dsh-task-heartbeat
在终端中运行以下命令:
dsh plugin install jerentpan-lab/dsh-task-heartbeat
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install jerentpan-lab/dsh-task-heartbeat,即可从 https://github.com/jerentpan-lab/dsh-task-heartbeat 安装 dsh-task-heartbeat 插件。
插件介绍
长时间跑任务的 Agent 或脚本,进程可能仍在运行,却早已卡在某一步。只看进程是否存活,无法判断「任务有没有在推进」。dsh-task-heartbeat 把关注点放在任务进度上:为长任务登记身份与负责人,在每次有意义的进展后打一次心跳,当最后一次心跳超过可配置的 ttl 时,任务会被视为停滞。
插件提供 task_register、task_beat、task_check、task_list、task_done 等工具,配合主机侧定期执行 task_check(README 建议约每 5 分钟),即可得到当前停滞任务列表。状态持久化到本地 JSON,支持默认 ttl、状态文件路径等配置;非法配置会给出可读的 ConfigError,便于排查。
适合需要编排或监督多步 Agent 工作流、希望「卡住」能被及时发现而不是等进程超时的人。心跳写入会 fsync,适合按任务自然节奏调用 task_beat,而非高频空打。
使用场景
- 多步 Agent 任务在关键步骤后上报心跳,便于发现长时间无进展
- 主机定时执行 task_check,汇总超过 ttl 未心跳的停滞任务
- 长流程编排中登记 owner 与 taskId,任务结束调用 task_done 收尾
适合人员
- 编排或监督 Agent 工作流的开发者
- 需要区分「进程活着」与「任务在推进」的运维场景
- 运行长时间自动化任务并希望及早发现卡住的团队