文本→HTML→重构→流程图:AI-Animation-Skill 四步工作流的实现原理
文本→HTML→重构→流程图:AI-Animation-Skill 四步工作流的实现原理
AI-Animation-Skill 是一个使用 AI 生成 HTML 演示动画的工具集,让视频创作者能快速将科普文本转换为炫酷的演示动画。它不是模板合集,而是一套可运行的 AI 动画生成工作流:你只需在对话中输入一段技术科普文本,AI 就会自动完成「文本 → HTML → 模板重构 → 流程图」的完整链路,产出适合 B 站视频、课堂教学和技术分享的演示网页。本文带你拆解它四步工作流的实现原理,以及背后踩坑换来的 3 个关键修复。
一分钟认识这个工具
先明确它解决什么问题:
| 痛点 | 传统做法 | AI-Animation-Skill 的做法 |
|---|---|---|
| 把文字做成演示动画 | 手动写 HTML/CSS 动画,耗时数天 | 输入文本,两步自动完成 |
| 风格单一、不好换 | 每个主题重新设计 | 内置 25 个 Level2 模板 + 14 个流程图模板,AI 自动选型 |
| 切页后动画只播一次 | 逐浏览器调试 | 内置 cloneNode 动画重置修复 |
它的本质是一个 Skill 文件 + 模板资产库:
- 工作流定义:SKILL.md(Skill 主文件,内部名称为
science-content-ppt,触发词包括"生成PPT"、"生成演示网页"、"生成流程图") - 模板库:
assets/templates/下分三个目录,配合 OpenClaw、Workbuddy、QClaw 等 AI 工具使用 - 选择指南:两个 SUMMARY.md 文件,教 AI 如何"看菜下饭"选模板
整个技术栈为原生 HTML5 + CSS3 + JavaScript,零框架依赖,现代浏览器直接打开即可播放。
四步工作流全解:每一步在做什么
第一步 · 文本:把科普文本加工成 PPT 提示词
这一步的关键不是"让 AI 随便写",而是把需求翻译成结构化提示词。工作流内置了一个固定模板,要求 AI:
- 生成"仿 PPT 换页轮播"的单页布局
- 加大文字、加粗/下划线/彩色强调,适配视频演示
- 页面切换时各元素依次"缓入"出现,动画细化到每行文字
📌 真实案例:输入一段 OSI 七层模型的科普文本,最终产出 13 页轮播(封面、简介、七层详情、层级分工、协议对比),全部动画逐行缓入。
这一步的产物是一份"带完整排版指令的提示词",为下一步的高质量生成打下地基。
第二步 · HTML:模型直出 AI_Animation.html(含一个关键修复)
用第一步的提示词调用模型,直接生成完整 HTML 页面(默认输出到 AI_Animation.html)。生成时强制追加两条约束:
- emoji 全部替换为平面 UI 图标(Font Awesome 或 Lucide 图标库),并检查无残留 emoji
- 所有动画元素的 class 统一为
an或anim-item——这是为第三步的动画修复"埋钩子"
而实现中最精华的部分,是解决一个 AI 生成页面的经典 bug:CSS 动画加了 animation-fill-mode: forwards 后只执行一次,切回页面也不重播。工作流给出的方案是切换页面时克隆 DOM 节点,强制浏览器重新渲染:
item.parentNode.replaceChild(item.cloneNode(true), item);
这段修复 JS 会插入到页面底部 </body> 前,只依赖 cloneNode(true) + replaceChild,是跨浏览器最可靠的方案。
第三步 · 重构:25 个 Level2 模板,AI 帮你选
直接生成的页面只是"毛坯",第三步用 Level2 PPT 模板做精装修。流程是:
- AI 先阅读 PPT Template-level2/SUMMARY.md(25 个模板的选型指南)
- 根据科普内容类型自动匹配最合适的一个模板
- 按该模板的布局、样式和轮播机制重构页面,内容不变,视觉升级
选型逻辑一目了然(节选自 SUMMARY):
| 内容类型 | 推荐模板 | 原因 |
|---|---|---|
| 对比/辩论类 | 8-1、8-3、6-2 | VS 对比卡片最多 30 组 |
| 步骤/流程类 | 3-2、6-1、6-3 | SVG 流程图 + 步骤动画 |
| 案例/实验类 | 4-2、4-3 | 数据图表 + 代码雨动画 |
| 警示/危险类 | 5-4、7-3 | 最高 15 种动画,红色脉冲 |
| 轻量/快速 | 3-3(331行)、9-3(5页) | 代码量小,加载快 |
若 Level2 无合适选项,则回退到 4 个基础模板(PPT-Generate-3.html 为通用推荐)。重构完成后还需检查模板是否内置动画重置 JS。
第四步 · 流程图:一句话切换平面 UI 风格
当你说"生成流程图"时,进入模式二——不生成新内容,只把已产出的 AI_Animation.html 做一次视觉重构:
- AI 先阅读 Animation/SUMMARY.md,从 14 个单页全量展示模板中选型(默认 RNN-3.html)
- 将相邻两页内容合并,按模板的平面 UI 样式重构:精确还原布局、间距、字体、图标,保持原有配色,响应式适配,目标是 95% 以上的视觉相似度
Animation 模板的共同视觉基因是:深绿渐变背景 + SVG 噪点纹理 + Canvas 粒子漂浮 + 分层卡片连线动画,非常适合展示 RNN、LSTM、GPU 架构这类"结构+流动"的技术内容。
3 个高频坑与官方解法
这部分直接来自 SKILL.md 的实操总结,值得收藏:
| 问题 | 原因 | 解法 |
|---|---|---|
| 切页后动画不重触发 | forwards 使动画只跑一次,display:none 也无法重置 |
克隆 DOM 节点强制重渲染(第二步已内置) |
| AI 生成的代码太单薄(200~400 行) | 模型偷懒 | 提示词中明确要求"代码 1000 行以上",或分多步生成拼接 |
| 流程图模式"没内容" | 它只做视觉重构,不生成新内容 | 必须先跑完模式一,再触发"生成流程图" |
快速上手与模板资源清单
安装(以 Workbuddy 为例):下载本项目 → 将 AI-Animation-Skill 文件夹复制到 ~/.workbuddy/skills/ → 重启客户端。
使用路径:
- 模式一:输入科普内容 + "帮我生成PPT" → 自动完成提示词生成、网页生成、模板重构
- 模式二:在模式一基础上说"生成流程图" → 自动按 Animation 模板重构
- 指定模板:说"以 xxx.html 为模板"即可切换内置模板
模板资产一览(详见 README.md 模板总览):
- PPT Level2 模板(26 个,优先选用):assets/templates/PPT Template-level2/
- PPT 基础模板(4 个,回退选用):assets/templates/PPT/
- Animation 流程图模板(14 个):assets/templates/Animation/
- 版本演进:CHANGELOG.md
💡 一句话总结:AI-Animation-Skill 把"写动画网页"这件苦差事,拆成了四个可复用、可替换的标准化环节——提示词工程管表达、约束 + 修复 JS 管质量、模板库 + SUMMARY 指南管视觉。这就是它四步工作流的实现原理。