用途：从 Octocode 使用统计文件生成本地 HTML 看板，适合查看工具调用、token/字符节省、GitHub 缓存命中、限流规避、原始与最终响应体积对比、错误与包注册失败等。
统计文件路径：设置了 OCTOCODE_HOME 时用 ${OCTOCODE_HOME}/stats.json，否则用 ~/.octocode/stats.json，也可通过 --stats <path> 指定。文件缺失时提示先运行任意 Octocode MCP 工具。
用法：在仓库根目录运行 node skills/octocode-stats/scripts/build_dashboard.mjs 常用参数：--stats <path>、--output <path>、--no-open、--allow-empty、--help。构建脚本负责全部解析、计算、渲染与打开浏览器的行为，不要在其他脚本或对话中重复实现。
结果只需报告：看板路径、统计来源路径、总调用次数、预估节省 token、GitHub 缓存命中、错误；若浏览器未打开，附上手动打开命令 open <dashboard-path>（macOS）。
度量说明：token 为估算值，estimatedTokensSaved = savedChars / 4，须说明为近似。charsSavedByTool 是累计响应节省数据，不是近期活动日志或完整调用台账。零节省工具可能不出现在可视化明细中，但总调用次数仍可能包含。rawChars、responseChars、savedChars 是响应管线的测量值，并非严格满足 raw = response + saved。responseChars 为分页后的最终响应，rawChars 为实际抓取的上游负载；分页 API 只统计实际请求过的页。不要编造页面、字数、书籍或金额等对比。限制：不用于会话 ID 查询、凭据或无关配置文件。相关文件：packages/octocode-shared/src/session/schemas.ts、packages/octocode-shared/src/paths.ts、docs/SESSION_PERSISTENCE.md、docs/CONFIGURATION_REFERENCE.md。