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。若遇到此问题，需先移除旧包再安装。