adu-motion-video 是做什麼的?
使用者提供剪好的口播影片、文案,最好還有新口播的時間碼字幕;選用含錄屏、作品牆、頭像、標識或配樂的場景時,還須提供本期有權使用的素材。你負責把完整場景編舞適配到新台詞與片長,生成可編輯工程,核查後匯出新 MP4。先讀 製作約定。SKILL_DIR 是本檔案目錄,PL="$SKILL_DIR/scripts/pipeline.sh"。 製作記錄儲存實際 Skill 路徑、版本和所用入口;同名舊安裝、倉庫版本與已生成工程的凍結執行代碼可能不同,不能用最新版說明追認舊工程。
選擇入口
使用者指定模板編號(如 01-B)或要求選風格時,先讀模板與風格目錄,按「一級模板 → 二級風格」映射到顯式套件版本。未發布風格不能按已發布套件承諾製作。需要輔助動畫素材時,按公開動畫素材 API 檢索並下載到本期工程,再核對所選套件的媒體與渲染要求。
使用者新增完成工程、提煉新鏡頭組或更新模板庫時,讀持續模板接入。先登記來源和實際狀態,再按價值提煉;收到工程不代表已經有可發布模板。bash "$PL" packs 只列套件的語義與版本元資料,按任務載入相關清單;同一 ID 有多個版本時顯式選擇 id@version。
使用者指定 03 · 深色 3D / 03-A · 多屏展陳 時,讀深色 3D 模板,選擇 [email protected]。它保留九場作品牆、多屏比較、重點放大與軟體視窗編舞,新增 1080×1920 原生豎屏佈局。1.1.1 補齊 HDR 抽幀和 SDR 匯出色彩核驗;此前冷安裝記錄屬於 1.1.0,當前仍待作者連續聲畫確認;按本期材料選擇完整場景,不計入十七個穩定組。舊 1.0.0 保持原字節。
- 預設執行
bash "$PL" packs,按表達目的選擇顯式版本,讀取相關套件的README.md與manifest.json,並查看完整工程複用說明。[email protected]保留錯峰、人物回應與回穩,共三個已驗證組;[email protected]保留同物件變形、拆解與閉合,共兩個已驗證組。[email protected]是一個紙面透視續接組。穩定範圍限於已驗收的 macOS 1080p60,不代表整份來源或任意文案已模板化;逐組邊界見能力矩陣。舊候選版本保留,B 的計劃干擾組仍在候選中。舊anim3/anim4分別有 12/9 個完整場景,仍為 experimental。套件 ID 與原片標題、品牌無關。 C/D/E 的[email protected]、[email protected]與[email protected]各有三個穩定組,分別保留前後層與人物讓位、分欄與跨欄交接、整詞與實體回應。每條路線都由未參與提煉的執行者從凍結公開套件和本期輸入獨立製作一部 99.5 秒新片,作者確認成立。舊候選原字節保留;本期橋接不計作公開穩定組。 - 只需輕量短片、探索版式時,使用 9 個基礎
TPL;它們是 quick-start,不包含完整工程套件裡的全部動作。 - 手繪角色、補錄同鏡頭續接,讀手繪動畫方法。目前沒有對應完整工程套件,不要把方法文件稱為已自動模板化。
3.3.0 新增 02-B · 紙面聚合 [email protected]:六類資料聚合成網絡,以及七步日曆、六類能力、三項開箱和交付卡堆疊兩個穩定組。源/重放對照與 18.2667 秒不同內容樣片已獲作者聲畫確認。需要本期真人口播/文案,並顯式提供固定 SHA 的標題字型;詳見套件說明。這是組級增量,不是新整片路線;嚴格柵格問題保留在 review.json。3.2.0 的十五個穩定組與舊候選均保持原字節,當前七個風格共十七個穩定組。
完整工程套件流程
3.6.0 新增當前分鏡局部重配和素材版本檢查,並為通用影片抽幀接入共享色彩處理。04-A · 儀器台演示 當前候選 [email protected] 增加有界文字佈局,原 0.1.1 三組的同內容技術重放仍保留;靜音新文案檢查不代替新口播完整聲畫或獨立複用驗收,詳見模板說明。新預覽統一使用帶匯出證據與版本檢查的 preview 命令。
新文案先按系統適配機制形成 brief.json,執行 bash "$PL" macro-plan 套件ID@版本 brief.json 新規劃目錄。該入口按語義階段、數量、原速動作窗和前後場依賴篩選,再在合法組合內減少效果重複。8 個風格套件的 26 個完整組已有程式碼核對的適配 profile,能力仍為 adaptation-experimental。輸出 spec.json/report.json/report.md/profile.json;退出碼 0 為綁定檢查通過,2 為已儲存待補或受阻草稿,1 為無效輸入。媒體或真實關鍵字時間碼缺失時修改 brief 並重新規劃,不填來源演示時間碼。macro-spec 保留為歷史/人工配方入口,它不提供這層語義與鄰接診斷;新製作優先沿用帶 adaptation 的計劃,建構會重新驗證。
已有計劃新增素材時,按局部分鏡重配執行 macro-rematch,檢查建議後透過 macro-apply-rematch 儲存到新目錄。固定原段語義、時間和其它分鏡,重驗媒體與雙側接縫;基線或素材已改變則拒絕應用。沒有相容新組時保留原組,不隨機換效果、不猜其它模板的文案映射。此介面供製作工具呼叫,尚不等於已接入 ADuDir 拖放介面。
bash "$PL" doctor檢查 Node、Python、FFmpeg 和 Chrome;缺依賴且允許安裝時再bash "$PL" setup。保持來源工程和原成片唯讀,輸出到不存在的新路徑。- 先鎖定使用者指定的模板來源。素材目錄裡的其他
anim、新工程或舊成片不自動成為動畫底稿;不能只插入少數模板片段就稱整片使用了指定模板。逐場記錄來源套件與場景 ID,混用完整套件見來源與多套件編排。對齊新口播和文案,取得關鍵台詞的準確時間。SRT 只有整句時間時,不可臆測句內某個詞的時間;用逐詞對齊資料或人工標註。讀套件的role、cues、motionWindows、slots,按意義挑選、重排或重複完整場景。先列出分鏡和缺少的素材。 - 按新口播編寫 brief,執行
bash "$PL" macro-plan 套件ID@版本 /路徑/本期brief.json /已有父目錄/新規劃目錄;查看報告,缺項回到 brief 補齊後重新規劃,使用生成的spec.json建構。在渲染前按複用內容核對核對階段與真實台詞、關鍵事件落點、素材身份及全片重複。規劃器檢查聲明的結構,不會判斷填寫的階段是否忠於台詞。僅人工維護歷史配方時使用macro-spec,它的 cue 留空,範例文字及原片時長只供認識介面;必須填寫本期內容與實際時間碼,不能給每個重複組機械加同一偏移。brand填本期帳號。本期音樂可用music:{mode:"track",path,offset}指定;未指定時按原編曲結構重合成。人物視窗預設在 macOS 使用 Vision 追蹤新口播人臉;不能自動追蹤時須顯式設定審核過的faceTracking:{mode:"fixed",cx,cy,h}。任何來源演示資料與範例文字都須替換或明確標「示意」。素材的空路徑代表缺項;媒體準備與容量限制看套件目錄中的README.md。 bash "$PL" macro-build 套件ID@版本 /路徑/新規劃目錄/spec.json /路徑/剪好口播.mp4 /路徑/新工程 [--subs-js /路徑/字幕.js]。新口播長度應與計劃總幀數相符。配接器把關鍵動作視窗鎖在原速,較長段落只伸展可停留區;如果時間不夠,會報錯,改分鏡或片段長度,不靠全片線性拉伸。缺文字、數字、媒體或關鍵 cue 也會報錯。bash "$PL" stills /路徑/新工程 0,4,12,...抽查首幀、每個 cue 前中後、最長文字、場景接縫和片尾;小圓窗需看到雙眼、嘴巴和下巴,fixed 參數須從本期素材確定並檢查低頭、抬頭等極端姿態;再播放所有複雜運動區間,與原工程對照。檢查字型、媒體比例/裁切、真實口型、字幕、SFX 與音樂。修訂設定或工程並重新驗證。bash "$PL" audio /路徑/新工程→bash "$PL" mix /路徑/新工程→bash "$PL" render /路徑/新工程 /路徑/新片_v1.mp4→bash "$PL" check /路徑/新片_v1.mp4。完整觀看並聽取最終編碼檔案;check的幀數、解碼和響度不能替代視覺與內容驗收。新預覽統一透過bash "$PL" preview /路徑/新工程 /路徑/新片_v1.mp4 /已有父目錄/新預覽目錄發布,綁定真實成片 SHA,顯示播放版本並提示舊標籤頁更新。HDR/DV、來源位元和元資料風險須按素材色彩與預覽留下實際對照證據,不只檢查標籤。
快速體驗基礎模板可用 bash "$PL" demo /不存在的新目錄。為真實口播從零組合 TPL 時,按模板目錄和字幕方案製作,仍須完整驗收。
不可省略的檢查
- 口播取幀以目標輸出時鐘為準;來源場景動畫以映射後的原編舞時鐘執行。不能讓原場景時鐘控制真人口型,也不能用凍結的真人幀補足缺失時長。
- 第一幀若是口播開場,應看見真人與主題;檢查字幕白字描邊、字號和安全區,不能把模板來源影片的品牌、日期、數值或佔位字留在新片。
- 檢查每個動作保護視窗的連續片段,而不只抽一張圖;錄屏、九宮格、作品牆按本期真實素材檢查。音樂和音效隨新時間線重編,不直接變速舊成品音軌。
- 新文案不能保證自動無損適配。短段容不下動作就拒絕、拆分或換場景;長段只在允許停留的位置延長。新場景仍需針對本期內容設計,不按句子硬套巨集場景。
- 輸出新工程和新版本成片,不覆蓋使用者原工程;報告實際檢查範圍。
anim3與anim4在完整新文案逐幀對照和成片聲畫驗收前保持 experimental,不要稱已完整驗證。