在 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 界面的情況下,實現複雜的跨任務協作。