幻灯片动画 (/animate-slides)
将用户提供的一系列关键帧图像转化为忠实的2D代码绘制,并为每一对连续帧 (第i帧 -> 第i+1帧) 编排流畅、富有表现力的运动过渡视频(使用 motion-reel 技能),为Motion Presentation Studio做好准备。
适用范围 vs
/new-motion-presentation:
- 当用户已经拥有预制的演示幻灯片图像(
01.png,02.png, ...)并且希望模型在视觉上忠实于原始幻灯片布局,同时生成它们之间的动态过渡时,使用/animate-slides。- 当从零开始(根据主题、大纲或产品URL)创作演示文稿,拥有高度创作自由并需要生成“静止姿态空闲运动循环”(
XX_loop.mp4)时,使用/new-motion-presentation。
创作自主权: 忠实于用户帧的视觉外观和确切的帧顺序,同时对过渡编排、节奏和时序保持完全的创作自由,除非用户指定了约束。转换默认无音频(静音),除非用户明确要求添加声音。
1. 等待并验证帧序列(强制性入口)
-
等待帧路径: 如果用户在调用
/animate-slides时没有提供帧文件夹(或图像文件)的路径,请询问帧路径并停止。不要猜测路径或编造帧。 -
检查并验证数字排序: 一旦提供了路径,从工作区根目录运行检查辅助脚本:
node ".agents/skills/animate-slides/scripts/inspect_frames.mjs" "<frames_path>"每个帧文件名必须包含一个明确的排序数字(例如,
01_intro.png,frame_2.png,03-architecture.png)。 -
澄清关卡 —— 如果
needsClarification为true,则停止并向用户询问: 如果出现以下任何情况,请不要猜测或回退到字母顺序:- 任何帧文件名没有排序数字(
UNNUMBERED_FRAMES)。 - 文件名中的多个数字导致序列顺序不明确(
AMBIGUOUS_FRAME_NUMBERS)。 - 两个或更多帧解析为相同的排序数字(
DUPLICATE_ORDER_NUMBERS)。 - 路径不存在、不包含支持的图像或包含少于2个帧(
PATH_NOT_FOUND,NO_FRAMES_FOUND,FEWER_THAN_TWO_FRAMES)。
列出检测到的文件和具体的不明确之处,然后等待用户的澄清后再继续。 (如果
warnings提到IRREGULAR_NUMBER_GAPS或MIXED_DIMENSIONS,仅在看起来非预期时才与用户确认。) - 任何帧文件名没有排序数字(
2. 读取并解构每一帧
- 在搭建或渲染之前阅读
motion-reel技能说明:C:\Users\Mohamed\.gemini\config\plugins\motion-reel\skills\motion-reel\SKILL.md
- 按顺序(
1 .. N)直接检查每个有序帧图像(read_file)。 - 对于每帧,分解其视觉结构以便能用代码绘制:
- 画布与调色板: 背景色调/渐变、卡片表面、边框、强调色、精确的十六进制值。
- 排版与文案: 字体系列/权重/层级、确切文本(阿拉伯语/英语,RTL/LTR对齐)。将所需字体文件复制/打包到
fonts/,并验证非拉丁字形能干净渲染,不会出现损坏的 fallback 字体。 - 2D几何与组件: 卡片、徽章、图表、图标、连接器、分隔线、药丸状指示器、进度指示器和几何图案。
- 光栅元素(仅在真正需要时): 如果帧嵌入了不应以矢量路径近似的真实摄影或复杂品牌艺术作品,请将实际资源保存/引用到
assets/中,并将其与2D代码绘制图层干净地合成。
- 映射逐对关系(
第1帧 -> 第2帧,第2帧 -> 第3帧,...):- 识别可以在剪辑过程中变形、移动、调整大小或重新锚定的持久/共享元素。
- 识别退出和进入的图层,使移动感觉有动机而非平淡的交叉淡入淡出。
3. 通过 /motion-reel 构建2D代码绘制与运动过渡
遵循 motion-reel 的核心架构(window.seek(t) 纯时间函数,仅使用种子噪声,闭式弹簧 springU/springKeys,kf,E.*,layout/glyph,运动模糊和批评循环):
-
每帧的模块化2D代码绘制:
- 将每帧(
第1帧..第N帧)表示为一个可重用的2D Canvas 绘图模块/函数(其中图层和元素可以参数化以控制偏移、缩放、不透明度、裁剪、变形进度、描边绘制等)。 - 在过渡
(k-1 -> k)的结束和过渡(k -> k+1)的开始之间共享完全相同的第k帧代码定义,确保演示文稿的无缝连续性。
- 将每帧(
-
连续帧之间的过渡影片(
N - 1个过渡):- 清晰地搭建或结构化每个过渡(例如,放在专用工作区文件夹中,如
reels/<project-slug>/t01-02/,t02-03/, ...,从而保持app/src/不变)。 - 边界连续性契约:
- 在
t = 0时: 渲染的画布必须忠实地匹配第i帧(相同的构图、颜色、排版和几何形状——无空白导入、无从黑场淡入、无突然弹出)。 - 在
0 < t < duration期间: 编排富有表现力、有目的性的2D运动(元素交接、形状变形、错开弹簧、定向擦拭/裁剪、对数空间中的摄像机推拉、重叠时序)。 - 在
t = duration时: 渲染的画布必须干净地稳定在第i+1帧上,零漂移。
- 在
- 音频策略(默认静音)与节拍网格:
- 默认——无音频(
--video-only): 除非用户明确要求声音/SFX/音乐,否则生成静音过渡视频(render.mjs --film <film> --format <f> --video-only,输出无音轨的 H.264.mp4)。不要生成music.wav、sfx.wav或运行mix.mjs。 render.mjs和motion.js仍然需要<film>/beats.json(offset,period,beats数组)用于节拍定时和--contact表;对于静音过渡,编写一个与您过渡节奏匹配的干净beats.json网格(例如,120 BPM ->period: 0.5)。- 当用户明确要求声音时: 使用
motion-reel的音频管线(beats.py/score.py,sfx.mjs,mix.mjs)并将其混流到最终的.mp4中。
- 默认——无音频(
- 格式与分辨率:
- 匹配来自
inspect_frames.mjs的detectedFormat(宽屏1920x1080幻灯片为16x9,竖屏为9x16,正方形为1x1)。如果帧使用非标准的16:9尺寸(例如1280x720),则在1920x1080的画布空间中按比例绘制。
- 匹配来自
- 清晰地搭建或结构化每个过渡(例如,放在专用工作区文件夹中,如
-
视觉验证(交付前检查):
- 对于每个过渡视频,检查:
- 第一帧(
--at 0)与输入的第i帧 - 过渡中段截图(
--strip 0:<duration>:8)以验证运动弧线、模糊、重叠和无空白帧 - 最后一帧(
--at <duration>)与输入的第i+1帧
- 第一帧(
- 迭代直到每个端点干净对齐,并且每个过渡看起来有意图、清晰且充满动感。
- 对于每个过渡视频,检查:
4. 交付,为 Motion Presentation Studio 做好准备
将最终的演示资产导出到一个干净的输出文件夹(例如,out/<project-slug>/presentation/ 或用户指定的目录),使用 Motion Presentation 的 SmartPairer 能通过拖放自动配对的文件名:
- 幻灯片(有序PNG):
01_frame.png,02_frame.png, ...,0N_frame.png(匹配精确的开始/结束视觉状态) - 过渡视频(H.264
yuv420p,60 帧/秒.mp4):01-02_transition.mp4,02-03_transition.mp4, ...,0(N-1)-0N_transition.mp4 - 原生
presentation.json清单(用于 Motion Presentation Studio 的手术式AI编辑提示构建器):{ "skill": "animate-slides", "title": "<演示标题>", "aspectRatio": "16:9", "projectRootPath": "<reels/<project-slug> 的绝对路径>", "outputDirPath": "<输出文件夹的绝对路径>", "slides": [ { "index": 1, "title": "幻灯片 1", "frameFile": "01_frame.png", "transitionVideoFile": "01-02_transition.mp4", "slideCodeFile": "scenes/slide_01.js", "transitionCodeFile": "t01-02/film.js" } ] }
使用 ffprobe 验证每个最终的 .mp4(持续时间,60 帧/秒,yuv420p,默认无音轨,除非明确要求声音),并向用户报告输出文件夹路径和所有生成的过渡摘要。