DSH Plugins
返回列表
⚙️

dsh-task-heartbeat

工作流 更新于 2026.11.02

在终端中运行以下命令:

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 工作流的开发者
  • 需要区分「进程活着」与「任务在推进」的运维场景
  • 运行长时间自动化任务并希望及早发现卡住的团队