Cachebeat Skill 技能

技能简介

cachebeat 是一款体积极小的 Claude Code 技能（Skill），只为解决一个长期被忽视的浪费问题：让提示词缓存（Prompt Cache）在会话空闲时保持「温热」。Claude 每一次对话都要把完整历史重新发给 API，Anthropic 的提示词缓存能把缓存命中的输入按约 0.1 倍价格计费，一旦缓存过期，同样一段历史会以接近 10 倍的价格重新计算。cachebeat 通过一个惰性触发的心跳，把这段「闲置税」压到几乎为零。

核心能力

• 空闲保活：只在会话真正静默 N 分钟后触发一次心跳，任何消息、回复或后台事件都会刷新缓存并重置计时器，绝不无脑空转。
• 计费保护：用一次「冷启动」的代价约等于十次心跳来做衡量，只要你会回到这个会话一次，心跳就已经回本。
• 订阅守护：不仅省 API 费用，对 Pro/Max 订阅用户还能避免 5 小时窗口和周额度被无谓消耗。
• 自动止损：默认在 8 小时后自动终止，避免被遗弃的会话持续产生费用。
• 零配置：只需把 SKILL.md 复制到技能目录，输入 /cachebeat 即可运行，无需任何环境变量或配置项。
• 阈值可调：支持自定义空闲分钟数（被限制在 5 到 55 分钟之间），适配不同工作节奏。

安装配置

1. 用户级安装（对所有项目生效）：先创建目录 mkdir -p ~/.claude/skills/cachebeat，再把仓库中的 SKILL.md 复制进去。
2. 项目级安装（只对单个项目生效）：把 SKILL.md 复制到 /.claude/skills/cachebeat/ 目录下。
3. 前置要求：需要一个支持运行后台任务的 Claude Code 版本，这也是当前默认能力，通常无需额外设置。

使用步骤

1. 打开任意一个 Claude Code 会话。
2. 输入斜杠命令 /cachebeat 激活空闲监控。
3. 默认会在空闲 50 分钟后触发心跳，并在 8 小时后自动停止；如需调整阈值可输入 /cachebeat 40。
4. 触发时 Claude 会用极短回复唤醒会话，缓存 TTL 随之重新计时，你回来后即可无缝继续。

适用场景

• 长时间训练或跑批：模型微调、CI 构建、大文件下载等需要挂机数小时，人工偶尔离开的场景。
• 多日跟踪会话：需要跨越夜晚持续跟进的长任务，避免第二天回来后一次性重算全部历史。
• 成本敏感型开发者：重度使用 API 计费、希望把每一分 token 都花在正事上的人。
• 订阅额度紧张用户：5 小时窗口或周额度经常见底，想减少无谓消耗的 Pro/Max 用户。

适用人群

面向所有重度使用 Claude Code 的开发者、AI 工程师与自动化运维人员，尤其是那些经常让会话挂机等待长任务、又在意 token 成本或订阅额度的人。

工作原理

Claude 本身是无状态的，每轮都会把整段对话重新发送给 API，提示词缓存虽然能把命中部分降到约 10% 的价格，但缓存存在 TTL（长时会话最长约 1 小时）。一旦空闲超过 TTL，缓存失效，下一次提问就会以未缓存的全价重新处理整段历史。cachebeat 在会话内挂载一个惰性计时器，只有真正静默超过设定分钟数才唤醒一次，用极短的交互续期缓存，从而把「冷回来」的十倍开销转化为几乎可忽略的心跳成本。

官方链接

https://github.com/ARahim3/cachebeat