用途：读取本地 Codex 会话日志，生成一致的 token 用量报告，适合统计、审计、对比或汇报本地 Codex Desktop/CLI 的 token 消耗。
主要能力：统计 total、input、cached input、output、reasoning output、non-cached input、net usage、cache hit rate、每日平均总量，并给出峰值日与最忙一周。默认生成固定 HTML 仪表盘，包含每日堆叠柱状图、总量/净用量模式、token 构成、可排序每日表格和 CSV 导出；也支持 markdown 与 json 输出。
使用方式：在用户工作区运行已安装脚本，例如 python scripts/codex_token_usage.py --days 30 --timezone Asia/Shanghai。可用 --start/--end、--month、--codex-home、--format、--language、--output、--no-open 等选项。默认 HTML 会写入 output/token-usage-<start>-<end>.html 并请求系统默认外部浏览器打开；文本或 Markdown 请求用 --format markdown，机器可读用 --format json，自动化或不打开浏览器用 --no-open。若 python 不在 PATH，可使用捆绑的 Codex 运行时 python.exe。
适用场景：按周、月或自定义日期范围统计本地 Codex 用量；需要 HTML 仪表盘、Markdown 表格或 JSON 供其他脚本使用。
限制：报告为生成快照，不是实时监控；仅含用量聚合，不含提示词、会话 ID 或源路径。不要用 total_token_usage 求和，应使用 last_token_usage。HTML 需启用 JavaScript，离线打开，不依赖构建、服务器或 CDN。若浏览器打开失败或被阻止，应提供保存文件链接并说明未打开。缺失事实暂未提供。