https://github.com/yaowen51888-rich/lumencode

AI 编码工具帮你写了多少代码？一条命令见分晓。支持 Claude Code · Codex · OpenCode 三大 AI 编码工具。How much code have AI coding tools written for you? One command will tell. Supports three major AI coding tools: Claude Code, Codex, and OpenCode.
https://github.com/yaowen51888-rich/lumencode

ai ai-productivity analytics ccusage claude claude-code cli code-metrics developer-tools git-analysis productivity reporting usage-reports visualization weekly-report

Last synced: 2 days ago
JSON representation

AI 编码工具帮你写了多少代码？一条命令见分晓。支持 Claude Code · Codex · OpenCode 三大 AI 编码工具。How much code have AI coding tools written for you? One command will tell. Supports three major AI coding tools: Claude Code, Codex, and OpenCode.

• Host: GitHub
• URL: https://github.com/yaowen51888-rich/lumencode
• Owner: yaowen51888-rich
• Created: 2026-05-15T16:35:10.000Z (12 days ago)
• Default Branch: master
• Last Pushed: 2026-05-23T03:07:37.000Z (5 days ago)
• Last Synced: 2026-05-23T05:25:32.318Z (5 days ago)
• Topics: ai, ai-productivity, analytics, ccusage, claude, claude-code, cli, code-metrics, developer-tools, git-analysis, productivity, reporting, usage-reports, visualization, weekly-report
• Language: JavaScript
• Homepage:
• Size: 7 MB
• Stars: 3
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


  





  

  

  

  





  支持 Claude Code · Codex · OpenCode 三大 AI 编码工具 · 600+ 模型定价 · AI 贡献度归因 · 按项目独立汇报 · 自定义时间范围 · 一键飞书/钉钉周报





  English · 命令 · FAQ · 更新日志





  



---

## 它解决什么问题？

> 「AI 帮你写了多少代码？」「订阅这些工具值不值？」—— 与其手算，不如一条命令搞定。

| 场景 | 用 lumencode 解决 |

|------|----------------------|

| **写周报** | 选周报 → 点「工作汇报 → 复制」→ 粘贴飞书/钉钉。**3 秒搞定。** |

| **证明 AI ROI** | 「67% 提交有 AI 参与，AI 辅助新增 4,200 行，费用 $12.5」**有数据，有底气。** |

| **按项目汇报** | 配置多项目后，选择单个项目生成独立工作汇报，方便向不同项目负责人对齐 |

| **对齐 Sprint 周期** | 除日/周/月外，支持自定义起止日期，不再被固定周期限制 |

| **理解使用习惯** | 哪个项目用得最多？哪个模型最费 Token？什么时段是编码高峰？**一目了然。** |

| **追踪 AI 成本** | 内置 **600+ 模型定价**（含 GLM、Kimi、Qwen、DeepSeek 等），自动算出等效 API 花销 |

---

## 3 秒上手

```bash

# 全局安装

npm install -g lumencode

lumencode serve            # 启动 Web 服务，自动打开浏览器

# 或零安装直接使用

npx lumencode serve

```

**零配置启动** —— 自动检测 `~/.claude`、`~/.codex`、OpenCode 日志目录，从会话里推导项目路径。

---

## 产品亮点



  



| 亮点 | 说明 |

|------|------|

| 🌐 **三工具统一** | Claude Code / Codex / OpenCode 数据全自动汇总，左侧标签一键切换 |

| 🤖 **AI 贡献度量化** | 识别 `Co-Authored-By: Claude` 等签名，多层归因引擎量化 AI 在你代码中的实际占比 |

| 📝 **自然语言工作汇报** | 详报/简报一键生成，支持标准 Markdown / 飞书 / 钉钉三种格式，每个板块附诊断解读 |

| 📂 **按项目独立汇报** | 右侧面板选择项目，生成该项目的独立工作汇报（commits + AI 交互量 + 热点文件） |

| 📅 **自定义时间范围** | 除日/周/月外，支持选择任意起止日期，方便对齐 Sprint 周期 |

| 💰 **精确费用估算** | 600+ 模型本地定价（含 GLM/Kimi/Qwen/DeepSeek）+ Portkey API 兜底，未知模型不计费而非乱算 |

| 📦 **零配置开箱即用** | 首次运行自动检测工具目录、推导项目路径 |

| 🔍 **数据钻取** | 点击任意图表下钻明细，从汇总数据到具体会话/提交一气呵成 |

| 📈 **趋势与洞察** | 周报/月报附峰值日识别、连续活跃分析、工具使用五类分布（编辑/阅读/执行/规划/研究） |

| 🌙 **亮/暗主题** | 亮色/暗色主题一键切换，全图表自适配 |

---

## 产品截图

### 数据分析总览

> 左侧数据源面板一键切换工具，主区域汇总 Token 消耗、费用、模型分布、AI 贡献度归因。

  

    

    

  

  

    汇总指标 + Token 趋势

    项目分布 + 时段分布 + 会话列表

  

![AI 贡献度与提交分析](doc/数据分析页面3.png)

### 多工具维度

> 切换到「全部工具」视图，查看跨工具的汇总数据与对比分析。

![多工具维度](doc/多工具维度.png)

### 项目分布 & 会话记录

> 按项目统计 Token、费用、会话数，点击下钻查看单条会话明细。

![项目分布与会话记录](doc/项目分布-会话记录.png)

### 场景分析

> 按工作类型分类（编码 / 测试 / 调试 / 文档 / 审查 / 规划），附匹配关键词示例。

![场景分析](doc/工作类型分布_匹配示例.png)

### 工作汇报 · 一键生成可直接发布的周报

> 自然语言段落式汇报，覆盖 Token / 费用 / AI 贡献度 / 项目亮点 / 代码产出，每个板块附洞察解读。

- **详报** —— 完整数据 + 洞察解读 + 板块编号，适合周报、月报

- **简报** —— 3-5 句话核心摘要，适合日报或群消息

- **多平台格式** —— 标准 Markdown / 飞书 / 钉钉，一键切换

- **按项目生成** —— 右侧面板选择项目，生成该项目的独立汇报

  

    

    

  

  

    详报

    简报

  

### 亮色 / 暗色主题

> 全图表配色自适配，长时间阅读不伤眼。

![亮色模式](doc/浅色模式.png)

> 暗色模式为默认主题，上方截图均为暗色模式下的效果。

---

## 命令用法

```bash

lumencode <命令> [周期] [日期] [选项]

```

| 命令 | 说明 |

|------|------|

| `serve` | 启动 Web 服务（默认端口 4567） |

| `report` | 生成命令行报告（默认命令） |

| `init` | 初始化配置文件 |

| 周期 | 说明 |

|------|------|

| `daily` | 日报（默认） |

| `weekly` | 周报（自动计算所在周） |

| `monthly` | 月报（自动计算所在月） |

### 常用示例

```bash

# Web 模式（推荐）

lumencode serve

# 命令行日报

lumencode report daily

lumencode report daily 2026-05-15

# 周报 / 月报

lumencode report weekly

lumencode report monthly 2026-05-01

# 只统计指定项目

lumencode report daily --projects D:/fzwork,E:/play/idea

# 一键生成可发布的工作汇报

lumencode report daily --work          # 详报

lumencode report daily --work --brief  # 简报

lumencode report weekly --work

```

---

## 配置

v0.4.0 起支持 Claude Code、Codex、OpenCode 三种工具，**首次运行自动检测**已安装工具的日志目录与项目路径。

如需自定义，点击 Web 页面右上角设置按钮在线修改。

| 配置项 | 说明 |

|--------|------|

| Claude 日志目录 | Claude Code 数据目录（含 `projects/` 子目录），默认 `~/.claude` |

| Codex 日志目录 | Codex 数据目录（含 `sessions/` 子目录），默认自动检测 |

| OpenCode 日志目录 | OpenCode 数据目录，默认自动检测 |

| 启用工具 | 指定启用哪些工具，默认全部已检测到的工具 |

| 本地项目路径 | 关联的 Git 仓库路径，用于代码提交统计与 AI 贡献度归因 |

| 排除项目 | 不希望统计的项目名称 |

| 场景关键词 | 工作类型分类关键词 JSON |

### 模型定价数据

- **本地表**：内置 590 个来自 [Portkey-AI/models](https://github.com/Portkey-AI/models) 的厂商原命名定价

- **别名映射**：内置 28 条权威覆盖，把 `glm-5.1` / `kimi-for-coding` 等中转服务别名定向到正确定价

- **API 兜底**：未命中的新模型自动调用 Portkey 免费 API，成功结果缓存到 `data/pricing-cache.json`

- **失败降级**：API 不可用时该模型按 0 计费，不影响其他模型与报告生成

---

## 常见问题

| 问题 | 解决方案 |

|------|----------|

| 浏览器显示「暂无数据」 | 首次启动会引导配置；如已跳过，点击右上角设置按钮 |

| Windows 下日志目录不存在 | 默认路径为 `C:\Users\<用户名>\.claude`，确认该目录下有 `projects/` 子目录 |

| 端口 4567 被占用 | 设置环境变量：`set LUMENCODE_PORT=8080 && lumencode serve` |

| 找不到 Git 统计数据 | v0.2.0+ 已自动从会话 `cwd` 推导项目路径，仍未识别时可在设置中手动指定 |

| 费用显示 $0 | 该模型未在定价表中，可临时联网让 API 兜底，或在 `data/pricing.json` 的 `overrides` 中添加 `aliasOf` 别名 |

---

## 环境要求

- Node.js >= 18.0.0

- 已安装 Claude Code / Codex / OpenCode 中至少一个，并产生过会话日志

---

## 更新日志

### v1.0.0 (2026-05-24) — 项目级汇报 & 自定义时间

- **按项目独立汇报** — 工作汇报右侧面板新增项目选择器，选定后自动筛选该项目数据，生成独立工作汇报（commits + AI 交互量 + 热点文件）

- **自定义时间范围** — 新增「自定义」周期选项，支持选择任意起止日期，方便对齐 Sprint 周期

- **智能日期导航** — 左右箭头根据当前周期自动调整步长：日报 ±1天、周报 ±7天、月报 ±1个月

- **侧边栏重构** — 版本信息、主题切换、收起按钮统一移至底部，顶部仅保留标题与链接，布局更紧凑

- **界面重构** — 全新视觉设计，布局更紧凑美观，数据呈现更直观

### v0.4.0 (2026-05-22) — 多工具统一平台

从 Claude Code 单工具报告升级为 AI 编码全栈分析平台。

- **多工具支持** — 新增 OpenAI Codex CLI 和 OpenCode 解析器，三工具数据自动汇总

- **工具版本检测** — 自动读取各工具版本号显示在侧边栏

- **AI 归因引擎** — 多层置信度（显式签名 / Session 强关联 / 文件重叠），支持跨天提交匹配和按工具维度过滤

- **600+ 模型定价** — 集成 [Portkey-AI/models](https://github.com/Portkey-AI/models) 数据库，覆盖 OpenAI/Anthropic/Google/中国厂商；API 兜底未知模型；失败时不计费而非乱算

- **工作汇报洞察** — 每个板块新增一句话诊断性解读，不只是数据罗列

- **工具使用模式** — 工具调用从简单排行改为五类分布统计（编辑/阅读/执行/规划/研究）

- **时间趋势** — 周报/月报新增日维度活跃趋势分析（峰值日、连续活跃、趋势方向）

- **动态编号** — 汇报板块按实际数据动态编号，不再出现跳号

- **场景分类扩展** — 新增 Codex/OpenCode/Serena MCP 工具的场景映射

- **UI 优化** — AI 归因板块重设计、工具主题色（Claude 橙、Codex 绿、OpenCode 紫）、暗色模式细节修复

- **工作汇报修复** — 暗色模式切换不再误切回主报告页

### v0.3.0 (2026-05-19)

- 工作汇报新增飞书、钉钉格式支持，详报/简报两种输出模式

- 修复刷新布局跳动，优化 Markdown 渲染与暗色主题

- AI 贡献度置信度评分和文件级指标计算改进

### v0.2.0 (2026-05-17) — Git 深度分析

新增 AI 辅助提交检测、贡献度指标、Conventional Commit 解析、文件热点 Top 10、Session ↔ Commit 关联、零配置启动。

### v0.1.0 (2026-05-17)

首个正式发布版本。

---

## 支持项目

如果这个工具帮到你，不妨：

- **给个 Star** —— 让更多人看到这个工具

- **提 Issue** —— 报告 Bug 或建议新功能

- **提 PR** —— 欢迎贡献模型定价、场景关键词、工具适配

---

## 许可证

[MIT](LICENSE) © [zhangyaowen](https://github.com/yaowen51888-rich)