Communitygithub.com

ll-video-progress

根據 SRT 字幕製作可匯入剪映的透明章節進度條。先確認章節與原話範圍,再開啟 Playground 讓用戶按名稱選樣式,支援配色和人物替換,交付窄條透明 MOV。不適用於文案短動效或完整影片剪輯。

ll-video-progress 是什麼?

這個 AI 代理技能(ll-video-progress)專為開發者與 AI 代理使用者設計,可根據 SRT 字幕自動生成透明章節進度條影片,並直接匯入剪映等影片編輯軟體。其核心功能是從使用者提供的 SRT 檔案中提取字幕內容,透過分析語義與話題轉折來建議章節分段,並以表格形式呈現,讓使用者確認或調整。確認後,技能會啟動本地 Playground 伺服器,展示多種預設樣式的動態樣片,使用者可依名稱選擇,並自訂 RGB 填充色、字型大小,甚至替換「人物領走」或「文字領走」樣式中的角色圖像。最終輸出的檔案為窄條 ProRes 4444 MOV,僅包含進度條與人物,其餘區域完全透明,確保無損品質與編輯軟體的相容性。此技能支援 macOS、Windows 及 Linux 系統,搭配 Node.js 環境即可執行。其嚴謹的規則(如不搜尋非使用者提供的 SRT、不預設影片比例、不強制分段數量)確保了流程的可靠與安全性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/liuliu-66-create/ll-video-progress/tree/main

在你喜歡的 AI 中提問

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

說明文件

影片章節進度條

使用者流程

  1. 先檢查使用者是否已在當前對話上傳 SRT 檔案,或明確提供本次要使用的 SRT 檔案路徑。只有這種來源的字幕才可直接讀取。若當前對話沒有使用者提供的 SRT,必須先回覆:「請先上傳這個影片的 SRT 字幕檔案,我會根據字幕用表格給你分段建議,等你確認後再製作進度條。」然後等待使用者提供;此時不執行檔案搜尋、字幕讀取、內容分析或進度條生成。不得搜尋本機、當前工作區、歷史專案、下載目錄、其他對話或記憶中的 SRT,也不得挑選一份看起來合適的字幕。當前對話裡使用者已提供的檔案可複用,不重複索要;若提供多份且未指定用哪份,先詢問;指定檔案不可讀時,請使用者重新上傳或核對路徑,不搜尋替代檔案。只有使用者明確要求看樣式或製作固定時長樣片時,才可使用內置樣片內容;一句「幫我生成一個進度條」不屬於這個例外。
  2. 讀完整份 SRT,按內容語義、話題轉折、影片長度和使用者需求建議章節數量,不設固定段數上限;使用者指定的劃分優先。先說明「我建議分成 X 段」,然後必須用下述表格列出分段建議。等待使用者確認後再繼續;使用者要求合併或拆分時更新整張表,再確認。不要用純文字列表替代表格,不要求使用者核對時間碼。
  3. 分段確認後,若當前會話尚未明確影片比例,必須先問:「你的影片畫面比例是 4:3、16:9,還是 3:4?其他比例也可以直接告訴我。」收到回答後再繼續;不能根據字幕、舊樣片或 Playground 的預覽尺寸預設比例。已明確比例或已有原影片可核實尺寸時直接使用,不重複詢問。
  4. 運行本 Skill 的 scripts/playground_server.mjs,開啟本次啟動返回的 progressUrl,展示真實動態樣片。啟動腳本會自動複用同版本服務,連接埠被其他程式或舊版本佔用時自動換連接埠;不要把預設連接埠佔用當作安裝失敗,不要直接複用未核驗版本的舊頁面,也不要結束未知程序。讓使用者回覆樣式名稱,不要求判斷動畫實現或編碼。已選樣式不重複選。
  5. 僅在使用者選「人物領走」或「文字領走」後處理人物,按 references/characters.md 讀取本機已儲存的個人預設人物。使用者已為本次指定人物時優先使用本次選擇;否則有個人預設人物就直接沿用,簡短告知,不重複索要或生成。無記錄時再問是否提供自訂圖,沒有則用內置人物;未回覆不等於沒有。新自訂人物的走路效果經使用者確認後,儲存到本機安裝 Skill 內的 user-data/characters/,作為下次預設;使用者明確僅本次使用時不改預設。只選無人物樣式時不詢問、不讀取、不儲存人物。個人原圖、動作幀和配置不得寫入公共 assets、SKILL.md、Git 提交或 GitHub;更新安裝時保留本機 user-data。
  6. 根據已確認的影片比例、章節與樣式,按 references/rendering.md 儲存配置、dry-run、生成、檢查,再交付窄條 ProRes 4444 MOV。字幕若在製作後增刪或變速,需要重新同步。

分段建議的固定輸出格式

段落進度條短標題內容概括起始原話結束原話
1簡短章節名本段講什麼從 SRT 逐字引用本段第一句從 SRT 逐字引用本段最後一句

每段一行,標題用於進度條,概括幫助使用者判斷分段,原話範圍幫助使用者定位。表格後請使用者確認是否採用,或指出需要合併、拆分、改標題的地方。原話不能改寫成摘要。若章節過多導致文字放不下,說明實際排版問題並提出縮短標題、調整字號或其他排版方案,由使用者決定;不能為了適配樣式強行壓成 5 段或擅自合併已確認章節。

確認資訊在當前會話中持續有效,不重複索要。沒有明確授權時不改稿、不改字幕、不剪原片。

已驗證樣式

  • 朦朧白底(soft-white-green):直角橫條、半透明白底、白色章節文字和豎線分隔,填充隨本段時間推進。

  • 人物領走(walking-leading):沿用上面的橫條,只增加在填充前沿領走的人物。人物與條等高,身體下移,條外最多露出半個條高,不踩在條頂上走。

  • 圓點連線(dot-line):細線與圓點隨章節進度變色,文字與圓點間距 6 px。

  • 分段短線(short-segments):每章一根短線,按本章時間填色,文字與短線間距 6 px。

  • 文字領走(text-leading):文字隨章節進度變色,人物在前沿領走,無長條底色;小字號無描邊,使用 4 倍精度繪製與單次透明度合成。

五款都可任意修改 RGB 填充色。新增三款支援 18–72 px 字號(按匯出像素計算),預設分別為 24、26、25 px,輸出高度隨文字自動適配。綠色只是預設色,使用者在 Playground 選定的色號要寫入正式配置,不能預覽換色而匯出仍是綠色。

規則真源為 references/confirmed-rules.md,登記表為 assets/progress/styles.json。只展示和生成已驗證樣式;新增樣式經使用者看過真實樣片並驗收後再登記。

驗收與交付

  • 腳本檢查字幕範圍、標題排版、尺寸、完整解碼、幀數、時長和透明像素。Agent 還需打開聯絡表、實際匯出幀和動態預覽,檢查人物循環、裁切、章節切換和顏色。
  • 朦朧白底 1440×64;人物領走 1440×96,其中條高 64、人物最高 64、下方露出最多 32。新增三款預設尺寸分別為 1440×78、1440×70、1440×96;文字領走人物最高 64,下方露出最多 32。改條高時按同樣比例計算,預設不匯出整幅畫布。
  • 下載的是窄條 ProRes 4444 MOV。透明 WebM 用於瀏覽器預覽;reference-qtrle.mov 只用於內部校驗,不交付。不要用普通 MP4 替代透明影片。
  • 除條和人物外必須透明。預覽底色、斜線或棋盤格不得烘焙進檔案。
  • 使用者已驗證本次窄條 ProRes 4444 在剪映可用;新的檔案仍需檢查,不能把瀏覽器正常或存在 alpha 當成任意版本剪映都支援。
  • 回傳絕對路徑的成品連結,說明放在原影片上方軌道、開頭對齊、保持原速、鋪滿寬度並移到頂部。樣片明確標註時長,不能冒充使用者影片的全長進度條。

按文案生成幾秒獨立短動效、章節過渡使用 ll-video-motion;配音、全程字幕和連續素材剪輯使用 ll-video-edit。

相關技能