Skip to content

ZJU-REAL/Easel / skills/builtin/slideshow-video

slideshow-video

Verified

图片相册 → 视频:把一组图片做成带 Ken Burns 缓慢缩放、图间转场、背景音乐和逐图字幕的视频,自动适配平台画幅(竖版/方形/横版)。当用户说 图片转视频、图片做成视频、相册视频、照片视频、一组图生成视频、图片轮播视频、幻灯片视频、把这几张图做成短视频、图集成片、卡点图片视频 时使用。基于 shared/scripts/slideshow.py 确定性 ffmpeg 封装。与 auto-short-video 区别:auto-short-video 从一句话主题自动生成配图/配音成片,本 SKILL 用用户已有的图片直接拼成视频。

图片相册 → 视频

把一组图片拼成一条视频:Ken Burns 缓慢缩放 + 图间转场 + 背景音乐 + 逐图字幕, 自动适配目标画幅。全部走 skills/shared/scripts/slideshow.py,不要手拼 zoompan / xfade——脚本已处理帧数换算、转场偏移、音画时长对齐。

只做"已有图片 → 视频"。从主题自动生成配图/配音的完整流水线见 auto-short-video; 已有视频的剪辑见 video-editing;单张封面/海报见 poster-hero。

输入

字段必填说明
图片是一组图片路径(按顺序),或一个图片目录(按文件名排序)
画幅是用户或上游任务未明确横版/竖版/方形(或具体分辨率)时,制作前必须追问并等确认;不得按平台、Profile 或默认值静默推断,已明确则不重复问
每图时长否默认每张 3 秒
转场否默认淡入淡出 fade;none 为硬切
BGM否背景音乐文件(自动循环/裁到片长/尾部淡出)
逐图字幕否每张图配一句字幕

输出(outputs/主题名/)

  • 成片视频(*.mp4)
  • 报告:图片数、总时长、画幅、转场方式、是否带 BGM

执行步骤

脚本路径(相对项目根):skills/shared/scripts/slideshow.py(build -h 看全部参数)。

基本用法

python skills/shared/scripts/slideshow.py build \
  -i 1.jpg 2.jpg 3.jpg -o outputs/主题名/show.mp4 \
  --size 1080x1920 --per 3 --transition fade

带 BGM + 逐图字幕

python skills/shared/scripts/slideshow.py build --images-dir ./photos \
  -o outputs/主题名/show.mp4 \
  --bgm ./music.mp3 --bgm-volume 0.7 \
  --captions "开场一句|第二张说明|第三张说明"

字幕也可用 --captions-file <文件>(每行对应一张图)。

常用变体

  • 静止画面(不缩放):--no-kenburns,配 --fit pad(补边)或 --fit crop(裁满)。
  • 换转场:--transition 可选 fade/fadeblack/fadewhite/wipeleft/wiperight/slideup/slidedown/circleopen/dissolve/none。
  • 平台画幅:小红书/抖音竖版 1080x1920,朋友圈/ins 方形 1080x1080,B站/横版 1920x1080。

Profile 感知

  • 有 Profile:platforms.md 只用于给出画幅建议,仍须用户确认;字幕语气贴合 style.md; BGM 风格建议贴合账号调性(欢快/治愈/燃)。
  • 无 Profile:先确认横版/竖版/方形;转场默认 fade + Ken Burns。

规则

  1. 图片顺序 = 视频顺序;用 --images-dir 时按文件名排序,必要时先重命名。
  2. 转场时长自动限制在每图时长内(不超过 --per)。
  3. BGM 自动循环补足并裁到成片长度、尾部淡出;无 BGM 时补静音轨方便上传。
  4. 逐图字幕数量可少于图片数(多出的图不加字幕),不要求一一对应。
  5. 产物统一进 outputs/主题名/。

参考来源

Ken Burns(缓慢缩放位移)+ 交叉转场 + BGM 是相册/图集视频的标准做法(MoneyPrinterTurbo 等短视频工具同款思路);本 SKILL 复用 auto-short-video 合成器的 zoompan 方案,把帧数换算与 xfade 偏移计算封装成确定性脚本,避免手写滤镜链出错。

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall