查看改动

查看改动

每次修改文件，都会以 diff 的形式出现在对话记录里。想一次看全，运行：

/diff

/diff 会显示本次会话开始以来的全部改动。你自己的 git 历史不受影响，git diff 和 git status 照常可用。

把文件回滚到之前的回合

每个回合开始前和结束后，Codewhale 都会把工作区快照存进一个独立的 git 存储。它从不写入你仓库自己的 .git，在不是 git 仓库的文件夹里也能用。

/restore           # list the 20 most recent snapshots
/restore list 50   # list more (up to 100)
/restore 1         # put files back to the newest snapshot

恢复会改动文件，所以需要工作区已被信任（/trust on）或处于 Full Access；查看快照列表则不受限制。你也可以直接说“撤销你刚才的修改”，Codewhale 可以回滚它自己的那个回合。

/undo 是另一回事：它只是从对话中删掉最后一轮问答。想恢复文件，请用 /restore。

注意： 快照保留 7 天。超过 2 GB 的工作区不做快照，Codewhale 会提示你一次；如果仍想要快照，可以在配置中调大 [snapshots] max_workspace_gb。如果没有安装 git 或磁盘已满，回合照常运行，只是不做快照。

做一次代码审查

在会话中，/review 可以对一个文件、一段 diff 或一个拉取请求做结构化审查。在 shell 中，codewhale review 会审查一段 git diff 并输出发现的问题：

codewhale review                      # unstaged changes in the working tree
codewhale review --staged             # what you are about to commit
codewhale review --base origin/main   # everything on this branch
codewhale review --pr 123             # a GitHub pull request (needs gh)

加上 --path <文件> 只审查一个路径，用 --model 指定审查模型，用 --json 输出机器可读结果。超过 200,000 个字符的 diff 会被直接拒绝，而不是截断；需要时可以用 --max-chars 调高上限。

注意： --post 会把审查结果作为评论发布到拉取请求上。不加这个参数时，除了发给模型的请求，没有任何内容离开你的终端。

为审查保留收据

审查收据记录了审查了什么、发现了什么，让你能证明推送出去的 diff 正是被审查过的那一份。

codewhale review --base origin/main --write-receipt
codewhale review --base origin/main --check-receipt

• --write-receipt 在审查成功后保存一个本地 JSON 文件：diff 的指纹、提供商与模型、各类发现的数量、未解决的风险，以及审查文本的哈希。它不保存 diff 本身。
• --check-receipt 不调用模型。如果 diff 在收据生成后发生了变化、审查留下了未解决的风险，或者附带的检查没有通过，它都会以非零状态退出，因此可以用作推送前的检查关卡。
• --receipt-path <文件> 写入或读取指定的收据，而不是最新的那一份。

注意： 目前收据只覆盖代码审查。普通 Agent 回合的收据——把每次工具调用、审批和文件改动汇总成一份导出——已经设计好，但还没有实现。

保存整个会话

想保留或分享一次会话的完整记录，可以导出：

/export clipboard                  # a redacted copy of this session
/export file notes/session.md      # the same, written to a file
codewhale sessions export <id>     # full archive: messages, tool calls, results, artifacts

codewhale sessions 会列出已保存的会话及其 id。完整归档包含全部上下文，请像对待源代码一样对待它。

下一步