生物生長動畫 是做什麼的?
將生物階段圖製作成持續生長的科學檔案短片。復用的是連續形變與界面系統;新生物的圖像、階段名稱、解剖控制點和引線位置必須重新設計,不能只改海馬標題。
預設:10秒、3:4豎版900×1200、60fps、黑底、無配音、概念數據。使用者給出其他時長、視覺參考或交付形式時按其要求調整。內建HUD範本支援3:4及同比例解析度,支援2–8階段;其他縱橫比需要實際修改版面,不能直接拉伸畫面。
工作流程
-
確定生長序列。 使用請求裡已有的生物和視覺方向。階段需有可對應的姿態;普通體型增長可直接連續形變,蛙/蝶等長出或失去肢體的變態發育先讀素材與形態指導,按拓撲連續的區間分段。概念圖不冒充實測發育數據;知識講解中的階段和事實要先核實。
-
製作並檢查素材。 新素材使用可用的內建 imagegen,背景設為透明;完整提示詞與背景清理策略見素材與形態指導。採用同一鏡頭、朝向與光照。先看真實輸出,再讀取實際尺寸、確定格線邊界;灰底、霧狀矩形和相鄰格漏入都應在動畫前處理。不要預設為提示詞裡的尺寸已實現。
-
填寫配置。 讀配置說明,從
assets/examples/seahorse.json複製結構,但為新生物重新標定語義控制點。設定標題、階段、尺寸錨點、兩組指標、標註與配色。圖集路徑相對設定檔;所有控制點使用單格原始像素。關鍵姿態要有連續的頭/軀幹/附肢對應關係。 -
生成專案。 以當前技能目錄作為
BIO_SKILL_DIR,在工作目錄呼叫:python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config work/specimen/config.json --validate-only python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config work/specimen/config.json --out work/specimen/project輸出目錄必須不存在或為空,腳本不會覆蓋既有專案。它複製本地GSAP、字型、形變渲染器,內嵌配置並產生HyperFrames專案;現有素材的渲染不呼叫圖像API。專案使用Python3生成,影片驗證/匯出需要Node.js 22+、FFmpeg和可用的Chrome/WebGL。HyperFrames CLI固定在已驗證版本,首次執行可能需要下載依賴。
-
看過渡,不能只看階段端點。 在生成專案中執行
npm run check -- --snapshots,查看首個可見幀、每兩個姿態之間的中間幀、成熟體與最終保持幀。需要定點截圖時執行npx hyperframes snapshot --at <逗號分隔的時間>。複查第一張截圖,防止非同步初始化造成首幀未綁定時間軸。確認沒有網格翻折、眼睛重影、尾圈破洞、圖集裁斷、標題遮擋或引線脫離身體。 -
完成匯出。 使用者要成片時按已授權範圍匯出,避免重複詢問已給出的製作要求:
npm run render -- --quality delivery --output renders/growth.mp4 ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,duration,nb_frames -of json renders/growth.mp4查看匯出影片的過渡中間幀。交付MP4、配置/專案原始檔案和素材提示詞;使用者可見檔案放到目前工作區約定的outputs目錄,暫存圖、日誌和檢查幀留在work。不要發佈或上傳到外部服務,除非使用者要求。
已有HyperFrames相關技能時沿用其執行時期與CLI約定;這裡的範本負責生長動畫的具體生成,不重新收集對話裡已經確定的偏好。
平滑性必須保留的實作
- 主體只有一個連續生長進度;眼、吻/口、軀幹、附肢與卷尾等控制點隨同一進度變化。不能退回0.3秒換圖來代替平滑生長,單純提高fps也不能修復換圖感。
- 共享三角網格把鄰接紋理扭到共同形狀;Catmull-Rom控制空間軌跡,距離場插值收攏輪廓,減少透明度疊化的雙重邊緣。複雜拓撲變化不能靠增加控制點硬撐。
- 標註線直接讀取形變後的控制點;數值直接格式化當前進度,保留小數位。不要固定初始
stroke-dasharray後繼續拉長引線。 - 單一paused GSAP時間軸驅動屬性setter;不依賴被seek抑制的onUpdate回呼,不使用真實時鐘。圖像decode及網格構建完成後再註冊時間軸,並呼叫可用的
__hfForceTimelineRebind()。 - 內建輪廓插值會對透明圖的alpha取閾值:對半透明水母/薄翅必須檢查觸手和薄邊是否遺失,按實際素材調
morph.alphaThreshold;不承諾保持物理透明材質。
快速驗證與呼叫範例
技能自帶原海馬素材和已驗證配置,用於回歸檢查,不能冒充新生物素材:
python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config "$BIO_SKILL_DIR/assets/examples/seahorse.json" --out work/growth-smoke
典型請求:「用這個skill做一段水母從小到大的生長動畫,10秒、青藍色、60fps。」
維護產生器時可執行 python3 scripts/test_create_project.py 和 node scripts/test_renderer.mjs;它們不呼叫圖像API或進行渲染。
使用者只想修改現有短片時,保留其素材與版式,調整對應配置或執行時期;不要重新生成整套圖像。內建產生器支援從專案 config.json 重建到新的同級目錄,驗證後再選用新結果。