HTML 报告

HTML 报告

--html <file> 在终端输出之外生成一份自包含的 HTML 报告:单文件、无外部资源(无 CDN/字体/图片请求),可直接发消息、挂内网、存档。

git diffdim main feature --html report.html

报告结构

1. 总览瓷贴 — 总新增 / 总删除 / 总修改(行),0 值瓷贴不显示
2. 维度总览 — 代码 / 测试代码 / 其他非代码三行比例条,条长跨维度可比(同一比例尺);文件维度以计数徽章展示(单位不同,不与行数共用比例尺)
3. 按语言 — Go / Python / 测试各自的比例条
4. 文件明细 — 全部文件按变更行数降序:状态、路径、类别、+/−/~ 数字、迷你比例条

比例条分段有 2px 间隙,悬停显示数值,数字全部直标——不需要靠颜色也能读。

双主题

报告同时适配浅色/深色:跟随系统 prefers-color-scheme,也支持宿主页面通过 data-theme="dark|light" 强制指定。两套配色分别调校,不是简单反色。

配色依据(为什么"修改"是蓝色)

新增/删除沿用 git 惯例的绿/红;修改用蓝色(VS Code diff gutter 惯例)而不是常见的黄色——黄↔红在绿色盲(deutan)下的色差 ΔE 仅 1.5,基本不可分。

全部配色跑过色觉缺陷(CVD)模拟校验:

主题	新增	删除	修改	校验结果
浅色	#116329	#f05252	#0969da	全项通过(最差对 protan ΔE 9.6)
深色	#1c7833	#e5665c	#4493f8	protan ΔE 6.6,处于 6–8 允许区,以分段间隙+直标数字+表格视图作二次编码

对比度、明度带、色度下限均在校验范围内;色弱读者仍可通过直标数字与文件表格获得全部信息。