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/ 專案檔案;props 以 "asset:<path>" 參考素材
shots/<shot>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ 輸出,被 git 忽略;manifest.json 追蹤版本
工具包程式碼(引擎、公司模板、本技能)位於 node_modules/motion-toolkit,由 package.json 固定版本。切勿在此處編輯;公司模板的變更應提交至工具包儲存庫。
公司模板
每個公司模板都有一個 look prop:minimal(簡潔、輕量字重、模糊上升、無面板)、bold(粗體大寫字型、實色色塊、彈簧彈出效果)、corporate(面板、強調欄、遮罩揭示)。預設值 "brand" 使用 look 權杖,因此客戶只需在 brand/tokens.json 設定一次風格(例如 "look": "minimal")。
| Id | 用途 |
|---|---|
lower-third | 姓名與職稱帶條,可選標誌 |
title-card | 章節或段落標題,可選引文與副標題;覆疊或全畫面 |
callout | 從畫面中某點(x, y 為影格比例)到標籤的連線 |
end-card | 結尾卡片:標誌、標題、行動呼籲、網址、0–2 個 YouTube 結尾畫面欄位 |
kinetic-text | 逐字揭示的引文或陳述;*word* 表示強調 |
logo-sting | 簡短的標誌動畫揭示(開頭/結尾) |
counter | 數字向上計數(value, prefix, suffix, decimals)搭配標籤 |
social-handle | 平台圖示加 @handle 顯示於角落(YouTube、Instagram、TikTok、X、LinkedIn…) |
typewriter | 逐字打字的文字,渲染音訊中包含打字機或鍵盤音效 |
corner-branding | 任一角落的持續標誌浮水印,可選標籤如 LIVE |
執行 pnpm mg new-shot … --template <id> 會以預設值建立每個 prop。每個 prop 的意義在 node_modules/motion-toolkit/templates/<id>/index.tsx 中的 .describe() 文字內說明。
權杖鏈
toolkit → house → client → variant(若 project.json 中有 "brand")→ project tokens.json → shot props。toolkit 層僅提供預設值(look、mono 字型、打字 sounds)。物件逐鍵合併,null 會刪除繼承的鍵,最特定層級的值優先。"extends": "none" 會跳過客戶與 variant。字型、標誌與音效檔案會在包含它們的最特定層級的 fonts/、logos/ 或 sounds/ 資料夾中尋找。
規則
- 每個可見值都來自 shot props 或權杖。模板中不得有寫死的顏色、字型、以 px 為單位的尺寸或時間設定。
- 專案存放資料,而非程式碼。新設計就是一個新模板;新工作就是一個包含 shot 檔案的專案。
- 將值放在擁有它的最低層級:單一 shot → shot props;單一專案 → 專案
tokens.json;客戶的數個專案 → variant;整個客戶 → 客戶權杖。 - 切勿手動編輯
tokens.lock.json。已交付的專案會被凍結;僅能透過mg rebrand修改(請見motion-render)。 - 每次編輯 JSON 或模板後,請先執行
pnpm mg check並修正回報的錯誤,再進行渲染。 - 每次視覺變更完成後,請先執行
motion-qa程序,再回報完成。 - 在執行
mg rebrand --apply以及編輯凍結專案使用的客戶或 variant 權杖之前,請詢問使用者。 - 如果渲染或 doctor 檢查失敗,請先執行
pnpm mg doctor,再修改程式碼。
路由
| 任務 | 閱讀 |
|---|---|
| 新客戶、variant、標誌、字型、色票 | motion-brand |
| 根據簡報建立新專案或 shots;修改現有 shots 的文字/顏色 | 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> 建立含所有預設值的 shot 檔案
pnpm mg new-template <client> <name> 建立入門模板
pnpm mg check [<client> | <client>/<project>] 驗證一切但不渲染
pnpm mg render <client>/<project> [shot…] 略過未變更的 shot;--force, --preset
pnpm mg still <client>/<project> [shot…] 在棋盤格背景上檢視 PNG(預設為所有 shot)
pnpm mg studio <client>/<project> 即時預覽;Studio 中的「儲存」會寫入 shot 檔案
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、煙霧測試渲染