核心功能

版本管理

Z Code 提供完整的版本管理能力,包括对话级版本回退内置 Git 版本管理,让您在 Agent 驱动的开发流程中始终掌控代码的每一次变化。


版本回退

Z Code 会自动追踪所有由 Agent 执行的文件修改,将用户的对话历史作为版本控制时间线。您可以定位到任意一次对话,审查变更或将代码回滚到该对话完成后的版本。

版本回退与 Diff 视图

核心机制

  1. 自动创建检查点 (Checkpoint):在您发送消息后,任何由 Agent 产生的文件变更都会被系统自动捕获并保存为一个独立的检查点。
  2. 审查当轮变更 (Review):每轮对话完成后,点击 Review 按钮,可在多文件 Diff 视图中清晰预览本次操作产生的所有文件变更。
  3. 撤销最近一次变更 (Undo):点击 Undo 按钮将仅撤销最后一轮对话产生的文件变更,将代码恢复至上一轮消息完成时的状态。
  4. 从历史消息恢复 (Restore Checkpoint):通过在历史消息中定位目标节点,您可以将整个项目的文件精确恢复到该条消息处理完成后的状态。

Git 版本管理

Z Code 内置了完整的 Git 管理面板,您可以直接在界面中完成代码提交,无需切换到终端操作。

Git 版本管理

主要功能

  • 提交更改:在左侧 Git 面板中查看所有已修改的文件,填写提交信息后一键提交。
  • 文件状态追踪:清晰标记文件的修改状态(M 已修改、U 未追踪等),一目了然。
  • 分支管理:在底部状态栏查看和切换当前分支。
  • 提交历史:浏览完整的 Git 提交记录,了解项目的演进脉络。

典型使用场景

场景说明
逐步迭代处理复杂任务时,每完成一小步通过 Review 审查代码,稳步推进,所有版本自动记录。
快速修正若 Agent 最近一次修改不符合预期,立即使用 Undo 撤销,微调指令后重新发送。
方案调整发现当前路径有误时,直接在对话时间线上找到关键消息,一键恢复至该节点重新开始。
阶段性提交当 Agent 完成一个功能模块后,通过 Git 面板提交代码,保留清晰的项目里程碑。

功能优势

  • 对话即版本:摆脱繁琐的手动操作,对话历史就是最直观的版本演进图。
  • 零成本实验:通过 Undo 和 Restore 功能,您可以大胆尝试不同的实现路径。
  • 精准追溯:每一行代码的变更都能对应到具体的对话上下文,告别"不知道为什么要改这行"的困惑。
  • Git 无缝集成:版本回退与 Git 提交互补,既有细粒度的对话级回滚,也有标准的 Git 版本管理。

下一步