前言¶
在 DeepSeek Harness（DSH）裏寫代碼、改文件時，主會話裏的智能體往往已經帶着上下文在幹活；若再讓同一條對話「順便 code review」，審查意見容易和實現步驟纏在一起，也不利於你單獨決定是否採納。社區插件 dsh-code-review（維護者 SeanTolstoyevski，GitHub 倉庫 SeanTolstoyevski/dsh-code-review）的定位是：在 Harness 會話裏用 /review 觸發一次獨立審查，由 reviewer 模型審計工作區未提交改動，並把報告以卡片形式出現在對話中——默認不告知主 agent、不讀入其上下文、也不自動改代碼。
這是什麼¶
一句話：On-demand code review for DeepSeek Harness——按需代碼審查。分類上常歸在「模型推理」：審查本身由配置的 reviewer 模型完成。包名爲 @local/dsh-code-review，當前資料中的版本爲 1.5.0，許可證 MIT；純 JavaScript bundle，無額外 npm 依賴。
核心功能¶
審查命令與範圍¶
在目標會話中輸入 /review，默認對倉庫相對 HEAD 的全部未提交改動運行，內置模式爲 cr（針對變更行）。可選 arc，從變更「形狀」做架構向審查；還可在設置文件的 modes 下自定義模式（角色、finding 字段、嚴重級別詞彙、運行預設等）。
命令支持多種參數，例如限定本會話改動的文件、指定模式與模型、忽略路徑、附加 focus 消息等。reviewer 不會讀取會話 transcript；focus 消息是你寫給 reviewer 的唯一自定義文本。
兩種內置模式與可擴展 modes¶
| 模式 id | 含義（資料原文） |
|---|---|
cr |
reviews the changed lines |
arc |
reviews the shape of the change |
未解析的 mode=、reasoningEffort= 等會在調用模型前被拒絕，並列出可用名稱。
中斷仍可用的審查結果¶
reviewer 在每條 finding 落定後立即記錄。流中斷、超時、取消或模型未跑完時，已記錄內容仍會交付，並標記爲 incomplete，而不是整份丟失。
與主 agent 隔離（默認）¶
默認情況下：主 agent 不知道審查發生、審查內容不進入其上下文、也不會因審查自動改代碼。例外：開啓 projectAccess 時，reviewer 通過 Harness 自帶工具讀項目，Harness 會將這類訪問計爲主 agent 曾觸碰相關文件，可能影響後續 instruction 文件——審查報告本身仍不會進入 agent。
報告卡片與證據校驗¶
對話中出現一張卡片：標題隨 mode，摘要與 verdict 芯片按模式詞彙展示，每個 finding 按該 mode 聲明的字段分塊。Copy report 複製整份 Markdown；Copy 複製單條 finding。每條 finding 會引用證明它的代碼行，並與 diff 及 reviewer 實際讀過的文件覈對；站不住腳的 claim 以 withheld 列出原因，而非直接發佈。卡片僅展示與複製，沒有會把內容發回 agent 的控制項。
尚未發送會話首條消息時，Harness 不繪製 transcript，/review 也不會開啓新 turn，卡片先出現在 composer 上方，會話開始後再移入 transcript，並顯示該會話最新一次 /review 的結果（含錯誤）。
安裝與啓用¶
插件是 DeepSeek Harness profile 的 bundle，安裝時不編譯、不拉依賴。
- 在會話中通過 bundle 安裝器安裝，或使用 Web UI 的 plugin manager 粘貼倉庫 URL 安裝。資料中的安裝目標爲：
plugin_manager
action: install_bundle
target: github:SeanTolstoyevski/dsh-code-review
若從本地目錄安裝，將 target 換爲該目錄的絕對路徑即可（與 clone 後安裝等價；本文不展開 clone 步驟）。
-
重啓
dsh web。替換包後需重新生成模塊才能加載 JavaScript；首次啓動會寫入DSH_HOME/code-review/config.json（含全部設置與兩種內置模式的默認值）。 -
刷新頁面（客戶端半部分按頁拉取一次）。
-
在需要被審查的會話裏輸入
/review。
安裝與運行發生在本機 DSH 進程權限下；安裝前請自行查看倉庫源碼與 MIT 許可證，確認符合你的安全與合規要求。
典型用法¶
完整命令形式（資料原文）：
/review [full|session] [mode=<id>] [provider=<id>] [model=<id>] [reasoningEffort=<id>]
[language=<code>] [gitRev=<rev>] [source=auto|git|session] [ignored=<pattern,…>]
[ignoreDefaults=<bool>] [respectGitIgnore=<bool>] [focus message]
常見示例：
| 示例 | 作用 |
|---|---|
/review |
相對 HEAD 的全部未提交改動，cr 模式 |
/review mode=arc |
同一變更集，架構向 arc 模式 |
/review session |
僅本會話寫入或編輯的文件 |
/review ignored=fixtures/,!dist/ |
忽略 fixtures/，仍審查 dist/ |
/review reasoningEffort=max |
使用 provider 最高 thinking 檔位 |
/review session Thoroughly review the a/b/c.go file. |
參數之後爲 focus message |
更細的 modes、配置鍵、忽略規則、運行流程與 finding 語義見倉庫內 docs/reference.md 各章節（Modes、Configuration、Ignored paths、How a run works、Findings、The card、Limits 等）。
適用場景與注意¶
適合誰：已在 DSH Web 裏用 Harness 改代碼、希望在同一界面拿到獨立、可拷貝審查報告、且默認不想讓主 agent 被審查結果「帶跑」的開發者。
注意：
- 審查依賴你配置的 reviewer provider/model；無效名稱會在跑模型前失敗並提示可解析項。
- 插件以當前 dsh 進程權限運行；
projectAccess會改變 reviewer 讀項目的方式及對 instruction 文件的間接影響，啓用前請讀配置文檔。 - 社區目錄 skillhub.cn 插件頁 與 DeepSeek / 幻方無官方從屬關係，DSH 生態強調「一切皆插件」，本文事實以 GitHub README 與 package 元數據爲準。
結尾¶
經過上面的步驟，你可以在 Harness 會話裏用 /review 對未提交改動做按需審查，在卡片裏閱讀經證據門控的報告並自行決定是否修改。倉庫與說明：GitHub — SeanTolstoyevski/dsh-code-review；目錄索引：skillhub.cn/plugins/SeanTolstoyevski/dsh-code-review。
