SOP 视频
将观察到的操作流程转化为一个初学者可以无需猜测就能跟随的视频。交付可编辑源文件、MP4 视频、字幕、章节元数据以及一份简短的证据报告。默认语言为用户的当前语言；当用户要求时使用法语。默认的视觉风格为白色、蓝色且克制简约。
从实际需求出发
在提问之前，先阅读已有的简报和素材。仅解决那些会影响结果的不确定因素：任务、受众、软件/版本、旁白模式和输出目标。在制作系列视频之前，尊重用户先制作一个试点的要求。
在输出项目中编写 BRIEF.md，内容包括学习者应达到的结果、先决条件、范围、语言、旁白方式、授权操作以及交付格式。请求“制作/导出视频”即已授权其在本地渲染。不要添加常规的批准环节。公开上传和真实的账户更改需要相应的授权。
指定一名负责的制作人
当有委托工具可用时，使用 agents/producer.md 指定一名制作人代理。赋予其明确的范围内的文件所有权、简报、捕获权限和验收标准。协调代理审核结果并交付。除非用户要求并行制作，否则不要将场景分配给多个代理。
制作人可以通过可用的代理运行时或提供商的 CLI 使用经过验证的模型。按照 references/models.md 进行模型选择、简短的动态测试、模型标识和使用证据。绝对不能凭空捏造模型标识符，或对类似“O3.5”这样的模糊请求进行静默重命名。如果请求的运行时不可用，请说明限制并使用当前代理进行独立的准备工作；仅当必需的模型选择阻碍制作时才进行询问。
如果没有委托工具，则在当前代理中执行相同的制作人角色，并明确说明。agents/openai.yaml 描述了发现过程；它不会自动创建后台代理或选择模型。
制作视频
- 观察流程。 阅读 references/capture-and-audio.md。使用允许的浏览器/原生捕获工具、已连接的会话、提供的录制文件或经过验证的公开文档。记录确切的屏幕、按钮文本、原生图像尺寸、捕获日期、UI 变体以及某个操作是否真实执行。对于真实产品，绝对不能虚构 UI。
- 编写教学脚本。 每拍/节拍只包含一个操作或决策：去哪里，点击什么，检查什么，成功是什么样。给出必要的先决条件和常见的阻塞情况。避免解说视频中无法显示的点击。为每个可操作步骤和每个变化的模态框/标签页添加指示性的截图；当更清晰时，使用新的裁剪区域复用同一张屏幕截图。
- 先创建或使用语音。 选择 ElevenLabs、经过授权的提供/录制的语音，或环境可用的旁白工具。在安排场景之前，先测量实际的音频时长。在系列视频中保持语音/模型/设置稳定。保留自然的停顿，并添加足够的停留时间来检查按钮。当用户选择了自己的录音时，绝对不要静默生成语音。
- 构建视觉序列。 遵循 references/production.md。使用下面可运行的入门示例，或调整已批准的项目。白色
#FFFFFF背景，蓝色#1565D8标题/强调色，深蓝色#102A43文字。大尺寸截图占据左侧；简短的操作检查清单保持在右侧。将摄像机移动到实际的按钮坐标，保持相关标签可见，并使用一个光标/光晕。仅当有助于理解时添加说明面板。 - 添加字幕和章节。 将字幕与测量到的语音对齐，并分割成易读的提示。不要让一个提示持续到其所属场景之外。章节必须使用与渲染视频相同的时间线；交付文本/VTT 格式的章节并将其嵌入到 MP4 文件中。播放器的章节 UI 各不相同，因此请保留侧边文件。
- 验证并交付。 运行清单验证器和渲染器检查，检查每个场景，观察关键点击的过渡，并分别验证导出的 MP4 文件。报告真实的限制和实际执行的操作。文件存在并不代表播放正确或画面构图正确。
可运行的入门示例
附带的演示使用合成 UI，在屏幕上明确标注，并且没有旁白。它是一个技术示例，不是关于真实应用的证据。
要求：Python 3.10+, Node.js（与所选 HyperFrames 版本兼容）、FFmpeg/ffprobe 以及渲染器支持的 Chrome。npx 会在首次使用时下载锁定版本的渲染器；GSAP 会在编译期间从其声明的 CDN 获取。本地预览/渲染不需要 ElevenLabs 账户。如果依赖检查失败，请使用最新的渲染器文档。
从本技能所在的目录运行：
python3 scripts/sop.py init /path/to/new-sop
cd /path/to/new-sop
node build.mjs
npm run check
npm run preview -- --background
npm run render -- --quality delivery --output renders/video.mp4 --workers 1
对于 GPU 编码，仅在支持时添加 --gpu。入门示例固定了一个经过测试的渲染器版本以确保可重复性；在更改之前请先验证升级。如果安装了 HyperFrames 技能，请使用其当前的合成和验证指南。此软件包包含了基本约定，并且无需私有技能目录即可工作。
设置 SKILL_DIR 为本技能安装的目录，然后运行：
python3 "$SKILL_DIR/scripts/sop.py" validate sop.json --probe
python3 "$SKILL_DIR/scripts/sop.py" chapters sop.json --output delivery
python3 "$SKILL_DIR/scripts/sop.py" embed renders/video.mp4 delivery/chapters.ffmetadata delivery/video.mp4
init 命令会拒绝非空目标目录。embed 命令拒绝覆盖输出文件，并会在不重新编码的情况下复制流。字段和时序信息请参见 references/manifest.md。此辅助工具不会生成语音、登录网站或上传文件。
验收标准
- 学习者可以找到每个描述的按钮并看到相应的结果状态，或者明确标注的“未执行/示例”状态。
- 在实际导出的像素中，屏幕数据已被匿名化。公共来源仅包含经批准的素材；绝对不要捆绑私有的原始捕获文件、凭据、Cookie 或会话文件。
- 小号 UI 文本在预期的观看尺寸下保持可读；缩放保留上下文。没有检查清单/字幕重叠或无法解释的空白时间段。
- 音频没有截断的说话声、突兀的剪辑、丢失的短语或不稳定的声音变化。使用一致的测量响度，并检查峰值。
- 字幕和章节与最终时长一致。最后一帧显示有用的结果/检查清单，而不是意外黑屏。
- 交付物包括 MP4、SRT、VTT、章节文本/VTT、可编辑源文件、截图出处、模型/语音使用证据（如可用）以及一份说明实际测试内容的 QA 报告。
如果捕获、旁白、渲染或发布被阻止，请完成独立的授权工作，并说明确切缺失的能力。不要将故事板、合成屏幕或静默预览描述为完成的带旁白的 SOP。