使用 Paneflow Changes 审查智能体的工作区修改

Paneflow 的 Changes 标签页在智能体终端旁显示本地修改。您可以将文件与最新提交（HEAD）比较，在编辑器中查看上下文，或恢复不想保留的修改块。

以下步骤适用于 Paneflow 0.17.5。Changes 包含已暂存和未暂存的修改，以及未跟踪文件。修改按检出目录分组，不区分修改者。如果多个智能体编辑同一组文件，它们的修改会一起显示。

更新指南。 本文最初介绍 Paneflow 0.3.7 的 Diff 界面，现在介绍底部工具区的 Changes 标签页。

选择要审查的检出目录

打开 Git 项目，选择目标检出目录或 worktree 的标签页，然后在底部工具区打开 Changes。阅读差异前，先确认文件路径。

比较显示当前文件相对于 HEAD 的变化。已暂存和未暂存的修改在这个视图中合并显示。要准确确认下次提交包含什么，请使用 git diff --cached 单独检查 Git 暂存区。

Changes 不包含分支上已经提交的修改。仓库尚无首次提交时，会以空树作为比较基准。

结合上下文阅读差异

选择 Split 并排阅读两个版本，或选择 Unified 在同一视图中查看新增和删除的内容。Words 高亮显示行内修改。

空白选项可以在比较时修剪或忽略空白。如果空白影响程序行为，例如 Python 的缩进，请保留 Default。

需要查看修改块周围的代码或进行修正时，在集成编辑器 Files 中打开文件。Changes 读取磁盘上的文件，因此需要先保存，修改才会出现在其中。

文件没有文本差异时

在 Paneflow 0.17.5 中，Changes 会列出二进制文件、超过 512 KiB 的文件和部分依赖锁定文件，但不显示文本差异。列表最多显示 200 个文件，并在省略更多文件时给出提示。

没有文本差异的文件也可能已经修改。使用 Git 检查完整文件列表，并用适合的工具审查大型或二进制文件。

使用 Revert 恢复修改块

在已修改的文本文件中，Revert 将一个块替换为 HEAD 中的内容。点击后立即写入磁盘，没有确认对话框。 使用前，先复制或以其他方式保留可能还需要的修改，再检查恢复后剩余的差异。

Revert 不改变 Git 暂存区。如果该块已经暂存，它仍会进入下次提交，直到您更新暂存区。恢复已暂存的修改后，请检查 git diff --cached。Revert 不会删除未跟踪文件。

Paneflow 会在以下两种情况下拒绝恢复：

• 编辑器中有该文件的未保存修改。 先保存，或在不再需要时放弃修改，然后重新阅读差异再重试。
• 磁盘文件在差异加载后发生了变化。 先重新阅读更新后的差异再重试，尤其是在智能体仍在编辑文件时。

让智能体审查整个分支

要请求审查，在目标检出目录中启动智能体，并指定基准分支。例如，分支基于 main 时：

对照 main 审查这个分支，包括已提交的修改和本地修改。不要修改文件。报告缺陷和回归风险，并提供文件路径、行号和相关测试。

智能体可以进一步检查 Changes 未显示的已提交修改。结合代码阅读审查意见，完成必要修正并运行相关测试。提交前，使用 git diff --cached 确认将要记录的内容。