前言¶
在 DSH 裏手工開子會話派活，常見瓶頸往往不是「模型不夠強」，而是三件事缺少固定做法：該用哪檔模型、該注入什麼人設、任務書寫到什麼程度纔算可執行。編排者若每次都臨時決定，成本會落在重複溝通和事後對不上驗收標準上。oh-my-claudecode 等實踐已經表明：按角色複雜度分配模型，比全員上最貴檔更合理。dsh-agents 把角色目錄、檔位路由和任務書合成收進一次工具調用，讓派活可審、可覈對、可落在標準 DSH 會話裏。
這是什麼¶
dsh-agents 是社區維護的 DSH 插件（GitHub：wangyuanchuan2022/dsh-agents，當前 package 版本 0.1.0，MIT 許可）。維護者爲 wangyuanchuan2022。插件向宿主註冊 agent_roles、agent_taskbook、agent_spawn 三個工具：23 個專職角色按 build / review / domain 三條泳道組織，每個角色釘在三檔模型路由（LOW / MEDIUM / HIGH）之一；一次 agent_spawn 即完成檔位解析、人格注入、八節任務書合成，並創建可接管的標準 DSH 子會話。另含 25 個工作流技能目錄（skills/ 下 25 個 SKILL.md）用於端到端編排，以及內置 advisor 等機制（詳見倉庫 README）。
社區目錄頁：https://www.skillhub.cn/plugins/wangyuanchuan2022/dsh-agents（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
角色與檔位¶
合計 23 個角色：HIGH 檔 11、MEDIUM 檔 10、LOW 檔 2。其中 19 個角色移植自 oh-my-claudecode，4 個爲插件新建（rag-reviewer、silent-failure-hunter、spec-miner、harness-optimizer）。檔位語義在 README 中約定爲：LOW 偏窄而快的檢索與文檔；MEDIUM 偏實現、調試、測試與設計；HIGH 偏需求分析、規劃、架構與長鏈推理。
九個子角色在上游標註爲只讀（disallowedTools: Write, Edit），任務書中寫成只讀顧問條款；插件說明中同時註明這只是文字約束，執行邊界仍取決於宿主與會話權限（見倉庫「已知限制」）。
檔位映射分兩層：cordis.patch.yml 的出廠默認與用戶層覆蓋（設置頁「Agents 三檔模型路由」或 agent_roles action=set）。解析優先級爲：調用期顯式 tier / provider / model → roleOverrides → settings → cordis 基底 → 內置默認表。未知檔位、未知角色或非法配置會拋錯，不靜默兜底。
三個工具¶
| 工具 | 作用 |
|---|---|
agent_roles |
角色目錄、單角色詳情、檔位路由表體檢；支持 list / show / tiers / set / reset |
agent_taskbook |
只合成任務書，不創建會話；含派活前置三問與本次路由解析結果 |
agent_spawn |
一步派活；dryRun=true 僅返回路由與任務書；越檔參數會記入返回以便審計 |
會話生命週期中的 wake / status / list / rename 由宿主 de_session 負責，本插件只負責創建會話。
任務書與會話產出¶
派活首條消息爲八節任務書：角色卡、職責與邊界、人格細則（personas/<id>.md）、本次任務、交付與驗收（含落盤路徑與硬性完成標準）、澄清模式、彙報與回收、Claude Code → DSH 工具映射。評審類角色可附加「上下文隔離契約」；對下發材料有機檢泄漏告警（isolationLeaks）。
默認產出路徑爲 <cwd>/agent-out/<角色id>-<yyyyMMdd-HHmm>.md，可用 evidencePath 覆蓋。
工作流技能與其它能力¶
README 列出 25 件工作流技能，分入口、流水線、協作、方法論、顧問等組；例如 agent-workflow-router 作總入口，agent-autopilot / agent-feature / agent-bugfix / agent-review-squad 等串聯 23 角色。另有 11 份按語言或專項路由的評審清單，以及確定性機檢工具 crgate 與 publish-scan。內置 advisor 在每 turn 後被動評審主會話可見消息，不佔上述三個 agent 工具位。
環境要求¶
- DSH 需提供
tools服務（工具經ctx.tools.register註冊）；settings/llm/workspaceRegistry/agentPresets爲可選，缺失時插件仍可加載但部分能力降級。 - Node.js 需支持 ESM；倉庫開發環境爲 Node 24。
- 新增 bundle 後需重啓 DSH：宿主引導圖在啓動時生成，運行中新增的插件不會被加載。
安裝與啓用¶
安裝命令以倉庫 README 爲準：
# 本地路徑安裝（推薦先 git clone 到本地）
dsh plugin --profile <profile-name> add /path/to/dsh-agents
# 或直接從 git 安裝
dsh plugin --profile <profile-name> add https://github.com/wangyuanchuan2022/dsh-agents
宿主契約與既有 DSH 插件一致：package.json 的 dsh.bundle.patch 指向 cordis.patch.yml，lib/index.js 導出 name / inject / apply。安裝後不要在 profile patch 裏重複插入同一插件 id，否則 loader 可能失敗。人格正文在 personas/；可用 tools/install-personas.mjs 批量安裝到 DSH（默認跳過已有自定義版本的角色）。
插件以當前 DSH 進程權限運行；安裝前應自行審閱源碼與 MIT 許可證，確認角色與任務書是否符合你的安全與合規要求。
典型用法¶
下面三步來自 README 快速開始，適合先摸清角色與檔位，再審任務書，最後派活。
// 1. 看有哪些角色、各自檔位與實際解析到的模型
agent_roles(action="list", lane="review")
agent_roles(action="tiers") // 檔位路由表體檢：配置的 provider/model 是否真的存在
// 2. 派活前先審任務書（只合成，不創建會話）
agent_taskbook(role="code-reviewer", task="評審 src/ 下這批改動，給出 P0/P1/P2 分級")
// 3. 一步派活：解析檔位 → 注入人格與任務書 → 創建標準 DSH 會話並立即開跑
agent_spawn(role="executor", task="實現 X，按 tests/ 現有風格補測試")
派活方可用 de_session action=status|list 做角色回收覈對。派活前建議執行 agent_roles action=tiers 查看當次生效檔位與來源（tierSources），勿假設某檔固定指向某個模型名。
適用場景與注意¶
適合已在 DSH 中頻繁開子會話、希望把「誰做、用什麼模型、交付標準」固化下來的開發者或團隊。流水線類技能適合功能開發、修 bug、評審小隊等可重複編排的場景；只讀顧問類角色適合探索、架構討論、代碼與安全評審等需要隔離上下文的席次。
應注意：只讀條款不等於宿主強制禁寫；副作用關鍵詞告警採用 fail-closed，但任務是否可行仍取決於目標會話工具與數據。配置錯誤會直接報錯，需按 README「配置參考」與設置頁調整三檔路由。社區目錄星標等數據會變動，以 GitHub 與目錄頁當時信息爲準。
結尾¶
dsh-agents 把多智能體派活從「每次口述規程」收成「角色 + 檔位 + 任務書 + 標準會話」一條鏈路，並附帶工作流技能與評審、機檢等擴展能力。進一步瞭解安裝細節、技能列表與已知限制，請閱讀倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/wangyuanchuan2022/dsh-agents
- GitHub：https://github.com/wangyuanchuan2022/dsh-agents
