dsh-custom-subagents：DeepSeek Harness (DSH) 可複用子 Agent 插件

前言¶

DeepSeek Harness (DSH) 支持創建子 Agent 來分擔任務，但在實際工作流中，我們往往需要固定一套角色（例如代碼審查員、文檔撰寫、網絡調研）反覆調用。原生創建方式需要每次手動配置，且容易產生無限嵌套，導致 token 浪費。

dsh-custom-subagents 插件通過提供一套可視化的配置界面，讓用戶把常用的角色定義保存下來。主 Agent 獲得一個 delegate_agent 工具，即可隨時調用這些定義好的子 Agent。

插件介紹¶

dsh-custom-subagents 是一個爲 DSH 提供可複用子 Agent 定義的插件。

核心價值：
* 一次定義，反覆使用：將「代碼審查員」等角色保存爲定義，主 Agent 隨時調用。
* 無需寫代碼：所有操作在「設置 → 子 Agent」頁面完成，所見即所得。
* 防止無限套娃：提供「禁止嵌套委派」開關和硬深度上限（3層），防止 token 和時間開銷失控。

安裝¶

安裝前請確保已安裝 DSH。推薦使用 npm registry 安裝：

dsh plugin --profile web add dsh-custom-subagents

平臺說明：
* Windows：建議使用全局安裝的 DSH (npm i -g @deepseek-ai/dsh)，避免版本不一致問題。
* 端口衝突：若 Windows 啓動報 EADDRINUSE 錯誤，需更換端口，例如 dsh web --port 4000。
* Shell 令牌：插件會根據宿主平臺自動解析 shell 工具令牌（Windows 映射爲 pwsh，Linux/macOS 映射爲 bash）。

配置與使用¶

安裝後，DSH 會自動獲得 delegate_agent 工具。打開 設置 → 子 Agent 頁面進行配置。

新建子 Agent¶

點擊「新建」。
填寫表單：
* 名稱：角色的唯一標識，主 Agent 用來認人。
* 描述：寫給主 Agent 看，說明何時使用該角色（例如：「在需要檢查代碼正確性時使用」）。
* 系統 Prompt：定義角色的身份與工作方式。
* 模型與上下文：默認使用父模型，上下文可選擇「全新」或「繼承對話」。
* 工具：勾選或選擇「繼承父 Agent 工具」。

可用工具能力¶

支持的工具包括：
* read：讀取文件
* glob / grep：查找文件、搜索內容
* write / edit：創建和修改文件
* Shell (bash / pwsh)：運行命令
* web_search：聯網搜索
* skill：使用技能

典型用法¶

配置完成後，在對話中直接吩咐主 Agent：
* 「讓 Explorer 看一下 src/ 裏的模塊是怎麼組織的。」
* 「用「代碼審查員」檢查一下 src/ 最近改動的代碼。」

功能特性¶

所見即所得的工具選擇：勾選工具即可，無需配置文件。
安全邊界清晰：子 Agent 能用的工具永遠不會超出父 Agent 已有的工具。若父會話缺少定義勾選的某個工具，委派會明確失敗。
運行時配置安全：修改或刪除定義不影響正在運行的任務。
防無限套娃：原生 DSH 的子 Agent 創建路徑沒有默認深度上限。本插件提供兩層防護：
1. 禁止嵌套委派開關（默認關閉）：開啓後，子 Agent 無法再創建任何子 Agent。
2. 硬深度上限：委派鏈最深限制爲 3 層，超出即拒絕。

注意事項¶

版本兼容：已在 DSH 0.1.1-rc.2 上驗證。插件 peer 依賴聲明爲 >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-0 <0.2.0-0。
後臺執行：後臺執行不可用，只支持標準模式。
引用穩定性：改名或刪除定義不會破壞歷史記錄中的引用，隻影響未來的委派。
預置定義：內置的 Explorer 等預置子 Agent 不能刪除，只能停用。

結尾¶

dsh-custom-subagents 通過可視化的方式解決了 DSH 子 Agent 的複用與安全管理問題。它讓主 Agent 能夠靈活調用專業角色，同時通過深度限制和工具繼承機制，保證了系統的可控性。

插件目錄：https://www.skillhub.cn/plugins/ktdhhc/dsh-custom-subagents
GitHub 倉庫：https://github.com/ktdhhc/dsh-custom-subagents