00 · 交接导览（先读我）

Mon, 01 Jan 0001 00:00:00 +0000

本目录是 QMTV 项目开发文档集，面向开发/运维的同事。建议按顺序阅读，全程约 30 分钟即可建立完整认知并跑起项目。

项目速览卡

项	值
项目名	QMTV — AI 短剧智能生产线
位置	`D:\WORK\GAE\qmtv`（本目录）
技术栈	Node.js 22 + Express 5 + better-sqlite3（后端）；Vue 3 + Vue Router 4 + Vite 8（前端）；无 UI 框架，自研主题
启动	`npm install` → `npm start`（后端 :3300 并托管前端 dist）→ `npm run build`（构建前端）
数据库	`data/qmtv.db`（SQLite WAL，49 张表，免安装）
规模	后端 24 个模块 / 5436 行，239 个 API；前端 24 个页面 / 约 9000 行
设计文档（历史全量）	`D:\WORK\GAE\QMTV网站设计文档.md`（22 节，按 v1→v22 版本演进记录每一步设计决策与实测结论）

文档地图

文档	内容	什么时候读
01-系统设计方案.md	产品定位、功能全景、各模块设计方案、数据模型、计费模型、AI 链路设计、视觉体系	想理解"为什么这样设计"
02-系统架构介绍.md	技术栈、目录结构、后端模块职责、前端结构、49 张表清单、关键机制（SSE/供应商适配/启动恢复）、构建部署	想理解"代码怎么组织的"
03-系统开发说明.md	环境准备、启动步骤、账号、日常开发操作指南（加页面/加接口/加表）、验证方法、踩坑清单、运维注意	动手开发前必读
04-待开发功能与规划.md	真实模型接入清单、已知欠账与改进项、建议优先级	排后续开发计划
05-API接口速查手册.md	全部 239 个 API 按模块分组	写代码时当字典查

30 分钟上手路径

（5 分钟）读本文档 + 02-系统架构介绍.md 的目录结构一节
（5 分钟）npm install，两个终端分别 npm start 和 npm run dev（前端热更 :5173，代理到 :3300）
（5 分钟）用制片账号登录 producer@xingmang.cn / demo123456，把主导航每一页点一遍；再用管理员 admin@qmtv.com / admin123456 看管理后台
（10 分钟）读 03-系统交接说明.md 的「常见开发任务怎么做」与「踩坑清单」
（5 分钟）浏览 04-待开发功能与规划.md，确定你的第一个任务

三条最重要的经验（先记住再说）

发中文请求调试一律写 Node 脚本（仓库里有大量 verify_*.js 可参照），不要用 curl/heredoc——Git Bash 下中文会 GBK 损坏，曾数次被误判为 bug。
数据库是SQLite 单文件，改表结构统一走 server/db.js 的 migrations 数组（ALTER TABLE ... ADD COLUMN，try/catch 幂等），不要手改已有 CREATE TABLE。
所有生成动作都走积分：先 tryDeduct 再调 providers.imageSmart/videoSmart，失败退款由 providers 内部统一负责，调用方不要重复退款。生成类入口只此一个约定，接手时务必遵守。

QMTV 移植契约规格（PRD）v1

Mon, 01 Jan 0001 00:00:00 +0000

文档定位：本文是 qmtv 后端 Go+MySQL 移植的需求契约唯一权威——以冻结版 Node 实现（qmtv/server/，2026-10-17）的实际行为为基准逐条登记，外加已裁决的修正项。Go 版若与本文不符，以本文为准；本文与冻结代码不符处=修正项章节。上游设计参照：qmtv/docs/01-系统设计方案.md（冻结）。

01 · 系统设计方案

Mon, 01 Jan 0001 00:00:00 +0000

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

前端技术对比：qmtv（Vue3）vs pms web（React18+AntD5）

Mon, 01 Jan 0001 00:00:00 +0000

文档定位：回答"前端不改写是确定的，但两套前端技术各有什么优劣"。结论前置：qmtv 前端零改动（已裁决）；本文是选型对比存档 + 为 Go 移植钉住前端兼容面 + 沉淀"若未来前端演进，哪些 pms 经验值得吸收"。事实基线：2026-10-17 双仓库实测。

04 · 待开发功能与规划

Mon, 01 Jan 0001 00:00:00 +0000

本文供排期参考。分四类：A 真实模型接入（最高价值）、B 产品功能补强、C 生产化改造、D 技术债与优化。每项标注预估规模（S≤1天 / M≤3天 / L>3天）与前置依赖。

产品 on QMTV 产品文档

00 · 交接导览（先读我）

项目速览卡

文档地图

30 分钟上手路径

三条最重要的经验（先记住再说）

QMTV 移植契约规格（PRD）v1

01 · 系统设计方案

前端技术对比：qmtv（Vue3）vs pms web（React18+AntD5）

04 · 待开发功能与规划