成風口播剪輯評測：chengfeng-videocut 讓 Agent 判斷、Runtime 動刀

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

GitHub 上累積近 3000 顆星的開源專案 chengfeng-videocut（成風口播剪輯），把口播影片的剪輯流程做成了一套需要 Agent 介入判斷、再交由本地 Runtime 執行確定性動作的外掛。它最有意思的地方不在於「一鍵剪片」，而是作者把誠實寫進了發布流程：2026 年 7 月評測初稿時，它還只有兩個業務入口，連正式的轉錄指令都還沒補齊；兩個月後已經推進到六個對外入口的外掛 0.10.8 候選版，但 README 依然白紙黑字要求，在公開 Runtime 與雙平台驗收完成之前，不得把候選版講成可下載的穩定版本。這條作者自己畫下的界線，剛好是理解這套工具最該有的起點。

同樣圍繞終端 AI agent 工作流的工具，Port22 想做的是把 Codex 等 agent 的等待確認搬到 iPhone 上。

這篇會把官方倉庫的架構、六個對外入口、雙平台安裝流程，以及 2026 年 9 月此刻的版本邊界一次拆給你看，讓你判斷它值不值得現在就裝進自己的工作鏈。

這套外掛到底在做什麼

chengfeng-videocut 的官方倉庫 由署名 chengfeng（對外品牌為 AI 產品自由）的開發者維護，採用 Apache 2.0 授權，主要語言是 JavaScript。截至 2026 年 9 月上旬，倉庫累積約 2977 顆星、384 個 fork，最早建立於 2026 年 1 月中旬，最近一次推送落在 2026 年 8 月下旬，屬於還在活躍推進的專案。產品本體（Runtime 與剪輯工作台）放在同一作者的另一個倉庫 Agentchengfeng/chengfeng-videocut，外掛倉庫只負責 Skill 與 Marketplace 包裝。

Pin

2026 年 7 月評測初稿時，它對外暴露的業務入口只有剪口播與口播成片兩個；到了 9 月，README 已把對外入口擴充成四個業務入口加兩個支援入口：

入口變多了，分工原則卻沒有變。外掛刻意不複製剪輯產品本體，剪輯判斷與流程編排由 Skill 層負責，真正會動到影片檔案的確定性動作（剪切片段、算繪成片、驗證結果）全部交給另一個叫做 chengfeng-videocut Runtime 的本地執行層，透過 CLI 或 API 呼叫。只有進入人工審核階段且 Studio 能力匹配時，才會打開介面；兩個支援入口更輕，上報 Bug 不安裝 Runtime、不啟動 Studio、也不改專案，檢查更新則只走官方 Marketplace 機制。

為什麼要把判斷和動作拆開

很多人看到「AI 剪輯 Agent」會直覺聯想到「模型直接把影片切好給你」。這套外掛走的不是那條路。它把整件事拆成兩層：

Skill 層（Agent 負責）做的是需要語意理解的工作，例如判斷哪一段是口誤、哪一段靜音該保留、字幕時間軸有沒有對齊。這層的輸出是一份審查紀錄，而不是直接覆寫原片。

Runtime 層（本地執行）做的是不能出錯的確定性動作，例如依審查紀錄把指定時間碼的片段切掉、把字幕燒進影片、算繪成片並跑驗證。這層的設計原則是「不覆寫、不偷打包舊算繪器」，動作失敗就停下來回報，不會猜著繼續做。

這種拆法的好處是責任分明：Agent 可以犯錯、可以被你打回票，但真正動刀的是可控的 Runtime。README 裡的架構圖把這層關係畫得很清楚，從 Codex 發出的指令會先經過共用的 ensure-runtime 檢查，確認本地 Runtime 就緒才會往下走。

Runtime 的就緒檢查是一個叫 doctor 的流程，會依三種狀態決定下一步：

• desktop-managed 或 ready：Runtime 已就緒，桌面路徑可直接複用桌面安裝與同一個使用者服務，繼續目前的 Skill
• missing：提示一句安裝狀態，引導到 GitHub Release，做 SHA 256 校驗，安裝後重跑 doctor 再繼續
• unhealthy 或 failed：停止動作，不覆寫、不打開 Studio

Runtime 預設安裝在 ~/.chengfeng-videocut 這個路徑，整個外掛則透過 Codex 的 Marketplace 機制安裝，不需要手動複製 Skill 檔案到 ~/.claude/skills 之類的目錄。

安裝流程：Codex Marketplace 外掛加本地 Runtime

先把系統需求講清楚：官方目前支援 macOS（Apple Silicon 或 Intel）與 Windows 10/11，Windows 支援自 Runtime v0.4.2 起正式可用，作者也在 README 註明已在 Windows 真機走通安裝、常駐服務、崩潰自癒、重啟自啟與導出成片等全流程。安裝分成掛市場與裝 Runtime 兩段，第一步用三條指令把倉庫掛進 Codex 的 Marketplace 並啟用外掛：

“`bash

codex plugin marketplace add Agentchengfeng/chengfeng-videocut-skills –ref 1487e02b1c0c39ea74d079e8ce45da56bf59bc32

codex plugin marketplace upgrade chengfeng-videocut –json

codex plugin add chengfeng-videocut@chengfeng-videocut

“`

第二步在你第一次使用任何一個業務 Skill 時自動發生，也可以裝完外掛後直接對 Codex 說「安裝剪輯環境」提前觸發。「檢查更新」的就緒檢查會從固定版本的 GitHub Release 下載 Runtime、做 SHA 256 校驗，再安裝到 ~/.chengfeng-videocut；純 CLI 路徑只下載版化的 portable 安裝包，不安裝桌面版 DMG 或 EXE，Release 不存在、雜湊不符或既有 Runtime 不相容時都會直接停止，不覆寫現有安裝、也不回退舊版。三條指令必須分開是 Codex 官方 CLI 的機制：先掛市場、再固定要安裝的精確快照、最後從已驗證的市場快照安裝，--ref 後面的快照編號會隨候選版前進，實際安裝前以官方 README 當下的值為準。

這裡要特別提醒：外掛本身（包含預先打包的 MCP Server，約 1.1MB）和 Runtime 是兩件事。外掛只是 Skill 與編排邏輯，真正會在影片檔案上動工的是 Runtime，兩者缺一不可。README 目前推薦直接安裝桌面預覽包，它自帶 Runtime、Bun、FFmpeg 與 FFprobe，統一裝進 ~/.chengfeng-videocut 的受管目錄；若只走外掛加 CLI 便攜包路線，就得自行補齊 Bun（1.2 以上）、Node.js（20 以上）、ffmpeg（6 以上，含 ffprobe）與 Chrome（導出成片時渲染字幕和動畫用）。README 同時明講，不把 npx github: 這類一次性指令當成對外穩定安裝承諾，Runtime 也必須通過 doctor 檢查才會放行。

倉庫結構也呼應了這個分工，主要目錄與檔案分布在幾個位置：

• 根目錄 chengfeng-videocut-skills/ 下的 .agents/plugins/marketplace.json 是 Marketplace 註冊檔
• plugins/chengfeng-videocut/ 是外掛本體，包含 .codex-plugin/plugin.json、.mcp.json、預先打包的 dist/server.mjs（約 1.1MB）、public/review-confirm.html 確認卡頁面，以及 scripts/ 與 references/
• 六個 Skill 放在 plugins/chengfeng-videocut/skills/ 下的 chengfeng-cut、chengfeng-subtitle、chengfeng-visual、chengfeng-export、chengfeng-report-bug 與 chengfeng-check-updates，並以 runtime-requirements.json 聲明 Runtime 合同
• LICENSE、NOTICE.md、CITATION.cff 對應 Apache 2.0 授權與引用格式

從目錄可以確認，對外 Skill 就是上面六個，共同規則放在 references/ 目錄當內部契約，不占用使用者的 Skill 名額。中間的確認卡（review-confirm.html）搭配一個 MCP App，用來把白名單動作、專案 ID 與修訂版次交回 Codex 對話，它本身不執行剪輯，也不是第七個 Skill。

Pin

平台身分的小轉折：從 Claude Code Skills 到 Codex 外掛

在查證過程裡有一個值得講清楚的事。這個專案的 GitHub 倉庫描述至今仍寫著「用 Claude Code Skills 做的影片剪輯 Agent」，部分早期資訊也以 Claude Code Skill 的角度介紹它（安裝方式是把倉庫複製到 ~/.claude/skills/videocut）。

但官方 README 現在的說法已經不一樣了：它自我定位為「給 Codex 用的中文口播剪輯 Marketplace 外掛」，安裝路徑走的是 codex plugin marketplace add。換句話說，這套工具經歷過一次從 Claude Code Skill 形態、轉到 Codex Marketplace 外掛形態的演進。

對使用者來說，這個差別很實際：你現在要照官方 README 的 Codex 外掛路線安裝，而不是早期資料提到的 Claude Code Skill 路線。如果你看到的是舊版安裝教學，務必回到官方倉庫的 README 對照最新指令，才不會裝錯形態。若你對 Skill 形態的開發工具特別感興趣，TechMoon 先前評測過的 last30days Claude Code Skill 與 能匯出給 Cursor 和 Claude Code 的 Agent Skills 構建器 Refly，可以一起放進參考清單做橫向比較。

語意剪輯和波形靜音剪輯，到底差在哪

口播影片最常見的處理需求，是把大量的靜音空窗、語氣停頓、口誤重複剪掉。傳統做法依賴音訊波形的分貝閾值判斷靜音，門檻抓得太鬆會漏剪，抓得太緊又會把呼吸點一起切掉，成片聽起來生硬機械。

chengfeng-videocut 走的語意路線，差別在於判斷邏輯是建立在對內容的理解上，而不是單純看音量曲線。這意味著系統是在解析口播內容的過程中標記問題，例如逐字識別口誤，並保留符合自然語言邏輯的停頓。審查紀錄產出後會先交給人工決策，確認無誤才會進入實際剪切片段的批處理。

兩種路線的取捨可以這樣比較：

要強調的是，這個比較描述的是兩種路線的設計取向，不代表 chengfeng-videocut 已經在每一種素材上都跑通完整流程。它目前能不能在你手上跑出這些結果，取決於下一節要講的版本邊界。

版本邊界：舊缺口翻頁之後，界線移到了穩定發布

這是整篇最該仔細看的一段，因為它直接決定你會不會裝了才發現跑不起來。先回顧評測初稿時的邊界：2026 年 7 月的 README 在「當前邊界」這一節白紙黑字寫著，產品 Runtime v0.1.1 有兩個明確缺口：

第一，還沒有正式的原影片 transcribe 或 import 指令。也就是說，當環境裡沒有可用的自動語音識別（ASR）能力時，剪口播這個 Skill 會直接停下來，並回報缺少對應能力，不會硬著頭皮繼續。這代表如果你的本機環境沒有先把 ASR 這層準備好，裝完外掛也跑不出剪後影片。

第二，render run 仍可能要求外部的算繪器。新版 Skill 不會把舊的算繪器偷偷打包回來，但也因此在某些情境下，你得自己準備好符合條件的外部算繪器，成片階段才能順利完成。

兩個月後回頭看，這兩個缺口已經被高速迭代翻頁：Runtime 在產品倉庫已連發十個公開版本，8 月初接連讓 Windows 支援正式可用、修好 Windows 轉錄路徑，一路推進到 8 月下旬的 v0.5.9 Windows beta；外掛本體也來到 0.10.8 候選版，剪輯、字幕、畫面、導出各有對應入口，桌面預覽包更把 FFmpeg 與 FFprobe 直接包進來，純 CLI 路線才需要自己補齊算繪相關依賴。但界線沒有消失，只是移了位置：README 的穩定發布順表明，在公開 Runtime 與雙平台驗收完成之前，不得移動 stable 頻道、不得把候選版表述為可下載版本；已安裝 0.10.5 或 0.10.6 的測試者，也要透過「檢查更新」核對版本、內容提交與 SHA 256 之後才確認啟用，任何一步未通過就停止推進。把它當成已定版的開箱即用剪輯神器還太早；把它當成架構已就位、快速演進中的開源 Agent 專案，會比較接近事實。

授權、作者與官方資源

授權方面，本專案使用 Apache License 2.0。原作者署名為 chengfeng，對外品牌是 AI 產品自由。官方列出的身分與管道如下：

• GitHub 帳號：Agentchengfeng
• X 帳號：chengfeng240928
• 小紅書、公眾號、B 站、抖音、影片號：AI 產品自由
• 原始倉庫：Agentchengfeng/chengfeng-videocut-skills

Apache 2.0 是相對寬鬆的開源授權，允許商業使用與修改，但要求保留原作者、原始倉庫連結、LICENSE 與 NOTICE.md。若你打算把它包進自己的產品或做二次開發，記得遵守這幾項歸屬要求。想做正式引用的話，倉庫還附了 CITATION.cff 方便你取得標準引用格式。

誰適合現在就裝，誰建議先等一輪

綜合上面的拆解，給三種情況的建議：

適合現在就跟進的人：你本來就在用 Codex 做開發或內容產製，本機環境已經備好，或願意照官方依賴表補齊 Bun、Node.js、ffmpeg 與 Chrome，願意陪一個還在補齊階段的開源專案一起迭代，也接受跑不通時自己排查。這種使用者最能吃到它架構拆分的好處，也能從審查紀錄裡逐步把自己的剪輯偏好寫進配置。

建議先觀望的人：你只想找一套裝完就能全自動產出成片的工具，不想處理 Runtime 安裝、doctor 檢查或依賴補齊這些事。在 stable 頻道正式指向候選版、雙平台驗收完成之前，這套外掛離你的期待還有距離。先把它放進 watch 清單，等穩定版正式發布再回來。

可以順便參考的替代路線：如果你重視的是 AI 影片產製的整體工作鏈，而不只是口播剪輯這一環，那麼把視角拉大一點會更有收穫。像是以小說拆鏡與角色鎖定為核心的 Toonflow AI 短劇產生器，或是把劇本到影片串成一條流程的 Jellyfish 開源 AI 短劇工作流，以及一鍵部署私人 AI 助理的 OpenClaw 第三方一鍵部署工具，都能讓你從不同角度理解目前開源 AI 影片與 Agent 生態的長相。

常見問題

chengfeng-videocut 是免費的嗎？

是。專案以 Apache 2.0 開源，程式碼可免費取得、修改與商業使用，只要保留原作者與授權標示。要留意的是「外掛免費」不代表「使用零成本」，桌面預覽包雖然自帶 Runtime、Bun 與 FFmpeg，硬體與設定成本仍由你自己吸收。

它只能在 Codex 上用嗎？

依目前官方 README 的說明，它是以 Codex Marketplace 外掛的形式發布，安裝走 codex plugin 指令。雖然倉庫描述保留了「Claude Code Skills」的歷史用語，但現行的安裝與執行路線是 Codex 外掛，建議照官方 README 操作，不要混用舊的 Skill 安裝教學。

它會自動把我的口播影片剪好嗎？

不會全自動。剪口播會先產出一份審查紀錄交給你確認，確認後才會執行批處理剪輯，這是它「判斷交給 Agent、動作交給 Runtime」的設計。而且任何一層就緒檢查沒有通過，它都會直接停下來回報缺什麼，不會勉強產出。

我需要自己準備哪些依賴？

看你想走哪條路線。桌面預覽包路線幾乎不用自己準備：它自帶 Runtime、Bun、FFmpeg 與 FFprobe，但桌面路徑仍需要 Node.js 跑 Skill 腳本與 MCP Server，以及 Chrome 用來導出字幕和動畫。只走外掛加 CLI 便攜包路線的話，Bun（1.2 以上）、Node.js（20 以上）、ffmpeg（6 以上）與 Chrome 都要自行安裝。具體依賴會隨版本演進調整，務必以官方倉庫 README 的最新說明為準。

它和一般靜音剪輯工具差在哪？

最大差別在判斷依據。一般靜音剪輯看的是音訊波形的分貝閾值，容易誤刪呼吸點；這套外掛走的是語意理解路線，標記口誤時是逐字識別內容，並保留符合自然語言邏輯的停頓。但語意路線對算力與環境的要求也更高，這是取捨。