backnotprop/plannotator

Plannotator – 面向 AI 編碼助手的本地瀏覽器式審查 UI

是什麼 – Plannotator 是一個僅限桌面使用（無需雲端服務）的工具，當 AI 驅動的編碼助手（Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi 等）產生計畫、HTML 或完成程式碼時，會自動開啟一個 Web UI（或透過 Herdr Annotate 使用終端機 UI）。您可以在內容上加上註解，對差異進行評論，並將回饋發送回助手，以便其修改輸出。

核心功能

• 計畫／文件審查 – 可對 Markdown 計畫、規格書或透過 URL 取得的頁面進行註解。UI 顯示內嵌評論和「傳送回饋」按鈕。
• 程式碼審查 – 支援本地變更或遠端 PR/MR URL（GitHub、GitLab、GitButler、Perforce）。顯示檔案樹與並排差異，可評論、暫存／取消暫存，以及回覆「LGTM」。
• HTML 資產審查 – 渲染原始 HTML，允許您在傳送回饋前進行標記。
• AI 在環中 – 您可以向連接的 LLM 提問關於審查內容的問題，或啟動 AI 生成的審查，自動發布評論。
• 終端機模式 – Herdr Annotate 插件將相同 UI 帶入終端機（透過 Herdr TUI）。也可獨立使用 plannotator-tui 作為終端機 UI。

運作方式

1. 助手觸發一個鈎子（例如 ExitPlanMode）。
2. Plannotator 的本地伺服器接收計畫或差異。
3. 您的預設瀏覽器開啟審查 UI。
4. 您完成註解後，工具透過相同鈎子將結構化回應傳送回，使助手可繼續或修改。

安裝

• 適用於 macOS、Linux、WSL 和 Windows PowerShell 的一鍵安裝腳本，自動下載 plannotator 二進位檔，偵測已安裝的助手，並寫入必要的鈎子／技能／指令。
• --minimal 標誌僅安裝二進位檔，不包含任何助手特定的整合。
• 安裝後，依各助手的簡要步驟操作（如為 Amp 複製插件檔案、為 Claude Code 加入市場條目等）——README 提供了每個助手的詳細設定連結。

使用快捷鍵

/plannotator-annotate README.md                # 註解本地檔案
/plannotator-annotate https://example.com     # 取得並註解 URL
/plannotator-review                           # 審查目前 git 差異
/plannotator-review https://github.com/...    # 審查 PR/MR
/plannotator-last                             # 註解助手的上一次回覆
plannotator sessions                          # 列出／開啟儲存的會話

（對於 Codex，命令前綴為 ! 或 $。）

整合

• VS Code Webview、Obsidian 儲存庫自動儲存、Bear 記事、GitHub/GitLab PR 取得、GitButler 工作區、Perforce、遠端 SSH/開發容器埠轉送。
• 所有整合皆為可選；核心 UI 無需任何整合即可運作。

隱私與網路

• 無遙測；所有計畫、差異、註解和設定均保留在本機，除非您明確共享。
• 網路呼叫僅在請求外部資源時發生：取得 URL（預設透過 Jina Reader）、從 GitHub/GitLab 拉取 PR 資料、向設定的 LLM 提供商傳送問題，或使用可選的連結共享服務（使用 AES-256-GCM 在客戶端加密大負載）。
• 安裝程式會檢查 GitHub 上的最新版本，但不會傳輸您的任何內容。

分享

• 小型 Markdown 片段編碼在 URL 片段中（任何擁有連結的人都可查看）。
• 大型負載使用短連結服務，僅儲存密文；解密金鑰位於片段中。
• 提及了用於團隊協作的託管「工作區」產品，但開源應用始終保持完全本地化。

安全

• 每個二進位發布均附帶 SHA-256 檢查碼和 SLSA 證明。
• 每個發布均附帶 CycloneDX SBOM 和 Grype 掃描；README 提供了驗證命令的連結。

卸載／徹底清除

• plannotator uninstall 刪除二進位檔和設定，但保留本機資料。
• plannotator uninstall --purge 在確認提示後清除所有 Plannotator 資料。

總結 – Plannotator 是一個專注的本地主機 UI，讓開發者在使用 AI 編碼助手時保持「人類在環中」，提供計畫審查、程式碼差異註解和 HTML 資產回饋，而無需將專有程式碼傳送給任何第三方服務。