Communitygithub.com

thevibethinker/n5os-ode

使用 React 和 Remotion 以编程方式创建视频。脚手架项目、编写合成并渲染 MP4。针对 Zo 优化,是官方 Remotion 技能代理的封装。

n5os-ode 是什么?

该技能基于 Remotion 框架,使开发者能够通过 React 组件以编程方式生成视频。与传统视频编辑或 AI 生成的视频不同,它允许精确控制视频的每一帧、每个元素和动画,非常适合数据驱动的视频、批量模板渲染、产品演示或社交媒体动画内容(如 TikTok、Reels、Shorts)。 技能提供了完整的 CLI 工具链,包括新建项目、启动预览工作室以及渲染 MP4 输出。所有动画必须帧驱动(使用 `useCurrentFrame()`),禁止使用 CSS 动画,确保视频渲染一致性。支持 `Composition`、`Sequence`、弹簧动画等核心模式,以及淡入淡出、交错元素、数据驱动视频等常见模式。 该技能特别针对 Zo 平台优化:项目存储在 `Sites/<name>/` 目录下,支持通过 `/zo/ask` 批量并行渲染视频。它包装了官方 Remotion 代理技能,并引用了 10 个详细参考规则文件(涵盖动画、配乐、字幕、图表等),方便深入使用。 需要注意的是,视频渲染为 CPU 密集型任务,复杂视频需要更长时间。项目依赖 Node.js 环境(Zo 中已提供)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

在你喜欢的 AI 中提问

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

文档

何时使用

在以下情况下使用此技能:

  • 通过代码创建程序化视频(非生成式 AI 视频)
  • 构建数据驱动的视频内容(图表、统计、个性化视频)
  • 根据模板和数据批量生成视频
  • 创建动画社交媒体内容(TikTok、Reels、Shorts)
  • 构建需要精确控制的产品/解释性视频

快速入门

1. 创建新项目

python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video

2. 编写你的合成

编辑 src/Composition.tsx —— 这是你的视频,定义为 React 组件。

3. 在工作室中预览

python3 Skills/remotion/scripts/remotion_cli.py studio my-video

4. 渲染为 MP4

python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4

核心概念

合成

合成定义了视频的尺寸、时长和帧率:

<Composition
  id="MyVideo"
  component={MyComponent}
  durationInFrames={300}  // 10秒,30fps
  fps={30}
  width={1920}
  height={1080}
/>

基于帧的动画

所有动画必须使用 useCurrentFrame()。禁止使用 CSS 动画。

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

序列

使用 <Sequence> 来控制元素出现的时间:

<Sequence from={30} durationInFrames={60}>
  <Title />
</Sequence>

规则参考

阅读以下文件以获取详细模式(从上游 Remotion 技能加载):

规则描述
references/animations.md基于帧的动画基础
references/timing.md弹簧、缓动、插值曲线
references/compositions.md定义合成、静态帧、文件夹
references/sequencing.md元素的时序和排序
references/videos.md嵌入视频——裁剪、音量、速度
references/audio.md音频处理——导入、裁剪、音量
references/assets.md图片、字体、静态文件
references/transitions.md场景过渡
references/text-animations.md排版动画模式
references/charts.md数据可视化模式
references/display-captions.mdTikTok 风格字幕

CLI 命令

# 项目管理
python3 Skills/remotion/scripts/remotion_cli.py new <name> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <name>
python3 Skills/remotion/scripts/remotion_cli.py render <name> [--composition ID] [--output path]
python3 Skills/remotion/scripts/remotion_cli.py list

# 渲染选项
--composition ID    # 要渲染的特定合成(默认:第一个)
--output PATH       # 输出文件路径(默认:out/video.mp4)
--fps N             # 覆盖 FPS
--width N           # 覆盖宽度
--height N          # 覆盖高度
--codec CODEC       # h264, h265, vp8, vp9, prores(默认:h264)

常见模式

淡入/淡出

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

弹簧动画(自然运动)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // 平滑,无弹跳
});

交错元素

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

数据驱动视频

type VideoProps = { title: string; stats: number[] };

export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
  // 根据属性进行动画
};

// 在 Root.tsx 中:
<Composition
  id="DataVideo"
  component={DataVideo}
  defaultProps={{ title: "Q4 结果", stats: [10, 20, 30] }}
  // ...
/>

与 Zo 集成

批量渲染

使用 /zo/ask 并行渲染多个视频:

for row in data:
    # 每次调用使用不同的属性进行渲染
    await render_video(row)

输出位置

项目位于 Sites/<name>/ 目录下,以保持与 Zo 站点系统的一致性。 渲染后的视频输出到 Sites/<name>/out/。

限制

  • 无 CSS 动画 —— 它们无法正确渲染
  • 无 Tailwind 动画类 —— 同样的问题
  • 仅限基于帧的动画 —— 所有运动都来自 useCurrentFrame()
  • CPU 密集型 —— 渲染需要时间;复杂视频需要更长的渲染时间
  • 需要 Node.js —— Remotion 需要 Node 环境(Zo 中已提供)

相关技能