前言¶
用 DeepSeek Harness（DSH）這類智能體工作臺寫代碼，模型完成任務的速度很快，問題在於改完之後質量如何：多數時候只能靠人工再開一遍編輯器，或者在系統提示詞裏寫一段「請順便檢查代碼」——結果是報告格式不固定、沒有量化分數，審查記錄也留不下來。
下面介紹的 Mingxi2077/dsh-plugin-review 把這件事做成了插件：對項目或代碼做多維度健康評分，用程序生成的 SVG 雷達圖展示結果，審查歷史帶分類、分頁和回收站，並且支持 AI 在完成模塊後主動觸發審查。
這是什麼¶
dsh-plugin-review 是一個 DSH 插件，運行在 dsh web 端（client platform 爲 web），作者是 Mingxi2077，許可證爲 MIT。它的定位一句話可以說清：把 DSH 變成一個自帶代碼質量審查紀律的工作臺——評分是程序化指標，不依賴模型的主觀描述。
插件需要 DeepSeek Harness 0.1.0-rc.6 及以上版本（依賴 Cordis 注入規範和客戶端 __ModuleLoader__ 註冊規範），支持 Windows / macOS / Linux，Windows 下無 HOME 環境變量時會回退到 USERPROFILE 路徑。
核心功能¶
插件的能力分幾塊：
1、審查模式開關。輸入框 + 號旁有一個「審查」按鈕，開啓後輸入項目路徑或直接粘貼代碼即可審查。
2、AI 主動審查。插件會注入系統守則，AI 在完成一個任務、一個模塊或一輪修復後，主動調用 review_audit 工具；發現 error 級問題或分數低於及格線時，會主動修復並複查。
3、8 維健康評分。結構、可維護性、一致性、健壯性、測試、文檔、性能、安全，全部是程序化指標。
4、程序生成 SVG 雷達圖。對話內的審查結果卡和審查歷史彈窗都會即時渲染，雷達圖由 RadarChart 組件純 SVG 生成，沒有外部圖表依賴。
5、審查歷史。支持按時間、項目、成績分類，支持分頁、刪除，刪除的記錄先進回收站，默認保留 7 天，過期自動清除。
6、導出與統計。可以導出 CSV、查看項目統計、一鍵重審。
7、設置頁配置。維度開關、及格線、掃描上限/深度、忽略目錄、回收站天數都可以在「設置 → 審查」裏調整。
安裝與啓用¶
推薦用 GitHub 源安裝，執行下面這條命令，然後重啓 dsh web 並刷新頁面：
dsh plugin --profile web add "github:Mingxi2077/dsh-plugin-review#main"
如果本地有源碼，也可以從目錄安裝：
dsh plugin --profile web add /path/to/plugin-review
卸載用對應的 remove 命令，或從 web profile 的 bundles 移除條目後重啓：
dsh plugin --profile web remove plugin-review
典型用法¶
安裝並重啓 dsh web 之後，按下面的步驟走一遍：
1、輸入框左下出現「審查」按鈕，點擊開啓審查模式，輸入框上方會出現橫幅。
2、輸入要審查的目標，例如 審查 /path/to/project，或者直接粘貼代碼。
3、發送後模型調用 review_audit，對話中出現雷達圖評分卡和審查報告。
4、不點按鈕也行：AI 會在模塊完成時主動觸發審查；或者在對話裏說「審查」「評測」也會觸發。
有兩點使用細節需要注意：review_audit 需要絕對路徑，審查單文件時請用 text 參數粘貼代碼；雷達圖不顯示時，先確認已重啓 dsh web 並做了硬刷新（Ctrl+F5）。
配置與數據落盤¶
設置頁可配置的項及默認值如下：
| 配置項 | 說明 | 默認 |
|---|---|---|
| 評分維度 | 參與評分的 8 個維度開關 | 全部開啓 |
| 及格線 | 綜合分 ≥ 此值視爲通過 | 60 |
| 掃描文件上限 | 最多掃描的文件數 | 300 |
| 目錄深度上限 | 遞歸掃描的最大深度 | 4 |
| 忽略目錄 | 掃描時跳過的目錄（逗號分隔） | node_modules, .git, dist 等 |
| 回收站保留天數 | 刪除的審查記錄可恢復天數（0 = 立即刪除） | 7 |
配置和歷史數據都落在 $DSH_HOME 下：review-config.json 存配置，review-history.json 存審查歷史（最多 50 條，刪除該文件會清空歷史），review-trash.json 存回收站，按保留天數過期清除。
對目標項目，掃描只讀取文件前 40KB 做統計，不寫入、不修改任何內容；對話 URL 只存審查發生時的會話 ID，不存內容。
實現方式¶
插件分兩部分：Node half（lib/index.mjs）實現 review_audit 工具、掃描評分邏輯和 /api/review/* 接口，遵循 rc.6 的注入規範，注入 webServer、tools、systemPrompt；Browser half（lib/index.js）通過 window.__ModuleLoader__.load({ id, factory }) 註冊外殼，實現審查按鈕、橫幅、設置頁、雷達圖、歷史和回收站界面。
路線圖上還有幾個未完成的計劃：審查報告導出爲 Markdown/JSON、按項目平均分的趨勢圖、重審結果的新舊分數對比視圖。
適用場景與注意¶
這個插件適合把 DSH 當日常寫碼工作臺、希望每次改動都有量化審查記錄的開發者，尤其是想讓 AI 在交付模塊時自覺走一遍「審查—修復—複查」流程的場景。
安裝前請注意：插件以當前 dsh 進程的權限運行，掃描會讀取目標項目文件，安裝前應檢查源碼與許可證。該項目使用 MIT License，與 DeepSeek 官方無關聯，插件名稱和描述僅供社區分發使用。
結尾¶
簡單回顧：dsh-plugin-review 用程序化指標和雷達圖把「代碼質量」變成可量化、可留檔、可複查的流程，補上了智能體寫碼工作臺裏容易缺的那一環。插件頁面在社區目錄 skillhub.cn：https://www.skillhub.cn/plugins/Mingxi2077/dsh-plugin-review ，源碼在 GitHub：https://github.com/Mingxi2077/dsh-plugin-review 。
