demo-video

Demo Video 是一个用于创建和修订剪辑视频的技能，基于 Remotion 实现。它适合制作产品演示、带旁白的屏幕操作讲解、动画解说以及由素材构建的短演示视频。

用途与核心理念 该技能强调让主题成为故事本身。对于产品，应展示人们能做什么、为什么重要以及团队构建了什么。个性应体现在表达方式中，而不是作为故事内容。除非被要求，否则不要把修订版介绍为新版本，也不要谈论旁白者的声音。

参考文档 技能包含两个参考文档：references/rendering.md 用于设置 Remotion、测量片段、混合音乐、渲染、检查导出或查看修订示例；references/motion.md 用于将运动与旁白对齐，包括词语对齐、镜头移动、高亮、光标、字幕、转场和静帧。

工作流程

1. 选择模型配置：合成、运动计时和帧审查属于实现工作。当有可用的交接且列出的配置比当前配置更适合实现时，应在步骤 1 前切换。如果请求者指定了模型或配置，在可用时使用它。不要仅为总结已完成工作而交接。

2. 解析需求并复用工作：阅读当前请求和先前决定，保持约定的受众、长度、语气、署名和目的地。只询问阻碍工作的缺失决定。在重建前查找现有源、素材和附件。沙箱文件可能在轮次之间消失，应在对话中查找早期的源归档并加载。如果没有源，说明这将是全新合成。在撰写关于已发布行为的声明前，检查目标 UI 和相关仓库历史。使用仓库技能获取代码访问权限。不要将未合并的功能呈现为已上线。起草简短的场景列表，每个场景一个要点。将每个声明匹配到捕获或已验证的源。在被要求且有支持时命名协作者。将产品能力与本任务中采取的操作分开。描述提醒邮件并不授权发送一封。

3. 捕获真实 UI：加载 agent-browser 以使用浏览器命令。当请求还询问 UI 是否工作或看起来正确时，使用 visual-web-qa。优先使用可访问的本地或预览页面进行请求的修订。对私有页面使用授权会话；不要绕过登录。如果私有数据阻止安全捕获，使用真实 UI 配合隔离的合成测试数据。在视频中标注该数据。不要制作一个相似物并称其为应用。保持测试数据服务器在本地。防止其向生产环境发送写入、邮件或上传。不要复用客户提交或机密。捕获旁白提到的每个状态：打开的面板、深色主题、播放器卡片和移动视图。当状态需要数据时添加小型合成测试数据。当相机必须滚动时使用全页捕获。在捕获视口从 DOM 记录元素框。高亮和光标目标使用这些框；参见运动参考。对稳定页面使用截图。当交互或运动是故事的一部分时，使用短浏览器录制。在所需流程后停止录制。等待预期内容和字体。在使用捕获前打开它们。检查加载状态、裁剪、测试数据计数不匹配和敏感内容。对于没有编辑呈现的原始交互录制，仅使用 agent-browser。默认不要添加 Remotion 项目。

4. 准备旁白和音乐：将口头文本与场景布局和表达方向分开编写。保持开场关于工作。将署名和操作能力放在支持故事的位置。对于请求的语音，加载可用的 TTS 技能并使用其凭证、成本和重试规则。使用约定的语音预设。不要静默地用另一个声音替换缺失的提供者。每个场景生成一个片段，使修订成本低。复用未更改的片段，将更改的文本生成到新路径。仅视觉编辑不需要新的语音请求。测量每个片段。对齐其词语以获得词语时间。从最后一个口语词加上明确的前导和尾部时间推导场景帧。在片段更改后重新计算后续场景偏移。保持字幕与最终脚本和词语时间绑定。如果对齐不可用，说明字幕计时是近似的。音频能量驱动的头像运动不是唇形同步。音乐是可选的。仅使用用户提供的或对此用途有明确许可的曲目。不要在没有声明来源和许可的情况下生成、下载或模仿音乐。保持音乐在旁白之下；参见渲染参考。

5. 合成和渲染：除非用户要求更改应用，否则使用单独的产物目录。将合成源、本地素材、场景数据和输出放在一起。复用现有的 Remotion 项目和锁文件。对于新项目，遵循渲染参考。浏览器运行时设置仍由插件拥有；报告缺失的运行时，而不是在此修复。匹配应用的字体、颜色和批准的素材。保持 UI 文本可读。将每个动作计时到口语词：相机、高亮、光标点击、字幕和屏幕文本。一次显示一个焦点。使用平移、缩放、短擦除和弹簧，而不是昂贵的特效。标注任何不是真实屏幕的插图。将图像、字体和音频本地打包。从帧号驱动运动，而不是墙钟计时器或渲染期间的网络调用。在完整视频之前为每个场景和转场渲染静帧。修复裁剪、碰撞和空状态，然后再次渲染。使用短帧范围诊断失败。尽早为目的地设置导出分辨率和音频比特率。保持源为完整合成大小。较小的交付副本不需要更改场景设计。

6. 检查和交付：解码完整导出的视频和音频。检查每个场景的帧，包括转场、首尾帧、字幕和任何更改的裁剪。检查时长、缺失音频、响度、峰值和末帧截断。当音频审查可用时聆听。解码和电平检查不能证明发音、计时或聆听质量；报告未检查的限制。在附件前检查实际文件大小。如果太大，使用较小的交付配置重新编码现有母版。重新检查该文件。不要重新生成语音或发布公共 URL 来绕过限制。在超时后重复渲染前检查输出和日志。永远不要仅从文件存在推断成功。使用 sendFiles 交付视频。在被要求或已同意时包含独立的合成旁白和可编辑源。从源归档中排除依赖、缓存、机密和未使用的修订。报告成功的附件、时长、检查和剩余限制。在产物 README 中记录捕获来源、对齐、音乐许可和重新渲染命令。当只有视频更改时，不要说应用或生产已更改。

适用场景 该技能适用于需要制作产品演示、屏幕操作讲解、动画解说或短演示视频的场景，尤其适合需要将旁白与视觉运动精确对齐、需要基于真实 UI 捕获、需要可编辑源和可重复渲染流程的项目。

限制 音乐仅在用户提供或有明确许可时使用。私有数据捕获需使用授权会话或隔离的合成测试数据并标注。字幕计时在对齐不可用时为近似。音频能量驱动的头像运动不是唇形同步。浏览器运行时设置由插件拥有，缺失时应报告而非在此修复。