mcpField
T
tldr-stats

tldr-stats

github.com/parcadeiAgent 工作流3.9k476 次安装39 周前更新
代码仓库

关于 tldr-stats

用于展示 TLDR 使用统计的技能，面向希望查看会话 Token、API 成本、压缩节省和钩子活动的用户。它要求运行统计脚本，并将完整仪表盘输出展示在对话中。

主要功能

  1. 01展示会话 Token 与费用
  2. 02统计 TLDR 节省
  3. 03查看文件读取压缩数据
  4. 04显示缓存命中与历史趋势
  5. 05检查模型和钩子活动

适用场景

  1. 01查看当前会话的 Token 使用量
  2. 02比较 TLDR 压缩前后的成本
  3. 03确认 TLDR 或钩子是否运行

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill tldr-stats

安装后在 Claude Code 中输入/tldr-stats确认已加载。

详细介绍

TLDR 统计技能

显示精美的仪表板，包含令牌用量、实际 API 成本、TLDR 节省量和钩子活动。

使用场景

  • 查看 TLDR 为你节省了多少实际费用
  • 查看会话令牌总用量和成本
  • 对比使用 TLDR 前后的效果
  • 调试 TLDR/钩子是否正在使用
  • 查看当前使用的模型

说明

**重要：**运行脚本并向用户展示输出。

  1. 运行统计脚本：
python3 $CLAUDE_PROJECT_DIR/.claude/scripts/tldr_stats.py
  1. 将完整输出复制到回复中，让用户直接在聊天中看到仪表板。不要只静默运行命令——用户想看到统计数据。
输出示例
╔══════════════════════════════════════════════════════════════╗
║  📊 Session Stats                                            ║
╚══════════════════════════════════════════════════════════════╝

  You've spent  $96.52  this session

  Tokens Used
        1.2M sent to Claude
      416.3K received back
       97.8K from prompt cache (8% reused)

  TLDR Savings

    You sent:               1.2M
    Without TLDR:           2.5M

    💰 TLDR saved you ~$18.83
    (Without TLDR: $115.35 → With TLDR: $96.52)

    File reads: 1.3M → 20.9K █████████░ 98% smaller

  TLDR Cache
    Re-reading the same file? TLDR remembers it.
    █████░░░░░░░░░░ 37% cache hits
    (35 reused / 60 parsed fresh)

  Hooks: 553 calls (✓ all ok)
  History: █▃▄ ▇▃▇▆ avg 84% compression
  Daemon: 24m up │ 3 sessions

数值说明

指标含义
你已花费本次会话在 Claude API 上实际花费的金额
你已发送 / 不使用 TLDR 时实际令牌数与原本可能达到的令牌数
TLDR 为你节省了通过压缩文件读取节省的费用
文件读取 X → Y原始文件令牌数压缩为 TLDR 摘要后的令牌数
缓存命中TLDR 复用已解析文件结果的次数
历史迷你图最近会话的压缩率（█ = 高）

可视化元素

  • 进度条可一目了然地展示节省量和缓存效率
  • 迷你图展示历史趋势（█ = 节省多，▁ = 节省少）
  • 颜色表示状态（绿色 = 良好，黄色 = 一般，红色 = 需关注）
  • 表情符号用于区分模型类型（🎭 Opus、🎵 Sonnet、🍃 Haiku）

注意事项

  • 令牌节省量因文件大小而异（大文件 = 节省更多）
  • 缓存命中率初始较低，随着重复读取文件而升高
  • 成本估算采用以下价格：Opus $15/1M、Sonnet $3/1M、Haiku $0.25/1M
  • 统计数据会随工作进展实时更新

评论

支持 Markdown