| name | it-infra-evolution-video-v2 |
| version | v2 |
| description | 从 it-infra-continuous-png 的真实 PNG manifest 生成 IT 基础设施长图讲解视频。强制执行 manifest -> video.config.json -> index.html -> audio -> HyperFrames acceptance -> MP4 -> ffprobe 的闭环。 |
IT 基础设施长图讲解视频 v2
生成或重绘图片规则
只要上游素材流程需要生成、扩图、修复或重绘静态 PNG，必须先读 ../../marketplace/pptx/editable-reconstruction.md，复用其中的图片模型优先级、无字生成和残影验收规则。生成图片中不得烘焙标题、数字、标签、字幕或伪文字；这些内容必须由 manifest、video.config.json 和 HyperFrames/HTML 层承载。
本 skill 仍只消费通过 manifest 校验的真实 PNG。该引用不允许绕过 it-infra-continuous-png 前置条件，也不允许用 CSS、SVG 或伪 PNG 代替输入。
本 skill 是 it-infra-evolution-video 的可执行 v2 路径。v1 模板保持 frozen；v2 的主路径必须通过仓库 runner 完成，不再让 Agent 临时手写 generate_index.py 或自由拼接模板片段。
调用前置条件
必须先完成 it-infra-continuous-png：
assets/images/*.png 存在，且每个文件是真实 PNG。assets/images/manifest.md 存在。- manifest 每一行都包含
chapter_id、title、file、source_type、video_usage、scan_mode、safe_focus。
缺少这些输入时，不要继续生成视频，不要用 CSS 卡片、假截图或 SVG 冒充 PNG。
标准调用
在 Bridge 预先准备的当前任务 artifact scope 中执行。目录解析优先使用
$XWORKMATE_TASK_ARTIFACT_DIR / $XWORKMATE_ARTIFACT_DIRECTORY，其次使用
本轮系统上下文里的 artifactDirectory: ...；只有当前 pwd 已经是
.../tasks/<session>/<run> 时才可直接使用 .。
cd "${XWORKMATE_TASK_ARTIFACT_DIR:-${XWORKMATE_ARTIFACT_DIRECTORY:-.}}"
python3 "${AI_VIDEO_SKILLS_HOME:-/home/ubuntu/ai-video-skills}/scripts/build_it_infra_video.py" \
--project-dir . \
--title "云原生 Service Mesh 网络科普视频" \
--audio-mode edge-tts \
--run-acceptance \
--output-name service-mesh-video.mp4 \
--require-task-scope \
--session-key "$XWORKMATE_SESSION_KEY" \
--run-id "$XWORKMATE_RUN_ID"
在 XWorkmate/OpenClaw 中，. 必须是 Bridge 预先准备的
tasks/<safe-session-key>/<safe-run-id> artifact scope。不能在
owners/.../threads/<session> 工作区直接渲染，也不能在 scope 内再创建
task_artifacts/<session>/... 二次嵌套目录；如果只知道
artifactScope，可用 --artifact-scope "tasks/<safe-session-key>/<safe-run-id>"
代替 --session-key/--run-id。
OpenClaw 任务中如果同时选择了 it-infra-continuous-png 和 it-infra-evolution-video-v2，必须按以下顺序执行：
- 先用
it-infra-continuous-png 生成多张 PNG 和 manifest。
- 再用本 skill 的 runner 读取 manifest。
- 最后只把最终 MP4 作为 XWorkmate 制品输出。
video.config.json、assets/images/manifest.md、ffprobe.json、DELIVERY.md、音频、snapshot、HTML 等中间/验收文件可以留在当前 tasks/<session>/<run> workspace 内供调试，但不得作为最终制品同步或报告。
XWorkmate 制品输出约定
本 skill 的 XWorkmate 最终制品只允许包含一个 MP4：
- 最终 MP4 必须写入
renders/<output-name>.mp4，推荐默认 renders/service-mesh-video.mp4。
- 完成回复只报告这个 MP4 的相对路径和简短说明，不要列出
video.config.json、ffprobe.json、index.html、音频、snapshot、manifest、DELIVERY.md 或其他中间文件作为制品。
- 不要为了同步中间产物而把它们复制到
deliverables/、reports/、artifacts/ 或任务 scope 根目录。
- 如果运行环境提供制品过滤、manifest 或导出列表，只把
renders/<output-name>.mp4 标记为 final/exportable；其他文件标记为 intermediate/debug 或完全不列入导出列表。
- 如果最终 MP4 不存在或
ffprobe 不通过，任务必须失败，不要用中间产物替代交付。
Runner 合同
runner 负责：
- 解析并校验 manifest。
- 拒绝缺失图片、伪 PNG、缺失列、非法
scan_mode。
- 生成唯一 ID 的
index.html。
- 保证 scene、caption、voiceover 在各自 track 上不重叠。
- 只保留一个全局 BGM 音轨。
- 生成
video.config.json 和 inspectTimes。
- 生成
build_ffmpeg_video.sh 作为 HyperFrames 之外的应急合成路径；该脚本必须从 video.config.json 的 sections 动态生成章节标签、时间、active marker、总进度条和音频 delay，禁止手写固定 6 段、固定 25 秒、固定标题。
- 执行
lint -> inspect -> snapshot -> render -> ffprobe。
生产模式默认 --audio-mode edge-tts。本地测试或无网络 dry-run 可以使用 --audio-mode tone，但不能把 tone 输出当作正式口播成片。
验收标准
只有以下文件都存在，才能在 XWorkmate/OpenClaw 中报告完成；但除最终 MP4 外，这些文件只是验收证据，不是最终制品：
index.htmlvideo.config.jsonassets/images/manifest.mdassets/audio/*.mp3assets/audio/bgm.wavrenders/<output-name>.mp4ffprobe.jsonDELIVERY.md
ffprobe.json 必须显示：
- 分辨率为
1920x1080
- 有 video stream
- 有 audio stream
- 时长接近
video.config.json 的 duration
如果 HyperFrames 或 ffprobe 任一阶段失败，只输出失败阶段和原因，不输出“完成”。
完成时的制品同步范围必须仍然只包含 renders/<output-name>.mp4。
FFmpeg fallback timeline text
如果因为长版、快速修复或 HyperFrames 之外的 fallback 路径使用 FFmpeg 直接合成 timeline，不能只用 drawbox 绘制底部色块。必须同时绘制可见章节文字：
- 优先使用
/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc 或 fc-match "Noto Sans CJK SC" 返回的中文字体。
- 优先使用 runner 生成的
build_ffmpeg_video.sh，不要在任务现场临时手写 build_long_video.sh 或固定数组脚本。
- 每个章节 marker 必须包含时间和短标题，例如
0:25 服务器是一座孤岛。
- 必须保留 v1/HyperFrames 风格的底部总进度条：一条低透明底线加一条随全片时间推进的高亮进度线。
- 修复后必须从最终 MP4 抽帧确认底部 timeline 文字和总进度条都可见，不能只依赖脚本执行成功。
