QMTV 使用说明书(页面图解版)

本手册面向 QMTV 平台的三类用户:工作台用户(拆解-出图-成片创作者)、企业管理员(组织与分销)、平台管理员(/admin 运营方)。 演示环境:http://localhost:3300(启动见 docs/DEPLOY.md §2.5);演示账号 admin@qmtv.com / admin123456(管理员)、demo@qmtv.com / demo123456、producer@xingmang.cn / demo123456。 截图来自 Playwright 截图管线(frontend/e2e/snapshots.spec.ts,重跑 cd frontend && npm run test:snapshots);Mock 模式下素材图为占位 SVG,真实供应商接入后为实际生成结果。 配套文档:人工测试清单(QA 走查底稿)· e2e 场景清单(自动化覆盖地图)。

测试旅程总览

第1章 快速上手

1.1 登录(/login)

入口:未登录访问任意页面自动跳转;路由 /login。

做什么:登录 QMTV 账号,进入工作台。

操作步骤:

1. 输入「邮箱」与「密码」(可点「显示」核对明文);
2. 点「登 录」(请求中显示「登录中…」),成功后进入首页 /。

规则与注意:

• 登录失败为原生弹窗提示(如「邮箱或密码错误」),非 toast;
• 页面不显示演示账号——演示账号见本手册头部;
• 左侧为产品流程卡:「01 剧本拆解 → 02 智能出图 → 03 成片合成」。

1.2 注册(/register)

入口:登录页「还没有账号?立即注册」;路由 /register。

做什么:注册新账号,注册即赠体验积分。

操作步骤:

1. 填「用户名」「邮箱」「密码(至少 8 位)」;
2. 有企业邀请码则填「企业邀请码(可选,注册即加入企业)」,没有留空;
3. 点「注册」,成功后自动登录进入首页。

规则与注意:

• 注册赠送 200 体验积分(台账「注册赠送 200 积分(初始)」,后台「计费配置」可调);
• 填了有效邀请码→邀请人得 50 积分;无效邀请码静默忽略;
• 昵称留空取邮箱 @ 前缀;密码后端强校验 ≥8 位。

1.3 申请企业入驻(/enterprise-apply)

入口:登录页「企业客户?申请企业入驻」;路由 /enterprise-apply,无需登录。

做什么:企业客户提交入驻申请,平台审核通过后自动创建企业组织并任命申请人为负责人。

操作步骤:

1. 填「企业名称」「联系人」「申请说明」;
2. 点「提交申请」→ 页面显示「申请已提交,等待审核。可在登录后于「企业管理」中查看进度。」。

规则与注意:审核动作在管理后台「企业审核」tab(§7.5);审核结果以站内通知告知。

1.4 首页(/)

入口:登录后默认落点;顶栏「首页」。

做什么:内容门户——查看积分余额、从四张入口卡进入核心功能。

操作步骤:整卡点击跳转:「01 剧本拆解台」→ /dashboard;「02 剧本视频生成」→ /video;「03 独立生成工具」→ /independent-tools;「04 爆款分析」→ /viral-analysis。

规则与注意:右上统计块实时显示「积分余额」与「当前账号」。

1.5 顶栏与全局功能

做什么:全局导航、搜索、主题、通知与账号入口。

操作步骤与规则:

• 导航下拉:「工作台」(拆解台/视频生成/导演工作台)、「创作工具」(独立生成/工作台工具集/本入剧出/作品展示/爆款分析)、「内容生态」(评估中心/剧本库/投稿中心/编剧广场/火花计划);「企业管理」「推广与收益」仅企业成员可见;「管理后台」仅管理员可见;
• 全站搜索(Ctrl/Cmd+K):搜「📚 剧本」与「✍️ 编剧」,回车跳首个结果;
• 主题切换:深色→浅色→雅致三态循环,记忆在浏览器本地;
• 工作台切换:「原始工作台」/「导演工作台」两版,切换即跳对应工作台;
• 🔔 通知:点开面板(60 秒轮询),支持单条/全部已读;业务完成另有实时推送 toast(视频/拆解/充值/工具四类);
• 积分胶囊:「昵称 · 可用 N 积分」,点击进账号中心;
• 右侧按钮:「充值」「积分记录」「修改密码」「退出」;
• 公告横幅:管理员发布的活跃公告显示在顶栏下,点「我知道了」不再显示。

第2章 创作主链(拆解 → 出图 → 成片 → 导出)

2.1 剧本拆解台(/dashboard)

入口:顶栏「工作台」→「🧩 剧本拆解台」;首页入口卡 01。

做什么:粘贴剧本文本,AI 拆解为场次/分镜/资产,再故事板抽卡生成分镜图——全链路的起点。

操作步骤:

1. 左栏「任务配置」:上传 .txt 或点「📚 剧本库导入」选现成剧本,或直接粘贴「剧本文本」(提示:「强烈建议一集一集放入剧本,拆解效果更佳」);
2. 填「任务名称」、选「剧本类型」(国内短剧/海外短剧)、「人物脸型风格」(亚洲中国/非亚洲)、缩略图墙选「视觉风格」(真人短剧/3D 动画/2D 插画三组共 19 种)、「成片时长(分钟)」范围与「特殊要求」;
3. 点「立即合并放入后台拆分」→ toast「拆解完成:X 场 Y 镜,消耗 Z 积分」(异步路径为「已提交后台 AI 拆解」,完成后实时通知);
4. 「智能资产提取」卡勾选「人物/场景/道具」范围点「开始提取」→「已提取 N 个资产图,消耗 N×单价 积分」;
5. 右栏故事板:逐镜「📝 编辑提示词并生成」(10 积分/张)或用「流程控制」的「一键全自动串联生成」;「🔍 预览2K」可看 15 积分/次的高清预览;
6. 「执行记录」中任务卡显示状态(完成/失败/处理中)与「N 镜头」,支持打开/复制/重命名/删除。

规则与注意(计费详见附录 A):

• AI 拆解按 token 计费:每积分 ≈ 1000 tokens(「文本拆解按 token 计费」提示行实时显示当前模型与换算);「🤖 AI 重新拆解」固定 20 积分(弹层确认「将清空现有分镜与资产并重新拆解」);
• 分镜图 10 积分/张、2K 预览 15 积分、资产提取按张数×10;
• 「图片规则说明」:自定义图需去独立生成工具页生成再上传;独立生成结果仅保存 72 小时;
• 「💰 项目积分」弹层可查本项目全部消耗明细;积分不足统一 toast「积分不足」。

2.2 剧本视频生成(/video)

入口:顶栏「工作台」→「🎬 剧本视频生成」;首页入口卡 02。

做什么:接续拆解产物,逐镜生成视频、串行打标、审片、配音,一键打包交付(图片包/视频包/剪映包)。

操作步骤:

1. 顶部「选择任务」选拆解任务(选项格式「任务名(N镜)」);
2. 逐镜填「视频提示词」(可粘贴「参考图槽位」的 @图片N 引用)、「时长(秒) 1~15」「构图」(9:16/16:9/1:1)「分辨率」(1080p/720p),点生成;
3. 批量动作:「🏷️ 一键串行打标签」(确认「消耗 N×10 积分」)、「⚡ 一键全自动串行渲染全案视频」(确认「估算消耗 X 积分(拉取5 + 每秒5×时长)」)、「🕵️ 智能审片」(确认「消耗 10 积分」→ 报告含综合分与五维:主体一致性/画面美感/动作连贯/字幕与口型/穿帮检测);
4. 「🎙 配音」:选音色(旁白解说/女声/男声/童声)生成旁白(免费);
5. 交付:「📥 一键下载图片+提示词」「📦 打包下载已完成视频」「✂️ 剪映导入包」(解压到剪映草稿目录即可打开)、「进入导出」→ 导出成片页。

规则与注意:

• 视频计费 = 拉取 5 + 每秒 5×时长(「计费说明」行实时显示当前单价);打标 10/镜;审片 10/次;配音免费;
• 「取消生成」提示「供应商已产生费用,取消不退积分」;
• 左栏可上传音频素材(「音频将自动进入剪映导入包与成片混音流程」);
• 生成完成/失败有实时 toast 推送,失败自动退积分。

2.3 导出成片(/export/:taskId)

入口:视频页工具条「进入导出」;路由 /export/:taskId(无顶栏入口)。

做什么:对已渲染分镜发起成片导出编排,显示进度与段数。

操作步骤:进入页面自动执行——已有导出则显示进度,否则自动新建并 toast「已开始导出,共 N 段」;2 秒轮询至终态 toast「导出完成」/「导出失败」。

规则与注意:每段消耗 2 积分;本页无 ZIP 下载按钮——产物下载在视频页的三个打包按钮;失败且积分不足显示「积分不足,无法导出」。

第3章 创作工具

3.1 独立生成工具(/independent-tools)

入口:顶栏「创作工具」→「🖼 独立生成工具」。

做什么:不依赖剧本项目,独立生成图片/视频素材,或一键生成解说成片。

操作步骤:

1. 「图片生成」:填提示词、选比例(9:16/16:9/1:1)、可加最多 9 张参考图,点「生成图片(10 积分)」;
2. 「视频生成」:填提示词选比例,点「生成视频(50 积分)」;
3. 「🎬 一键成片」:填标题与解说剧本(≥50 字),点「开始生成」→「成片完成:N 个解说段落」;
4. 「生成记录」中可下载原图/重用提示词/删除(删除确认「取消已开跑任务不退积分」)。

规则与注意:顶部规则「结果仅保存 72 小时,请及时下载;参考图最多 9 张」;一键成片 30 积分;视频时长滑杆仅展示不参与计费(扁价 50)。

3.2 本入剧出(/oneclick)

入口:顶栏「创作工具」→「📖 本入剧出」。

做什么:粘贴小说或剧本,自动识别分集、生成分镜并逐集渲染成片。

操作步骤:

1. 「＋ 新建转剧项目」:填项目名称、粘贴文本(支持「第X集」划分,无集名按段落切分)→「已识别 N 集」;
2. 项目卡上「🚀 一键转剧」→ 确认「将自动生成分镜并逐镜渲染视频(每集 30 积分)」→ 逐集进度,结束「转剧完成」(单集失败自动退款继续其余)。

规则与注意:每集 30 积分扁价;删除项目会「分集与成片素材一并删除」。

3.3 工作台工具集(/workbench)

入口:顶栏「创作工具」→「🛠 工作台工具集」。

做什么:成片后处理三件套——转绘/去字幕/转高清。

操作步骤:

1. 选工具卡:🎨「一键转绘」(20 积分/次,填风格描述如「赛博朋克霓虹风」)、🧽「去字幕」(10 积分/次)、💎「转高清」(15 积分/次,选目标 2K/4K);
2. 「上传视频(mp4/webm/mov)」或「引用已有成片」下拉选择;
3. 点「开始{工具名}(N 积分)」→ 完成 toast「{工具名}完成」。

规则与注意:「生成失败自动全额退回积分,可放心提交」;转绘未填描述确认「将使用默认「电影级写实质感」」。

3.4 导演工作台(/director3d)

入口:顶栏「工作台」→「🎯 导演工作台」(或顶栏工作台版本切换)。

做什么:项目制三级工作台——剧本自动分集 → 资产提取 → 9 字段导演指令分镜 → 逐镜出图出片 → 导出交付包。

操作步骤:

1. L1 项目列表:「＋ 新建项目」(名称/脸型/视觉风格/剧本文本)→「项目已创建,识别出 N 集」;支持「📥 导入项目」(.zip)与「导出 ZIP」;
2. L2 项目详情(八 tab):「🎞 片段管理」进分集工作台;「👤 角色 / 📍 场景 / 🎒 物品」资产三 tab 可「加入待生成队列」(不扣费)再「⚡ 批量生成」(按张×10,失败部分自动退款)或「📦 公共池导入」;「🖼 融合生图」选角色/场景/物品+画面描述生成一致性图(3 积分);「✨ 图片改创」以已有图为底图改创(10 积分);「🎬 参考视频」「🎵 参考音频」上传素材;项目头可「🏢 共享到企业」「🕵️ 智能审片(10 积分)」;
3. L3 分集工作台:勾选范围「🎭 提取资产」;「🎬 生成分镜」(确认「按场次生成 3~6 镜/场」);每镜卡内编辑「导演指令(9 字段)」(格式「每行一条 键:值」)、「图片提示词」「视频参数」「视频提示词」,逐镜「🖼 生成图片」「🎥 生成视频」。

规则与注意:分镜/资产图按图片单价(默认 10);融合 3 积分;「待生成资产不会消耗积分,生成时才扣」。

第4章 内容生态

4.1 剧本库(/library)

入口:顶栏「内容生态」→「📚 剧本库」。

做什么:官方剧本市集——多维筛选找剧本,看详情(项目亮点/前三集试读/人物小传/世界观/故事目录),一键导入拆解台开拍。

操作步骤:

1. 筛选:题材 chip(带 🔥 近 7 天热度)、「全部市场/受众/形式」下拉、搜索框(防抖)、排序(近期火爆/评分最高/最新上架);
2. 点卡片开详情弹层,按锚点浏览各区块;点「📥 导入到拆解台使用」→ 自动跳拆解台并载入剧本。

规则与注意:浏览与导入免费(导入记录使用热度);完整剧本在导入后才载入拆解台。

4.2 投稿中心(/studio)

入口:顶栏「内容生态」→「📮 投稿中心」。

做什么:提交原创剧本投稿(过审上架剧本库),维护编剧档案。

操作步骤:

1. 「＋ 新建剧本投稿」:填「标题*」「分类」「目标市场」「制作形式(短剧/网剧)」「目标受众」「简介」「剧本内容*」;
2. 「存草稿」或「提交审核」→「已提交审核,审核结果将在通知中告知」;
3. 状态流转:草稿→待审核→已发布/需修改/已驳回;「需修改」可「查看意见」后「重新编辑提交」;
4. 「编剧档案」:填笔名*/擅长题材/简介/代表作创建资料,资料展示在编剧广场。

规则与注意:投稿免费;过审后上架剧本库(§4.1)供全网使用;审核动作在管理后台「投稿审核」tab(§7.12)。

4.3 编剧广场(/writers)

入口:顶栏「内容生态」→「✍️ 编剧广场」。

做什么:发现编剧——按题材/排序浏览,看主页(入驻时间/在库剧本/代表作)。

操作步骤:搜索(回车)或点题材 chip;点卡片「查看主页」;主页内点在库剧本跳剧本库详情。

规则与注意:展示数据来源即投稿中心的「编剧档案」。

4.4 作品展示(/showcase)

入口:顶栏「创作工具」→「🎬 作品展示」。

做什么:平台成片作品墙——发布已完成成片让全平台看见。

操作步骤:「📤 发布作品」→ 选成片(仅已完成)+ 填「作品名称」→「发布到作品墙」;自己的卡片可「撤下」。

规则与注意:「发布不消耗积分」;发布后全平台可见。

4.5 火花计划(/spark)

入口:顶栏「内容生态」→「🔥 火花计划」。

做什么:创作者激励计划——加入即奖积分,投稿过审按阶梯持续奖励。

操作步骤:

1. 点「🔥 立即加入(赠 100 积分)」→ toast「已加入火花计划,100 积分已到账」,数据卡开始实时展示投稿量/过审率/累计激励;
2. 按本期赛事卡指引「立即投稿」(经投稿中心提交,过审自动进入评选);
3. 阶梯:🪵 星火(过审 1-2 部,100 积分/部)→ 🔥 炬火(3-5 部,150 积分/部+首页推荐位)→ 🏆 燎原(6+ 部,200 积分/部+专属流量扶持+实物周边)。

规则与注意:重复加入提示「您已加入火花计划」;「怎么玩」三步:写剧本并投稿→过审即发布→按阶梯拿激励;FAQ 见页面底部四条。

4.6 爆款分析(/viral-analysis)

入口:顶栏「创作工具」→「📈 爆款分析」。

做什么:粘贴爆款链接或文案,AI 从四维打分并给改写钩子。

操作步骤:填「任务名(可选)」与「链接或文案」→「开始分析(5 积分)」→ 结果卡显示环形总分(60-94)+ 四维条(钩子强度/情绪共鸣/节奏密度/转化引导)+ 改写钩子(可复制);历史记录可回看。

规则与注意:每次 5 积分;空内容提示「请输入待分析内容」。

4.7 剧本评估中心(/evaluation)

入口:顶栏「内容生态」→「🔬 剧本评估中心」。

做什么:七维评分体系的剧本评估,快速(100 积分)/深度(300 积分)两档,产出结构化评估报告。

操作步骤:

1. 「新建评估」:填项目名(选填)、选「评估方式」卡片(⚡ 快速—评分/结论/最多 3 项风险;🔬 深度—完整报告含逐集证据与海外适配)、可选填题材/市场/形式三下拉;
2. 粘贴剧本文本(≥100 字,建议含人物小传/大纲/分集正文)或上传 .txt/.md/.docx(≤10MB);
3. 点「开始评估」→ toast「已提交,冻结 N 积分,完成后结算(失败自动退回)」;
4. 流水线三阶段八角色实时推进(交付规范审计→全剧主审/前 10 集精读→证据复核/首席评分),3 秒轮询;
5. 完成后查看报告:总分/等级/七维评分(交付规范 10+内容基础 20+前 10 集转化 20+人物情绪 15+结构兑现 15+海外适配 10+AI 漫剧可视化 10)/故事亮点/逐集证据/重点风险/推进建议,可「📥 下载报告」(.txt)。

规则与注意:提交冻结、完成结算、失败全额退回(「评估失败,冻结积分已自动退回」);字数不足提示「剧本内容至少 100 字」。

第5章 积分与账户

5.1 个人积分流水(/credits)

入口:账号中心「积分明细页」;顶栏「积分记录」为弹层版。

做什么:查看积分充值/消费/余额明细。

操作步骤:四格汇总(可用积分/累计增加/累计消费/当前余额)+ 流水表(时间/类型「增加|扣费」/事项/积分「+N|-N」/余额);「上一页/下一页」翻页(每页 20 条)。

规则与注意:「累计增加/累计消费/当前余额」三格基于当前页聚合,非全量统计。

5.2 充值(/recharge)

入口:顶栏「充值」;账号中心「充值」。

做什么:扫码转账充值积分,上传凭证待审核到账。

操作步骤:

1. 左栏看「充值金额(元)」输入(≥1),页面实时预览「按当前汇率 1 元 = N 积分,预计获得 N 积分」;
2. 按收款码转账(备注订单号)→「创建充值订单」→ toast「充值订单 xxx 已创建(N 积分),请转账后上传支付凭证」;
3. 「我的订单」中对该单「上传凭证」(图片)→ 状态「待审核」;
4. 管理员审核通过 → 状态「已到账」+ 实时 toast「💰 充值已到账」。

规则与注意:

• 汇率默认 1 元 = 10 积分(后台可调);无收款码时提示线下联系管理员;
• 「单笔充值满 980 元自动开通推广资格」(可在后台调整);
• 到账同时自动结算两级返佣(§6.2)。

5.3 账号中心(/account)

入口:顶栏积分胶囊点击。

做什么:个人资料/登录设置/积分/通知集中管理。

操作步骤:

• 修改密码:填原密码+新密码(≥8 位)+确认 →「密码已修改」;
• 修改登录邮箱:填新邮箱+当前密码 → 成功后强制登出跳登录页;
• 查看邀请码/注册时间/推广资格 tag/通知(最近 4 条)。

规则与注意:改密成功后端撤销全部登录状态(refreshToken 全失效),其他已登录设备需重登;手机号绑定暂未接入。

第6章 企业与分销(企业成员可见)

6.1 企业管理(/organization)

入口:顶栏「企业管理」(有 org_id 时显示;未加入企业时此页提供「提交入驻申请」与「使用邀请码加入」两个入口)。

做什么:企业组织管理——数据看板/成员角色/分组权限/素材权限/企业素材库/共享项目/积分流水。

操作步骤(已加入企业,7 个 tab 全员可见,管理动作按角色收敛):

1. 📊 数据看板:积分余额(可用/冻结)/累计充值/累计消耗/近 14 天趋势与项目、人员消耗榜;
2. 👥 成员与角色:所有者可「生成邀请码」邀新(对方邮箱→邀请码→对方在「使用邀请码加入」处兑换)、调整角色(成员/管理员)、移除;
3. 🧩 成员组·权限组:所有者创建成员组(指定组长)与权限组(查看/上传/下载/编辑/删除组合);
4. 🔐 素材权限:五项独立权限勾选(「授予下载/编辑/删除会自动授予查看;授予删除自动含编辑;取消查看会取消其余全部权限」);
5. 🗄 企业素材库:目录树/类型筛选/文件夹管理;素材来自成员在拆解台「资产库」的企业共享;
6. 🎬 共享项目:导演工作台开了「共享到企业」的项目在此汇集,可跳转查看;
7. 💰 积分流水:组织维度台账。

规则与注意:角色三层——所有者(全部管理)/管理员(素材权限+看板+共享项目)/成员(按权限组访问)。

6.2 推广与收益(/distribution)

入口:顶栏「推广与收益」(企业成员可见;推广资格满 980 元充值自动开通)。

做什么:分销推广——分享推广码拿两级返佣,收益可提现或 1:1 兑换生产积分。

操作步骤:

1. 概览卡复制「我的推广码」分享;好友注册时填入即绑定为下线;
2. 下线充值即按比例返佣(到账自动结算):一级 8% / 二级 2%(后台可调);
3. 「提现」tab:收益满 100 积分申请提现 → 状态机 待审核→审核中→待打款→已打款(平台打款后)→ 你点「确认到账」→已完成;待审核/审核中可「撤回」;
4. 「兑换」tab:收益 1:1 兑换生产积分(最少 10)。

规则与注意:提现最低 100 积分(「最低提现 N 积分」);可提额度=累计佣金−全部提现申请(已驳回/撤回不释放额度);兑换与提现额度相互独立。

第7章 管理后台(/admin,管理员)

入口:顶栏「管理后台」(仅 admin);非管理员访问被顶回首页。左侧 tab 栏共 14 个 tab,30s 自动刷新概览。

做什么:平台运营全功能——用户/积分/内容/审核/计费/模型/提示词。

各 tab 速览:

规则与注意:

• 「模型配置」是全站 AI 能力开关:接入真实供应商后自动切换,失败自动回退 Mock;配置零环境变量;
• 「计费配置」改动全站即时生效(对照附录 A 各「可调」项);
• 充值「通过」即触发到账+两级返佣联动,不可逆。

附录 A 计费速查表

单价经源码核对(backend/internal/domain/credits/billing.go 及各域);标「可调」者经管理后台「计费配置」或 settings 即时生效。

附录 B 常见问题

• 登录掉线/全员掉线:JWT 密钥文件(data/.jwt_secret)丢失或更换所致——迁移必须随 data/ 整目录带走(见 DEPLOY.md §5.1);
• 页面白屏:先查前端 dist 是否构建成功(:3300 托管的就是 dist/),再清浏览器缓存;
• 生成一直排队:未配置模型接入时全站走内置 Mock(秒级同步完成);若配置了真实供应商,排队属正常,完成/失败均有实时 toast;
• 生成失败积分去哪了:自动原路退回(台账可见「+N」退回行),工作台工具/评估/转剧等失败面全覆盖;
• 独立生成的图片不见了:独立生成结果仅保存 72 小时,请及时下载;
• 改密后被登出:改密撤销全部登录状态(安全设计),用新密码重登即可;
• 充值为 0 积分:订单需管理员审核到账,状态在「我的订单」可见;到账后有实时通知;
• 提现被驳回:看提现记录「备注」列的管理员原因;驳回/撤回的额度立即解锁可重新申请。