html-video

环境要求

• Node.js 运行环境（需能执行 node 命令）
• pnpm 包管理器（用于 pnpm install / pnpm -r build）
• 本地已安装并登录受支持的编码智能体之一（如 Claude Code、Cursor、Codex、Gemini、OpenCode、Copilot、Aider 等），
• 可用的浏览器，用于访问 Studio 界面

安装与启动步骤

1. 1克隆并安装依赖

   进入项目根目录后安装整个 monorepo 的依赖，首次执行耗时较长，请保持网络畅通。

   git clone https://github.com/nexu-io/html-video.git
   cd html-video
   pnpm install

   复制

2. 2构建所有子包

   递归构建仓库内所有包，生成 CLI 产物 packages/cli/dist/bin.js，后续命令都依赖它。

   pnpm -r build

   复制

3. 3检测智能体与引擎

   运行 doctor 自动探测本机已安装的编码智能体和可用的渲染引擎，确认环境是否就绪。

   node packages/cli/dist/bin.js doctor

   复制

4. 4搜索模板

   按意图检索内置的 21 套模板，例如“github stars race”，用 --top 控制返回条数。

   node packages/cli/dist/bin.js search-templates --intent "github stars race" --top 3

   复制

5. 5启动 Studio

   启动本地工作室界面，随后在浏览器访问 http://127.0.0.1:3071 开始制作视频。

   node packages/cli/dist/bin.js studio

   复制

如何确认成功

执行 studio 命令后，浏览器打开 http://127.0.0.1:3071 能正常看到工作室界面即启动成功。

常见问题

注意事项

• Studio 默认监听 http://127.0.0.1:3071，仅在本地可访问。
• 视频导出为真实 MP4，技术栈包含 ffmpeg，建议本机具备相应渲染能力。
• 支持可选的 AI 配乐与旁白，以及逐帧文案编辑。
• 一条智能体循环完成从描述到 MP4 的生成，全程在本机渲染，无按次计费。