端到端工作流
故事管理、資產庫、線性時間軸、進階預備與 FFmpeg 匯出，全部在同一桌面應用程式完成。
端到端由故事到成片完整管線
動作庫多格動作指示圖
媒體生成統一精修出圖／出片
FFmpeg匯出、轉場、字幕
由構思到成片的專業管線
故事、資產、時間軸到匯出一氣呵成；下方流程與能力矩陣助您快速掌握全貌。
- 故事AI 風格說明、劇情節拍、選角綁定
- 資產庫人物／服裝／場景／道具／動作
- 時間軸編排片段、撰寫節拍腳本、吸附對齊
- 生成分鏡靜圖 → 出片佇列
- 匯出FFmpeg、語音合成、字幕、轉場
動作指導
多格指示圖庫可掛入選角、劇情段落與時間軸片段，注入節奏與鏡頭意圖。
統一媒體生成
庫頁與時間軸精修共用：材料 → 多圖視覺潤飾 → 出圖／出片。
遠端控制與命令列
瀏覽器可操作同一份資料；約 157 個指令通道供腳本、持續整合與智能代理調用。
| 領域 | 您可以做什麼 |
|---|---|
| 故事 | 多故事管理、封面 AI、風格聖經、劇情節拍、選角綁定、.idm.zip 備份 |
| 人物 | 全域角色庫、soul.md／SoulMD Hub、多角度角色表、身份鎖定、視覺 AI 填充 |
| 服裝 | 服裝庫、換裝、試穿建議；試穿結果可同時寫入角色與服裝圖庫 |
| 場景 | 場景文案、底板／造型／氛圍、場景圖庫、視覺 AI 填充 |
| 道具 | 描述、主提示詞、底板變體、時間軸片段綁定 |
| 動作 | 多格指示圖（2–6 格）、選角參考、出片時注入節奏意圖 |
| 媒體生成 | 統一材料 → 多圖視覺潤飾 → 出圖／出片 |
| 圖庫介面 | 共用圖庫面板：預覽、封面、身份鎖定多選、介紹影片 |
| 時間軸 | 線性編排、吸附／緊密排列、6 或 10 秒片段、對白與鏡頭標記 |
| 進階預備 | 選角鎖定 → 分鏡靜圖 → 出片；單格精修 |
| 音訊／字幕 | 可選語音合成混音、燒錄字幕、轉場淡化、背景音樂閃避、比例感知匯出 |
| 設定 | 語言模型／影像／影片供應商、FFmpeg、網頁伺服器、自動更新 |
| 命令列／遠控 | 約 157 個指令通道；桌面內建網頁服務或獨立伺服器模式 |
| 多語／更新 | 10 種介面語言；打包版經 GitHub Releases 自動更新 |
創作資產庫
全域可重用資產 — 建立一次，多故事共用。
故事
- 建立／編輯／刪除多個獨立短劇專案；狀態、封面、排序（如最近更新）
- 封面：放大／重新生成／另存；匯入／匯出故事級
.idm.zip備份 - 基本資料：封面、AI 快速建立（風格說明／節拍）、標題、狀態、藝術風格、風格聖經
- 選角：連結角色、場景、道具、動作（搜尋與已加入／未加入篩選）
- 劇情節拍：每段可多選角色／場景／道具／動作，並撰寫節拍腳本
人物
- 全域角色庫，故事可共用選角；支援搜尋、性別、藝術風格、有無圖片、Soul、語言篩選
- 個人資料：名稱、描述、年齡、性別、語言、聲音；AI 可依構思／草稿／soul 填充，或只憑上載靜圖（視覺理解）填充
- 參考圖：多角度角色表（正面／¾ 側／特寫等）、體型／底圖／服裝管線、外部參考、鎖定身份、專業參考生成、介紹影片
- 服裝分頁綁定服裝；整合 SoulMD Hub 索引與 soul.md 匯入
服裝
- 全域服裝庫，可連結零至多個角色
- 只憑參考圖 AI 填充（構思可留空）；多圖圖庫、封面、介紹影片
- 縮圖支援身份鎖定多選；以角色參考圖試穿／換裝
- 接受試穿草稿後，靜圖會同時寫入角色圖庫與服裝多圖庫
場景
- 場景描述與腳本欄位；底板、造型、氛圍
- 場景圖庫與變體生成；依選中或封面靜圖作視覺 AI 填充
道具
- 道具名稱、描述、主提示詞、底板變體
- 供時間軸片段綁定；依參考靜圖作視覺 AI 填充
動作指導
- 全域動作庫：可重用的肢體／走位／場面調度指示（先建庫，再掛入故事）
- 多格指示圖：2 至 6 格（橫向條或 2×2／2×3）；第 1 格為第一動作，最後一格為結尾動作
- 藝術風格、外部參考圖、由角色／服裝／場景／道具引入選角參考
- 視覺 AI 填充；多圖累積（追加指示板、排序、封面）
- 可掛入故事選角、劇情段落與時間軸片段；出片時注入節奏／意圖／鏡頭備註，並可作圖生影片參考
媒體生成殼
- 統一流程：材料 → 多圖視覺潤飾 → 出圖／出片
- 指令面：
mediaGen:extract·polish·generateImage - 庫頁與時間軸精修（時間軸靜圖／時間軸片段）共用同一殼層
圖庫介面
- 共用面板：大圖預覽、放大／另存／設封面／移除／介紹影片
- 縮圖列：預覽模式與身份鎖定多選模式
- 圖庫標籤與相關錯誤訊息已多語本地化
時間軸與匯出
主製作台：排片、進階預備、音訊字幕與 FFmpeg 成片。
時間軸（主製作台）
- 選擇當前故事；播放／復原／重做
- 批次生成；匯出成片；匯出紀錄
- 總時長、就緒數、影片模式；AI 片段僅 6 秒或 10 秒
- 時間軸縮放、吸附、對齊網格、緊密排列片段
- 片段編輯：綁定角色／場景／道具／動作、時長、節拍腳本（如情緒／氛圍／對白標記）
- 單一片段：生成此片段／重新生成／接續影片；可取消、只重試失敗片段
- 匯出可選：語音合成、燒錄字幕、轉場淡化、音量閃避、畫面比例
進階預備
- 由時間軸的「進階」開啟
- 選角鎖定 — 鎖定出場人物造型
- 分鏡靜圖 — 依節拍批量關鍵靜幀；片尾幀連續、強制上一段關鍵幀、多參考圖潤飾；批量補齊缺失；狀態標籤（需更新／需先補上一段／就緒）
- 影片 — 靜圖就緒後入佇列出片（可略過已有影片）
- 單格精修 — 精修靜圖或精修出片，開啟媒體生成殼
音訊／字幕
- 可選語音合成混音、燒錄對白字幕
- 轉場淡化、背景音樂閃避、比例感知匯出
工具與設定
活動日誌、供應商設定、多語系與自動更新。
活動日誌
- 本機活動紀錄（如
activity.jsonl）：生成、匯出、更新、支援報告等 - 協助排查介面與管線問題
設定
- 語言模型：OpenAI 相容；預設 Grok 閘道（如
http://127.0.0.1:3847）；亦可 OpenAI／自訂／Kimi 等 - 影像：可跟隨語言模型，或獨立設定網址／金鑰／模型（含 Seedream 等）
- 影片：自動／HTTP／測試模式；Seedance、Grok 影片介面；6／10 秒；輪詢與逾時
- 診斷：測試對話、列出模型、連線狀態
- FFmpeg：硬性依賴；可指定
FFMPEG_PATH - 網頁伺服器：瀏覽器遠端控制、連接埠、權杖、僅本機／區網
- 自動更新：檢查／下載／重新啟動（打包版）
- 支援報告：匯出診斷 JSON（介面金鑰已遮罩）
- 法律：免責與可接受使用政策；版本變更需再次同意
多語系與自動更新
- 介面：繁體中文（香港）、簡體中文、英語、西班牙語、印地語、阿拉伯語（由右至左）、巴西葡語、法語、日語、俄語
- 打包版 electron-updater：啟動時檢查 GitHub Releases；橫幅與通知；設定內檢查／下載／重新啟動
誠實邊界：成片觀感取決於您選用的模型與提示詞；本工具負責工作流、連貫性與匯出管線，不保證「影院級」自動出片。商店簽章／公證需自備憑證。
命令列與網頁遠控
無介面腳本、智能代理整合，或用瀏覽器操作同一份專案資料。
命令列 instant-drama
- 全域安裝：
npm i -g instant-drama-magician→ 路徑上的instant-drama - 本機模式：操作
IDM_DATA_DIR（與桌面同一應用程式資料根目錄） - 遠端模式：
POST {url}/api/invoke並附帶授權權杖 - 約 157 個指令通道，對應桌面程序通訊；可用於腳本、持續整合、OpenClaw／Hermes 智能代理
- 範疇包括：故事、人物、服裝、媒體生成、時間軸、影片預備、動作、生成、伺服器、工具結構等
instant-drama update／釘選版本；doctor亦會報告 npm 更新狀態
網頁遠控與自架
- 方式甲：桌面應用程式設定 → 網頁伺服器 → 啟用、複製網址與權杖 → 瀏覽器與桌面共用使用者資料
- 方式乙：獨立
instant-drama server（網頁建置、資料目錄、權杖、連接埠等）
介面截圖與安裝
桌面介面一覽，以及推薦安裝與工作流。
01
故事管理
多專案列表：封面、狀態、角色／場景／道具／動作／片段數量、搜尋篩選、匯入／匯出備份。
02
故事編輯（基本資料）
封面、AI 風格說明／節拍、標題狀態、藝術風格、風格聖經、外部參考與身份鎖定。
03
人物庫
全域角色、多圖角色表、篩選；側欄顯示 Grok 命令列連線狀態。
04
人物參考圖
身份／體型／服裝管線、角色聖經、鎖定身份、介紹影片。
05
時間軸製作台
片段編排、吸附、生成／匯出、進階入口。
06
進階預備
選角鎖定 → 分鏡靜圖（連貫）→ 影片佇列。
推薦流程
- 設定 → 介面金鑰 → 測試對話
- 故事 → 新建／AI 風格說明 + 節拍
- 人物 → 多角度角色表 → 鎖定身份（或靜圖視覺填充）
- 場景／道具／服裝／動作補齊資產
- 故事選角 → 連結角色、場景、道具、動作
- 劇情段落 → 每段綁定資產
- 時間軸 → 排片段、寫節拍腳本
- 進階預備 → 靜圖（連貫）→ 出片
- 匯出成片（可選語音合成／字幕）
npm install -g instant-drama-magician
instant-drama doctor --json
instant-drama --local stories list --json
instant-drama channels list --json # ~157
# 桌面開發
npm install && npx prisma db push && npm run dev