DeepSeek Harness（DSH）采用插件生态。单个 Harness 具有单一视角。在做出关键决策、在宣布风险工作完成前，或在进行显著的新代码编写前，第二模型能提供有用的独立证据。该插件将咨询转变为有界工具调用，而非复制粘贴的变通方法。Claude 在行为和输出合同下回答，DSH 将结果作为供权衡而非服从的建议接收。
核心功能¶
该插件提供了一套围绕外部专家咨询的工具集：
- Role contracts（角色合约）：内置 advisor（顾问）、reviewer（审查员）、designer（设计师）与自定义角色，具有不同的目标和 JSON 合同。可配置
outputKind、prompt、model、fallback和effort。enabled标记可将角色挂起而不删除。 - Thinking effort（思考投入）：原生
--effort（low / medium / high / xhigh / max），优先级为：per-call argument > role > global default。 - Model fallback（模型回退）：模型级别错误（如
unrecognized_model、model-not-found）的一跳重试，usedFallback记录在运行元数据中。 - Agent tools（代理工具）：
consult_expert：单一角色、单一问题，可选结构化brief。consult_panel：在brief上并行调用多个不同角色，非多数票。consult_roles：实时角色列表，包括outputKind、角色级别 model/effort 和全局默认值。
- Auto consult（自动咨询）：
- Composer-seat toggle：权限控制行的 Expert Consult 开关，勾选的角色在会话中加入选择条件和生命周期提醒。
- Policy section：模型请求名称勾选的角色及其选择条件，模式为
off | remind | hard-remind（默认remind）。 - Lifecycle nudges：在文件写入前或任务完成前触发提醒。
- Budget：
capPerRole（默认 3），限制每角色每会话的真实consult_*调用数。
- Settings workspace（设置工作区）：每个 Harness CLI 一个标签页；热应用支持，角色编辑可直接作用于下一次模型步骤，无需重启。
- Connectivity test（连通性测试）：真实的端到端咨询测试（CLI + 登录 + 代理），包含轮次、持续时间、成本和回退标记。
- Defense in depth（纵深防御）：对工作区只读的 CLI 工具；严格 MCP 隔离；权限锁定；有界输出/轮次/时间；明确标记不受信任的证据。
- Fully bilingual UI（双语界面）：完全支持中文/英文，包括内置角色描述、后端说明和验证消息。
安装¶
通过官方命令行安装插件：
dsh plugin --profile web add dsh-capability-optimizer
安装后，重启 dsh web 或您选择的 profile。
前置要求：
* claude CLI（npm i -g @anthropic-ai/claude-code）必须在 PATH 中。
* 需已登录 Claude 账户。
典型用法¶
在对话中直接调用代理工具。例如：
“consult the reviewer on this diff before we call it done”
Agent 会自动选择角色并调用 consult_expert。
对于结构化任务，可以发送 Structured brief：
objective（目标）successCriteria（成功标准）constraints（约束）currentAttempt（当前尝试）artifacts（产物）verification（验证方式）unknowns（未知项）
Claude 返回的回复包含模型、轮次、持续时间、成本和协议元数据。
| 工具 | 工作区读写 | 用途 |
|---|---|---|
consult_expert |
read* | 单一角色、单一问题，可选 brief 或 context |
consult_panel |
read* | 多个角色并行咨询 |
consult_roles |
read | 实时角色列表及配置 |
* 对工作区为只读；每次调用消耗 Claude 订阅配额。
适用场景与注意¶
适用场景：在关键决策点、代码审查、设计阶段需要第二模型视角的场景。
注意事项：
* 权限隔离：Agent 工具对工作区是只读的，不会修改文件，但会消耗 Claude 订阅配额。
* 指令传递与强制调用：Nudges 保证指令被传递，而非强制工具调用。模型拒绝时需在单行中说明原因。
* 状态展示：状态栏使用轮询和服务器截断预览，并非所有主机上的 token 流式传输。
* 阶段限制：当前阶段（Phase 1）仅针对 Claude Code CLI。其他后端（codex, zcode 等）计划后续支持。
总结¶
dsh-capability-optimizer 将外部专家咨询集成到了 DSH 的工具链中，通过角色合约和结构化 brief，提供了可控的参考答案，帮助 Agent 在重要决策前进行独立验证。
