{"id":50098006,"url":"https://github.com/yaowen51888-rich/lumencode","last_synced_at":"2026-05-26T01:03:58.585Z","repository":{"id":358096360,"uuid":"1239979370","full_name":"yaowen51888-rich/lumencode","owner":"yaowen51888-rich","description":"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.","archived":false,"fork":false,"pushed_at":"2026-05-23T03:07:37.000Z","size":7341,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-23T05:25:32.318Z","etag":null,"topics":["ai","ai-productivity","analytics","ccusage","claude","claude-code","cli","code-metrics","developer-tools","git-analysis","productivity","reporting","usage-reports","visualization","weekly-report"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yaowen51888-rich.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T16:35:10.000Z","updated_at":"2026-05-23T03:07:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yaowen51888-rich/lumencode","commit_stats":null,"previous_names":["yaowen51888-rich/ccusage-report","yaowen51888-rich/lumencode"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/yaowen51888-rich/lumencode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaowen51888-rich%2Flumencode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaowen51888-rich%2Flumencode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaowen51888-rich%2Flumencode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaowen51888-rich%2Flumencode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yaowen51888-rich","download_url":"https://codeload.github.com/yaowen51888-rich/lumencode/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yaowen51888-rich%2Flumencode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33499282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T14:31:05.219Z","status":"ssl_error","status_checked_at":"2026-05-25T14:31:02.878Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-productivity","analytics","ccusage","claude","claude-code","cli","code-metrics","developer-tools","git-analysis","productivity","reporting","usage-reports","visualization","weekly-report"],"created_at":"2026-05-23T05:16:08.499Z","updated_at":"2026-05-26T01:03:58.571Z","avatar_url":"https://github.com/yaowen51888-rich.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"doc/logo.png\" alt=\"LumenCode\" width=\"520\"\u003e\n\u003c/div\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/lumencode\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/lumencode.svg?style=flat-square\u0026color=cb3837\" alt=\"npm version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/lumencode\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/lumencode.svg?style=flat-square\u0026color=cb3837\" alt=\"npm downloads\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/npm/l/lumencode.svg?style=flat-square\u0026color=blue\" alt=\"license\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://nodejs.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square\" alt=\"Node.js\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  支持 \u003cb\u003eClaude Code · Codex · OpenCode\u003c/b\u003e 三大 AI 编码工具 · 600+ 模型定价 · AI 贡献度归因 · 按项目独立汇报 · 自定义时间范围 · 一键飞书/钉钉周报\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README_EN.md\"\u003eEnglish\u003c/a\u003e · \u003ca href=\"#命令用法\"\u003e命令\u003c/a\u003e · \u003ca href=\"#常见问题\"\u003eFAQ\u003c/a\u003e · \u003ca href=\"#更新日志\"\u003e更新日志\u003c/a\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"doc/数据分析页面.png\" alt=\"LumenCode Dashboard\" width=\"800\"\u003e\n\u003c/div\u003e\n\n---\n\n\n## 它解决什么问题？\n\n\u003e 「AI 帮你写了多少代码？」「订阅这些工具值不值？」—— 与其手算，不如一条命令搞定。\n\n| 场景 | 用 lumencode 解决 |\n|------|----------------------|\n| **写周报** | 选周报 → 点「工作汇报 → 复制」→ 粘贴飞书/钉钉。**3 秒搞定。** |\n| **证明 AI ROI** | 「67% 提交有 AI 参与，AI 辅助新增 4,200 行，费用 $12.5」**有数据，有底气。** |\n| **按项目汇报** | 配置多项目后，选择单个项目生成独立工作汇报，方便向不同项目负责人对齐 |\n| **对齐 Sprint 周期** | 除日/周/月外，支持自定义起止日期，不再被固定周期限制 |\n| **理解使用习惯** | 哪个项目用得最多？哪个模型最费 Token？什么时段是编码高峰？**一目了然。** |\n| **追踪 AI 成本** | 内置 **600+ 模型定价**（含 GLM、Kimi、Qwen、DeepSeek 等），自动算出等效 API 花销 |\n\n---\n\n## 3 秒上手\n\n```bash\n# 全局安装\nnpm install -g lumencode\nlumencode serve            # 启动 Web 服务，自动打开浏览器\n\n# 或零安装直接使用\nnpx lumencode serve\n```\n\n**零配置启动** —— 自动检测 `~/.claude`、`~/.codex`、OpenCode 日志目录，从会话里推导项目路径。\n\n---\n\n## 产品亮点\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"doc/核心能力.png\" alt=\"LumenCode 核心能力\" width=\"720\"\u003e\n\u003c/div\u003e\n\n\n| 亮点 | 说明 |\n|------|------|\n| 🌐 **三工具统一** | Claude Code / Codex / OpenCode 数据全自动汇总，左侧标签一键切换 |\n| 🤖 **AI 贡献度量化** | 识别 `Co-Authored-By: Claude` 等签名，多层归因引擎量化 AI 在你代码中的实际占比 |\n| 📝 **自然语言工作汇报** | 详报/简报一键生成，支持标准 Markdown / 飞书 / 钉钉三种格式，每个板块附诊断解读 |\n| 📂 **按项目独立汇报** | 右侧面板选择项目，生成该项目的独立工作汇报（commits + AI 交互量 + 热点文件） |\n| 📅 **自定义时间范围** | 除日/周/月外，支持选择任意起止日期，方便对齐 Sprint 周期 |\n| 💰 **精确费用估算** | 600+ 模型本地定价（含 GLM/Kimi/Qwen/DeepSeek）+ Portkey API 兜底，未知模型不计费而非乱算 |\n| 📦 **零配置开箱即用** | 首次运行自动检测工具目录、推导项目路径 |\n| 🔍 **数据钻取** | 点击任意图表下钻明细，从汇总数据到具体会话/提交一气呵成 |\n| 📈 **趋势与洞察** | 周报/月报附峰值日识别、连续活跃分析、工具使用五类分布（编辑/阅读/执行/规划/研究） |\n| 🌙 **亮/暗主题** | 亮色/暗色主题一键切换，全图表自适配 |\n\n---\n\n## 产品截图\n\n### 数据分析总览\n\n\u003e 左侧数据源面板一键切换工具，主区域汇总 Token 消耗、费用、模型分布、AI 贡献度归因。\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"doc/数据分析页面.png\" alt=\"汇总面板与趋势图\" width=\"400\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"doc/数据分析页面2.png\" alt=\"项目分布与时段分布\" width=\"400\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e汇总指标 + Token 趋势\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e项目分布 + 时段分布 + 会话列表\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n![AI 贡献度与提交分析](doc/数据分析页面3.png)\n\n### 多工具维度\n\n\u003e 切换到「全部工具」视图，查看跨工具的汇总数据与对比分析。\n\n![多工具维度](doc/多工具维度.png)\n\n### 项目分布 \u0026 会话记录\n\n\u003e 按项目统计 Token、费用、会话数，点击下钻查看单条会话明细。\n\n![项目分布与会话记录](doc/项目分布-会话记录.png)\n\n### 场景分析\n\n\u003e 按工作类型分类（编码 / 测试 / 调试 / 文档 / 审查 / 规划），附匹配关键词示例。\n\n![场景分析](doc/工作类型分布_匹配示例.png)\n\n### 工作汇报 · 一键生成可直接发布的周报\n\n\u003e 自然语言段落式汇报，覆盖 Token / 费用 / AI 贡献度 / 项目亮点 / 代码产出，每个板块附洞察解读。\n\n- **详报** —— 完整数据 + 洞察解读 + 板块编号，适合周报、月报\n- **简报** —— 3-5 句话核心摘要，适合日报或群消息\n- **多平台格式** —— 标准 Markdown / 飞书 / 钉钉，一键切换\n- **按项目生成** —— 右侧面板选择项目，生成该项目的独立汇报\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"doc/工作汇报_详报.png\" alt=\"工作汇报-详报\" width=\"400\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"doc/工作汇报_简报.png\" alt=\"工作汇报-简报\" width=\"400\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003e详报\u003c/b\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003e简报\u003c/b\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### 亮色 / 暗色主题\n\n\u003e 全图表配色自适配，长时间阅读不伤眼。\n\n![亮色模式](doc/浅色模式.png)\n\n\u003e 暗色模式为默认主题，上方截图均为暗色模式下的效果。\n\n---\n\n## 命令用法\n\n```bash\nlumencode \u003c命令\u003e [周期] [日期] [选项]\n```\n\n| 命令 | 说明 |\n|------|------|\n| `serve` | 启动 Web 服务（默认端口 4567） |\n| `report` | 生成命令行报告（默认命令） |\n| `init` | 初始化配置文件 |\n\n| 周期 | 说明 |\n|------|------|\n| `daily` | 日报（默认） |\n| `weekly` | 周报（自动计算所在周） |\n| `monthly` | 月报（自动计算所在月） |\n\n### 常用示例\n\n```bash\n# Web 模式（推荐）\nlumencode serve\n\n# 命令行日报\nlumencode report daily\nlumencode report daily 2026-05-15\n\n# 周报 / 月报\nlumencode report weekly\nlumencode report monthly 2026-05-01\n\n# 只统计指定项目\nlumencode report daily --projects D:/fzwork,E:/play/idea\n\n# 一键生成可发布的工作汇报\nlumencode report daily --work          # 详报\nlumencode report daily --work --brief  # 简报\nlumencode report weekly --work\n```\n\n---\n\n## 配置\n\nv0.4.0 起支持 Claude Code、Codex、OpenCode 三种工具，**首次运行自动检测**已安装工具的日志目录与项目路径。\n\n如需自定义，点击 Web 页面右上角设置按钮在线修改。\n\n| 配置项 | 说明 |\n|--------|------|\n| Claude 日志目录 | Claude Code 数据目录（含 `projects/` 子目录），默认 `~/.claude` |\n| Codex 日志目录 | Codex 数据目录（含 `sessions/` 子目录），默认自动检测 |\n| OpenCode 日志目录 | OpenCode 数据目录，默认自动检测 |\n| 启用工具 | 指定启用哪些工具，默认全部已检测到的工具 |\n| 本地项目路径 | 关联的 Git 仓库路径，用于代码提交统计与 AI 贡献度归因 |\n| 排除项目 | 不希望统计的项目名称 |\n| 场景关键词 | 工作类型分类关键词 JSON |\n\n### 模型定价数据\n\n- **本地表**：内置 590 个来自 [Portkey-AI/models](https://github.com/Portkey-AI/models) 的厂商原命名定价\n- **别名映射**：内置 28 条权威覆盖，把 `glm-5.1` / `kimi-for-coding` 等中转服务别名定向到正确定价\n- **API 兜底**：未命中的新模型自动调用 Portkey 免费 API，成功结果缓存到 `data/pricing-cache.json`\n- **失败降级**：API 不可用时该模型按 0 计费，不影响其他模型与报告生成\n\n---\n\n## 常见问题\n\n| 问题 | 解决方案 |\n|------|----------|\n| 浏览器显示「暂无数据」 | 首次启动会引导配置；如已跳过，点击右上角设置按钮 |\n| Windows 下日志目录不存在 | 默认路径为 `C:\\Users\\\u003c用户名\u003e\\.claude`，确认该目录下有 `projects/` 子目录 |\n| 端口 4567 被占用 | 设置环境变量：`set LUMENCODE_PORT=8080 \u0026\u0026 lumencode serve` |\n| 找不到 Git 统计数据 | v0.2.0+ 已自动从会话 `cwd` 推导项目路径，仍未识别时可在设置中手动指定 |\n| 费用显示 $0 | 该模型未在定价表中，可临时联网让 API 兜底，或在 `data/pricing.json` 的 `overrides` 中添加 `aliasOf` 别名 |\n\n---\n\n## 环境要求\n\n- Node.js \u003e= 18.0.0\n- 已安装 Claude Code / Codex / OpenCode 中至少一个，并产生过会话日志\n\n---\n\n## 更新日志\n\n### v1.0.0 (2026-05-24) — 项目级汇报 \u0026 自定义时间\n\n- **按项目独立汇报** — 工作汇报右侧面板新增项目选择器，选定后自动筛选该项目数据，生成独立工作汇报（commits + AI 交互量 + 热点文件）\n- **自定义时间范围** — 新增「自定义」周期选项，支持选择任意起止日期，方便对齐 Sprint 周期\n- **智能日期导航** — 左右箭头根据当前周期自动调整步长：日报 ±1天、周报 ±7天、月报 ±1个月\n- **侧边栏重构** — 版本信息、主题切换、收起按钮统一移至底部，顶部仅保留标题与链接，布局更紧凑\n- **界面重构** — 全新视觉设计，布局更紧凑美观，数据呈现更直观\n\n### v0.4.0 (2026-05-22) — 多工具统一平台\n\n从 Claude Code 单工具报告升级为 AI 编码全栈分析平台。\n\n- **多工具支持** — 新增 OpenAI Codex CLI 和 OpenCode 解析器，三工具数据自动汇总\n- **工具版本检测** — 自动读取各工具版本号显示在侧边栏\n- **AI 归因引擎** — 多层置信度（显式签名 / Session 强关联 / 文件重叠），支持跨天提交匹配和按工具维度过滤\n- **600+ 模型定价** — 集成 [Portkey-AI/models](https://github.com/Portkey-AI/models) 数据库，覆盖 OpenAI/Anthropic/Google/中国厂商；API 兜底未知模型；失败时不计费而非乱算\n- **工作汇报洞察** — 每个板块新增一句话诊断性解读，不只是数据罗列\n- **工具使用模式** — 工具调用从简单排行改为五类分布统计（编辑/阅读/执行/规划/研究）\n- **时间趋势** — 周报/月报新增日维度活跃趋势分析（峰值日、连续活跃、趋势方向）\n- **动态编号** — 汇报板块按实际数据动态编号，不再出现跳号\n- **场景分类扩展** — 新增 Codex/OpenCode/Serena MCP 工具的场景映射\n- **UI 优化** — AI 归因板块重设计、工具主题色（Claude 橙、Codex 绿、OpenCode 紫）、暗色模式细节修复\n- **工作汇报修复** — 暗色模式切换不再误切回主报告页\n\n### v0.3.0 (2026-05-19)\n\n- 工作汇报新增飞书、钉钉格式支持，详报/简报两种输出模式\n- 修复刷新布局跳动，优化 Markdown 渲染与暗色主题\n- AI 贡献度置信度评分和文件级指标计算改进\n\n### v0.2.0 (2026-05-17) — Git 深度分析\n\n新增 AI 辅助提交检测、贡献度指标、Conventional Commit 解析、文件热点 Top 10、Session ↔ Commit 关联、零配置启动。\n\n### v0.1.0 (2026-05-17)\n\n首个正式发布版本。\n\n---\n\n## 支持项目\n\n如果这个工具帮到你，不妨：\n\n- **给个 Star** —— 让更多人看到这个工具\n- **提 Issue** —— 报告 Bug 或建议新功能\n- **提 PR** —— 欢迎贡献模型定价、场景关键词、工具适配\n\n---\n\n## 许可证\n\n[MIT](LICENSE) © [zhangyaowen](https://github.com/yaowen51888-rich)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyaowen51888-rich%2Flumencode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyaowen51888-rich%2Flumencode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyaowen51888-rich%2Flumencode/lists"}