在 DeepSeek Harness (DSH) 的开发场景中,一个常见痛点是如何让一个智能体同时管理多个并行的子任务。传统做法往往只能单线程处理,或者需要手动干预。dsh-plugin-task-coordinator 旨在解决这一问题,它允许一个“主管”会话通过一套工具,来调度、监控和收集其他子任务会话的结果。
插件简介¶
该插件由开发者 Kayungko 维护,属于“工作流”类别,采用 MIT 许可证。它提供了一套 task_* 工具集,模拟 Codex 的跨任务协调机制,支持跨会话的消息传递、任务生成与状态追踪。
核心功能¶
插件提供以下核心能力:
- 任务管理:
task_list用于列出可见任务,task_progress用于读取单个任务的深度进度(包括状态、消息、待办事项等)。 - 任务调度:
task_spawn用于创建并启动一个新任务,task_spawn_batch支持批量并行分发;task_send用于向任务发送可见的后续提示。 - 结果收集:
task_wait用于收集已生成任务的结果。 - 交互确认:支持交互式确认(
task_confirm),提供审批卡片、可复用的任务级审批以及多选部分分发(task_confirm_select)。 - 环境与模型控制:支持工作区迁移(
task_workspace)、子任务模型选择(task_models),以及递归深度治理和工作区继承。 - 辅助功能:包含
/tasks命令、会话 ID 复制按钮、结果报告回传,以及本地化的用户界面字符串。
安装与启用¶
在安装之前,请确保满足以下先决条件:
- DSH Desktop 已安装并处于运行状态(插件不会启动宿主程序)。
- Node.js 版本为
^22.19.0 || >=24。 - 系统中安装了 PowerShell。
执行以下命令进行安装:
git clone https://github.com/Kayungko/dsh-plugin-task-coordinator.git
cd dsh-plugin-task-coordinator
pwsh install.ps1 -Source .
安装脚本会执行以下操作:将插件文件复制到配置目录的 node_modules/ 中(不修改 pnpm-lock.yaml),在配置清单中注册依赖和打包内容,并更新 .package-map.json。所有操作在执行前都会先备份到 backups/<timestamp>/ 目录。
安装完成后,重启 DSH Desktop。此时任何顶层会话都可以使用相关的工具和 /tasks 命令。
使用方法¶
插件依赖于明确的指令。为了让模型正确调用工具,建议在提示词中直接引用工具名称并使用祈使语气。
示例 1:并行任务拆分¶
你可以直接要求将任务拆分为多个并行执行的部分:
Split this into three tasks and run them in parallel: A researches the approach, B builds the prototype, C runs the tests. Summarize for me when they finish.
示例 2:主管会话接管¶
在 /goal 模式下,主管会话应明确其职责:
As the supervisor session, take over the remaining development: ① splittable work MUST be dispatched to parallel sub-task sessions via task_spawn_batch (attach a team name) — do not do everything yourself; ② collect results with task_wait and integrate them; ③ sub-task sessions may further parallelize with their own subagents; ④ push to remote main at every milestone.
注意事项与适用场景¶
- 运行环境:插件以当前 DSH 进程的权限运行,因此安装前应检查源码与许可证。
- Git Worktrees:为了保持隔离性,Git worktrees 被刻意设计为“未分组”状态。
- 可重运行性:重新运行安装脚本是安全的,文件复制是幂等的,清单注册会自动去重。
- 提示工程:模糊的指令(如“你可以使用 /task 插件”)通常无效。模型只有在能够将你的语言映射到工具时才会进行协调。确保在指令中点名工具并使用祈使语气。
- /goal 模式限制:在
/goal模式下,协调指令必须包含在目标对象中,以便每个后续轮次都能锚定该文本。
总结¶
dsh-plugin-task-coordinator 为 DSH 提供了从单会话向多会话编排转型的能力。通过标准的 task_* 工具和审批流程,开发者可以在不离开 DSH 界面的情况下,实现复杂的跨任务协作。