ylxmf2005/dsh-scheduled

dsh-scheduled

面向 DeepSeek Harness 的持久化 Heartbeat 与 Cron 定时自动化插件。

dsh-scheduled 是一个全局自动化插件：一次安装即可管理跨项目、跨会话的计划任务。这一点与 DSH 内置的 dsh-schedule 不同；后者把会话内提醒存储在当前 Session 的事件日志中。

功能

- Heartbeat：恢复已有 DSH 会话，并在原会话中继续执行提示词。
- Cron：每次运行创建新的项目会话，可选择独立 Git worktree。
- RFC 5545 重复规则、IANA 时区与 DST 感知的墙上时钟调度。
- 使用原子替换写入的持久化任务与运行记录。
- 防重叠、记录跳过的计划、重启后的中断恢复和稳定错误码。
- Agent 工具与 Web 设置页共用同一套 Host RPC 服务。
- 使用 Cordis 生命周期定时器，并将工具注册在 Agent 作用域内。

安装

这是一个 DSH bundle，可从公开 GitHub 仓库安装到 profile。请锁定 commit 以保证可复现：

dsh plugin --profile web add github:ylxmf2005/dsh-scheduled#56c067b

v0.1.4 release 还提供了预构建 tarball，不需要安装时构建：

dsh plugin --profile web add https://github.com/ylxmf2005/dsh-scheduled/releases/download/v0.1.4/dsh-scheduled-0.1.4.tgz

从 GitHub checkout 安装时，请在 profile 的 pnpm-workspace.yaml 中允许构建：

dsh plugin --profile web add github:ylxmf2005/dsh-scheduled#

allowBuilds:
dsh-scheduled: true

Git 安装拿到的是源码，会运行包内自包含的 prepare 构建。只允许信任的源码执行安装构建。安装后重启 DSH，在 设置 > 插件 > 定时任务 中使用。

使用

计划使用 RFC 5545 文本。需要固定墙上时钟时，请写入 DTSTART 与 TZID：

DTSTART;TZID=Asia/Shanghai:20260822T090000
RRULE:FREQ=DAILY;BYHOUR=9;BYMINUTE=0

Heartbeat 需要目标 Session，Cron 需要项目路径。automation_update 工具支持 create、list、view、update、delete、run、runs、mark_read；设置页通过 Host RPC 提供同样的操作。

失败运行会被记录，默认不会自动重试；除非暂停或完成任务，否则下一次重复仍会保留。

持久化与保留

默认状态文件是 $DSH_HOME/automations/automations.json。使用全局 JSON 是有意的设计：任务需要能够恢复冷会话并跨项目创建运行，不能只放在某一个 Session 的事件日志中。写入采用临时文件加 rename；文件损坏时启动会明确失败，不会静默丢失任务。

Cron worktree 默认保留，以便运行结束后仍可检查对应的 DSH 会话。删除前请先检查运行记录及 Agent 产生的变更。

开发

需要 Node.js >=22.19.0 与 pnpm：

pnpm install
pnpm test
pnpm run typecheck
pnpm run build
pnpm pack --dry-run

GitHub 安装使用的构建路径与 pnpm run prepare/npm run prepare 相同。贡献流程见 CONTRIBUTING.md，版本记录见 CHANGELOG.md。

许可证

MIT