前言¶
如果你已经在 DeepSeek Harness（DSH）中运行一个 AI 编码代理，希望把不同任务交给不同模型、不同后端、不同工具集和不同结果契约，又不想再引入一套独立多智能体框架，下面介绍 dsh-legion。
DSH 的插件生态允许在已有运行时上扩展能力。相比在每次提示中直接写模型 ID，或采用自带 runtime、state、process lifecycle 的独立多智能体框架，dsh-legion 的做法是把委派策略交给部署侧配置：协调代理只选择语义 Specialist，例如 quick、deep、review，具体 model route、subagent backend、persona、tool filter、depth 和 result contract 由插件配置决定。
这是什么¶
dsh-legion 是 wxxb789 维护的 DeepSeek Harness 插件，定位为 TypeScript 多智能体编排与 LLM 模型路由插件。许可证为 MIT。
它是 DSH 插件，不是独立代理框架或应用。DeepSeek Harness 提供 Agent、Session、model adapters、subagent runtime、sandbox、approvals、Web GUI；dsh-legion 不额外引入 scheduler、session store、database 或 agent runtime。
核心功能¶
语义 Specialists¶
dsh-legion 提供一个面向模型的 legion 工具，供协调代理选择语义 Specialists，例如：
quick
deep
review
这些名称用于表达委派意图，替代每次提示中的原始模型选择。
精确模型路由¶
每个 Specialist 可以携带部署自有的 model route。路由支持最多 8 个有序 provider/model 候选，并带静态上下文和输出预算约束。
多种后端与策略¶
每个 Specialist 可使用 spawn、fork、codex、claude-code 或其他 DSH 注册的 subagent provider。
同时可配置：
- 子代理工具限制；
- Specialist 指令；
- 深度；
- 前台 / 后台默认。
结构化结果¶
dsh-legion 提供版本化前台结果契约：
text
findings-v1
review-v1
Cohorts 与 Strategies¶
自定义 Cohorts 可声明有界 Member Slots，并引用现有 Specialists。
声明式 Strategies 可把类型化 artifact 图编译为冻结的 DSH 委派原语。
每个 Cohort Run 可设置硬限制，包括：
agents
并发
deadline
可接受输出大小
Catalog 与提示资源¶
Catalog 定制支持对用户或第三方 catalog 条目进行：
- 分层；
- 替换；
- 禁用；
- 恢复。
Prompt Fragments 可从部署自有根目录加载受限、不可变的 UTF-8 提示资源。
可解释性与边界¶
dsh-legion 提供稳定 digests、确定性诊断、路由证据和 JSON explain 输出。
需要注意的边界是：提示只能选择 Specialist，不能扩大该 Specialist 背后的 model、tools、persona 或 depth。dsh-legion 不提供聚合 token 或货币成本 admission。
安装与启用¶
下面步骤用于把一个已运行 DSH 的环境接入 dsh-legion。
1、安装插件到 DSH host profile。可追加 #<commit-sha> 以固定 revision。
dsh plugin --profile web add github:wxxb789/dsh-legion
2、将 Legion 行复制到用户自有的 agent preset，然后启动新会话。模板路径为：
examples/legion.agent.cordis.fragment.yml
3、依赖路由前验证路由策略。这一步用于在运行时前检查配置与 provider 能力 fixture。
dsh-legion doctor examples/legion.config.yml --providers examples/providers.fixture.yml
经过上面的步骤，协调代理最终看到一个 legion 工具，其 specialist 值为语义委派选择。
典型用法¶
dsh-legion 适合以下用途：
- 按任务类型路由；
- 运行独立 review；
- 构建多智能体 workflow；
- 约束工作量和风险；
- 标准化委派；
- 在运行时前验证策略；
- 通过 Catalog Layers 定制。
例如，quick 可用于较快完成的任务，deep 可用于需要更深推理的任务，review 可用于独立审阅。实际路由、后端、工具、深度和结果契约仍以部署侧配置为准。
适用场景与注意¶
适合对象：
- 已经运行 DSH；
- 希望多智能体委派可审查、可复用；
- 不想再引入独立 scheduler、session store 或 agent runtime；
- 需要在运行时前验证委派策略。
注意事项：
- 如果不运行 DSH，dsh-legion 不是合适工具，独立框架更适合；
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证；
- 许可证为 MIT；
- 环境资料标注 Node.js 要求为
^22.19.0或>=24.0.0，TypeScript 标记为 strict； - DSH 插件目录是独立站点，不是官方应用商店，与 DeepSeek / 幻方无官方从属关系；
- 本次已核实资料未给出可确认的目录页 URL，因此此处不列出。
结尾¶
dsh-legion 的价值在于：在 DSH 已有运行时上增加一层可审查的多智能体委派策略，而不是替换 DSH 或引入第二套 runtime。它把语义 Specialists、精确模型路由、后端选择、工具策略、结构化结果和硬限制放在一起，适合已经在 DSH 上工作、并希望把委派策略配置化的团队。
GitHub：
https://github.com/wxxb789/dsh-legion
