// 01 html-video 是什么
快速结论
html-video 是 nexu-io（Open Design 背后团队）推出的开源视频生成工具，主打让 AI 编程代理把 HTML 直接渲染成动画 MP4。它以 Apache-2.0 协议开源，核心卖点是「本地出片、无云端依赖」——用 headless Chromium 配合 ffmpeg 在本机逐帧渲染，把提示词、文章链接或 GitHub 仓库转成多帧动画视频。运行全程本地，源码托管在 GitHub（国内拉取依赖建议配镜像加速）。
适合谁优先使用
- 已在用 Claude Code / Cursor / Copilot 等 AI 编程代理、想顺手把项目或文章变成演示视频的开发者
- 要批量产出数据可视化、产品演示视频，又不想被云端渲染按条收费的团队
- 注重隐私、要求素材本地渲染不上传的场景
- 前端 / 全栈背景、能接受命令行 + Node 环境的人
核心能力拆解
HTML → MP4 本地渲染
用 headless Chromium 逐帧截取 HTML/CSS/JS 动画，再经 ffmpeg（libx264）合成真实 MP4，全程在本机完成，不依赖云端渲染农场。
21 个预制模板
内置数据可视化、标题卡、产品演示等 21 套模板，配合多场景故事板（内容图编排系统）拼出完整视频。
由 AI 编程代理驱动
支持 14 种代理（Claude Code、Cursor、Windsurf CLI、Copilot、Aider 等），把一段提示词、一篇文章链接或一个 GitHub 仓库交给代理，自动生成对应视频脚本与画面。
可选 AI 配乐与配音
集成 MiniMax，可为视频自动加背景音乐和文字转语音旁白（需 MiniMax API Key，可选不开）。
和同类工具怎么选
| 需求 | 优先考虑 | 判断标准 |
|---|---|---|
| 开发者用代码 / AI 代理批量生成视频 | html-video | 开源、本地渲染、能接入现有 AI 编程代理 |
| 零代码、网页拖拽做视频 | 剪映 / Canva | 不想碰命令行，要可视化编辑 |
| 文本 / 图片生成式出画面 | 可灵 / 即梦 | 要的是 AI 生成画面，而非把 HTML 转成视频 |
国内平替：纯「HTML 转视频」的开源同类很少；零代码视频可用剪映、必剪，生成式视频可用可灵、即梦。
限制与避坑
- 需要 Node.js 20+、pnpm 9+ 环境，还要本机装 ffmpeg 和 Chromium，门槛偏开发者
- 没有公开在线 demo，必须本地安装运行才能体验
- 源码在 GitHub，国内拉取依赖可能较慢，建议配镜像或代理
- 可选的 Anthropic Messages API 后端国内访问不便；但代理可换成其它（含国内）方案，配乐用的 MiniMax 国内可用
- 产出依赖你的 HTML / 模板质量，复杂动画仍需懂前端
典型工作流
从 GitHub 项目生成演示视频
- 装好 Node 20+ / pnpm，执行
pnpm install && pnpm -r build - 运行
node packages/cli/dist/bin.js doctor检测本机已安装的 AI 编程代理 - 启动 Studio：
node packages/cli/dist/bin.js studio，浏览器打开 http://127.0.0.1:3071 - 把仓库地址 / 文章链接 / 提示词交给代理，选择模板并预览故事板
- 本地渲染导出 MP4（可选开启 MiniMax 加配乐与配音）
常见问题
html-video 收费吗？
完全免费。它以 Apache-2.0 协议开源，本地渲染不按条收费、无座位限制；只有可选的 MiniMax 配乐 / 配音需要自备 API Key（按 MiniMax 计费），不开就没有这项支出。
国内能用吗？
能。渲染和运行都在本地完成；但源码和依赖托管在 GitHub，拉取建议配镜像或代理。可选的 Anthropic 后端国内访问不便，可换成其它（含国内）AI 编程代理。
一定要会写代码吗？
需要基本的命令行和 Node 环境操作，产出质量也和 HTML / 模板有关，更适合开发者或前端；完全非技术用户上手成本较高。
和剪映、可灵有什么区别？
剪映是可视化视频剪辑，可灵是 AI 生成画面；html-video 是把你写好的 HTML 动画转成 MP4，靠代码和 AI 编程代理驱动，偏开发者批量、自动化、可复现地产出视频。
NavXD 使用建议
如果你已经在用 Claude Code、Cursor 这类 AI 编程代理，html-video 是把「代码 / 项目」顺手变成演示视频的低成本选择——本地出片、开源免费、不锁供应商。但它不是给非技术用户的成片工具：要 Node 环境、要懂点前端。想零门槛做视频，选剪映或可灵更省事；想把视频生产工程化、批量化、可复现地接进研发流程，再上 html-video 最值。
// 02 核心 功能
- 核心定位快速结论 html-video 是 nexu-io（Open Design 背后团队）推出的开源视频生成工具， […]
- 分类索引当前归档在 AI 视频，方便和同频工具横向比较。
- 能力标签关联标签包括 开源、视频生成、AI编程、自托管、命令行。
- 使用入口已记录可访问入口，可通过本页主按钮跳转。
// 03 使用 场景
- 快速判断是否适合当前任务结合 AI 视频 定位和 开源、视频生成、AI编程 标签，先判断它是否匹配你的工作流。
- 横向比较同类工具从相同分类和标签继续探索替代工具，减少只看单个产品带来的选择偏差。
- 沉淀工具选型资料把官网入口、平台、版本和 NavXD 标签合并成一页，适合做选型记录或团队分享。
