local-dashboard-forge · 本地单文件数据看板

输入 CSV / Excel，输出一个自包含的离线 HTML 数据看板。单文件、零依赖、可微信直发。

安装

1. 把本目录整个放到 ~/.workbuddy/skills/local-dashboard-forge/
2. 需要 Python 3.9+；读 xlsx 需要 pip install openpyxl

使用

python scripts/forge_dashboard.py <数据.csv|xlsx> [-o 输出.html] [-t 标题] [-n 副标题] [-c]

参数

| 参数 | 说明 | |---|---| | -o | 输出 HTML 路径（默认 dashboard.html） | | -t | 看板标题 | | -n | 副标题 / 项目名 | | -c | 数值按 ¥ 货币格式显示 |

示例

python scripts/forge_dashboard.py examples/sample_sales.csv -o examples/dashboard_demo.html -t "门店销售看板" -n "2026年8月 轻食连锁示例" -c

功能清单

• [x] 自动识别数值 / 日期 / 文本列
• [x] KPI 指标卡（合计 / 平均 / 最大 / 记录数）
• [x] 趋势折线图（按日期聚合）
• [x] 排行条形图（按分类聚合 Top8）
• [x] 占比环形图（Top6 分布 + 图例）
• [x] 明细表：点击表头排序、输入框搜索过滤
• [x] 单文件输出：CSS / JS / SVG 全部内嵌，离线可开
• [x] CSV 编码自动探测（utf-8-sig / gbk / utf-8）

目录结构

local-dashboard-forge/
├── SKILL.md                 # 技能说明（WorkBuddy 识别入口）
├── README.md
├── scripts/
│   └── forge_dashboard.py   # 核心生成引擎（含中文注释）
├── references/
│   └── fields.md            # 字段识别规则说明
└── examples/
    ├── sample_sales.csv     # 示例数据
    └── dashboard_demo.html  # 示例输出（浏览器直接打开）

已知限制

• 图表为静态 SVG（无 hover 交互），适合快速交付；如需高级交互图表可联系扩展
• 日期列需要可解析的日期格式（见 SKILL.md 输入输出约定）
• 数据量过大（>10 万行）时建议先聚合

合规说明

• 纯本地运行，不采集任何外部数据，不上传数据
• 图表不自动生成误导性结论，仅供数据展示