前言¶

在 DSH（DeepSeek Harness）裏，子 Agent 派發通常不只是“發一個 prompt”。如果不同子任務需要不同模型、不同推理強度、不同工具範圍，還要能複查這次派發實際生效了什麼、是否通過安全檢查、成本估算如何，就需要一個能顯式管理派發策略的插件。

muzyLink/dsh-subagent-profile 是 DeepSeek Harness 子 Agent 派發插件：按任務爲子代理選擇模型、推理強度與工具範圍，將常用組合保存爲命名 profile 並隨時複用，同時提供安全檢查、成本估算與節省分析，以及完整決策臺賬。

這是什麼¶

dsh-subagent-profile 由 muzyLink 維護，許可證爲 MIT。

它圍繞一個核心目標：讓每次子 Agent 派發都有可複用的 profile、可檢查的安全約束、可閱讀的成本估算，以及可追蹤的決策記錄。具體來說，它把“用哪個模型、用多高推理強度、給哪些工具、是否後臺運行、成本如何估算、結果如何落賬”放到同一套插件能力裏。

核心功能¶

下面介紹它明確提供的能力：

• 按任務爲子代理選擇模型、推理強度與工具範圍。
• 將常用組合保存爲命名 profile 並隨時複用。
• 提供 dispatch 工具派發子 Agent。
• 內置 whitelist、cost、intersection、approval、budget 安全檢查並記錄。
• 提供成本估算與節省比較。
• 記錄 request vs. effective、gates、execution、settlement 的決策臺賬。
• 提供 settings page 和 per-session ledger tab。
• 自安裝 orchestrator agent preset。
• 工具集取 profile 與 parent 交集，並始終移除 run_code。
• 支持後臺派發、即時狀態、提醒中心、派發建議和子代理 header badge。

安裝與啓用¶

先安裝插件：

dsh plugin --profile web add dsh-subagent-profile

安裝後重啓 dsh web，並在新會話 preset picker 中選擇自安裝的 orchestrator 預設。

環境要求如下：

• Node：^22.19.0 || >=24
• peerDependencies：@deepseek-ai/dsh-agent、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-subagent、@deepseek-ai/dsh-tools，版本範圍爲 >=0.1.0-rc.6 <0.2.0，且均標記爲 optional。

卸載插件會移除相關數據文件和自安裝的 orchestrator preset 目錄；重裝或重啓會重新同步 preset 並生成數據文件。

典型用法¶

1. 在 settings page 管理 profile¶

Profile 在 settings page 管理。每個 profile 包含：

• preset
• model
• reasoning effort
• tool scope
• 可選 persona

內置兩個 profile：swap-standard 與 researcher。

Profile 文件位於：

~/.dsh/subagent-profiles.json

從 settings page 編輯後，配置立即生效。

2. 使用 dispatch 工具派發子 Agent¶

示例：

dispatch(
  profile: "researcher",
  prompt: "Survey the DSH plugin ecosystem and compare direct competitors",
  run_in_background: true
)

這裏指定使用 researcher profile 作爲派發時的模型、推理強度與工具範圍組合，並把任務放到後臺執行。

3. 在 per-session ledger tab 查看決策¶

每個會話都有 per-session ledger tab。它記錄派發決策：

• request vs. effective
• gates
• execution
• settlement

用於複查這次子 Agent 派發實際生效的配置、執行過程與成本結算。

安全檢查與限制¶

插件的默認約束如下：

• 工具集取 profile 與 parent 的交集，並始終移除 run_code。
• Delegation 不豁免 host approval；需要審批的操作會被自動拒絕。
• 非官方 preset 可以按 preset 開啓，但默認關閉，每次允許都會被審計。

成本方面需要注意：

• 成本數字是估算，基於每個 model 的平均 per-dispatch 價格，而不是細粒度 per-token 計價。
• 成本估算與節省分析用於比較，不應直接當作精確計費結果。

後臺派發有依賴：

• 需要 @deepseek-ai/dsh-jobs 和 @deepseek-ai/dsh-tool-jobs 已加載。
• 否則會失敗，提示：dispatch: 後臺派發不可用：缺少 jobs 服務。

運行模式也有差異：

• 在 Continuable mode 下，preset swap 與 reasoningEffort 會被忽略，子代理繼承父會話 preset，並使用默認推理強度。
• 在 One-shot 模式下，最終工具集由 dsh 決定，插件無法讀取最終受限結果。

適用場景與注意事項¶

適合這些情況：

• 你已經在 DSH 中派發子 Agent，但希望不同任務使用不同模型和推理強度。
• 你希望工具範圍按任務收窄，並保留 run_code 始終被移除的默認約束。
• 你需要查看每次派發的 request、effective、gates、execution、settlement 記錄。
• 你希望用 profile 管理常用組合，而不是每次手寫完整配置。

安裝前請注意：

• 插件以當前 dsh 進程權限運行，建議先檢查源碼、依賴與許可證。
• 本項目許可證爲 MIT。
• 如果依賴後臺派發，先確認 @deepseek-ai/dsh-jobs 與 @deepseek-ai/dsh-tool-jobs 已加載。
• 如果依賴 One-shot 或 Continuable 的最終行爲，注意插件在部分模式下不能讀取或覆蓋最終結果。

結尾¶

dsh-subagent-profile 的價值在於把子 Agent 派發中的模型選擇、推理強度、工具範圍、安全檢查、成本估算與決策臺賬放在同一套 profile 和 ledger 裏管理。

GitHub 倉庫

項目目錄頁（來自插件線索，未完全證實）