Chart.js 可视化报告生成器

具体问题

在数据分析中，我们常需要将 SQL 查询结果、CSV 摘要或 Python 字典/列表等结构化数据快速转化为可视化报告，以便直观展示趋势、对比或构成。但手动创建图表和报告往往耗时，且依赖复杂工具，尤其是当需要生成自包含、可直接分享的 HTML 文件时。

技能如何工作

Chart.js 可视化报告生成器通过自动化脚本解决这一问题。它接收结构化数据，根据数据类型和分析目的智能选择图表类型，生成包含 Chart.js 图表和 KPI 卡片的 HTML 报告。核心能力包括：

• 自动图表选型：基于分析目的（如占比、趋势、对比），推荐使用 doughnut、line、bar 等图表类型。
• KPI 卡片生成：支持顶部展示关键指标，使用颜色编码（如 blue、green）。
• 自包含输出：生成的 HTML 文件通过 CDN 加载 Chart.js 4.4.0，无需本地安装，浏览器直接打开即可查看。

关键步骤：首先理解数据结构（如数值列、分类列），然后调用 generate_report.py 脚本，指定 kpis 列表（可选，用于 KPI 卡片）和 charts 列表（图表配置），最后输出到指定路径并预览。布局规则自动处理：KPI 卡片最多 4 列，图表默认 2 列网格，高度固定 240px。

适用边界与注意点

该技能适用于快速生成数据分析报告，尤其适合与 DuckDB 集成进行查询后可视化。但需注意：

• 报告固定为深色主题（背景色 #0f172a），适合截图展示但不支持自定义主题。
• Chart.js 版本锁定为 4.4.0，确保稳定性，但可能无法使用最新特性。
• 数据格式需符合规范：数值超过 1000 时自动格式化为千分位（如 ¥1,234,567），颜色序列内置无需手动指定。
• 布局限制：1 个图表全宽，3 个图表 3 列，表格（如 Top N 排名）单独一行全宽显示。报告页脚包含数据来源和生成时间说明。