# 智慧體外掛 Source: [智慧體外掛]() Documentation index: [llms.txt]() Last updated: 2026-07-13 ChatCut 智慧體外掛是公開的 npm 包 `@chatcut/skill`（目前是 v0.2.1），它會安裝一個名為 “chatcut” 的 Claude Code 技能，以及一個命令列工具 `chatcut`，可以根據一段文字 prompt 和一組素材 URL 或本地檔案路徑來建立 AI 剪輯影片。 ## 如何安裝？ 執行 `npm install -g @chatcut/skill`（`pnpm add -g` 和 `yarn global add` 效果相同），然後重啟 Claude Code。必須進行全域性安裝 —— 該技能會呼叫 PATH 上裸的 `chatcut` 二進位制檔案，所以 `npx @chatcut/skill submit` 是不可行的。安裝過程的 postinstall 步驟會把 SKILL.md 複製到 `~/.claude/skills/chatcut/SKILL.md`，讓 Claude Code 自動識別這個技能；這個註冊步驟是盡力而為的，不會導致 npm 安裝失敗，如果之後 Claude Code 沒有識別到這個技能，執行 `chatcut install` 手動註冊即可。 ## 執行它需要什麼？ `chatcut` CLI 需要 Node.js 18 或更高版本（package.json 中 `engines.node >=18`）。 ## 這個 CLI 能做什麼？ `chatcut` 命令提供九個子命令：`install`（帶 `--link` 選項）、`update`、`login`、`logout`、`pick`、`submit`、`status `、`watch ` 和 `help`。核心命令是 `submit`，它需要必填的 `--prompt `、一個或多個可重複的 `--asset ` 標誌（type 為 `audio`、`gif`、`image` 或 `video`），以及可選的 `--name `、`--resolution <480p|720p|1080p>`、`--format `、`--codec `、`--max-turns ` 和 `--model ` 標誌。如果你手頭還沒有素材路徑，`chatcut pick` 會開啟一個原生檔案選擇對話方塊，並打印出 `path:type` 格式的行，可以直接餵給 `submit --asset`。 ## `chatcut submit` 是如何生成影片的？ 把 prompt 和素材交給 `submit`，它會替你跑完整條流水線：你用自然語言描述這次剪輯，並以公開 URL 或本地絕對檔案路徑的形式提供素材 —— 兩者接受方式完全相同 —— CLI 會在本地轉檔並上傳，ChatCut 的智慧體在服務端組裝時間軸，影片在雲端渲染，最後你會拿到一個帶簽名的下載 URL。如果你沒有設定 `--resolution` 或 `--format`，CLI 會自動在你的 prompt 後追加一條匯出指令，預設匯出 1080p 影片。提交一個任務是付費操作，所以如果智慧體在提交前改動了你的措辭，它必須先停下來，把最終的 `--prompt` 文字展示給你確認。 ## 需要多久，進度在哪裡看？ `chatcut submit` 會一直阻塞，直到任務完全完成 —— 轉檔、上傳、智慧體的編輯迴圈、雲端渲染都跑完之後才會返回 —— 期間會持續向 stderr 輸出人類可讀的進度資訊。在後臺，它每 3 秒輪詢一次任務狀態，如果任務在 40 分鐘內沒有完成，就會以超時錯誤放棄。 ## 結果最終在哪裡？ 每次 `chatcut submit` 執行都會建立一個新的 ChatCut 專案 —— 用 `--name` 命名，或者接受預設名 —— 執行結束後會在 stdout 列印一行 JSON，包含該專案的 `projectId`、任務的 `jobId`，以及渲染檔案的帶簽名 `outputUrl`。 ## 需要先執行 `chatcut login` 嗎？ 不需要 —— 如果 `submit` 沒有找到已儲存的 API key，它會自動開啟瀏覽器讓你登入，登入完成後繼續執行任務，所以首次 submit 之前不需要單獨一步 `chatcut login`。這個登入流程會開啟一個指向 ChatCut 登入頁的瀏覽器視窗；你確認後，CLI 會在後臺把結果換成一個長期有效的 API key，整個流程如果 5 分鐘內沒有完成就會超時。 ## 這和 “Codex 外掛” 是同一個東西嗎？ 就目前釋出的版本而言不是 —— `@chatcut/skill` 只是一個 Claude Code 技能：CLI 註冊在 `~/.claude/skills/chatcut` 下，包裡沒有任何東西與 OpenAI Codex 整合。 另見：[ChatCut 編輯器的佈局是怎樣的](https://pr-444-preview.chatcut.dev/docs/editor-overview)。 ## 如何安裝並登入 ChatCut 智慧體外掛？ 用 `npm install -g @chatcut/skill` 全域性安裝外掛 —— `pnpm add -g` 和 `yarn global add` 效果相同 —— 然後重啟 Claude Code。它需要 Node.js 18 或更高版本。安裝過程還會把 `SKILL.md` 註冊到 `~/.claude/skills/chatcut/`，讓 Claude Code 自動識別這個技能；如果這一步沒有發生（比如用了 `--ignore-scripts`），執行 `chatcut install` 手動完成註冊。必須全域性安裝 —— 在 Claude Code 裡用 `npx @chatcut/skill` 是不行的。 你不需要單獨的登入步驟：第一次 `chatcut submit` 會開啟瀏覽器進行基於 PKCE 的授權交換，如果 5 分鐘內沒有完成，流程會超時。如果想提前登入，執行 `chatcut login`。 另見：[如何登入 ChatCut](https://pr-444-preview.chatcut.dev/docs/sign-in-and-account#how-do-i-sign-in-to-chatcut)。 ## ChatCut 智慧體外掛能做什麼，有哪些限制？ ChatCut 智慧體外掛 —— 也就是作為 Claude Code 技能的 `chatcut` CLI —— 會建立一個專案、上傳你的素材、執行一次自然語言 AI 剪輯任務，並在一條命令裡返回一個帶簽名的下載 URL。`chatcut submit` 接受一段 prompt 加素材（URL 或本地檔案路徑）；只有當編解碼器不相容瀏覽器、影格率超過 30fps，或位元速率超過 8Mbps 時，它才會在本地轉檔影片，並把輸出限制在最長邊 1920px 以內 —— 否則會原樣上傳檔案。之後它會一直阻塞，直到 ChatCut 服務端的智慧體完成編輯和雲端渲染，期間向 stderr 輸出進度，最後向 stdout 輸出一行包含 `jobId`/`projectId`/`outputUrl` 的 JSON。 限制：submit 每 3 秒輪詢一次，40 分鐘後超時。`chatcut status ` 只檢查一次任務狀態；`chatcut watch ` 最多輪詢 20 分鐘。CLI 每 24 小時檢查一次是否有新版本（結果會快取），並且只會提示，從不阻塞命令執行。 另見：[如何安裝並登入 ChatCut 智慧體外掛](https://pr-444-preview.chatcut.dev/zh-hant/docs/agent-plugin#%E5%A6%82%E4%BD%95%E5%AE%89%E8%A3%9D%E4%B8%A6%E7%99%BB%E5%85%A5-chatcut-%E6%99%BA%E6%85%A7%E9%AB%94%E5%A4%96%E6%8E%9B)。