前言¶
在 DSH 裏做複雜任務時，主智能體往往要兼顧對話、工具調用和較長鏈路的工作。若把整塊編碼、審查或探索丟給單一模型，上下文和權限邊界都難控；若手工切換多個 CLI，又很難把進度、用量和結果統一回主會話。
dsh-maestro-codex 面向上述場景：在宿主 DSH 進程內註冊派發工具，由主代理按任務類型與難度門檻，把子任務交給 headless 的 Codex CLI、Claude Code CLI 或 Grok CLI 執行，並把結果自動回填。路由、CLI 安裝、模型注入、技能橋接與監視界面集中在插件配置頁完成。
這是什麼¶
dsh-maestro-codex 是 DSH 的 CLI 子代理編排插件（npm 包名 dsh-maestro-codex，當前發佈版本 v0.1.15，MIT 許可證）。維護者爲 GaoHu1997（倉庫與 SkillHub 目錄頁 一致）。
一句話定位：把會話中的任務按類型派發給 codex cli、claude cli 或 grok cli 執行，取回結果回填主會話；並在配置頁管理路由表、各 CLI 的權限與模型，以及 CLI 本身的安裝與卸載。
核心功能¶
下面按主流程概括 README 已說明的能力，不涉及未在文檔中出現的行爲。
派發與難度門檻¶
主會話註冊 dispatch_cli_task 工具。派發前主代理先判斷是否需要子代理；不需要則自行完成。需要時再評估難度並給出理由：達到爲對應 CLI 配置的門檻才啓動外部 CLI，未達門檻則改用 DSH 內置子代理（subagent / subagent_fork），不拉起 CLI。
Claude、Codex、Grok 各自獨立的最低難度（低 / 中 / 高 / 極高，默認中）在「CLI 管理」中配置，互不影響。調用時傳 task_difficulty（low / medium / high / extreme）與 difficulty_reason；顯式指定 cli 也不能繞過門檻。
任務類型路由¶
配置頁以卡片爲 13 個內置四字任務類型指定執行器。默認分工在 README 中寫明：例如 Claude 側偏倉庫探索、影響分析、模塊重構等；Codex 側偏功能開發、缺陷修復、測試驗證等。舊類型名會映射到新名稱並保留關鍵詞兼容。
CLI 與 SDK 管理¶
配置頁檢測版本，並可通過 npm 全局安裝或卸載：
@anthropic-ai/claude-code@openai/codex@xai-official/grok
支持自定義 npm registry；「SDK 管理」區負責 Claude Code SDK / Codex SDK 的檢測與裝卸。Claude / Grok 權限策略、Codex 沙箱檔位（read-only / workspace-write / danger-full-access）與併發上限均在配置頁設置；連續無輸出超時爲各 CLI 共用一項，放在「調度設置」。
模型與思考等級¶
模型下拉直接讀取 DSH 已配置的供應商與模型（llm-pi-ai 設置與 credentials）。選中後插件在 spawn 前注入端點、密鑰與協議方言，並做 1-token 級模型預檢；兩端點都不可用則任務直接失敗並列原因，不會靜默回落到 CLI 自有配置文件中的模型（Codex 派發時使用 --ignore-user-config）。
思考等級來自所選 DSH 模型條目的 reasoningEfforts 檔位，不寫死枚舉。
技能與宿主工具橋接¶
派發時通過隨包的 dsh_bridge stdio MCP 服務器，把 DSH 技能目錄（兩段式按需加載）與宿主工具橋接給子代理。Claude 可選原生模式（claudeSkillsMode: native），將技能暫存爲 .claude/skills 樹；失敗時回退橋模式。橋接策略含 bridgeTools: off / auto / custom。
監視、看板與會話續接¶
- 任務監視：記錄
dispatch_cli_task派發的子任務，展示進度事件、取消、超時與併發。 - 任務看板：安裝 dsh-better-sidebar 後，右側欄增加「任務看板」tab，以分層樹狀圖查看主智能體與各子智能體階段與耗時。
- CLI 會話頁：回放任務與結果，統計 Token；底部輸入框可續發消息（
POST /task/reply，底層走各 CLI 的 resume 語義）。
用量與可靠性¶
用量寫入 $DSH_HOME/maestro/usage-journal；任務結果落盤至 $DSH_HOME/maestro/tasks/<taskId>.json，重啓後恢復最近 40 條。提供 GET /health、GET /status 等接口；同一父會話 + CLI + 任務名 + cwd 在 10 分鐘內重複派發可由冪等鍵擋下。進程被殺遺留的任務在下次啓動標記爲 已中斷（interrupted）。
安裝與啓用¶
安裝插件本體¶
README 寫明：
安裝到 dsh：在 dsh 插件市場或插件管理器安裝本包；
cordis.patch.yml會把dsh-maestro-codex條目插入 profile。
SkillHub 上條目爲 GaoHu1997/dsh-maestro-codex，可與目錄頁「發送給 DeepSeek Harness 安裝」的說明對照。文檔未給出固定的 dsh plugin add … 命令行，請以上述市場或管理器路徑爲準，不要憑倉庫名自行拼接安裝命令。
安裝包運行要求 Node >=22.19（內置 fetch）。
安裝並配置 CLI¶
- 在 DSH 中打開本插件「配置頁 · CLI 管理」。
- 按需爲 Claude / Codex / Grok 檢測版本並執行全局 npm 安裝（或使用「SDK 管理」安裝對應 SDK）。
- 爲各執行器勾選任務類型、最低難度，並在「dsh 模型」下拉選擇可用供應商與模型。
- 在「調度設置」中設置連續無輸出超時與併發上限。
啓用後，主會話即可使用 dispatch_cli_task；補丁會自動把插件條目寫入 profile。
典型用法¶
主會話內派發¶
典型流程不由單獨腳本驅動，而是由主智能體在對話中調用 dispatch_cli_task：
- 主代理判斷任務是否值得開子代理。
- 若需要，評估
task_difficulty與difficulty_reason，由路由表選擇 CLI。 - 未達該 CLI 門檻時，回落 DSH 內置子代理，不啓動外部 CLI。
- 子任務結束後，結果與用量投影回主會話；可在會話內任務列表與 CLI 子會話頁查看。
工具參數可顯式指定 cli 或 provider::model；後者鎖定 DSH 供應商，且仍須通過預檢與門檻校驗。
配置頁日常運維¶
- 在「CLI 管理」調整某類任務改派執行器，或臨時關閉某一 CLI。
- 在 CLI 會話頁對已完成任務 續發消息，沿用原難度門檻與路由，並繼承上一輪 DSH 模型配置（服務端按協議過濾可選模型）。
命令行查看狀態快照¶
README 提供運維腳本（需在實際插件安裝目錄下執行，或使用腳本絕對路徑）：
node scripts/maestro-status.mjs --json
該腳本依賴與插件相同的 Node 版本，用於讀取 GET /status 一類信息的命令行快照；亦可結合 GET /health 做健康檢查。
適用場景與注意¶
適合誰：已在 DSH 中集中配置多供應商模型，並希望把「大塊編碼 / 審查 / 探索」交給專業 CLI、同時保留主會話編排與可觀測性的開發者。
生態說明：DSH 奉行「一切皆插件」；SkillHub 爲社區目錄，與 DeepSeek / 幻方無文檔所載的官方從屬關係。
安全與權限：插件在 當前 DSH 進程權限 下運行，會 spawn 外部 CLI 並可能橋接宿主工具。安裝前應閱讀 GitHub 源碼 與許可證，並查閱倉庫內 CLI 安全說明。Codex 沙箱與 Claude 權限模式務必按環境審慎選擇；danger-full-access 等高檔位僅應在可信環境中啓用。
依賴與可選組件：任務看板完整體驗依賴 dsh-better-sidebar；未安裝時仍可使用任務監視與會話內列表。Grok 執行器默認關閉，需在配置頁顯式啓用。
結尾¶
dsh-maestro-codex 把多 CLI 子代理納入同一套 DSH 配置、路由與賬本：主會話只做該不該派、派給誰，執行與回放留在插件提供的監視界面裏。若要進一步覈對行爲邊界與恢復流程，請直接閱讀倉庫 README 與 docs/ 下的可靠性、任務板說明。
