前言¶
DeepSeek Harness（DSH）的核心設計理念是“一切皆插件”。通過在 DSH profile 中掛載不同的 bundle，開發者可以擴展命令行或 Web UI 的功能。dsh-command-code-review 是一個基於 DSH slash-command 的代碼審查插件，它旨在爲 Pull Request 和本地代碼提供自動化的審查能力。
插件簡介¶
該插件由 JasonFreeLab 維護，採用 MIT 許可證。它是一個獨立的插件包，安裝後會在 DSH profile 中註冊 /code-review 命令。其核心價值在於將複雜的代碼審查流程封裝爲可配置的透鏡，並提供置信度與嚴重程度的評分機制，幫助開發者快速定位代碼問題。
核心功能¶
-
雙模式運行
- PR 模式：通過
/code-review 123或 PR URL 進行審查，結果會通過 GitHub CLI 自動回覆到 Pull Request 中。 - 本地模式：通過
/code-review review src/auth或空參數審查當前代碼庫。
- PR 模式：通過
-
可配置審查透鏡
- 默認包含 5 個透鏡：
guidance（AGENTS.md/CLAUDE.md 合規性）、bugs（錯誤與正確性）、history（歷史上下文）、security（安全性）、comments（註釋合規性）。 - 支持啓用可選的
perf（性能）透鏡。
- 默認包含 5 個透鏡：
-
評分機制
- 對發現的問題進行去重，並分別打分：置信度（區分誤報）和嚴重程度（Blocker/Major/Minor/Nit）。
- 支持設置置信度閾值（默認 80），低於該分數的發現會被過濾掉。
-
報告輸出
- 本地審查會生成結構化的 Markdown 報告。
- 伴隨生成 JSON 格式的機器可讀側車文件。
- 支持自定義報告輸出目錄。
安裝與前置條件¶
在安裝前，請確保你的 DSH profile 基於 @deepseek-ai/dsh-base，並且已安裝並認證了 GitHub CLI (gh)（僅 PR 模式需要）。
安裝命令如下：
dsh plugin --profile web add dsh-command-code-review
安裝完成後，需要重啓或重新加載 profile 以使命令生效。
使用方法¶
在 DSH Web UI 的 composer 中輸入 /code-review 即可使用。以下是幾種典型的調用方式：
# 通過 PR 編號審查
/code-review 123
# 通過 PR URL 審查
/code-review https://github.com/owner/repo/pull/123
# 審查本地指定路徑
/code-review review src/auth
# 審查整個項目
/code-review review the whole project
# 審查當前未提交的更改
/code-review
# 指定輸出目錄
/code-review review src/auth --out reports
/code-review --out docs review src/auth
空輸入會首先探測當前分支的 Open PR，若沒有則回退審查未提交更改。
配置項¶
插件支持在 profile 的 cordis.patch.yml 中進行配置。
- 置信度閾值
設置低於此分數的發現將被丟棄。
- id: command-code-review
config:
threshold: 90
- 報告輸出目錄
設置本地審查報告的默認保存位置（默認doc）。
- id: command-code-review
config:
outputDir: reports
- 審查透鏡選擇
選擇啓用的透鏡集合。
- id: command-code-review
config:
lenses: [guidance, bugs, security]
- 自適應透鏡
默認開啓（autoLenses: true）。當審查範圍涉及安全敏感文件時自動啓用security透鏡；涉及熱路徑時自動啓用perf透鏡。
注意事項¶
- 代碼鏈接：GitHub 上的代碼鏈接渲染需要完整的 Commit SHA 和行號範圍（格式：
#L[start]-L[end]）。 - GitHub CLI：若未安裝或未認證
gh，PR 模式無法自動回覆評論。 - 文件命名：本地報告文件名在 Git 倉庫中會包含當前 HEAD 的短 SHA（
code-review-<sha7>-<slug>.md）。
結語¶
dsh-command-code-review 爲 DSH 生態提供了一個標準化的代碼審查入口。通過配置透鏡和閾值，它可以將 LLM 的分析能力轉化爲具體的開發工作流，適合需要嚴格把控代碼質量的團隊。更多細節可參考插件目錄：https://www.skillhub.cn/plugins/JasonFreeLab/dsh-command-code-review 或源碼：https://github.com/JasonFreeLab/dsh-command-code-review。
