数据报表自动化生成器

概述

把一份原始数据（CSV/Excel）自动变成一份能交付的报表：汇总指标 + 分组统计 + 图表 + 结论，输出 HTML 或 Excel。核心价值是用脚本做确定性计算，避免每次重写代码、算错数。

触发场景

• 用户提供 CSV/Excel，要求"做份报表""汇总一下""分析一下"
• 接单做数据整理、周报月报、经营分析
• 需要把明细数据转成可视化汇报

工作流程（SOP）

第 1 步：确认输入与需求

缺失必问：

1. 数据文件路径（CSV/Excel，必填）
2. 分析目标：汇总统计 / 分组对比 / 趋势 / 占比
3. 关键指标列、分组维度列（有则提供，无则自动识别）
4. 输出形式：HTML（推荐，可图表）/ Excel / Markdown

第 2 步：探查数据

用 scripts/generate_report.py 或自行读表，先摸清：列名、数据类型、缺失值、异常值。发现数据问题先报告，不硬算。

第 3 步：计算与制图

• 汇总指标：计数、求和、均值、最大最小、中位数
• 分组统计：按指定维度做聚合
• 图表：柱状图/折线图/饼图（用 HTML 内嵌 SVG 或图表库）
• 结论：从数据里读出 3-5 条客观结论

第 4 步：生成报表并自检交付

调用脚本生成报表文件，按验收标准自检后再交付，并告诉用户文件路径。

自动执行 vs 必须询问

| 事项 | 处理方式 | | ---- | ---- | | 文件路径 / 分析目标 / 指标列 | 缺失时必须询问 | | 汇总计算、分组、图表、结论 | 自动执行（脚本做确定性计算） | | 数据是否可信 / 口径定义 | 与用户确认口径，不擅自改口径 |

错误处理

• 文件不存在 / 无法解析：停下来报错，不生成空报表。
• 列名对不上 / 数据类型错误：列出实际列名，让用户确认。
• 缺失值/异常值：在报表中标注"缺失 N 条"或"异常值"，不静默丢弃。

验收标准

• [ ] 汇总指标计算正确（抽查 1-2 个值）
• [ ] 分组统计与图表一致
• [ ] 报表含数据结论，非纯堆数字
• [ ] 数据问题已标注，无静默删数据
• [ ] 输出文件可正常打开

资源

• scripts/generate_report.py：确定性报表生成脚本（读 CSV/Excel → 汇总 + 分组 → 输出 HTML）
• assets/报表模板说明.md：报表结构与字段说明

脚本用法

python generate_report.py <数据文件> --out report.html [--group 分组列] [--metric 指标列]

脚本依赖 pandas，运行前若缺失需安装：pip install pandas openpyxl