ArcReelStudio

開源、自架的 AI 影片製作工作台
把小說、完成的劇本或商品素材，做成角色一致、過程可控、費用可追蹤，而且還能繼續編輯的短影片。

快速開始 · 入門教學 · 完整文件

ArcReelStudio 是 ArcReel 的修改版本，由 HazelnutParadise 維護。和原版的差異見下方「與原版 ArcReel 的差異」，原始專案的授權與署名規定見「授權條款」。

介面一覽

作品範例

ArcReel-.-.01.-720p.mp4

《入職地府後投訴鬼都是我老客戶》第 1 集

ArcReel-.-.02.-720p.mp4

《入職地府後投訴鬼都是我老客戶》第 2 集

ArcReel-.-.03.-720p.mp4

《入職地府後投訴鬼都是我老客戶》第 3 集

ArcReelStudio 是什麼

ArcReelStudio 是開源、自架的影片製作工作台，適合做 AI 漫劇與小說改編、旁白解說短影片，以及廣告和帶貨短片。內容分析、素材管理、分鏡、媒體生成、費用追蹤和匯出，都串在同一條產線上，每一步都能審核，中斷後也能接著做。

• 同一條產線：小說、完成的劇本或商品素材，都能一步步變成角色、場景、道具、分鏡、影片片段和完成的影片。
• 畫面一致，人工把關：角色、場景等參考圖可以跨分鏡重複使用。關鍵階段可以先確認再往下走，單一素材可以重做，也能退回舊版本。
• 模型與費用集中管理：文字、圖像、影片和 TTS（文字轉語音）能力在同一處設定，生成前後都能查看預估費用和實際用量。
• 交付後可繼續編輯：可以直接合成影片，也可以匯出剪映草稿，繼續調整字幕、配音、節奏和轉場。匯出格式以中國大陸版剪映為準，尚未驗證是否相容 CapCut。

與原版 ArcReel 的差異

ArcReelStudio 保留原版的製作流程，主要差在多人協作、帳號與訂閱的接法，以及部署預設值。

項目	原版 ArcReel	ArcReelStudio
帳號	單一登入帳號，帳密寫在 .env	帳號存在資料庫，分管理員和成員。管理員可以新增、停用成員，改角色和重設密碼
協作	一次一個人編輯，存檔時可能蓋掉別人的修改	像共用文件一樣多人同時打字，看得到彼此的游標和在線成員。Agent 或背景任務改了同一處時會自動合併
API Key 管理	每個供應商用預設的那組密鑰	新增「設定 › 連線中心」。同一家可以存多組連線，每個模型設定都能指定用哪一組
訂閱帳號	Agent 可以用 Claude 訂閱	可以在網頁上登入 Claude、ChatGPT、Grok 訂閱，每家可登入多個帳號。文字與圖片生成也能改用訂閱額度
Agent 引擎	Claude	Claude 或 OpenAI Codex。Codex 可以用 ChatGPT 訂閱或 OpenAI API Key
介面語言	簡體中文、英文等	新增繁體中文
影片編碼	CPU 編碼	在 NVIDIA GPU 上可用 NVENC 編碼完成的影片
部署預設	映像 arcreel/arcreel，時區 Asia/Shanghai	映像 ghcr.io/hazelnutparadise/arcreelstudio:main，時區 Asia/Taipei，文件補上連接既有 PostgreSQL 的做法

Codex 引擎目前還不支援從較早的訊息改寫重來、Agent 向使用者提問、唯讀審查子 Agent，以及訂閱與 API Key 之間的自動切換。每一項修改的細節與日期記錄在本 repo 的提交歷史中。

從素材到完成影片

flowchart LR
    A["小說 / 完成的劇本 / 商品素材"] --> B["內容分析與專案規劃"]
    B --> C["角色 / 場景 / 道具素材"]
    C --> D["分集與結構化劇本"]
    D --> E["分鏡圖 / 多格分鏡"]
    E --> F["影片片段 / 旁白音軌"]
    F --> G["合成完成影片"]
    F --> H["匯出剪映草稿"]

Loading

每個階段都可以交給 Agent（AI 助理）自動安排，也可以由使用者在工作台裡審核、調整或重新生成。怎麼選模式，請看 創作流程與模式。

快速開始

先安裝 Docker 和 Docker Compose，再執行：

git clone https://github.com/HazelnutParadise/ArcReelStudio.git
cd ArcReelStudio/deploy

cp .env.example .env
docker compose up -d

用瀏覽器開啟 http://localhost:1241。預設使用者名稱是 admin。AUTH_PASSWORD 留空時，第一次啟動會產生一組初始密碼，存在 deploy/projects/runtime/initial-admin-password。登入後可以在 設定 › 帳號與成員 修改密碼、新增成員。

預設的 Compose 設定會把 1241 連接埠開放給主機上所有網路介面。請不要把服務直接放到公開網路上。要從遠端連線，請先設定登入驗證，並透過 HTTPS、VPN 或安全通道存取，詳見 反向代理與 HTTPS。

登入後進入 設定 頁面，設定 Agent 以及文字、圖像、影片等生成能力，接著建立專案就能開始製作。

第一次使用的完整流程見 完整入門教學。正式部署、升級、備份和反向代理見 部署與維運。

文件

以下連結指向原始專案的文件網站，內容為簡體中文，沒有涵蓋上方列出的 ArcReelStudio 新功能。

頁面	內容
文件首頁	依使用者、維運人員和開發者分流的入口
完整入門教學	從第一次部署到生成第一支影片
創作流程與模式	小說、劇本與創作構想三種創作類型，以及兩種生成模式
供應商與模型設定	Agent、文字、圖像、影片、TTS 供應商的選擇和設定
剪映草稿匯出	把生成結果交給剪映繼續編輯
常見問題	部署、費用、模型、資料和授權問題
部署與維運	SQLite、PostgreSQL、升級、備份和反向代理
從 SQLite 遷移到 PostgreSQL	資料遷移、驗證與還原流程
架構說明	Agent Runtime、任務佇列、供應商抽象層和資料層
貢獻指南	本機開發、測試、程式碼規範和 PR 流程

回報問題與貢獻

遇到可以重現的 Bug，或有明確的功能需求，請到 GitHub Issues 提出。

也歡迎貢獻程式碼、文件、測試、供應商串接，或協助重現問題。開始開發前請先閱讀 CONTRIBUTING.md。複製專案到本機後，建議馬上安裝專案的 pre-commit hook：

uv run pre-commit install

授權條款

原版 ArcReel 採用 GNU Affero General Public License v3.0 授權，附加條款見 NOTICE。ArcReelStudio 是 ArcReel 的修改版本，HazelnutParadise 所做的修改同樣採用 AGPLv3 授權，所有修改記錄在本 repo 的提交歷史中。

依照附加條款，修改版本必須保留原作者署名與原始專案連結，並標明所做的修改：

Powered by ArcReel — https://github.com/ArcReel/ArcReel

Copyright © 2026 Pollo3470 and ArcReel contributors

ArcReelStudio 修改部分：Copyright © 2026 HazelnutParadise