cinetic（cinema + kinetic）是一个让编码代理"当导演"的开源项目：用代码编写、渲染电影级产品视频。它内置了 5 大视频格式配方——Launch Film（发布片）、功能循环（Feature Loop）、Logo Sting（Logo 闪现）、UI 演示（UI Walkthrough）和社交重排版，每个格式都有明确的时长、节奏、字数与交付清单。本文带你一次看懂：什么场景该选哪个格式、各自有什么硬性要求，帮助你在第一次向 agent 下达视频任务时就选对格式。

先搞懂格式总览：一张表选对格式

cinetic 的核心原则是"先选行，再开工"：格式决定了时长、节拍密度、文案预算和交付文件列表。总览表位于 SKILL.md，完整配方在 formats.md。

💡 选型口诀：官网首屏要循环 → 功能循环；发布会/官宣 → Launch Film；给剪辑师做片头 → Logo Sting；教用户走流程 → UI 演示；发 Reels / 抖音 → 用社交重排版而不是裁剪。

1️⃣ Launch Film：30 秒讲完"问题—转折—证明—承诺"

适用场景：产品发布、官宣、X（推特）推文视频。

Launch Film 的叙事骨架是"让观众先感到问题，再看产品给出答案，最后记住名字"。结构模板（见 formats.md §2）：

关键规则：

• 全片只允许 15–25 个词，每次只上屏不超过 4 个词的片段，画面在片段之间留白；
• 只有两次高潮（Drop），最大声量留给结尾的"承诺"；
• Teaser 版本：15–20 s，砍掉证明段落，预算 6–10 词，但"永远不要从 Logo 开场"。

2️⃣ 功能循环（Feature Loop）：落地页静音自动播放的"永动机"

适用场景：Landing Page 首屏、社交帖子的静音自动播放背景。

功能循环最反直觉的要求是：它不是"淡入 → 停留 → 淡出"，而是一个循环（cycle）。formats.md §4 给出三种循环设计：

• Conveyor（传送带）：条目流过舞台，最后一项恰好回到第一项的起点；
• Relay（接力）：设备从一侧把结果带出画面，另一侧带着新输入回来；
• State round-trip（状态往返）：A 态 → 产品行动 → B 态 → B 变成下一轮的 A。

工程细节同样严格：

• 前 2 秒必须展示产品并开始动作——落地页访客只给你一两秒；
• 长度必须是整小节（如 8 s = 120 BPM 下的 4 小节），TAIL = 0，保证未渲染的第 TOTAL 帧与第 0 帧一致，否则每个循环周期都会"卡一下"；
• 静音可读：循环没有结束卡，必须在画面内部让产品/功能名可辨认；
• 交付 MP4 + WebM 给<video autoplay muted loop playsinline>，GIF 仅在要求时提供，且用 25 fps 导出（GIF 帧延迟是百分之一秒的整数倍，30 fps 会快放 11%）。

3️⃣ Logo Sting：让 Logo"带着意图"登场

适用场景：品牌片头/片尾、给剪辑师用的透明叠加层。

Logo Sting 只有 3–8 秒，却有一套精密的解剖结构（formats.md §5，以 6 s 为例）：

两个容易翻车的点：

• Logo 必须由 2–4 个基本图元在网格上组装，直接放大一个扁平 Logo 等于"什么都没教"；
• 结束帧的锁定画面必须占帧宽28–45%、可读 ≥1.5 s——Sting 的全部工作就是"被读到"。

它还标配透明版本（StingAlpha保留锁定画面、StingAlphaClear在最后节拍清空），方便剪辑师直接叠在实拍素材上。

4️⃣ UI 演示（UI Walkthrough）：教用户走完一个流程

适用场景：onboarding 教学、功能流程讲解，20–90 秒。

UI 演示比 Launch Film 更安静，但"绝不静态"。每个章节都是同一个小模板（formats.md §6）：

要点：

• 一个锚点相机贯穿全片，每次移动都从上一次结束的位置开始；
• 字幕烧录进画面（feed 静音自动播放），同时从同一数据导出 SRT 文件，保证两套时间轴一致；
• 每条字幕 ≤5 词，绝不一次性"倒出"一整块；
• 超过 60 s 的长演示按章节分 act，修改一处只需重渲一章。

5️⃣ 社交重排版：重排，永远不要裁剪

适用场景：把 16:9 成片变成 9:16、1:1、4:5 发往 Reels、TikTok、LinkedIn。

这是第 5 种"格式"，也是新手最常踩的坑：中心裁剪 16:9 母版会切掉文字、把产品挤出画面。正确做法是把每个画幅注册为独立 composition，复用同一套组件、同一时间轴和同一条音轨（formats.md §7）：

• 时间轴完全不动，只改位置、大小、换行和相机锚点；
• 竖屏 9:16 不是"加了黑边的宽屏"：内容视觉重心放在安全带中部（y ≈ 885），底部 40% 不能留空，文字与 UI 放大到 16:9 的 1.3–1.5 倍；
• 安全区预设内置在src/lib/safe.ts（如feed9x16：顶 270 px、右 120、底 420、左 64），用bash scripts/layout-audit.sh逐变体检查。

快速上手：一句话生成视频

安装后，直接给 agent 一句话需求即可，格式关键词决定走哪条配方：

Make a 20-second launch teaser with sound for our database branching tool, for the announcement on X. Invent the brand.

Animate our new export feature as a 10-second loop for the landing page. It autoplays muted, so it has to read without sound.

Design a logo for our budgeting app and make a 6-second sting with sound, plus a transparent version for our editors.

安装命令（如需 clone 仓库，地址为 https://gitcode.com/gh_mirrors/ci/cinetic）：

npx skills add Leonxlnx/cinetic

环境要求与首次试渲染见 docs/setup.md，格式配方全文见 skills/cinetic/references/formats.md，完整导演规则见 skills/cinetic/SKILL.md。

总结：5 大格式怎么选

• Launch Film：官宣主角，20–45 s，两个高潮，尾帧即海报 🎬
• 功能循环：落地页静音背景，整小节时长，靠"循环设计"而非淡入淡出 🔁
• Logo Sting：3–8 s 品牌出场，图元组装 + 一次调音撞击，附透明版 🎯
• UI 演示：20–90 s 流程教学，锚点相机 + 烧录字幕 + SRT 🖥️
• 社交重排版：同一条时间轴重排画幅，永不裁剪 📱

所有格式共享同五条"定律"：一个专属点子、一个贯穿全片的故事设备、一个只表达一种含义的强调色、一套统一的动效系统、以及"以测量为准"的交付验证。选对格式，agent 才能把它做对。