前言¶
在使用 DeepSeek Harness（DSH）开发智能体时，平衡计算成本与输出质量是常见需求。如果全程使用昂贵模型成本过高，而全程使用廉价模型则可能降低质量。dsh-escalation-advisor 插件提供了一种折中方案：在大多数情况下运行便宜模型，仅在需要时借用更强的 DSH 模型进行“咨询”或“升级”。咨询过程以可见的 DSH 子会话形式运行，而非隐藏的 LLM 请求，便于调试和审计。
是什么¶
dsh-escalation-advisor 是一个 DSH 专用插件，由 zhangqian98 维护，采用 MIT 许可证。它通过在任务树中创建可见的子会话，让用户能够检查咨询记录、工具调用、token 使用量和最终结果。插件支持三种工作模式，并允许针对不同智能体类型（主智能体与本地子智能体）配置不同的覆盖策略。
核心功能¶
三种工作模式¶
插件支持以下三种模式：
* manual：仅提供 consult_advisor 接口，无自动咨询。
* escalate：默认模式，提供手动咨询及确定性卡住/失败评分。
* continuous：在自然轮次边界进行影子审阅。
覆盖策略¶
覆盖策略可针对主智能体和本地 DSH 子智能体独立配置：
* Manual：主智能体和本地子智能体均开启。
* Automatic Escalation：主智能体和本地子智能体均开启。
* Continuous Review：主智能体默认开启，本地子智能体默认关闭。
Completion Review¶
Completion Review 是一个独立的触发器，在智能体准备最终交付时运行，检查任务是否就绪（目标、成功标准、变更文件等），并通过 concern/blocker 引导智能体。该功能默认关闭。
Advisor Profiles¶
支持配置命名的 Advisor Profiles，包含 ID、标签、模型路由和工具策略。智能体在咨询时选择一个 Profile，该 Profile 在首次咨询后被固定，后续切换 Profile 或移除工具权限均会被拒绝。
会话覆盖¶
通过 UI 头部面板或命令行可以设置版本化的 advisor/policy 记录，包括模式预设、超时、工具白/黑名单、触发器开关等。未设置项将遵循全局默认值。
安装与启用¶
安装前请确认 DSH 版本。该插件支持 DSH 0.1.2-rc.1、0.1.5-alpha.2 和 0.1.5-rc.1。CI 检查 Node.js 版本为 22.19+。
使用 npm 安装：
dsh plugin --profile web add dsh-escalation-advisor@0.1.0-alpha.29
dsh web
也可以从 GitHub 源码安装：
dsh plugin --profile web add github:zhangqian98/dsh-escalation-advisor#v0.1.0-alpha.29
安装后，在 Settings → Plugins → DSH Escalation Advisor 中配置强模型路由。该插件仅存储提供者/模型路由 ID，复用 DSH Models 中已配置的认证信息。
典型用法¶
管理策略¶
在会话中使用以下命令管理策略和触发器：
* /advisor catalog：查看或配置 Advisor Profiles。
* /advisor-trigger <trigger> <on|off|inherit>：切换手动、自动升级或完成审阅等触发器的状态。
* /advisor-tool <tool> <on|off|inherit>：控制工具的允许/拒绝策略。
配置 Profiles¶
在全局设置中配置 Advisor Profiles，指定 ID、标签、模型路由和工具策略。智能体在调用 consult_advisor 时通过 advisor_profile 参数指定使用哪个 Profile。
适用场景与注意¶
该插件适合需要在 DSH 环境中精细化控制成本与质量的开发者。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（MIT）。注意：
* 子会话排除：Advisor 子会话本身不会被手动咨询、升级评分或连续审阅，防止递归咨询。
* 默认设置：Completion Review 和 Local-subagent continuous review 默认关闭，以防止倍增强模型调用。
* 历史兼容性：升级到 0.1.5-rc.1 时，建议先备份，并运行包含的维护脚本 scripts/patch-dsh-history.mjs 以处理旧版本的历史记录。
短结尾¶
dsh-escalation-advisor 通过提供可见的、可配置的第二意见机制，帮助 DSH 用户在保持成本可控的同时提升输出质量。更多细节请参考 GitHub 仓库。
