每天早上 7 点的定时简报,读起来像一条机器通知——两个开关能改掉

每天早上一份简报发到 Telegram:昨天合并了几个 PR、构建过没过、有没有需要你拍板的事。内容其实写得不错,但你每次看到的第一屏是这样的:
Cronjob Response: Morning brief
(job_id: 8322078a1a06)
-------------
昨天合并 12 个 PR……
四行机器味的抬头,占掉了手机通知的预览空间,也让人一眼觉得“这是系统消息,不用细看”。再往下翻,末尾还有一句“要停止或管理这个任务,请给我发消息”。
问题不在排版强迫症。真正麻烦的是第二件事:你想回复“第三个 PR 是什么”,agent 一脸茫然——因为这条消息从来没有进入过对话历史,它只是单向发送的通知。
这两件事各有各的开关,而且都是按单个 job 生效的。
第一个开关:把那层包装关掉
包装是全局默认开启的,配置项叫 cron.wrap_response,默认为 true。开着的时候,每次投递都会套上这段:
Cronjob Response: <任务名>
(job_id: <任务 id>)
-------------
<真正的正文>
要停止或管理这个任务,请给我发消息(例如 "stop reminder <任务名>")。
对“提醒我 20 分钟后关火”这种一次性提醒,这段是必要的——你需要知道怎么取消它。但对每天固定送达的简报、状态汇总,它只是噪音。
现在可以按 job 覆盖:
# 新建时就关掉包装
hermes cron create "0 7 * * *" "昨天的 PR 与构建简报……" --name "Morning brief" --no-wrap-response
# 已有的 job 改掉
hermes cron edit 8322078a1a06 --no-wrap-response
# 想恢复跟随全局默认(默认就是 true)
hermes cron edit 8322078a1a06 --inherit-wrap-response
三个开关的关系很直白:--wrap-response 强制套包装,--no-wrap-response 强制不套,--inherit-wrap-response 删掉这条 job 自己的设置、重新跟随全局 cron.wrap_response。第三种在“我试过不套,但还是想统一”的时候很有用——它不会留下一个写着 false 的字段,而是真的把覆盖删掉。
如果你想让整个实例的简报都干净,直接改全局:
# ~/.config/hermes/config.yaml(或你的 profile 配置)
cron:
wrap_response: false
改完全实例生效,包括以后新建的 job。单个 job 的显式设置优先于它。
第二个开关:让追问落在自己的线程里
通知型投递是“发完就完”。要让简报变成一段可以继续的对话,得让它成为“可继续的任务”(continuable)。开关有两个层级:
cron:
mirror_delivery: true # 全局打开:投递的简报进入对应会话历史
或者在单个 job 上开:
hermes cron edit 8322078a1a06 --attach-to-session
打开之后的行为是“优先用线程”:
- 支持线程的平台(Telegram 的 forum topic、Discord / Slack / Matrix 的线程):每次投递开一条专属线程,简报被写进那条线程的会话,你在线程里追问就带着完整上下文。
- 只有私信的平台(WhatsApp、Signal、短信):没有线程概念,简报被镜像进目标私信会话,私信本身就是继续的界面。
- 镜像写进去的是一条带标签的用户消息:
[Cron delivery: <任务名>]。这样在历史里能看出“这是定时任务送来的”,也能保证不同模型 provider 下的对话轮次交替是合法的。
这里有个容易被忽略的细节:在 Telegram topic 里创建的 job,默认仍然发回那个 topic,因为它的来源把目标钉住了。而“每次运行开新线程”恰恰是投递型 job 最想要的行为——否则昨天的追问和今天的简报挤在同一个 topic 里,你回一句“那第二个呢”,agent 分不清你指今天还是昨天。
给这种 job 补一个平台级开关:
platforms:
telegram:
extra:
cron_fresh_thread_per_run: true
它只影响“投递回 job 自己所在 topic”的那些运行;你显式写了 chat_id:thread_id 的目标永远不会被改写。Discord 是个例外:它不能在 job 已有的线程里再套一层线程,所以在 Discord 线程里创建的 job 仍然发回原线程。
顺带收拾“运行时机”的两个开关
既然在调 job,另外两个经常一起改的参数值得知道,它们解释了很多“为什么我的简报今天没来”。
catch_up:机器关着的时候错过了怎么办。 --catch-up on 表示回来后补跑一次;off 表示跳过,而且在 hermes cron runs 里记成一行 missed。默认值是配置项 cron.catch_up_missed(对周期任务生效),一次性任务默认跳过——毕竟“20 分钟后关火”的提醒,两小时后补跑毫无意义。
grace_minutes:一次运行可以迟到多久。 默认窗口是半个周期,再夹到 2–120 分钟之间。--grace-minutes 0 是个特殊值:永远不补,错过的那次直接跳过而不是迟到执行。反过来,如果你有一个“必须跑,晚一点也行”的夜间任务,可以把它放大到最多 1440 分钟(一天)。
--timezone:按哪个时区读 cron 表达式。 不写就跟随 profile 的时区。跨时区团队常见的坑是“我明明写的是 9 点”,其实是按服务器所在时区算的——这一项就是为它准备的。
一个配好的例子
把上面的东西拼起来,一个“干净的、可追问的、每天 7 点(香港时间)的简报”长这样:
hermes cron create "0 7 * * *" \
"收集昨天的 PR、构建与部署结果,写成 200 字以内的简报;没有异常就只说一句。" \
--name "Morning brief" \
--timezone Asia/Hong_Kong \
--no-wrap-response \
--attach-to-session \
--catch-up on
再在 config.yaml 里给 Telegram 打开每次新线程:
platforms:
telegram:
extra:
cron_fresh_thread_per_run: true
结果:早上 7 点一条干净的简报落在自己的线程里,你回一句“第三个 PR 谁合的”,agent 知道你在说哪份简报里的哪一条。
几个边界
wrap_response关掉不影响投递本身:目标、失败通知、重试全都不变,只是不再套那层文字。- 失败通知走另一个开关:
failure_deliver单独指定失败消息发去哪儿,local可以彻底不打扰你(状态仍记在hermes cron list/hermes cron runs里)。 - 可继续的 job 不是“永远同一个会话”:线程是按运行开的,历史按线程分开;想跨运行累积上下文,用
--continuity(每次运行能看到自己上一次的输出),这是另一件事,别混。 - 不是所有投递目标都能继续:广播式(
deliver: all)永远不会被镜像成会话,因为那会同时改动多个对话的历史。
如果你的 cron 经常出问题、想先做一次体检,看hermes cron doctor 那篇;想理解“每次运行都能看到上一次输出”的连续性,看定时任务记忆连续性。命令的完整参数在 hermes cron 参考页,本次改动记录在 v0.23.2 版本页。
小结
同一份简报,读起来像机器通知还是一个同事发来的消息,差别就在这两层:外层包装(wrap_response)决定它看起来像什么,可继续投递(attach_to_session + 每次新线程)决定你能不能顺着它问下去。两个都是按 job 一个开关的事,加起来不到一分钟,但每天都会用上。