前言¶
在 DSH 里跑复杂任务时，常见做法是全程用同一个大模型：规划、写代码、查资料、跑测试都在一条对话里完成。强模型能力够，但 token 与延迟往往偏高；若把「动手」部分交给更便宜或更专长的 API 模型，又需要自己在路由、凭证和活动视图之间拼一套流程。DeepSeek Harness 社区插件 DSH Planner–Executor（仓库 O-OII/dsh-planner-executor）把主从分工写进插件：主代理负责规划、设计、决策与验收，实质实现、调研与测试可委托给配置的默认执行器；简单任务仍可由主代理直接处理。下面介绍它是什么、能做什么，以及如何安装与启用。
这是什么¶
DSH Planner–Executor 由维护者 O-OII 发布，在 SkillHub 目录中归类为工作流。插件自述为：DSH 主从协作——主模型规划设计决策与验收，默认执行器承担实质工作；支持通用 API 模型接入与代理活动观察。实现上不绑定 DeepSeek 单一厂商；已有安装可继续沿用文档中的 stable technical IDs。
当前 package.json 中版本为 0.3.2，许可证 MIT，要求 Node.js >= 22，声明的 DSH API 范围为 >=0.2.1-rc.2 <0.3.0（README 说明面向 0.2.1-rc.2 起的目标 API，并以 rc.3 做过对照；该范围不等同于对每个构建的认证）。
核心功能¶
角色与路由¶
- 主代理（Planner）：在设置里指定允许担任规划者的精确模型 ID；运行时 reasoning 仅在模型支持时配置。
- 默认执行器（Default executor）：未显式指定路由的、来自匹配 main 代理的后续委托，可走默认执行器；显式选择、已配置的工具路由与 worker 子代仍走 DSH 原生行为。
- 子模型优先级：显式的子模型 / reasoning 选择优先；文档说明不会迁移已有子代理配置。
模型与凭证¶
- 在插件设置 Add custom model API 中新建 Provider ID、协议、Base URL、可选密钥，并至少填写一个精确 model ID；也可通过显式端点请求拉取模型列表，手动填写 ID 始终可用。
- 已有或目录中的 Provider 仍在 Settings → Models 管理。
- 密钥经 DSH 官方只写凭证服务保存；设置依赖官方
llm-pi-ai命名空间、schema 与 LLM 目录服务，凭证与发现能力单独校验，缺失或只读/overlay 拒绝会如实提示。
活动观察¶
活动视图可看到实际使用的主/子模型、正在运行的直接子代理、上一回合结果，以及原生的 Open/Stop、折叠/隐藏等。README 中的预览图使用公开合成数据，策略默认关闭。
成本与范围¶
插件强调成本感知而非成本保证：工人范围与验收证据宜简洁；更倾向新 worker 而非带全量历史的 fork。委托可能减少强模型上的执行量，也可能增加总 token、延迟或费用。
安装与启用¶
安装前请自行审阅仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行；README 要求先禁用旧的本地 activity/routing 副本。本仓库不会自动安装、改写线上 profile 或重启 DSH。
README 给出的安装方式为在本地克隆后通过 CLI 加入 profile（将 desktop 换成你使用的 profile），然后刷新已打开的 DSH 页面：
git clone https://github.com/O-OII/dsh-planner-executor.git
cd dsh-planner-executor
dsh plugin --profile desktop add --ignore-scripts .
典型用法：三步配置¶
经过上面的安装后，按 README 的 Three steps 完成路由（Provider 创建与启用 Planner–Executor 是分开保存的）：
- 打开 Settings → Plugins → DSH Planner–Executor。在 Add custom model API 中填写新 Provider ID、协议、Base URL、可选 key 与至少一个精确 model ID。
- Host 确认创建后，在 Default executor 下选择执行器模型，并添加允许担任 planner 的精确模型；仅在支持时配置 runtime reasoning。路由单独保存；创建 Provider 不会自动启用路由。
- 需要时再启用 Planner–Executor。仅未来、且未写 route 的、来自匹配 main 代理的委托会使用默认执行器。
更细的模型设置、凭证失败与独立保存见 configuration.md；选择 precedence、策略与限制见 planner-executor.md；面板迁移与兼容见 advanced.md。
适用场景与注意¶
适合：希望在 DSH 里固定「强模型主控 + API 执行器分工」、需要看清主从模型与实际子代理运行状态、并愿意自行配置 OpenAI/Anthropic 兼容端点与凭证的开发者。
注意：
- 插件依赖 DSH 官方 LLM 与凭证相关服务；环境不完整时部分能力不可用，界面会说明原因。
- 未复制官方编辑器组件，不使用 private navigation、localStorage 开关或自定义 secret 端点（README 原文说明）。
- 社区目录 SkillHub 插件页 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展思路。
结尾¶
DSH Planner–Executor 把规划验收与 API 子代理执行收敛到同一套设置与活动视图里，并保留显式路由与原生 worker 行为。若要查看简介与分类，可打开目录页 skillhub.cn/plugins/O-OII/dsh-planner-executor；源码、Issue 与文档以 GitHub 仓库为准：github.com/O-OII/dsh-planner-executor。
