关于 caveman-stats
caveman-stats 是 Caveman 的用量统计功能,在 Claude Code 中以 /caveman-stats 显示已记录的输出与缓存读取 token 及响应次数。报告不估算节省量,并说明其他宿主的替代方式。
主要功能
- 01显示已记录的输出和缓存读取 token 数
- 02支持 --all 与 --since 7d 汇总统计
- 03支持 --share 输出可分享的用量报告
- 04按原样输出报告,不重新计算数值
适用场景
- 01查看 Claude Code 中 Caveman 会话的用量记录
- 02在 Gemini CLI 中查看当前会话用量的替代命令
- 03按时间范围汇总多次会话的输出量
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ juliusbrussee/ caveman --skill caveman-stats安装后在 Claude Code 中输入/caveman-stats确认已加载。
附带文件README.md
详细介绍
在 Claude Code 中,src/hooks/caveman-mode-tracker.js 会解析其同目录下的 src/hooks/caveman-stats.js,并在 /caveman-stats 时运行它。该钩子不会阻止提示词:它会通过 hookSpecificOutput.additionalContext 提供报告,并指示将报告原样打印在围栏代码块中。请严格照做,不要自行计算、重新计算或重新四舍五入这些数字。
在 Gemini CLI 中,请引导用户使用 /stats model 查看当前会话的令牌用量,或使用 /stats session 查看会话统计信息。Gemini 自定义命令是提示词;它们无法调用内置命令或读取实时会话指标。切勿将 Claude Code 转录内容当作 Gemini 用量。在其他宿主中,如果有原生用量报告,请使用该报告;否则说明当前会话用量不可用。Claude 读取器和其生命周期历史记录仅适用于 Claude Code。在没有经过测量的对比时,所有宿主的节省量都应标为未知。
报告会显示记录的输出令牌数、缓存读取令牌数、响应数量,以及可用时的模式归属。节省量未知:转录内容没有提供与未使用 Caveman 时的测量对比。不要根据输出数量或当前模式推断节省的令牌数、百分比、金额、规则开销或净结果。
--all 和 --since 7d 会汇总每个会话最近一次记录的输出数量。--share 会报告观测到的用量,并将节省量标为未知。历史 est_saved_* 字段会被忽略;其原始历史记录仍保留在磁盘上。状态栏会显示当前模式,不再显示已弃用的节省徽标。
原始/当前内存文件对会按测得的字节大小报告。这些文件大小差异无法证明节省了提供商令牌或费用。请参阅 docs/HONEST-NUMBERS.md。