企业官网建设流程全解析

herdr-reviewr是一个运行在终端里的代码评审面板（code-review pane），专为 AI 编程代理设计：它把你的代理（Claude Code、Codex、OpenCode 或 Pi）修改的代码 diff 展示在聊天窗口旁边，你可以按行写下评论，再一键把评论发回给代理。整个界面只有3 个标签页——Changes、All files、PR，按下数字键1、2、3即可切换。本文带你逐个标签页看懂一个 PR 的全部细节。

一、安装 herdr-reviewr：一条命令的事

前提条件很简单：herdr ≥ 0.9.3、git、支持 24 位色的终端（macOS / Linux / Windows 均可）。

herdr plugin install persiyanov/herdr-reviewr

当 herdr 为 worktree 创建工作区时，reviewr 会自动打开；也可以手动打开：

herdr plugin action invoke open --plugin persiyanov.reviewr

💡 没有 herdr 也能单独运行 release 二进制（herdr-reviewr ~/some/repo），只是「发送给代理」和 last turn 范围不可用。

二、3 个标签页总览：1 键切换

标签页定义在 src/app.rs 中，渲染逻辑位于 src/ui.rs。三个标签页各司其职：

2.1 标签页一：Changes —— 只看"改了什么"

这是最核心的评审区。左侧是 diff 视图，右侧是文件列表。评审流程只需五步：

1. 选文件：j/k在文件列表移动，]/[在改动块之间跳转；
2. 聚焦 diff：按Tab切换面板焦点；
3. 选中行：按v进入选择模式，再用j/k扩展选区（也可拖动行号）；
4. 写评论：按c，输入内容，Enter保存；
5. 发送：按s，所有评论一次性送入代理的输入框。

底部状态栏会实时提示下一步操作，按?可查看完整按键表。

首次打开且没有改动时，Changes 面板会显示no diff空状态：

Changes 面板还内置4 种 diff 范围（scope），用ubtg快速切换：

• uncommitted（u）：上次提交以来的改动，含新增文件；
• branch（b）：分支从 base 分出后的全部改动（B可自选 base 分支）；
• last turn（t）：只看代理"最近这一轮"改了什么，适合盯着代理干活；
• commits（g）：用G挑选单个提交或提交区间。

2.2 标签页二：All files —— 浏览整个工作树

按2切到All files，右侧文件列表从"只列出被改文件"变为worktree 下的全部文件：

• Git 忽略（ignored）的文件会以暗色显示，但仍可点开查看；
• 这里同样支持写评论并发送，即使文件没有出现在 diff 里；
• 按/可按文件名或代码内容全局搜索（基于 fff 引擎），Ctrl+F在文件内查找并逐个跳转；
• 打开.md文件后按m可在"渲染视图 / 源码"之间切换。

排查"代理是不是动了我没注意的文件"时，这个标签页非常实用。

2.3 标签页三：PR —— 只读查看 Pull Request

按3打开PR标签页，可以直接在终端里阅读当前分支的 Pull Request（GitLab 上是 Merge Request），包括：

• PR 状态（open / merged / closed）与 CI 检查（checks）；
• PR 描述、评论列表（每列最多显示最新 100 条）。

常用操作：j/k在描述与评论间移动，PageUp/PageDown滚动，r刷新，o在浏览器中打开。该标签页是只读的——reviewr 永远不会替你在 PR 上发布内容。

⚠️ 使用 PR 标签页需要在本地登录gh、glab或az（含 azure-devops 扩展）之一，且仅支持 GitHub、GitLab、Azure DevOps 三家平台。

三、高频快捷键速查表

分栏 diff（|）需要 diff 面板宽度达到 137 列；空间不够时可先用z隐藏文件列表，或用p把文件列表移到底部。

四、新手常见问题

Q：我写的评论存在哪里？评论只存在于面板内存中，关闭面板未发送的评论会丢失；s发送是"全部或都不发"的原子操作。这也是它的安全设计之一——reviewr 从不自动发送。

Q：为什么 PR 标签页打不开？检查是否已安装并登录gh/glab/az；私有部署还需要在 config.toml 中配置github_host、gitlab_host或azure_devops_host。

Q：last turn 范围显示为空？代理在"回合刚开始的那一刻"就写入了全部文件时，该范围会显示空并附带原因说明。

Q：想改默认主题或布局怎么办？所有配置都在~/.config/herdr/plugins/config/persiyanov.reviewr/config.toml，保存即生效，内置 20 套明暗主题（catppuccin、tokyo-night、rose-pine等），更多说明见 README.md。

五、小结

• Changes（1）：评审主力，4 种 scope 覆盖"刚改了什么"到"整个分支改了什么"；
• All files（2）：任意文件浏览 + 全文搜索，未改动文件也能评论；
• PR（3）：终端内只读查看 PR 状态、检查与讨论。

配合底部状态栏的下一步提示和?全按键表，基本不需要背下任何快捷键，就能在 10 分钟内上手一次完整的终端代码评审。🚀