shixiong0529/dsh-schedule-enable

dsh-schedule-enable

一个 DeepSeek Harness 纯 patch-only bundle（配置层），用于在组合它的 profile 中启用内置持久化调度器（@deepseek-ai/dsh-schedule），让活跃的根 Agent 拥有 3 个 Agent 作用域的调度管理工具：

| 工具 | 作用 |
| --- | --- |
| schedule_create | 在当前会话创建一条持久化提醒。需提供非空 prompt，并恰好选择一个选择器：after_seconds（正整数延迟秒数）、at（带偏移的 RFC 3339 字符串，或 {date,time,time_zone} 本地时间对象）、或 every_seconds（固定频率，至少 300 秒）。 |
| schedule_list | 按创建顺序列出当前会话的全部活跃提醒，含精确 id、UTC 目标时间、scheduled/overdue 状态、session-local 投递方式。 |
| schedule_delete | 按精确 id 删除一条活跃提醒。未知或已结束的 id 返回 deleted: false。 |

你安装的是 bundle；真正的调度引擎是 Harness 自带的内置包 @deepseek-ai/dsh-schedule。本 bundle 只贡献一个配置层，没有模块入口、没有依赖，因此非常小，且完全从平台解析。

安装

bundle 声明了 dsh.bundle.patch，所以 dsh plugin add 会把它作为 profile 层安装（外部包通过安装的扁平模块回退解析它们的 peer 依赖）。Web 界面运行在 web profile（dsh web 即 --profile web 的别名），所以安装到 web：

从 GitHub 安装（推荐，一条命令即可，无需先发布到 npm）：
dsh plugin --profile web add github:shixiong0529/dsh-schedule-enable
或从本地 checkout / tarball 安装：
dsh plugin --profile web add ./dsh-schedule-enable-0.1.0.tgz

这条命令会自动把 dsh-schedule-enable 追加到该 profile 的 dsh.profile.bundles（无需手动编辑任何文件）。安装后重启 profile（重新启动 dsh web），组合配置就会插入 time-context 和 schedule 两行，调度器即可用。

常见问题

- 报 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION：pnpm 11 对 lockfile 有 24 小时「最小发布年龄」供应链策略，如果目标 profile 里已有今天刚发布的其它包就会命中。在同一命令后追加 --config.minimum-release-age=0 即可（dsh 会原样转发参数给 pnpm，装完仍会自动加入 bundles）：
dsh plugin --profile web add github:shixiong0529/dsh-schedule-enable --config.minimum-release-age=0

- 安装后「插件列表」里看不到 @deepseek-ai/dsh-schedule：先运行 dsh --profile web --dump-config，确认输出末尾有 time-context 与 schedule 两行且没有 disabled: true；同时检查该 profile 的 cordis.patch.yml（用户补丁层）没有把这两个 id 设为 disabled: true。
- 调度工具只在新建会话里出现：调度器挂载到 profile 重启后新建的根 Agent 会话；已存在的旧会话不会自动获得 schedule_create / schedule_list / schedule_delete。

验证

只打印组合层，不启动服务：
dsh --profile web --dump-config
你应能在该 bundle 层里看到 schedule 和 time-context 两行。

然后启动 profile（dsh --profile web）。调度器会挂载到 profile 加载后创建的每个新的活跃根 Agent 上。

投递语义（继承自 dsh-schedule）

- 仅会话内：提醒只在原会话仍然活跃时按时运行。冷会话不会收到外部通知，只能在会话恢复后按 overdue 处理。
- 固定频率下限：every_seconds 至少 300（5 分钟），并以创建为锚点对齐。不支持 Cron/日历表达式。
- 只取最新一次：过期的固定频率规则只贡献其最近一次到期发生，不会回放错过的积压。
- 过期判定：活跃干系人从持久化 session fold 重新计算最早目标。回拨时钟不会提前触发；向前跳时会标记为 overdue。
- 不保证精确一次：在同步跟进入队之后、dispatch 落盘之前发生崩溃，可能重复触发一次提醒。该包不声称模型完成、用户确认或精确一次投递。
- 持久化状态位于会话事件日志（schedule/change）；定时器与工具值只是该 fold 的可丢弃投影。

使用示例

重启服务后，在 Web 界面新建一个会话，对 Agent 说：

提醒我 3 天后检查备份，并把提醒内容定下来。

Agent 会调用 schedule_create（选择 at 或 after_seconds）。到点时，会话内会出现一条 [SCHEDULE REMINDER] 消息，由模型正常跟进处理。

要求

- DeepSeek Harness 0.1.1-rc.2（或该基线的源码 checkout）。
- 目标 profile 需组合 @deepseek-ai/dsh-base（Web profile 还需 @deepseek-ai/dsh-web-app），它们提供 sessions、agents、tools、sessionPersistence。缺少任一必需服务时，Schedule 插件会组合失败。
- Node ^22.19.0 || >=24.0.0。

许可

MIT