DeepSeek Harness 定时提醒怎么用?schedule 四工具、preset 与时区频率
DeepSeek Harness 的定时提醒已经是发布版 Web profile 的内置能力,不再是需要额外启用的实验包。 真正决定“能不能用”的是 Agent 的 preset:standard、cordis、ptc 提供四个 schedule 工具和时钟上下文,minimal 不提供,被委派的子 Agent 也看不到。频率写法、时区与投递语义则决定“到点会不会按你预期触发”。
DeepSeek Harness:四个工具与 preset 矩阵
Schedule 的能力不是全局开关,而是按 preset 声明:同一个 DSH 实例里,不同 Agent 可能有的能用、有的不能用。 对照如下:(来源)
| preset | 四个 schedule 工具 | 时钟上下文 |
|---|---|---|
standard | 有 | 有 |
cordis | 有 | 有 |
ptc | 有 | 有 |
minimal | 无 | 无 |
| 被委派的子 Agent | 被 deny | 不可见 |
四个工具各管一件事:
schedule_create— 创建提醒,写入频率、时区与指令。预期:自动化任务页出现一条新任务。schedule_list— 列出当前活动提醒。预期:只显示活动任务,不显示已投递的一次性任务。schedule_update— 原地修改名称、指令或运行时间,保留任务 id 与已保存投递记录。预期:任务不换 id,历史仍在。schedule_delete— 删除任务及其保存的发送记录。预期:任务从列表消失,原对话不受影响。
如果模型说“我没有定时工具”,先确认它用的 preset,再看它是不是子 Agent。别急着重装。
DeepSeek Harness:五种频率怎么写
官方支持一次性、绝对时间、固定间隔、每日、每周与 cron;差别主要在时区与“错过一次后怎么办”。 逐种看:(来源)
- 一次性延迟 — 传正整数秒,例如“30 分钟后提醒我”。预期:只投递一次,之后变为未运行,不会自动变成重复任务。
- 绝对日期时间 — 指定具体日期与时间。预期:不存在的本地时间会被拒绝,重叠时间选择较早的一次。
- 固定间隔 — 至少一分钟,例如“每 2 小时”。预期:间隔改变前与创建时间对齐,改变后与保存时间对齐。
- 每日本地时间 — 必须带 IANA 时区,例如“每天 Asia/Shanghai 23:00”。预期:不存在的本地时间跳过,重叠时间选较早的一次。
- 每周本地时间 — 带 IANA 时区与 ISO 星期(周一 1 到周日 7)。预期:按保存的星期与本地时间触发。
- 五字段 cron — 必须显式带 IANA 时区,表达式以规范化形式保存。预期:适合“工作日 9 点”这类规则。
自然语言请求会使用浏览器提供的时区来解释;如果你要跨设备、跨地区稳定触发,最好在请求里显式写出时区。
DeepSeek Harness:五类请求的实际写法
把请求写成官方支持的时间形态,能明显减少模型猜错。 示例:(来源)
- 一次性延迟 — “30 秒后提醒我检查构建结果。”预期:按正整数秒创建,投递一次后变为未运行。
- 绝对时间 — “2026-10-22 09:00 Asia/Shanghai 提醒我发版本。”预期:不存在的本地时间被拒绝,重叠时间选较早。
- 固定间隔 — “每 2 小时提醒我看一次队列。”预期:间隔至少一分钟;改间隔后从保存时间重新对齐。
- 每日 — “每天 Asia/Shanghai 23:00 提醒我查看天气。”预期:按保存的本地时间与时区触发。
- 每周 — “每周一 Asia/Shanghai 09:00 提醒我开周会。”预期:ISO 星期从周一到周日为 1 到 7。
- cron — “工作日 09:00 Asia/Shanghai 提醒我站会。”预期:五字段表达式,显式时区,保存为规范化形式。
跨夏令时的地区,重点测“不存在的本地时间”和“重叠时间”两个边界;这两类不会按直觉触发。
DeepSeek Harness:自动化任务页怎么用
自动化任务页是跨 Session 的提醒总览,不是某个对话的附属面板。 它提供四类操作:(来源)
- 跨会话查看 — 从侧栏打开,不激活对应对话。预期:所有活动与未运行任务都在一个列表里。
- 搜索与筛选 — 按名称、指令或内部 Session id 搜索,用“全部 / 已开启 / 未运行”过滤。预期:快速定位某条提醒。
- 查看运行记录 — 选中任务打开“规则”,再切到“任务运行记录”。预期:每次加载最近 20 条,可继续加载更早记录。
- 编辑或删除 — 活动任务可改名称、指令与时间;删除会连同保存记录一起移除。预期:编辑保留 id 与历史,删除不影响原对话。
页面上有几个容易误解的细节:Session 行只有在“有活动任务、自身空闲且未归档”时才显示时钟标识;归档行不显示实时状态;记录按保存顺序从新到旧排列,即使时钟回拨也不改顺序。
DeepSeek Harness:投递语义与保留策略
提醒只保证“消息进了对话收件箱”,不保证模型执行完成,也不保证恰好投递一次。 这条边界必须记住:(来源)
- 进程关闭就不调度 — 宿主停止后不会触发;重启后补投逾期的一次性提醒,或每条重复任务最近错过的一次。
- 同 Session 的重复任务可以共用一条消息 — 到期的多个提醒可能合并,不要假设一条提醒对应一条独立消息。
- 发送记录不是执行历史 — 收件箱持久化后崩溃或任务写入失败,可能重复投递;接收端要能容忍重复。
- 保留受两个参数限制 —
deliveryHistoryDays控制天数窗口,deliveryHistoryRecords控制最多条数;最近一次回执始终保留。
另外,官方明确不支持“暂停”和“每次运行新建 Session”。修改名称、指令与时间是允许的,但这不是跨会话转交工作流的机制。
DeepSeek Harness:三条创建路径怎么选
对话创建、页面新建、原地更新,三条路径落到同一份任务数据,但适合的场景不同。 对比如下:(来源)
- 对话里让模型创建 — 最自然,适合“想到就加一条”。预期:模型调用
schedule_create,页面立刻出现任务。 - 自动化任务页“新建” — 打开一个新会话,composer 已写好请求。预期:适合不想自己拼频率描述的场景。
- 对已有任务
schedule_update— 保留 id 与投递记录,只改时间或指令。预期:适合调整已经验证过的提醒。
如果提醒只存在于旧 Session 日志里,不会自动调度;需要重新创建。删除过的任务记录也不会被重建。
从实验性 schedule bundle 迁移
早期文章里写的“先启用实验性 bundle”已经过时:现行发布版 Web profile 自带 Schedule,旧 bundle 不再是前置条件。 迁移时按下面做:
- 确认当前版本 — 运行
dsh -V,并检查 Web profile 是否已包含 Schedule 服务。预期:自动化任务页可直接打开,模型能看到四个工具。 - 撤掉重复声明 — 如果旧 patch 还手动插入了实验性 schedule bundle,先移除该行。预期:避免同一服务重复注册或工具重复。
- 重建需要的提醒 — 旧版本里创建的任务不会自动进入新结构。预期:在自动化任务页重新创建,并核对时区与频率。
迁移完成后,用一次“每天固定时间”的提醒验证时区,再用一次“几分钟后”的提醒验证一次性投递。
DeepSeek Harness 常见问题
Q:为什么“每天 23 点”有时会跳过一天? 该时区下不存在的本地时间会被跳过,重叠时间选择较早的一次。跨夏令时地区尤其常见,显式时区能让行为可预测。
Q:能不能让子 Agent 创建提醒? 不能。三个 preset 的委派行都 deny 了四个 schedule 工具;即使调用到达工具也会被拒绝。提醒应由主 Agent 创建。
Q:删除提醒会删掉原对话吗? 不会。删除只移除任务及其保存的发送记录,不删除原对话,也不会撤回已经进入队列的消息。
一句话收束: 定时提醒能不能用,先看 preset;准不准,看时区与频率;可不可靠,记住它只保证进收件箱,不保证模型执行完成。
常见问题
DeepSeek Harness 里,不需要。发布的 Web profile 已经自带宿主 Schedule 服务与自动化任务页面;先配好模型 provider,再让模型调用 schedule_create 即可。只有 minimal preset 既不声明四个工具,也不声明时钟上下文。
DeepSeek Harness 里,先看 Agent 用的 preset:standard、cordis、ptc 才有 schedule_create、schedule_list、schedule_update、schedule_delete;minimal 没有。再看是不是子代理:三个 preset 的委派行都 deny 了这四个工具,子代理即使收到调用也会被拒绝。
DeepSeek Harness 里,支持正整数秒的一次性延迟、绝对日期时间、至少一分钟的固定间隔、带 IANA 时区的每日本地时间、带 IANA 时区与 ISO 星期的每周本地时间,以及带显式 IANA 时区的五字段 cron。一次性提醒投递后不会自动变成重复任务。
DeepSeek Harness 里,不会。宿主停止后调度也停止,直到进程再次启动。重启后会检查存储的任务,投递逾期的一次性提醒,或每条重复任务最近错过的一次;提醒本身保存在磁盘上,不会因为进程退出而丢失。
DeepSeek Harness 里,不能。已保存的发送记录只确认消息已经持久化到对话收件箱,不表示模型完成了所请求的工作,也不是执行历史或外部通知渠道。收件箱持久化后崩溃还可能重复投递,官方不保证恰好一次。
相关术语
- schedule_create
- schedule_create 是 DeepSeek Harness 的提醒创建工具,由 standard、cordis、ptc 三个 preset 提供,支持一次性、绝对时间、固定间隔、每日、每周与五字段 cron 规则。— DeepSeek Harness 官方文档 - Schedule 提醒
- 自动化任务页
- 自动化任务页是 DeepSeek Harness Web UI 中跨 Session 查看、搜索、编辑和删除提醒的页面,区分全部、已开启与未运行状态,并展示每个任务最近 20 条发送记录。— DeepSeek Harness 官方文档 - Schedule 提醒
- IANA 时区
- IANA 时区是形如 Asia/Shanghai 的时区标识。DeepSeek Harness 的每日、每周与 cron 提醒要求显式时区,以避免自然语言里的本地时间产生歧义。— DeepSeek Harness 官方文档 - Schedule 提醒
- 投递记录
- 投递记录是 DeepSeek Harness 保存的提醒发送回执,确认消息已持久化到对话收件箱;它不表示模型完成工作,也不是执行历史,受 deliveryHistoryDays 与 deliveryHistoryRecords 限制。— DeepSeek Harness 官方文档 - Schedule 提醒
来源
- DeepSeek Harness 官方文档 - Schedule 提醒· deepseek-ai
- DeepSeek Harness 官方参考 - 定时提醒子系统· deepseek-ai