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

LLMS 索引： [llms.txt](/llms.txt)

---

> 本手册面向 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,真实供应商接入后为实际生成结果。
> 配套文档:[人工测试清单](/qmtv/manual/%E4%BA%BA%E5%B7%A5%E6%B5%8B%E8%AF%95%E6%B8%85%E5%8D%95/)(QA 走查底稿)· [e2e 场景清单](/qmtv/test/e2e-qmtv-%E5%9C%BA%E6%99%AF%E6%B8%85%E5%8D%95/)(自动化覆盖地图)。

## 测试旅程总览

```mermaid
flowchart LR
  A[第1章 快速上手] --> B[第2章 创作主链]
  B --> C[第3章 创作工具]
  A --> D[第4章 内容生态]
  A --> E[第5章 积分与账户]
  D --> F[第6章 企业与分销]
  G[第7章 管理后台]
```

---

## 第1章 快速上手

### 1.1 登录(/login)

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

![登录页](/qmtv/manual/images/e2e-login.png)

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

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

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

### 1.2 注册(/register)

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

![注册页](/qmtv/manual/images/e2e-register.png)

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

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

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

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

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

![企业入驻申请](/qmtv/manual/images/e2e-enterprise-apply.png)

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

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

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

### 1.4 首页(/)

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

![首页](/qmtv/manual/images/e2e-home.png)

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

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

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

### 1.5 顶栏与全局功能

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

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

---

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

### 2.1 剧本拆解台(/dashboard)

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

![剧本拆解台](/qmtv/manual/images/e2e-dashboard.png)

**做什么**:粘贴剧本文本,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。

![剧本视频生成](/qmtv/manual/images/e2e-video.png)

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

**操作步骤**:
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`(无顶栏入口)。

![导出成片](/qmtv/manual/images/e2e-export.png)

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

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

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

---

## 第3章 创作工具

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

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

![独立生成工具](/qmtv/manual/images/e2e-independent-tools.png)

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

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

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

### 3.2 本入剧出(/oneclick)

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

![本入剧出](/qmtv/manual/images/e2e-oneclick.png)

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

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

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

### 3.3 工作台工具集(/workbench)

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

![工作台工具集](/qmtv/manual/images/e2e-workbench.png)

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

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

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

### 3.4 导演工作台(/director3d)

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

![导演工作台](/qmtv/manual/images/e2e-director3d.png)

**做什么**:项目制三级工作台——剧本自动分集 → 资产提取 → 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)

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

![剧本库](/qmtv/manual/images/e2e-library.png)

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

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

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

### 4.2 投稿中心(/studio)

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

![投稿中心](/qmtv/manual/images/e2e-studio.png)

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

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

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

### 4.3 编剧广场(/writers)

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

![编剧广场](/qmtv/manual/images/e2e-writers.png)

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

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

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

### 4.4 作品展示(/showcase)

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

![作品展示](/qmtv/manual/images/e2e-showcase.png)

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

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

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

### 4.5 火花计划(/spark)

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

![火花计划](/qmtv/manual/images/e2e-spark-faq.png)

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

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

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

### 4.6 爆款分析(/viral-analysis)

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

![爆款分析](/qmtv/manual/images/e2e-viral-analysis.png)

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

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

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

### 4.7 剧本评估中心(/evaluation)

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

![剧本评估中心](/qmtv/manual/images/e2e-evaluation.png)

**做什么**:七维评分体系的剧本评估,快速(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)

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

![积分流水](/qmtv/manual/images/e2e-credits.png)

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

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

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

### 5.2 充值(/recharge)

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

![充值](/qmtv/manual/images/e2e-recharge.png)

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

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

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

### 5.3 账号中心(/account)

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

![账号中心](/qmtv/manual/images/e2e-account.png)

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

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

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

---

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

### 6.1 企业管理(/organization)

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

![企业管理](/qmtv/manual/images/e2e-organization.png)

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

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

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

### 6.2 推广与收益(/distribution)

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

![推广与收益](/qmtv/manual/images/e2e-distribution.png)

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

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

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

---

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

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

![管理后台](/qmtv/manual/images/e2e-admin.png)

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

**各 tab 速览**:

| # | Tab | 做什么(关键动作) |
|---|-----|------------------|
| ① | 概览 | 六格统计(用户/任务/图片/视频/发放/消耗)+「运行中任务」(视频生成中/拆解中)实时卡 |
| ② | 用户管理 | 搜索;每行「调整积分」(prompt 正负数+confirm)/「停用·启用」/「重置密码」(prompt ≥8 位)/「设管理员」 |
| ③ | 积分发放 | 选用户+金额+说明「发放」(confirm);「📥 导出积分流水(Excel)」(.csv) |
| ④ | 公告管理 | 「发布公告」(标题+内容)→ 顶栏横幅展示;可停用/启用 |
| ⑤ | 企业审核 | 入驻申请「通过」(自动建组织+任命负责人)/「拒绝」 |
| ⑥ | 提现审核 | 状态机推进:转入审核中→批准打款→(用户确认);「驳回」填原因 |
| ⑦ | 模型配置 | 三用途(文本/图片/视频)各「＋ 添加接入」(OpenAI 兼容:显示名+接口地址+API Key+模型名)→「测试连接」「设为当前使用」;未配置自动走 Mock |
| ⑧ | 计费配置 | 五项:注册试用积分/文本每积分 Tokens/图片单价/视频拉取费/视频每秒积分 |
| ⑨ | 指令版本 | 拆解系统指令多版本管理:「设为生效」「下一次拆解即使用该指令」 |
| ⑩ | 提示词管理 | 各分类(拆解/出图/视频等)自定义提示词版本:编辑/上传 .txt/.md/设为生效/还原内置 |
| ⑪ | 充值审核 | 「收款码设置」上传;订单「通过」(confirm→「已到账 N 积分,返佣已结算」)/「拒绝」(填原因,默认「凭证有误」) |
| ⑫ | 投稿审核 | 「查看全文」「发布到剧本库」「需修改」(填意见)/「驳回」(填原因) |
| ⑬ | 任务审计 | 视频失败记录(「手动退款」confirm)/拆解失败记录(「重试拆解」) |
| ⑭ | 剧本管理 | 批量上传 .txt(文件名即标题)/手动新建全字段/评分(0-5)/封面/上架·下架/删除 |

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

---

## 附录 A 计费速查表

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

| 项目 | 单价 | 可调 |
|------|------|------|
| 注册赠送 | +200 积分 | ✔(trial_credits) |
| AI 拆解(v2) | 按 token:每积分 ≈ 1000 tokens(最少 1 积分) | ✔(text_tokens_per_credit) |
| AI 重新拆解(旧版) | 20/次 | — |
| 分镜图/资产图/图片改创/独立图片 | 10/张 | ✔(image_generation) |
| 2K 预览 | 15/次 | — |
| 分镜视频 | 拉取 5 + 每秒 5×时长 | ✔(video_pull/video_per_second) |
| 独立视频 | 50/条(扁价) | — |
| 一键成片(解说) | 30/次 | — |
| 一键转剧 | 30/集 | — |
| 工作台工具 | 转绘 20 / 去字幕 10 / 转高清 15 | — |
| 融合生图 | 3/张 | — |
| 资产提取 | 10×资产数 | ✔(随图片单价) |
| 打标(单镜/一键) | 10/镜 | — |
| 智能审片 | 10/次 | — |
| 导出成片 | 2/段 | — |
| 配音 | **免费** | — |
| 爆款分析 | 5/次 | — |
| 剧本评估 | 快速 100 / 深度 300(冻结-结算制,失败退) | ✔(eval_cost_quick/deep) |
| 火花计划 | 加入 +100;过审阶梯 100/150/200 | — |
| 充值汇率 | 1 元 = 10 积分 | ✔(credit_per_cny) |
| 分销返佣 | 一级 8% / 二级 2%(到账自动结算) | ✔(commission_rate/level2_rate) |
| 分销开通 | 单笔充值满 980 元自动开通 | ✔(affiliate_threshold_cny) |
| 提现/兑换 | 提现满 100 起提;兑换 1:1 满 10 起兑 | 提现✔(min_withdraw) |
| 通用保障 | 生成失败自动退积分(工作台工具/评估/转剧/分镜视频等) | — |

## 附录 B 常见问题

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

---

反链：

- [使用手册](/qmtv/manual/)
- [QMTV 使用手册 · 文档索引](/qmtv/manual/readme/)
- [人工测试清单(QMTV QA 走查底稿)](/qmtv/manual/%E4%BA%BA%E5%B7%A5%E6%B5%8B%E8%AF%95%E6%B8%85%E5%8D%95/)