ram-altman如何保证每天只发一封邮件?cron调度、flock锁与失败重试完全解析

原创2026-11-11 09:51:291,637 阅读

ram-altman如何保证每天只发一封邮件?cron调度、flock锁与失败重试完全解析

ram-altman 是一个有趣的 Linux 监控脚本:它会定时检测你的电脑还剩多少可用内存(RAM),一旦空闲内存超过阈值,就自动给 OpenAI 的 CEO Sam Altman 发一封"投诉邮件"。更巧妙的是——每封邮件最多每天发送一次。它是怎么做到的?答案藏在三样东西里:cron 调度、flock 文件锁,以及一个"先发送、后记账"的失败重试设计。本文将带你完整拆解这套机制,新手也能看懂。

ram-altman 是什么?

先了解一下背景:Sam Altman 曾公开吐槽"个人电脑里闲置着一大堆 DRAM,从全球分配角度看简直是太糟糕了"。这个项目就是带着幽默感给出的回应:

  • 📊 每 5 分钟采样一次内存使用情况,记录到 CSV
  • ✉️ 当可用内存超过 10% 时,给指定收件人发一封措辞各异的邮件
  • 🛡️ 保证每天最多一封,绝不轰炸收件箱

项目只有一个脚本 ram-altman.sh,外加一个测试脚本 test-ram-altman.sh,纯 bash 编写,没有任何依赖。

第一步:cron 调度每 5 分钟触发一次

ram-altman 自己不常驻运行,它依赖系统的 cron 定时任务来反复唤起自己。在 ram-altman.sh 的头部注释里就写明了推荐配置:

*/5 * * * * /path/to/ram-altman.sh

*/5 表示"每 5 分钟执行一次"。每天约 288 次触发——听起来会发 288 封邮件?当然不会。这正是后面几道"闸门"要解决的问题。

配合环境变量即可完成完整配置(详见 README.md):

RAM_ALTMAN_TO=recipient@example.com
RAM_ALTMAN_FROM=you@example.com
*/5 * * * * /path/to/ram-altman.sh

三道闸门:每天只发一封邮件的核心

main 函数的执行流程是"层层过滤":每次被 cron 唤醒后,脚本依次通过三道检查,全部通过才会真正发邮件。

闸门一:flock 文件锁,拒绝重复运行

第一道防线在 ram-altman.sh:

# Stop overlapping runs from both sending today's email.
if command -v flock > /dev/null; then
    exec 9> "$STATE_DIR/lock"
    flock -n 9 || exit 0
fi

这里用 flock -n(non-blocking,非阻塞模式)对状态目录下的 lock 文件加排他锁:

  • 如果另一个实例正在运行,flock -n 会立即失败,新进程直接 exit 0 安静退出
  • 这防止了两个进程同时通过日期检查、同时发邮件的"竞态条件"

新手常问:脚本明明 5 秒就跑完了,为什么还需要锁?因为如果某次运行卡在发信环节(比如网络慢),下一次 cron 触发时可能撞上尾巴。flock 是最省心的防并发手段,三行代码解决。

闸门二:阈值过滤,内存不够闲就不发

锁之后先采样内存,再判断是否"足够闲置"。判定逻辑在 ram-altman.sh:

is_over_threshold() {
    (( available_kb * 100 > THRESHOLD_PCT * total_kb ))
}

默认阈值是 10%(可用内存占比)。注意是严格的"大于"——恰好 10% 不算超过,测试脚本 test-ram-altman.sh 里专门验证了这条边界:

exactly 10%: no email      # 恰好 10%,不发
just over 10%: email sent   # 多 1 kB,就发

内存不够闲?直接 exit 0,连邮件模板都不会加载。

闸门三:last_sent 日期标记,一天只记一笔

这是"每天一封"最核心的一步,代码在 ram-altman.sh:

local today last_sent
today=$(date +%F)
last_sent=$(cat "$LAST_SENT_FILE" 2>/dev/null || true)
[[ "$last_sent" != "$today" ]] || exit 0

逻辑简单粗暴但非常有效:

  1. 状态目录下的 last_sent 文件保存着上次成功发信的那天日期
  2. 本次日期和它一样?说明今天已经发过了,直接退出
  3. 不一样(或文件不存在)?才允许继续往下走发信

状态目录默认在 ~/.local/state/ram-altman(可用 RAM_ALTMAN_STATE_DIR 环境变量覆盖),里面有三个文件:

文件 作用
usage.csv 每次采样的内存数据(超过 10 MiB 自动裁剪,见 ram-altman.sh)
last_sent 上次发信日期,"一天一封"的账本
lock + bag_* flock 锁文件、邮件文案随机抽签用的"袋子"

失败重试:先发送,成功后才记账

最精妙的设计在最后两步,ram-altman.sh:

compose_email
send_email || die "email failed to send; will try again on the next run"

# Recorded only after a successful send, so a failure gets retried.
echo "$today" > "$LAST_SENT_FILE"

顺序是关键:先发信,成功后才写入 last_sent。

  • 如果 sendmail/msmtp/mail 全部不可用或发送失败,send_email 返回非零,die 让脚本以错误码退出(见 ram-altman.sh)
  • 此时 last_sent 没有更新,明天之前的任何一次 cron 触发(5 分钟后)都会重新走一遍流程,再次尝试发送
  • 发送成功,日期落盘——今天到此为止

这就是"延迟到成功才记录"(write-on-success)模式,是构建可靠定时任务时的通用技巧:失败不记账,成功才记账,重试自然发生。测试脚本 test-ram-altman.sh 用一个会故意失败 75 的假 sendmail 完整验证了这条链路。

发信与防刷屏的小细节

  • 发信通道自动降级:优先 sendmail,其次 msmtp,最后 mail,都没有才报错(ram-altman.sh)
  • cron 的 PATH 问题:cron 环境里常常找不到 /usr/sbin 下的 sendmail,脚本在开头主动补全了 PATH(ram-altman.sh),这是 cron 新手最常踩的坑之一
  • 邮件不重样:8 个主题、10 段正文、6 个落款通过"随机抽签袋"轮换——先随机洗好整副牌,抽完一轮才重新洗牌,保证不连续重复(ram-altman.sh)
  • 严格模式:set -euo pipefail 确保任何命令出错都立即中止,避免半拉子状态(ram-altman.sh)

快速上手:三步体验

git clone https://gitcode.com/gh_mirrors/ra/ram-altman
cd ram-altman
chmod +x ram-altman.sh test-ram-altman.sh

然后先体验两个"安全模式":

./ram-altman.sh --status    # 查看本机内存详情
./ram-altman.sh --dry-run   # 预览会发出的邮件(不真发)

确认无误后,把环境变量和 */5 * * * * 一行加入 crontab -e,就大功告成。想跑测试看看 14 个断言是否全绿?执行 ./test-ram-altman.sh 即可,它全程使用模拟内存和假 sendmail,不会打扰任何真实收件箱(test-ram-altman.sh)。

总结:一张表看懂"每天一封"

层级 机制 挡掉了什么
调度层 cron */5 * * * * 提供高频采样,又天然低占用
并发层 flock -n 文件锁 两个实例同时运行
业务层 可用内存 > 10% 阈值 机器正忙时的无意义发信
状态层 last_sent 日期比对 当天第二、第三……第 N 次触发
可靠层 成功才写日期 发送失败导致的"当天漏发"

ram-altman 证明了:一个不到 300 行的 bash 脚本,靠 cron 调度 + flock 锁 + 成功记账,就能把"高频触发、低频发送"这件事做得严丝合缝。这套模式——高频唤醒、多重闸门、失败自动重试——同样适用于任何你想写的定时提醒或监控脚本,值得收藏借鉴。📬

登录后查看全文
ram-altman