ChenShuo2004/cs-board

📽️ cs‑board – 本地 AI 白板影片製作工作台

一言概括

將中文文案、參考音訊與可選的風格/角色素材，一鍵轉換成配音、插畫、手繪筆跡、字幕與音畫同步的 MP4 白板動畫。

---

🎯 核心定位

• 本地運行 – 所有音訊、模型呼叫與生成的素材皆保存於本機，保障隱私安全。
• 端到端流程 – 從音色克隆 → 文本拆解 → 插畫生成 → 手繪動畫 → 字幕/合成 → 導出 MP4，全程自動化。
• 可選雲端服務 – 可透過 MiniMax H3、OpenLux 等相容 OpenAI 協定的 API 呼叫文字與圖片模型，亦可自行部署 IndexTTS（Gradio/FastAPI）進行本地音色克隆。
• 區域網路協作 – 多台電腦共享同一製作佇列，團隊可在同一網路下協同作業。

---

🛠️ 主要功能

功能	說明
本地音色克隆	接入自建的 IndexTTS 服務，參考音訊不離開本機，實現人物／品牌專屬配音。
12 種視覺模板	從極簡白板到賽博霓虹、國風卡通、3D 黏土等，每種模板皆附帶配色、線條風格與構圖建議。
自訂人物／畫風	最多 5 位角色，每人 1–3 張參考圖，或上傳 1 張整體風格圖，系統於全片維持統一風格。
動態資訊圖	根據旁白的真實時間軸生成逐句出現的知識卡片，避免畫面搶跑。
中文重點詞疊加	本地渲染 4–10 字的中文關鍵短語，避開常見的中文亂碼問題，可隨時關閉。
可控節奏	開關字幕、調節筆觸粗細、選擇 4 檔繪製量、每張圖容納 1–4 個分鏡，靈活控制影片節奏。
任務複用／恢復	配音、分鏡、圖片、影片段落皆有檢查點，修改本地渲染設定時無需重新呼叫模型。
區域網路協作	同一區域網路內的機器可查看共享佇列、進度與歷史記錄，個人偏好保存於各自瀏覽器。

---

🚀 快速上手（5 分鐘啟動）

1. 準備環境 – Windows 10/11、macOS 15+、Python 3.11+、Node 22.13+、FFmpeg/FFprobe 在 PATH 中。需可存取的 IndexTTS 2.5 服務與 OpenLux API Key（文字＋圖片模型權限）。
2. 安裝（以 macOS 為例）

   brew install python@3.13 node ffmpeg
   python3.13 scripts/prepare_env.py
   .venv/bin/python -m pip install -r webapp/requirements.txt
   (cd web && npm ci)
   

3. 啟動

   ./start-webapp.sh   # Windows 使用 start-webapp.ps1
   

   瀏覽器自動開啟 http://127.0.0.1:13000/。
4. 設定 API – 在右上角 API 設定 填入 OpenLux API Key、文字模型（預設 gpt-5）、圖片模型（預設 gpt-image-2）以及 IndexTTS 位址。點 Test 確認連線。
5. 建立影片 – 上傳 10–30 秒的參考音訊、貼上中文文案、選擇製作模式（標準／自訂／動態資訊圖）與視覺模板，點擊 開始 即可。

---

📚 適用情境

模式	推薦使用情境
標準製作	知識講解、故事口播、課程宣傳 – 自動拆分分鏡、生成插畫並繪製白板動畫。
自訂參考	品牌影片、固定 IP、系列內容 – 上傳風格圖與角色參考，實現統一人物與畫風。
動態資訊圖	商業分析、觀點表達、課程內容 – 旁白同步出現的動態卡片，幫助觀眾「邊聽邊懂」。

---

📁 專案結構概覽

assets/          # 畫筆、模板素材
docs/            # 動態資訊圖工作流程文件
examples/        # 示範 GIF/影片
scripts/         # 渲染、時間軸、維護腳本
tests/           # 單元／整合測試
video_renderer/  # Remotion（React-based）影片渲染器
web/             # React 前端
webapp/          # FastAPI 後端
start‑webapp.*   # 一鍵啟動腳本（Windows/Unix）

---

🧪 開發／測試指南

• 前端：(cd web && npm test)
• 後端任務佇列與斷點恢復：python -m unittest discover -s tests -v
• Remotion 類型檢查：(cd video_renderer && npm run build)

---

🤝 貢獻與授權

• 貢獻 – 提交 Issue 或 Pull Request，涉及渲染邏輯的變更請提供真實素材下的時序、遮罩與成片驗證。
• 授權 – MIT License。

---

📢 贊助商

MiniMax H3 影片生成 API（秘塔科技）提供低價 768p/2K 影片生成，相容 OpenAI 協定並支援 ComfyUI，使用專屬連結可領取額度。

---

簡而言之：cs‑board 將「文字＋聲音」轉為「手繪白板動畫」的全鏈路工具，適合個人創作者與小團隊在本地快速產出高品質中文影片，且支援自訂風格與區域網路協作。