shangliy/kvleak 是一个 Python 工具,用于分析编码工具会话记录中的提示词缓存复用与重建成本。最新版本是 v0.12.0。所提供的信息中没有该版本的更新日志,因此无法确认新增或变更的功能。该仓库聚焦于依据 Claude Code 等编码工具在本地留下的记录,找出产生缓存成本的位置。
该工具不只查看缓存是否命中,而是按会话与模型调用拆分使用量,以考察重建成本。根据 README 的说明,它会展示由空闲时间、新会话、子代理等造成的缓存损耗。它还支持多个代理的记录以及 JSONL 格式,并且可以通过调整配置和安装钩子来尝试改进。它还提供状态栏和预测功能,并说明有命令可以撤销更改。Codex CLI、Gemini CLI、OpenCode 也在支持范围内。它说明分析记录文件不需要 API 密钥、网络连接或外部依赖。许可证为 MIT。
不过,缓存损耗分析功能究竟能在多大程度上转化为实际成本节省,尚未得到确认。也没有给出支撑性能或节省数字的验证结果。因此,kvleak 可以视为一个用于从会话记录中寻找成本原因的分析工具,但尚缺乏足够依据把它当作保证预期节省额的手段。