前言¶
DeepSeek Harness (DSH) 提供了子代理註冊表和並行工具能力,這使得實現複雜的代碼審查工作流成爲可能。現有的 DSH Git 插件多停留在 diff 查看或工作區清理階段。dsh-review-squad 利用 DSH 的並行子代理特性,將代碼審查轉化爲一個標準化的工作流步驟。
是什麼¶
這是一個並行多角色代碼評審插件。它通過 /review 命令派出四名只讀評審員子代理(安全、正確性、測試、風格),每名評審員可獨立配置模型與思考強度,最終彙總爲按嚴重度分組的結構化報告。
核心功能¶
- 並行多角色評審:同時進行安全、正確性、測試和風格四類檢查。
- 只讀模式:評審員被嚴格限制,禁用寫入、子代理、Web 搜索等工具,確保環境安全。
- 獨立配置:每名評審員可指定不同的模型(如安全用強模型,風格用快模型)和思考強度。
- 後臺執行:默認作爲後臺任務運行,不阻塞對話。
- 結構化報告:彙總報告按嚴重度分組,方便快速定位問題。
- 熱更新配置:支持通過 Web UI 或
settings.yaml實時覆蓋配置,無需重啓。
安裝與啓用¶
使用前需確保 DeepSeek Harness (dsh) 版本 ≥ 0.1.1-rc.2。
dsh plugin --profile web add dsh-review-squad
典型用法¶
Slash Command¶
在聊天中直接使用以下命令:
/review # 完整小隊評審未提交更改
/review staged # 僅評審暫存區更改
/review commit abc1234 # 評審指定提交
/review path src/lib # 評審指定路徑
/review security tests # 僅評審特定角色
/review --style # 排除風格評審
/review stop # 停止當前評審會話
Tool¶
Agent 也可以調用 code_review 工具,參數包括:
* scope: 評審範圍(diff / staged / commit:<sha> / path:<dir-or-file>)
* focus: 附加關注點
* reviewers: 評審員列表(逗號分隔,--key 可排除)
配置說明¶
支持在 ~/.dsh/settings.yaml 中通過 review-squad: 節點覆蓋配置,或使用 Web UI 設置頁面修改。
# ~/.dsh/settings.yaml
review-squad:
language: zh
timeoutMs: 300000
reviewers:
- key: security
role: Security reviewer
instructions: Hunt for injection, authz gaps, committed secrets, unsafe crypto.
agentOptions:
provider: deepseek-official
model: deepseek-v4-pro
reasoningEffort: max
- key: style
role: Style reviewer
instructions: Naming, duplication, complexity, conventions.
agentOptions:
provider: my-cheap-gateway
model: glm-4.6-flash
適用場景與注意¶
- 依賴:依賴
@deepseek-ai/dsh-base提供的spawn和tool-str-replace-editor。 - 權限限制:插件以當前 DSH 進程權限運行,評審員工具被嚴格限制,無法寫入文件或調用外部網絡。
- 報告限制:報告生成有最大字符數限制(
maxReportChars),超過後會丟棄 INFO → LOW → MEDIUM 嚴重度的內容。 - 合規性:插件遵循 MIT 許可證,建議在安裝前檢查源碼。
結語¶
對於需要在 DSH 工作流中集成深度、自動化代碼審查的場景,該插件提供了靈活且可控的解決方案。更多細節與源碼可參考項目倉庫。