lumencode 1.2.0 → 1.3.0

package/lib/step-tracker.js

@@ -0,0 +1,323 @@
+import { createHash } from 'crypto';
+import { existsSync, readFileSync, statSync } from 'fs';
+import { isAbsolute, join, resolve } from 'path';
+import { StepDatabase } from './step-schema.js';
+import { computeBlame, buildInitialBlameMap } from './line-blame.js';
+import {
+  normalizeCommitFilePath,
+  toRepoRelativePath,
+} from './git-paths.js';
+
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
+const IGNORED_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', '.cache', '__pycache__']);
+
+function shouldIgnore(filePath) {
+  const parts = filePath.replace(/\\/g, '/').split('/');
+  return parts.some(p => IGNORED_DIRS.has(p));
+}
+
+function generateStepHash(data) {
+  const raw = typeof data === 'string' ? data : JSON.stringify(data);
+  return createHash('sha256').update(raw).digest('hex').slice(0, 16);
+}
+
+function normalizePath(filePath, projectRoot) {
+  if (!filePath) return '';
+  const relative = toRepoRelativePath(filePath, projectRoot);
+  return normalizeCommitFilePath(relative);
+}
+
+function extractPatchTargetFiles(patchText, projectRoot) {
+  const files = [];
+  const patch = String(patchText || '');
+  const markerRe = /^\*\*\* (?:Add File|Update File|Delete File|Move to):\s+(.+)$/gm;
+  let match;
+  while ((match = markerRe.exec(patch)) !== null) {
+    const normalized = normalizePath(match[1].trim(), projectRoot);
+    if (normalized) files.push(normalized);
+  }
+  return files;
+}
+
+// Extract file paths from tool input (reuses logic from git.js)
+function extractTargetFiles(toolName, toolInput, projectRoot) {
+  const files = [];
+  const input = toolInput || {};
+  const normalizedTool = String(toolName || '').toLowerCase();
+
+  if (['write', 'edit', 'multiedit', 'notebookedit'].includes(normalizedTool)) {
+    const rawPath = input.file_path || input.filePath || input.filepath || input.path || '';
+    if (rawPath) {
+      const normalized = normalizePath(rawPath, projectRoot);
+      if (normalized) files.push(normalized);
+    }
+  } else if (normalizedTool === 'bash') {
+    // Minimal extraction for shell commands touching files
+    const cmd = input.command || '';
+    const redirectRe = />>?\s*['"]?([^&|;\s<>$`'"]+)['"]?/g;
+    let m;
+    while ((m = redirectRe.exec(cmd)) !== null) {
+      const p = normalizePath(m[1], projectRoot);
+      if (p) files.push(p);
+    }
+  } else if (normalizedTool === 'apply_patch') {
+    files.push(...extractPatchTargetFiles(input.patchText || input.patch_text || input.patch, projectRoot));
+  } else if (String(toolName || '').startsWith('mcp__')) {
+    const rawPath = input.relative_path || input.file_path || input.path || '';
+    if (rawPath) {
+      const normalized = normalizePath(rawPath, projectRoot);
+      if (normalized) files.push(normalized);
+    }
+  }
+
+  return files.filter(f => !shouldIgnore(f));
+}
+
+export class StepTracker {
+  constructor(projectRoot, options = {}) {
+    this.projectRoot = resolve(projectRoot || process.cwd());
+    this.dbPath = options.dbPath
+      ? (isAbsolute(options.dbPath) ? options.dbPath : join(this.projectRoot, options.dbPath))
+      : join(this.projectRoot, '.ccusage', 'steps.db');
+    this.db = null;
+    this.maxFileSize = options.maxFileSize || MAX_FILE_SIZE;
+  }
+
+  async open() {
+    this.db = new StepDatabase();
+    await this.db.open(this.dbPath);
+    return this;
+  }
+
+  close() {
+    if (this.db) {
+      this.db.save();
+      this.db.close();
+      this.db = null;
+    }
+  }
+
+  isAvailable() {
+    return this.db && this.db.getStepCount() > 0;
+  }
+
+  async isAvailableAsync() {
+    if (!existsSync(this.dbPath)) return false;
+    try {
+      const tempDb = new StepDatabase();
+      await tempDb.open(this.dbPath);
+      const count = tempDb.getStepCount();
+      tempDb.close();
+      return count > 0;
+    } catch { return false; }
+  }
+
+  // ── Record a tool use step ──
+
+  async recordStep(payload) {
+    if (!this.db) await this.open();
+
+    const sessionId = payload.sessionId || 'unknown';
+    const origin = payload.origin || 'claude_code';
+    const toolName = payload.toolName || '';
+    const toolUseId = payload.toolUseId || generateStepHash(`${sessionId}:${Date.now()}`);
+    const timestamp = payload.timestamp ? new Date(payload.timestamp).getTime() : Date.now();
+
+    // Extract target files from tool input
+    const explicitTargets = Array.isArray(payload.targetFiles)
+      ? payload.targetFiles.map(file => normalizePath(file, this.projectRoot)).filter(Boolean)
+      : [];
+    const batchTargets = Array.isArray(payload.toolCalls)
+      ? payload.toolCalls.flatMap(call => extractTargetFiles(
+        call.toolName || call.tool_name || call.name || call.tool || '',
+        call.toolInput || call.tool_input || call.input || call.args || {},
+        this.projectRoot
+      ))
+      : [];
+    const targetFiles = [...new Set([
+      ...explicitTargets,
+      ...batchTargets,
+      ...extractTargetFiles(toolName, payload.toolInput || {}, this.projectRoot),
+    ])];
+    if (targetFiles.length === 0) return null;
+
+    // Get parent step for session
+    const parentStepId = this.db.getSessionHead(sessionId);
+
+    // Generate step hash
+    const stepHash = generateStepHash(
+      `${parentStepId}:${sessionId}:${toolName}:${toolUseId}:${timestamp}`
+    );
+
+    // Compute blame for each target file
+    for (const filePath of targetFiles) {
+      const absPath = resolve(this.projectRoot, filePath);
+      if (!existsSync(absPath)) continue;
+
+      const stat = statSync(absPath);
+      if (stat.size > this.maxFileSize) continue;
+
+      const newContent = readFileSync(absPath, 'utf-8');
+
+      // Get old content and blame from parent step
+      let oldContent = null;
+      let oldBlameMap = null;
+      if (parentStepId) {
+        oldContent = this.db.getFileBlob(parentStepId, filePath);
+        oldBlameMap = this.db.getBlameMap(parentStepId, filePath);
+      }
+
+      let newBlameMap;
+      if (oldContent !== null) {
+        newBlameMap = computeBlame(oldContent, newContent, oldBlameMap, stepHash);
+      } else {
+        newBlameMap = buildInitialBlameMap(newContent, stepHash);
+      }
+
+      this.db.upsertStepFile(stepHash, filePath, newBlameMap, newContent);
+    }
+
+    // Write step record
+    this.db.insertStep({
+      id: stepHash,
+      parentId: parentStepId,
+      sessionId,
+      origin,
+      ts: timestamp,
+      toolName,
+      toolUseId,
+    });
+
+    // Update session head
+    this.db.upsertSession({
+      id: sessionId,
+      origin,
+      headStepId: stepHash,
+    });
+
+    this.db.save();
+    return stepHash;
+  }
+
+  // ── Line attribution for a commit ──
+
+  getLineAttributionForCommit(commit) {
+    if (!this.db || !commit.sessionId) return null;
+
+    const result = {
+      aiLines: 0,
+      humanLines: 0,
+      aiDeletedLines: 0,
+      humanDeletedLines: 0,
+      totalLines: 0,
+      fileBreakdown: {},
+      source: 'step_blame',
+    };
+
+    for (const file of commit.files || []) {
+      const filePath = normalizeCommitFilePath(file.path);
+      if (shouldIgnore(filePath)) continue;
+
+      // Find the latest step for this file in the session
+      const stepFiles = this.db.getStepFilesForPath(filePath, 5);
+      const sessionSteps = stepFiles.filter(sf => sf.session_id === commit.sessionId);
+      if (sessionSteps.length === 0) continue;
+
+      const latestStep = sessionSteps[0]; // already sorted DESC by ts
+      const blameMap = this.db.getBlameMap(latestStep.step_id, filePath);
+      if (!blameMap || !blameMap.lines) continue;
+
+      // Count AI vs human lines in the blame map
+      const stepIds = new Set(sessionSteps.map(s => s.step_id));
+      let fileAI = 0;
+      let fileHuman = 0;
+
+      for (const lineStep of blameMap.lines) {
+        if (stepIds.has(lineStep)) {
+          fileAI++;
+        } else {
+          fileHuman++;
+        }
+      }
+
+      const totalChanged = (file.added || 0) + (file.deleted || 0);
+      if (totalChanged === 0) continue;
+
+      // Proportionally attribute added/deleted lines
+      const fileTotal = fileAI + fileHuman;
+      const aiRatio = fileTotal > 0 ? fileAI / fileTotal : 0;
+
+      const fileAIAdded = Math.round((file.added || 0) * aiRatio);
+      const fileHumanAdded = (file.added || 0) - fileAIAdded;
+      const fileAIDeleted = Math.round((file.deleted || 0) * aiRatio);
+      const fileHumanDeleted = (file.deleted || 0) - fileAIDeleted;
+
+      result.aiLines += fileAIAdded;
+      result.humanLines += fileHumanAdded;
+      result.aiDeletedLines += fileAIDeleted;
+      result.humanDeletedLines += fileHumanDeleted;
+      result.totalLines += totalChanged;
+      result.fileBreakdown[filePath] = { aiLines: fileAIAdded, humanLines: fileHumanAdded, aiDeletedLines: fileAIDeleted, humanDeletedLines: fileHumanDeleted };
+    }
+
+    if (result.totalLines === 0) return null;
+    return result;
+  }
+
+  // ── Backfill from existing session data ──
+
+  async backfillFromSession(session) {
+    if (!this.db) await this.open();
+
+    const sessionId = session.id || 'unknown';
+    let stepCount = 0;
+
+    for (const tc of session.toolSequence || []) {
+      const targetFiles = extractTargetFiles(tc.name, tc.input, this.projectRoot);
+      if (targetFiles.length === 0) continue;
+
+      const timestamp = tc.timestamp ? new Date(tc.timestamp).getTime() : Date.now();
+      const parentStepId = this.db.getSessionHead(sessionId);
+      const stepHash = generateStepHash(
+        `backfill:${parentStepId}:${sessionId}:${tc.name}:${timestamp}`
+      );
+
+      for (const filePath of targetFiles) {
+        const absPath = resolve(this.projectRoot, filePath);
+        if (!existsSync(absPath)) continue;
+
+        const stat = statSync(absPath);
+        if (stat.size > this.maxFileSize) continue;
+
+        const content = readFileSync(absPath, 'utf-8');
+        const blameMap = buildInitialBlameMap(content, stepHash);
+        this.db.upsertStepFile(stepHash, filePath, blameMap);
+      }
+
+      this.db.insertStep({
+        id: stepHash,
+        parentId: parentStepId,
+        sessionId,
+        ts: timestamp,
+        toolName: tc.name,
+        toolUseId: `backfill-${stepCount}`,
+      });
+
+      this.db.upsertSession({ id: sessionId, headStepId: stepHash });
+      stepCount++;
+    }
+
+    if (stepCount > 0) this.db.save();
+    return stepCount;
+  }
+
+  // ── Stats ──
+
+  getStats() {
+    if (!this.db) return { stepCount: 0, sessionCount: 0 };
+    return {
+      stepCount: this.db.getStepCount(),
+      sessionCount: this.db.getSessionCount(),
+    };
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumencode",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "LumenCode — AI 编码助手使用报告工具，从 JSONL 日志和 Git 仓库提取 AI 贡献度、效率与使用指标，支持 Web 可视化和命令行两种模式",
   "type": "module",
   "bin": {
@@ -8,7 +8,11 @@
   },
   "scripts": {
     "start": "node index.js",
-    "test": "node --test test/*.test.js"
+    "test": "node --test test",
+    "hooks:init": "node hooks/init-steps.js",
+    "hooks:install": "node hooks/install.js",
+    "hooks:install-claude": "node hooks/install.js",
+    "hooks:install-codex": "node hooks/install-codex.js"
   },
   "keywords": [
     "lumencode",
@@ -29,6 +33,7 @@
   "license": "MIT",
   "author": "zhangyaowen",
   "files": [
+    "hooks/",
     "lib/",
     "public/",
     "data/pricing.json",
@@ -39,6 +44,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "diff-match-patch": "^1.0.5",
     "sql.js": "^1.14.1"
   }
 }

package/public/api.js

@@ -107,6 +107,27 @@ export async function fetchSessions(params) {
   return cachedFetch(`${API.SESSIONS}?${qs}`);
 }
 
+export async function fetchStepStats() {
+  return cachedFetch(API.STEP_STATS, {}, 10_000);
+}
+
+export async function fetchHooksStatus() {
+  const res = await fetch(API.HOOKS);
+  if (!res.ok) throw new Error('获取 hooks 状态失败');
+  return res.json();
+}
+
+export async function updateHooks(action, tools = ['claude', 'codex', 'opencode']) {
+  const res = await fetch(API.HOOKS, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ action, tools: tools.join(',') }),
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(data.error || '更新 hooks 失败');
+  return data;
+}
+
 export async function fetchWorkReport(params) {
   const qs = new URLSearchParams(params).toString();
   const res = await fetch(`${API.REPORT}?${qs}&format=work`);

package/public/app.js

@@ -1,8 +1,8 @@
 import { COLORS, SCENARIO_COLORS, TEXT, ID, STORAGE } from './config.js';
 import { esc, fmt, fmtShort, destroyChart, destroyAllCharts, getChart, setChart, todayISO, fmtDate } from './utils.js';
-import { createLatestRequestGuard, fetchTools, fetchReport, fetchConfig, saveConfig, fetchDetails, fetchSessions } from './api.js';
+import { createLatestRequestGuard, fetchTools, fetchReport, fetchConfig, saveConfig, fetchDetails, fetchSessions, fetchStepStats, fetchHooksStatus, updateHooks } from './api.js';
 import { renderWorkTypePie, renderModelBars, renderProjectBars, renderTimelineArea, renderCacheStack } from './charts.js';
-import { renderGitInsights } from './git-insights.js';
+import { renderGitInsights, renderLineBlameEvidence } from './git-insights.js';
 import { loadWorkReport, copyWorkReport, downloadMarkdown, getWorkReportState, setWorkReportState } from './work-report.js';
 import { exportCSV, printReport, exportJSON, exportHTML } from './export.js';
 
@@ -95,6 +95,12 @@ function appState() {
     sourceOpencodePct: 0,
     sourceBreakdown: [],
     aiContributionMeta: '- / - LINES',
+    lineBlameEvidence: null,
+    lineBlamePrecision: '',
+    stepStats: null,
+    stepStatusLabel: '',
+    hooksStatus: null,
+    hooksBusy: false,
     gitOutputCells: [
       { l: '提交', en: 'COMMITS', v: '-', c: '' },
       { l: '变更文件', en: 'FILES', v: '-', c: '' },
@@ -146,6 +152,36 @@ function appState() {
     reportSummary: '',
     reportHighlights: [],
 
+    get hooksNeedAction() {
+      if (!this.hooksStatus) return false;
+      return !this.hooksStatus.stepsInitialized ||
+        !this.hooksStatus.claude?.enabled ||
+        !this.hooksStatus.codex?.enabled ||
+        !this.hooksStatus.opencode?.enabled;
+    },
+
+    get hooksStatusText() {
+      if (!this.hooksStatus) return '正在检查 hooks 状态';
+      const total = this.hooksStatus.projectCount ?? this.hooksStatus.claude?.total ?? 0;
+      if (this.hooksStatus.targetMode === 'configured-projects') {
+        if (total === 0) return '未配置项目，请先在设置中添加项目路径';
+        const parts = [
+          `Claude ${this.hooksStatus.claude?.enabledCount || 0}/${total}`,
+          `Codex ${this.hooksStatus.codex?.enabledCount || 0}/${total}`,
+          `OpenCode ${this.hooksStatus.opencode?.enabledCount || 0}/${total}`,
+          `steps ${this.hooksStatus.stepsReadyCount || 0}/${total}`,
+        ];
+        return `设置内项目 hooks：${parts.join(' / ')}`;
+      }
+      const parts = [
+        `Claude ${this.hooksStatus.claude?.enabled ? '已开启' : '未开启'}`,
+        `Codex ${this.hooksStatus.codex?.enabled ? '已开启' : '未开启'}`,
+        `OpenCode ${this.hooksStatus.opencode?.enabled ? '已开启' : '未开启'}`,
+        `steps ${this.hooksStatus.stepsInitialized ? '已初始化' : '未初始化'}`,
+      ];
+      return parts.join(' / ');
+    },
+
     /* ── init ── */
     async init() {
       this.loadStateFromHash();
@@ -157,6 +193,8 @@ function appState() {
         }
       });
       await this.loadTools();
+      await this.loadHooksStatus();
+      await this.loadStepStats();
       // 首次加载时先获取全量数据填充侧边栏，再按当前工具加载
       if (this.activeTool !== 'all') {
         try {
@@ -189,6 +227,83 @@ function appState() {
       } catch (e) { console.warn('loadTools failed:', e); this.availableTools = []; }
     },
 
+    async loadStepStats() {
+      try {
+        const data = await fetchStepStats();
+        this.stepStats = data;
+        this.stepStatusLabel = data?.available
+          ? `STEP READY · ${data.stepCount || 0}`
+          : 'STEP NOT READY';
+      } catch {
+        this.stepStats = null;
+        this.stepStatusLabel = '';
+      }
+    },
+
+    async loadHooksStatus() {
+      try {
+        this.hooksStatus = await fetchHooksStatus();
+      } catch (e) {
+        console.warn('loadHooksStatus failed:', e);
+        this.hooksStatus = null;
+      }
+    },
+
+    showHooksConfirmModal() {
+      const count = this.hooksStatus?.projectCount ?? 0;
+      const el = document.getElementById('hooksConfirmCount');
+      if (el) el.textContent = count;
+      const modal = document.getElementById('hooksConfirmModal');
+      if (modal) modal.style.display = 'flex';
+    },
+
+    hideHooksConfirmModal() {
+      const modal = document.getElementById('hooksConfirmModal');
+      if (modal) modal.style.display = 'none';
+    },
+
+    async enableHooksFromUi() {
+      this.hideHooksConfirmModal();
+      if (this.hooksBusy) return;
+      this.hooksBusy = true;
+      try {
+        await updateHooks('enable');
+        await this.loadHooksStatus();
+        await this.loadStepStats();
+        showToast('hooks 已开启');
+      } catch (err) {
+        showToast('开启 hooks 失败: ' + err.message);
+      } finally {
+        this.hooksBusy = false;
+      }
+    },
+
+    showHooksDisableConfirmModal() {
+      const modal = document.getElementById('hooksDisableConfirmModal');
+      if (modal) modal.style.display = 'flex';
+    },
+
+    hideHooksDisableConfirmModal() {
+      const modal = document.getElementById('hooksDisableConfirmModal');
+      if (modal) modal.style.display = 'none';
+    },
+
+    async disableHooksFromUi() {
+      this.hideHooksDisableConfirmModal();
+      if (this.hooksBusy) return;
+      this.hooksBusy = true;
+      try {
+        await updateHooks('disable');
+        await this.loadHooksStatus();
+        await this.loadStepStats();
+        showToast('hooks 已关闭');
+      } catch (err) {
+        showToast('关闭 hooks 失败: ' + err.message);
+      } finally {
+        this.hooksBusy = false;
+      }
+    },
+
     setTool(name) {
       this.activeTool = name;
       this.loadCurrentView();
@@ -535,6 +650,16 @@ function appState() {
         pctSum += pct;
         return { name: toolDisplayNames[name] || name, pct, tokens: fmtShort(tok), color: toolColors[name] || 'var(--foreground)' };
       });
+
+      /* Line-level blame evidence */
+      const blameEv = renderLineBlameEvidence(gitStats?.commitList);
+      if (blameEv) {
+        this.lineBlameEvidence = blameEv;
+        this.lineBlamePrecision = `行级归因: ${blameEv.aiLines}/${blameEv.totalLines} 行 (${blameEv.precision}%) · ${blameEv.commitCount} 提交`;
+      } else {
+        this.lineBlameEvidence = null;
+        this.lineBlamePrecision = '';
+      }
     },
 
     renderTimeline(trendData, usageStats) {

package/public/config.js

@@ -5,6 +5,8 @@ export const API = {
   CONFIG: '/api/config',
   DETAILS: '/api/details',
   SESSIONS: '/api/sessions',
+  STEP_STATS: '/api/step-stats',
+  HOOKS: '/api/hooks',
 };
 
 // 灰阶色板（按视觉权重从重到轻）

package/public/git-insights.js

@@ -42,6 +42,25 @@ function renderCommitTypeChart(typeEntries) {
   setChart('commitTypeChart', instance);
 }
 
+/**
+ * Render line-level attribution evidence summary.
+ * Called when gitStats.commitList has commits with lineBlame data.
+ */
+export function renderLineBlameEvidence(commitList) {
+  const blamed = (commitList || []).filter(c => c.lineBlame && c.lineBlame.source === 'step_blame');
+  if (blamed.length === 0) return null;
+  const totalAiLines = blamed.reduce((s, c) => s + (c.lineBlame.aiLines || 0), 0);
+  const totalLines = blamed.reduce((s, c) => s + (c.lineBlame.totalLines || 0), 0);
+  const totalAiDeleted = blamed.reduce((s, c) => s + (c.lineBlame.aiDeletedLines || 0), 0);
+  return {
+    commitCount: blamed.length,
+    aiLines: totalAiLines,
+    totalLines,
+    aiDeletedLines: totalAiDeleted,
+    precision: totalLines > 0 ? Math.round((totalAiLines / totalLines) * 100) : 0,
+  };
+}
+
 const COMMIT_TYPE_COLORS = {
   feat: '#8ab8a0', fix: '#c49090', refactor: '#a090c0', docs: '#90a8c8',
   test: '#c8b880', chore: '#a8a8a8', perf: '#c890b0', style: '#80b8b8',

package/public/index.html

@@ -52,6 +52,22 @@
             </ul>
           </nav>
 
+          <div class="rail-hooks" x-show="hooksStatus" x-cloak>
+            <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:6px;">
+              <span style="font-size:11px;font-weight:500;">行级 AI 归因</span>
+              <span class="font-mono" style="font-size:9px;letter-spacing:0.08em;opacity:0.55">HOOKS</span>
+            </div>
+            <div class="rail-hooks-meta" x-text="hooksStatusText"></div>
+            <div style="display:flex;gap:6px;margin-top:8px;">
+              <button class="rail-hooks-btn" x-show="hooksNeedAction" @click="showHooksConfirmModal()" :disabled="hooksBusy">
+                <span x-text="hooksBusy ? '...' : '开启'"></span>
+              </button>
+              <button class="rail-hooks-btn rail-hooks-btn--off" x-show="!hooksNeedAction" @click="showHooksDisableConfirmModal()" :disabled="hooksBusy">
+                关闭
+              </button>
+            </div>
+          </div>
+
           <div class="rail-footer">
             <div style="display:flex;align-items:center;justify-content:space-between;width:100%;">
               <div style="display:flex;align-items:center;gap:8px;">
@@ -188,6 +204,8 @@
               <span class="label section-head-en">/ AI CONTRIBUTION</span>
               <span class="section-head-line"></span>
               <span class="section-head-meta font-mono" style="font-size:10px;opacity:0.55" x-text="aiContributionMeta"></span>
+              <span x-show="stepStatusLabel && !lineBlameEvidence" class="font-mono" style="font-size:9px;padding:2px 8px;border-radius:4px;background:var(--ink-12);color:var(--foreground);letter-spacing:0.08em;opacity:0.7" x-text="stepStatusLabel"></span>
+              <span x-show="lineBlameEvidence" class="font-mono" style="font-size:9px;padding:2px 8px;border-radius:4px;background:var(--forest);color:var(--background);letter-spacing:0.08em;opacity:0.85">LINE-BLAME</span>
             </div>
 
             <div class="ai-hero-grid">
@@ -196,6 +214,7 @@
                   <div style="flex-shrink:0;">
                     <div class="ai-hero-pct"><span class="text-aurora-shimmer" x-text="aiLinePctDisplay"></span><span :style="'color:' + colors.rust">%</span></div>
                     <div class="ai-hero-desc" x-html="aiSummaryDesc"></div>
+                    <div x-show="lineBlamePrecision" class="font-mono" style="font-size:10px;margin-top:6px;opacity:0.55" x-text="lineBlamePrecision"></div>
                   </div>
                   <div style="flex:1;padding-bottom:12px;">
                     <div style="display:flex;justify-content:space-between;margin-bottom:6px;">
@@ -640,6 +659,56 @@
         </div>
       </div>
     </main>
+
+    <!-- ── Hooks Confirm Modal ── -->
+    <div id="hooksConfirmModal" class="modal-overlay" style="display:none;">
+      <div class="modal-backdrop" @click="hideHooksConfirmModal()"></div>
+      <div class="modal-panel" style="max-width:440px;">
+        <div class="modal-header">
+          <h3 style="font-size:15px;font-weight:500;">确认开启 hooks</h3>
+          <button class="rail-btn-icon" @click="hideHooksConfirmModal()" style="color:var(--foreground);opacity:0.65;">
+            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+          </button>
+        </div>
+        <div class="modal-body" style="padding:16px 24px;">
+          <p style="font-size:13px;line-height:1.7;opacity:0.85;">将为设置中的 <strong id="hooksConfirmCount">0</strong> 个项目开启 hooks，修改各项目下的配置文件并自动备份：</p>
+          <div class="hooks-confirm-files">
+            <div><span style="color:var(--claude)">Claude</span> .claude/settings.local.json</div>
+            <div><span style="color:var(--codex)">Codex</span> .codex/config.toml</div>
+            <div><span style="color:var(--opencode)">OpenCode</span> .opencode/plugins/lumencode-step-tracker.js</div>
+          </div>
+        </div>
+        <div class="modal-footer" style="gap:8px;">
+          <button class="btn btn-outline" @click="hideHooksConfirmModal()">取消</button>
+          <button class="btn btn-primary" @click="enableHooksFromUi()" :disabled="hooksBusy">确认开启</button>
+        </div>
+      </div>
+    </div>
+
+    <!-- ── Hooks Disable Confirm Modal ── -->
+    <div id="hooksDisableConfirmModal" class="modal-overlay" style="display:none;">
+      <div class="modal-backdrop" @click="hideHooksDisableConfirmModal()"></div>
+      <div class="modal-panel" style="max-width:440px;">
+        <div class="modal-header">
+          <h3 style="font-size:15px;font-weight:500;">确认关闭 hooks</h3>
+          <button class="rail-btn-icon" @click="hideHooksDisableConfirmModal()" style="color:var(--foreground);opacity:0.65;">
+            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
+          </button>
+        </div>
+        <div class="modal-body" style="padding:16px 24px;">
+          <p style="font-size:13px;line-height:1.7;opacity:0.85;">关闭后将<strong style="color:var(--warning)">停止记录</strong>行级编辑步骤，影响如下：</p>
+          <div class="hooks-confirm-files">
+            <div style="color:var(--warning)">新提交的代码将无法进行行级 AI 归因</div>
+            <div>已记录的历史数据会保留，不受影响</div>
+            <div>恢复记录需重新开启 hooks</div>
+          </div>
+        </div>
+        <div class="modal-footer" style="gap:8px;">
+          <button class="btn btn-outline" @click="hideHooksDisableConfirmModal()">取消</button>
+          <button class="btn btn-primary" @click="disableHooksFromUi()" :disabled="hooksBusy">确认关闭</button>
+        </div>
+      </div>
+    </div>
   </div>
 
   <!-- ── Settings Modal ── -->