前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在构建多智能体协作系统时，开发者常面临任务分解混乱、专家委派无门禁、交付质量不可控等问题。传统的单智能体或简单链式调用难以应对复杂项目。
dsh-expert-orchestrator 插件提供了一个「专家编排」会话模式。它引入了 PM 先行规划、依赖 DAG 任务板和分级交付门禁机制，将控制权交给编排层，确保实现过程始终由专家委派完成，而非智能体自我实现。
核心功能¶
- 每轮分诊与锚点机制：每个用户消息重新进入分诊循环，在执行任何动作前，运行包含五个锚点的自检（审阅、收敛、防漂移、协作、资源），防止跨轮次的任务漂移。
- PM 先行规划：复杂任务优先交给项目管理专家进行分解、依赖梳理和验收标准定义，然后再进行委派。
- 专家委派与合并名册：实现始终委派。系统维护一个合并专家名册（包含核心专家和启用的源专家），通过
summon_expert或summon_experts调用。递归保护通过 6 项黑名单限制子智能体行为。 - 依赖 DAG 任务板与消息总线：使用
taskboard.py工具管理依赖关系图，通过消息总线实现并行专家的磁盘落盘与摘要回复。 - 分级交付门禁：交付前需经过独立评审（评审者 ≠ 实现者，最多 2 轮返工）和 PM 检查点，最后才能提交/交付。
- 经验池与提示精简：每任务捕获 ≤3 条可复用经验注入未来任务。支持专家级提示精简（
method前置）和按需深度阅读指针。 - 安全与容错：v2.8 引入委派安全门禁（源链标记、工件所有权注册、写锁）；v2.7 实现基于事件溯源的崩溃安全编排状态。
安装与启用¶
插件以目录形式集成。将 dsh-expert-orchestrator 目录放置于 DSH 的插件加载路径下，或通过 DSH 插件管理器添加。确保 DSH 版本满足 engines.dsh 要求（>=0.1.7-alpha.2 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.3.0-0）。
典型用法¶
插件提供以下交互模式：
- 浏览专家名册
list_experts
支持紧凑和展开模式，列出合并名册中的专家，标记跨源冲突和被阴影覆盖的条目。
- 单次专家召唤
summon_expert
适用于单篇白皮书或单一领域专家的召唤。任务限制 8K 字符，自动注入净化后的角色人设。
- 批量专家召唤
summon_experts
支持批量召唤，数量 ≤8，并发数 4。具备部分成功语义。
- 任务板与增量读取
taskboard.py -- (structured envelopes)
taskboard.py --since-seq
使用依赖 DAG 任务板处理结构化信封，支持自上次序列号的增量读取。
- 配置与开关
启用工具预算和空闲边缘自动回收（建议同时开启）：
export DSH_EXPERT_TOOL_BUDGET=1 # 启用工具调用硬预算
export DSH_EXPERT_IDLE_RECLAIM=1 # 启用空闲边缘自动回收
适用场景与注意¶
此插件适用于需要严格流程管理、多角色协作和交付质量控制的复杂开发场景。
注意事项：
- 权限与安全：插件以当前 DSH 进程权限运行，请确保安装源可信（许可证为 MIT）。
- 递归保护：子智能体工具过滤器包含 6 项黑名单，防止无限嵌套。
- UI 待定：设置面板中的「清除已删除」按钮 UI 尚未实现（RPC 协议已就位）。
- 空闲循环：空闲边缘自动回收是零令牌操作，但会在事件流中可见，不会消耗模型额度。
总结¶
dsh-expert-orchestrator 通过将规划、委派和交付环节解耦并标准化，为 DSH 提供了一套多智能体编排方案。它不直接实现代码，而是通过 PM 规划和专家委派，配合事件溯源的任务板和门禁机制，确保任务交付的可靠性与质量。
