dsh-task-control

English | 中文

为 DSH Web 增加任务暂停、恢复和取消能力。支持安全暂停与强制暂停，恢复时从暂停点继续，不重复已完成的工作。

当前适配 DSH v0.1.1-rc.2（最新版本）。

安装

dsh plugin --profile web add github:p2coder/dsh-task-control

安装后请完整重启 dsh web，然后刷新浏览器页面。

快速使用

任务运行时，输入框旁会显示三个常驻按钮：

按钮	作用	可用状态
⏸ 暂停	按默认粒度暂停任务	运行中
▶ 恢复	从暂停点继续	已暂停
⏹ 取消	立即终止当前回合	运行中或已暂停

灰色按钮表示当前不可用，黑色按钮表示可点击。

暂停模式

模式	行为	适合场景
safe wait（默认）	等待推理和工具自然完成后暂停	长任务、迁移、测试
safe stop	工具完成后暂停；可中断当前推理	希望更快暂停
force	立即中断推理及在途工具	紧急停止

在「设置 → 任务控制」中修改默认模式，保存后立即生效：

命令

命令	说明
/pause	按设置中的默认模式暂停
/pause force	强制暂停
/pause safe wait	安全暂停，不中断推理
/pause safe stop	安全暂停，可中断推理
/resume	恢复任务
/resume confirm rerun	重新执行被中断或未派发的工具后恢复
/resume confirm skip	跳过该工具后恢复
/cancel	取消当前回合

供其他插件调用

通过 ctx.get("taskControl") 获取服务：

API	作用
pause(sessionId, options?)	暂停任务
resume(sessionId, options?)	恢复任务
cancel(sessionId)	取消任务
state(sessionId)	查询 idle、running 或 offline 状态及暂停信息

暂停状态保存在 ~/.dsh/task-control/，重启后不会丢失。测试时可用 DSH_TASK_CONTROL_STATE_DIR 修改存储目录。

注意事项

情况	说明
强制暂停	工具可能已产生部分副作用；恢复前可选择重新执行、跳过或保持暂停
safe wait 的未派发工具	恢复时需要选择重新执行或跳过
暂停期间发送新消息	会开启新回合；暂停只控制当前回合
定时提醒	dsh-schedule 到期后仍会唤醒
子代理	已派发的子代理不会被父任务暂停
状态同步	浏览器每 2 秒轮询一次，修改插件后需重启 dsh web

测试

node test/host-smoke.mjs