Excel 统计图生成

解决的问题

当一份 .xlsx 或 .xls 文件里已经存在分类列、时间列、数值列，但手动配轴、选图表类型、清理列名仍然容易出错时，Excel 统计图生成会把「数据到图表」的流程收敛到一次预览和参数确认上。它适合快速把表格变成可汇报的静态图，或可交互的 HTML 图。

工作方式

核心是先用 scripts/generate_chart.py 的预览模式读取文件，输出 sheet 名称、前 5 行、列类型和数值列统计摘要。随后根据结构选择 X 轴、Y 轴、图表类型和输出格式：

• 柱状图 / 条形图：bar，适合分类与数值比较
• 折线图：line，适合时间趋势
• 饼图 / 环形图：pie，适合占比
• 散点图：scatter，适合两个数值变量关系
• 箱线图：box，适合分布和异常观察
• 热力图：heatmap，需要至少两个数值列

输出默认使用 html，基于 Plotly 生成交互文件；也可以选择 png，基于 Matplotlib 生成静态图片。脚本会解析日期字符串、识别数值和分类列、忽略空列，并对超过 1000 行的数据提示分批或采样。缺失值不会自动填充，适合先确认口径再生成图。

适用边界

它主要服务已有结构的 Excel 数据可视化，不替代复杂报表布局或商业智能仪表盘。如果字段含义不明确、多张 sheet 指标口径不一致，或需要精确配色、图例、坐标轴标题，需要人工先确认参数。