项目简介
html-video 是一个通过编程代理制作视频的项目，可将 HTML、CSS 和数据转换为 MP4。它由 Open Design 团队开发，提供本地浏览器工作室和命令行工具，仓库标注许可证为 Apache-2.0。
项目使用可插拔渲染引擎架构。README 明确说明，当前已接入的是 Hyperframes：通过无界面 Chromium 记录动画 HTML，再由 ffmpeg 编码为 MP4。Remotion、Motion Canvas、Revideo 等适配器仍在计划中。
项目使用场景
适合将文章整理为多场景解读视频、将 GitHub 仓库资料制作成项目介绍，或根据文字描述制作产品展示、数据图表、动态标题与短视频。
已有内容素材时，可以让代理依据素材安排分镜；需要调整表达时，可以在工作室内修改各帧文字、调整顺序并重新渲染。需要声音时，可选用 MiniMax 生成背景音乐和旁白。
项目作用与解决的问题
项目把素材获取、代理生成、分镜组织、动画页面与视频导出连接起来，减少在这些环节之间手动搬运内容的工作。多帧视频通过内容图记录场景及其顺序关系，每帧对应独立的动画 HTML。
模板提供文字和数据输入位置，以及分辨率、画面比例等元信息，帮助代理选择和填充适合的视觉形式。渲染在本机完成；素材获取、所选代理后端及可选音频服务的配置和使用条件需要分别确认。
项目使用方法
1. 完成安装并启动工作室后，在打开的本地浏览器界面中浏览模板，选择适合内容的样式；也可以直接描述要制作的视频，或提供文章、GitHub 仓库作为素材。
2. 在工作室顶部选择可用的编程代理。项目会检测 PATH 中已安装的受支持代理。可在仓库根目录运行 `node packages/cli/dist/bin.js doctor`，检查已安装的代理和渲染引擎。
3. 与代理对话，说明视频主题和内容要求，让代理生成分镜及动画 HTML。需要按意图查找模板时，可运行 `node packages/cli/dist/bin.js search-templates --intent "github stars race" --top 3`，该示例用于查找与 GitHub 星标竞赛相关的模板。
4. 在工作室中检查各帧内容，修改文字、调整顺序，并按需要重新渲染。
5. 如需配乐或旁白，在 Settings → Audio 中配置 MiniMax API 密钥，再到项目的 Soundtrack 面板描述音乐氛围或填写旁白稿。未配置该密钥时，仍可使用其他工作室功能。
6. 导出 MP4。README 未提供各代理的完整安装、登录步骤及外部服务费用信息，应查阅原始仓库和相应服务说明。
项目安装方法
1. 从页面下方的原始仓库获取克隆地址或下载入口，将源码保存到本机，并在终端进入仓库根目录。所给 README 未提供具体克隆命令。
2. 准备 Node.js 20 或更新版本、pnpm 9 或更新版本，以及较新的 ffmpeg。分别运行 `node --version`、`pnpm --version` 和 `ffmpeg -version` 检查。README 未提供这些工具的具体安装步骤，也未列明操作系统支持范围。
3. 准备 Chromium 或 Playwright 浏览器。README 给出的 Playwright Chromium 安装命令为 `npx playwright install chromium`。
4. 在仓库根目录运行 `pnpm install`，安装项目依赖。
5. 运行 `pnpm -r build`，构建项目。
6. 运行 `node packages/cli/dist/bin.js studio`，启动本地浏览器工作室。
7. 使用视频生成功能前，配置受支持的编程代理；README 也提供通过 Anthropic API 密钥直接使用 Messages API 的方式，但未给出完整密钥配置步骤，请查阅原始仓库。
来源与使用说明
- 原始仓库：https://github.com/nexu-io/html-video
- 资料版本：c414ecc07f795add03807d5d9ce4baefd807cea2
本站提供上游仓库链接，未提供经验证的下载包，也未独立验证项目的完整运行流程。
本页介绍由 AI 根据上游公开资料整理与翻译；具体能力、安装要求、费用和许可请以原始仓库说明为准。 
