前言¶

DeepSeek Harness (DSH) 的设计理念是让日常模型处理常规工作，而在关键决策、重复失败或回合结束时，由更强的顾问模型提供第二意见。dsh-advisor-flow 是一个将 pi-advisor-flow 移植到 DSH 的插件，它为智能体增加了咨询工具、审查门限、使用账本和隐私分级功能。

插件简介¶

名称：dsh-advisor-flow
维护者：ccll
定位：DeepSeek Harness (DSH) 插件，提供按需执行的审查与顾问工作流。

该插件解决了智能体在运行过程中缺乏外部审查机制的问题。它通过引入一个独立的顾问模型（复用 DSH 的模型路由），在不接管主流程控制权的前提下，对执行计划、失败重试和最终结果进行强制审查。

核心能力¶

该插件提供以下核心功能：

1. 按需咨询工具：执行器可在需要时调用 ask_advisor 工具。该工具支持通用审查（无参数），或传入具体问题、草稿、仓库上下文分级及文件列表进行针对性审查。每次回答携带 adviceId 以便后续引用。
2. 手动咨询：会话所有者可随时使用 /advisor-manual [focus] 命令发起咨询，或使用 /advisor cancel 取消进行中的咨询。
3. 硬循环门限：当工具调用签名重复达到预设阈值（默认为 3）时，系统会拦截调用并请求顾问审查。顾问返回 proceed（继续）、revise（修订）或 blocked（阻塞）三种裁决。
4. 执行指南注入：插件会在系统提示中注入执行指南，包括 before-plan（前计划）、after-failure（失败后）和 before-completion（完成前）三个阶段的约束。
5. 硬完成审查：在默认的 hard 模式下，每个回合关闭前都会进行强制审查。若裁决为 revise 或 blocked，顾问会将建议反馈给执行器。soft 模式则仅作为参考。
6. 结果记录：执行器可使用 record_advisor_outcome 工具记录建议是否被采纳及验证结果，默认关闭。
7. 使用账本与状态：通过 /advisor status 命令，可查看会话状态、门限统计以及按触发类型分类的 Token 消耗和成本明细。
8. 隐私分级：支持仓库上下文分级（关闭/摘要/完整）。敏感数据在发送前会被替换为占位符（redactSecrets），文件内容仅在独立确认后才会离开本地。
9. 非阻塞保证：无论顾问服务或门限检查失败，都不会阻塞主智能体的循环。

安装与启用¶

由于 npm 发布尚在进行中，目前需直接从仓库安装。

dsh plugin --profile web add github:ccll/dsh-advisor-flow

安装后，若未在界面看到设置卡片，请重启 dsh web。

配置文件位于 settings.yaml 的 advisor-flow 命名空间下。启用插件需同时配置 advisor-flow.enabled 以及 advisor.provider 和 advisor.model。

advisor-flow:
  enabled: true
  advisor:
    provider: deepseek-official
    model: deepseek-reasoner
  mode: hard
  gates:
    plan: { enabled: true }
    failure: { enabled: true }
    loop: { enabled: true, threshold: 3 }
    completion: { enabled: true }
  failureMode: block-tool
  privacy:
    repoContext: summary
    redactSecrets: true

使用方式¶

插件通过命令行和工具两种方式交互。

命令行交互：
- /advisor-manual [focus]：立即启动手动咨询。
- /advisor cancel：取消正在进行的咨询。
- /advisor：切换会话的顾问模式（开启/关闭）。
- /advisor status：查询会话状态、门限统计和成本。

工具调用示例：
执行器调用 ask_advisor 获取通用审查：

// 无参数，进行通用审查
ask_advisor()

调用 ask_advisor 获取针对特定问题的审查：

ask_advisor({
  question: "当前的重试策略是否存在风险？",
  draft: "重试 3 次，每次间隔 1 秒...",
  repoContext: "summary" // 只能缩小所有者允许的分级范围
})

注意事项¶

• 非接管原则：顾问模型仅提供建议，不直接调用工具或修改文件，工作流控制权始终在主智能体手中。
• 兼容性：插件依赖 DSH 的插件接口，package.json 中声明的兼容版本为 0.2.0-rc.2，但 README 中测试环境为 0.1.5-rc.1，安装前请确认环境兼容性。
• 安全：默认不开启敏感数据删除，建议在设置中开启 redactSecrets，确保敏感值在截断前被替换。

结语¶

dsh-advisor-flow 为 DSH 智能体提供了一个标准化的审查层，通过配置化的门限和隐私分级，帮助开发者在保持工作流自主权的同时，引入外部模型的监督能力。

GitHub 仓库
SkillHub 插件目录