commit-report 1.0.1 → 1.0.2

package/templates/report-scripts/00-filter-state.html

@@ -0,0 +1,374 @@
+  function getPathDirectory(path) {
+    if (!path) return '(根目录)';
+    const parts = String(path).split('/').filter(Boolean);
+    return parts.length > 1 ? parts[0] : '(根目录)';
+  }
+
+  function getFileExtension(path) {
+    const fileName = String(path || '').split('/').pop() || '';
+    const dotIndex = fileName.lastIndexOf('.');
+    if (dotIndex <= 0 || dotIndex === fileName.length - 1) return '无扩展';
+    return fileName.slice(dotIndex).toLowerCase();
+  }
+
+  function getCommitLines(commit) {
+    return (commit.linesAdded || 0) + (commit.linesDeleted || 0);
+  }
+
+  function getCommitFiles(commit) {
+    return Array.isArray(commit.files) ? commit.files : [];
+  }
+
+  function isReportFiltered() {
+    return Boolean(reportState.author || reportState.directory);
+  }
+
+  function commitMatchesReportFilters(commit) {
+    return Boolean(normalizeFilteredCommit(commit));
+  }
+
+  function getFilteredSourceCommits() {
+    const commits = baseStats.commitDetails || [];
+    if (!isReportFiltered()) return commits;
+    return commits
+      .map(normalizeFilteredCommit)
+      .filter(Boolean);
+  }
+
+  function normalizeFilteredCommit(commit) {
+    const authorMatches = !reportState.author || String(commit.email || '').toLowerCase() === reportState.author;
+    if (!authorMatches) return null;
+
+    if (!reportState.directory) return commit;
+
+    const files = getCommitFiles(commit).filter(file => {
+      const directory = getPathDirectory(file.path);
+      return directory === reportState.directory || String(file.path || '').startsWith(reportState.directory + '/');
+    });
+    if (files.length === 0) return null;
+
+    return {
+      ...commit,
+      files,
+      linesAdded: files.reduce((sum, file) => sum + (file.added || 0), 0),
+      linesDeleted: files.reduce((sum, file) => sum + (file.deleted || 0), 0),
+    };
+  }
+
+  function createTimeAuthorSlot() {
+    return { count: 0, authors: {} };
+  }
+
+  function addTimeAuthor(slot, author) {
+    slot.count++;
+    slot.authors[author] = (slot.authors[author] || 0) + 1;
+  }
+
+  function buildFilteredStats() {
+    if (!isReportFiltered()) return baseStats;
+
+    const commits = getFilteredSourceCommits();
+    const emptyDate = new Date().toISOString();
+    const sortedAsc = [...commits].sort((a, b) => new Date(a.date) - new Date(b.date));
+    const sortedDesc = [...commits].sort((a, b) => new Date(b.date) - new Date(a.date));
+    const totalCommits = commits.length;
+    const linesAdded = commits.reduce((sum, commit) => sum + (commit.linesAdded || 0), 0);
+    const linesDeleted = commits.reduce((sum, commit) => sum + (commit.linesDeleted || 0), 0);
+    const filesChanged = commits.reduce((sum, commit) => sum + getCommitFiles(commit).length, 0);
+    const firstCommitDate = sortedAsc[0]?.date || baseStats.firstCommitDate || emptyDate;
+    const lastCommitDate = sortedDesc[0]?.date || baseStats.lastCommitDate || emptyDate;
+
+    const derived = {
+      ...baseStats,
+      totalCommits,
+      linesAdded,
+      linesDeleted,
+      filesChanged,
+      firstCommitDate,
+      lastCommitDate,
+      busiestDay: deriveBusiestDay(commits),
+      authors: deriveAuthors(commits),
+      fileTypes: deriveFileTypes(commits),
+      directories: deriveDirectories(commits),
+      hourlyDistribution: deriveHourlyDistribution(commits),
+      dailyHeatmap: deriveDailyHeatmap(commits),
+      hourlyByAuthor: deriveHourlyByAuthor(commits),
+      quality: deriveQuality(commits, linesAdded, linesDeleted, filesChanged),
+      timePatterns: deriveTimePatterns(commits),
+      trends: deriveTrends(commits),
+      collaboration: deriveCollaboration(commits),
+      messageStats: deriveMessageStats(commits),
+      authorFileTypeContributions: deriveAuthorFileTypeContributions(commits),
+      commitDetails: sortedAsc,
+    };
+
+    derived.teamHealth = deriveTeamHealth(commits);
+    derived.stability = deriveStability(commits);
+    derived.workPressure = deriveWorkPressure(commits);
+    derived.contributorChurn = deriveContributorChurn(commits);
+    derived.advancedCollaboration = deriveAdvancedCollaboration(commits);
+    derived.changeSizeDistribution = deriveChangeSizeDistribution(commits);
+    derived.directoryCoupling = deriveDirectoryCoupling(commits);
+    derived.engineering = deriveEngineering(commits);
+    derived.techDebt = deriveTechDebt(derived);
+    applyFilteredAIStats(derived, commits);
+
+    return derived;
+  }
+
+  function deriveBusiestDay(commits) {
+    const daily = new Map();
+    commits.forEach(commit => {
+      const key = formatDateKeyLocal(commit.date);
+      daily.set(key, (daily.get(key) || 0) + 1);
+    });
+
+    const [date, count] = [...daily.entries()].sort((a, b) => b[1] - a[1])[0] || ['', 0];
+    return { date, count };
+  }
+
+  function deriveAuthors(commits) {
+    const map = new Map();
+    commits.forEach(commit => {
+      const email = String(commit.email || '').toLowerCase();
+      const current = map.get(email) || {
+        name: commit.author || 'Unknown',
+        email: commit.email || '',
+        commits: 0,
+        linesAdded: 0,
+        linesDeleted: 0,
+        lastActiveDate: commit.date,
+      };
+      current.commits++;
+      current.linesAdded += commit.linesAdded || 0;
+      current.linesDeleted += commit.linesDeleted || 0;
+      if (new Date(commit.date) > new Date(current.lastActiveDate)) current.lastActiveDate = commit.date;
+      map.set(email, current);
+    });
+
+    return [...map.values()].sort((a, b) => b.commits - a.commits);
+  }
+
+  function deriveFileTypes(commits) {
+    const map = new Map();
+    commits.forEach(commit => getCommitFiles(commit).forEach(file => {
+      const extension = getFileExtension(file.path);
+      const current = map.get(extension) || { extension, added: 0, deleted: 0, fileCount: 0 };
+      current.added += file.added || 0;
+      current.deleted += file.deleted || 0;
+      current.fileCount++;
+      map.set(extension, current);
+    }));
+
+    return [...map.values()].sort((a, b) => (b.added + b.deleted) - (a.added + a.deleted));
+  }
+
+  function deriveDirectories(commits) {
+    const map = new Map();
+    commits.forEach(commit => {
+      const seen = new Set();
+      getCommitFiles(commit).forEach(file => {
+        const path = getPathDirectory(file.path);
+        const current = map.get(path) || { path, commits: 0, linesChanged: 0 };
+        current.linesChanged += (file.added || 0) + (file.deleted || 0);
+        if (!seen.has(path)) {
+          current.commits++;
+          seen.add(path);
+        }
+        map.set(path, current);
+      });
+    });
+
+    return [...map.values()].sort((a, b) => b.linesChanged - a.linesChanged);
+  }
+
+  function deriveHourlyDistribution(commits) {
+    const hours = new Array(24).fill(0);
+    commits.forEach(commit => {
+      hours[new Date(commit.date).getHours()]++;
+    });
+    return hours;
+  }
+
+  function deriveHourlyByAuthor(commits) {
+    const hours = Array.from({ length: 24 }, createTimeAuthorSlot);
+    commits.forEach(commit => addTimeAuthor(hours[new Date(commit.date).getHours()], commit.author || 'Unknown'));
+    return hours;
+  }
+
+  function deriveDailyHeatmap(commits) {
+    const daily = {};
+    commits.forEach(commit => {
+      const key = formatDateKeyLocal(commit.date);
+      daily[key] = (daily[key] || 0) + 1;
+    });
+    return daily;
+  }
+
+  function deriveQuality(commits, linesAdded, linesDeleted, filesChanged) {
+    const fileMap = new Map();
+    commits.forEach(commit => getCommitFiles(commit).forEach(file => {
+      const current = fileMap.get(file.path) || { path: file.path, modifyCount: 0, authors: new Set() };
+      current.modifyCount++;
+      current.authors.add(commit.author || 'Unknown');
+      fileMap.set(file.path, current);
+    }));
+
+    return {
+      avgFilesPerCommit: commits.length ? filesChanged / commits.length : 0,
+      avgLinesPerCommit: commits.length ? (linesAdded + linesDeleted) / commits.length : 0,
+      churnRate: linesAdded > 0 ? linesDeleted / linesAdded : 0,
+      hotFiles: [...fileMap.values()]
+        .map(file => ({ ...file, authors: [...file.authors] }))
+        .sort((a, b) => b.modifyCount - a.modifyCount)
+        .slice(0, 10),
+    };
+  }
+
+  function deriveTimePatterns(commits) {
+    const weekdayDistribution = new Array(7).fill(0);
+    const weekdayByAuthor = Array.from({ length: 7 }, createTimeAuthorSlot);
+    const dateSet = new Set();
+    let weekendCommits = 0;
+
+    commits.forEach(commit => {
+      const date = new Date(commit.date);
+      const index = (date.getDay() + 6) % 7;
+      weekdayDistribution[index]++;
+      addTimeAuthor(weekdayByAuthor[index], commit.author || 'Unknown');
+      dateSet.add(formatDateKeyLocal(commit.date));
+      if (index >= 5) weekendCommits++;
+    });
+
+    const days = [...dateSet].sort();
+    let longestStreak = 0;
+    let currentStreak = 0;
+    let previousTime = null;
+    days.forEach(day => {
+      const time = new Date(day).getTime();
+      currentStreak = previousTime !== null && time - previousTime === 86400000 ? currentStreak + 1 : 1;
+      longestStreak = Math.max(longestStreak, currentStreak);
+      previousTime = time;
+    });
+
+    const intervals = [...commits]
+      .sort((a, b) => new Date(a.date) - new Date(b.date))
+      .map(commit => new Date(commit.date).getTime());
+    const avgCommitInterval = intervals.length < 2
+      ? 0
+      : intervals.slice(1).reduce((sum, time, index) => sum + (time - intervals[index]), 0) / (intervals.length - 1);
+
+    return {
+      weekdayDistribution,
+      weekendCommits,
+      avgCommitInterval,
+      longestStreak,
+      currentStreak,
+      weekdayByAuthor,
+    };
+  }
+
+  function getWeekKey(dateValue) {
+    const date = new Date(dateValue);
+    const day = (date.getDay() + 6) % 7;
+    date.setDate(date.getDate() - day);
+    return formatDateKeyLocal(date);
+  }
+
+  function deriveTrends(commits) {
+    const weekly = new Map();
+    const daily = new Map();
+    [...commits].sort((a, b) => new Date(a.date) - new Date(b.date)).forEach(commit => {
+      const week = getWeekKey(commit.date);
+      const currentWeek = weekly.get(week) || { week, commits: 0, linesAdded: 0, linesDeleted: 0 };
+      currentWeek.commits++;
+      currentWeek.linesAdded += commit.linesAdded || 0;
+      currentWeek.linesDeleted += commit.linesDeleted || 0;
+      weekly.set(week, currentWeek);
+
+      const day = formatDateKeyLocal(commit.date);
+      daily.set(day, (daily.get(day) || 0) + (commit.linesAdded || 0) - (commit.linesDeleted || 0));
+    });
+
+    let netLines = 0;
+    const cumulativeLines = [...daily.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([date, delta]) => {
+      netLines += delta;
+      return { date, netLines };
+    });
+
+    return {
+      weeklyTrend: [...weekly.values()].sort((a, b) => a.week.localeCompare(b.week)),
+      cumulativeLines,
+    };
+  }
+
+  function deriveCollaboration(commits) {
+    const fileAuthors = new Map();
+    const fileCommits = new Map();
+    commits.forEach(commit => getCommitFiles(commit).forEach(file => {
+      if (!fileAuthors.has(file.path)) fileAuthors.set(file.path, new Set());
+      fileAuthors.get(file.path).add(commit.author || 'Unknown');
+      fileCommits.set(file.path, (fileCommits.get(file.path) || 0) + 1);
+    }));
+
+    const soloFiles = [];
+    const collaborationHotspots = [];
+    fileAuthors.forEach((authors, path) => {
+      if (authors.size === 1) {
+        soloFiles.push({ path, author: [...authors][0], commits: fileCommits.get(path) || 0 });
+      } else {
+        collaborationHotspots.push({ path, authorCount: authors.size, totalCommits: fileCommits.get(path) || 0 });
+      }
+    });
+
+    return {
+      soloFiles: soloFiles.sort((a, b) => b.commits - a.commits).slice(0, 20),
+      collaborationHotspots: collaborationHotspots.sort((a, b) => b.authorCount - a.authorCount).slice(0, 20),
+    };
+  }
+
+  function deriveMessageStats(commits) {
+    const typeDistribution = {};
+    let totalLength = 0;
+    commits.forEach(commit => {
+      const message = commit.message || '';
+      const match = message.match(/^([a-zA-Z]+)(\(.+\))?:/);
+      const type = match ? match[1].toLowerCase() : 'other';
+      typeDistribution[type] = (typeDistribution[type] || 0) + 1;
+      totalLength += message.length;
+    });
+
+    return {
+      typeDistribution,
+      avgMessageLength: commits.length ? totalLength / commits.length : 0,
+    };
+  }
+
+  function deriveAuthorFileTypeContributions(commits) {
+    const map = new Map();
+    commits.forEach(commit => getCommitFiles(commit).forEach(file => {
+      const extension = getFileExtension(file.path);
+      const key = `${commit.email || ''}::${extension}`;
+      const current = map.get(key) || {
+        author: commit.author || 'Unknown',
+        email: commit.email || '',
+        extension,
+        linesAdded: 0,
+        linesDeleted: 0,
+        commits: 0,
+        fileCount: 0,
+        commitHashes: new Set(),
+      };
+      current.linesAdded += file.added || 0;
+      current.linesDeleted += file.deleted || 0;
+      current.fileCount++;
+      current.commitHashes.add(commit.hash);
+      current.commits = current.commitHashes.size;
+      map.set(key, current);
+    }));
+
+    return [...map.values()]
+      .map(({ commitHashes, ...item }) => item)
+      .sort((a, b) => b.linesAdded - a.linesAdded);
+  }
+

package/templates/report-scripts/00-report-controls.html

@@ -0,0 +1,272 @@
+  function setupReportControls() {
+    populateGlobalFilters();
+    applyReportHash();
+
+    const authorFilter = document.getElementById('global-author-filter');
+    const directoryFilter = document.getElementById('global-directory-filter');
+    const resetButton = document.getElementById('global-filter-reset');
+    const jsonButton = document.getElementById('export-json');
+    const csvButton = document.getElementById('export-csv');
+
+    authorFilter?.addEventListener('change', () => {
+      reportState.author = authorFilter.value;
+      applyReportFilters();
+    });
+    directoryFilter?.addEventListener('change', () => {
+      reportState.directory = directoryFilter.value;
+      applyReportFilters();
+    });
+    resetButton?.addEventListener('click', () => {
+      reportState.author = '';
+      reportState.directory = '';
+      if (authorFilter) authorFilter.value = '';
+      if (directoryFilter) directoryFilter.value = '';
+      applyReportFilters();
+    });
+    jsonButton?.addEventListener('click', exportReportJson);
+    csvButton?.addEventListener('click', exportReportCsv);
+
+    reportState.hashReady = true;
+  }
+
+  function populateGlobalFilters() {
+    const authorFilter = document.getElementById('global-author-filter');
+    const directoryFilter = document.getElementById('global-directory-filter');
+    const commits = baseStats.commitDetails || [];
+    if (!authorFilter || !directoryFilter) return;
+
+    const authors = new Map();
+    const directories = new Set();
+    commits.forEach(commit => {
+      const email = String(commit.email || '').toLowerCase();
+      if (email && !authors.has(email)) authors.set(email, `${commit.author} <${commit.email}>`);
+      getCommitFiles(commit).forEach(file => directories.add(getPathDirectory(file.path)));
+    });
+
+    authorFilter.innerHTML = '<option value="">全部作者</option>' +
+      [...authors.entries()]
+        .sort((a, b) => a[1].localeCompare(b[1]))
+        .map(([email, label]) => `<option value="${escapeHtml(email)}">${escapeHtml(label)}</option>`)
+        .join('');
+    directoryFilter.innerHTML = '<option value="">全部目录</option>' +
+      [...directories]
+        .sort((a, b) => a.localeCompare(b))
+        .map(directory => `<option value="${escapeHtml(directory)}">${escapeHtml(directory === '(根目录)' ? '根目录' : directory)}</option>`)
+        .join('');
+  }
+
+  function applyReportHash() {
+    const params = new URLSearchParams(window.location.hash.replace(/^#/, ''));
+    const author = params.get('author') || '';
+    const directory = params.get('dir') || '';
+    const group = params.get('group') || reportState.advancedGroup;
+    const tab = params.get('tab') || reportState.advancedTab;
+
+    reportState.author = author;
+    reportState.directory = directory;
+    reportState.advancedGroup = group;
+    reportState.advancedTab = tab;
+
+    const authorFilter = document.getElementById('global-author-filter');
+    const directoryFilter = document.getElementById('global-directory-filter');
+    if (authorFilter) authorFilter.value = author;
+    if (directoryFilter) directoryFilter.value = directory;
+    stats = buildFilteredStats();
+  }
+
+  function applyReportFilters() {
+    stats = buildFilteredStats();
+    detailFiltersReady = false;
+    detailCurrentPage = 1;
+    detailExpandedCommits.clear();
+    updateReportHash();
+    renderAll();
+  }
+
+  function updateReportHash() {
+    if (!reportState.hashReady) return;
+
+    const params = new URLSearchParams();
+    if (reportState.advancedGroup) params.set('group', reportState.advancedGroup);
+    if (reportState.advancedTab) params.set('tab', reportState.advancedTab);
+    if (reportState.author) params.set('author', reportState.author);
+    if (reportState.directory) params.set('dir', reportState.directory);
+
+    const nextHash = params.toString();
+    if (window.location.hash.replace(/^#/, '') !== nextHash) {
+      window.history.replaceState(null, '', nextHash ? `#${nextHash}` : window.location.pathname + window.location.search);
+    }
+  }
+
+  function renderGlobalFilterMeta() {
+    const el = document.getElementById('global-filter-meta');
+    if (!el) return;
+
+    const total = baseStats.commitDetails?.length || 0;
+    const current = stats.commitDetails?.length || 0;
+    const active = [];
+    if (reportState.author) active.push('作者');
+    if (reportState.directory) active.push('目录');
+    el.textContent = active.length
+      ? `${active.join(' + ')}筛选：${formatNumber(current)} / ${formatNumber(total)} 次提交`
+      : `全量：${formatNumber(total)} 次提交`;
+  }
+
+  function renderHealthSummary() {
+    const gradeEl = document.getElementById('health-summary-grade');
+    if (!gradeEl) return;
+
+    const result = buildHealthSummary();
+    const gradeColor = result.score >= 80 ? 'text-emerald-500' :
+      result.score >= 60 ? 'text-amber-500' : 'text-rose-500';
+    const highlights = result.highlights.length ? result.highlights : ['当前筛选范围内没有明显异常信号'];
+    const risks = result.risks.length ? result.risks : ['未发现需要立即处理的高风险项'];
+
+    gradeEl.className = `text-5xl font-bold ${gradeColor}`;
+    gradeEl.textContent = result.grade;
+    document.getElementById('health-summary-score').textContent = `${result.score} / 100`;
+    document.getElementById('health-summary-label').textContent = result.label;
+    document.getElementById('health-summary-highlights').innerHTML = highlights
+      .slice(0, 4)
+      .map(item => `<li class="flex gap-2"><span class="mt-1 h-1.5 w-1.5 rounded-full bg-emerald-500 shrink-0"></span><span>${escapeHtml(item)}</span></li>`)
+      .join('');
+    document.getElementById('health-summary-risks').innerHTML = risks
+      .slice(0, 4)
+      .map(item => `<li class="flex gap-2"><span class="mt-1 h-1.5 w-1.5 rounded-full bg-rose-500 shrink-0"></span><span>${escapeHtml(item)}</span></li>`)
+      .join('');
+  }
+
+  function buildHealthSummary() {
+    let score = 100;
+    const highlights = [];
+    const risks = [];
+
+    if (stats.teamHealth) {
+      if (stats.teamHealth.riskLevel === 'high') {
+        score -= 18;
+        risks.push(`Bus Factor 为 ${stats.teamHealth.busFactor}，关键人员依赖偏高`);
+      } else if (stats.teamHealth.riskLevel === 'medium') {
+        score -= 8;
+        risks.push(`Bus Factor 为 ${stats.teamHealth.busFactor}，建议分散关键模块知识`);
+      } else {
+        highlights.push(`Bus Factor 为 ${stats.teamHealth.busFactor}，知识分布相对稳健`);
+      }
+    }
+
+    if (stats.stability) {
+      if (stats.stability.stabilityScore < 60) {
+        score -= 18;
+        risks.push(`稳定性评分 ${stats.stability.stabilityScore.toFixed(0)}，变更反复程度偏高`);
+      } else if (stats.stability.stabilityScore >= 80) {
+        highlights.push(`稳定性评分 ${stats.stability.stabilityScore.toFixed(0)}，代码变更较平稳`);
+      }
+    }
+
+    if (stats.workPressure) {
+      if (stats.workPressure.pressureScore >= 60) {
+        score -= 14;
+        risks.push(`非工作时间提交占比 ${(stats.workPressure.offHoursRate * 100).toFixed(1)}%，交付压力偏高`);
+      } else if (stats.workPressure.pressureScore < 30) {
+        highlights.push('非工作时间提交占比较低，节奏健康');
+      }
+    }
+
+    if (stats.contributorChurn) {
+      if (stats.contributorChurn.churnRate > 0.3) {
+        score -= 12;
+        risks.push(`贡献者流失率 ${(stats.contributorChurn.churnRate * 100).toFixed(1)}%，需要关注交接`);
+      } else if (stats.contributorChurn.retentionRate >= 0.7) {
+        highlights.push(`贡献者留存率 ${(stats.contributorChurn.retentionRate * 100).toFixed(1)}%，团队连续性较好`);
+      }
+    }
+
+    if (stats.quality) {
+      if (stats.quality.churnRate > 0.5) {
+        score -= 10;
+        risks.push(`代码流失率 ${(stats.quality.churnRate * 100).toFixed(1)}%，可能存在反复返工`);
+      }
+      if (stats.quality.avgFilesPerCommit <= 6 && stats.quality.avgLinesPerCommit <= 300) {
+        highlights.push('平均提交尺寸较克制，便于 Review');
+      }
+    }
+
+    const xlBucket = stats.changeSizeDistribution?.buckets?.find(bucket => bucket.label === 'XL');
+    if (xlBucket && xlBucket.count > 0) {
+      score -= Math.min(12, xlBucket.count * 3);
+      risks.push(`存在 ${xlBucket.count} 个 XL 大提交，建议拆分评审`);
+    }
+
+    const aiRisk = stats.aiQualityRisk?.summary?.highAIHighChurn || 0;
+    if (aiRisk > 0) {
+      score -= Math.min(12, aiRisk * 3);
+      risks.push(`${aiRisk} 个文件处于高 AI + 高 Churn 区间，需要加强人审`);
+    }
+
+    score = Math.max(0, Math.min(100, Math.round(score)));
+    const grade = score >= 85 ? 'A' : score >= 70 ? 'B' : score >= 55 ? 'C' : 'D';
+    const label = score >= 85 ? '整体健康' : score >= 70 ? '基本稳定' : score >= 55 ? '存在隐患' : '需要治理';
+
+    return { score, grade, label, highlights, risks };
+  }
+
+  function exportReportJson() {
+    downloadTextFile(
+      'commit-report.json',
+      'application/json;charset=utf-8',
+      JSON.stringify({ ...DATA, stats }, null, 2)
+    );
+  }
+
+  function exportReportCsv() {
+    const rows = [
+      ['repo', 'hash', 'author', 'email', 'date', 'message', 'files', 'linesAdded', 'linesDeleted'],
+      ...(stats.commitDetails || []).map(commit => [
+        commit.repoName || '',
+        commit.hash || '',
+        commit.author || '',
+        commit.email || '',
+        new Date(commit.date).toISOString(),
+        commit.message || '',
+        getCommitFiles(commit).map(file => file.path).join(';'),
+        commit.linesAdded || 0,
+        commit.linesDeleted || 0,
+      ]),
+    ];
+
+    downloadTextFile('commit-report.csv', 'text/csv;charset=utf-8', rows.map(row => row.map(csvEscape).join(',')).join('\n'));
+  }
+
+  function csvEscape(value) {
+    const text = String(value ?? '');
+    return /[",\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+  }
+
+  function downloadTextFile(filename, mimeType, content) {
+    const blob = new Blob([content], { type: mimeType });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.href = url;
+    link.download = filename;
+    document.body.appendChild(link);
+    link.click();
+    link.remove();
+    URL.revokeObjectURL(url);
+  }
+
+  function renderSingleRepoOnlyEmptyState(title, description = '该分析依赖单仓库的文件历史、blame 或跨文件关系。') {
+    const repoCount = DATA.repos?.length || 0;
+    const hint = repoCount > 1
+      ? `当前报告包含 ${repoCount} 个仓库。请重新选择单个仓库生成报告，必要时用 --depth 缩小扫描范围。`
+      : '请确认目标目录是单个 Git 仓库，并重新生成报告。';
+
+    return `
+      <div class="text-center py-12 text-slate-500 dark:text-slate-400">
+        <p class="text-lg mb-2">${escapeHtml(title)}</p>
+        <p class="text-sm mb-3">${escapeHtml(description)}</p>
+        <p class="text-xs text-slate-400 dark:text-slate-500">${escapeHtml(hint)}</p>
+      </div>
+    `;
+  }
+
+  // ============================================================
+  // 渲染入口