ToonFlow 分镜回写
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cc65e9bc/toonflow-backfill-storyboard。
技能介绍
问题在哪
在 ToonFlow 里做动画/短剧生产时,分镜数据应落在主库表 o_storyboard。有时你会看到 o_storyboard 为 0 行,但 o_agentWorkData 里 key='productionAgent' 的 storyboardTable 已经是完整 Markdown 分镜表。此时原生流程里的分镜图生成、视频合成读不到分镜,进度核查也会误判。
同一 projectId 下还可能有多个剧本(o_script.id = episodesId),需要按集把分镜接回主库,而不是指望 UI 自动同步。
技能怎么做
技能围绕本机已验证的路径:主库 %APPDATA%\ToonFlow\data\db2.sqlite(WAL,只读用 mode=ro),分镜权威源是 productionAgent JSON 中的 storyboardTable。
核心步骤包括:
- 发现 ToonFlow 监听端口(PowerShell 按进程 PID 查 Listen,端口常变,勿硬编码)
- 从
o_setting取tokenKey,自签 HS256 JWT - 查
o_script确认scriptId/projectId,回写前 备份db2.sqlite - 按
## 场N切场,解析表格列(画面描述、时长、景别、运镜、台词、音效)及「引用资产ID」 - 构造
prompt/videoDesc(景别、运镜后缀格式:全景景别,缓摇运镜,避免景,重复字 bug) - 调用
POST /api/production/storyboard/batchAddStoryboardInfo,由接口处理o_videoTrack、trackId、o_assets2Storyboard
历史人物/莽途类项目可在 prompt 末尾加 【严格约束】(人物一致性、西汉时代一致性等),与 SKILL 中红线一致。
边界与注意
优先走 HTTP API,避免直接写库引发锁问题。每次执行都要重新发现端口与密钥上下文。落库后应核对 o_storyboard 行数、trackId 非空、资产关联数量,并排查错误 prompt 模式。后续分镜图批量生成依赖 batchGenerateImage 及 image 厂商真实实现。
使用场景
- 核查进度时发现主库 o_storyboard 为空,但 productionAgent 的 storyboardTable 里已有完整分镜表,需要接回主库再走生成流程
- 同一 ToonFlow 项目下多集剧本各有 episodesId,需要把某一集的 Markdown 分镜表批量写入对应 scriptId
- 准备调用分镜图生成或视频合成 API,但客户端读不到分镜行,需先通过 batchAddStoryboardInfo 落库并建好 track 与资产关联
- 历史人物或西汉背景剧目回写分镜时,要在 prompt 与 videoDesc 末尾追加人物一致性与时代约束,避免后续出图穿帮
适合人员
- 用 ToonFlow 做 AI 短剧/动画的制作者,主库分镜表意外为空却要在本机恢复整条生产流水线
- 负责 ToonFlow 数据排障的工程师,熟悉 db2.sqlite、JWT 与 production API,需要可重复的 storyboardTable→o_storyboard 流程
- 多集连载项目的编剧/制片,需要按集把 agent 工作台里的分镜 Markdown 同步进主库再批量出分镜图
- 古装或历史人物剧的内容负责人,回写分镜时必须把一致性与反跨时代约束写进每条 prompt