# 01 · 系统设计方案 LLMS 索引： [llms.txt](/llms.txt) --- > 本文说明 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_` 指定当前使用；管理端可测试连通。 - **提示词中心**（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. 兼容对标对照 | 参照平台 | 已对齐模块 | |---|---| | 巨日禄 video.jurilu.com | 项目八类资源中心、融合生图、图片改创、待生成队列、公共池、参考视频/音频、本入剧出、剧本超市、团队管理(看板/组/权限/素材权限)、企业素材库(目录树/容量)、工作台工具集(转绘/去字幕/转高清——对方还标记"即将上线")、火花计划、作品展示 | | 新版 GAE newgae.manjuchuhai.cn | 剧本评估中心(8角色3阶段七维)、剧本库市集(多维筛选/详情五区块/试读)、编剧广场、投稿中心、账号中心、全站搜索 | | 旧版 GAE manjuchuhai.cn | 拆解台完整配置、视频页四一键、15 项功能更新全量、双工作台 | --- 反链： - [产品](/qmtv/product/)