用程式碼製作墨水動畫
使用者描述一個狀況或故事(例如「在社群媒體上混了一週,我快瘋了」),你將它轉化成一部簡短、單一概念的動畫。沒有任何影像生成模型:每一條線都是程式碼,每一段聲音都是合成。沒有版權問題,結果是確定性的,而且可以逐格修正。
可運行的範例(作為模板參考):ornekler/animasyon-bir-hafta/——7 天的時間跳躍,4:5 比例,17.7 秒,與程式同步的音樂和音效。
先閱讀:references/ilkeler.md(為何有效、平台表格、主題發想、誠實原則)以及 references/tarifler.md(引擎選擇、構圖、角色、聲音、校驗——所有經過測量發現的陷阱)。
指令中請使用 .venv/bin/python(Windows 使用 .venv\Scripts\python)。
相依套件:numpy, Pillow, ffmpeg。
工作流程
1. 簡短討論
如果概念不明確,或使用者表示「先討論一下」:提出 3-4 個概念(每個一句話的梗 + 為何有效),並推薦其中一個。只進行一輪提問:概念、比例(X:4:5 / 16:9,Reels:9:16)、時長。如果使用者說「先討論,不要產出」,則不要寫程式碼。
2. 拍點表(Beat Sheet)——寫程式碼之前
以秒為單位規劃:每個拍點 = 單一視覺概念 + 最多一句簡短台詞。
- 時長:X 15-30 秒,Reels 20-40 秒,YouTube 過場 3-8 秒。如果使用者要求簡短,則採取下限。
- 結構:錨點(角落的固定計數器:天/年)+ 重複出現的角色 + 每場景單一物件 + 漸進昇溫 + 呼應開頭的結尾。如果結尾與開頭相連,影片就能循環播放。
- 聲音的重點時刻(拍點、切換、靜音)必須在規劃時就寫入,不得事後追加。
3. 引擎
- 繪圖、角色、粒子、堆疊 → 此技能:
kit/murekkep.py+kit/sentez.py。 - 數字、文字、圖表為主的動態圖形(計數器、長條圖、比較圖)→
x-animasyon技能(Remotion)。
import sys; sys.path.insert(0, ".claude/skills/animasyon/kit")
import murekkep as M, sentez as Z
專案資料夾 calisma/<名稱>/:包含 anim.py(影像 + program())、ses.py(讀取同一個程式)。複製範例後開始;透過常數 KOK 和 CIKTI 修改路徑。
| 模組元件 | 功能說明 |
|---|---|
M.Tuval(w, h) | 紙質紋理背景(繪製兩次,bitir() 縮小:產生柔和邊緣) |
M.Kalem(d, kare, s, sc, ox, oy) | 暈染的墨水線條、圓形、多邊形、文字;場景變換 |
M.Iskelet、M.yuru、M.poz_karistir | 關節角色、程序化行走、姿勢混合 |
M.yaz_mp4(kare_fn, sure, yol, w, h, ses=wav) | 將幀透過管道傳送給 ffmpeg,並加入音訊 |
Z.harp/yayli/bas/flut/taiko | 樂器(音高經過校正) |
Z.whoosh/tus/yazma/ding/tik/hisirti/swell | 音效(whoosh 柔和,鍵盤模仿人類節奏) |
Z.yanki、Z.kes、Z.yaz_wav(buf, yol, lufs) | 迴音、喜劇式斷點、輸出指定 LUFS 的 wav |
4. 預覽 → 修正 → 最終渲染
在完整渲染之前,先輸出 4-6 個關鍵幀的 PNG(範例中使用 --kare 2,7.5,15.5)並自行檢查。第一輪總是會發現問題:擁擠的構圖、遮擋文字的物件、重複的文字、不該出現的東西從空隙中露出來。修正後再進行完整渲染。將預覽與完整渲染串聯在同一個指令中:沒看到關鍵幀就不要跑長時間的渲染。
5. 量化校驗——你不能用眼睛看,也不能用耳朵聽
.venv/bin/python .claude/skills/animasyon/kit/denetim.py calisma/<名稱>/<名稱>.mp4
檢查接觸頁面 + LUFS / 真實峰值 + 0.5 秒音訊輪廓 + 視覺過渡。如果合成音符有變更,使用 --perde。檢查規劃的靜音、拍點和斷點是否到位。無法量化的部分(音色好聽嗎?梗好笑嗎?)則明確留給使用者判斷。
6. 交付 + 貼文文案
提供檔案路徑、時長、大小以及校驗摘要。貼文文案 2-3 行:故事的核心句子。 誠實原則:「單一提示 / one-shot」的宣稱僅限於真正一次就生成成功的情況;如果是經過多輪修正才完成,就不要說「一次完成」。正確說明是由哪個模型產出的。
規則
- 文字不進行暈染或縮放;每場景最多一行。字型中不包含表情符號。
- 移動物件不得進入標題/計數器橫幅區域(進入前須淡出)。
- 只使用一種強調色(在墨水作品中為通知紅);其餘保持紙張 + 墨水的顏色。
- 直向作品中,底部約 520 px 以下以及右側 x > 900 的區域為平台介面:不要在那些位置放置文字。
- 音訊:單獨影片為 -15 LUFS;下方有語音時,音樂必須明顯低於語音。音樂只能來自合成或用戶自行驗證過授權的來源。
- 畫面上不得有未經校驗的數字;如果是範例數字,必須明確標示。
- 如果測量到新的陷阱,請寫入
references/tarifler.md;如果產生了新的可重複使用的元件(過渡效果、角色綁定擴充),請收入kit/。