Communitygithub.com

轨道卷轴

肖像图像卡片在说话者周围呈3D环形运动,从头部后方穿过并经过前景。提供竖屏(9:16)和横屏(16:9)版本。用于/orbit-reel或将此特定效果应用于说话人头视频片段。

轨道卷轴 是什么?

“轨道卷轴”是一项AI代理技能,用于为说话人头视频片段添加动态3D环形图像卡片效果。它通过一个4.2秒、30帧/秒的HTML模板,在说话人周围创建一个保持3D透视的场景,卡片从z轴负值区域(说话人后方)移动到正值区域(前景),营造出环绕的视觉体验。该技能支持竖屏(1080x1920)和横屏(1920x1080)两种格式,通过spec.json中的format参数选择。使用时,技能通过build.py脚本处理spec文件,接受用户提供的视频素材(如speaker.mp4和speaker_cut.webm),并输出渲染后的MP4文件至.work/目录。它依赖Python 3.9+、ffmpeg/ffprobe和Node.js 22+/npm,首次构建时会自动下载GSAP 3.15.0库,并使用HyperFrames 0.8.214进行渲染。技能要求用户提供与说话人视频匹配的alpha抠图(可通过kit/cutout.py生成),并确保卡片初始位置在时间轴0帧上。该技能特别适用于本地Claude Code编辑工作流,不涉及API密钥或转录文本,并遵循统一的设计风格(Inter字体、#5000fa强调色、白色软阴影字幕等)。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/orbit-reel

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

/orbit-reel

使用4.2秒、30帧/秒的模板将此效果应用于说话人头视频片段:template.html为竖屏(1080x1920);template-16x9.html为横屏(1920x1080),在spec中通过"format": "horizontal"选择。风格和图像与说话人的话语无关;请遵循用户选择的主题。

使用

从技能加载时显示的基础目录解析此技能文件夹。其build.py通过该实际路径解析共享工具包,包括作为符号链接安装时。运行:

python3 /path/to/skills/orbit-reel/build.py /path/to/spec.json

不附带示例说话人。通过spec的assets(键为speaker.mp4 / speaker_cut.webm,也用于横屏模板的1920x1080文件)提供用户素材,或将其放入assets/my-media/一次(参见其README),然后不带spec运行。输出位于仓库的.work/目录。--prepare-only会构建可编辑的组合但不渲染。需要Python 3.9+、ffmpeg/ffprobe和Node.js 22+/npm。首次构建将固定版本的GSAP 3.15.0下载到忽略的厂商缓存中;渲染使用HyperFrames 0.8.214。这些简短模板不需要转录或API密钥。Spec和自定义素材说明。

调整效果

保持一个带透视的单一preserve-3d场景,并在z=0处放置一个与帧匹配的alpha主讲人。z为负值的卡片从说话人后方穿过;z为正值的卡片从前景穿过。保持基础视频和抠图在同一源偏移上。示例使用八张卡片、一个570px的水平轨道和290px的深度;根据新的说话人裁剪调整环形。每张卡片的初始姿态必须使用显式的时间轴位置0,以便所有卡片在帧零处存在。

素材键:banana-heels.jpg、blue-stairs.jpg、cactus.jpg、speaker.mp4、speaker_cut.webm、pixel-burger.jpg、pixel-fruit.jpg、red-stairs.jpg。全分辨率示例图像和来源鸣谢见assets/style-showcase。

更换主讲人时,提供相同尺寸、与帧匹配的alpha抠图。现有的kit/cutout.py可以创建它;请参见共享指南。在明暗图像上检查头发和手部。构建助手不会自动执行分割。

确保主讲人从第一帧结果开始可见。使用清晰的照片和干净的文字。关键文字和面部应避开平台叠加层;让装饰性图像溢出,而不是缩小整个构图。模板的字幕和图像锚点只是起点,不是自动跟踪。

审查和交付

助手验证媒体尺寸/时长,准备组合,运行渲染器检查,渲染并完全解码MP4。检查第一帧、主要变化和结尾。检查裁剪锚点、文字可读性以及源素材与抠图的匹配时间。默认为无声;仅当用户要求时保留或添加语音、音效或音乐。更长的编辑需要扩展HTML时间线和源窗口;仅更改时长是不够的。

这些是本地的Claude Code编辑工作流。第三方图像权利与资产目录中的代码许可分开记录。

统一风格

仅使用Inter字体,一种强调色(#5000fa),带柔和阴影的白色字幕,圆角卡片和平面表面。每个节拍只保留一个强调时刻;不要添加额外颜色。要尝试整个工具包中的其他强调色,设置EDIT_ACCENT=#rrggbb,但这些HTML模板直接包含十六进制颜色:在template.html / template-16x9.html中更改它。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能