Communitygithub.com

Pulupulu 動態成片

把動態影片寫成 HTML 加 GSAP 時間線,用無頭 Chrome 逐幀截圖,再用 ffmpeg 混上旁白和音樂。

Pulupulu 動態成片 是什麼?

先確認本機有 Node、ffmpeg 和 pulupulu 命令列,再做扁平向量、文字、圖表和地圖。真人的臉、對口型和連續的身體動作不接,並會直接說明。

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

在你喜歡的 AI 中提問

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

說明文件

Pulupulu 動態成片 是做什麼的?

在這裡,一部電影就是一個 HTML 中的時間軸,由 Chrome 逐幀渲染。這裡沒有影片編輯器:你撰寫一個頁面,CLI 會以固定幀率對其進行截圖,ffmpeg 負責混合聲音。

這個檔案是路由器。它負責回答:我可以執行這項任務嗎?我該先執行什麼?哪些檢查必須通過?以及哪個頁面包含了詳細資訊?只載入你正在處理的部分的參考頁面。

1. 在做出任何承諾之前

python scripts/doctor.py                    # 唯讀檢查:python, node, ffmpeg, CLI, 金鑰, 磁碟空間
python scripts/doctor.py --project film/    # 同時檢查:頁面合約是否存在

退出碼 1 表示此機器無法製作電影。不要在撰寫場景之後才發現這個問題。切勿在每個指令中單獨呼叫 npx:在每次 check、still 和 render 操作中進行網路往返,是此工作流程中最常見的自我造成效能瓶頸。

此工具不適用於以下情況:故事需要它沒有的素材、真實人物的臉孔或肖像、複雜的人體或動物解剖結構、連續的物理動作,或對嘴。它擅長渲染平面向量幾何圖形、字型、圖表、地圖、圖示和顏色編碼的物件,但不擅長上述那些情況。與其產出一個相似物,不如直接說明原因:對於檔案資料來說,手繪的替代品是來源問題,而非風格選擇。

2. 工作流程,按順序進行

一個節拍 = 一句話 = 一個鏡頭。時間安排來自於測量過的語音,絕非憑空發明。

  1. 簡報。 主題、觀眾、平台、語言、是否有旁白。若缺少主題則應詢問;當要求的是影片時,不要詢問是否需要旁白。
  2. 先有分鏡,再有 HTML — references/narration-and-captions.md。字幕必須是逐字唸出的文字,而非其摘要。
  3. 錄製旁白並測量。 python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json,然後執行 gate 透過 ASR 檢查每個短語。路由、語音和限制:references/narration/deepseek-tts.md。
  4. 根據 timeline.json 建構頁面,而非分鏡表。合約:references/cli.md。 當故事需要圖示庫中沒有的物件時,先將它們生成為印刷面板 — references/generated-assets.md — 再進行組裝;切勿為照片手繪替代品。
  5. 檢查,然後檢視。 pulupulu check .,然後 pulupulu still . --at 2,12,24 --out .om/stills 並開啟這些靜止畫面。通過 check 的頁面仍然可能渲染出空白畫面。
  6. 渲染 — pulupulu render . --format mp4 --fps 30。停頓、黑幀和長度錯誤:references/render-traps.md。
  7. 使用明確的串流對應進行混合與封裝 — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 一步完成封裝並驗證。手動配方和側鏈壓縮鏈:references/workflow.md。
  8. 驗證你將要交付的檔案,而非渲染器的最新輸出:python scripts/deliver_check.py out/film.mp4 --timeline timeline.json。
  9. 誠實地交付,附帶說明哪些是繪製而非真實來源的內容,以及 QA 註記的內容。

3. 檢查閘門

只有這些會阻止流程。工具印出的其他所有內容都只是閱讀筆記:用論點回答它或修正它,但當它未通過時,切勿回報為已通過。

閘門指令證明事項若失敗時
預檢python scripts/doctor.py機器可以渲染停止,回報缺少的項目
組合pulupulu check .頁面合約,無缺少檔案在渲染前修正
語言python scripts/lang-audit.py film/index.html --lang en無其他語言的文字,包含 <script> 內的字串字面值翻譯該字面值,重新執行
語音python scripts/deepseek_voice.py gate beats.json --voice stella每個短語都能轉錄回其自身的詞彙重寫該短語;切勿交付不完整的片段
檔案python scripts/deliver_check.py out/film.mp4 --timeline timeline.json(或先使用 --video/--audio/--out 封裝)幀大小、幀率、音訊存在且足夠長、真峰值、交付大小重新封裝或重新編碼
爆音pulupulu qa out/film.mp4無單幀爆音找出該單幀元素

pulupulu qa 也會回報每秒的動作量、靜止 ≥ 1 秒 和 開頭平淡。這些是對節奏的判斷,基於 96×54 灰階比對,因此低對比度的緩慢移動可能被判定為靜止。將它們視為需要檢視的理由,而非必須服從的裁決。

沒有閘門可以證明: 這部電影是好的、ASR 聽對了數字(檢查數字和專有名詞作為標記)、或者字幕位於平台 UI 不會遮蓋的位置。

4. 會浪費一次渲染的陷阱

完整細節和修復方法請參閱 references/render-traps.md。以下是會直接導致渲染失敗的常見問題:

  • 將原始的 <g>/<rect>/<path> 寫入 <div> 中不會渲染任何東西也不會發出警告。請將每個場景片段包裹在其專屬的 <svg viewBox> 中。
  • 內聯 SVG <text> 中的網頁字型會導致該圖層在每一幀都重新柵格化。請將文字放在 HTML 中,或將其繪製成形狀。
  • 作為逐幀濾鏡的 feTurbulence(無論是內聯 SVG 或 CSS 背景)都會使渲染器停滯。請將噪點一次烘焙到 PNG 圖塊中。
  • 對內聯 SVG 進行全幀 GSAP 縮放會重新柵格化該底板;平移則可以很好地組合,而點陣圖圖層則可以進行縮放。當無法進行推鏡時,請對內部的小群組進行動畫處理。
  • repeat: -1 會使時間軸無限循環:一部 87 秒的電影會悄悄變成 117 秒。請計算有限的循環次數。
  • 在渲染失敗後,只關閉它留在後台的無頭 Chrome。taskkill //IM chrome.exe 會關閉使用者自己的瀏覽器。

5. 詳細資訊的位置

正在處理的事項頁面
指令、頁面合約、安裝references/cli.md
九個步驟、專案合約、封裝references/workflow.md
分鏡表、字幕、單一語言閘門references/narration-and-captions.md
調色盤、元素預算、風格、節奏references/design-taste.md
動畫語言、技巧、3D 圖層references/motion-library.md
強化、產品展示、發言人、文法references/workflows-specialized.md
音樂世界、作曲家、音效、旁白合成references/audio-and-music.md,references/narration/deepseek-tts.md
空白、停滯或長度錯誤的渲染結果references/render-traps.md
要檢查什麼,以及順序references/verification.md
風格配方、鏡頭語言references/art-motion/INDEX.md
獲取圖示和向量、授權references/asset-sourcing.md
由影像模型生成的藝術作品、裁切印刷品、裝裱references/generated-assets.md
平面向量工藝、捲動世界references/2d-vector-motion.md
此渲染器能處理哪些主題references/topic-fit.md
次秒級的時間與緩動references/ui-motion/
發布此技能(一次提交,v1.0)references/publishing-skills.md,references/publishing.md

風格配方路徑 (scripts/art-motion/engine/) 是 20 MB 的供應商執行環境,刻意不包含在此儲存庫中:一個技能不應該讓每個代理都去獲取一個它可能永遠不會用到的引擎,而且一個 37 MB 的樹無法被審查。它會固定在特定版本安裝,並經過校驗和驗證,安裝到上述頁面引用的確切路徑上:

python scripts/install_art_motion.py --check                   # 它存在嗎?
python scripts/install_art_motion.py                           # 核心:lib + demos + scenes,20 MB
python scripts/install_art_motion.py --with-reference-films    # + 學習材料,再增加 14 MB

其他所有東西 — Python 閘門、剪輯規格、文件 — 都包含在儲存庫中,無需安裝。切勿提交取回的樹:.gitignore 已經涵蓋了它。

6. 腳本

腳本功能
scripts/doctor.py預檢,唯讀
scripts/deepseek_voice.pyprobe · speak · cost · lay · beats · asr · gate — 旁白及其測量的時間軸
scripts/deliver_check.py驗證交付檔案:大小、速率、音訊、峰值、持續時間與時間軸的比對
scripts/lang-audit.py針對標記和腳本字面值的單一語言閘門
scripts/art-motion/icon_audit.py圖示系列、顏色計數、聯絡頁
scripts/art-motion/qa.py對已渲染檔案進行節奏和爆音啟發式分析
scripts/stamp_credit.py將 by Alucard0x1 行新增到文字檔案

7. 與真人協作

展示畫面,而非形容詞。每個場景一個關鍵畫面可以避免浪費一週在錯誤的方向上。當他們糾正你時,將修正內容放入此技能中,而不是放入聊天回覆中。

交接事項:旁白時間和韻律 → 技能 tts-intonation · 合併或翻譯另一個函式庫 → 技能 agent-skill-sourcing · 發布前的版權和肖像權 → 技能 media-content-safety · 獲取參考影片 → 技能 streaming-mirror-extraction · 3D 或實拍鏡頭 → 技能 headless-three-video-render 和 cinetic · 文字優先的影片 → 技能 kinetic-typography。

相關技能