审查与提交

检查仓库变更

运行 /changes 打开 q 的只读 Git 浏览器。它列出所在仓库中已暂存、未暂存和未跟踪的文件。

• 上下方向键或 j/k 选择文件。
• Enter 聚焦 diff，Tab 在文件与 diff 面板间切换。
• PageUp/PageDown 垂直滚动，左右方向键滚动长行。
• r 重新加载仓库状态；Escape 返回对话。

仅打开该视图不会暂存、编辑或提交任何文件。

理解视图

浏览器显示仓库当前状态，其中包括本轮 q 工作之前已有的变更。它并不是每轮代理操作的审计日志。

已暂存和未暂存的补丁分别显示，即使两者相对于 HEAD 相互抵消也是如此。已知文本格式会使用语法高亮，二进制文件显示提示；未知或过大的源码回退为纯文本。选中补丁的预览限制为 256 KiB 或 4,000 行，截断时会明确标记。

准备提交

在对话中运行 /commit，或在当前仓库中启动独立工作流：

如果索引中已有暂存变更，q 会使用当前索引。如果索引为空，q 会暂存当前工作树变更，但排除 q 管理的根目录 .q 元数据。随后使用配置的 commit 模型生成单条 Conventional Commit 消息或拆分提交方案。

创建提交前，q 会再次确认捕获的索引仍与方案匹配。如果审查期间仓库状态变化，请重新生成或重新开始，不要提交过期的文件分组。

审查并完成

在提交界面，上下方向键选择拆分方案，e 编辑消息，Ctrl+S 保存编辑，r 重新生成。Enter 提交已批准的方案。p 提交并推送；推送需要现有 upstream。Escape 取消而不创建提交。

批准前请检查每一组的文件和消息。q 可以提出并执行 Git 操作，但不会假定此前已有的不相关变更属于当前任务。