用途:当用户需要为 PR 制作演示视频、录制功能走查,或生成视频时使用。流程为协作式,不直接写代码,依次经过调研、提出脚本、迭代、录制、复核、再迭代。
前置条件:Positron 需已构建(可用 npm run build-ps 检查);MP4 转换需安装 ffmpeg(可选但推荐)。
工作流:先查看当前分支近期提交与改动文件,检查既有端到端测试能否复用;随后以纯文本编号脚本向用户说明每步画面、叠加文字与预估时长,反复迭代直至用户批准。批准后,将脚本转为 Playwright 测试,放在 test/e2e/demos/<name>.demo.test.ts,使用 setupDemoLayout()、...DEMO_SCREENCAST_SETTINGS、narrate() / showOverlay() 与 pause() 控制节奏,具体模式见 references/demo-patterns.md。
录制命令:DEMO_RECORD_VIDEO=1 npx playwright test test/e2e/demos/<name>.demo.test.ts --project e2e-electron --reporter list --timeout 300000。
剪辑转换示例:ffmpeg -ss <START_SECONDS> -t <DURATION> -i demo-videos/<hash>.webm -c:v libx264 -crf 20 -preset slow -an demo-videos/<name>.mp4
复核:可由子代理用 ffprobe 获取时长与体积,并用 ffmpeg 抽取关键帧检查叠加文字、布局与节奏。
输出与限制:录制为 1920x1080;GitHub 免费账户 10MB、付费 100MB 限制;开头约 10-15 秒为初始化内容需剪除;WebM 可用于 GitHub,MP4 对 Safari 兼容性更好。收费与价格信息暂未提供。