运营数据看板构建与运维

把你的 Excel / 腾讯文档在线表，变成一个 手机能开、固定链接、每天自动刷新 的网页看板。

它能做什么

• 任意 Excel / 腾讯文档在线表 → 单文件自包含 HTML 看板（无后端、无接口、无跨域，丢哪都能开）
• 响应式布局，一线业务员用手机就能看
• 取数三级回退：腾讯文档在线导出 → HTTP 直链 → 本地兜底目录
• 每天定时自动刷新，部署链接固定不变（适合发群里存书签）
• KPI 卡片 + 达成率进度条 + 落后预警配色

快速开始

# 1. 告诉 dashkit 用哪个 python（只需一次）
#    Windows：set DASHKIT_PY=C:\path\to\python.exe
#    macOS/Linux：export DASHKIT_PY=$(which python3)

# 2. 探查你的源表结构（打印每个 sheet 行数 + 前两行表头）
python scripts/dashkit.py "你的源表.xlsx"

# 3. 照 references/new-dashboard.md 六步搭出你的看板
# 4. 跑 build.py 生成 dist/index.html → 部署成固定链接

目录

| 路径 | 内容 | |---|---| | scripts/dashkit.py | 通用骨架（取数 / 解析 / 渲染），import 即用 | | references/new-dashboard.md | 从零搭一个看板的六步流程 + build.py 起手式 | | references/pitfalls.md | 通用技术坑，按症状查 | | examples/jlr/ | 真实生产实例：厦门 JLR 门店运营看板（4 数据源、每天 20:00 刷新、已稳定运行数月） |

适合谁

• 手头有定期更新的表，想让团队随时看汇总数据
• 门店 / 小组 / 项目的周报月报，想从"手动发截图"升级成"一个固定链接"
• 愿意为一个看板写一次 Python 解析（约 100 行），之后每天自动跑

不适合谁

• 想要"上传表自动出图、零代码" —— 本 skill 是骨架 + 方法论，业务解析要你自己写（这也是它稳的原因）
• 需要实时数据 —— 产物是构建时打进 HTML 的，改了源表必须重跑 build 才更新

真实案例

厦门 JLR 4S 店运营看板：4 个数据源、每天 20:00 自动刷新、已稳定运行数月。 完整实现（数据源配置 / 口径文档 / 运维手册 / 业务坑）见 examples/jlr/。

---

本 skill 是通用工具；JLR 实例仅作示例。改任何业务逻辑前，先把口径写进 data-spec 文档（血泪教训：口径错了比不做还糟）。