前言¶
在 DeepSeek Harness（DSH）的開發與調試中，經常需要爲特定任務（如代碼審查、快速摘要）配置獨立的模型路由和推理策略。手動爲每個請求創建新的上下文不僅繁瑣，而且難以複用。dsh-subagent 插件通過將命名配置轉化爲可調用的工具，解決了這一問題。
這是什麼¶
dsh-subagent 是一個社區維護的 DeepSeek Harness 插件，作者爲 xie-tj，採用 MIT 許可證。它將命名後的子代理配置轉化爲模型可見的代理工具，允許 Root Agent 通過工具調用（如 subagent_<name>）來委託特定任務。
核心功能¶
該插件提供了以下核心能力：
- 配置管理：支持在設置頁面創建、編輯和刪除子代理配置。
- 上下文模式：在
spawn（獨立子上下文）和fork（繼承已完成父對話）兩種模式中選擇。 - 路由策略：可選擇跟隨當前對話的 Provider/Model，或固定自定義的模型路由。
- 推理配置：可選擇跟隨當前推理等級或固定自定義的推理 effort。
- 動態刷新：可從 Host 的模型目錄中刷新自定義選項。
- 熱更新：應用配置更新無需重啓 Host，已存在的可延續子代理會保留創建時的路由策略。
- 工具接口：除 UI 外，還提供
custom_subagent工具供模型管理配置。 - 默認代理：支持標記一個配置爲“默認子代理”，在系統提示詞中引導模型使用對應的工具。
安裝與啓用¶
安裝前請確保 DeepSeek Harness 版本兼容（需 0.1.1-rc.2 兼容包），並且目標 Profile 加載了 Web UI（例如 web profile）。
安裝命令¶
在終端執行以下命令將插件安裝到 Web profile：
dsh plugin --profile web add github:xie-tj/dsh-subagent
驗證安裝¶
安裝完成後，可以通過以下命令檢查依賴是否正確加載：
dsh plugin --profile web why
在輸出結果中查找 dsh-subagent 相關條目，確認 cordis.patch.yml 層已合併。
典型用法¶
安裝並重啓 Web Profile 後，可通過以下方式使用：
-
配置端：
打開 Settings → Subagents。在此頁面可以新建或編輯配置項，設置後端模式（spawn/fork）、模型路由和推理等級。 -
運行端：
每個活動的 Root Agent 會自動獲得subagent_<name>工具（例如subagent_fast）。Agent 可直接調用這些工具來執行預設的任務策略。同時，Agent 也可通過custom_subagent工具進行配置管理。
適用場景與注意¶
- 適用對象：需要在多個對話中複用特定模型組合和推理策略的開發者。
- 狀態管理：插件本身不維護本地磁盤狀態，配置數據存儲在 DSH 的設置提供者、Profile 依賴清單和組合層中。
- Profile 依賴：由於需要 Web UI 和特定工具暴露，安裝時必須指定一個加載了 Web 運行時的 Profile。若安裝到非 Web Profile，需額外確保該 Profile 加載了
@deepseek-ai/dsh-client-ui-settings以渲染設置頁面。
結語¶
dsh-subagent 通過標準化的配置與工具映射，降低了在 DSH 中構建多模型、多策略子代理系統的門檻。你可以通過 GitHub 查看源碼，或在 SkillHub 瞭解更多詳情。
