前言¶
如果你已經在 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
