video-recap-skills

AI 影片解說 Agent 技能包:自動切鏡、看畫面寫解說詞、配音混音合成成片,可匯出剪映/CapCut 草稿,無需 GPU

video-recap-skills 是什麼?

AI 影片解說 Agent 技能包:自動切鏡、看畫面寫解說詞、配音混音合成成片,可匯出剪映/CapCut 草稿,無需 GPU

video-recap-skills 概覽

這是什麼

Video Recap Skills 是一組七個技能(六個生產 + 一個按需參考),可裝進 Claude Code、Codex CLI、OpenCode 或 OpenClaw 等程式 Agent。它能將一段或多段影片轉換成中文解說成片(影片解說)。流程包含場景偵測、ASR、VLM、腳本撰寫、TTS、ffmpeg 組裝,以及可選的剪映草稿匯出。只需要本機 ffmpeg 和一個遠端小米 MiMo key;不需要 GPU、不需要 pip install,也不需要下載模型。支援的輸入格式:.mp4、.mov、.mkv、.webm。

主要功能

  • 一個 key,本機只要 ffmpeg。 ASR、VLM、TTS 都走小米 MiMo;本機只使用 Python 標準函式庫和 ffmpeg。TTS 可切換為 Fish Audio。
  • 先做創作決定,再分配聲音。 Agent 在首次策劃時比較可行的剪輯方向,寫入故事計畫(recap_story_plan.json),包含觀眾承諾、視角、戲劇問題與每拍的變化,再為每一拍指定聲音歸屬(旁白、原聲對白或沉默)。
  • 先剪後配,時間軸自然對齊。 剪輯模式先將長影片剪成成片,再對著成片寫解說。可一次傳入多個影片,按 source_id 選段剪成一條主線。
  • 成片之外還能繼續改。 多軌時間線 timeline.json 可一鍵匯出剪映草稿,原片、解說、BGM、字幕、圖片疊層皆可編輯。
  • 每一步都留下可核對的記錄。 旁白 lint、組裝 QC 與最終 QC 會產生機器可讀報告;看片修改記錄會追蹤本輪改動、凍結項與驗證結果。

使用情境

將一段或多段影片製作成中文解說成片。例如從短劇中選段、剪輯、寫稿、配音、混音、包裝成最終影片,並可選擇匯出可編輯的剪映草稿。適用於影片解說、內容二次創作、故事重述等。

快速開始

前置需求:Python 3.10 或更新版本、PATH 上有 ffmpeg,以及一個小米 MiMo API Key。若要燒錄字幕,需要帶 libass 的 ffmpeg(macOS 上使用 brew install ffmpeg-full)。 設定環境變數: bash export MIMO_API_KEY=your-mimo-key export MIMO_TOKEN_PLAN_CLUSTER=cn # 僅 tp-* Token Plan key 需要:cn | sgp | ams 透過 Claude Code 安裝: text /plugin marketplace add zenstory-ai/video-recap-skills /plugin install video-recap-skills@video-recap 或透過 Codex CLI: bash codex plugin marketplace add zenstory-ai/video-recap-skills codex plugin add video-recap-skills@video-recap 關於 OpenCode 與 OpenClaw 的安裝方式,請參閱倉庫 README。

授權與價格

本專案以 MIT 授權開源,可免費使用。請注意小米 MiMo API 服務為按量計費(實測一條完整影片約 1.3 元人民幣);Fish Audio TTS 也有其自身的計費方式。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/zenstory-aivideo-recap-skills.svg)](https://yunodb.com/tools/zenstory-aivideo-recap-skills?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/zenstory-aivideo-recap-skills?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/zenstory-aivideo-recap-skills.svg" alt="Featured on YunoDB" height="20"></a>