Communitygithub.com

Ee1ex/elx-ezvideoedit

使用 2ByteASR MCP 製作帶字幕影片,完成三模型辨識、校對、剪輯、5 個標題、3 則簡介、標籤及三種比例封面,將原始檔案歸位後按單一影片資料夾交付;預設僅於本機製作,上傳為選用步驟。

elx-ezvideoedit 是什麼?

ELX EzVideoEdit 是一個為 ELX 工作台設計的 AI 輔助影片編輯技能,專門用於自動化「帶字幕影片」的產出流程。它整合了多個模型(如 MOSS、FireRed、Qwen3-ASR)進行語音辨識、時間軸校對與獨立複查,並透過原生服務完成智慧斷句、校對與剪輯。技能會自動產生 5 個不同風格的標題、3 則不超過 50 字的簡介、獨立的標籤,以及 16:9、4:3、3:4 三種比例的封面圖片。所有產出檔案(含字幕 SRT、成片、原始影片、宣傳文案等)會依單一影片資料夾結構交付,原始素材會經 SHA 核驗後移動歸位。此技能支援 Cursor、Codex 等 Agent 平台,但強烈依賴本機環境:使用者需自行配置模型、Python、MCP 存取權限與文字服務,且不繼承作者授權。預設流程僅於本機完成,第二階段的上傳功能為選用,需使用者明確要求並使用現有插件。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Ee1ex/elx-EzVideoEdit/tree/main/.agents/skills/elx-ezvideoedit

在你喜歡的 AI 中提問

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

說明文件

ELX EzVideoEdit

本 Skill 配合 ELX 工作台執行,並非獨立影片處理器。安裝後的 bundle-location.json 指向實際工作台;原始碼內的 CLI 會自動定位根目錄,亦可使用 EZVIDEOEDIT_ROOT 指定。首次使用前請先閱讀本機設定,本機模型、Python、MCP 存取權限與文字服務須由使用者自行配置,不繼承作者授權或憑證。

第一階段:製作與交付

預設執行至本機交付完成。使用者選擇素材、輸出目錄與本次人工字幕複核方式;若尚無選擇則詢問跳過或手動修改,已明確本次跳過則逐片讀取最新摘要並記錄 skip,不重複詢問,亦不稱人工校對通過。請勿將平台帳號或瀏覽器連線視為本機完成條件。

  1. 執行 node .agents/skills/elx-ezvideoedit/scripts/cli.mjs help,再使用 status 核對真實能力。以 launch 啟動或重複使用服務。任務透過同一服務寫入,不直接修改 task.json。詳細欄位請見本機介面。
  2. 透過 tools/list 與 get_status 發現 native-production/1 能力;官方 0.9.1 及已驗證的 0.9.0 均按實際 schema 呼叫。先核對相同 profile 的實例,必要時使用 node packaging/setup.mjs native-open 開啟 GUI,再進行 native-connect;GUI 與 stdio 共用 profile。模型、API 及權限缺失時回報原生設定位置,由使用者處理,不修改策略繞過。
  3. 品質鏈為 MOSS 主要轉寫、FireRed 字級時間軸、Qwen3-ASR 獨立複查,使用本機既有模型及 Python;AI 智慧斷句與校對使用原生已儲存的文字服務。實際執行、快取重複使用與降級分別回報,不能僅憑設定標籤認定完成。字幕口吃整理不等於音影片剪除。
  4. 使用 native-start 序列製作,native-state 查詢,native-resume 恢復。獨立工具使用 native-operation。AI preview 後以同 job_id 套用,不重複外送。超時或結果不明時先查詢舊 job/attempt;確定 configuration_required 後才在使用者完成設定時恢復,不盲目重送。
  5. 原生 scope=current 僅允許當前專案,建立或開啟其他專案需 library 範圍;獨立能力依各自權限執行。0.9.x 不呼叫舊版 0.8.7 的持續授權或批次 token 介面,也不為 apply_plan/export_subtitles 添加 batch_token。
  6. 正式 save_project 後匯出影片與官方 SRT,核對同一專案快照。native-adopt 僅綁定素材 SHA 一致的同源專案。review-inspect 讀取真實建議數,權限不足時保留未知計數;已授權跳過時以本次 signature 儲存 review-choice。手動修改由使用者在原生程式中儲存,再以 review-finish 僅重新匯出影片/SRT,不重新執行辨識覆蓋手動修改。verification_required 時使用 review-recover 核對舊作業,不重複啟動。
  7. 降級時間軸依服務現有守衛處理。跳過人工檢查不等於忽略失敗、未知錯誤或缺少時間證據。已明確允許保守繼續時才儲存保護範圍;preserve-review 僅用於已完成但 partial 且請求錯誤數為 0 的文字校對,整批保留原文與保護區間,不採用該批建議、不重發,保留 partial 回執。
  8. 根據真實轉錄產生恰好 5 個不同風格的標題、3 條不同且不超過 50 字的簡介、獨立標籤。封面為 16:9、4:3、3:4 三張實際圖片,逐張檢查文字、內容與比例,不拉伸。可推薦組合,不能偽造使用者已選定。

在已核准範圍內連續推進;新增外送服務、費用、目錄或權限變更依本次使用者要求確認。暫停時保留原始影片、專案、輸出與回執,明確恢復後先以唯讀檢查。預設在當前對話序列執行;只有使用者明確要求新對話或子代理時才委派,模型由使用者與宿主選擇。網頁「交給 Codex」僅儲存待辦事項,不代表宿主已執行。

資料夾交付

每個影片一個 <原始檔名>_交付 資料夾,以下檔案直接放置於根目錄:成片_帶字幕.mp4、原始影片(原始檔名)、字幕.srt、發佈文案.txt、封面_16比9.png、封面_4比3.png、封面_3比4.png、交付說明.txt。僅可編輯的專案與實際引用的依賴檔案放入「工程」子目錄。

  • 材料核驗後將唯一原始素材依原始檔名移動歸位,移動前後核對 SHA 與絕對路徑,更新並驗證專案引用。不得複製一份冒充交付原始影片;若已有重複副本則列出路徑、數量、大小與影響,取得刪除確認後處理,不覆蓋唯一原始影片。
  • 專案須對應成片/SRT 同一快照且依賴可用,僅攜帶實際引用的素材,不整包複製快取或歷史專案。交付說明合併剪輯數量、模型/字幕提醒與驗證結論,完整回執留存於工作台。
  • scripts/package-stage1.py --help 為精簡打包入口;輸入服務儲存的任務、文案與封面路徑,原始影片從 original-root 同磁碟移動。跨磁碟或檔名衝突時停止,不隱式複製再加刪除。工作台 import 仍會複製工作素材,不能據此擅刪工作副本。
  • 材料、摘要、時間碼、圖片比例、專案依賴均核實後才稱完整交付。若無可剪候選則回報實際 0,不虛稱剪除音影片。更新套件先驗證,保留使用者修改與歷史,不直接覆蓋。

第二階段:選用上傳

預設由使用者自行使用既有 MultiPost 或平台一般入口。第一階段結束時提供交付路徑與文案;尚未表明上傳選擇時提醒可手動上傳,已明確不上傳則結束,不重複詢問。詳見選用上傳邊界。

僅使用者明確要求 Agent 觸發時才使用現有插件正常入口,核對真實帳號與授權並停留在最終發佈前。插件、登入、驗證碼或控制項失敗時保留現場交接,不自動進行 Computer Use、注入修補或改造插件。付款、註冊、發佈、傳送訊息、帳號權限變更執行前須確認。工作台準備回執不代表上傳或發佈成功。

相關技能