Excel 自动变运营看板：零服务器、每天自刷新 (excel-dashboard-kit)

丢给它一张 Excel 或腾讯文档，自动解析成手机适配的单文件 HTML 看板，部署成固定链接，每天定时刷新——不用开服务器、不用手动搬数据。

把 Excel 或腾讯文档在线表格，变成单文件自包含 HTML 运营看板，部署成固定链接，每天自动刷新。

解决什么痛点

| 痛点 | 解法 | |---|---| | 腾讯文档/WPS 导出的 xlsx 用 openpyxl 直接崩 | parse_xlsx_sheets 改用 ZIP/XML 直读 | | 源表插列/删列/改名导致取数乱 | locate_cols 按表头名定位列 + fallback 兜底 | | 公式单元格导出后为空 | 只读明细表自行聚合，不读汇总表公式 | | 数据源偶发不可用 | resolve_source 三级回退：腾讯文档在线 → HTTP 直链 → 本地目录 | | 部署麻烦 | 数据内嵌 JS 的单文件 HTML + CloudStudio 一键部署 |

快速开始

import sys; sys.path.insert(0, 'skills/excel-dashboard-kit/scripts')
from dashkit import parse_xlsx_sheets, locate_cols, render_single_file, num, s

sheets = parse_xlsx_sheets('源表.xlsx')
rows = sheets['数据表']
idx = locate_cols(rows[0], {'date': '日期', 'leads': ['总商机', '商机量']}, fallback={'date': 0})

data = {'meta': {'snap': '2026-08-01', 'timeProgress': 0.03},
        'kpi': [{'name': '线索', 'value': 310, 'target': 1500, 'unit': ''}]}
render_single_file('assets/template.html', 'dist/index.html', data)

完整流程见 skill 内 references/new-dashboard.md，真实案例见 references/example-jlr.md。

目录结构

excel-dashboard-kit/
├── SKILL.md                # skill 主入口
├── LICENSE.txt
├── README.md
├── scripts/dashkit.py      # 通用技术骨架（取数/解析/工具/产出）
├── assets/template.html    # 通用单文件看板模板（含 __DASHBOARD_DATA__ 占位符）
└── references/
    ├── pitfalls.md         # 按症状排查（通用技术坑）
    ├── new-dashboard.md    # 新建看板六步流程
    └── example-jlr.md      # 捷豹路虎 4S 店运营看板：真实案例

依赖

• Python 3（标准库即可，无需 openpyxl）
• 腾讯文档在线导出需要宿主的 tencent-docs 连接器（路径用环境变量 DASHKIT_PY / DASHKIT_TENCENT_SCRIPT 覆盖，失败自动回退本地）
• 部署需要 CloudStudio（WorkBuddy 内置）