HKUSTDial/DataMagic

📚 什么是 DataMagic？

DataMagic 是一个开源工具包，让您可以将表格数据（CSV、Excel 等）转化为简短的动画视频故事。它附带了一个 139 张“配方卡”的库 —— 每张卡片描述了一个特定的视觉效果（例如：排名揭示、基于地图的比较、角色驱动的导览），并包含：

• 动画预览，
• 生成该效果的声明式源代码，以及
• 示例数据。

A datamagic Skill（一组提示词和辅助脚本）让 编程代理（例如：基于 LLM 的代码助手）能够自动：

1. 为您的数据选择合适的配方，
2. 用您自己的数字、标签、颜色和素材填充模板，
3. 渲染视频，以及
4. 验证输出结果。

该项目由两篇经过同行评审的论文（IEEE VIS 2026 和 VLDB 2026 Demo）以及一个在线演示网站支持，您可以在该网站上传电子表格并在几秒钟内获得成品视频。

---

🛠️ 核心组件

组件	功能	位置
配方卡 (Recipe cards)	视觉叙事的声明式规范（动画时间轴、图表类型、旁白提示）。	cards/recipes/ 以及网页图库 https://datamagic.chat/cards/
模板源代码	可重用的脚本（Python/JS），读取 CSV、将字段映射到视觉元素并驱动渲染引擎。	从每张卡片链接；也在 cards/ 中
datamagic Skill	提示词库 + 小型工具，让代码生成代理定位正确的模板、替换数据并运行渲染器。	skills/datamagic/
在线系统	协调整个流程的托管服务（数据上传 → 配方推荐 → 视频生成）。	https://datamagic.chat/
研究文档	底层流程 (DVSpec) 的描述、评估和引用信息。	docs/

---

🚀 如何使用（快速入门）

1. 克隆仓库

   git clone https://github.com/HKUSTDial/DataMagic.git
   cd DataMagic
   

2. 选择配方 – 浏览网页图库或本地 cards/recipes/ 文件夹。点击 Copy implementation command 获取单行指令。
3. 运行代理 – 将指令粘贴到您最喜欢的基于 LLM 的编码助手（例如：具有函数调用功能的 OpenAI ChatGPT、Claude 或本地托管模型）中。提供您的 CSV 和任何自定义样式说明。
4. 渲染 – 该技能将定位模板、注入您的数据、调用渲染后端，并输出 MP4 以及编辑后的源代码文件。
5. 迭代 – 要求代理调整时间、颜色、字幕或替换素材；工作流程完全可重复。

一个 72 秒的演示（咖啡店销售）展示了从搜索 → 配方 → 指令 → 生成视频的完整循环。

---

🎯 谁应该关注？

受众	重要性
内容创作者 / 社交媒体经理	无需学习动画软件即可制作引人注目的数据视频。
数据分析师 / 研究人员	将静态表格转化为可在简报或论文中分享的叙事可视化内容。
AI/ML 开发人员	声明式多代理协调 的范例 —— LLM 生成并运行代码的具体用例。
教育工作者	用于教授统计学、经济学或地理学的现成模板，并结合动画叙事。

---

📖 文档与社区

• 网页图库与即时编辑器 – https://datamagic.chat/cards/（预览、编辑、下载源代码）。
• 技能指南 – skills/datamagic/README.md（安装、提示词格式、故障排除）。
• 完整故事工作流程 – skills/datamagic/rules/full-story-workflow.md（将多张卡片组合成连贯的叙事）。
• 研究论文 – README 中的 IEEE VIS 2026 和 VLDB 2026 链接。
• 社区 – 微信群组（仓库中的 QR 码），用于分享创作和获取支持。

---

⭐️ 快速总结

DataMagic 是一个 真实、由研究支持的平台，通过 声明式配方卡 和 LLM 驱动的代码协调，架起了数据分析与视频制作之间的桥梁。对于任何想要自动化创建数据驱动视频故事的人来说，它都非常有用，且仓库提供了入门所需的所有模板、代理技能提示词和文档。