name: tldr-stats description: 显示完整的会话令牌使用情况、成本、TLDR节省和钩子活动
TLDR统计技能
显示一个美观的仪表板,包含令牌使用情况、实际API成本、TLDR节省和钩子活动。
使用时机
- 查看TLDR实际为您节省了多少美元
- 检查会话令牌使用总量和成本
- TLDR有效性的前后对比
- 调试TLDR/钩子是否在使用中
- 查看正在使用的模型
指令
重要提示: 运行脚本并将输出显示给用户。
- 运行统计脚本:
python3 $CLAUDE_PROJECT_DIR/.claude/scripts/tldr_stats.py
- 将完整输出复制到您的回复中,以便用户在聊天中直接看到仪表板。不要只是静默运行命令——用户希望看到统计信息。
样本输出
╔══════════════════════════════════════════════════════════════╗
║ 📊 会话统计 ║
╚══════════════════════════════════════════════════════════════╝
您本次会话已花费 $96.52
令牌使用
1.2M 发送给Claude
416.3K 接收回
97.8K 来自提示缓存(8% 重复使用)
TLDR节省
您发送: 1.2M
无TLDR: 2.5M
💰 TLDR为您节省了约$18.83
(无TLDR:$115.35 → 有TLDR:$96.52)
文件读取: 1.3M → 20.9K █████████░ 98% 更小
TLDR缓存
重新读取同一文件?TLDR会记住它。
█████░░░░░░░░░░ 37% 缓存命中
(35 重用 / 60 新解析)
钩子: 553 次调用(✓ 全部正常)
历史: █▃▄ ▇▃▇▆ 平均 84% 压缩率
守护进程: 24分钟运行 │ 3 个会话
理解数字
| 指标 | 含义 |
|---|---|
| 您已花费 | 本次会话在Claude API上的实际$花费 |
| 您发送 / 无TLDR | 实际令牌数与没有TLDR的情况 |
| TLDR为您节省 | 通过压缩文件读取节省的钱 |
| 文件读取 X → Y | 原始文件令牌压缩为TLDR摘要 |
| 缓存命中 | TLDR重复使用解析文件结果的频率 |
| 历史趋势线 | 最近会话的压缩百分比(█ = 高) |
视觉元素
- 进度条 一目了然地显示节省和缓存效率
- 趋势线 显示历史趋势(█ = 高节省,▁ = 低)
- 颜色 指示状态(绿色 = 好,黄色 = 中等,红色 = 关注)
- 表情符号 区分模型类型(🎭 Opus, 🎵 Sonnet, 🍃 Haiku)
备注
- 令牌节省因文件大小而异(大文件 = 更多节省)
- 缓存命中率开始时低,随着重新读取文件而增加
- 成本估算使用:Opus $15/1M, Sonnet $3/1M, Haiku $0.25/1M
- 统计信息在您工作时实时更新