前言¶
DeepSeek Harness（DSH）採用插件化架構，強調模塊化與靈活性。在傳統的智能體開發中，往往由單一的模型同時承擔分析、規劃、執行和彙總的任務。這種模式在處理複雜任務時，容易導致主模型 Token 消耗過大，或者難以讓主模型專注於高層的策略制定。dsh-planner-executor 插件旨在解決這一痛點，通過角色分離機制，將規劃與執行過程解耦。
插件介紹¶
插件名稱：mikuuuuuue/dsh-planner-executor
核心價值：規劃/執行分離。主模型負責分析問題、制定計劃與彙總結果，通過工具將執行工作委派給獨立的執行子代理。子代理在獨立會話中運行，中間步驟不污染主會話，最大化節約主模型 Token 並允許各角色使用最適合的模型。
核心功能¶
- 主模型職責：由會話所選的主模型負責分析、制定計劃及最終彙總。
- 委派機制：通過工具
delegate_execution(task, context)將執行工作委派給子代理。 - 子代理配置：執行子代理的模型、LLM 提供方、人格及工具範圍，可在 Web 設置面板的「規劃與執行」分節中配置（留空則繼承主模型）。
- 會話隔離：子代理在獨立會話中執行，中間步驟不進入主會話，僅最終彙報返回。
- 零依賴：純 JavaScript 實現，無構建依賴，即裝即用。
安裝與啓用¶
安裝該插件需要使用 DSH 的 CLI 命令。安裝完成後，插件會自動集成到當前 Web Profile 中。
dsh plugin --profile web add "github:mikuuuuuue/dsh-planner-executor"
安裝後，插件會自動加載，具體的執行參數將在 Web 界面中配置。
典型用法¶
使用該插件主要分爲配置與調用兩步。
1. 配置子代理¶
進入 Web 設置面板，找到「規劃與執行」分節，配置以下參數：
* 子代理後端：選擇 spawn（全新上下文，省 token）或 fork（繼承主代理已完成輪次）。
* 模型與提供方：設置執行子代理的模型 ID 或 LLM 提供方路由。
* 權限控制：配置工具過濾，允許或禁止特定工具。
* 遞歸限制：設置 maxDepth 限制遞歸委派深度。
2. 調用工具¶
在主模型的提示詞或邏輯中，調用 delegate_execution 工具啓動委派：
delegate_execution(task, context)
適用場景與注意¶
- 適用場景：適合需要將長鏈路任務拆解爲執行步驟的場景，或需要主模型與執行模型使用不同模型（如主模型用 DeepSeek-V3，執行模型用更輕量模型）的場景。
- 權限限制：子代理的權限固定在繼承的沙箱範圍內，審批策略固定爲
never，無法自擴大權限。 - 工具限制：子代理的工具目錄中強制排除
delegate_execution工具，防止無限遞歸或越權調用。 - 已知限制：
- 不支持按次調用的動態模型參數。
- 暫未引入
outputSchema結構化彙報功能。 - 子代理在獨立會話運行，若主進程權限受限，子代理同樣受限。
總結¶
該插件通過 delegate_execution 工具實現了主子代理的解耦，讓主模型專注於規劃與總結，子代理專注於具體執行。這種分離模式有助於優化 Token 使用並提升任務處理的靈活性。更多細節可參考插件目錄或 GitHub 倉庫。
