Codex Usage

这个 Skill 做什么

从 Codex state_*.sqlite 数据库生成中文 Token 使用报告。报告面向普通用户阅读，默认使用 html-doc 风格，包含月度指标卡、真实 SVG 图表、月份选择器、曲线 hover 指标、可筛选表格、可排序表格和可复制 SQLite 查询。也支持让 Agent 编写一个只包含分析逻辑的 Python 脚本，再由 Skill 自动渲染成 HTML。所有展示数字统一使用 万、亿 等中文单位。

Agent 执行流程

1. 确认数据库路径。优先使用用户传入的 --db /path/to/state_5.sqlite；如果用户没有传入，脚本会依次尝试 $CODEX_USAGE_DB、$CODEX_SQLITE_HOME/state_5.sqlite、config.toml 里的 sqlite_home、$CODEX_HOME/state_5.sqlite、~/.codex/state_5.sqlite。
2. 执行 scripts/generate_codex_usage_report.py。默认渲染器是 html-doc，会同时生成 .html 和 .md。
3. 把 HTML 报告路径告诉用户。报告是自包含文件，可以直接用浏览器打开。
4. 如果用户需要原始汇总数据，加上 --json-out 输出 JSON。

自定义分析工作流

当用户希望 Agent 补充自己的 Token 分析时，使用两步流程：先生成数据 JSON，再让 Agent 写一个 analyze(report) 脚本，最后交给 render_token_analysis.py 渲染。Agent 只写分析逻辑，不写 HTML。

生成数据：