idle-compact 空闲压缩
主会话空闲约 50 分钟后自动压缩一次，趁一小时缓存还热。
> 给订单列表加上分页
⏺ 我先看看列表组件。
idle-compact: compacts at 15:03 if nothing happens before then
… 50 分钟无新回合 …
idle-compact: compacted with a 95% cache hit
❯ 回来继续改
后台运行，无界面。这里显示的是示意日志。
❯
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add takahirom/takahirom-claude-code-marketplace
/plugin install idle-compact@takahirom-claude-code-marketplace
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add takahirom/takahirom-claude-code-marketplace
claude plugin install idle-compact@takahirom-claude-code-marketplace然后在会话里执行 /reload-plugins，或开一个新会话。
请帮我安装 Claude Code Mod「idle-compact 空闲压缩」（https://github.com/takahirom/takahirom-claude-code-marketplace）。安装前先阅读仓库 README 的 Security 和 Requirements 部分，告诉我它会读写哪些内容、运行什么命令、是否联网，以及对 Claude Code 版本、系统和终端的要求。确认没有问题后，运行 claude plugin marketplace add takahirom/takahirom-claude-code-marketplace 和 claude plugin install idle-compact@takahirom-claude-code-marketplace 完成安装，最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code，它会先读原作者说明再安装。
git clone https://github.com/takahirom/takahirom-claude-code-marketplace
cd takahirom-claude-code-marketplace
claude --plugin-dir ./plugins/idle-compact克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明，收录时核对；可用 claude plugin validate 自行检查。
读取
有读取会话 id、时钟与压缩结果里的用量字段，用于武装计时器与缓存命中提示。
写入文件
未说明未见写文件；仅通过界面日志往会话记录写预约与命中提示。
运行命令
未说明源码未见启动外部进程；作者未给出 Security 段。
联网
有空闲触发的 $.session.compact 会发起一次模型摘要请求。
介绍
idle-compact 是 Claude Code 的 function hooks Mod：主会话一轮回答结束后启动约 50 分钟的一次性计时器；若期间没有新回合、会话结束或手动压缩，就调用一次会话压缩，尽量在一小时提示缓存变冷前把长上下文收成摘要。压缩成功后不会重新计时，失败也不重试。子代理完成、中止或失败的回合不会武装计时器；若机器休眠导致计时器在超过约 58 分钟后才触发，则跳过，以免对已冷缓存整段重写。会话里会留下压缩预约与缓存命中提示（不送进模型）。作者对照 Claude Code 2.1.280 编写，并在 2.1.282 核对过缓存命中行；未声称硬性最低版本。许可证为 Apache-2.0。下方预览为示意。
适合谁
- 长会话离开约一小时再回来、想减少冷缓存重写成本的人
运行要求
- 作者对照 2.1.280 编写，并在 2.1.282 核对缓存命中行；未写硬性最低版本。
- 早期文档仍提到需开启 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1。