persiyanov/herdr-reviewr

herdr‑reviewr – herdr 的终端代码审查面板

是什么

• herdr AI 助手终端 UI 的插件，可显示代理刚刚编写的文件的实时差异。您可以在终端内滚动查看变更，添加行级或范围评论，并将这些评论发送回代理，无需离开终端。
• 可作为聊天窗口旁边的分屏面板运行，也可作为独立的终端程序使用。

核心功能

• 四种差异范围 – 查看未提交的更改、整个分支、代理的上一次“回合”，或任意一组提交。
• 行级评论 – 选择行（v），输入评论（c），编辑/删除（e/d），然后将所有评论发送给代理（s）。
• 导航器 – 模糊文件搜索、实时 grep（通过 fff 工具）、可渲染 Markdown 的文件查看器。
• PR 标签页 – 仅读取 GitHub、GitLab 或 Azure DevOps 的当前拉取/合并请求（需要相应的 CLI 工具）。
• 主题与 UI – 内置 18 种深色/浅色配色方案，可通过 --theme 或 TOML 配置文件自定义。
• 可自定义快捷键 – 每个操作均可重新绑定；默认值列在 README 中。

如何获取

1. 已安装 herdr（≥ 0.7.5）：

   herdr plugin install persiyanov/herdr-reviewr
   herdr plugin action invoke open --plugin persiyanov.reviewr
   

2. 独立使用（无需 herdr）：从发布页面下载预构建二进制文件，并在仓库上运行：

   herdr-reviewr ~/my/project
   

   （仅 UI 可用；“发送”和“上一轮”范围需要 herdr。）

配置

• CLI 标志：--poll <ms>，--base <ref>，--theme <name>，--wrap on|off。
• 持久化 TOML 文件位于 ~/.config/herdr/plugins/config/persiyanov.reviewr/config.toml，用于设置默认值，如 theme、default_scope、导航器位置、编辑器命令和自定义快捷键。
• 插件尊重 .gitignore；大文件（> 2 MiB 或 50k 行）将从差异中排除。

限制

• 需要真彩色终端和 Unicode 方框绘图字符；256 色终端无回退方案。
• 仅支持 macOS 或 Linux；不支持 Windows。
• 剪贴板集成依赖 pbcopy、wl-copy、xclip 或 xsel。
• 评论仅在当前会话内存中存在；关闭面板会丢弃未发送的评论。
• “发送”功能仅在 herdr 工作区中存在代理时才有效。
• PR 查看为只读，每线程最多显示前 100 行评论。

路线图亮点

• 评论的结构化 JSON 导出。
• 并排分屏视图。
• 通过 OSC 自动检测亮色/暗色主题。
• 添加更多主题（如 kanagawa、everforest）和 OSC-52 剪贴板支持。

许可证

• 代码采用 MIT 许可证。
• 语法高亮资源来自 syntect 和 two-face，分别遵循其各自的许可证。

---

herdr‑reviewr 是为在 herdr 终端 UI 中使用 AI 编码代理的开发者设计的实用工具，提供专注、键盘驱动的方式，在不离开控制台的情况下审查和评论生成的代码。