版本控制

每次更改都会提交到由 Proyecta 管理的私有 GitHub 仓库。在 builder 工具栏的版本下拉菜单中浏览并切换到之前的快照。

AI 对你应用所做的每一次更改都会提交到由 Proyecta 管理的私有 GitHub 仓库。你的代码始终可以在 builder 中访问和导出。

版本历史

使用 builder 工具栏中的版本下拉菜单在快照之间切换。在移动端，可通过 More 菜单访问版本历史。在查看历史版本时，点击版本横幅中的 Open history 可查看完整版本列表。每个版本显示以下信息：

版本号（例如”v12”）
版本标签（例如初始纯 frontend 快照显示为”v1 (pre-cloud)“，迭代版本则为空）
以你本地时区显示的创建时间戳
git commit 哈希的前 7 位字符

打开历史版本

点击任意版本卡片即可在预览中打开该快照。历史版本以只读模式打开——你可以查看代码和预览，但无法在历史视图中进行编辑。

浏览历史版本时，工具栏下方会显示一条横幅，提示*“正在以只读模式查看版本 N。”* 点击横幅中的 Return to latest 即可返回当前工作状态并继续编辑。

如果你从未进行过任何编辑，列表会显示*“暂无快照——版本会在 builder 提交更改后自动创建。“*

如何实际回退？

版本历史面板中的一键回退功能已在开发路线图中。目前，你有以下两种方式：

询问 AI — "Revert the last change"、"Go back to how the homepage looked in version 6"、"Undo everything from the last three commits"。AI 会读取历史记录并为你应用反向 commit。
在 Terminal 中使用 git — 实现精确控制：

# View recent commits
git log --oneline -20

# Revert a specific commit (creates a new commit undoing it)
git revert <commit-hash>

# Or reset to a specific point (destructive)
git reset --hard <commit-hash>

GitHub

你的项目代码存储在由 Proyecta 管理的私有 GitHub 仓库中。你可以直接在 builder 内的代码编辑器中访问代码，也可以将其导出。如果你已连接自己的 GitHub 组织，仓库将创建在该组织下。

常见问题

每个版本包含哪些内容？

代码更改、配置更新和 schema 修改——所有存在于 git 中的内容均包含在内。存储在仓库外的资源（如已上传的文件和数据库记录）不受版本控制。

我可以创建 branch 吗？

可以。使用 Terminal 创建并切换 branch：git checkout -b feature/new-homepage。AI 会将更改提交到当前已检出的 branch。

如何与团队成员协作？

多名团队成员可以在 GitHub 上访问同一仓库。使用标准 git 工作流（branch、pull request）进行协作。

即将推出

一键回退 — 在版本历史面板中添加”回退到此版本”按钮，创建一个与旧快照匹配的新版本
自定义版本标签 — 为单个版本命名，方便日后查找