cc-showtimelisted

# cc-showtime 分析本地 `~/.claude` 历史会话，按项目聚合统计 Token 消耗、工具调用、Skill 使用等数据，输出可视化报告。 ## 触发场景 - 用户询问 Claude Code 使用统计或历史分析 - 用户想看 Token 消耗、项目分布、时间趋势 - 用户说"分析一下我的使用情况"、"最近用了多少 token" - 用户想导出报告（JSON / HTML / 单文件） ## 用法 ```bash /cc-showtime [选项] ``` ## 选项 | 选项 | 说明 | |------|------| | `-f, --format <格式>` | `serve`（默认，启动浏览器）、`console`、`json`、`html`、`singlefile` | | `-o, --output <路径>` | 输出文件路径（json/html/singlefile 时有效） | | `-p, --project <名称>` | 只分析指定项目（可多次使用） | | `--since <YYYY-MM-DD>` | 起始日期筛选 | | `--until <YYYY-MM-DD>` | 结束日期筛选 | | `--top <N>` | 控制台输出时只显示前 N 个项目 | | `--trends` | 显示时间趋势和缓存效率分析 | | `--full-path` | 显示完整项目路径 | | `install-hooks` | 安装 PreToolUse hook 增强工具统计 | ## 输出格式说明 - **serve（默认）**：启动本地 HTTP 服务器，自动打开浏览器展示交互式报告 - **console**：终端表格输出，适合快速查看 - **json**：结构化数据导出 - **html**：内联所有数据的独立 HTML 文件，可离线查看 - **singlefile**：纯前端壳（单文件 HTML，需配合数据目录或静态服务器） ## 报告内容 - **会话看板**：项目 → 会话 → 详情三级看板，支持搜索过滤 - **项目概览**：各项目的 Token 消耗、会话数、活跃度 - **工具分析**：Read / Edit / Bash / Grep 等工具的调用分布 - **Skill 统计**：各 Skill 的调用次数和 Token 消耗 - **趋势图表**：按天统计 Token 消耗和会话活跃度 ## 可用脚本 产物 `scripts/` 目录下的可执行脚本： | 脚本 | 用途 | |------|------| | `cli.js` | 统一入口，解析参数、调用各模块生成报告 | | `parser.js` | 读取 `~/.claude` 历史会话数据 | | `analyzer.js` | 按项目聚合统计 Token、工具调用、Skill 使用 | | `trends.js` | 日/周趋势和缓存效率分析 | | `reporter.js` | 控制台/JSON/HTML 报告输出 | | `stats-hook.js` | `PreToolUse` hook，增强工具调用统计精度 | Claude 通过 `node scripts/cli.js [选项]` 执行分析任务。 ## 数据来源 直接读取本地 `~/.claude` 目录： - `history.jsonl` — 会话索引 - `projects/<项目>/<sessionId>.js