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