@hecom/codearts 0.3.2 → 0.4.1

package/README.md

@@ -31,7 +31,7 @@ npx @hecom/codearts bug-rate "迭代1,迭代2"
 ### 3. 更新配置
 
 ```bash
-# 更新全局配置
+# 更新配置文件
 npx @hecom/codearts config
 
 # 单独更新角色配置

package/dist/bin/cli.js

@@ -40,6 +40,8 @@ const path = __importStar(require("path"));
 const bug_command_1 = require("../commands/bug.command");
 const config_command_1 = require("../commands/config.command");
 const daily_command_1 = require("../commands/daily.command");
+const fix_command_1 = require("../commands/fix.command");
+const rebug_command_1 = require("../commands/rebug.command");
 const work_hour_command_1 = require("../commands/work-hour.command");
 const config_loader_1 = require("../utils/config-loader");
 const console_1 = require("../utils/console");
@@ -57,7 +59,7 @@ program
 // config 命令 - 交互式配置向导
 const configCmd = program
     .command('config')
-    .description('交互式配置向导，引导用户创建或更新全局配置文件')
+    .description('交互式配置向导，引导用户创建或更新配置文件')
     .action(async () => {
     (0, console_1.showLogo)();
     await (0, config_command_1.configCommand)();
@@ -85,7 +87,7 @@ availableConfigs.forEach((configItem) => {
 // daily 命令
 program
     .command('daily [date]')
-    .description('每日工时统计（默认日期为当天）')
+    .description('每日工时统计（默认日期为当天），日期格式：YYYY-MM-DD')
     .option('-r, --report', '显示总结报告', false)
     .action(async (date, options, command) => {
     const cliOptions = { ...command.parent.opts(), report: options.report };
@@ -95,7 +97,7 @@ program
 // work-hour 命令
 program
     .command('work-hour [year]')
-    .description('年度工时统计（默认当前年份）')
+    .description('年度工时统计（默认当前年份），年份格式：YYYY')
     .action(async (year, options, command) => {
     const cliOptions = command.parent.opts();
     logger_1.logger.setOutputFormat(cliOptions.output);
@@ -110,13 +112,32 @@ program
     logger_1.logger.setOutputFormat(cliOptions.output);
     await (0, bug_command_1.bugCommand)(cliOptions);
 });
+// fix 命令
+program
+    .command('fix')
+    .description('交互式修复 bug，填写相关信息')
+    .action(async (options, command) => {
+    const cliOptions = command.parent.opts();
+    logger_1.logger.setOutputFormat(cliOptions.output);
+    await (0, fix_command_1.fixCommand)(cliOptions);
+});
+// rebug 命令
+program
+    .command('rebug')
+    .description('Bug 列表交互式查询与多维度可视化分析')
+    .option('--output-dir <path>', '输出 HTML 报告的目录（默认输出到系统 cache 目录，指定此参数则输出到当前目录）')
+    .action(async (options, command) => {
+    const cliOptions = { ...command.parent.opts(), outputDir: options.outputDir };
+    logger_1.logger.setOutputFormat(cliOptions.output);
+    await (0, rebug_command_1.rebugCommand)(cliOptions);
+});
 // 检查配置并自动执行 config 命令
 async function checkConfigAndRun() {
     const args = process.argv.slice(2);
     // 如果没有参数（直接执行 codearts），检测配置
     if (args.length === 0) {
         (0, console_1.showLogo)();
-        // 检查是否有全局配置
+        // 检查是否有配置文件
         const hasConfig = (0, config_loader_1.configExists)();
         if (!hasConfig) {
             // 没有配置，自动执行 config 命令

package/dist/charts/chart.interface.d.ts

@@ -0,0 +1,5 @@
+import { IssueItem } from '../types';
+export interface ChartModule {
+    title: string;
+    buildOption(bugs: IssueItem[]): object;
+}

package/dist/charts/chart.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/charts/index.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from './chart.interface';
+export declare const allCharts: ChartModule[];

package/dist/charts/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allCharts = void 0;
+const bug_by_assignee_1 = require("./modules/bug-by-assignee");
+const bug_by_defect_analysis_1 = require("./modules/bug-by-defect-analysis");
+const bug_by_module_1 = require("./modules/bug-by-module");
+const bug_by_fix_duration_1 = require("./modules/bug-by-fix-duration");
+const bug_by_developer_hours_1 = require("./modules/bug-by-developer-hours");
+const bug_open_priority_heatmap_1 = require("./modules/bug-open-priority-heatmap");
+exports.allCharts = [
+    bug_by_defect_analysis_1.bugByDefectAnalysisChart,
+    bug_by_assignee_1.bugByAssigneeChart,
+    bug_by_module_1.bugByModuleChart,
+    bug_by_fix_duration_1.bugByFixDurationChart,
+    bug_by_developer_hours_1.bugByDeveloperHoursChart,
+    bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart,
+];

package/dist/charts/modules/__tests__/bug-by-developer-hours.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/charts/modules/__tests__/bug-by-developer-hours.test.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bug_by_developer_hours_1 = require("../bug-by-developer-hours");
+function makeIssue(nickName, hours) {
+    return {
+        developer: {
+            id: 1,
+            name: '',
+            nick_name: nickName,
+            user_id: '',
+            user_num_id: 1,
+            first_name: '',
+        },
+        actual_work_hours: hours,
+        new_custom_fields: [],
+        deleted: false,
+    };
+}
+describe('bugByDeveloperHoursChart', () => {
+    it('标题应为"开发人员工时消耗"', () => {
+        expect(bug_by_developer_hours_1.bugByDeveloperHoursChart.title).toBe('开发人员工时消耗');
+    });
+    it('按开发人员汇总工时并降序排列', () => {
+        const bugs = [makeIssue('张三', 3), makeIssue('李四', 5), makeIssue('张三', 1)];
+        const option = bug_by_developer_hours_1.bugByDeveloperHoursChart.buildOption(bugs);
+        const names = option.yAxis.data;
+        const values = option.series[0].data;
+        expect(names[0]).toBe('李四');
+        expect(values[0]).toBe(5);
+        expect(names[1]).toBe('张三');
+        expect(values[1]).toBe(4);
+    });
+    it('过滤掉 nick_name 为空的条目', () => {
+        const bugs = [makeIssue('', 4), makeIssue('王五', 2)];
+        const option = bug_by_developer_hours_1.bugByDeveloperHoursChart.buildOption(bugs);
+        const names = option.yAxis.data;
+        expect(names).not.toContain('');
+        expect(names).toContain('王五');
+    });
+    it('过滤掉 developer 未设置的条目', () => {
+        const bugs = [
+            { ...makeIssue('赵六', 3), developer: null },
+            makeIssue('赵六', 1),
+        ];
+        const option = bug_by_developer_hours_1.bugByDeveloperHoursChart.buildOption(bugs);
+        const values = option.series[0].data;
+        expect(values[0]).toBe(1);
+    });
+    it('空数组时返回空图表', () => {
+        const option = bug_by_developer_hours_1.bugByDeveloperHoursChart.buildOption([]);
+        expect(option.yAxis.data).toHaveLength(0);
+        expect(option.series[0].data).toHaveLength(0);
+    });
+});

package/dist/charts/modules/__tests__/bug-by-fix-duration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/charts/modules/__tests__/bug-by-fix-duration.test.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bug_by_fix_duration_1 = require("../bug-by-fix-duration");
+function makeIssue(overrides) {
+    return {
+        actual_work_hours: 0,
+        assigned_cc_user: [],
+        assigned_user: {
+            id: 1,
+            name: '',
+            nick_name: '测试人',
+            user_id: '',
+            user_num_id: 1,
+            first_name: '',
+        },
+        begin_time: '',
+        closed_time: '',
+        created_time: '2026-03-01T08:00:00Z',
+        creator: { id: 1, name: '', nick_name: '', user_id: '', user_num_id: 1, first_name: '' },
+        custom_fields: [],
+        developer: {
+            id: 1,
+            name: '',
+            nick_name: '开发人',
+            user_id: '',
+            user_num_id: 1,
+            first_name: '',
+        },
+        domain: { id: 1, name: '' },
+        done_ratio: 0,
+        end_time: '',
+        expected_work_hours: 0,
+        id: 1,
+        iteration: { id: 1, name: '' },
+        module: { id: 1, name: '' },
+        name: 'test bug',
+        new_custom_fields: [],
+        parent_issue: { id: 0, name: '' },
+        priority: { id: 1, name: '中' },
+        project: { project_id: '', project_name: '', project_num_id: 1 },
+        severity: { id: 1, name: '重要' },
+        status: { id: 5, name: '已关闭' },
+        tracker: { id: 3, name: 'Bug' },
+        updated_time: '',
+        deleted: false,
+        ...overrides,
+    };
+}
+describe('bugByFixDurationChart', () => {
+    it('标题应为"修复周期分布"', () => {
+        expect(bug_by_fix_duration_1.bugByFixDurationChart.title).toBe('修复周期分布');
+    });
+    it('closed_time 为空时归入"未关闭"桶', () => {
+        const bugs = [makeIssue({ closed_time: '' })];
+        const option = bug_by_fix_duration_1.bugByFixDurationChart.buildOption(bugs);
+        const data = option.series[0].data;
+        const categories = option.xAxis.data;
+        const idx = categories.indexOf('未关闭');
+        expect(idx).toBeGreaterThanOrEqual(0);
+        expect(data[idx]).toBe(1);
+    });
+    it('1天内关闭归入"≤1天"桶（ceil，间隔0.5天）', () => {
+        const created = '2026-03-01T08:00:00Z';
+        const closed = '2026-03-01T20:00:00Z'; // 12h → Math.ceil(0.5) = 1
+        const bugs = [makeIssue({ created_time: created, closed_time: closed })];
+        const option = bug_by_fix_duration_1.bugByFixDurationChart.buildOption(bugs);
+        const data = option.series[0].data;
+        const categories = option.xAxis.data;
+        const idx = categories.indexOf('≤1天');
+        expect(idx).toBeGreaterThanOrEqual(0);
+        expect(data[idx]).toBe(1);
+    });
+    it('3天关闭归入"2-3天"桶', () => {
+        const created = '2026-03-01T00:00:00Z';
+        const closed = '2026-03-04T00:00:00Z'; // 3天整
+        const bugs = [makeIssue({ created_time: created, closed_time: closed })];
+        const option = bug_by_fix_duration_1.bugByFixDurationChart.buildOption(bugs);
+        const data = option.series[0].data;
+        const categories = option.xAxis.data;
+        const idx = categories.indexOf('2-3天');
+        expect(idx).toBeGreaterThanOrEqual(0);
+        expect(data[idx]).toBe(1);
+    });
+    it('空数组时所有桶数量均为0', () => {
+        const option = bug_by_fix_duration_1.bugByFixDurationChart.buildOption([]);
+        const data = option.series[0].data;
+        expect(data.every((v) => v === 0)).toBe(true);
+    });
+});

package/dist/charts/modules/__tests__/bug-open-priority-heatmap.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/charts/modules/__tests__/bug-open-priority-heatmap.test.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bug_open_priority_heatmap_1 = require("../bug-open-priority-heatmap");
+function makeIssue(assignee, severityName, statusName, deleted = false) {
+    return {
+        assigned_user: {
+            id: 1,
+            name: '',
+            nick_name: assignee,
+            user_id: '',
+            user_num_id: 1,
+            first_name: '',
+        },
+        severity: { id: 1, name: severityName },
+        status: { id: 5, name: statusName },
+        deleted,
+        new_custom_fields: [],
+    };
+}
+describe('bugOpenPriorityHeatmapChart', () => {
+    it('标题应为"未关闭 Bug 优先级分布"', () => {
+        expect(bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart.title).toBe('未关闭 Bug 优先级分布');
+    });
+    it('过滤掉已关闭的 bug', () => {
+        const bugs = [
+            makeIssue('张三', '重要', '已关闭'),
+            makeIssue('张三', '严重', '进行中'),
+        ];
+        const option = bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart.buildOption(bugs);
+        const seriesData = option.series[0].data;
+        const total = seriesData.reduce((sum, d) => sum + d[2], 0);
+        expect(total).toBe(1);
+    });
+    it('过滤掉 deleted=true 的 bug', () => {
+        const bugs = [
+            makeIssue('张三', '重要', '进行中', true),
+            makeIssue('李四', '一般', '新问题', false),
+        ];
+        const option = bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart.buildOption(bugs);
+        const seriesData = option.series[0].data;
+        const total = seriesData.reduce((sum, d) => sum + d[2], 0);
+        expect(total).toBe(1);
+    });
+    it('X 轴严重程度按 一般→重要→严重 顺序排列', () => {
+        const bugs = [];
+        const option = bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart.buildOption(bugs);
+        const xData = option.xAxis.data;
+        expect(xData.indexOf('一般')).toBeLessThan(xData.indexOf('重要'));
+        expect(xData.indexOf('重要')).toBeLessThan(xData.indexOf('严重'));
+    });
+    it('visualMap max 至少为 1（防止空数据时 min===max===0）', () => {
+        const option = bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart.buildOption([]);
+        expect(option.visualMap.max).toBeGreaterThanOrEqual(1);
+    });
+    it('未知 severity 值放 X 轴末尾', () => {
+        const bugs = [makeIssue('张三', '未知等级', '进行中')];
+        const option = bug_open_priority_heatmap_1.bugOpenPriorityHeatmapChart.buildOption(bugs);
+        const xData = option.xAxis.data;
+        expect(xData[xData.length - 1]).toBe('未知等级');
+    });
+});

package/dist/charts/modules/bug-by-assignee.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from '../chart.interface';
+export declare const bugByAssigneeChart: ChartModule;

package/dist/charts/modules/bug-by-assignee.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugByAssigneeChart = void 0;
+exports.bugByAssigneeChart = {
+    title: '修复人 Bug 数量',
+    buildOption(bugs) {
+        const countMap = new Map();
+        bugs.forEach((bug) => {
+            const name = bug.developer?.nick_name || '未设置';
+            countMap.set(name, (countMap.get(name) || 0) + 1);
+        });
+        const sorted = Array.from(countMap.entries()).sort((a, b) => b[1] - a[1]);
+        const names = sorted.map(([name]) => name);
+        const values = sorted.map(([, value]) => value);
+        return {
+            tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
+            grid: { left: '3%', right: '8%', bottom: '3%', containLabel: true },
+            xAxis: { type: 'value' },
+            yAxis: { type: 'category', data: names, inverse: true },
+            series: [
+                {
+                    type: 'bar',
+                    data: values,
+                    label: { show: true, position: 'right' },
+                    itemStyle: { color: '#5470c6' },
+                },
+            ],
+        };
+    },
+};

package/dist/charts/modules/bug-by-defect-analysis.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from '../chart.interface';
+export declare const bugByDefectAnalysisChart: ChartModule;

package/dist/charts/modules/bug-by-defect-analysis.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugByDefectAnalysisChart = void 0;
+exports.bugByDefectAnalysisChart = {
+    title: '缺陷技术分析分布',
+    buildOption(bugs) {
+        const countMap = new Map();
+        bugs.forEach((bug) => {
+            const field = bug.new_custom_fields?.find((f) => f.custom_field === 'custom_field32');
+            const value = field?.value || '未填写';
+            countMap.set(value, (countMap.get(value) || 0) + 1);
+        });
+        const data = Array.from(countMap.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([name, value]) => ({ name, value }));
+        return {
+            tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' },
+            legend: { orient: 'vertical', left: 'left', type: 'scroll' },
+            series: [
+                {
+                    type: 'pie',
+                    radius: ['40%', '70%'],
+                    avoidLabelOverlap: true,
+                    label: { show: true, formatter: '{b}: {d}%' },
+                    data,
+                },
+            ],
+        };
+    },
+};

package/dist/charts/modules/bug-by-developer-hours.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from '../chart.interface';
+export declare const bugByDeveloperHoursChart: ChartModule;

package/dist/charts/modules/bug-by-developer-hours.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugByDeveloperHoursChart = void 0;
+exports.bugByDeveloperHoursChart = {
+    title: '开发人员工时消耗',
+    buildOption(bugs) {
+        const hoursMap = new Map();
+        bugs.forEach((bug) => {
+            const name = bug.developer?.nick_name;
+            if (!name || name === '未设置')
+                return;
+            hoursMap.set(name, (hoursMap.get(name) ?? 0) + (bug.actual_work_hours ?? 0));
+        });
+        const sorted = Array.from(hoursMap.entries()).sort((a, b) => b[1] - a[1]);
+        const names = sorted.map(([name]) => name);
+        const values = sorted.map(([, hours]) => hours);
+        return {
+            tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
+            grid: { left: '3%', right: '8%', bottom: '3%', containLabel: true },
+            xAxis: { type: 'value', name: '小时' },
+            yAxis: { type: 'category', data: names, inverse: true },
+            series: [
+                {
+                    type: 'bar',
+                    data: values,
+                    label: { show: true, position: 'right', formatter: '{c}h' },
+                    itemStyle: { color: '#ee6666' },
+                },
+            ],
+        };
+    },
+};

package/dist/charts/modules/bug-by-fix-duration.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from '../chart.interface';
+export declare const bugByFixDurationChart: ChartModule;

package/dist/charts/modules/bug-by-fix-duration.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugByFixDurationChart = void 0;
+const BUCKETS = ['未关闭', '≤1天', '2-3天', '4-7天', '8-14天', '>14天'];
+function getDurationBucket(created, closed) {
+    if (!closed)
+        return '未关闭';
+    const days = Math.ceil((new Date(closed).getTime() - new Date(created).getTime()) / (1000 * 60 * 60 * 24));
+    if (days <= 1)
+        return '≤1天';
+    if (days <= 3)
+        return '2-3天';
+    if (days <= 7)
+        return '4-7天';
+    if (days <= 14)
+        return '8-14天';
+    return '>14天';
+}
+exports.bugByFixDurationChart = {
+    title: '修复周期分布',
+    buildOption(bugs) {
+        const countMap = new Map(BUCKETS.map((b) => [b, 0]));
+        bugs.forEach((bug) => {
+            const bucket = getDurationBucket(bug.created_time, bug.closed_time);
+            countMap.set(bucket, (countMap.get(bucket) ?? 0) + 1);
+        });
+        const values = BUCKETS.map((b) => countMap.get(b) ?? 0);
+        return {
+            tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
+            grid: { left: '3%', right: '4%', bottom: '3%', containLabel: true },
+            xAxis: {
+                type: 'category',
+                data: [...BUCKETS],
+            },
+            yAxis: { type: 'value', minInterval: 1 },
+            series: [
+                {
+                    type: 'bar',
+                    data: values,
+                    label: { show: true, position: 'top' },
+                    itemStyle: { color: '#fac858' },
+                },
+            ],
+        };
+    },
+};

package/dist/charts/modules/bug-by-module.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from '../chart.interface';
+export declare const bugByModuleChart: ChartModule;

package/dist/charts/modules/bug-by-module.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugByModuleChart = void 0;
+exports.bugByModuleChart = {
+    title: '模块 Bug 分布',
+    buildOption(bugs) {
+        const countMap = new Map();
+        bugs.forEach((bug) => {
+            const name = bug.module?.name || '未分配模块';
+            countMap.set(name, (countMap.get(name) || 0) + 1);
+        });
+        const sorted = Array.from(countMap.entries()).sort((a, b) => b[1] - a[1]);
+        const names = sorted.map(([name]) => name);
+        const values = sorted.map(([, value]) => value);
+        return {
+            tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
+            grid: { left: '3%', right: '4%', bottom: '15%', containLabel: true },
+            xAxis: {
+                type: 'category',
+                data: names,
+                axisLabel: { rotate: 30, overflow: 'truncate', width: 80 },
+            },
+            yAxis: { type: 'value' },
+            series: [
+                {
+                    type: 'bar',
+                    data: values,
+                    label: { show: true, position: 'top' },
+                    itemStyle: { color: '#91cc75' },
+                },
+            ],
+        };
+    },
+};

package/dist/charts/modules/bug-open-priority-heatmap.d.ts

@@ -0,0 +1,2 @@
+import { ChartModule } from '../chart.interface';
+export declare const bugOpenPriorityHeatmapChart: ChartModule;

package/dist/charts/modules/bug-open-priority-heatmap.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugOpenPriorityHeatmapChart = void 0;
+const SEVERITY_ORDER = ['一般', '重要', '严重'];
+exports.bugOpenPriorityHeatmapChart = {
+    title: '未关闭 Bug 优先级分布',
+    buildOption(bugs) {
+        const openBugs = bugs.filter((b) => !b.deleted && b.status?.name !== '已关闭');
+        const unknownSeverities = [
+            ...new Set(openBugs.map((b) => b.severity?.name ?? '').filter((s) => s && !SEVERITY_ORDER.includes(s))),
+        ];
+        const xCategories = [...SEVERITY_ORDER, ...unknownSeverities];
+        const assigneeCounts = new Map();
+        openBugs.forEach((b) => {
+            const name = b.assigned_user?.nick_name ?? '未分配';
+            assigneeCounts.set(name, (assigneeCounts.get(name) ?? 0) + 1);
+        });
+        const yCategories = Array.from(assigneeCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([name]) => name);
+        const heatMap = new Map();
+        openBugs.forEach((b) => {
+            const xKey = b.severity?.name ?? '';
+            const yKey = b.assigned_user?.nick_name ?? '未分配';
+            const key = `${xKey}|${yKey}`;
+            heatMap.set(key, (heatMap.get(key) ?? 0) + 1);
+        });
+        const data = [];
+        xCategories.forEach((x, xi) => {
+            yCategories.forEach((y, yi) => {
+                const v = heatMap.get(`${x}|${y}`) ?? 0;
+                data.push([xi, yi, v]);
+            });
+        });
+        const maxValue = data.reduce((max, d) => Math.max(max, d[2]), 0);
+        return {
+            tooltip: {
+                position: 'top',
+                formatter: (params) => `${yCategories[params.data[1]]} / ${xCategories[params.data[0]]}: ${params.data[2]} 个`,
+            },
+            grid: { left: '3%', right: '4%', bottom: '10%', containLabel: true },
+            xAxis: {
+                type: 'category',
+                data: xCategories,
+                splitArea: { show: true },
+            },
+            yAxis: {
+                type: 'category',
+                data: yCategories,
+                splitArea: { show: true },
+            },
+            visualMap: {
+                min: 0,
+                max: Math.max(1, maxValue),
+                calculable: true,
+                orient: 'horizontal',
+                left: 'center',
+                bottom: '0%',
+                inRange: { color: ['#ffffff', '#ee6666'] },
+            },
+            series: [
+                {
+                    type: 'heatmap',
+                    data,
+                    label: {
+                        show: true,
+                        formatter: (params) => params.data[2] > 0 ? String(params.data[2]) : '',
+                    },
+                    emphasis: { itemStyle: { shadowBlur: 10, shadowColor: 'rgba(0, 0, 0, 0.5)' } },
+                },
+            ],
+        };
+    },
+};

package/dist/charts/renderer.d.ts

@@ -0,0 +1,21 @@
+import { IssueItem } from '../types';
+import { ChartModule } from './chart.interface';
+export interface ReportMeta {
+    iterationNames: string[];
+    terminalTypes: string[];
+    totalCount: number;
+    generatedAt: string;
+}
+/**
+ * 生成 HTML 报告并写入文件，返回文件路径。
+ * @param bugs Bug 列表
+ * @param charts 图表模块列表
+ * @param meta 报告元数据
+ * @param outputDir 输出目录，若不指定则使用系统 cache 目录
+ * 若文件写入失败，将 HTML 内容通过 logger 输出作为兜底，然后抛出错误。
+ */
+export declare function renderReport(bugs: IssueItem[], charts: ChartModule[], meta: ReportMeta, outputDir?: string): string;
+/**
+ * 自动在系统默认浏览器中打开文件
+ */
+export declare function openInBrowser(filePath: string): void;