前言¶
在使用 DeepSeek Harness (DSH) 進行開發時，管理 Pull Request 的反饋與審查狀態容易分散。遺漏重要的代碼審查意見或 CI 失敗信息會降低開發效率。dsh-pr-guardian 是一個專門用於管理 PR 反饋的收件箱工具，它由 Harzva 維護，旨在解決反饋遺漏和狀態追蹤的問題。
插件簡介¶
這是一個針對 DSH 的 PR 管理收件箱，支持與 Codex 共享進度狀態，並提供對 GitHub 開放 PR 的只讀集合管理。它將 GitHub 上的評論、審查和線程轉化爲結構化的反饋數據，幫助開發者優先處理關鍵任務。
安裝與啓用¶
安裝前請確保環境滿足以下要求：
* 已認證的 GitHub CLI (gh auth status)
* Git
* Node.js 24+
* 兼容的 DSH 版本：0.1.1-rc.2
* 兼容的 Cordis 版本：4.0.1
* 兼容的 React 版本：18.2.0
執行以下命令安裝插件並啓動 DSH：
dsh plugin --profile web add https://github.com/Harzva/dsh-pr-guardian/releases/download/v0.2.0-alpha.1/dsh-pr-guardian-0.2.0-alpha.1.tgz
dsh --profile web
安裝完成後，在 DSH 的側邊欄中打開 PR Guardian，刷新 GitHub 即可同步數據。
核心功能¶
- 反饋面板：側邊欄提供可搜索的反饋面板，支持分頁顯示普通評論、正式審查和審查線程（包括嵌套評論）。
- PR 發現：自動發現當前活動
gh賬戶撰寫的開放 PR。 - 優先級處理：支持優先處理人類反饋、收藏項、CI 失敗和衝突。
- 狀態管理：本地版本綁定狀態管理。已編輯的反饋會變爲待處理狀態。收藏和待處理/已調查/等待用戶等狀態在重啓後保留。已解決的線程和被取代的審查會被區分。
- 安全隔離：管理 API 不包含任何 GitHub 寫入操作，僅進行只讀數據收集。
典型用法¶
插件提供了管理 CLI 工具，默認位於 $DSH_HOME/dsh-pr-guardian/management 目錄（可通過 --state-dir 指定）。
- 同步與列表
先同步最新的 PR 和評論數據，然後列出所有待處理的反饋：
node bin/guardian-management.mjs sync
node bin/guardian-management.mjs list
- 標記收藏
通過 CLI 命令對特定的 PR 進行收藏操作：
node bin/guardian-management.mjs action '{"kind":"favorite","caseId":"owner/repo#123","favorite":true}'
- 本地診斷與監控
檢查本地環境狀態，或進行單次監控掃描：
node bin/dsh-pr-guardian.mjs doctor
node bin/dsh-pr-guardian.mjs monitor --once
- 生成報告
生成最近 7 天的報告：
node bin/dsh-pr-guardian.mjs report --days 7
適用場景與注意事項¶
- 狀態共享：若需在 Codex 和 DSH 之間共享進度，請使用相同的
stateDirectory路徑。 - 搜索限制：搜索範圍限制爲當前賬戶撰寫的 1,000 個開放 PR。
- 推送限制：
--push標誌受全局和倉庫開關限制，且需要滿足“七日門”要求才能啓用。當前版本默認禁用推送功能。 - 文件鎖：狀態文件使用獨佔寫入鎖。若遇到
WRITER_BUSY錯誤，請檢查並清理writer.lock文件。
生態鏈接¶
- GitHub 倉庫: https://github.com/Harzva/dsh-pr-guardian
- 目錄頁: https://www.skillhub.cn/plugins/Harzva/dsh-pr-guardian
