瞎折腾看数据 v3 官方 README 手册：把表格变成动态看板、图表和 4K 竞速视频（开源免费）

「瞎折腾吧」原创开源数据可视化工具 v3 完整部署与使用说明：支持 CSV/XLSX 与世界银行数据导入、自动匹配国旗与品牌图标、导出 4K MP4 竞速视频与原生可编辑 Excel 图表。

## 项目简介

**瞎折腾看数据 (v3)** 是一个把表格变成动态看板、图表和竞速视频的数据工具。支持导入数据、一键匹配内置国旗或品牌图标、播放动态排名竞速、直接导出最高 4K (2160p) MP4 视频与含原生可编辑图表的 Excel，并支持浏览器 IndexedDB、VPS SQLite 数据库及 Cloudflare KV 跨设备历史同步。**本工具完全开源免费！**

## 四种部署方式对比

| 使用方式 | 适用压缩包 | 历史数据保存位置 | 大屏展示方式 |
| --- | --- | --- | --- |
| **本机免安装** | `瞎折腾看数据-本地离线版-v3.zip` | 浏览器 IndexedDB；支持 JSON 备份导入导出 | 独立窗口 |
| **VPS / 服务器 / NAS** | `瞎折腾看数据-VPS版-v3.zip` | 本机副本 + **服务器 SQLite 数据库** | 独立窗口，主页面远程控制 |
| **GitHub Pages** | `瞎折腾看数据-Pages版-v3.zip` | 浏览器 IndexedDB；可连接远程 SQLite 或 KV 接口 | 当前页面大屏 |
| **Cloudflare Pages** | 同一个 Pages 包（保留 `_worker.js`） | 浏览器 IndexedDB + 可选绑定 Cloudflare KV (`HISTORY_KV`) | 当前页面大屏 |

## 核心功能亮点

- **智能表格导入**：支持 CSV、XLSX、XLS，以及世界银行（World Bank）原始 CSV/ZIP 直接识别并筛选国家与年份；支持空白值动态消散与底部跳入动画。
- **内置图标库与批量导入**：一键匹配中文、英文及常见缩写的国旗与品牌标志，并支持拖拽本地图标文件夹批量导入自定义分类。
- **七种可视化视角**：动态竞速、条形图、扇形图、环形图、波浪图、折线图、点状分布。
- **浏览器直出 MP4 与原生图表 Excel**：无需安装 Python、Node.js 或 FFmpeg，浏览器直接硬件编码导出 720p / 1080p / 1440p / 2160p MP4 视频（含领奖台排名收尾特效）。

## VPS / NAS Docker Compose 一键部署命令

解压 `瞎折腾看数据-VPS版-v3.zip` 上传至服务器目录后，配置 `.env` 访问密钥并启动容器：

```bash
# 1. 复制环境变量配置并修改访问密钥 HISTORY_API_TOKEN
cp .env.example .env
nano .env

# 2. 启动 SQLite 后端与网页服务（默认映射端口 8088）
docker compose up -d --build
```

启动后访问 `http://服务器IP:8088`，在右上角「历史数据 → 连接云端」中输入你设置的访问密钥即可实现多设备数据自动同步！