Communitygithub.com

atmirrr/波斯語動態導演

在 Remotion 或純網頁程式碼中,以正確的波斯語/法爾西語和從右到左的排版,導演並建立專業動態設計(宣傳片、啟動片、動態字體、動畫解說、社群短片、片頭序列)。每當使用者要求包含波斯語、法爾西語、阿拉伯字母或從右到左文字的影片、動畫、動態圖像、預告片或動畫文字時,請使用此技能;也適用於使用者說動態片段看起來「很預設」、「像幻燈片」、「AI 生成」或「不專業」,或波斯語看起來怪異、斷裂、不連貫,即使他們從未說出「動態設計」一詞。它帶來了「反幻燈片方法」(一個鏡頭、物件跨場景延續、以音樂優先的拍點同步剪輯)、八種附即時草稿的現成技術、用於逐字母和逐點的波斯語動畫的 HarfBuzz 工具、kashida 拉伸,以及波斯語正確性檢查清單和 linter。

波斯語動態導演 是什麼?

這是一個專為生成專業級動態設計而設計的 AI 代理技能,特別針對波斯語/法爾西語和從右到左 (RTL) 排版。它解決了兩個常見問題:動畫看起來像「幻燈片」(場景淡入淡出、統一的緩動曲線、所有元素同時出現),以及波斯語排版錯誤(字母斷開、點被裁切、使用了阿拉伯字母和數字、缺少半空格、從左到右的揭示方式)。此技能提供了一套完整的「導演循環」工作流程,包括閱讀簡報、展示方向、音樂優先、撰寫鏡頭清單、製作風格幀、建構、檢查與渲染。其核心方法論是透過一個移動的「鏡頭」容器和跨場景共享的物件來取代傳統的淡入淡出過場,並為每個動畫動作指定獨立的曲線。它支援 Remotion 和純網頁程式碼,並包含一個強大的技術庫(如單鏡頭無剪輯、形狀匹配過場、拍點同步剪輯等),所有技術均附有即時可用的草稿。 針對波斯語排版,此技能提供了嚴格的規則和工具。它明確禁止將波斯字母放入各自的獨立框中,因為這會導致字母斷開,並提供了解決方案,例如使用全詞或整行動畫,以及透過 HarfBuzz 工具(`shape_persian.py`)將文字轉為 SVG 輪廓以實現逐點動畫。它強制要求正確的文字方向(`dir="rtl" lang="fa"`)、使用標準的波斯語字母(ی 和 ک)與數字(۰–۹),並包含一個 linter(`lint_persian.py`)來自動檢查這些常見錯誤。此技能還提供了豐富的參考資料和可運行的資產(草稿、Remotion 專案、音樂生成腳本),使 AI 代理能夠從構思到最終渲染,完整地指導並執行專業級的動態設計專案。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add atmirrr/persian-motion-director

在你喜歡的 AI 中提問

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

說明文件

波斯語動態導演 是做什麼的?

你是在導演,而不僅僅是製作動畫。大多數生成的動畫都以兩種可預測的方式失敗:它看起來像幻燈片(場景淡入淡出、萬物統一的緩入緩出、所有東西同時出現),而且波斯語是破碎的(字母分離、點被截斷、使用了阿拉伯字母和數字、缺少半空格、從左到右的揭示)。此技能修復了這兩點。該方法來自專業動態設計師在 X 平台上描述他們自己作品的方式;波斯語規則來自 W3C 的阿拉伯語與波斯語佈局需求,並已於 Chrome(Remotion 的渲染引擎)中測試。

導演的循環

依此順序工作。每一個步驟的存在都是為了避免跳過它會使作品看起來很預設。

  1. 閱讀簡報,僅填補真正的空白。 複製(波斯語和任何拉丁語)、長度、寬高比、品牌顏色和字體、發佈位置、音樂。如果存在品牌,請使用其色板和字體,而不是自創一個。
  2. 建構前先展示方向。 動態是主觀的,重做成本高昂。從下方庫中挑選 6–10 個適合簡報的技法,打開 assets/sketches/gallery.html(或渲染片段),讓使用者選擇。在完整建構後返工的成本比提供挑選清單高出十倍。
  3. 音樂優先。 在製作動畫之前鎖定音軌及其節奏。建立一個小節地圖:哪個部分落在哪些小節上。如果沒有音軌,請創作一個(assets/music/compose_shur_pulse.py 是一個可運作的範例,會寫出 beats.json)或要求一個。在 120 BPM 下,一個拍點為 0.5 秒,一個小節為 2 秒;在 60 fps 下,一個拍點為 30 幀。
  4. 在小節網格上撰寫鏡頭清單(模板見 references/workflow.md)。每個段落變換都要落在強拍上;每個剪輯點落在拍點上或其前 2 幀。
  5. 風格幀。 渲染 4–6 張靜態幀(assets/remotion/render-stills.mjs),在製作所有動畫之前獲得同意。
  6. 建構 在 Remotion 中使用一個鏡頭容器和共享物件(完整的實作範例請見 assets/remotion/src/intro/Intro.tsx)。
  7. 檢查,然後渲染:在所有副本上執行 scripts/lint_persian.py,以完整尺寸檢視靜態幀以確保沒有截斷的點和斷裂的連接,逐幀檢查每個剪輯點是否對準拍點,並確切設定循環(片段長度 = 循環次數的整數倍)。

專業動態與幻燈片的區別

幻燈片習慣應做的替代方案
場景以淡入淡出過場串聯一個鏡頭在場景間移動,或一個物件攜帶進入下一個場景。絕不使用 fade() 從場景到場景。
萬物使用相同的緩入緩出每個動作都有自己的曲線。入場:bezier(.16,1,.3,1) 約 20 幀。出場:bezier(.7,0,.84,0) 約 8 幀,只移動約 70% 的距離。
所有東西一起、均勻地出現一個主導元素,其餘延後 2–4 幀,以曲線而非均勻間隔分佈。
Remotion 預設的彈性 spring()(過衝約 16%)UI 上低於 2% 的過衝,文字上無過衝:剛度 100 / 阻尼 16 可達約 1.5%。
最後才加入音樂音樂優先;剪輯點對準拍點;音效攻擊放置在視覺打擊點上。
文字居中在漸層背景上,片尾放 Logo在前 10 秒內展示真實產品執行真實任務。
凍結,或永不暫停的動作停留足夠長的時間以便閱讀;只有鏡頭在呼吸(每場景縮放 1.00 → 1.04)。
使用顆粒、半色調或 ASCII 作為收尾僅在有物理原因(紙張、印刷、光線)時使用紋理。這些收尾現在是 AI 的預設。

更多數字及其來源:references/anti-slideshow.md。

波斯語不可妥協原則

在將任何波斯語寫入影格之前,請先閱讀 references/persian-typography.md。簡要版本:

  1. 切勿將波斯字母放入它們自己的盒子中。 inline-block 跨度、flex 子項(包括 Remotion <AbsoluteFill> 的直接子項,它是一個 flex 盒子)以及任何逐字母變換都會將每個字母繪製成孤立形式。對整個詞或整行進行動畫處理。當你真正需要逐字母或逐點動畫時,請使用形狀化的輪廓(scripts/shape_persian.py)或零寬連字分割(scripts/split_fa.js)。
  2. 淡出詞語,而非字母。 連接的字母重疊;逐字母的不透明度或半透明文字顏色會在每個連接處留下接縫。
  3. 遮罩需要預留空間。 波斯語向上和向下延伸的範圍遠超拉丁語:將裁剪遮罩的頂部和底部各填充約 0.5em,使用 line-height ≥ 1.6(Nastaliq 字體需 ≥ 2.4),否則點和 گ 的頂部會被切掉。
  4. 方向。 在每個波斯語區塊上設置 dir="rtl" lang="fa";將拉丁名稱和數字包裹在 <bdi>(或 FSI/PDI)中,否則行順序會亂掉。揭示和錯開效果從右側開始,鏡頭進程向左移動,「下一步」箭頭指向左。播放按鈕、時鐘和數字永遠不鏡像。
  5. 字符。 使用波斯語的 ی (U+06CC) 和 ک (U+06A9),絕不使用阿拉伯語的 ي/ك;使用波斯語數字 ۰–۹ (U+06F0–U+06F9),絕不使用阿拉伯-印度數字 ٠–٩;在 می‌、‑ها、‑تر/‑ترین 中使用半空格 (ZWNJ, U+200C);使用標點符號 , ؛ ? « »。scripts/lint_persian.py 會捕捉這些錯誤。
  6. 無字母間距。 Chrome 自 137 版本起會忽略波斯語詞內部的字母間距,其他工具則會破壞連接。應改為使用 kashida 拉伸,且僅在向前連接的字母之後使用,每個詞最多一個。
  7. 每次都要載入字體。 如果波斯語字體(或其阿拉伯語子集)未載入,Chrome 會默默地使用系統字體作為備用。在 Remotion 中使用 FontFace + delayRender(見 assets/remotion/src/fonts.ts)。
  8. 文案。 使用統一的語域書寫自然的波斯語;不要逐字翻譯英語慣用語。在渲染前,讓以波斯語為母語的人簽署確認每一行文案(references/persian-copy.md)。

技術庫

每種技術的即時程式碼位於 assets/sketches/sketches.js(純 JS,是時間的純函數),既可以在瀏覽器頁面中執行,也可以透過 SketchPlayer 在 Remotion 中執行。詳細資訊、數字和每種技術所參考的 X 貼文,請見 references/techniques/。

#技術用途草稿 id
01單鏡頭,無剪輯影片的主軸:場景在一條帶狀上,使用帶動態模糊和視差的甩鏡oner
02一個形狀承載故事過場:一個句點成長為對話氣泡,然後再成長為下一個句點match
03真實的操作介面,經導演處理產品亮點:3D 中的真實介面、遊標沿弧形移動、焦點轉移ui
04在拍點上剪輯功能展示和動態字體:在每個拍點上硬剪輯、推近鏡頭、反相影格beat
05每兩幀一幀,帶線條抖動在乾淨 UI 上的手繪圖層:繪圖每 2 幀保持,線條每秒抖動 12 次boil
06紙張剪裁字母溫暖標題卡片:每個連接的字母組是一個剛性的紙片cutout
07點最後出現字標和揭示:先出現字母主體,然後點再掉落進來nuqta
08使用 Kashida,而非字母間距在長音上強調:拉伸連接筆劃,以書法點為單位測量kashida

根據簡報選擇,而非新穎性:一貫使用一兩種標誌性技術看起來像一個系統;同時使用全部八種看起來像剪輯作品集。

此技能中的工具

  • scripts/shape_persian.py — 使用 HarfBuzz 將波斯語成形並匯出 SVG 輪廓,分割為字母主體、點和連接的字母組(pip install uharfbuzz fonttools)。這使得在不破壞文字的情況下實現逐字母、逐點和 kashida 動畫成為可能。
  • scripts/split_fa.js — 將波斯語詞分割為保留其連接形式(使用零寬連字)的字母,適用於輪廓方案過於繁重的情況。
  • scripts/lint_persian.py — 檢查文案(阿拉伯字母和數字、缺少半空格、英語標點、錯誤放置的 kashida)和程式碼(字母間距、逐字母盒子、缺少 dir)。
  • assets/sketches/ — 動畫引擎 (engine.js)、八個草稿、成形字形資料、樣式和 gallery.html(使用任何靜態伺服器提供該資料夾)。
  • assets/remotion/ — SketchPlayer(從影格編號驅動草稿)、每種技術一個片段合成、作為完整實作範例的介紹影片,以及用於渲染片段和靜態幀的腳本。
  • assets/music/compose_shur_pulse.py — 以程式碼創作的原創 120 BPM Dastgah Shur 風格音樂,帶節拍地圖;展示如何讓剪輯鎖定音樂。

當使用者只想要一個快速片段時

仍然保持兩個不花成本的不可妥協原則:不為波斯語使用逐字母盒子,以及不使用場景到場景的淡入淡出。好好運用一種技術,在拍點網格上設定時間,並在完整渲染前渲染靜態幀以檢查波斯語。

相關技能