Communitygithub.com

Craft 2D Animation(EffectCraft + FilmCraft)

指导代理如何规划、构建或剪辑“二维动画制作”,使具体输出成为代理可以逐镜头辩护的动态效果。该流程贯穿 Craft 2D Animation(EffectCraft + FilmCraft),涵盖视觉方向与场景可读性、取景与视觉语法。在接到此类新任务时使用。

Craft 2D Animation(EffectCraft + FilmCraft) 是什么?

该技能为 AI 代理提供了一套完整、可复用的方法,用于在 EffectCraft 中设计、动画化并组装二维动画(如片头、产品演示、短场景或短片),并可选择在 FilmCraft 中进行剪辑和导出,支持带或不带音乐轨道。它强调视觉清晰度:通过限制场景中地点的数量、使用填充的几何形状代替轮廓、确保角色 silhouette 对比以及绘制超大的背景来避免摄像机移动时出现黑边。技能详细介绍了取景与视觉语法,定义了不同镜头景别的叙事作用(如建立镜头、过肩镜头、中景/侧影、特写),并给出了精确的摄像机对焦计算。动画原理部分涵盖了“预备→动作→缓冲/保持”、渐进式姿态变化以及强制静音测试,以确保动作叙事清晰。为避免 EffectCraft 中的常见错误,技能提供了关于父级绑定、锚点设置和堆叠顺序的严格规则,包括为骨骼化二维角色设计的分层层级结构。它还指导如何将场景内文本(V1)与叠加文本(V2)分离,以便灵活导出。为优化资源有限机器上的渲染性能,建议使用关键帧检查而非完整视频渲染,并通过限制线程和优先级进行顺序渲染。最后,它列举了位于 ~/.t3/shared/craft-video/ 下的可重用工具(如 ec_runtime.py、render_ec_batch.sh、assemble_filmcraft.py)和 Python 3.9+、ffmpeg 等依赖项。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

在你喜欢的 AI 中提问

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

文档

Craft 2D Animation(EffectCraft + FilmCraft) 是做什么的?

通用且可复用的方法,用于在 EffectCraft 中设计、动画化并组装片头、产品演示、短场景或短片(在 FilmCraft 中可选剪辑/导出),带或不带音乐轨道。

共享的 CLI/MCP 参考和 Flatpak 权限:../craft-music-video/references/mcp-and-commands.md


1. 视觉方向与场景可读性

  1. 可通过颜色识别的地点:将短场景限制在最多 2 到 3 个地点,每个地点有专属的主灯光和调色板(例如,暖色走廊/夜晚,屏幕照亮的工位,仅保留一种强调色用于错误或警报的明亮房间)。
  2. 填充的轮廓而非空线条:使用填充的几何形状(贝塞尔曲线或圆角矩形)构建角色和装饰,采用极简面部(简单的眼睛、眉毛、嘴),并在光源侧带有一条微弱的逆光线(rim light)。
  3. 轮廓对比:在缩略图阶段就区分每个角色(例如,圆润下蹲的轮廓 vs. 挺直、宽肩且动作干脆的轮廓)。
  4. 为摄像机运动绘制超大的背景:将背景/墙壁画得比画面更宽(对于 1920×1080 的缩放/抖动为 2200–2400 px;对于平移镜头则为 3600+ px),以避免画面边缘出现 10–20 px 的黑边。

2. 取景与视觉语法

变化镜头景别以无需多余文字即可讲述动作:

镜头景别叙事作用技术最佳实践
大远景(Establishing)展示地点、照明和元素的相对位置在返回同一地点时保持固定的空间参考(桌子、屏幕、面板、门)
过肩镜头(OTS)展示角色的目标及其在界面或物体上的视角在第一次尝试与最终成功之间完全重用相同的 OTS 取景,以创建即时的视觉呼应
中景/侧影跟踪姿态、移动和场景的物理变化适合展示逐渐下蹲、椅子后仰或大幅度动作
特写(Close-up)隔离意图、界面细节、按键的手、目光或笑点保持动作短小而清晰;利用特写清理出干净的负空间

摄像机取景计算(cam_focus)

使用锚点空对象 [0, 0],将世界坐标 (tx, ty) 的点以缩放 sc % 居中于尺寸 W × H 的画面中心,精确公式为: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (可直接通过 ec_runtime.py 中的 cam_focus(tx, ty, scale_pct, width, height) 使用)。


3. 姿态变化、重量与视觉节奏

  1. 预备 → 动作 → 缓冲/保持:
    • 永远不要线性地从姿态 A 过渡到姿态 B。
    • 在动作前添加一个小的反向预备运动(例如,手指抬起犹豫后再敲击键盘;门先轻微打开再砰地关上;身体支撑后再后退)。
    • 以轻微的过冲或清晰的停顿结束,以赋予重量感(例如,角色后退一步并暂停欣赏自己的作品)。
  2. 渐进式姿态阶梯:在等待或紧张升级时,让姿态在两个镜头之间通过清晰的阶梯变化(上身倾斜、低头、手臂放松),而不是持续晃动。
  3. 在两个动作之间保持镜头静止:让构图在重点之间呼吸(眨眼、缓慢的微距缩放、光标闪烁),而不是持续晃动所有图层。
  4. 强制无声测试:不带声音(或通过 3–5 个关键帧 render-frame 抓取)观看任何动作、片头或演示场景。角色的目标和场景的进展必须 100% 仅通过画面可理解。

4. 角色锚点、摄像机与堆叠顺序(EffectCraft 陷阱)

这些规则可避免 EffectCraft 中的偏移、肢体分离或元素隐藏等错误(兼容 After Effects 行为):

A. 空对象与摄像机

  • comp.layers.addNull() 默认创建锚点为 [50, 50]、位置为 [960, 540] 的空对象。在定位或父级绑定空对象之前,始终强制设置 anchorPoint.setValue([0, 0])(ec_runtime.py 中的 makeCamNull 正是这样做的)。
  • 始终在 child.position.setValue(...) 之前将 child.parent = parent,以便子对象的坐标直接在父对象的局部坐标系中解释。

B. 父级绑定与变换的绝对规则

  • 在父对象处于中性姿态(rotation = 0°,scale = [100, 100])时绑定所有子对象。
  • 仅在完整创建整个子层级之后再应用初始旋转、摄像机缩放或父对象的关键帧。
  • 原因:在设置 child.parent = parent 之前修改 parent.rotation 或 parent.scale 会触发 AE 风格的逆向补偿,导致头部/手臂脱离身体,或使整个背景缩到画面一角。

C. 骨骼化 2D 角色的锚点层级

  • 坐姿角色:Root 位于臀部(hip_pos)→ Chair、Legs、TorsoNull(腰部枢轴 [0, 0])→ BackUpperArm(肩部)→ BackForeArm(肘部)→ TorsoBody → Head(颈部底部)→ UpperArm → ForeArm。
  • 站姿角色:Root 位于双脚之间的地面(foot_pos),以便在缩放或后退时保持鞋子贴地 → LegBack / LegFront(臀部枢轴)+ TorsoPivot(臀部枢轴)→ Arms、Blazer/Body、Head。
  • 颈/领衔接:始终添加一个覆盖躯干顶部和头部底部的实心颈/领形状,以便在强烈倾斜(25°–35°)时不会在下巴与肩膀之间出现缝隙。

D. 堆叠顺序(Stacking Order)

  • 在同一个形状图层(ADBE Root Vectors Group)内部:第一个添加的组绘制在最上方,最后一个在最下方(前 → 后顺序)。
  • 在同一合成的不同图层之间:每个新图层插入到索引 1(最上方)。按后→前顺序构建图层(背景 → 辉光 → 装饰 → 角色 → 前景)。

5. 文本可读性与场景内/叠加分离

  1. 无永久性黑条:将标题、副标题或说明文字放置在每个镜头的可用负空间中(屏幕上方的墙面、暗角、地平线下方),且绝不遮盖面部、屏幕边框或装饰面板。
  2. 对比度与安全边距:
    • 应用柔和的投影(ADBE Drop Shadow,不透明度 190–230,距离 4–6 px,模糊 14–18 px),以确保在浅色和深色背景上均可阅读。
    • 保持水平安全边距(1920×1080 下 >= 70 px)以及可读的保持时间(动作或最后一个单词结束后 >= 0.35 s,包括跨镜头切换时)。
  3. 严格分离:场景内文本(V1)与叠加文本(V2):
    • 融入场景的文本(V1):标牌、屏幕界面、纸张、表格、键盘按键。它们是动画世界的一部分,在所有导出中保留。
    • 叠加文本(V2,ProRes 4444 RGBA):标题、卡片、字幕、歌词或 UI 注释。将它们放置在独立的透明合成中,即可一键导出带标题版本和剪辑完全相同的纯净版本。

6. 视觉检查与资源高效渲染

  1. 在完整视频渲染前的关键帧检查:对每个镜头的 1–2 个关键瞬间使用 effectcraft-cli render-frame --max-side 960(对 V2 叠加层使用 --transparent),以便在几秒内检查取景、关节衔接和文本可读性。
  2. 安全顺序渲染(8GB RAM / 中低端 CPU 机器):
    • 每次只渲染 1 个合成(绝不在 8GB RAM 上并行渲染 ProRes 4444 RGBA)。
    • 限制线程数(RAYON_NUM_THREADS=2,OMP_NUM_THREADS=2),以低优先级运行(nice -n 15 ionice -c 3),如果 VRAM 与系统 RAM 共享则避免使用 --gpu,并在两次渲染之间留出 2 秒以释放内存。

7. 共享 T3 Code 工具与依赖

可重用脚本位于 ~/.t3/shared/craft-video/:

工具路径二维动画用途
EffectCraft 运行时 JSX~/.t3/shared/craft-video/ec_runtime.py导入 JsxBuilder、cam_focus、hex_to_rgba、run_effectcraft_script 以正确生成 .ecproj(锚点 [0,0]、贝塞尔、辉光、平滑/保持关键帧)
顺序批处理渲染~/.t3/shared/craft-video/render_ec_batch.sh以低负载渲染 V* 场景(ProRes HQ RGB)和 L*/T* 叠加层(ProRes 4444 RGBA),通过 ffprobe 自动续传
FilmCraft 组装与导出~/.t3/shared/craft-video/assemble_filmcraft.py将 V1(+ 可选的 V2 alpha 和 A1 音频)组装为 Rec.709 的 .fcproj,并导出 Master + Clean

必要依赖

  • Python 3.9+(仅标准库)
  • ffmpeg 和 ffprobe
  • EffectCraft CLI(effectcraft-cli 或 Flatpak ai.storyteller.effectcraft 并带有 --filesystem 访问权限)
  • FilmCraft CLI(filmcraft-cli 或 Flatpak ai.storyteller.filmcraft)用于多轨组装/导出
  • 可选的 Linux 工具:nice、ionice、taskset

示例命令

# 检查可用依赖(不渲染)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# 预览低负载顺序渲染计划(场景 + 透明标题)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# 预览 FilmCraft 无音乐组装(静默片头/演示,Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能