dsh-task-checkpoint-guard
在终端中运行以下命令:
dsh plugin install jlnkx5200-beep/dsh-task-checkpoint-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 配置文件中执行 dsh plugin install jlnkx5200-beep/dsh-task-checkpoint-guard,或从源码仓库 https://github.com/jlnkx5200-beep/dsh-task-checkpoint-guard 构建安装包后按 README 安装到实际使用的 profile。
插件介绍
长时间运行的 DSH 智能体任务常被网络中断、提供商超时、服务错误或进程重启打断。对话日志能保留历史,但重启后的智能体仍需要一份紧凑、结构化的「进行到哪了」:目标、当前步骤、已完成的工具、不确定的结果、待办与最近可见输出。本插件在本地为每个活跃会话写入这类检查点,并在安全条件下帮助恢复,而不是让模型从零猜状态。
核心能力包括:以 JSON、Markdown 与会话指针持久化检查点;记录原始指令、目标与修订、待办、步骤位置、工具生命周期与有界可见结果;写入前脱敏凭证形态内容;用临时文件、fsync 与重命名保证写入可靠。它会对 NETWORK、TIMEOUT、SERVICE 等失败分类,并采用 fail-closed 策略——用户取消、鉴权错误、工具尚无持久结果或已完成/结果未知的工具不会盲目自动重试。恢复模式默认仅检查点(off),也可选 probe(有界就绪探测)或 deferred(显式延迟后继续)。恢复时通过 compare-and-set 重新激活目标并注入一条结构化上下文;可选地在恢复后的首轮拒绝与已完成调用完全相同的工具指纹。
插件 deliberately 不保存或重建隐藏思维链,不上传或同步检查点;也不保证任意工具的幂等性,自动续跑还依赖宿主挂载 goal 与 goal-round-driver。适合需要在本地留痕、在可控故障后继续同一目标、且重视隐私与边界策略的 Harness 用户与集成者。
使用场景
- 长任务因网络或超时中断后需要从本地检查点继续同一目标
- 需要在不保存思维链的前提下保留目标、待办与工具执行事实
- 希望用就绪探测或延迟策略控制自动恢复,避免盲目重试工具
适合人员
- 经常跑多步 Harness 目标、担心进程重启丢进度的开发者
- 需要在本地审计任务状态、且不上传检查点的团队
- 集成 DSH goal 与 goal-round-driver 并关心 fail-closed 恢复策略的插件作者