html-report
能力
生成单个自包含 .html 文件,内嵌:
- ECharts 图表(CDN 引入,无需本地依赖)——饼图、柱状图、趋势线、热力图、桑基图等
- 结构化表格
- 摘要卡片
- 中文标签、图例、tooltip
文件通过 write_file 保存到 session outputs,前端编辑器通过 sandboxed iframe 直接预览,不污染主页面。
适用场景
| 场景 | 图表类型建议 |
|---|---|
| 代码审核报告 | 饼图(严重度分布)+ 柱状图(文件维度)+ 表格 |
| 缺陷分布分析 | 热力图(模块×阶段)+ 桑基图(Bug → Root Cause) |
| 审核效果看板 | 趋势线(历月)+ 对比柱(改进前后) |
| ASPICE 追溯 | 矩阵 + 桑基图(需求 → 测试) |
| 覆盖率报告 | 环形图 + 堆叠柱 + 分组表格 |
生成方式
两步走,第二步是硬卡点:
Rendering diagram…
为什么第 2 步必不可少:复杂 dashboard 极易写错括号,错一个
}整段<script>直接抛 SyntaxError,前端打开后所有 chart 容器空白——但 HTML 文件本身有内容,仅凭文件大小或目测都看不出问题。
触发方式
自然语言示例:
- "画个缺陷严重度的饼图"
- "生成审核效果看板"
- "HTML 报告,带图表"
输出特性
| 特性 | 说明 |
|---|---|
| 自包含 | 一个 .html 搞定,ECharts 走 CDN |
| 离线可用 | 客户现场无网也能展示(CDN 失败自动回退内嵌) |
| 安全隔离 | 前端用 sandboxed iframe 渲染 |
| 响应式 | 自适应桌面/大屏 |
真实案例
ASPICE 工程闭环演示的 4 份可视化看板全部由 html-report 产出:
A-aspice-traceability-dashboard.htmlB-change-impact-dashboard.htmlC-test-coverage.htmlD-coverage-dashboard.html
详见 ASPICE 案例交付物清单。
相关文档
- document-editing — 生成 Docx 版报告
- xlsx — 生成 Excel 版数据透视