前言¶
在 DeepSeek Harness（DSH）的工作流中，Agent 团队通常用于扩展执行能力：分配不同角色、拆分子任务、合并产出。这种模式适合处理重复性强或需要并行执行的任务。
dsh-consult 解决的是另一类问题：决策质量。它不负责执行任务，而是为需要审慎判断的决策提供“第二意见”。当任务完成后，主 Agent 负责调查和验证，将收集到的证据打包，然后向一组独立的模型发起咨询。这些模型基于相同的证据回答同一个问题，主 Agent 再对比并综合它们的匿名意见，最终做出决策。
功能与定位¶
该插件是一个独立的 DeepSeek Harness 插件，由 DK-Zhu 维护，遵循 MIT 许可证。它的核心作用是在决策边界引入多模型视角，用于审查架构选型、安全边界、发布就绪性等高杠杆问题。
主要能力包括：
* 证据优先：仅当证据准备就绪时触发咨询，不会在执行过程中产生自动的模型调用消耗。
* 并行独立审查：配置的模型（顾问）并行工作，彼此之间无法对话、辩论或查看对方观点。
* 匿名综合：主模型只看到稳定的标签（如“顾问 A”），看不到具体的模型提供商名称，确保判断基于内容而非品牌。
* 权限隔离：咨询过程中，顾问模型没有工具访问权限，也没有工作区或历史记录访问权限。
安装与配置¶
使用前需满足以下环境要求：
* Node.js >= 22.19.0
* DeepSeek Harness 0.1.5-rc.2
1. 安装插件¶
通过 DSH 插件管理器安装：
dsh plugin --profile web add dsh-consult
2. 配置咨询面板¶
安装后插件处于休眠状态。需要在对应的 Profile 配置文件中启用咨询功能。例如，在 ~/.dsh/profiles/web/cordis.patch.yml 中添加以下内容（具体路径取决于 DSH_HOME 环境变量）：
- id: consult
config:
consultants:
- provider: "<provider-id-a>"
model: "<model-id-a>"
- provider: "<provider-id-b>"
model: "<model-id-b>"
配置项说明：
* provider：模型服务的标识符。
* model：该服务下具体的模型标识符。
* 可以配置 2 到 5 个模型作为顾问。相同的 provider 可以选择不同的 model。
* 验证配置并启动 DSH：
dsh --profile web --dump-config
dsh web
使用方法¶
咨询通过 /consult 命令触发。主 Agent 在完成实施和测试后，准备证据，然后向面板提问。
典型调用示例¶
/consult Finish the implementation and tests, then ask the panel whether this is ready to ship.
/consult Review the cache invalidation redesign. Inspect the implementation and tests first, then decide whether it is ready to ship.
执行流程¶
- 用户发起
/consult命令。 - 主 Agent 调查、实现并验证，准备一份证据包。
- 证据包被发送给所有配置的顾问模型。
- 顾问模型并行生成独立意见。
- 主 Agent 汇总这些匿名意见，输出最终建议。
适用场景与注意事项¶
适用场景¶
该插件最适合用于决策边界，特别是当存在不确定性或高杠杆影响时：
* 在多个合理的架构方案中做选择。
* 审查安全、隐私或数据保留边界。
* 检查发布前的就绪状态。
* 评估迁移或回滚计划。
* 平衡性能、可维护性、兼容性和用户体验。
注意事项¶
- 手动触发：咨询是显式的，不会在执行过程中自动触发，这避免了不必要的 Token 消耗。
- 数据隐私：完整的证据包会被发送给所有配置的顾问，并持久化到 DSH 的会话事件日志中。在请求咨询前，需确认该材料适合发送给外部提供商，也适合本地持久化。
- 成本控制：模型调用仅发生在咨询时刻，且由用户显式控制面板大小，没有后台自动消耗。
总结¶
dsh-consult 将模型多样性保留在决策时刻，而非执行过程中。它通过提供一种受控的、证据优先的审查机制，帮助开发者对关键决策进行验证。
