Argo 能将 Playwright 演示脚本转化为精美的产品演示视频,并配上 AI 配音与动画叠加层。默认在本地运行,无需 API 密钥(使用 Kokoro TTS),同时也支持云 TTS 引擎(OpenAI、ElevenLabs、Gemini、Sarvam)以获得更高质量或多语言配音。
用途:主要用于从 Playwright 脚本自动生成产品演示视频,适合需要快速产出演示素材的团队。
主要能力:
- 支持自主模式:完成全流程——安装 Argo、探索目标应用、编写演示脚本与清单、运行管线并交付 MP4。
- 支持辅助模式:帮助已有 Argo 脚本的用户解答问题、修复错误、编辑清单、重新运行单个管线步骤。
- 提供相机与效果 API:spotlight、focusRing、dimAround、zoomTo、resetCamera、showConfetti、createHumanCursor、cursorHighlight 等,均为非阻塞。
- 支持移动端演示录制,通过 test.use() 设置 isMobile 与 hasTouch。
- 使用统一的 .scenes.json 清单管理旁白文本、叠加层提示、效果与场景设置。
- 提供多种叠加层模板:lower-third、headline-card、callout、image-card、arrow,支持位置、动作与自动背景。
- 内置 12 个现成叠加块,如 x-post、macos-notification、data-chart、flowchart 等。
- 支持通过 argo add 安装 HyperFrames 全帧组件(如 vignette)。
使用方式:
- 前置要求:安装 TTS 引擎(如 npm i kokoro-js@1 或 npm i openai)、@argo-video/cli、Playwright 浏览器(npx playwright install chromium)、ffmpeg;确保项目根目录存在 argo.config.mjs(可用 npx argo init 生成)。
- 快速开始:检查安装与配置,设置 baseURL,编写 demos/<name>.demo.ts 与 demos/<name>.scenes.json,运行 npx argo pipeline <name>,输出 MP4 至 videos/ 或配置目录。
- 演示脚本需从 @argo-video/cli 导入 test,而非 @playwright/test;调用 narration.startRecording(page) 开始录制,narration.mark(scene) 标记场景,narration.durationFor() 计算时长。
适用场景:需要快速制作产品演示视频的开发者、产品团队;已有 Playwright 测试希望转为演示视频的场景;需要多语言配音或高质量云配音的演示。
限制:
- 默认不附带 TTS 引擎,需自行安装可选依赖。
- 演示脚本必须使用 Argo 的 test fixture,否则 narration 为 undefined,导致导出时找不到时序文件。
- 清单中 effects 字段仅为预览元数据,不会自动注入效果,需在脚本中显式调用。
- 长演示需设置足够超时(如 test.setTimeout(scenes.length * 15_000))。
- 中间产物(.argo/、test-results/)较大,应加入 .gitignore。
- zoomTo 推荐传入 narration 以使用 ffmpeg 后期缩放,否则回退到浏览器 CSS 变换。