lumencode 1.3.0 → 1.3.1

package/README.md

@@ -11,7 +11,7 @@
 </p>
 
 <p align="center">
-  支持 <b>Claude Code · Codex · OpenCode</b> 三大 AI 编码工具 · 600+ 模型定价 · AI 贡献度归因 · 按项目独立汇报 · 自定义时间范围 · 一键飞书/钉钉周报
+  <b>AI 编码助手使用分析</b> —— 精确到每一行代码的 AI 归因 · 三工具统一 · 智能周报生成
 </p>
 
 <p align="center">
@@ -30,12 +30,12 @@
 
 | 场景 | 用 lumencode 解决 |
 |------|----------------------|
-| **写周报** | 选周报 → 点「工作汇报 → 复制」→ 粘贴飞书/钉钉。**3 秒搞定。** |
-| **证明 AI ROI** | 「67% 提交有 AI 参与，AI 辅助新增 4,200 行，费用 $12.5」**有数据，有底气。** |
-| **按项目汇报** | 配置多项目后，选择单个项目生成独立工作汇报，方便向不同项目负责人对齐 |
-| **对齐 Sprint 周期** | 除日/周/月外，支持自定义起止日期，不再被固定周期限制 |
-| **理解使用习惯** | 哪个项目用得最多？哪个模型最费 Token？什么时段是编码高峰？**一目了然。** |
-| **追踪 AI 成本** | 内置 **600+ 模型定价**（含 GLM、Kimi、Qwen、DeepSeek 等），自动算出等效 API 花销 |
+| **精确量化 AI 贡献** | 不是模糊的"大概写了不少"，而是精确到「4,200 行代码中 3,180 行由 AI 辅助完成」。**每一行都有数可查。** |
+| **证明 AI ROI** | 周报自动生成：「本周 AI 辅助 12 个提交，节省约 8 小时编码时间，Token 花费 $18.5」。**老板一看就懂。** |
+| **写周报/月报** | 选周期 → 点「工作汇报 → 复制」→ 粘贴飞书/钉钉。**3 秒搞定。** |
+| **按项目汇报** | 多项目并行时，选择单个项目生成独立汇报，方便向不同项目负责人对齐 |
+| **对齐 Sprint 周期** | 支持自定义起止日期，不再被日/周/月固定周期限制 |
+| **追踪 AI 成本** | 600+ 模型内置定价（含 GLM、Kimi、Qwen、DeepSeek），自动算出等效 API 花销 |
 
 ---
 
@@ -63,8 +63,8 @@ npx lumencode serve
 
 | 亮点 | 说明 |
 |------|------|
+| 🎯 **行级 AI 归因** | 通过 hook 步骤追踪，精确识别每一行代码的 AI 参与度。不是"这个提交 AI 帮忙了"，而是"这行代码是 AI 写的" |
 | 🌐 **三工具统一** | Claude Code / Codex / OpenCode 数据全自动汇总，左侧标签一键切换 |
-| 🤖 **AI 贡献度量化** | 识别 `Co-Authored-By: Claude` 等签名，多层归因引擎量化 AI 在你代码中的实际占比 |
 | 📝 **自然语言工作汇报** | 详报/简报一键生成，支持标准 Markdown / 飞书 / 钉钉三种格式，每个板块附诊断解读 |
 | 📂 **按项目独立汇报** | 右侧面板选择项目，生成该项目的独立工作汇报（commits + AI 交互量 + 热点文件） |
 | 📅 **自定义时间范围** | 除日/周/月外，支持选择任意起止日期，方便对齐 Sprint 周期 |

package/lib/server.js

@@ -7,7 +7,7 @@ import { generateWorkReport, generateFeishuCard } from './report.js';
 import { collectAllRecords, filterRecordsByPeriod, groupBySessions, computeUsageStats, computeTrendData, computePrevPeriodRange } from './aggregate.js';
 import { normalizeProjectPath } from './aggregate.js';
 import { invalidateFileCache } from './cache.js';
-import { invalidateGitCache, getGitStatsForMultipleReposAsync, finalizeGitStats } from './git.js';
+import { invalidateGitCache, getGitStatsForMultipleReposAsync, finalizeGitStats, computeAIContribution, computeCommitTypes, computeFileHotspots } from './git.js';
 import { identifyBillingBlocks } from './blocks.js';
 import { detectAvailableTools, parseAllEnabledTools } from './parsers/index.js';
 import { isAssistantRecord, getInputTokens, getOutputTokens } from './record-utils.js';
@@ -89,9 +89,9 @@ export function startServer(config, effectiveIncludeProjects, buildReportData, c
   const REPORT_CACHE_TTL = 30_000; // 30s
   const REPORT_CACHE_MAX_SIZE = 50;
 
-  function getReportCacheKey(period, date, tool, customStart, customEnd, format) {
-    return `${period}|${date}|${tool || 'all'}|${customStart || ''}|${customEnd || ''}|${format || 'json'}`;
-  }
+  function getReportCacheKey(period, date, tool, customStart, customEnd) {
+    return `${period}|${date}|${tool || 'all'}|${customStart || ''}|${customEnd || ''}`;
+  }
 
   function getCachedReport(cacheKey) {
     const cached = _reportCache.get(cacheKey);
@@ -166,20 +166,80 @@ export function startServer(config, effectiveIncludeProjects, buildReportData, c
     return null;
   }
 
-  async function getOrParse(config, includeProjects) {
-    const cached = getCachedParse(config, includeProjects);
-    if (cached) return cached;
-    const result = await parseAllEnabledTools(config, {
-      excludeProjects: config.excludeProjects,
+  async function getOrParse(config, includeProjects) {
+    const cached = getCachedParse(config, includeProjects);
+    if (cached) return cached;
+    const result = await parseAllEnabledTools(config, {
+      excludeProjects: config.excludeProjects,
       includeProjects,
     });
     _parsedCache = result;
     _parsedCacheKey = `${config.claudeDir}|${includeProjects?.join(',') || ''}`;
-    _parsedCacheExpire = Date.now() + PARSED_CACHE_TTL;
-    return result;
-  }
-
-  const server = createServer(async (req, res) => {
+    _parsedCacheExpire = Date.now() + PARSED_CACHE_TTL;
+    return result;
+  }
+
+  function deriveProjectGitStats(gitStats, project, start, end, attributionOptions) {
+    if (!gitStats?.commitList?.length || !project) return null;
+    const windowEnd = end + 'T23:59:59';
+    const commitList = gitStats.commitList.filter(c => {
+      return getProjectBaseName(c.repo) === project && (c.date || '') >= start && (c.date || '') <= windowEnd;
+    });
+    if (commitList.length === 0) return null;
+
+    return {
+      commits: commitList.length,
+      filesChanged: new Set(commitList.flatMap(c => (c.files || []).map(f => f.path))).size,
+      linesAdded: commitList.reduce((s, c) => s + (c.linesAdded || 0), 0),
+      linesDeleted: commitList.reduce((s, c) => s + (c.linesDeleted || 0), 0),
+      commitList,
+      commitTypes: computeCommitTypes(commitList),
+      fileHotspots: computeFileHotspots(commitList, 10),
+      aiContribution: computeAIContribution(commitList, null, attributionOptions),
+      attributionSummary: gitStats.attributionSummary,
+    };
+  }
+
+  function prepareJsonReportData(baseData, tool) {
+    const data = { ...baseData };
+
+    if (tool !== 'all' && data.gitStats?.aiContributionByTool) {
+      const toolAi = data.gitStats.aiContributionByTool[tool];
+      if (toolAi) {
+        data.gitStats = { ...data.gitStats, aiContribution: toolAi };
+      }
+    }
+
+    if (data.usageStats?.models) {
+      const modelEntries = Object.entries(data.usageStats.models)
+        .sort((a, b) => b[1].cost - a[1].cost);
+      const totalCost = modelEntries.reduce((s, [, d]) => s + (d.cost || 0), 0);
+      const cacheRead = data.usageStats.cacheRead || 0;
+      const cacheCreate = data.usageStats.cacheCreate || 0;
+      let cacheSaving = 0;
+      if (totalCost > 0 && (cacheRead + cacheCreate) > 0) {
+        const totalInput = data.usageStats.inputTokens || 1;
+        const avgInputCostPerToken = totalCost / (totalInput + data.usageStats.outputTokens + cacheRead + cacheCreate || 1);
+        cacheSaving = Math.round(cacheRead * avgInputCostPerToken * 0.9 * 100) / 100;
+      }
+      data.costBreakdown = {
+        models: modelEntries.map(([name, d]) => ({
+          name,
+          cost: d.cost || 0,
+          mode: d.costMode || 'unknown',
+          requests: d.count,
+          inputTokens: d.inputTokens,
+          outputTokens: d.outputTokens,
+        })),
+        cacheSaving,
+        total: Math.round(totalCost * 100) / 100,
+      };
+    }
+
+    return data;
+  }
+
+  const server = createServer(async (req, res) => {
     const url = new URL(req.url, `http://localhost:${PORT}`);
 
     // 安全响应头
@@ -312,21 +372,26 @@ export function startServer(config, effectiveIncludeProjects, buildReportData, c
 
       try {
         // 查询结果缓存：相同条件直接返回缓存
-        const reportCacheKey = getReportCacheKey(period, date, tool, customStart, customEnd, format);
-        let data = getCachedReport(reportCacheKey);
-        if (data) {
-          res.writeHead(200, {
-            'Content-Type': 'application/json',
-            'Access-Control-Allow-Origin': 'http://localhost:' + PORT,
-            'X-Cache': 'HIT',
-          });
-          res.end(JSON.stringify(data));
-          return;
-        }
-
-        const parsed = await getOrParse(config, includeProjects);
-        data = await buildReportData(period, date, config, includeProjects, tool, parsed, { customStart, customEnd });
-        if (!data) {
+        const reportCacheKey = getReportCacheKey(period, date, tool, customStart, customEnd);
+        let data = getCachedReport(reportCacheKey);
+        if (data && format !== 'work') {
+          const responseData = prepareJsonReportData(data, tool);
+          res.writeHead(200, {
+            'Content-Type': 'application/json',
+            'Access-Control-Allow-Origin': 'http://localhost:' + PORT,
+            'X-Cache': 'HIT',
+          });
+          res.end(JSON.stringify(responseData));
+          return;
+        }
+
+        let parsed = null;
+        if (!data) {
+          parsed = await getOrParse(config, includeProjects);
+          data = await buildReportData(period, date, config, includeProjects, tool, parsed, { customStart, customEnd });
+          if (data) setCachedReport(reportCacheKey, data);
+        }
+        if (!data) {
           res.writeHead(200, { 'Content-Type': 'application/json' });
           res.end(JSON.stringify({
             error: '未找到数据',
@@ -352,10 +417,11 @@ export function startServer(config, effectiveIncludeProjects, buildReportData, c
           let projUsageStats = data.usageStats;
           let projGitStats = data.gitStats;
           let projPrevStats = data.prevStats;
-          let projectName = '';
-
-          if (project) {
-            const { records: allRecords } = parsed;
+          let projectName = '';
+
+          if (project) {
+            if (!parsed) parsed = await getOrParse(config, includeProjects);
+            const { records: allRecords } = parsed;
             const toolRecords = tool !== 'all' ? allRecords.filter(r => r.tool === tool) : allRecords;
             // basename 匹配
             const projRecords = toolRecords.filter(r => {
@@ -375,25 +441,8 @@ export function startServer(config, effectiveIncludeProjects, buildReportData, c
             projPrevStats = prevProjFiltered.length > 0 ? computeUsageStats(prevProjFiltered, config.scenarioKeywords, config.costMode) : null;
 
             // 单项目 Git 统计
-            if (config.repos?.length > 0) {
-              const matchedRepo = config.repos.find(r => getProjectBaseName(r) === project);
-              if (matchedRepo) {
-                try {
-                  const { getGitStatsAsync } = await import('./git.js');
-                  const sessions = groupBySessions(projFiltered);
-                  const { finalizeGitStats, getGitStatsForMultipleReposAsync } = await import('./git.js');
-                  let repoGit = await getGitStatsForMultipleReposAsync([matchedRepo], pStart, pEnd + 'T23:59:59');
-                  repoGit = await finalizeGitStats(repoGit, sessions, {
-                    attribution: config.aiAttribution,
-                    stepTracking: config.stepTracking,
-                  });
-                  projGitStats = repoGit;
-                } catch (e) { console.warn("[server] error", e.message); }
-              }
-            } else {
-              projGitStats = null;
-            }
-          }
+            projGitStats = deriveProjectGitStats(data.gitStats, project, pStart, pEnd, config.aiAttribution);
+          }
 
           const markdown = generateWorkReport(projUsageStats, projGitStats, period, data.start, data.end, projPrevStats, { level, platform, tool, projectName });
           res.writeHead(200, {
@@ -404,52 +453,14 @@ export function startServer(config, effectiveIncludeProjects, buildReportData, c
           return;
         }
 
-        // 按工具替换 aiContribution
-        if (tool !== 'all' && data.gitStats?.aiContributionByTool) {
-          const toolAi = data.gitStats.aiContributionByTool[tool];
-          if (toolAi) {
-            data.gitStats.aiContribution = toolAi;
-          }
-        }
+        const responseData = prepareJsonReportData(data, tool);
 
-        // 添加费用分解
-        if (data.usageStats?.models) {
-          const modelEntries = Object.entries(data.usageStats.models)
-            .sort((a, b) => b[1].cost - a[1].cost);
-          const totalCost = modelEntries.reduce((s, [, d]) => s + (d.cost || 0), 0);
-          // 缓存节省 = (inputTokens - cacheRead) * avgInputRate - 已通过 cacheRead 低价体现
-          // 简化：缓存节省 = cacheRead * avgInputRate * (1 - cacheReadRate/inputRate)
-          const cacheRead = data.usageStats.cacheRead || 0;
-          const cacheCreate = data.usageStats.cacheCreate || 0;
-          let cacheSaving = 0;
-          if (totalCost > 0 && (cacheRead + cacheCreate) > 0) {
-            const totalInput = data.usageStats.inputTokens || 1;
-            const avgInputCostPerToken = totalCost / (totalInput + data.usageStats.outputTokens + cacheRead + cacheCreate || 1);
-            cacheSaving = Math.round(cacheRead * avgInputCostPerToken * 0.9 * 100) / 100;
-          }
-          data.costBreakdown = {
-            models: modelEntries.map(([name, d]) => ({
-              name,
-              cost: d.cost || 0,
-              mode: d.costMode || 'unknown',
-              requests: d.count,
-              inputTokens: d.inputTokens,
-              outputTokens: d.outputTokens,
-            })),
-            cacheSaving,
-            total: Math.round(totalCost * 100) / 100,
-          };
-        }
-
-        // 写入查询结果缓存
-        setCachedReport(reportCacheKey, data);
-
-        res.writeHead(200, {
+        res.writeHead(200, {
           'Content-Type': 'application/json',
           'Access-Control-Allow-Origin': 'http://localhost:' + PORT,
           'X-Cache': 'MISS',
         });
-        res.end(JSON.stringify(data));
+        res.end(JSON.stringify(responseData));
       } catch (err) {
         res.writeHead(500, { 'Content-Type': 'application/json' });
         console.error('API error:', err.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumencode",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "LumenCode — AI 编码助手使用报告工具，从 JSONL 日志和 Git 仓库提取 AI 贡献度、效率与使用指标，支持 Web 可视化和命令行两种模式",
   "type": "module",
   "bin": {