前言¶
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 仓库。
