在 GitHub 上保留无限的布局历史记录

该应用会保留每种邮件布局的最新25个版本。连接 GitHub 后，每个版本还会保存到您选择的仓库中，因此您的布局历史记录将不受限制：您可以查看谁对哪些内容进行了修改，恢复任意版本，并在应用之外保留布局的副本。

连接 GitHub

在应用中，打开**“开发者**”并进入**“连接**”选项卡。
在**“GitHub**”下方，点击**“连接 GitHub**”。GitHub 将在新标签页中打开。
在您的 GitHub 账户或组织中安装该应用，并选择它可使用的仓库。建议使用私有仓库。如果您还没有私有仓库，请先在、github.com/new 或上创建一个。
返回应用后，在**“存储库**”下选择该存储库，然后点击**“使用此存储库**”。

该应用会立即将您现有的每个布局写入代码库，然后在您保存时将每个新版本提交到代码库。

仓库中包含什么

email-layouts文件夹中，每个布局对应一个文件，文件名由布局的ID决定，例如email-layouts/cmu3010yo01e4yn0wdjmh7xab.json。该文件包含布局的名称、主题、预览文本、内容或视觉设计，以及所有翻译。无论是在应用中保存、通过API保存、由AI保存还是通过还原操作保存，每次保存都会生成一个提交，其提交信息类似于Update "Order confirmation" (editor, v12)。

在应用中删除一个布局会删除其文件；早期的提交会保留其历史记录。

还原到较早的版本

打开该布局，然后点击**“版本历史**”。在应用中保存的最新版本下方**，“GitHub 上的旧版本**”列出了该布局的所有提交记录。点击**“查看**”可预览某个版本，点击**“还原此版本**”可将其恢复。还原操作会保存为一个新版本，因此可以撤销。

在 GitHub 上编辑布局

在代码库中修改布局文件并将其提交到关联的分支：应用将在几秒内更新布局。该文件的检查方式与在应用中保存文件类似：Liquid 必须有效，链接和颜色必须安全，且文件必须已上传到您的商店。检查失败的文件将被忽略，布局将保持原样。

文件无法创建新的布局，删除文件也不会删除布局，因此误提交绝不会导致正在发送的电子邮件出现故障。

断开连接

开发者 > 连接 > GitHub > 断开连接 GitHub 将断开连接并撤销该应用的访问权限。代码库及其历史记录仍将保留在您的 GitHub 账户中。

通过 API

GET /api/v1/email-templates/:id/versions/github 在 GitHub 上列出了各个版本，而 POST /api/v1/email-templates/:id/versions/github/:sha/restore 可用于还原其中一个版本。MCP 工具包括 list_template_versions、github: true 和 restore_template_github_version。