dsh-subagent-setting：在 Web 設置頁統一配置 subagent 的默認模型

前言¶

如果你在 DeepSeek Harness（DSH）裏跑多 subagent 的任務流，可能會遇到一個具體問題：subagent 的 provider、model 和 reasoning effort 默認配置散落在配置文件裏，想換一個默認模型，就得手動編輯 YAML，改完還要確認每個 subagent 是否用上了新值。

dsh-subagent-setting 把這件事搬到了 Web 設置頁：在界面上選好默認的 provider / model / reasoning effort，新建的 subagent 立即生效，還可以選擇讓已經存在的空閒 subagent 跟隨新設置。

這是什麼¶

dsh-subagent-setting 是一個 DSH 插件，由 marshfolx 維護，當前版本 0.1.0，採用 MIT 許可證。它解決的問題很單一：爲 subagent 提供一個可視化的默認模型配置入口，替代手動編輯 YAML。

核心功能¶

按插件的 README，它提供以下能力：

1、設置頁配置（Settings → Subagent Model）：從即時模型目錄中選擇 provider、model 與 reasoning effort，無需手動編輯 YAML。

2、新建 subagent 立即生效：override 在每個子 agent 創建時逐個應用，創建之後新建的 subagent 直接使用新配置。

3、可選的即時傳播：設置項 Apply setting changes to subagents created earlier 開啓後，配置變更會更新所有已存在的空閒 subagent，新值在其下一次請求時生效；正在運行中的 subagent 則從下一步開始生效。關閉該選項時，變更隻影響之後新建的 subagent。

4、留空即繼承父會話：provider / model / effort 任何一項留空，subagent 就沿用父會話所用的配置。

5、WebView 友好的下拉框：設置表單使用完全受控的自定義下拉組件替代原生 <select>，在瀏覽器和 Tauri（WebView2）shell 中行爲一致。

實現方式¶

瞭解實現有助於判斷它是否適合你的環境，README 給出了簡要說明：

Host 側（lib/index.js）註冊 dsh-subagent-setting 設置命名空間，並在 agent/created 事件中，對 session header 裏 origin: 'subagent' 的每個 agent 安裝 agent 級的 agent/request waterfall 監聽器，將調用配置重寫爲配置的 route。
監聽器讀取子 agent 的即時 route holder，因此 applyToIdle 只需替換該 holder，就能讓已存在的子 agent 在下一次請求時切換到新配置。
Client 側（client/client.js）負責渲染設置區域，通過官方連接 API（settings.describe / settings.replace / llm.models）通信。

安裝與啓用¶

先把插件安裝到 profile，再加入 bundle 列表：

dsh plugin --profile web add github:marshfolx/dsh-subagent-setting

安裝完成後，打開 Settings → Subagent Model 配置默認值即可。

典型用法¶

按 README 的使用流程：

1、執行上面的安裝命令，把插件裝入 web profile 並加入 bundle 列表。

2、打開 Settings → Subagent Model，從模型目錄中選定 provider、model 和 reasoning effort。

3、如果希望早前創建的 subagent 也跟隨設置變更，啓用 Apply setting changes to subagents created earlier 選項；否則保持關閉，只讓新建的 subagent 使用新配置。

如果不想鎖定具體模型，把 provider / model / effort 留空即可，subagent 會繼承父會話的配置。

適用場景與注意¶

適合的場景：在 Web 端管理多個 subagent、需要頻繁調整默認模型配置、或者希望把模型選擇從 YAML 編輯中解脫出來的 DSH 用戶。

幾點注意：

即時傳播只作用於空閒的 subagent；正在運行中的 subagent 要到下一步纔會拿到新配置。
插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼和許可證。本項目採用 MIT 許可證，源碼在 GitHub 上可以查閱。
項目當前版本爲 0.1.0，屬於早期階段，建議在自己的環境裏先驗證再用於生產。

結尾¶

dsh-subagent-setting 做的事不復雜，但把 subagent 模型配置從手改 YAML 變成了設置頁裏的幾次點選，並且通過 route holder 替換實現了對已有空閒 subagent 的即時更新。如果你的工作流依賴多個 subagent，值得一試。

社區目錄頁：https://www.skillhub.cn/plugins/marshfolx/dsh-subagent-setting
GitHub 倉庫：https://github.com/marshfolx/dsh-subagent-setting

順帶一提，DSH 的理念是「一切皆插件」，上面的目錄頁是獨立的社區站點，與 DeepSeek / 幻方沒有官方從屬關係。