前言¶
在 DeepSeek Harness (DSH) 的使用中，若要構建一個包含多個角色的複雜工作流，通常需要爲每個子任務現場描述 Prompt。這不僅繁瑣，而且難以複用和標準化。dsh-subagent-library 插件旨在解決這一問題，它將常用的角色（如代碼審查、紅隊測試、多模態理解）封裝成一份持久化的具名子代理名冊。模型通過標準工具接口即可選人並派活，主會話只需一句指令即可觸發。
核心功能¶
- 具名子代理名冊：將模型、Persona、工具過濾等配置持久化存儲，支持熱生效。
- 工具集成：爲模型提供
list_subagents（列出名冊）和delegate（派發任務）兩個工具。 - 可視化編輯：在 DSH 設置頁直接增刪改條目，無需手動維護 YAML 文件。
- Host 平面工具註冊：工具註冊在 Host 平面，不依賴特定 Agent Preset，切換 Preset 不會丟失。
- 後臺模式支持：支持
one-shot（一次性任務）和continuable（可續聊子代理）模式。
安裝與啓用¶
通過 npm 安裝該插件：
npx @deepseek-ai/dsh plugin --profile web add dsh-subagent-library
安裝完成後，重啓 dsh web 進程並刷新頁面即可使用。
配置與用法¶
目錄結構¶
0.3 版本起，名冊存儲爲目錄結構，默認路徑爲 ~/.dsh/subagents/。每個具名子代理對應一個 YAML 文件（文件名即 ID）。
~/.dsh/subagents/
k3-reviewer.yaml # 對應 ID 爲 k3-reviewer
glm-reader.yaml
_backups/ # 備份區，以下劃線開頭的文件/目錄會被插件忽略
README.md # 可選，供 Agent 或人類閱讀的說明
工具調用流程¶
- 主會話指令：主會話 Agent 只需告訴它“用 xxx 做這件事”。
- 模型決策：模型使用
list_subagents工具查看名冊中的可用條目（包含描述、模型路由等）。 - 任務派發：模型使用
delegate工具，根據選中的library_id將任務派發給對應的子代理。 - 無需 Slash 命令：模型層面的交互完全通過工具完成，
/subagent命令僅用於人類在命令面板中查看名冊。
配置項說明¶
單個條目文件（k3-reviewer.yaml）的配置示例：
description: Kimi K3-256K 獨立只讀審覈，支持圖片視覺走查
provider: kimi-coding
model: k3-256k
persona: |
你是運行在 Kimi K3-256K 上的獨立審覈 agent……
toolFilter:
deny: [write, edit, todo_write, create_goal, update_goal, subagent, subagent_fork, send_message, interrupt_agent, workflow, ralph, list_subagents, delegate]
maxDepth: 1
backgroundMode: continuable
主要字段含義：
* id：文件名，須匹配 [a-z0-9][a-z0-9-]*。
* description：角色描述，用於 list_subagents 展示。
* provider：LLM 路由（如 deepseek-official、kimi-coding）。
* model：LLM 模型 ID。
* subagentProvider：子代理傳輸層（默認取插件級默認 spawn）。
* persona：子代理的角色提示詞，支持 {{…}} 模板插值。
* toolFilter：工具過濾名單。建議對只讀角色將 list_subagents 和 delegate 加入 deny，防止子代理被全局提示詞誘導鏈式派活。
* maxDepth：委派深度上限，防止遞歸過深。
* backgroundMode：後臺模式，one-shot（默認）或 continuable。
設計說明¶
- 熱生效：名冊每次操作實時讀取目錄，修改 YAML 文件無需重啓 DSH。
- Host 平面：工具註冊在 Host 平面，確保切換 Preset 時工具依然可用。
- 容錯性：解析或校驗失敗的文件會被跳過，錯誤信息會進入
list_subagents輸出與診斷界面，不會導致名冊崩潰。 - 原子操作：單條目寫入採用臨時文件 + rename 重試機制，多寫者環境下後寫生效。
適用場景與注意¶
- 適用場景：適合需要固定角色分工的長期工作流，例如代碼審查、紅隊測試、多模態理解等。
- 安全注意：設置接口
/subagent-library/api遵循 DSH Web Host 的本地可信邊界，插件自身不包含獨立身份驗證層。若將 DSH 綁定到公網或局域網，務必在外層配置認證與訪問控制，不要將接口暴露給不可信客戶端。 - 依賴關係：插件是獨立社區項目，與 DeepSeek 無隸屬關係。安裝前建議查看源碼與許可證。
