使用 Git 与启心代码管理协作
何时用
当多人共同维护一个 app、需要审计变更、回到已知版本，或把工程安全保存到远程仓库时，使用 Git 面板。
开始前
- Git 功能位于桌面编辑器左侧 Activity Bar 的 Git 图标中。
- 开始修改前，团队先约定主分支、功能分支命名和合并负责人。
- 使用启心代码管理时，先登录 Qixin 账号并设置账号名称。
- Pull、切换分支或切换历史提交前，先保存编辑器中的 Page 和 Graph。
步骤
建立仓库和远程
新建 app 时可以直接勾选启心代码管理。已有 app 可按以下方式接入：
- 打开 Git 面板。
- 如果尚未初始化，选择启用启心代码管理，或选择初始化仓库。
- 已有 Git 仓库时，打开远程选择器：
- 选择切换到启心代码管理，让 Theseus 创建并连接私有仓库；或
- 选择添加远程，填写远程名称和 URL。
- 确认当前远程为计划使用的
origin或团队约定远程。
每次任务的推荐流程
- 在分支菜单确认当前分支。独立任务选择创建并切换新分支。
- 点击 Fetch 获取远程分支信息，再 Pull 当前分支。
- 完成一小组相关修改并在编辑器中验证。
- 在 Changes 中逐个点击文件查看 diff。
- 只 Stage 本次任务要提交的文件；其余文件保持未暂存。
- 输入清晰的提交信息并 Commit。也可以在已有 staged 变更后让 AI 生成提交信息，再人工修改。
- Push 当前分支。
- 由团队按约定评审和合并；合并后其他成员再次 Pull。
查看历史版本
- 切换到 History，必要时先 Fetch。
- 查看提交标题、作者、时间和分支标记。
- 双击历史提交只用于检查旧版本。切换后处于 detached HEAD 时，不要直接继续团队开发；需要继续修改时，从目标提交创建分支。
成功表现
- Git 面板显示正确的当前分支和远程。
- 提交只包含本任务文件，diff 中没有密钥、现场数据或生成文件。
- Push 完成后，远程仓库能看到同一 commit。
- 另一位成员 Pull 后能打开 app，并得到相同的可编辑工程。
常见问题
Pull 前有未提交修改
先完成并提交，或明确保留、暂存到 stash、放弃哪些修改。不要在不理解选项影响时切换提交或分支。
Push 或 Pull 要求认证
HTTPS 远程按提示更新访问令牌并重试；SSH 远程检查本机 SSH key 和 agent。不要把凭据写入远程 URL。
启心代码管理不可用
确认已登录 Qixin、账号已设置名称，并检查当前账号是否有代码管理权限。
同一个文件发生冲突
先停止继续编辑，和同事确认两边要保留的业务意图，再逐项解决冲突并重新运行验证。不要只按“保留我的”或“保留对方的”覆盖整个文件。
想撤回 Changes 中的文件
撤回已跟踪文件会丢弃本地修改；撤回未跟踪文件会删除文件。确认无须保留后再操作。
AI 可以怎么帮
AI 可以检查当前 app 的变更、建议拆分提交、解释冲突和生成提交信息。例如：
只读检查当前 Git 变更。按业务目的建议如何拆成最少的独立提交，指出不应提交的文件，并为每个提交给出一句提交信息。不要暂存、提交或推送。
AI 完成 app 修改后，应要求它列出修改文件和验证结果；随后仍要在 Git 面板人工查看 diff。
必须人工确认
- 当前分支、远程和目标仓库是否正确。
- staged 文件是否只属于本次任务，是否包含密钥、客户数据或机器专属配置。
- Pull、切换分支、Discard、stash 和 detached HEAD 操作会如何影响未提交工作。
- Commit 和 Push 的时机，以及团队评审是否已经完成。