基于 SQLAlchemy AsyncSession 的任务存储（MySQL/SQLite 等均可）。

模型供应商配置。 安全提示： - `api_key` / `api_secret` 属敏感信息；如后续接入审计/日志，避免明文输出。

具体模型实例（绑定供应商、类别与参数）。

镜头表（基础信息）。 说明： - 目前未混入 `TimestampMixin`，避免在高频生成/更新流程中引入额外写放大；如需要审计可再补。 - 细节放在 `ShotDetail` 以保持主表字段稳定。

镜头细节（1:1）。 设计点： - 与 `Shot` 共享主键，确保一条镜头最多一份细节，且删除镜头时细节级联删除。 - `mood_tags` 用 JSON 存 list[str]，与前端 mock 对齐。 应用层保证： - `scene_id` 所指场

章节表。 约束： - `project_id + index` 唯一，保证一个项目内集数序号不重复。

项目表。 说明： - `stats` 使用 JSON 存储聚合统计，便于快速渲染与渐进扩展；如需要强一致统计可后续改为物化/触发器维护。

通用的生成任务关联表。 通过 resource_type + relation_type + relation_entity_id 表示与上层业务资源的关联： - resource_type：生成资源类型，如 image / video / text - relation_

提示词模板表。 应用层保证： - 同一 category 下至多一条 is_default=True，写入/更新时由接口层维护。 - is_system=True 的记录由初始化脚本写入，接口层拒绝删除和修改。

模型管理全局设置（单例表）。 说明： - 通过“单表单行”实现全局默认值；应用层通常只读/更新 id=1。 - 外键使用 `SET NULL`，避免删除模型时导致设置表不可更新。

任务管理器：对上层（路由/业务）提供统一入口。 init params: - store: TaskStore, 任务存储 特性： - store 可插拔：内存 or MySQL（通过 SQLAlchemy） - delivery strategy 可插拔

执行生成任务时需要的供应商配置。

最小 Studio DB 替身：仅覆盖项目/章节/镜头接口测试所需行为。

封装 studio 通用实体与图片的协调调用。

最小 DB 替身：仅覆盖镜头子资源接口测试所需行为。

镜头帧提示词生成结果：单个 prompt 字符串。

按分镜聚合返回的关联资产条目（角色/道具/场景/服装）。

素材文件表。

供应商/模型图片能力约束。

任务状态枚举。

给 async 业务任务的 Celery 执行桥。 适用于图片生成、视频生成、分镜帧提示词这类仍以内置 async service 为主的任务。 它只负责： - 每个任务执行前重建 async DB runtime； - 从 GenerationTask.paylo

资产图片生成的基础真值。

图片生成输入：文本 prompt 为必填，其余参数透传给供应商。

准备页命令执行后的统一响应。

用于导入 Studio 的提取结果草稿（name-based）。

任务在应用层的统一表示（与存储实现解耦）。

仅用于 TaskManager.create，避免为异步任务额外声明无意义 task 类。

最小 DB 替身：仅覆盖 Provider 路由测试所需行为。

动作拍点的轻量阶段推断结果。

根据原文人物描述分析缺失信息，并输出优化后的可生成画像描述。

OpenAI 图片生成 HTTP；无状态，可单测替换。

创建供应商时的请求体，允许填写敏感字段。

场景表。

镜头提取候选类型。

镜头对话行。 设计点： - 前端 mock 里 `dialog` 为数组，这里拆表以支持排序、检索与后续对齐字幕/配音等能力。 - `shot_detail_id + index` 唯一，保证行号稳定。 应用层保证： - `speaker_characte

镜头提取候选项。 用于记录一条镜头经“信息提取”后得到的候选资产及其确认状态： - pending：待处理 - linked：已关联到真实实体 - ignored：已明确忽略

镜头分镜帧图片（首帧/尾帧/关键帧）。每镜头每类型一条记录，通过 file_id 关联 files 表。 应用层保证： - 同一 shot_detail_id + frame_type 至多一条记录（表唯一约束）。

镜头草稿：不含 shot_id，由导入 API 生成；引用实体用 name。

供应商/模型能力约束。

无分页时的统一响应结构。

角色表（归属项目）。 组成约定： - 角色由：Actor（演员） + Costume（服装） + Props（道具）组成。 - 最终在分镜中引用角色：`ShotCharacterLink`（shot_character_links）。 应用层保证： - `

用于满足 TaskManager.create 的最小 Task 实现。

创建模型请求体。

给同步 worker 使用的任务存储。

视频生成的基础真值。

视频生成的动态上下文。

最小 DB 替身：仅覆盖 prompts 路由测试所需行为。

一致性检查（角色混淆）：输入原文，检测同一角色身份/行为混淆并给出修改建议。

OpenAI 视频：POST /videos 与 GET /videos/{id}。

道具表。角色道具绑定见 CharacterPropLink。

剧本自动分镜：输入完整剧本文本，输出分镜列表。

镜头引用角色（多对多）。 应用层保证： - 所引用角色应与镜头所属项目一致（角色表本身归属项目，写入时校验可避免跨项目引用）。

文件基础信息（供调用方在路由层自行封装为 Pydantic schema）。

Studio 资产草稿（Scene/Prop/Costume）。 导入 API 未传 id 时由服务端生成；分镜详情回填时可带 scene_id/prop_id/costume_id。

任务中心列表视图。

轮询接口的轻量视图（性能友好）。

火山视频任务 HTTP。

演员表（与角色区分）。 说明： - 使用 ActorImage（旧） 的字段集合，作为“演员形象/立绘资产”的主表。 - 归属由 ProjectActorLink（project/chapter/shot 维度）表达。

根据原文服装/造型描述分析缺失信息，并输出优化后的可生成服装描述。

项目级信息提取（最终输出）：输入分镜结果，产出全局实体表 + 逐镜关联。

跨镜合并 + 基础画像生成：输入全部分镜提取结果+历史实体库，输出合并后的库。

分镜帧 guidance 的保留/压缩决策结果。

真正提交给模型的最终载荷。

当前默认图片模型对应的关键帧规格选项。

图片生成统一结果。

单张图片结果。

更新或保存模型全局设置请求体。

更新模型请求体（全部可选）。