haomingz Infographic Builder
从 JSON 数据生成自包含的 HTML/SVG 信息图，支持四种类型：
- 统计卡片（stats） — KPI 大数字 + 趋势箭头 + 图标
- 数据对比（comparison） — 分组柱状图，支持多系列
- 流程图（flow） — 步骤流程，带编号、图标和箭头连接
- 仪表盘（dashboard） — 混合布局：统计卡片 + 柱状图 + 环形图 + 流程
输出为 完全自包含 的 HTML 文件（CSS/SVG 全部内联，无外部依赖），可直接在浏览器打开。
使用方式
基础用法
python3 scripts/build_infographic.py config.json
也支持从 stdin 读取：
cat config.json | python3 scripts/build_infographic.py
脚本输出 JSON 状态到 stdout，生成的 HTML 写入 output 字段指定的路径。
JSON 配置格式
通用字段：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
title |
string | 否 | 信息图标题 |
subtitle |
string | 否 | 副标题 |
type |
string | 是 | stats / comparison / flow / dashboard |
palette |
string | 否 | 配色方案（默认 auto） |
data |
object/array | 是 | 数据内容（格式取决于 type） |
output |
string | 否 | 输出文件路径（默认 infographic.html） |
footer |
string | 否 | 页脚文字 |
配色方案
可选值：auto（根据数据自动选择）、ocean、sunset、forest、berry、vibrant、corporate、pastel、earth
各类型 data 格式
1. stats — 统计卡片
{
"type": "stats",
"data": [
{
"label": "总收入",
"value": "¥1.2M",
"icon": "money",
"trend": "+12.5%",
"trend_dir": "up"
},
{
"label": "用户数",
"value": "45,230",
"icon": "users",
"trend": "+8.2%",
"trend_dir": "up"
}
]
}
icon 可选值：users、user、money、percent、globe、clock、check、star、target、zap、chart-bar、chart-pie、database、rocket、shield、heart、light、search、mail、settings、flag、trending-up、trending-down
trend_dir：up（绿色上升箭头）或 down（红色下降箭头）
2. comparison — 数据对比柱状图
{
"type": "comparison",
"data": {
"chart_title": "季度营收对比",
"categories": ["Q1", "Q2", "Q3", "Q4"],
"series": [
{"name": "2024", "values": [320, 410, 380, 520]},
{"name": "2025", "values": [380, 490, 450, 610]}
]
}
}
3. flow — 流程图
{
"type": "flow",
"data": [
{"step": 1, "title": "需求分析", "description": "收集用户需求", "icon": "search"},
{"step": 2, "title": "方案设计", "description": "制定技术方案", "icon": "light"},
{"step": 3, "title": "开发实现", "description": "编码与测试", "icon": "settings"},
{"step": 4, "title": "上线发布", "description": "部署到生产环境", "icon": "rocket"}
]
}
4. dashboard — 混合仪表盘
{
"type": "dashboard",
"data": {
"stats": [
{"label": "DAU", "value": "12.3K", "icon": "users", "trend": "+5%", "trend_dir": "up"},
{"label": "转化率", "value": "3.8%", "icon": "target", "trend": "-0.2%", "trend_dir": "down"}
],
"chart": {
"chart_title": "月度趋势",
"categories": ["1月", "2月", "3月", "4月"],
"series": [{"name": "DAU", "values": [10200, 11500, 11800, 12300]}]
},
"breakdown": [
{"label": "iOS", "value": 45},
{"label": "Android", "value": 38},
{"label": "Web", "value": 17}
],
"flow": [
{"step": 1, "title": "注册", "description": ""},
{"step": 2, "title": "激活", "description": ""},
{"step": 3, "title": "留存", "description": ""}
]
}
}
输出格式
脚本在 stdout 输出 JSON 结果：
{
"status": "success",
"output": "/absolute/path/to/infographic.html",
"type": "stats",
"title": "My Infographic",
"palette": "auto",
"size_bytes": 8432
}
错误时：
{
"status": "error",
"errors": ["Missing required field: data"]
}
设计特点
- 零外部依赖：纯 Python 标准库，无需 pip install
- 自包含输出：HTML 内联所有 CSS 和 SVG，无需网络
- 响应式布局：支持桌面和移动端浏览
- 专业配色：8 套预设配色方案 + 自动选择
- 24+ 内置图标：常用 SVG 图标，无需字体文件
- 中文友好：字体栈包含思源黑体、苹方、微软雅黑
适用场景
- 数据报告中的可视化模块
- 产品数据仪表盘
- 业务流程说明
- 季度/月度数据对比
- 团队 KPI 展示
依赖
- Python 3.7+（仅使用标准库）