InstantDrama Magician（瞬劇魔法師） 是由 YSK Limited 開發的開源 AI 專業短劇桌面工具，主打「從一個想法到完整短劇」的端到端創作流程。
它不是單純的 AI 影片生成器，而是一套強調角色一致性、場景連續性、素材優先的專業工作流工具，支援桌面、瀏覽器遠端控制與完整 CLI。
一、核心定位
From one idea to a finished short drama — on your desk.
Lock a cast. Board every beat. Generate 6 / 10 second clips that keep face, costume, and set. Then FFmpeg exports the film.
主要目標：
- 將故事構思、角色鎖定、分鏡、AI 生成與最終匯出整合在同一工具
- 解決目前 AI 短片工具常見的「角色不一致、場景跳變」問題
- 提供可被腳本與 AI Agent 控制的完整介面（CLI 約 157 個 channel）
二、主要功能亮點
| 模組 | 功能 |
|---|---|
| 故事管理 | 多專案、封面、風格說明、分鏡節拍、.idm.zip 備份 |
| 角色庫 | 全域角色、多角度參考圖、Identity Lock、SoulMD Hub 整合 |
| 戲服 / 場景 / 道具 / 動作庫 | 可重用資產，支援 AI 從靜圖填充 |
| 時間軸 | 線性剪接、6 或 10 秒片段、綁定資產、生成 / 重新生成 |
| 進階預備流程 | Cast Lock → 分鏡靜圖（含連續性）→ 影片生成 |
| MediaGen | 統一素材提取、Prompt 潤飾、靜圖與影片生成管線 |
| 音訊與字幕 | 可選 TTS、燒錄對話、轉場、比例感知匯出 |
| 跨平台 | Electron 桌面 + Web 遠端 + 完整 CLI |
三、技術架構
- 前端：React 18 + TypeScript + Tailwind CSS
- 桌面：Electron + Vite
- 資料：Prisma + SQLite
- 媒體處理：FFmpeg（內建
ffmpeg-static） - AI 整合：預設 Grok Gateway（OpenAI-compatible），支援多種圖片 / 影片提供者
- 國際化：支援 10 種介面語言（含繁體中文）
- 授權：MIT License
架構採清晰分層（Presentation → Application → Domain → Infrastructure），桌面、Web 與 CLI 共用同一套 handler runtime，確保一致性。
四、適用場景
- 短劇 / 微電影快速原型
- 需要嚴格角色與場景一致性的 AI 影片創作
- 希望以腳本或 AI Agent 自動化生成流程的團隊
- 本地或私有部署需求（支援 self-host）
五、專業評價
目前主流 AI 影片工具多偏向「一鍵生成」，但在長序列一致性與可控制性上仍有明顯短板。InstantDrama Magician 選擇走「材料優先 + 連續性鎖定 + 時間軸管理」路線，更接近專業製片工作流。
其完整 CLI 與 Agent 友好設計，也使其適合整合進更大的自動化創作系統。
結語
InstantDrama Magician（瞬劇魔法師）是一套定位清晰、技術完整的開源 AI 短劇工作室。它把「角色鎖定、分鏡連續、素材管理、AI 生成、最終匯出」整合在單一工具中，並同時提供桌面、Web 與 CLI 三種使用方式。
對於希望在本地或可控環境下進行專業短劇創作的開發者與創作者而言，這是一個值得關注的開源專案。
GitHub：https://github.com/yanshekki/instant-drama-magician
Vendor：YSK Limited