Token 用量统计
用途
该技能用于统计 Claude Code 的 Token 消耗情况。它会扫描 ~/.claude/projects/ 下全部会话 JSONL 文件，并生成两种可视化视图：仪表盘和 Token 日历。
安装与运行
本技能依赖 Python 3.10+，无需额外依赖包（纯标准库实现）。确认脚本路径后直接运行即可，可用 Glob 搜索 **/se7en-token-stats/token_stats.py 定位绝对路径。
一、仪表盘（token_stats.py）
包含以下内容：
- Summary cards：总量、日均、会话数、消息数
- Daily Trend：日度趋势折线图（Cache Read / Cache Write / Output 分层）
- Weekly / Monthly：周度和月度堆叠柱状图
- Token Breakdown：四类 token 占比环形图 + 明细卡片
- Models：模型分布横向进度条
- Activity by Hour：24 小时活跃度热力图
运行示例： python3 /path/to/token_stats.py python3 /path/to/token_stats.py --since 2026-03-01 python3 /path/to/token_stats.py -o ~/Desktop/token-report.html
参数说明：
- --since YYYY-MM-DD：起始日期
- --until YYYY-MM-DD：截止日期
- -o PATH：输出文件路径（默认 /tmp/token-stats.html）
- --no-open：不自动打开浏览器
二、Token 日历（token_calendar.py）
月历视图，每个日期格子显示当天总 Token 量和各模型消耗分布。支持月份切换、左右键导航、hover 查看详情。
运行示例： python3 /path/to/token_calendar.py python3 /path/to/token_calendar.py --month 2026-03
参数说明：
- --month YYYY-MM：初始显示月份（默认当月）
- -o PATH：输出文件路径（默认 /tmp/token-calendar.html）
- --no-open：不自动打开浏览器
日历格子内容：日期（醒目）· 总 Token · 会话/调用数 · 前三模型明细 · 模型占比条。无数据日期虚线边框。
触发判断
用户说「token 日历」「用量日历」→ 运行 token_calendar.py；其他 token 统计类请求 → 运行 token_stats.py。
数字单位
所有数字使用中文单位：亿、万、千。图表坐标轴、tooltip、卡片数值统一遵循此规则。
日历视觉风格
暖光浮动卡片设计。
调色板：
- --bg：#f4f1ec，暖纸底背景
- --card：#ffffff，浮动卡片
- --text：#1c1917，主文本（warm near-black）
- --text-secondary：#78716c，次文本
- --text-tertiary：#a8a29e，辅助文本
- --accent：#d4714f，珊瑚强调色
- --border：rgba(0,0,0,0.06)，默认边框
- --shadow：0 1px 3px rgba(120,100,80,0.06)，暖色调阴影
字体：Outfit（Google Fonts）+ PingFang SC / Noto Sans SC CJK fallback。全局 tabular-nums 对齐数字。
布局规则：
- 周一起始：周一~周日，周六日标记为 weekend（珊瑚色日期）
- 浮动卡片网格：7 列 CSS Grid，gap: 8px，每个有数据的日期是独立白色卡片（border-radius: 14px）
- 无数据日期：虚线边框（dashed rgba(0,0,0,0.08)），无背景
- 空占位格：完全透明，min-height: 40px
- 当日高亮：珊瑚色 border + box-shadow 双环
日格卡片内容（由上至下）：
- 日期数字（1.1rem / 700 weight，醒目）
- Token 总量（1.2rem / 700 weight）
- 会话·调用（0.68rem 辅助文字）
- 前三模型明细（色点 + 名称 + 用量）
- 模型占比条（4px 堆叠色带）
交互：
- Hover：卡片 translateY(-2px) + 阴影加深，模型条 scaleY(1.5)
- 入场动画：fadeUp 瀑布式（animation-delay: d * 20ms）
- Tooltip：玻璃态（backdrop-filter: blur(20px)），含完整模型明细 + 百分比
- 键盘：左右箭头切换月份
页面底部：
- 环形图（SVG donut）：180px，展示月度模型占比，中心显示月度总量
- 模型图例：两列卡片网格，默认显示前 6 个，「显示全部」按钮展开其余
- 每项含：色点 + 模型名 + 用量 + 百分比
响应式：
- < 900px：模型明细隐藏，图例单列
- < 600px：模型条隐藏，日格最小化
- 打印：隐藏导航和页脚
适用场景
适用于需要查看 Claude Code Token 消耗总量、日均用量、会话与消息数量、按日/周/月趋势、模型分布、按小时活跃度，以及按日历查看每日用量与模型占比的场景。
限制
资料未提供除 Python 3.10+ 与纯标准库之外的其他运行环境要求、数据来源之外的统计口径说明、价格或费用计算功能、平台支持范围等信息。