lumencode 1.3.1 → 1.3.3

package/lib/aggregate.js

@@ -238,6 +238,8 @@ export function computeUsageStats(records, scenarioKeywords, costMode = 'auto')
     projects: {},
     dailyStats: {},
     toolBreakdown: {}, // 新增：各工具数据分布
+    skills: {},
+    mcpTools: {},
   };
 
   for (const r of records) {
@@ -308,10 +310,51 @@ export function computeUsageStats(records, scenarioKeywords, costMode = 'auto')
       }
     }
 
-    // Tools (toolCalls) - 保持现有逻辑
+    // Tools (toolCalls) - calls: 总调用次数, uses: 使用次数（同一 record 内同名工具只算一次）
     const toolCalls = r.metadata?.toolCalls || r.toolCalls || [];
     for (const tc of toolCalls) {
-      stats.tools[tc.name] = (stats.tools[tc.name] || 0) + 1;
+      if (!stats.tools[tc.name]) stats.tools[tc.name] = { calls: 0, uses: 0 };
+      stats.tools[tc.name].calls++;
+      if (projectName && stats.projects[projectName]) {
+        if (!stats.projects[projectName].tools) stats.projects[projectName].tools = {};
+        if (!stats.projects[projectName].tools[tc.name]) stats.projects[projectName].tools[tc.name] = { calls: 0, uses: 0 };
+        stats.projects[projectName].tools[tc.name].calls++;
+      }
+      // Skill 细分采集
+      if (tc.name === 'Skill' && tc.input?.skill) {
+        const sk = tc.input.skill;
+        if (!stats.skills[sk]) stats.skills[sk] = { calls: 0, uses: 0 };
+        stats.skills[sk].calls++;
+      }
+      // MCP 细分采集
+      if (tc.name.startsWith('mcp__')) {
+        if (!stats.mcpTools[tc.name]) stats.mcpTools[tc.name] = { calls: 0, uses: 0 };
+        stats.mcpTools[tc.name].calls++;
+      }
+    }
+    const uniqueToolNames = new Set(toolCalls.map(tc => tc.name));
+    for (const name of uniqueToolNames) {
+      if (!stats.tools[name]) stats.tools[name] = { calls: 0, uses: 0 };
+      stats.tools[name].uses++;
+      if (projectName && stats.projects[projectName] && stats.projects[projectName].tools[name]) {
+        stats.projects[projectName].tools[name].uses++;
+      }
+      // 同步更新 skills / mcpTools 的 uses
+      if (name === 'Skill') {
+        const skillNames = new Set(
+          toolCalls
+            .filter(tc => tc.name === 'Skill' && tc.input?.skill)
+            .map(tc => tc.input.skill)
+        );
+        for (const sk of skillNames) {
+          if (!stats.skills[sk]) stats.skills[sk] = { calls: 0, uses: 0 };
+          stats.skills[sk].uses++;
+        }
+      }
+      if (name.startsWith('mcp__')) {
+        if (!stats.mcpTools[name]) stats.mcpTools[name] = { calls: 0, uses: 0 };
+        stats.mcpTools[name].uses++;
+      }
     }
 
     // Daily stats
@@ -406,6 +449,7 @@ export function computeUsageStats(records, scenarioKeywords, costMode = 'auto')
       cacheCreate: p.cacheCreate || 0,
       estimatedCost: p.estimatedCost || 0,
       models: p.models || {},
+      tools: p.tools || {},
     };
   }
 
@@ -488,12 +532,23 @@ export function computeTrendData(allRecords, period, refDate) {
     if (!r.timestamp) continue;
     const date = r.timestamp.slice(0, 10);
     if (date < trendStart || date > trendEnd) continue;
-    if (!dailyStats[date]) dailyStats[date] = { requests: 0, inputTokens: 0, outputTokens: 0 };
+    if (!dailyStats[date]) dailyStats[date] = { requests: 0, inputTokens: 0, outputTokens: 0, tools: {} };
     if (isAssistantRecord(r)) {
       dailyStats[date].requests++;
       dailyStats[date].inputTokens += getInputTokens(r);
       dailyStats[date].outputTokens += getOutputTokens(r);
     }
+    const toolCalls = r.metadata?.toolCalls || r.toolCalls || [];
+    for (const tc of toolCalls) {
+      if (tc.name === 'Skill' || tc.name?.startsWith('mcp__')) continue;
+      if (!dailyStats[date].tools[tc.name]) dailyStats[date].tools[tc.name] = { calls: 0, uses: 0 };
+      dailyStats[date].tools[tc.name].calls++;
+    }
+    const uniqueNames = new Set(toolCalls.map(tc => tc.name).filter(n => n !== 'Skill' && !n?.startsWith('mcp__')));
+    for (const name of uniqueNames) {
+      if (!dailyStats[date].tools[name]) dailyStats[date].tools[name] = { calls: 0, uses: 0 };
+      dailyStats[date].tools[name].uses++;
+    }
   }
 
   return { dailyStats, start: trendStart, end: trendEnd };

package/lib/attribution.js

@@ -99,6 +99,8 @@ export function aggregateAttribution(items = []) {
     unknown: 0,
     human: 0,
     excluded: 0,
+    mergeCommits: 0,
+    mergeCommitLines: 0,
     confirmedAILines: 0,
     probableAILines: 0,
     possibleAILines: 0,
@@ -112,6 +114,12 @@ export function aggregateAttribution(items = []) {
 
   for (const item of items || []) {
     const classified = item?.classification ? item : classifyAttribution(item);
+    // 合并提交不计入统计，避免稀释 AI 占比
+    if (item?.reason === 'human_merge') {
+      summary.mergeCommits = (summary.mergeCommits || 0) + 1;
+      summary.mergeCommitLines = (summary.mergeCommitLines || 0) + (item?.added || item?.linesAdded || 0) + (item?.deleted || item?.linesDeleted || 0);
+      continue;
+    }
     const lines = (item?.added || item?.linesAdded || 0) + (item?.deleted || item?.linesDeleted || 0);
     summary.totalItems++;
     summary.totalLinesChanged += lines;

package/lib/config.js

@@ -2,6 +2,7 @@ import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { homedir } from 'os';
 import { DEFAULT_ATTRIBUTION_OPTIONS } from './git-attribution-options.js';
+import { parseRepoPaths } from './path-utils.js';
 
 const CONFIG_LOCATIONS = [
   join(homedir(), '.lumencode.json'),
@@ -19,12 +20,13 @@ const DEFAULT_CONFIG = {
   blockQuota: null, // 5h 计费窗口 token 上限（Max Pro=1000000, Max=450000 等），null=不限
   costMode: 'auto', // 'auto' | 'calculate' | 'display'
   scenarioKeywords: {
-    coding: ['实现', '功能', '开发', '添加', '修改代码', 'implement', 'feature', 'add', 'refactor', '重构', '组件'],
-    testing: ['测试', 'test', 'spec', '覆盖率', 'coverage', '单元测试', 'unit test', 'jest', 'vitest', 'mocha'],
-    debugging: ['修复', 'bug', 'debug', 'fix', '报错', '错误', '异常', 'error', 'issue', '问题', '排查', '堆栈'],
-    documentation: ['文档', 'doc', 'readme', 'md', '注释', 'comment', '说明', '指南', 'guide'],
-    review: ['review', '审查', '检查', '代码审查', '/review'],
-    planning: ['计划', 'plan', '设计', '架构', '方案', 'design', 'architect'],
+    coding: ['实现', '功能', '开发', '添加', '修改代码', 'implement', 'feature', '组件', 'component', '编写', 'write code'],
+    testing: ['测试', 'test', 'spec', '覆盖率', 'coverage', '单元测试', 'unit test', 'jest', 'vitest', 'mocha', 'cypress', 'playwright'],
+    debugging: ['修复', 'bug', 'debug', 'fix', '报错', '错误', '异常', 'error', '排查', '堆栈', 'trace', 'stack trace', 'crash'],
+    documentation: ['文档', 'readme.md', '注释', '说明', '指南', 'guide', 'wiki', '手册', 'api doc'],
+    review: ['review', '审查', '代码审查', '/review', 'pr', 'pull request', 'approve', 'approval', 'reject', '走查', '代码走查'],
+    planning: ['计划', 'plan', '设计', '架构', '方案', 'design', 'architect', 'roadmap', '规划'],
+    refactoring: ['重构', 'refactor', '重写', 'rewrite', '清理代码', 'clean up', '简化', 'simplify', '提取', 'extract'],
   },
   aiAttribution: DEFAULT_ATTRIBUTION_OPTIONS,
   stepTracking: {
@@ -51,6 +53,17 @@ function deepMerge(target, source) {
   return result;
 }
 
+function normalizeConfig(config) {
+  // 支持 repos / excludeProjects 为字符串（逗号或换行分隔）
+  if (config.repos !== undefined) {
+    config.repos = parseRepoPaths(config.repos);
+  }
+  if (config.excludeProjects !== undefined) {
+    config.excludeProjects = parseRepoPaths(config.excludeProjects);
+  }
+  return config;
+}
+
 export function loadConfig(configPath) {
   let config = { ...DEFAULT_CONFIG };
 
@@ -60,7 +73,7 @@ export function loadConfig(configPath) {
       try {
         const userConfig = JSON.parse(readFileSync(configPath, 'utf-8'));
         config = deepMerge(config, userConfig);
-        return config;
+        return normalizeConfig(config);
       } catch (e) {
         console.error(`配置文件读取失败: ${configPath}`, e.message);
         // 文件存在但解析失败，返回默认值
@@ -75,7 +88,7 @@ export function loadConfig(configPath) {
       try {
         const userConfig = JSON.parse(readFileSync(p, 'utf-8'));
         config = deepMerge(config, userConfig);
-        return config;
+        return normalizeConfig(config);
       } catch (e) {
         console.error(`配置文件读取失败: ${p}`, e.message);
       }

package/lib/git.js

@@ -550,7 +550,10 @@ export function computeAIContribution(commits, toolFilter = null, options = {})
   const attributionOptions = resolveAttributionOptions(options.attribution || options);
   const confidenceWeights = attributionOptions.confidenceWeights;
   const allCommits = commits || [];
+  const isMergeCommit = c => c.attributionType === 'human_merge';
   for (const c of allCommits) {
+    // 合并提交不计入总行数分母，避免稀释 AI 占比
+    if (isMergeCommit(c)) continue;
     totalLinesAdded += c.linesAdded || 0;
     totalLinesDeleted += c.linesDeleted || 0;
   }
@@ -807,14 +810,14 @@ function sanitizeArg(s) {
   return String(s || '').replace(/[`$"\\|;&<>!\n\r]/g, '');
 }
 
-function buildGitArgs(since, until) {
-  const sinceFull = since.includes('T') ? since : since + 'T00:00:00';
-  const safeSince = sanitizeArg(sinceFull);
-  const safeUntil = sanitizeArg(until);
-  // 格式：哨兵行(subject) → body 行(可多行) → ENDBODY 行 → numstat 行
-  const pretty = `--pretty=format:"${COMMIT_SENTINEL}%H|%ad|%ae|%s%n%B${BODY_END}"`;
-  return `--all --no-renames ${pretty} --date=iso-strict --numstat --since="${safeSince}" --until="${safeUntil}"`;
-}
+function buildGitArgs(since, until) {
+  const sinceFull = since.includes('T') ? since : since + 'T00:00:00';
+  const safeSince = sanitizeArg(sinceFull);
+  const safeUntil = sanitizeArg(until);
+  // 格式：哨兵行(subject) → body 行(可多行) → ENDBODY 行 → numstat 行
+  const pretty = `--pretty=format:"${COMMIT_SENTINEL}%H|%ad|%ae|%s%n%B${BODY_END}"`;
+  return `--all --no-renames ${pretty} --date=iso-strict --numstat --since="${safeSince}" --until="${safeUntil}"`;
+}
 
 function mergeGitStats(target, source) {
   target.commits += source.commits;
@@ -837,66 +840,66 @@ function mergeGitStats(target, source) {
   // filesChanged 在 merge 完后由 finalize 重新计算（跨 repo 去重）
 }
 
-function recomputeFilesChanged(stats) {
-  const set = new Set();
-  for (const c of stats.commitList || []) {
-    for (const f of c.files || []) set.add((c.repo || '') + '::' + f.path);
-  }
-  stats.filesChanged = set.size;
-}
-
-function recomputeStatsFromCommitList(stats) {
-  stats.commits = 0;
-  stats.filesChanged = 0;
-  stats.linesAdded = 0;
-  stats.linesDeleted = 0;
-  stats.commitsByDate = {};
-  stats.linesByDate = {};
-
-  for (const c of stats.commitList || []) {
-    const dateKey = c.dateLocal || (c.date || '').slice(0, 10);
-    stats.commits++;
-    stats.commitsByDate[dateKey] = (stats.commitsByDate[dateKey] || 0) + 1;
-    if (!stats.linesByDate[dateKey]) stats.linesByDate[dateKey] = { added: 0, deleted: 0, files: 0 };
-    stats.linesByDate[dateKey].added += c.linesAdded || 0;
-    stats.linesByDate[dateKey].deleted += c.linesDeleted || 0;
-    stats.linesByDate[dateKey].files += (c.files || []).length;
-    stats.linesAdded += c.linesAdded || 0;
-    stats.linesDeleted += c.linesDeleted || 0;
-  }
-  recomputeFilesChanged(stats);
-}
-
-function markAuthorOwnership(stats, expectedAuthor) {
-  const normalizedExpected = (expectedAuthor || '').toLowerCase();
-  for (const c of stats.commitList || []) {
-    c.expectedAuthor = expectedAuthor || null;
-    c.authorMatchesConfig = normalizedExpected
-      ? (c.author || '').toLowerCase() === normalizedExpected
-      : null;
-  }
-}
-
-function hasLocalSessionEvidence(commit) {
-  if (!commit.sessionId) return false;
-  if (commit.sessionAttribution === 'strong') return true;
-  return (commit.aiEvidenceDetails?.matchedFileCount || 0) > 0;
-}
-
-function filterCommitsForUser(stats) {
-  const commits = stats.commitList || [];
-  const hasAuthorOwnershipMetadata = commits.some(c => c.expectedAuthor || c.authorMatchesConfig !== undefined);
-
-  for (const c of commits) {
-    c.countedForUser = !hasAuthorOwnershipMetadata
-      || c.authorMatchesConfig === true
-      || hasLocalSessionEvidence(c);
-  }
-
-  if (!hasAuthorOwnershipMetadata) return;
-  stats.commitList = commits.filter(c => c.countedForUser);
-  recomputeStatsFromCommitList(stats);
-}
+function recomputeFilesChanged(stats) {
+  const set = new Set();
+  for (const c of stats.commitList || []) {
+    for (const f of c.files || []) set.add((c.repo || '') + '::' + f.path);
+  }
+  stats.filesChanged = set.size;
+}
+
+function recomputeStatsFromCommitList(stats) {
+  stats.commits = 0;
+  stats.filesChanged = 0;
+  stats.linesAdded = 0;
+  stats.linesDeleted = 0;
+  stats.commitsByDate = {};
+  stats.linesByDate = {};
+
+  for (const c of stats.commitList || []) {
+    const dateKey = c.dateLocal || (c.date || '').slice(0, 10);
+    stats.commits++;
+    stats.commitsByDate[dateKey] = (stats.commitsByDate[dateKey] || 0) + 1;
+    if (!stats.linesByDate[dateKey]) stats.linesByDate[dateKey] = { added: 0, deleted: 0, files: 0 };
+    stats.linesByDate[dateKey].added += c.linesAdded || 0;
+    stats.linesByDate[dateKey].deleted += c.linesDeleted || 0;
+    stats.linesByDate[dateKey].files += (c.files || []).length;
+    stats.linesAdded += c.linesAdded || 0;
+    stats.linesDeleted += c.linesDeleted || 0;
+  }
+  recomputeFilesChanged(stats);
+}
+
+function markAuthorOwnership(stats, expectedAuthor) {
+  const normalizedExpected = (expectedAuthor || '').toLowerCase();
+  for (const c of stats.commitList || []) {
+    c.expectedAuthor = expectedAuthor || null;
+    c.authorMatchesConfig = normalizedExpected
+      ? (c.author || '').toLowerCase() === normalizedExpected
+      : null;
+  }
+}
+
+function hasLocalSessionEvidence(commit) {
+  if (!commit.sessionId) return false;
+  if (commit.sessionAttribution === 'strong') return true;
+  return (commit.aiEvidenceDetails?.matchedFileCount || 0) > 0;
+}
+
+function filterCommitsForUser(stats) {
+  const commits = stats.commitList || [];
+  const hasAuthorOwnershipMetadata = commits.some(c => c.expectedAuthor || c.authorMatchesConfig !== undefined);
+
+  for (const c of commits) {
+    c.countedForUser = !hasAuthorOwnershipMetadata
+      || c.authorMatchesConfig === true
+      || hasLocalSessionEvidence(c);
+  }
+
+  if (!hasAuthorOwnershipMetadata) return;
+  stats.commitList = commits.filter(c => c.countedForUser);
+  recomputeStatsFromCommitList(stats);
+}
 
 // ── async versions (server) with cache ──
 
@@ -916,26 +919,26 @@ function evictGitCache() {
   }
 }
 
-async function getGitStatsAsync(repoPath, since, until, author = null) {
-  const cacheKey = `${repoPath}|${since}|${until}|${CACHE_VERSION}`;
-  const cached = gitCache.get(cacheKey);
-  if (cached && Date.now() - cached.ts < GIT_CACHE_TTL) return cached.stats;
+async function getGitStatsAsync(repoPath, since, until, author = null) {
+  const cacheKey = `${repoPath}|${since}|${until}|${CACHE_VERSION}`;
+  const cached = gitCache.get(cacheKey);
+  if (cached && Date.now() - cached.ts < GIT_CACHE_TTL) return cached.stats;
 
   try {
     await execAsync('git rev-parse --git-dir', { cwd: repoPath });
   } catch {
     return emptyResult();
   }
-
-  try {
-    const output = await execAsync(`git log ${buildGitArgs(since, until)}`, {
-      cwd: repoPath, encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024,
-    });
-    const stats = parseGitLogOutput(output, repoPath);
-    markAuthorOwnership(stats, author);
-    gitCache.set(cacheKey, { stats, ts: Date.now() });
-    evictGitCache();
-    return stats;
+
+  try {
+    const output = await execAsync(`git log ${buildGitArgs(since, until)}`, {
+      cwd: repoPath, encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024,
+    });
+    const stats = parseGitLogOutput(output, repoPath);
+    markAuthorOwnership(stats, author);
+    gitCache.set(cacheKey, { stats, ts: Date.now() });
+    evictGitCache();
+    return stats;
   } catch {
     return emptyResult();
   }
@@ -1131,38 +1134,38 @@ function sortAttributionCandidates(candidates) {
   });
 }
 
-function candidateFromSession(commit, session, distanceMs) {
-  const overlap = computeFileOverlap(session.touchedFiles || [], commit.files || []);
-  return scoreSessionCandidate(commit, session, {
-    distanceMs,
+function candidateFromSession(commit, session, distanceMs) {
+  const overlap = computeFileOverlap(session.touchedFiles || [], commit.files || []);
+  return scoreSessionCandidate(commit, session, {
+    distanceMs,
     fileOverlapRatio: overlap.fileOverlapRatio,
     matchedFiles: overlap.matchedFiles,
     projectMatches: true,
-  });
-}
-
-function getStepSessionIdCandidates(sessionId, session) {
-  if (!sessionId) return [];
-  const candidates = [sessionId];
-  if (sessionId.includes(':')) return candidates;
-
-  const originByTool = {
-    claude: 'claude_code',
-    codex: 'codex_cli',
-  };
-  const origin = originByTool[session?.primaryTool];
-  if (origin) {
-    candidates.push(`${origin}:${sessionId}`);
-  } else {
-    candidates.push(`claude_code:${sessionId}`, `codex_cli:${sessionId}`);
-  }
-
-  return [...new Set(candidates)];
-}
-
-const BASH_GIT_COMMIT_RE = /\bgit\s+commit\b/i;
-const STRONG_WINDOW_BEFORE_MS = 30 * 1000;       // 30s before bash invocation
-const STRONG_WINDOW_AFTER_MS = 5 * 60 * 1000;    // 5min after
+  });
+}
+
+function getStepSessionIdCandidates(sessionId, session) {
+  if (!sessionId) return [];
+  const candidates = [sessionId];
+  if (sessionId.includes(':')) return candidates;
+
+  const originByTool = {
+    claude: 'claude_code',
+    codex: 'codex_cli',
+  };
+  const origin = originByTool[session?.primaryTool];
+  if (origin) {
+    candidates.push(`${origin}:${sessionId}`);
+  } else {
+    candidates.push(`claude_code:${sessionId}`, `codex_cli:${sessionId}`);
+  }
+
+  return [...new Set(candidates)];
+}
+
+const BASH_GIT_COMMIT_RE = /\bgit\s+commit\b/i;
+const STRONG_WINDOW_BEFORE_MS = 30 * 1000;       // 30s before bash invocation
+const STRONG_WINDOW_AFTER_MS = 5 * 60 * 1000;    // 5min after
 
 function toMs(iso) {
   if (!iso) return NaN;
@@ -1346,11 +1349,11 @@ export function attachCommitsToSessions(sessions, commitList) {
 }
 
 // 一次性收尾：跑 attribution + 三个聚合
-export async function finalizeGitStats(merged, sessions = [], options = {}) {
-  if (!merged) return merged;
-  const attributionOptions = resolveAttributionOptions(options.attribution || options);
-  const stepTrackingOptions = options.stepTracking || {};
-  const fileOverrides = loadAttributionOverrides();
+export async function finalizeGitStats(merged, sessions = [], options = {}) {
+  if (!merged) return merged;
+  const attributionOptions = resolveAttributionOptions(options.attribution || options);
+  const stepTrackingOptions = options.stepTracking || {};
+  const fileOverrides = loadAttributionOverrides();
   const inputOverrides = options.overrides || {};
   const mergedOverrides = {
     commits: { ...fileOverrides.commits, ...(inputOverrides.commits || {}) },
@@ -1378,69 +1381,69 @@ export async function finalizeGitStats(merged, sessions = [], options = {}) {
     }
   }
 
-  // Step 1.5: Enrich commits with line-level step blame when available
-  const stepTrackers = new Map();
-  if (stepTrackingOptions.enabled !== false) try {
-    const { StepTracker } = await import('./step-tracker.js');
-    const projectRoots = [...new Set((sessions || []).map(s => s.project).filter(Boolean))];
-    // Also check repo paths from commits
-    for (const c of merged.commitList || []) {
-      if (c.repo) projectRoots.push(c.repo);
-    }
-    for (const root of [...new Set(projectRoots.map(normalizePathForGit))]) {
-      if (!root) continue;
-      const tracker = new StepTracker(root, {
-        dbPath: stepTrackingOptions.dbPath,
-        maxFileSize: stepTrackingOptions.maxFileSize,
-      });
-      if (await tracker.isAvailableAsync()) {
-        await tracker.open();
-        stepTrackers.set(root, tracker);
-      }
-    }
-  } catch {
-    for (const tracker of stepTrackers.values()) tracker.close();
-    stepTrackers.clear();
-  }
-
-  if (stepTrackers.size > 0) {
-    for (const c of merged.commitList || []) {
-      if (!c.sessionId) continue;
-      const candidateRoots = [
-        c.repo,
-        sessionsById.get(c.sessionId)?.project,
-      ].filter(Boolean);
-      let stepTracker = null;
-      for (const candidateRoot of candidateRoots) {
-        const normalizedCandidate = normalizePathForGit(candidateRoot);
-        for (const [root, tracker] of stepTrackers.entries()) {
-          if (projectMatchesFromGitPaths(root, normalizedCandidate)) {
-            stepTracker = tracker;
-            break;
-          }
-        }
-        if (stepTracker) break;
-      }
-      if (!stepTracker && stepTrackers.size === 1) {
-        stepTracker = stepTrackers.values().next().value;
-      }
-      if (!stepTracker) continue;
-      try {
-        const session = sessionsById.get(c.sessionId);
-        for (const stepSessionId of getStepSessionIdCandidates(c.sessionId, session)) {
-          const lineBlame = stepTracker.getLineAttributionForCommit({
-            ...c,
-            sessionId: stepSessionId,
-          });
-          if (lineBlame) {
-            c.lineBlame = lineBlame;
-            break;
-          }
-        }
-      } catch { /* best effort */ }
-    }
-    for (const tracker of stepTrackers.values()) tracker.close();
-  }
+  // Step 1.5: Enrich commits with line-level step blame when available
+  const stepTrackers = new Map();
+  if (stepTrackingOptions.enabled !== false) try {
+    const { StepTracker } = await import('./step-tracker.js');
+    const projectRoots = [...new Set((sessions || []).map(s => s.project).filter(Boolean))];
+    // Also check repo paths from commits
+    for (const c of merged.commitList || []) {
+      if (c.repo) projectRoots.push(c.repo);
+    }
+    for (const root of [...new Set(projectRoots.map(normalizePathForGit))]) {
+      if (!root) continue;
+      const tracker = new StepTracker(root, {
+        dbPath: stepTrackingOptions.dbPath,
+        maxFileSize: stepTrackingOptions.maxFileSize,
+      });
+      if (await tracker.isAvailableAsync()) {
+        await tracker.open();
+        stepTrackers.set(root, tracker);
+      }
+    }
+  } catch {
+    for (const tracker of stepTrackers.values()) tracker.close();
+    stepTrackers.clear();
+  }
+
+  if (stepTrackers.size > 0) {
+    for (const c of merged.commitList || []) {
+      if (!c.sessionId) continue;
+      const candidateRoots = [
+        c.repo,
+        sessionsById.get(c.sessionId)?.project,
+      ].filter(Boolean);
+      let stepTracker = null;
+      for (const candidateRoot of candidateRoots) {
+        const normalizedCandidate = normalizePathForGit(candidateRoot);
+        for (const [root, tracker] of stepTrackers.entries()) {
+          if (projectMatchesFromGitPaths(root, normalizedCandidate)) {
+            stepTracker = tracker;
+            break;
+          }
+        }
+        if (stepTracker) break;
+      }
+      if (!stepTracker && stepTrackers.size === 1) {
+        stepTracker = stepTrackers.values().next().value;
+      }
+      if (!stepTracker) continue;
+      try {
+        const session = sessionsById.get(c.sessionId);
+        for (const stepSessionId of getStepSessionIdCandidates(c.sessionId, session)) {
+          const lineBlame = stepTracker.getLineAttributionForCommit({
+            ...c,
+            sessionId: stepSessionId,
+          });
+          if (lineBlame) {
+            c.lineBlame = lineBlame;
+            break;
+          }
+        }
+      } catch { /* best effort */ }
+    }
+    for (const tracker of stepTrackers.values()) tracker.close();
+  }
 
   // Step 1.6: compute developer behavioral baselines
   const authorBaselines = computeAuthorBaseline(merged.commitList);
@@ -1548,21 +1551,21 @@ export async function finalizeGitStats(merged, sessions = [], options = {}) {
   }
 
   // Step 2.5: composite continuous scoring for all commits
-  for (const c of merged.commitList || []) {
-    c.aiScore = computeContinuousScore(c, attributionOptions);
-    const mappedConfidence = scoreToConfidence(c.aiScore, attributionOptions);
-    // Only override if no explicit signature and continuous score disagrees
-    if (c.attributionType !== 'explicit') {
+  for (const c of merged.commitList || []) {
+    c.aiScore = computeContinuousScore(c, attributionOptions);
+    const mappedConfidence = scoreToConfidence(c.aiScore, attributionOptions);
+    // Only override if no explicit signature and continuous score disagrees
+    if (c.attributionType !== 'explicit') {
       c.aiConfidence = pickHigherConfidence(c.aiConfidence, mappedConfidence);
       c.isAI = isCountedAIConfidence(c.aiConfidence);
-      c.aiAssisted = c.aiConfidence !== AI_CONFIDENCE.NONE;
-    }
-  }
-
-  filterCommitsForUser(merged);
-
-  const attributionItems = [];
-  for (const c of merged.commitList || []) {
+      c.aiAssisted = c.aiConfidence !== AI_CONFIDENCE.NONE;
+    }
+  }
+
+  filterCommitsForUser(merged);
+
+  const attributionItems = [];
+  for (const c of merged.commitList || []) {
     const commitOverride = mergedOverrides.commits[c.hash] || null;
     const fileOverride = (c.files || []).find(f => mergedOverrides.files[`${c.hash}:${f.path}`]);
     const fileOverrideValue = fileOverride ? mergedOverrides.files[`${c.hash}:${fileOverride.path}`] : null;

package/lib/path-utils.js

@@ -0,0 +1,18 @@
+/**
+ * 解析仓库路径字符串，支持多种分隔符：
+ * - 英文逗号 ,
+ * - 中文逗号 ，
+ * - 换行 \n / \r\n
+ * - 多余空白自动 trim
+ *
+ * @param {string|Array} input - 路径字符串或已解析的数组
+ * @returns {string[]} 解析后的路径数组
+ */
+export function parseRepoPaths(input) {
+  if (Array.isArray(input)) return input.map(s => String(s || '').trim()).filter(Boolean);
+  if (typeof input !== 'string') return [];
+  return input
+    .split(/[,，\n\r]+/)
+    .map(s => s.trim())
+    .filter(Boolean);
+}