01 · 系统设计方案

本文说明 QMTV 的产品定位、功能全景与各模块的设计方案。历史设计决策的完整推导过程见 D:\WORK\GAE\QMTV网站设计文档.md（22 节版本史）。

1. 产品定位

QMTV 是面向短剧/漫剧制作方的一站式 AI 内容生产平台，覆盖「剧本 → 资产 → 分镜 → 视频 → 成片 → 交付」完整链路，并配套内容生态（剧本库/评估/编剧激励）、企业协同（团队/权限/素材库）与商业闭环（积分/充值/返佣）三大体系。

设计原则：

• 生产工具 + 内容社区 + 商业化三合一：既做工具（对标巨日禄的项目内八类资源中心、工作台工具集），也做生态（对标新版 GAE 的剧本评估/剧本库/编剧广场），还做生意（积分计费/充值返佣/团队管理）。
• 积分是唯一硬通货：所有 AI 消耗统一折算积分，任务级流水可查，失败自动退款。商业模块（充值/返佣/提现）全部围绕积分展开。
• 功能零缺失复刻：以行业头部平台（manjuchuhai.cn 旧版/新版、video.jurilu.com）为参照逐项对齐，允许布局不同、不允许功能缺失。

2. 功能全景

QMTV
├── 创作生产
│   ├── 剧本拆解台        剧本→场次/分镜/资产，四种故事板生成方式，18 种视觉风格
│   ├── 导演工作台        项目→分集→分镜(9字段导演指令)→逐镜出图出片，八类资源 Tab
│   ├── 剧本视频生成      分镜→视频：一键下载/串行打标/全自动渲染/剪映包，智能审片
│   └── AI 工具集         独立生图/生视频/爆款分析；一键转绘/去字幕/转高清；本入剧出
├── 内容生态
│   ├── 剧本库市集        多维筛选+详情五区块(亮点/试读/人物/世界观/目录)+导入拆解台
│   ├── 剧本评估中心      8 AI 角色 × 3 阶段流水线，七维评分，逐集证据，深度/快速两档
│   ├── 编剧广场+投稿中心 编剧档案/主页，投稿状态流，过审上架剧本超市
│   ├── 火花计划          阶梯积分激励 + 现金奖池赛事页
│   ├── 作品展示          成片作品墙，发布/撤下/站内播放
│   └── 全站搜索          Ctrl K 同时搜剧本与编剧
├── 企业协同
│   ├── 企业管理台        数据看板(趋势+双排行榜)/成员角色/成员组/权限组/素材权限矩阵
│   ├── 企业素材库        目录树+10GB容量展示+共享素材跨成员可见
│   └── 项目共享          导演项目一键共享到企业
├── 商业闭环
│   ├── 积分体系          生成按量计费/任务级流水/失败退款/冻结-结算-退回
│   ├── 充值返佣          凭证审核入账、两级返佣(8%/2%)、满980自动开通推广资格
│   └── 管理后台          14 板块：用户/积分/公告/企业/提现状态机/模型接入/计费/剧本/提示词/指令/充值审核/投稿审核/任务审计
└── 平台基础
    ├── 模型接入注册表    文本/图片/视频三类，每条独立接口地址+密钥+模型名
    ├── 提示词中心        8 分类版本管理，占位符引擎
    └── 实时推送          SSE 事件流（视频进度/拆解完成/充值到账/审片报告）

3. 核心模块设计方案

3.1 剧本拆解（双引擎）

• 提交：POST /api/tasks/v2 接收剧本+配置（剧本类型/脸型/风格/时长区间/提取范围/自定义指令）。
• 引擎 A（规则拆解）：preprocess.js 正则识别场次/分镜/角色，确定性输出，秒级完成，永远可用。
• 引擎 B（LLM 拆解）：tasks/v2 走异步任务——取提示词中心生效的拆解指令（带输出合同：[CHARACTERS]/[SCENES]/[PROPS]/[SCRIPT]/[SHOT]/[IMG]/[VID] 段落标记），llm.js 调用注册表当前文本模型，parser.js 状态机解析回填。失败自动回退引擎 A 并站内通知。
• 设计要点：输出合同用段落标记而非纯 JSON——大模型对分段文本的遵循度比严格 JSON 高得多；解析器按行状态机容错，允许模型输出多余空行/前后缀。

3.2 资产一致性与融合生图

• 角色/场景/物品在项目内统一建档（assets 表），生成图后 image_id 回填，形成"资产卡"。
• 提示词组装：promptCenter.buildAssetPrompt(type, 描述, 脸型) 拼接资产类别模板 + 占位符替换，保证同角色跨镜头提示词同源——这是一致性的第一保障。
• 融合生图（3 积分/张）：组合角色/场景/物品卡描述 + 姿态/特效 + 画面描述 → 单张图，明确写入"保持所选资产外观一致性"指令。
• 图片改创：以项目内任意图为底图，原文提示词 + [改创要求] 后缀重新生成。
• 待生成队列：资产先入队（queue_status: idle/queued/generating/done）不扣费，生成时才计费；失败回 queued 不丢队列；重启时 recoverQueue() 把 generating 回退 queued（持久化挂起）。

3.3 分镜与视频渲染

• 分镜支持 9 字段导演指令（环境状态/叙事任务/世界空间锁/位置锁/轴线锁/投影/群像锁/逐秒动作/转场点，JSON 存 director_shots.shot_fields）。
• 视频/图片生成统一走 providers.imageSmart / videoSmart（见架构文档 §5）；批量渲染逐笔容错——单笔失败退款继续，返回 failed 计数。
• 智能审片（10 积分）：五维评分（主体一致性/画面美感/动作连贯/字幕与口型/穿帮检测）+ 分级问题清单 + 修复建议；LLM 可用时走结构化 JSON 审片，否则规则引擎，engine 字段标注来源。经典工作台与导演工作台双入口，报告存 review_reports。

3.4 剧本评估（多智能体流水线）

• 快速 100 / 深度 300 积分，提交冻结、完成结算、失败退回（tryDeduct type=‘reserve’）。
• 8 角色 × 3 阶段：一级 交付规范主审+交叉核验 → 二级 全剧主审+前十精读+情绪人物+海外市场 → 三级 证据复核+评分审定。阶段落库 eval_projects.stage，前端轮询渲染流水线动画。
• 七维评分（合计 100）：交付规范10 / 内容基础20 / 前10集转化20 / 人物情绪15 / 结构兑现15 / 海外适配10 / AI漫剧可视化10。
• 深度评估附逐集证据（按「第X集」切分，Mock 引擎与 LLM 提示词都要求按集给证据）。

3.5 剧本库市集与生态

• script_library（官方库）与 submissions（用户投稿）两源：官方库管理端维护；投稿过审后上架。字段完全市集化：题材/市场/受众/形式/标签/亮点/试读/人物小传/世界观/梗概/设定/集数/策划字数/编剧署名/评分/封面。
• 详情目录自动从正文解析「第X集」生成；导入使用记 script_uses（近 7 天热度驱动排序与 🔥 角标）。
• 火花计划：spark_joined 报名送 100 积分；阶梯 = 星火(1-2部过审,100/部) → 炬火(3-5部,150/部) → 燎原(6+部,200/部)；页面叠加现金赛事卡（奖池/奖项表/投稿入口）。

3.6 企业协同

• 组织/成员/邀请码；owner→admin→member 三级角色。
• 成员组（member_groups）与权限组（perm_groups：查看/编辑/删除/下载四权限 JSON）挂在 org_members 上；素材权限五项矩阵（查看/上传/下载/编辑/删除，org_members.material_perms）带联动规则：授上传/下载/编辑/删除自动含查看，授删除自动含编辑，取消查看清空全部——与行业对标产品一致。
• 数据看板：组织成员聚合的积分概览（可用+冻结）、近 14 天消耗趋势、项目消耗榜（credit_records.task_id 反查任务/项目名）、人员消耗榜。
• 素材库：asset_folders 目录树 + asset_library.folder_id 归属 + 容量估算（图片/音频真实大小、缺失按 80KB/2MB 估算，配额 10GB）。

3.7 商业闭环

• 计费：util.COSTS 基础价 + 管理端计费配置（视频=拉取5+每秒5，图片10，2K预览15，拆解20，爆款5，评估100/300，审片10，转绘20/去字幕10/转高清15，融合3，一键转剧30/集，导出2/段）。计费参数存 system_settings，管理端可改。
• 充值：创建订单→上传凭证→管理审核→approve 入账 + 两级返佣（一级 8%、二级 2%，从 distribution_settings 读）→ 单笔满 980 元自动 affiliate_enabled 开通推广资格。
• 提现状态机：pending→reviewing→topay→paid→(用户确认)done；任意审核阶段可驳回；pending/reviewing 可用户撤回解锁收益。非法流转被 W_FLOW 矩阵拒绝。
• 安全：JWT 密钥持久化 data/.jwt_secret（支持 QMTV_JWT_SECRET 覆盖）；登录 20 次/分/IP、注册 5 次/时/IP 限流；密码 hash 存储；管理端接口全部 adminRequired。

4. 数据模型设计要点

49 张表见架构文档 §6。关键设计决策：

• 多态引用：images.task_id 既存拆解任务 id（t_）也存导演项目前缀 id（dir_）；videos.shot_id 配合 shots._tbl 约定（providers 内部判断 director_shots/shots）指向不同表——避免为两套工作台建两套生成表。
• 积分流水即账本：credit_records(task_id) 使任意消耗可追溯到项目，管理端审计、项目积分记录、企业看板共用这一张表。
• 轻量迁移：所有列变更走 migrations 数组幂等 ALTER，历史兼容靠 COALESCE/DEFAULT 占位值（注意：迁移 DEFAULT 值会挡住后续数据回填，需显式覆盖，见交接文档踩坑 §7.4）。
• 种子数据幂等：剧本库种子按标题匹配回填，且只覆盖"默认占位值"（market=‘中国内地’ 等），不覆盖人工修改。

5. AI 链路设计

页面动作 → routes(校验+tryDeduct) → promptCenter 组提示词
  → providers.imageSmart / videoSmart
      ├─ 注册表有启用接入（base_url+api_key+model）→ 真实供应商
      │    图片：OpenAI 兼容 /images/generations（同步，比例→尺寸映射）
      │    视频：异步任务 提交→轮询(10s×90次)→下载回填→SSE通知；失败自动退款
      └─ 无接入 → 本地 Mock（SVG 占位图/动画视频/WAV 配音），同步返回
  → 结果落 images/videos 表 → bus.emit → SSE → 前端 toast + 刷新

• 模型接入注册表（model_endpoints）：purpose ∈ text/image/video，每条独立 base_url/api_key/model/enabled，active_model_<purpose> 指定当前使用；管理端可测试连通。
• 提示词中心（prompt_templates）：8 分类（split/shot_image/shot_video/asset_character/asset_scene/asset_prop/video_tag/viral+eval_quick/eval_deep）版本管理，单分类单生效；占位符 {描述}{脸型}{场次}{景别}{转场}{风格基调} 生成时替换。
• 失败语义统一：providers 内部退款并抛 {status, message}，全局错误中间件透传；调用方不得重复退款。

6. 视觉设计体系

• 三主题 CSS 变量切换（html[data-theme] = dark/light/gae + localStorage），深色为主品牌（深空蓝 #04060e 底 + #2f6bff→#22d3ee 电光蓝渐变），玻璃拟态面板（backdrop-blur + 半透明边框光晕）。
• 登录页左右分屏品牌大图；分镜卡 v-tilt 自定义指令 3D 悬浮倾斜（触屏禁用）。
• 导航为分组下拉（工作台/创作工具/内容生态），菜单文字固定浅色（浅色主题下 var(–text) 会在深色菜单底上不可读——历史踩坑）。
• 移动端断点：1100px 导航换行、900px 网格降列。

7. 兼容对标对照