Communitygithub.com

oleg-motion

將靜態圖片轉化為精美的動畫——循環橫幅、動態廣告、限時動態、電影級短片(MP4/WebM/GIF)。支援平面 JPG/PNG(自動分離背景、主體和文字圖層)、PSD 或 PNG 圖層資料夾,並添加視差/2.5D 攝影機運動、粒子特效(雪、落葉、灰塵、五彩紙屑、散景)、光效(光掃、星光、光暈、發光)以及文字/產品動態,同時保持價格、標誌和法律文字清晰可見。

oleg-motion 是什麼?

Oleg-motion 是一款專為開發者與 AI 代理設計的確定性動畫技能,能從靜態圖像中生成具備專業水準的循環影片。它將靜態圖片拆解為多個圖層(背景、主體、文字),並賦予它們視差、粒子、光效等動態效果。該技能支援多種輸入格式,包括平面 JPG/PNG(透過 ML 自動分層)、PSD 檔案或 PNG 圖層資料夾。它可在 Claude Code、Cursor 和 Codex 等平台上運作,透過命令列工具 `om` 進行設定與執行。核心流程包括:圖像分析、動畫方案制定、圖層提取、場景建置、渲染與迭代。其關鍵設計哲學在於限制主要動畫數量(最多一個主體動畫與兩個環境動畫)、保持價格與標誌的靜止,以確保品牌識別度與可讀性。渲染結果具有可重現性,所有動畫均為時間函數,確保循環完美無縫。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bonchuk/oleg-motion/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

oleg-motion 是做什麼的?

從靜態圖像生成確定性動畫設計:一個在無頭 Chrome 中逐幀渲染的 HTML 場景,並使用 ffmpeg 編碼。所有元素都是時間的純函數,因此循環能完美閉合,渲染結果可重現。請使用使用者所使用的語言與其交談;保持檔案名稱和場景 JSON 為英文。

下面的 $OM 代表此技能所在的目錄(包含此 SKILL.md 的資料夾)。

0. 確保它能運行(每台機器僅需執行一次)

透過啟動器 $OM/om 執行所有操作——它會將技能自帶的 Node、ffmpeg 和 Python 放在 PATH 的最前面,因此可在沒有開發者工具的全新 Mac 上運作。

$OM/om doctor              # 檢查已安裝項目
bash $OM/scripts/setup.sh  # 核心:Node.js、ffmpeg、渲染引擎(下載缺少的項目)
$OM/om setup --psd         # + PSD 匯入
$OM/om setup --ml          # + 平面圖像自動分層(約 1 GB,含模型)
$OM/om update              # 從 GitHub 更新至最新版本(無需 git),然後再次執行 setup

設定無需管理員密碼、Homebrew 或 git:缺少的工具會下載到 ~/.cache/oleg-motion/tools(可透過設定環境變數 OLEG_MOTION_HOME 覆蓋此資料夾);如果機器上已有的工具足夠好,則會直接使用。僅靠核心功能即可為任何圖像添加動畫(攝影機、粒子、光效、覆蓋層)。執行 --ml 前請先詢問——它會下載模型。如果 om 沒有執行權限(例如從 zip 解壓),請用 bash $OM/om … 來呼叫。

1. 簡報——先觀察,再以可點擊的選項提問

使用者會丟出一個檔案並說「讓它動起來」。大多數人無法用語言描述動畫,所以不要問開放式問題——先親自檢視圖像(打開它),列出其元素(標題、價格、按鈕、標誌、照片、產品、箭頭……),然後再提問。

優先檢查品牌套件。 如果請求中提到了品牌或專案名稱,或者工作資料夾中有 *.brand.json / oleg-motion.brand.json,或者 $OM/brands/ 中有匹配的套件,請載入它並在執行 scene 時傳遞 --brand 參數:其預設值能回答大多數問題(跳過那些問題),而其 protect / avoid / notes 是硬性規則。格式:references/brand-kit.md。如果還沒有品牌套件,請在交付時(步驟 6)主動提供建立一個。

絕不詢問技術細節——時間點、緩動函數、振幅、延遲、粒子數量等都有專業的預設值(參考 references/motion-guidelines.md)。僅在使用者要求時才更改它們。每個問題都應提供一個預設選項,使用者可以直接接受。

跳過提問,當使用者說「просто зроби」/「just do it」/「你自己決定」,或者答案已包含在請求中時:選擇預設值並在一行內說明。

否則,一次性提問,並提供選項——使用 AskUserQuestion 工具(可點擊卡片;否則在一個訊息中提供編號選項)。最多 4 個問題,每個問題的首個選項是你的推薦,根據你從圖像中看到的內容來建構:

  1. 它將用在哪裡? → 設定檔:「як є — не змінювати пропорції」(source:原始寬高比,長邊上限為 1920 px),Instagram 貼文 4:5(feed-portrait),限時動態/Reels 9:16(story),網站橫幅(web-hero / web-strip),顯示廣告 GIF(display-*)。根據圖像選擇 4 個選項:如果其比例已符合某個格式(例如 4:5 → Instagram 貼文),則提供該格式而非獨立的「як є」(結果相同)並推薦它;否則先推薦「як є」。比例不同的格式會裁切圖像(fit: cover)或添加模糊邊距(contain-blur)——請說明是哪種情況,以及它會裁切掉什麼(標題邊緣、行動呼籲按鈕),以免使用者感到意外。
  2. 角色? → 3–4 個適合圖片的氛圍,用感覺描述,而非名稱:「平靜且高級」、「充滿活力」、「節日氣氛」、「幾乎不動」。提及描述中對應的氛圍(premium、energetic、festive、calm……;完整列表:$OM/om moods)。
  3. 結構? → 「元素出現,然後循環」(intro-loop,適合社群貼文)、「僅無縫循環」(loop,適合網站橫幅)、「單次播放並結束」(oneshot)。
  4. 主角是什麼?(多選)→ 你找到的 3–4 個最突出的元素,例如「標題 SUMMER SALE」、「行動呼籲按鈕」、「照片」、「產品」。主角獲得主要的動畫;其他元素保持靜止。

未回答時的預設值:基於寬高比的設定檔、6 秒(intro-loop 為 2 秒介紹 + 4 秒循環)、MP4、從色調和主題中選擇的氛圍。參考影片(「像這樣的」)優先於任何答案——使用 references/reference-analysis.md 分析並複製其節奏,而非內容。

2. 動畫方案——在渲染前用文字達成共識

在首次渲染之前,用純文字(使用使用者的語言)展示方案,每個元素一行,並包含時間點——例如:

介紹(2 秒): 標誌出現 → 標題逐行上升 → 「-30%」彈出 → 按鈕和商品從底部出現。 循環(4 秒): 「-30%」微弱發光,一道閃光掃過 · 按鈕脈動 · 商品輕微浮動 · 背景中有溫暖的灰塵。 不移動: 標誌(僅閃光)、價格(出現後)、日期。

在同樣的訊息中詢問「Так робимо, чи щось змінити?」(就這樣做,還是要修改?),只有在得到肯定答覆後(或者使用者跳過了提問——則直接渲染並在結果中展示方案)才繼續。修改方案只需幾秒鐘;修改渲染則需要幾分鐘。方案也決定了哪些元素在下一步需要獨立的圖層。

3. 取得圖層

根據輸入類型選擇——目標是產生一個包含角色資訊的 layers.json(參見 references/scene-format.md):

輸入類型命令
平面 JPG/PNG,已安裝 ML$OM/om py $OM/scripts/ml/auto_layers.py in.jpg --out work/layers
PSD$OM/om py $OM/scripts/psd_layers.py in.psd --out work/layers
PNG 圖層資料夾$OM/om layers-from-dir path/to/pngs
設計好的創意稿(卡片、按鈕、箭頭、頭部超出畫框的照片)或自動分層錯誤撰寫 regions.json(方框/多邊形 + 遮罩模式)→ $OM/om py $OM/scripts/ml/cut_regions.py regions.json --out work/layers(格式在腳本的文件字串中)
平面圖像,無 ML手動編寫 layers.json:一個 background 圖層(如果粒子必須避開文字,則詢問文字方塊)

對於 regions.json,透過測量而非目視來找到座標:對亮/暗像素設定閾值並列印元件邊界框;對於照片卡片,掃描框架的顏色並擬合邊緣(多邊形應在真實邊緣內側 3–5 像素,這會在背景留下一條亮線並裁剪卡片)。對於純色背景上的文字/標誌/線條,使用 mask: "contrast";對於頭部突出的照片卡片,使用 "full" + popout;對於繁忙照片上的物體,使用 "seg"。

在建立場景之前,務必打開 preview.png / 圖層 PNG 檔案檢查分割結果:自動分層可能標記錯誤(標誌被偵測為文字、價格被標記為標題、主體實際上是背景)。在 layers.json 中修正角色——角色決定了哪些元素可以移動。如果主體的剪裁效果很差,則丟棄該圖層,而不是為一個邊緣鋸齒的圖層添加動畫。

4. 建立場景

$OM/om scene --layers work/layers/layers.json --mood energetic \
     --profile feed-portrait --structure intro-loop [--brand brand.json] \
     [--intensity 1] [--speed 1] [--density 1] --out work/scene.json

這會根據氛圍組合(以及品牌套件)起草 scene.json。然後編輯它以符合已同意的方案——這就是工藝所在:圖層間的介紹時間點錯開 50–100 毫秒(整個級聯 ≤ 2 秒,入場 400–800 毫秒,緩出;僅對一個俏皮的元素使用反彈效果),主角的光效/發光效果,裝飾性動畫(箭頭彈跳、徽章旋轉),使用圖像或品牌套件中的一個強調色來製作粒子效果。閱讀 references/effects.md 以了解每個效果及其參數,以及 references/motion-guidelines.md 中使其保持專業的限制。

5. 渲染、查看、疊代

$OM/om render work/scene.json --out work/out --quality draft     # 快速檢查
$OM/om render work/scene.json --out work/out --formats mp4,webm,gif  # 最終輸出

每次渲染後,查看 *-sheet.jpg(8 幀),若有疑問時,提取單幀(ffmpeg -ss 2.5 -i out.mp4 -frames:v 1 f.png)並查看。報告(*-report.json,摘要顯示在 stderr 中)會檢查:循環接縫、閃爍(≤3/秒)、鎖定圖層是否移動、安全區域(文字/價格/CTA 距邊緣 ≥ 10%,標誌 ≥ 5%;cut 表示格式變更導致裁切,as-designed 表示來源本來就這麼緊湊)、檔案大小限制。

在交付前修復失敗——可見的接縫通常意味著非整數 cycles;超出檔案大小限制則表示需要減少粒子/顆粒效果,或降低 GIF 尺寸/fps。

向使用者展示草稿(聯絡單或 MP4),並邀請他們用自己語言提出調整——「повільніше」(慢一點)、「менше блиску」(少一點光澤)、「без частинок」(不要粒子)、「кнопку яскравіше」(按鈕更亮一些)、「прибери інтро」(去掉介紹)。references/tweaks.md 將此類短語對應到場景編輯;應用它們,重新渲染為草稿,並僅在他們滿意時才渲染最終版本。

在筆記型電腦(M1、8 GB)上的成本:自動分層 ≈ 每張圖像 3–4 分鐘(執行一次,然後疊代場景);渲染 ≈ 0.2–0.4 秒/幀(6 秒、30 fps 約需 1 分鐘)。在耗時步驟前告知使用者。

6. 交付

提供給使用者:檔案(路徑 + 大小)、海報 JPG、一句話概述動畫內容,以及網站的嵌入提示 <video autoplay muted loop playsinline poster="…">。如果目標平台有嚴格限制(精確尺寸、編解碼器、最大 MB),請說明是否已滿足——或未滿足。如果這是某個品牌的任務且尚無品牌套件,請主動提供一行說明來建立一個(references/brand-kit.md),以便下次問題已經有了答案。

讓它保持優秀的規則(及其原因)

  • 一個主角動畫,最多兩個環境動畫。 觀看者一次只能閱讀一件事;額外的動畫會與訊息競爭。
  • 價格、法律文字和標誌保持靜止。 移動會使字體模糊和搖晃——可讀性和品牌信任勝過花俏。角色設定強制了這一點;不要為了讓價格產生動畫而將其角色重新分配為 text。
  • 不要偽造人物的動作。 一個被剪裁出來的人不能跑步或揮手;讓整個人物上下浮動或脈動看起來就像一個紙板木偶。給人物深度(攝影機視差)和一個介紹,僅此而已。
  • 小振幅。 3–6% 的攝影機推近,2–4° 的傾斜,≤ 2% 的呼吸效果。大的縮放和視差會引起暈眩感,看起來不專業。
  • 僅使用完整循環。 循環之所以無縫,是因為每個動畫在每個循環內都完成了整數個週期——永遠不要設定非整數的 cycles。
  • 第一幀 = 完成的海報。 在 loop 模式中,第一幀已經萬事俱備;當需要入場動畫時,使用 intro-loop。
  • 不重新生成文字。 此技巧絕不重新繪製文字或產品;AI 影片(可選,參見 references/ai-video.md)僅用於背景,原始圖層會合成回頂部。

故障排除

  • Playwright is not installed、Node.js is missing、ffmpeg 錯誤 → 執行 bash $OM/scripts/setup.sh。
  • 空白或黑色幀 → 圖層路徑錯誤(檢查 stderr 警告)或場景缺少背景圖層。
  • 文字偵測跳過 → ocrmac 僅限 macOS;在其他平台上需手動傳遞文字圖層。
  • 視差中的邊緣光暈 → 降低 depthParallax.amp,或修補基底畫面(除非使用 --no-inpaint,否則自動分層會執行此操作)。
  • GIF 太大 → display-* 設定檔會自動縮小它;否則降低 fps/寬度。

相關技能