Agent Skills
返回列表
💻

ToonFlow 分镜回写

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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