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 程式碼代理的開發者設計的實用工具，提供專注、鍵盤驅動的方式，在不離開終端的情境下審查與評論生成的程式碼。