Communitygithub.com

funnyp1g/clothing-promo-video

根據服裝或穿搭圖片製作可下載的朋友圈宣傳 MP4,支援連續容器形變、LOOK 款式切換、合集、配樂及可選品牌片尾。

clothing-promo-video 是什麼?

此技能是一個專業的參數化渲染器,專為將服裝或穿搭圖片轉換為朋友圈宣傳用的 MP4 影片而設計。它能自動分類用戶提供的圖片(主圖、細節圖、品牌圖等),並根據圖片內容編排動畫,產生包含連續容器形變、LOOK 款式切換、款式合集、背景配樂以及可選品牌片尾的完整影片。渲染器支援 1 到 12 款服飾,預設產生 720×1280 解析度、30fps 的預覽片,也可根據用戶需求升級為 1080×1920、60fps 的最終版本。此技能完全基於本地 Python 環境執行,依賴 Pillow、NumPy 和 imageio-ffmpeg,無需任何原項目服務、模型 API Key 或專用工具。生成的影片使用程序化動畫和原始照片,並非擬真人物走秀或神經網路生成的內容,非常適合時尚電商、社群媒體行銷人員快速製作高品質的產品宣傳素材。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add funnyp1g/clothing-promo-video

在你喜歡的 AI 中提問

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

說明文件

服裝圖片宣傳影片

使用本 Skill 自帶的參數化渲染器生成真實 MP4。模型負責看圖、分類和編排,腳本負責動畫、配樂、編碼與完整解碼校驗。可在任意工作目錄運行,無需原網頁專案、模型 API Key 或專案專用工具。

素材與事實

  • 實際查看本次用戶提供的圖片,區分服裝主圖、細節圖、重複圖、品牌圖片和參考圖。參考圖僅用於比較,不進入成片;每張圖片都記錄分類,未展示的圖片說明理由。
  • 預設保留服裝和人物原貌、原圖比例;形變只作用於展示容器。裁切僅在看圖確認主體安全後填寫邊界和理由。
  • 此樣式使用 LOOK 編號和固定穿搭文案,不根據圖片推斷顏色、面料成分、功能、價格、優惠、庫存、聯絡方式或品牌授權。不把 LOOK 編號當成真實貨號。只有用戶明確指定的品牌圖片可用於品牌片尾,不能從衣服上的商標或舊素材提取店鋪品牌。
  • 支援 1–12 款及最多一張片尾品牌圖片。預設每個已識別款式都展示;明確片長不足時說明所需時長並讓用戶選擇加長或分組,不擅自丟棄款式。只有品牌圖時需要補充服裝主圖。
  • 用戶明確要求自訂標題、廣告文案、全新動效或擬真走秀時,說明此渲染器的實際範圍;不要把被忽略的參數稱為已實現。不同畫幅僅等比居中保留豎版構圖。

執行

把下文 SKILL_DIR 替換為實際讀取到的 Skill 目錄,PYTHON 替換為具有依賴的 Python 直譯器;不要寫死原專案路徑。

  1. 運行 PYTHON SKILL_DIR/scripts/render_video.py --check。已有 Python 環境可複用;缺依賴時,在本次工作目錄創建虛擬環境並執行 python -m pip install -r SKILL_DIR/scripts/requirements.txt。依賴為 Pillow、NumPy、imageio-ffmpeg,建議 Python 3.9–3.12;字體已隨 Skill 提供,FFmpeg 由 imageio-ffmpeg 提供。無需安裝原專案服務或執行框架。

  2. 閱讀 輸入規格,在本次工作目錄寫 promo.json。預設 aspect=9:16、quality=preview(720×1280 / 30fps);用戶要求高清或正式成片時選 final(1080×1920 / 60fps)。預設開啟配樂。四款無品牌為 15 秒,有品牌為 18 秒,其他數量自動計算。

  3. 先生成預覽圖:

    PYTHON SKILL_DIR/scripts/render_video.py --spec /absolute/path/promo.json --output /absolute/path/video-output --keyframes
    

    實際查看結果返回的 keyframes 和 transitions,檢查款式覆蓋、主體比例、文字可讀性、轉場連續幀及品牌過渡。預設樣式為暖灰白畫布、深色膠囊、宋體標題、同一個圓角容器連續展開、LOOK 切換、款式合集、諮詢收尾;有品牌圖時再柔和展開為深色品牌頁。檢查沒有問題即可繼續,不額外要求用戶批准渲染。

  4. 用同一規格和輸出目錄運行完整渲染:

    PYTHON SKILL_DIR/scripts/render_video.py --spec /absolute/path/promo.json --output /absolute/path/video-output
    

    運行器複製本次素材和源碼,保存 context.json、輸入規格與 manifest,執行真實渲染,並驗證尺寸、幀率、時長、解碼幀數以及所需音軌。成功時返回 stage=completed 和絕對檔案路徑。無需 frame_write_manifest、frame_finish_video 或任何原專案服務。失敗時根據輸出日誌修正規格或環境;同一失敗連續兩次仍未解決時保留產物並報告具體阻塞。

交付與複用

交付成功返回的 MP4,並給出尺寸、時長及幀率;必要時附海報、關鍵幀或 verification.json。只生成關鍵幀不能稱為影片完成。音樂存在且可解碼不代表已經聽過;未試聽時不聲稱音質已審聽。此成片使用原照片與程式化動畫,不是人物實拍或神經網路生成的影片。

輸出目錄包含 src/render_video.py、src/clothing_morph.py、src/request.json、素材和字體。將整個輸出目錄移到其他機器後,可安裝同一 src/requirements.txt,再運行 python src/render_video.py --spec src/request.json --output /new/output/path 復現。更換款式時編輯規格,不改寫基準動畫;用戶明確修改動效時才另做設計。

相關技能