Motion 工作空间
该工作空间通过 mg CLI(pnpm mg <command>)使用 Remotion 渲染可复用的动态图形。设计即代码,以模板形式存在;每个作业特定的值都存放在 JSON 中。更改文本、颜色或字体只需编辑 JSON 并运行 pnpm mg render,无需修改代码。
目录结构
mg.json 工作区视频默认值(fps、尺寸)
brand/house.tokens.json 基础令牌:基础颜色、字体、缓动函数、持续时间、安全区域
brand/fonts/ brand/logos/ 基础令牌引用的文件
clients/<client>/
client.json 显示名称、可选的视频覆盖
brand/tokens.json 客户端覆盖(深度合并到基础令牌之上)
brand/fonts/ brand/logos/
brand/variants/<variant>/ 命名的备选外观,可被多个项目复用:tokens.json、fonts/、logos/
templates/<name>/index.tsx 仅限客户端的模板,id 为 "<client>/<name>"
projects/<project>/
project.json { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
tokens.json 仅限项目的覆盖(可选)
tokens.lock.json 冻结时存在:渲染会忽略实时链
fonts/ logos/ assets/ 项目文件;道具引用资源为 "asset:<path>"
shots/<shot>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ 输出目录,已被 git 忽略;manifest.json 追踪版本
工具包代码(引擎、基础模板、这些技能)位于 node_modules/motion-toolkit 中,由 package.json 固定版本。请勿在此处编辑;基础模板的变更应提交到工具包仓库。
基础模板
每个基础模板都有一个 look 道具:minimal(简洁、轻量字体、模糊上升、无面板)、bold(粗体大写、纯色块、弹性弹出)、corporate(面板、强调条、遮罩揭示)。默认值 "brand" 使用 look 令牌,因此客户端只需在 brand/tokens.json 中设置一次风格("look": "minimal")。
| Id | 用途 |
|---|---|
lower-third | 名称和标题条,可选标志 |
title-card | 章节或小节标题,可选的引子文字和副标题;叠加或全屏 |
callout | 从画面中的点(x、y 作为帧坐标)到标签的连线 |
end-card | 结束卡片:标志、标题、行动号召、URL、0–2 个 YouTube 结束画面插槽 |
kinetic-text | 逐词揭示的引述或陈述;*word* 可强调 |
logo-sting | 短的动画标志揭示(片头/片尾) |
counter | 数字向上计数(value、prefix、suffix、decimals),带标签 |
social-handle | 平台图标加 @账号,位于角落(YouTube、Instagram、TikTok、X、LinkedIn 等) |
typewriter | 逐键输入的文本,渲染的音频中包含打字机或键盘音效 |
corner-branding | 在任意角落持续显示的水印标志,可附带诸如 LIVE 等标签 |
pnpm mg new-shot … --template <id> 会用所有默认值写出每个道具。每个道具的含义在其 node_modules/motion-toolkit/templates/<id>/index.tsx 中的 .describe() 文本中有说明。
令牌链
工具包 → 基础 → 客户端 → 变体(如果 project.json 中设置了 "brand") → 项目 tokens.json → 镜头道具。工具包层仅提供默认值(look、mono 字体、打字 sounds)。对象按键逐层合并,null 用于删除继承的键,最具体的层获胜。"extends": "none" 会跳过客户端和变体。字体、标志和声音文件会在包含它们的最具体层的 fonts/、logos/ 或 sounds/ 文件夹中查找。
规则
- 每个可见值都来自镜头道具或令牌。模板中不得硬编码颜色、字体、以 px 为单位的尺寸或时间。
- 项目存放数据,不存放代码。新设计是模板;新作业是包含镜头文件的项目。
- 将值放在拥有它的最低层:单个镜头 → 镜头道具;单个项目 → 项目
tokens.json;客户端的多个项目 → 变体;整个客户端 → 客户端令牌。 - 请勿手动编辑
tokens.lock.json。已交付的项目会被冻结;它们只能通过mg rebrand更改(参见motion-render)。 - 每次编辑 JSON 或模板后,在渲染前运行
pnpm mg check并修复其报告的问题。 - 每次视觉更改完成后,先执行
motion-qa程序,然后再报告完成。 - 在
mg rebrand --apply之前,以及在编辑被冻结项目使用的客户端或变体令牌之前,先询问用户。 - 如果渲染或检查失败,请在更改代码前运行
pnpm mg doctor。
路由
| 任务 | 请阅读 |
|---|---|
| 新客户端、变体、标志、字体、调色板 | motion-brand |
| 根据简报创建新项目或镜头;更改现有镜头上的文本/颜色 | motion-project |
| 新模板或对模板动画方式的更改 | motion-template,然后阅读 motion-style |
| 动感感觉:缓动、时间、错开、安全区域 | motion-style |
| 渲染、预设、版本管理、交付、应用品牌变更 | motion-render |
| 交付前检查输出 | motion-qa |
命令
pnpm mg templates 列出模板 id
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <id> 创建包含所有默认道具的镜头文件
pnpm mg new-template <client> <name> 启动模板
pnpm mg check [<client> | <client>/<project>] 验证一切,无需渲染
pnpm mg render <client>/<project> [shot…] 跳过未更改的镜头;--force、--preset
pnpm mg still <client>/<project> [shot…] 在棋盘格背景上查看 PNG(默认查看所有镜头)
pnpm mg studio <client>/<project> 实时预览;工作室中的“保存”会写入镜头文件
pnpm mg deliver <client>/<project> 渲染、验证、冻结、将最终文件复制到 deliver/<date>/
pnpm mg rebrand <client | client/project> [--apply] 对已交付的作品应用品牌变更
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor 环境、mg check、冒烟测试渲染