前言¶

DeepSeek Harness（DSH）采用插件化架构，开发者可以根据需要扩展能力。在构建复杂智能体时，如何让模型在运行过程中进行自我审查、验证路径的合理性，同时保持对主流程的控制，是一个常见需求。dsh-deliberation 插件提供了这种机制。

这是什么¶

dsh-deliberation 是一个为 DeepSeek Harness 设计的插件，由 fly1989 维护。它主要解决智能体在推理过程中的自我审查与路径验证问题，允许主控流程发起推演或请求遮蔽审查，而不需要主控模型决定是否信任。

核心功能¶

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

• Primary-controlled deliberation（主控推演）：由主控流程主动调用工具进行推演，而非由模型随机决定。
• Opt-in reasoning-masked review（推理遮蔽审查）：通过遮蔽推理过程，仅查看行动结果，进行审计。
• deliberate tool：运行受限的替代、审计或遮蔽审查子进程。
• automatic masked review：可选的自动遮蔽审查功能。

安装与启用¶

安装该插件需要满足 Node.js 环境（22.19+ 或 24+）和 pnpm。DSH 的插件安装命令会自动转发到 pnpm。安装命令如下：

npx @deepseek-ai/dsh plugin --profile web add dsh-deliberation@0.1.0

安装或更新插件后，必须重启正在运行的 Web 进程才能生效。

典型用法¶

手动调用推演
模型仍需决定是否调用 deliberate 工具。测试时可使用以下提示词引导：
1. 先使用只读工具收集具体观察。
2. 调用 deliberate，并在最近完成的步骤上开启一个轨迹审计分支和一个遮蔽审查分支。
3. 子进程返回紧凑的 JSON 包，主控根据结果决定下一步。

启用自动遮蔽审查
默认情况下自动审查是关闭的。通过应用配置补丁可以启用。示例配置（参考 examples/auto-review.patch.yml）如下：

autoReview:
  enabled: true
  scope: tool-bearing-turns
  provider: mid-fork-current-turn

适用场景与注意¶

角色定义
插件定义了三种推演角色：
* independent-alternative：寻找不同的机制或策略。
* trajectory-audit：验证当前轨迹，定位最早的可疑决策。
* masked-review：在不查看推理过程的情况下重读可观察的行动和结果。

注意事项
* 状态：目前处于实验预览阶段。配对基准数据尚未确立正确性或成本优势，因此自动审查默认禁用。
* 权限：子进程从不投票、不选择获胜者或替换主控。
* 确定性：确定性是子进程的自我报告，并非事实验证。
* 配置机制：DSH 补丁行会替换目标行的整个配置，不进行深层合并。

短结尾¶

dsh-deliberation 为 DSH 提供了可控的推演和审查能力，适合需要在运行时进行安全检查或路径验证的开发者。更多细节请参考插件目录或GitHub 仓库。