周报数据图表生成器

为什么要做这个脚本

周报或月报配图往往卡在最后一步：打开 Excel 拖拽图表、调配色、导出 PNG，不仅耗时，放大后还经常发虚。weekly-kpi-chart-builder 试图把这条链路压缩成「给数据 → 拿 SVG + 结论句」。它不依赖任何前端绘图库，纯 Python 脚本直接产出矢量图，适合需要把图表嵌进在线文档或浏览器页面的场景。

脚本如何工作

• 输入结构：核心是一份包含标签与数值的 JSON。脚本支持从 stdin、参数文件或位置参数读入，编码上兼容 utf-8-sig 与 gbk。
• 图型推荐：通过 chart 字段指定 bar、line 或 hbar；设为 auto 时会根据数据形态自动推荐——时间序列优先折线，类目对比优先柱状，排名类目较多则用横向条形图。
• 结论句生成：脚本会计算首末值变化（环比）与极值，直接拼出类似「本周 GMV 较上周 +12.5%，峰值出现在周三」的文本，方便直接粘贴进汇报文档。
• 视觉细节：内置商务配色，自动标注数值标签，并支持可选的目标参考线。负值场景下纵轴会自动下探，兼容收支或增减类数据。

适用边界

• 数据校验：数据点少于 2 个无法成图；标签与数值数量不一致会直接报错并指出差异位置。
• 清洗规则：数值中包含非数字字符（如「约1500」）会自动剥离并在摘要中注明。
• 输出限制：单图仅支持单指标。SVG 可直接拖入浏览器使用；如需 PNG 需自行截图或通过本地 matplotlib 转换。