data-report · 数据可视化报告
把 CSV/Excel/JSON 数据生成完整可视化报告页的 skill：脚本自动计算 KPI、按数据类型选型出 2-4 张图，组装成含 KPI 卡片、图表、数据洞察与数据表的自包含 HTML，可离线打开。
KPI 与图表由脚本从真实数据算出，不手写数值。建议补写 3-5 条解读型洞察（趋势、异常、对比、行动建议）。可选渲染成一张长图用于社媒分享。
调用示例：在聊天框中说"把这份销售数据生成一份可视化报告"。
产品详解
定位
data-report 是结构化数据的可视化报告生成器：输入 CSV/Excel/JSON，输出一整页可视化报告（KPI 卡 + 多图 + 洞察 + 数据表）。数据解析、聚合、出图、HTML 组装全部由脚本确定性完成，它不做单张图表、不做信息图动画。
核心能力
- 一键成页：
scripts/report.py自动计算 KPI（数值列汇总）、按数据形态选型出 2-4 张图（时间序列→折线、类别→柱状、占比→饼图），拼成整页 HTML。 - 数据概览先行：
analyze输出行列数、列类型与缺失、数值列统计、类别列 Top 5，为写洞察提供真实依据。 - 自包含离线报告：图表以 base64 内嵌，一个 HTML 文件即可离线打开；matplotlib 中文无乱码。
- 洞察补写：基于真实概览补 3-5 条洞察（趋势、异常、对比、行动建议），只解读不捏造数字。
- 分享长图：可选把 HTML 渲染成 1080 宽长图用于社媒分享。
- Profile 配色：有 Profile 时可从
style.md读取品牌主色统一配色。 - 确定性原则：必须用脚本解析真实数据，KPI 与图表不手算、不手写数值；无数值列时仍输出数据表。
工作流程
- 读数据概览：
report.py analyze <数据文件>，判断数据讲了什么 - 生成报告 HTML：
report.py report（可指定标题与 KPI 列） - 补写洞察（可选但推荐）：在洞察区插入 3-5 条解读，不捏造数字
- 渲染成长图分享（可选）
输入与输出
| 输入 | 说明 |
|---|---|
| 数据文件 | .csv / .json / .xlsx（Excel 需 openpyxl，缺失时脚本会提示） |
| 报告标题 | 可选 |
| KPI 列名 | 可选，不给则自动挑数值列 |
输出：自包含 HTML 报告文件（写入 outputs/），可选 PNG 长图。
与相邻 skill 的区别
- chart-visualization：调 AntV 远程 API，产出单张静态图片 URL；只要一张标准统计图、直接拿图片链接时用它。
- infographic：本地 JS 渲染，产出结构化信息图 / GIF 动画图表。
- data-report（本）：输入数据文件，产出一整页可视化报告。
适用场景
- 业务周报/月报的数据页制作
- 市场与运营人员做投放效果、KPI 复盘报告
- 把原始数据转成可转发分享的可视化报告
- 分析人员快速验证数据形态并沉淀洞察
使用前准备
- 无需 API key，纯本地计算与出图。
- Excel 输入需环境安装 openpyxl（缺失时脚本会提示）。
- 准确性前提：输入数据真实；无数值列时脚本仍出数据表（打印 WARN），报告依然可用。
data-report 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。