Demo Video Creator

核心功能

Demo Video Creator 是一套完整的浏览器自动化录屏解决方案，专为创建专业级产品演示视频而设计。其核心工作流程分为三步：规划演示序列（定义页面路径、交互动作与时机）、录制帧序列（通过 Playwright CDP Screencast API 捕获 JPEG 帧）、编码输出视频（使用 FFmpeg 合成 MP4/GIF/WebM 格式）。

显著优势

• 高质量捕获：基于 Chrome DevTools Protocol 的 screencast 能力，可捕获完整浏览器上下文，包括 CSS 动画、悬停状态、滚动效果，远超普通屏幕录制软件的窗口捕获精度
• 可编程自动化：通过 JavaScript 精确控制每一次点击、输入、悬停和页面跳转，消除人工操作的手抖与犹豫，确保演示节奏一致、专业
• 灵活输出格式：内置 FFmpeg 预设支持 H.264 MP4（通用兼容）、VP9 WebM（高压缩）、循环 GIF（嵌入文档/邮件），适应多平台分发需求
• Clawdbot 集成：直接连接自动化浏览器环境，无需额外配置显示服务或虚拟桌面

潜在局限

• 技术门槛：需要编写 JavaScript 自定义 DEMO_SEQUENCES，非技术人员难以直接使用
• 无音频捕获：当前方案仅捕获视觉帧，需后期通过 FFmpeg 或视频编辑器叠加音轨与解说
• 依赖环境：要求预装 FFmpeg、运行中的 Clawdbot 浏览器实例，本地开发环境配置较复杂
• 动态内容风险：若目标应用含不可预测的加载延迟（如 API 响应波动），固定 waitForTimeout 可能导致帧丢失或冗余等待

适合人群

• 产品经理/设计师：制作功能更新介绍、交互流程展示
• 开发者/技术写作者：创建 API 控制台演示、CLI 工具可视化教程
• SaaS 运营团队：批量生成个性化产品演示（如客户名替换、数据模拟）

常规风险

• 敏感信息泄露：录制前需确认浏览器环境无生产数据、测试账号或内部域名暴露
• 资源消耗：高帧率录制（低 FRAME_SKIP）可能短时间内生成大量 JPEG 文件，需监控磁盘空间
• 版权合规：录制第三方网站内容需遵守其服务条款，避免未经授权的品牌素材使用

核心用法

Demo Video Creator 是一款专注于自动化录制产品演示视频的开发者工具。其核心工作流程分为三步：规划演示序列 → 录制浏览器帧 → 编码输出视频。用户通过自定义 JavaScript 脚本定义页面导航、点击、悬停、输入等交互行为，工具连接本地 Clawdbot 浏览器通过 Chrome DevTools Protocol (CDP) 捕获 JPEG 帧序列，最终调用 FFmpeg 转换为 MP4/GIF/WebM 格式。

显著优点

• 纯本地执行：仅连接 127.0.0.1:18800 本地 CDP 端点，无任何外发网络请求，数据隐私风险极低
• 零外部依赖：无 npm/pip 依赖包，仅依赖系统级 playwright-core 和 ffmpeg，供应链攻击面最小化
• 灵活可控：支持自定义帧率（FRAME_SKIP）、JPEG 质量、输出格式，可精细平衡视频质量与文件大小
• 专业级输出：基于 Playwright 的真实浏览器渲染，确保视觉一致性；FFmpeg 专业编码保证兼容性
• 模板化工作流：提供开箱即用的脚本模板，降低录制自动化门槛

潜在缺点与局限性

• 手动配置门槛：需自行编写 DEMO_SEQUENCES 交互脚本，对非技术用户不够友好
• 浏览器依赖：必须预先启动 Clawdbot 浏览器，环境准备步骤较多
• 分辨率绑定：输出分辨率完全取决于浏览器窗口尺寸，缺乏独立设置选项
• 音频缺失：当前仅支持画面捕获，无系统音频或旁白录制能力
• 错误处理薄弱：脚本缺乏完善的异常捕获，CDP 连接失败或浏览器未启动时反馈不明确

适合人群

• 产品经理 / 设计师：需要快速制作产品 walkthrough 视频
• 开发者 / 技术写手：录制 API 演示、开源项目 showcase
• 营销团队：批量生成一致的交互演示素材
• 不适合：需要实时语音讲解、复杂后期剪辑的专业视频制作需求

常规风险

• 来源可信度：T3 级个人开发者项目，长期维护能力存在不确定性
• 数据安全：虽仅操作本地文件，但脚本会递归删除输出目录，配置错误可能导致数据丢失
• 法律合规：当前未包含开源许可证声明，商用需注意潜在法律风险

改进建议

建议添加 LICENSE 文件、增强错误处理机制、限制文件操作范围（禁止根目录/系统目录），并在生产环境部署前进行人工代码审查。