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 依赖):
dsh plugin --profile web add dsh-schedule-enable
# 或从本地 checkout / tarball 安装:
dsh plugin --profile web add ./dsh-schedule-enable-0.1.0.tgz
# 或从 git:
dsh plugin --profile web add github:you/dsh-schedule-enable
这会把 dsh-schedule-enable 追加到该 profile 的 dsh.profile.bundles。下次启动时,组合配置会插入 time-context 和 schedule 两行,调度器即可用。
验证
# 只打印组合层,不启动服务:
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
