dsh-advisor-plugin: DeepSeek Harness 審查模型插件

前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許開發者擴展行爲。當同一個模型既寫代碼又驗代碼時，容易出現“證明自己是對的”的情況，這會導致長鏈路 Coding Agent 的三類常見失效——自驗證盲區、長程漂移、過早宣告完成。dsh-advisor-plugin 的核心作用是引入“獨立第二意見”，通過審查模型來緩解這些問題。

插件定位¶

該插件名爲 leeyoung1/dsh-advisor-plugin，定位爲 DeepSeek Harness advisor 策略模式插件。它通過將一個快速執行模型與一個更強的審查模型配對，在關鍵節點把整段會話交給審查模型，拿回 plan / correction / stop 信號後繼續執行。

核心功能¶

插件提供了兩條互補的通道和一系列輔助能力：

顯式諮詢通道
執行模型零參數調用 advisor()，整段會話與工具清單自動轉發給審查模型。模型不需要組織上下文即可完成諮詢。
自動巡邏通道
每 N 步把會話快照發給審查模型。審查模型判斷當前狀態爲 ON-TRACK、CORRECTION 或 STOP。干預最早落在下一個模型請求，不會打斷正在飛行的 turn。
輔助能力
- 只讀調查工具：審查模型可先在工作區內 search_files / read_file 覈實事實，再給建議。
- 失敗隔離與雙降級：審查調用失敗、超時、空正文、上下文溢出都不會中斷執行模型的 turn。上下文溢出時會做安全截斷後重試。
- 執行模型黑名單：支持 model、provider/model、provider/model@effort 三種語法，用於禁用特定模型的審查功能。
- 設置頁可視化：所有審查配置都在 DSH 設置頁完成，包括模型與推理檔位、巡邏模式兩個區塊的配置。

安裝與啓用¶

安裝插件：

    dsh plugin --profile web add dsh-advisor-plugin

重啓 dsh web。

安裝完成後，打開 設置 → 插件，找到 Advisor 審查模型 卡片。選擇一個比執行模型更強的審查模型，按需設置推理檔位。按任務類型決定是否開啓巡邏模式。

典型用法¶

會話指令：在會話中執行 /advisor，或讓執行模型調用 advisor() 工具。
配置文件：也可以直接編輯 ~/.dsh/settings.yaml 中的 advisor 部分：

    advisor:
      enabled: true
      provider: example-provider
      model: reviewer-model
      effort: high
      patrolEnabled: true
      patrolEverySteps: 6
      patrolImmuneTurns: 3
      investigate: true
      disabledForModels:
        - deepseek-v4-pro
        - gpt-5.2@high

未武裝零成本：沒有配置審查模型時，工具和提示段都不註冊。

依賴與兼容性¶

DSH 版本：目標版本爲 0.1.5-rc.1 或 0.1.5-rc.2。
Node.js：要求版本爲 >=22.19 或 >=24。
安裝方式：推薦使用 dsh plugin --profile web add dsh-advisor-plugin。不推薦使用裸 npm install。
DSH Desktop 0.2.1：存在舊包名兼容性問題，那個版本的 cordis.patch.yml 仍然引用舊包名 dsh-advisor。若遇到此問題，需先移除舊包再安裝。