Ian Xiaohei SVG Motion
把 Ian 小黑正文配圖的原則,改造成可控的 HTML + SVG + GSAP timeline 動效。目標不是復刻生圖像素,而是把文章裡的一個認知動作重建成分層漫畫舞台,方便錄影片、按字幕 cue 對齊、後續改文案和元素。
核心規則
不要將 PNG 自動向量化並對產生的路徑碎片進行動畫。僅將點陣圖作為構圖參考。將場景重建為語義化的 SVG 群組:
概念 -> 分鏡計劃 -> SVG 圖層計劃 -> HTML/SVG 模板 -> GSAP 時間軸 -> 靜態 + 動態審查
工作流程
- 從文章、腳本、截圖或分鏡場景中提取一個認知錨點。
- 選擇一個物理隱喻:分類、搬運、橋接、洩漏、捕捉、折疊、稱重、打開、改道或墜落。
- 讓小黑執行動作核心。如果移除小黑不會改變意義,則重新設計。
- 設計一個 16:9 的白色畫布,包含一個主要場景,35% 以上的留白,以及最多 3-5 個簡短的手寫註解。
- 為每個移動的物體建立語義化的 SVG 群組。
- 使用 GSAP 時間軸進行動畫。使用
x、y、rotation、scale、opacity以及 SVG 描邊繪製。避免版面動畫。 - 同時儲存可播放的 HTML 頁面與靜態審查截圖。
- 如果是「口播成片」專案,在最終渲染前將時間軸片段對應到字幕/提示時間點。
需要時閱讀
- 在設計新場景或判斷結果是否仍像 Ian 小黑風格之前,先閱讀
references/style-rules.md。 - 在編寫或編輯 SVG 結構之前,先閱讀
references/svg-layering.md。 - 在編寫 GSAP 動畫之前,先閱讀
references/motion-rules.md。
輸出約定
預設輸出資料夾:
output/<slug>-xiaohei-svg-motion/
必要檔案:
index.html
README.md
preview.png
vendor/gsap.min.js
可選檔案:
source.png # 參考圖片,如果由使用者提供
cue-map.md # 當需要對齊口播腳本或字幕時
可重用素材
AI 模型與介面圖示存放於:
assets/icons/
使用 assets/icons/index.json 作為唯一資料來源。將原始 SVG 檔案保留在子資料夾中,並在生成時將完整的 SVG 內容內嵌到場景 SVG 中,以便保留漸層、描邊與品牌顏色。
圖示規則:
- 如果
index.json已包含確切的模型、提供者或語意圖示,請使用該圖示。不要將 ChatGPT、Claude、閃電、Step、DeepSeek、Qwen、錯誤、表格、圖表、資料庫或網頁圖示替換為通用方塊、星星、火花或抽象標記。 - 當使用者提供新的 SVG 圖示時,將原始 SVG 儲存在
assets/icons/<category>/下,在index.json中新增一個條目,然後在場景計劃中透過 id 引用它。 - 對於比較場景,圖示的選擇本身即具有意義。保持模型圖示在大小與位置上視覺一致,以便觀眾在小黑開始移動物體之前就能辨識參與者。
模板
當請求類似於包含移動物體、箭頭、註解或小黑動作的手繪漫畫場景時,使用 assets/templates/xiaohei-comic-motion/ 作為起始模板。
當請求要求多個變體、可重複使用的系列,或為口播解釋場景提供更廣泛的參考集時,使用 assets/templates/xiaohei-series-reference/。
將模板複製到專案輸出資料夾中,然後編輯:
- SVG 群組名稱。
- 手寫標籤。
- 物體位置。
- 時間軸標籤與持續時間。
- README 中關於該場景特定隱喻的說明。
品質檢查
在最終回應之前:
- 在本機伺服器中開啟 HTML。
- 檢查主控台是否有錯誤。
- 使用
?static=1擷取靜態截圖。 - 當場景包含多個節拍時,至少擷取一個播放中幀。如果可行,使用
?frame=mid來獲取確定的審查幀。 - 目視檢查文字、箭頭、小黑、道具、腰帶、坑洞、卡片以及最終撞擊點是否重疊。
- 確認動畫有可見的進展:先呈現背景,再是動作,接著是問題/結果,最後是總結。
- 確認註解僅在它們說明的物體/動作出現之後才顯示。
- 如果物體移動已顯示方向,則移除裝飾性或半透明的引導箭頭。
- 確認小黑是動作的一部分。
- 確認頁面不僅僅是
<img>標籤中的 PNG,除非使用者明確要求僅做 PNG 的鏡頭移動。