Communitygithub.com

beimeibeile/Remotion-controls-skill

使用 React/TypeScript 程式碼精確控制 2D 動畫,原生支援透明背景 (Alpha 通道) 渲染,可輸出 WebM/MOV 帶透明通道影片,適用於剪映模板動畫素材製作、UI 動畫、文字排版動畫、角色 2D 動畫等場景。提供 API 服務化、模板庫、品質控制和自學習進化能力。

Remotion-controls-skill 是什麼?

這是一個專業的 Remotion 程式碼驅動影片動畫控制技能。它讓開發者能夠使用 React 和 TypeScript 精確控制 2D 動畫的每一幀,並原生支援透明背景 (Alpha 通道) 渲染,能輸出包含透明通道的 WebM (VP9) 與 MOV (ProRes 4444) 影片格式。此技能的核心優勢在於其精確可控性(相較於 ComfyUI 的 AI 生成或 Blender 的 3D 動畫),特別適合需要對位、疊加的動畫素材製作,如剪映模板、UI 動畫、文字排版和 2D 角色動畫。技能提供完整的 API 服務化架構、預設動畫模板庫、自動化品質控制(含 Alpha 通道完整性檢測)以及基於渲染參數與效果評分的自學習進化能力。它與 ai-video-editor 等更高階的編排系統整合,接收動畫指令後渲染出帶透明背景的影片,作為上層模板的動畫素材層。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add beimeibeile/Remotion-controls-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Remotion Controls Skill

用程式碼驅動影片動畫的專業控制技能。Remotion 是一個基於 React 的影片創作框架,用程式碼精確控制每一幀,原生支援透明背景渲染。

核心能力

能力說明
透明背景渲染原生支援 Alpha 通道,輸出 WebM(VP9) / MOV(ProRes 4444) 帶透明影片
程式碼精確控制用 React/TypeScript 精確控制位置、縮放、旋轉、透明度、緩動曲線
API 服務化HTTP API 接收動畫指令,輸出影片檔案
模板庫預設動畫模板(角色動畫、UI 動畫、文字動畫、轉場特效)
品質控制幀率、解析度、碼率、Alpha 通道完整性自動檢測
自學習進化記錄渲染參數與效果評分,最佳化預設參數

與 ComfyUI / Blender 的定位差異

技能核心優勢適用場景
ComfyUI-controlsAI 生成(圖/影片/音訊),創意不可控角色圖/場景圖/特效影片生成
Blender-controls3D 動畫,物理模擬,高品質渲染3D 角色動畫、產品展示、物理特效
Remotion-controls2D 程式碼動畫,精確可控,透明背景模板動畫素材、UI 動畫、文字排版、2D 角色動畫

快速開始

1. 安裝依賴

cd remotion-project
npm install

2. 渲染透明背景影片

# CLI 方式
npx remotion render src/index.ts MyComp out/video.webm --transparent

# API 方式
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent

3. 啟動 API 服務

python remotion_controls.py serve --port 8765

透明背景渲染說明(已驗證流程)

Remotion 原生支援透明背景,但 CLI 的 --transparent 編碼會遺失 Alpha 通道(WebM VP8/VP9、MOV ProRes 均驗證失敗)。

已驗證的正確流程(PIT-024):

  1. PNG 序列渲染:npx remotion render src/index.ts Composition out/frames --sequence(輸出帶 Alpha 的 PNG 序列)
  2. ffmpeg 合成 ProRes 4444:
    ffmpeg -y -framerate 30 -i out/frames/%04d.png \
      -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \
      out/animation.mov
    
  3. 驗證 Alpha 通道:python verify_animation.py out/animation.mov

剪映整合注意事項(PIT-024):

  • add_media_safe 匯入 ProRes 4444 mov 時會自動轉碼為 H.264 mp4,遺失 Alpha(66MB→0.07MB)
  • 必須手動匯入:直接複製 mov 到草稿 materials 目錄 → 建立 VideoMaterial → 註冊到 materials.videos → VideoSegment(material=anim_material) → add_segment

動畫素材品質標準

完整標準請見 QUALITY_STANDARD.md。

合格動畫素材的硬性指標:

  • Alpha 通道保留(yuva444p12le)
  • ProRes 4444 編碼(profile=4)
  • 解析度/幀率/時長與配置一致
  • 內容覆蓋率 ≥ 50%(10 點取樣)
  • 檔案大小合理(≤15MB/秒)

自動化驗證:

python verify_animation.py <動畫檔案> --duration 20 --width 1080 --height 1920

基礎動畫元件庫

位於 remotion-project/src/components/,所有元件均支援透明背景。

角色與運動元件

元件說明
CharacterSprite角色精靈:多姿態切換、位置/縮放/旋轉/透明度關鍵幀動畫
MotionPath運動路徑:線性/貝塞爾/彈性/彈跳運動
FlashEffect閃白特效:快速淡入緩慢淡出
ShakeEffect震動特效:振幅衰減的隨機震動
FadeEffect淡入淡出:可控淡入/淡出時長
PopEffect彈出特效:彈性縮放彈出
SlideEffect滑動特效:四方向緩出滑動

文字動畫元件(TextAnimations.tsx)

元件說明適用場景
TextReveal逐字顯現:打字機/淡入/上滑/左滑旁白、台詞、標題入場
TextPop彈出文字:縮放/旋轉/彈跳關鍵詞強調、卡點
TextWave波浪文字:逐字正弦浮動趣味風格、背景音樂節奏
TextGlitch故障風:RGB 分離 + 抖動科技感、故障藝術、轉場
TextGradient漸變流光:顏色流動 + 掃光標題、品牌名、高級感
KineticText動態排版:多行組合動畫開場標題、片尾字幕

轉場特效元件(TransitionEffects.tsx)

元件說明適用場景
FadeTransition淡入淡出轉場(in/out/inOut)通用轉場、情緒過渡
SlideTransition滑動轉場(上下左右)場景切換、內容替換
ZoomTransition縮放轉場(推近/拉遠)強調重點、鏡頭推進
WipeTransition擦除轉場(上下左右/對角線)創意轉場、風格化
BlurTransition模糊轉場(先模糊後清晰)夢幻過渡、回憶閃回
GlitchTransition故障風轉場(RGB 分離 + 掃描線)科技感、故障藝術

衝擊特效元件(ImpactEffects.tsx)

元件說明適用場景
PunchImpact拳擊衝擊(衝擊波 + 星星 + 白閃)打鬥、擊打、碰撞
ImpactFlash衝擊閃光(快速白閃)重擊、爆炸、卡點
ParticleBurst粒子爆發(星星/火花/碎片)慶祝、爆炸、衝擊
Shockwave衝擊波(多環擴散)能量釋放、爆炸、震感
SpeedLines速度線(放射狀)高速衝擊、衝刺、連擊

使用範例:

import { PunchImpact, ParticleBurst, FadeTransition } from "./components";

// 打鬥場景
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />

使用範例:

import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";

<CharacterSprite
  poses={[
    { name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
      position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
    { name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
  ]}
  width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="被打了!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="痛!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />

專案結構

remotion-controls-skill/
├── SKILL.md                    # 本檔案
├── QUALITY_STANDARD.md         # 動畫素材品質標準
├── verify_animation.py         # 自動化驗證工具
├── remotion_controls.py        # 主控制腳本(CLI/API)
├── .env.example                # 環境變數範例
├── .gitignore
├── capabilities/
│   ├── cap_api_wrapper/        # Remotion API 封裝
│   ├── cap_animation_renderer/ # 動畫渲染器
│   ├── cap_template_library/   # 動畫模板庫
│   ├── cap_quality_control/    # 品質控制
│   └── cap_self_evolution/     # 自學習進化
├── remotion-project/           # Remotion 專案
│   ├── src/
│   │   ├── components/         # 基礎動畫元件庫
│   │   │   ├── CharacterSprite.tsx
│   │   │   ├── MotionPath.tsx
│   │   │   ├── Effects.tsx
│   │   │   └── index.ts
│   │   ├── AnimationTemplate.tsx  # JSON 驅動的動畫模板
│   │   ├── Root.tsx
│   │   └── index.ts
│   ├── public/                 # 靜態素材(角色/道具圖片)
│   └── package.json
└── out/                        # 渲染輸出

能力模組

cap_api_wrapper — Remotion API 封裝

  • render_media():渲染影片(支援透明背景)
  • render_still():渲染單幀圖片
  • select_composition():取得可用 Composition 列表
  • get_props_schema():取得 Composition 的 Props 定義

cap_animation_renderer — 動畫渲染器

  • 輸入動畫指令 JSON → 輸出透明背景影片
  • 支援關鍵幀動畫(位置/縮放/旋轉/透明度)
  • 支援緩動曲線(ease-in/ease-out/ease-in-out/linear/spring)
  • 支援多圖層合成

cap_template_library — 動畫模板庫

  • 角色動畫模板(豆包被打、表情切換等)
  • UI 動畫模板(按鈕點擊、頁面切換等)
  • 文字動畫模板(打字機、淡入淡出、彈跳等)
  • 轉場特效模板(淡入淡出、滑動、縮放等)

cap_quality_control — 品質控制

  • 幀率檢測(24/30/60fps)
  • 解析度檢測(1080p/4K)
  • Alpha 通道完整性檢測
  • 影片時長與預期比對
  • 檔案大小合理性檢查

cap_self_evolution — 自學習進化

  • 記錄渲染參數與效果評分
  • 最佳化預設參數
  • 產生最佳實踐文件
  • 模板效果排行榜

環境變數

REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765

與 ai-video-editor 的整合

Remotion-controls-skill 作為 ai-video-editor 的動畫素材製作工具:

  1. ai-video-editor 的導演引擎輸出動畫指令
  2. Remotion-controls-skill 接收指令,渲染透明背景影片
  3. 透明背景影片作為剪映模板的動畫素材層
  4. 使用者替換背景後,動畫完美疊加

注意事項

  • Remotion 需要 Node.js 18+ 環境
  • 透明背景影片建議使用 WebM 格式(剪映相容性佳)
  • 長影片渲染耗時較長,建議分段渲染後合成
  • 動畫中避免使用 CSS 濾鏡(部分濾鏡不支援透明背景)

相關技能