Initial AI manga platform

OPERATION_GUIDE.md

@@ -0,0 +1,826 @@
+# AI 漫剧平台小白使用手册
+
+本文给第一次使用系统的人看，目标是讲清楚两件事：
+
+- 用户端怎么从一个想法或一段小说，生成一集漫剧成品。
+- 后台运营怎么给用户加额度、看资源、查问题、管 AI 接入。
+
+当前建议先用 mock 或低成本配置熟悉流程。不要在不理解成本和任务状态时直接打开“生产任务优先使用 OpenAI”。
+
+## 1. 先理解几个核心概念
+
+### 项目
+
+项目是一部漫剧的制作单元。一个项目可以是：
+
+- AI 原创小说：你给题材、人设、卖点，AI 先写小说内容，再改成漫剧。
+- 上传小说：你粘贴或上传已有小说，系统解析章节，再改成漫剧。
+
+项目里会逐步产生：小说源、故事圣经、角色、分集、脚本、分镜、图片、音频、字幕、视频。
+
+### 故事圣经
+
+故事圣经不是最终小说，也不是一集脚本。它是整部作品的“规则说明书”。
+
+它主要回答：
+
+- 这个故事是什么类型，例如都市逆袭、甜宠、悬疑。
+- 故事的核心冲突是什么。
+- 主角要达成什么目标。
+- 世界观和风格是什么。
+- 什么内容不能乱写，例如不能突然科幻、不能低俗、不能侵权。
+- 结尾方向、爽点、反转和长线伏笔是什么。
+
+为什么需要它：后面的角色、分集、脚本、分镜都会参考故事圣经。没有故事圣经，AI 容易前后风格不一致。
+
+故事圣经一般由 AI 先生成，人再检查。确认后，后续流程才会继续。
+
+### 角色圣经
+
+角色圣经是角色库，也就是每个重要人物的设定卡。
+
+它会记录：
+
+- 姓名
+- 角色类型：主角、反派、配角、次要角色
+- 性格
+- 背景
+- 目标和动机
+- 与其他角色的关系
+- 外貌特征
+- 服装规则
+- 说话风格
+- 锚点图
+
+角色怎么定：
+
+- AI 原创项目会结合你填写的主角设定、题材、卖点和故事圣经自动抽取。
+- 上传小说项目会结合小说章节和故事圣经自动抽取。
+- 运营或用户可以在确认前改名、改关系、补外貌、删除不需要的角色，也可以手动新增角色。
+
+确认角色后，角色会被锁定。后续分镜和图片生成会尽量遵守这些角色设定。
+
+### 全局角色资产库
+
+全局角色资产库是后台给运营用的“演员库”。
+
+它和项目里的角色不一样：
+
+- 全局角色：可跨项目复用的固定演员，例如“都市冷感女主模板”“霸总男主模板”“绿茶反派模板”。
+- 项目角色：某个项目里的具体人物，例如这一部剧里叫“林晚”、身份是设计师、剧情目标是夺回项目。
+
+正式运营时，建议先沉淀一批全局角色：
+
+- 固定脸：锚点图、脸型、发型、身形。
+- 服装规则：日常装、职场装、礼服、古装、校服等变体。
+- 声音：每个角色自己的 voice id、模型、声线、语速和情绪风格。
+- 表演风格：眼神、表情、动作习惯。
+- 授权范围：内部测试、公司自有、授权、限制使用。
+
+这样不同项目可以复用同一批主角、配角、反派，只在项目里改名字、身份、关系和服装变体，不需要每次重新设计。
+
+后台路径：
+
+```text
+后台 -> 角色资产库
+```
+
+项目角色绑定路径：
+
+```text
+后台 -> 角色资源 -> 全局角色 -> 选择角色资产 -> 绑定
+```
+
+绑定后，如果项目角色还没有锚点图、声音或默认服装，系统会自动带入全局角色资产里的默认配置。项目角色已有的差异化设置不会被强行覆盖。
+
+### 锚点图
+
+锚点图是角色的一张参考图，用来稳定角色外观。
+
+简单理解：以后生成这个角色的分镜图时，系统会尽量让人物长得像这张图。
+
+内部测试时可以先用 mock 图熟悉流程；真实上线时再接真实图片 Provider。
+
+### 长篇记忆
+
+长篇记忆用于保证多集连续性。
+
+它会记录：
+
+- 已发生的重要事件
+- 角色关系变化
+- 未回收的伏笔
+- 不能打破的设定
+- 前几集结尾留下的悬念
+
+如果做 1 集短测试，长篇记忆看起来存在感不强；如果做 20 集、100 集，它非常关键。
+
+### 分集计划
+
+分集计划就是把故事拆成第 1 集、第 2 集、第 3 集。
+
+每集会有：
+
+- 标题
+- 剧情摘要
+- 开头钩子
+- 中段冲突
+- 结尾悬念
+- 关联章节
+- 预计时长
+
+你说“一章一个集数”，在系统里可以理解为：一个章节内容对应一个 episode，也就是一集。
+
+### 单集脚本
+
+单集脚本是一集的文字剧本。
+
+它主要包含：
+
+- 旁白
+- 关键对白
+- 剧情推进
+- 情绪节奏
+
+脚本确认后，才会进入分镜。
+
+### 分镜
+
+分镜是把一集拆成一个个镜头。
+
+当前默认每集约 10 个镜头。每个镜头会有：
+
+- 镜头序号
+- 场景名，例如“开局压迫”“主角反击”“结尾钩子”
+- 地点描述，例如“会议室中心”“走廊阴影”
+- 出场角色
+- 画面描述
+- 动作描述
+- 对白或旁白
+- 镜头运动
+- 特效类型
+- 时长
+- 图片生成 Prompt
+- 负面 Prompt
+
+场景是不是 AI 生成：是。当前场景不是单独的“场景库”，而是在分集、脚本、分镜里由 AI 自动生成场景名、地点、画面和动作。确认前可以编辑分镜字段，也可以重新生成 Prompt。
+
+### 分镜图
+
+分镜图是每个镜头对应的一张画面。
+
+系统会根据分镜 Prompt、角色设定和风格生成图片。当前一集默认约 10 张正式分镜图。
+
+### 音频、字幕和视频
+
+音频是 TTS 声音，字幕是 SRT 字幕，视频是最终 MP4。
+
+当前推荐上线链路是：
+
+分镜图 + TTS 音频 + SRT 字幕 + FFmpeg 本地合成 MP4
+
+这样成本更可控。Sora 视频可以作为高级能力，不建议默认打开。
+
+现在音频默认走“多角色音频”：
+
+- 旁白使用旁白声线。
+- 角色对白优先使用角色资产库里的 `voice_id`。
+- 如果项目角色绑定了全局角色，会继承全局角色的声音配置。
+- 如果角色没有单独声音，才使用默认 TTS 声音。
+- 系统会按分镜顺序把旁白和对白拆成多个片段，逐段合成。
+- 每个片段会带上起始秒数、结束秒数和目标时长，再按分镜时间轴铺成一条整集音轨。
+- 如果某句真实 TTS 比分配时间更长，接口会返回时间轴告警，运营需要缩短台词、增加镜头时长或调整语速。
+
+现在字幕默认走“对白级字幕”：
+
+- 一句旁白或一句角色台词对应一条 SRT 字幕。
+- 字幕时间和多角色音频使用同一套分镜时间轴。
+- 如果需要旧版“每个分镜一条字幕”，技术接口可以传 `subtitle_mode: "shot"`。
+
+生成完成后，在用户端“图片、音频和视频”区域可以看“音频字幕时间轴”：
+
+- 每一行是一句旁白或一句角色对白。
+- 可以看到镜头号、说话人、起止秒、目标时长、实际 TTS 时长和声音 ID。
+- 如果某句 TTS 超出分配时长，会出现红色提示。
+- 这时优先处理台词：缩短句子、拆成两个镜头、增加镜头时长，或换更快的声线。
+- 面板里的“试听音频”是整集音频试听；“下载字幕”可以下载 SRT 文件。
+- 每句后面可以点“重试此句”，只重合成这一句 TTS，再重新铺成整集音频。
+- 单句重试可以换声音 ID、语速和语气说明。
+- 老版本生成的音频如果缺少逐句片段文件，页面会提示先“重生成音频”；真实 TTS 模式下这一步会重新产生费用。
+
+成本预估说明：
+
+- 页面会显示本集大约多少句、多少个声音、多少 TTS 字符。
+- 这不是最终账单金额。
+- 真实金额以后台 Provider 日志和 AI 平台账单为准。
+
+旧的一条旁白音频模式仍保留，技术接口可以传：
+
+```json
+{
+  "dialogue_mode": "narration"
+}
+```
+
+正式测试真实 TTS 前要注意：多角色音频会按片段多次调用 TTS，成本高于一条旁白音频。第一次建议只测 1 集、少量分镜。
+
+## 2. 用户端从 0 到 1 操作流程
+
+用户端地址：
+
+```text
+http://152.53.37.118:5174
+```
+
+本机地址：
+
+```text
+http://127.0.0.1:5174
+```
+
+### 2.1 登录或注册
+
+打开用户端后，先登录或注册。
+
+如果是内部测试用户，需要后台先给这个用户加额度。当前用户端不展示真实支付入口，额度由后台人工增加。
+
+### 2.2 新建项目
+
+进入“新建”页面。
+
+主要字段：
+
+- 标题：项目名，方便后台和自己识别。
+- 输入方式：AI 原创小说或上传小说。
+- 类型：例如都市逆袭、甜宠、悬疑。
+- 风格：例如韩漫风。
+- 目标集数：想生成几集。
+- 单集时长：一集预计多长。
+
+新手建议：
+
+- 第一次测试选 1 集。
+- 单集时长填 40-60 秒。
+- 风格先保持默认。
+
+### 2.3 AI 原创小说流程
+
+如果输入方式选择“AI 原创小说”，继续填写原创信息。
+
+常见字段：
+
+- 目标受众：给谁看。
+- 主角姓名：可以填，也可以留空让 AI 起名。
+- 主角设定：身份、性格、困境。
+- 故事氛围：高能反击、甜虐、悬疑等。
+- 卖点：强钩子、快节奏、反转爽点。
+- 禁忌规则：不希望出现的内容。
+
+建议写法：
+
+```text
+主角设定：女主是被豪门退婚的设计师，表面温和，实际非常冷静，有隐藏实力。
+卖点：退婚现场反击、身份反转、前任后悔、女主独立成长。
+禁忌规则：不要血腥，不要低俗，不要真实品牌。
+```
+
+然后按页面顺序生成：
+
+1. 创意或小说内容
+2. 故事圣经
+3. 角色
+4. 长篇记忆
+5. 分集计划
+6. 单集脚本
+7. 分镜
+8. 分镜图
+9. 音频
+10. 字幕
+11. 视频
+
+每一步生成后，都要先看结果是否合理，再确认进入下一步。
+
+### 2.4 上传小说流程
+
+如果输入方式选择“上传小说”，流程是：
+
+1. 新建项目时选择上传小说。
+2. 粘贴小说文本，或后续用文件上传入口。
+3. 填标题、作者名。
+4. 做版权确认。
+5. 解析小说章节。
+6. 生成故事圣经。
+7. 抽取角色。
+8. 后续与 AI 原创流程相同。
+
+版权确认是什么意思：确认你有权使用这段文本做 AI 改编。没有确认版权，系统不应该继续改编。
+
+### 2.5 故事圣经怎么检查
+
+看到故事圣经后，重点检查：
+
+- 类型对不对。
+- 主角目标是否清楚。
+- 核心冲突是否够强。
+- 风格是否符合你要的漫剧方向。
+- 有没有明显跑题。
+- 禁忌规则有没有写进去。
+
+可以接受时再确认。
+
+如果不满意：
+
+- 用户端当前以生成和确认为主，细改能力相对轻。
+- 后台或 API 可做更细的编辑。
+- 简单测试可以重新建项目或回到前一步调整输入。
+
+### 2.6 角色怎么检查
+
+角色生成后，重点看：
+
+- 主角是否正确。
+- 反派是否明确。
+- 配角是否过多。
+- 人物关系是否合理。
+- 外貌和服装是否适合后续图片生成。
+- 是否有不需要的人物。
+
+确认角色前，尽量把主角、反派、关键配角定清楚。
+
+角色锚点图建议：
+
+- 主角必须有锚点图。
+- 反派和重要配角最好也有。
+- 次要角色可以后面再补。
+
+### 2.7 分集计划怎么检查
+
+每集都要看：
+
+- 开头钩子是否吸引人。
+- 中段冲突是否推进。
+- 结尾悬念是否让人想看下一集。
+- 每集信息量是否太少或太多。
+- 是否符合“一章一个集数”的目标。
+
+确认后再生成脚本。
+
+### 2.8 单集脚本怎么检查
+
+看三个点：
+
+- 旁白是否顺。
+- 对白是否符合角色。
+- 剧情是否能在目标时长内讲清楚。
+
+如果一集 40-60 秒，脚本不要太长。旁白越长，TTS 音频越长，视频时长也会变长。
+
+### 2.9 分镜怎么检查
+
+分镜是最容易影响成片质量的地方。
+
+重点看：
+
+- 是否有 8-12 个镜头。
+- 每个镜头是否有清楚画面。
+- 出场角色是否合理。
+- 画面描述是否适合生成图片。
+- 镜头顺序是否能讲清故事。
+- 结尾镜头是否有悬念。
+
+场景字段由 AI 生成，包括场景名、地点、画面、动作、镜头运动。确认前可以修改，确认后再生成分镜图。
+
+### 2.10 生成分镜图
+
+分镜确认后，生成分镜图。
+
+如果是真实图片 Provider：
+
+- 每张图都会产生费用。
+- 当前一集约 10 张分镜图。
+- 建议第一次真实测试只开一集，并设置成本上限。
+
+如果是 mock：
+
+- 不消耗真实 AI 额度。
+- 适合熟悉流程和验收页面。
+
+### 2.11 生成音频、字幕和视频
+
+顺序建议：
+
+1. 点击“多角色音频”，生成角色音频和对白级字幕。
+2. 检查音频、字幕素材是否都已出现。
+3. 渲染视频。
+4. 去成品页预览或下载。
+
+视频渲染前需要额度可用。当前内部测试由后台人工加余额。
+
+### 2.12 成品下载和审核
+
+视频生成后，到“成品”页面看预览和下载。
+
+如果要做公开案例，需要提交公开案例授权。后台审核通过后才可以公开展示。
+
+## 3. 后台运营操作流程
+
+后台地址：
+
+```text
+http://152.53.37.118:5175
+```
+
+本机地址：
+
+```text
+http://127.0.0.1:5175
+```
+
+本地 seed 默认管理员：
+
+```text
+邮箱：admin@example.com
+密码：Admin123!
+```
+
+生产环境必须改密码。
+
+### 3.1 仪表盘
+
+仪表盘用于看整体情况：
+
+- 今日用户
+- 今日项目
+- 今日生成集数
+- 任务状态
+- 项目状态
+- 队列状态
+
+运营每天先看这里，确认有没有大量失败任务或异常队列。
+
+### 3.2 项目管理
+
+项目管理用于查看用户项目。
+
+你可以看到：
+
+- 项目标题
+- 用户
+- 当前状态
+- 分集数量
+- 角色数量
+- 分镜数量
+- 最近任务
+- 成本
+
+常用操作：
+
+- 转人工：项目卡住或内容有风险。
+- 取消项目：内部测试废弃项目。
+- 查看项目详情：排查用户说“生成不了”的问题。
+
+### 3.3 小说管理
+
+小说管理包含小说源和章节。
+
+小说源是用户上传或 AI 原创产生的原始文本。章节是解析后的结构化内容。
+
+看这里可以判断：
+
+- 上传文本有没有解析成功。
+- 章节数量是否正常。
+- 字数是否异常。
+- 内容预览是否乱码。
+
+### 3.4 角色资源
+
+角色资源页用于看所有项目里的角色。
+
+运营重点看：
+
+- 主角是否生成。
+- 角色状态是否已确认。
+- 是否有锚点图。
+- 图片数量是否正常。
+- 长篇记忆数量是否正常。
+
+用户反馈“人物长得不一致”，先看这里有没有锚点图。
+
+### 3.5 分镜资源
+
+分镜资源页用于看镜头。
+
+运营重点看：
+
+- 一集是否有足够分镜。
+- 每个镜头的场景名是否合理。
+- 画面描述是否清楚。
+- 是否已经生成图片。
+- 最新图片能否预览。
+
+用户反馈“画面不对”，先看分镜字段，再看分镜图。
+
+### 3.6 成品漫剧
+
+成品漫剧页看最终视频。
+
+你可以看：
+
+- 视频资产 ID
+- 所属项目
+- 所属分集
+- 文件路径
+- 时长
+- 渲染任务
+- 预览
+
+用户反馈“视频下载不了”或“成品不对”，从这里开始查。
+
+### 3.7 用户管理
+
+用户管理是当前内部测试最常用的后台页面。
+
+常用操作：
+
+- 人工加余额
+- 查看用户详情
+- 看用户余额流水
+- 看用户订单
+- 看用户项目
+- 看用户素材
+- 看最近操作
+- 禁用或启用用户
+- 修改角色
+- 重置密码
+- 额度冲正
+
+当前用户端不展示真实支付入口，所以测试用户要先在后台加余额。
+
+建议：
+
+- 内部测试用户先加少量额度。
+- 真实 AI 测试前再加额外额度。
+- 额度冲正要写清楚原因。
+
+### 3.8 订单额度
+
+订单额度页用于看额度账户和历史订单。
+
+当前内部测试模式下：
+
+- 用户端不展示套餐和支付。
+- 后台人工加余额是主流程。
+- 历史 mock 支付接口还在，但不作为正式入口。
+
+### 3.9 内容审核
+
+内容审核页用于处理文本、素材、成品视频、公开案例。
+
+常见状态：
+
+- 通过
+- 需修改
+- 驳回
+- 屏蔽
+- 转人工
+
+用户反馈“项目被卡住”，要看这里有没有人工审核项。
+
+### 3.10 任务管理
+
+任务管理用于处理生成失败。
+
+常见操作：
+
+- 重试
+- 取消
+- 转人工
+
+任务失败时先看：
+
+- 任务类型
+- 错误信息
+- 重试次数
+- 是否达到上限
+- 项目是否缺前置资源
+
+例如视频失败，可能是分镜图不足、音频未生成、字幕缺失或 FFmpeg 异常。
+
+### 3.11 AI 接入
+
+AI 接入用于配置 OpenAI 或 mock Provider。
+
+顶部“OpenAI 统一接入”是运营日常使用区域。
+
+“初始化视频接入”会写入真实视频 Provider 预设，包含 MiniMax Hailuo、阿里 Wan、Vidu、Seedance、Runway 和 Kling。它们默认都是关闭状态，只是把配置位放进后台，不会自动调用、不自动扣费。
+
+重要规则：
+
+- 保存 Key 不等于开始花钱。
+- 只有勾选“生产任务优先使用 OpenAI”，业务链路才会优先使用真实 OpenAI。
+- “检查连接（不生成内容）”只查 Key 和网络，不生成内容。
+- 真实 Provider 的付费测试需要二次确认。
+- 真实视频测试默认禁用，避免误触发高成本视频任务。
+- 真实视频只能在用户端真人短剧流程里显式勾选确认后调用。
+
+建议第一次真实测试配置：
+
+- 单次成本上限：3
+- 当日成本上限：10
+- 先不要打开真实视频 Provider。
+- 先用真实文本和图片小样确认链路。
+
+### 3.12 成本日志
+
+成本页用于看 Provider 调用日志和估算成本。
+
+如果发现费用异常：
+
+- 先看哪个 Provider 调用多。
+- 再看是文本、图片、TTS 还是视频。
+- 视频按秒计费，最容易变贵。
+- 图片按张数累积。
+
+### 3.13 系统配置
+
+系统配置当前包含 API 加密开关。
+
+测试默认不开启。上线后可以手动开启。
+
+注意：应用层加密不能替代 HTTPS。正式上线必须使用 HTTPS。
+
+### 3.14 审计日志
+
+审计日志记录后台高危操作。
+
+例如：
+
+- 给用户加余额
+- 扣减或冲正额度
+- 禁用用户
+- 改角色
+- 重置密码
+- 修改系统配置
+- 导出日志
+
+出现运营争议或客服问题时，先查审计日志。
+
+## 4. 一集从头到尾的小白流程
+
+这是最推荐的新手演练流程，先用 mock 熟悉，不产生真实 AI 生成费用。
+
+1. 后台给测试用户加余额。
+2. 用户端登录测试用户。
+3. 新建项目，选择 AI 原创小说。
+4. 目标集数填 1。
+5. 填主角设定和卖点。
+6. 生成原创内容。
+7. 生成故事圣经。
+8. 检查故事圣经，确认。
+9. 抽取角色。
+10. 检查主角、反派、配角，生成锚点图，确认角色。
+11. 生成长篇记忆。
+12. 生成分集计划，确认。
+13. 选择第 1 集，生成脚本，确认。
+14. 生成分镜，检查 10 个镜头，确认。
+15. 生成分镜图。
+16. 生成音频。
+17. 生成字幕。
+18. 渲染视频。
+19. 到成品页预览和下载。
+20. 后台看项目、分镜资源、成品漫剧、任务和成本日志。
+
+## 5. 哪些内容是 AI 生成，哪些需要人确认
+
+| 阶段 | AI 会生成什么 | 人要看什么 |
+|---|---|---|
+| 原创小说 | 创意、章节、大纲、自检 | 是否符合题材和禁忌 |
+| 故事圣经 | 世界观、冲突、风格、结尾方向 | 是否跑题，规则是否清楚 |
+| 角色圣经 | 角色列表、人设、关系、外貌 | 主角/反派是否正确，关系是否合理 |
+| 角色图 | 候选图、锚点图、表情图 | 外观是否稳定，锚点是否合适 |
+| 长篇记忆 | 事件、伏笔、角色记忆 | 是否和前文冲突 |
+| 分集计划 | 每集标题、摘要、钩子、悬念 | 节奏是否适合短剧 |
+| 单集脚本 | 旁白、对白、剧情推进 | 语言是否顺，角色是否不崩 |
+| 分镜 | 场景、地点、画面、动作、镜头、Prompt | 画面是否能生成，镜头是否连贯 |
+| 分镜图 | 每个镜头的图片 | 人物一致性、画面质量 |
+| TTS | 多角色音频 | 声音、语速、时长、角色是否匹配 |
+| 字幕 | 对白级 SRT 字幕 | 每句台词时间轴和文字 |
+| 视频 | MP4 成品 | 是否可播放、画音字幕是否对齐 |
+
+## 6. 新手最容易误解的地方
+
+### 故事圣经不是让用户看的简介
+
+它更像制作规则。用户未必需要理解每个字段，但运营要知道它会影响后面所有生成。
+
+### 角色不是只靠一张图定
+
+角色由文字设定和锚点图共同决定。文字设定决定“是谁”，锚点图决定“长什么样”。
+
+### 场景目前不是独立资产库
+
+当前场景主要在分镜里体现。AI 会生成场景名、地点、画面描述。后续如果要做场景库，可以把常用地点、背景图、风格规则单独管理。
+
+### 确认不是摆设
+
+确认的意思是：这一步结果可以作为后续生成依据。
+
+如果故事圣经错了就确认，后面角色、分集、脚本都会跟着错。
+
+### mock 不等于没用
+
+mock 用来验证流程、页面、状态、素材落库、任务重试和下载。真实 AI 只是在 Provider 层替换生成能力。
+
+### Sora 视频不要默认打开
+
+Sora 按秒计费。当前漫剧落地更适合先用分镜图 + TTS + FFmpeg 合成，成本更可控。
+
+### 生成类型要先选清楚
+
+新建项目现在有三种生成类型：
+
+| 生成类型 | 当前作用 | 适合场景 |
+|---|---|---|
+| 图片漫剧版 | 分镜图 + 配音字幕 + FFmpeg 合成 | 低成本批量测试 |
+| 动态漫画版 | 先预留入口 | 后续做局部动效 |
+| AI 真人短剧版 | 演员定妆、真人分镜、关键帧、视频片段、片段质检、合成 | 先验证真人短剧数据流，再做真实视频小样 |
+
+AI 真人短剧版默认使用 mock video clip 跑通流程。后台已经支持 MiniMax Hailuo、阿里 Wan、Vidu、Seedance、Runway、Kling 等 image-to-video Provider，但真实视频默认禁用，必须运营启用 Provider、填写成本阈值，并且用户端勾选“确认使用真实视频生成并承担费用”后才会调用。
+
+真人短剧的顺序是：
+
+1. 先完成故事、角色、分集、脚本、分镜。
+2. 点“演员定妆”，把角色圣经转成真人演员设定。
+3. 点“真人分镜”，把漫画分镜改写成真人短剧镜头。
+4. 点“关键帧”，生成每个镜头的真人短剧关键帧 mock 图。
+5. 在“视频 Provider”里保持 mock，先点“估算”，确认成本为 0。
+6. 点“视频片段”，生成每个镜头的 mock MP4 片段。
+7. 预览片段，点“质检”；不满意可以点“重试”。
+8. 点“合成”，把视频片段拼成真人短剧 mock 成片。
+
+真实 Hailuo/Wan/Vidu/Seedance/Runway/Kling/Sora 等视频模型建议只做 1 个镜头小样。真实小样前要注意：
+
+- 后台 AI 接入页先点“初始化视频接入”。
+- 只启用一个视频 Provider。第一轮建议优先试 `minimax_hailuo_23_fast`，速度和成本更适合小样验证。
+- 填 API Key、Base URL、模型、单次成本上限、当日成本上限。
+- 填 `price_per_second`，否则页面只能显示 0 美元估算。
+- 真实视频需要 PNG/JPG/WebP 关键帧；mock SVG 关键帧不能直接用于真实视频 Provider。
+- 真实视频测试不要在后台 Provider 测试里做，后台仍禁用真实视频测试，避免误扣费。
+- 阿里 Wan、Seedance 等不同渠道接口字段差异较大；后台预设是可配置模板，正式上线前必须用 1 个镜头核对请求字段、返回视频 URL、耗时和实际账单。
+
+推荐真实视频小样顺序：
+
+1. MiniMax Hailuo 2.3 Fast：先看“人物会动”和中文短剧感是否接近目标。
+2. 阿里 Wan2.6 I2V Flash：对比速度、稳定性和成本。
+3. Vidu Q3 Turbo Reference：重点看角色一致性、表情和音画能力。
+4. Seedance/即梦：重点看真人感、镜头语言和中文短剧风格。
+5. Kling/Runway：作为备用对比。
+
+每次只测同一个项目、同一个角色、同一个镜头，这样才看得出哪个 Provider 更适合。
+
+## 7. 建议的真实 AI 验收顺序
+
+等你熟悉流程后，再做真实 AI 验收。
+
+建议顺序：
+
+1. 后台 AI 接入页设置单次成本上限和当日成本上限。
+2. 点“检查连接（不生成内容）”。
+3. 只打开真实文本或真实图片中的一个能力。
+4. 跑 1 个项目、1 集、10 个分镜。
+5. 看 Provider 日志和成本。
+6. 确认结果可控后，再打开 TTS。
+7. 视频继续先用 FFmpeg。
+8. 最后再考虑 Sora 小样。
+
+建议成本阈值：
+
+- 单次成本上限：3 美元
+- 当日成本上限：10 美元
+- 第一轮不打开 Sora
+
+## 8. 运营排查问题速查
+
+| 用户反馈 | 先看哪里 |
+|---|---|
+| 登录不了 | 后台用户管理、用户状态 |
+| 没额度 | 后台用户管理、额度账户、额度流水 |
+| 项目卡住 | 后台项目详情、任务管理 |
+| 小说解析失败 | 小说管理、小说源预览、章节数量 |
+| 角色不对 | 角色资源、故事圣经 |
+| 人物长得不一致 | 角色锚点图、分镜图 |
+| 场景乱 | 分镜资源里的场景名、地点、画面描述 |
+| 视频生成失败 | 成品漫剧、任务管理、分镜图、音频、字幕 |
+| 审核不过 | 内容审核页 |
+| 费用异常 | 成本日志、AI 接入优先级、成本阈值 |
+
+## 9. 当前系统状态提醒
+
+- 用户端是 H5 优先，PC 自适应；微信小程序/App 后续再适配。
+- 当前内部测试不展示真实支付入口。
+- 额度由后台人工增加。
+- OpenAI Key 已支持后台保存并加密。
+- 保存 Key 不会自动消耗额度。
+- OpenAI Provider 默认优先级低于 mock。
+- 真实视频测试已禁用，避免误触发高成本任务。
+- 当前适合先做 mock 全流程熟悉，再做真实 AI 小样。