ganbo-gab/open-storyboard-canvas

开源的 AI 分镜与导演台画布，支持全景图、摄像机控制、提示词预设和自定义供应商调用。

Open Storyboard Canvas – 是什麼

Open Storyboard Canvas 是一個在本機執行的桌面應用程式，讓創作者能在視覺化的「節點畫布」上構建、組織並執行由AI驅動的影像與影片生成流程。它結合了基於 Tauri 的 GUI（React + TypeScript 前端，Rust 後端）與對多個文字轉圖像／文字轉影片提供者（OpenAI 相容 API、Claude、Dreamina CLI 等）的外掛支援。畫布可容納參考媒體、提示詞、生成資產、3D「導演工作室」（用於場景佈局），以及一個可操作節點、提交生成任務並回報狀態的對話式 Canvas Agent。

核心功能（如 README 所述）

領域 應用程式功能
Canvas Agent（測試版） 位於右側的聊天式助手，可讀取目前專案，建立／移動／編輯節點，提交生成任務，追蹤其狀態，並顯示簡潔的推論摘要。支援手動與自動確認模式。
AI 圖像／影片工作流程 可從零開始建立影像，使用參考影像進行編輯，產生影片，並擷取故事板畫格。所有提供者層級的設定（模型、解析度、長寬比、輸出數量、額外參數）皆集中管理。支援自訂 OpenAI 相容提供者、Agnes 與本地 Dreamina CLI。
節點畫布與標籤群組 可上傳媒體、AI 生成資產、故事板、全景圖與導演工作室場景作為節點。標籤群組可讓您在不增加提示詞長度的情況下對參考內容進行分組。支援無限畫布尺寸，透過幾何索引與快取提升效能。
導演工作室與全景圖 3D 場景編輯器，可放置角色、道具、燈光與攝影機。可將截圖匯出回畫布，產生或匯入全景圖，並記錄攝影機移動。
生產力與診斷 支援從試算表批量匯入提示詞，提供帶預設的提示詞圖書館，支援取消／重做，專案持久化，可搜尋的帶匿名化細節的日誌，以及對 API 金鑰與成本相關操作的明確處理。
跨平台桌面應用 為 macOS（universal dmg）與 Windows（exe）打包。基於 Tauri 2 建構，UI 在輕量級 WebView 中執行，網路呼叫與檔案 I/O 等繁重任務由 Rust 處理。

如何開始

  1. 下載 從 GitHub 的 Releases 頁面下載最新安裝程式（macOS 與 Windows 各有獨立二進位檔）。macOS 使用者可能需要繞過 Gatekeeper，因為該應用尚未經過公证。
  2. 設定提供者 在 設定 → 我的設定 中加入您的 OpenAI 相容 API 金鑰、Claude 凭證，或指向本地 Dreamina CLI 安裝路徑。
  3. 建立專案（或開啟現有專案），然後從左側面板新增節點——上傳媒體、新增 AI 圖像／影片節點，或拖曳一個導演工作室場景。
  4. 產生 可透過點擊節點的產生按鈕，或呼叫 Canvas Agent（聊天視窗）並要求其「建立一個日落背景」等任務。Agent 將建立節點、提交請求，並在結果到達時更新畫布。
  5. 檢查日誌 若有問題，請在左側查看日誌；日誌會自動匿名化，但可展開以供除錯。

項目結構（概覽）

src/                     # TypeScript 前端
  commands/              # 與 Tauri（Rust）命令的橋接
  components/            # 可重用的 UI 元件
  features/canvas/       # 畫布 UI、Agent、導演工作室、節點邏輯
  features/promptLibrary # 提示詞圖書館 UI 與儲存
  stores/                # Zustand 狀態管理
  i18n/                  # 中文／英文翻譯
src‑tauri/               # Rust 後端（Tauri）
  src/commands/          # 系統層級命令、網路代理
  src/ai/                # 提供者適配器（OpenAI、Claude、Dreamina…）
  tauri.conf.json        # Tauri 設定
docs/                    # 使用者與開發者文件

開發快速啟動

# 克隆並安裝相依性
git clone https://github.com/ganbo-gab/open-storyboard-canvas.git
cd open-storyboard-canvas
npm install

# 以開發模式執行 UI
npm run dev            # 熱重載前端
npm run tauri dev      # 使用開發伺服器啟動桌面應用

該倉儲也提供用於 lint、類型檢查、建構與 Rust 側測試（cargo test）的指令碼。

許可與致謝

程式碼以 MIT 許可證 發布。它是 Storyboard‑Copilot（原始作者 henjicc）的分支，並已獲得明確授權繼續開發與開源衍生作品。原始作者與上游倉儲在 NOTICE 檔案中被列名致謝。

誰會使用它？

  • 希望在單一地點管理提示詞、生成資產與場景佈局的 故事板藝術家與動畫師。
  • 為遊戲、行銷或影片製作構建 AI 生成視覺內容的 內容創作者。
  • 希望擴展基於 Tauri 的 AI 桌面應用的 開發者（倉儲包含清晰的 Rust/TS 界限與提供者適配器）。

總結

Open Storyboard Canvas 是一個真正功能豐富的桌面工具，整合了 AI 圖像／影片生成、視覺化節點工作流程與對話式助手。它完全開源、跨平台，專為需要比簡單「提示詞→影像」Web UI 更高控制力的創作者而設計。

相關