# 04 · 待开发功能与规划

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

---

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

## A. 真实 AI 能力接入（拿到 Key 后第一优先）

| # | 事项 | 规模 | 说明 |
|---|---|---|---|
| A1 | 文本模型接入验证 | S | 管理后台填 Key→测试连接→设为当前；验证 LLM 拆解/评估/审片三条链路自动升级（llm.isAvailable 分支已就绪） |
| A2 | 图片模型接入验证 | S | 验证 /images/generations 兼容性（比例→尺寸映射在 providers.generateImageReal）；重点测 9:16 竖屏 |
| A3 | 视频模型接入验证 | M | 异步任务型接口已在 providers 适配（提交+轮询+下载），需用真实供应商联调：超时（15min）、同步 url 直返、错误码三类路径 |
| A4 | 智能审片 Vision 升级 | M | 当前审片文本摘要式；接入 Vision 模型（图片入参）做真正的画面级审片——reviewShots 已预留 engine 标注与回退 |
| A5 | 成本核账 | S | 真实接入后校准计费配置（管理后台计费设置），对照供应商定价调整 积分/张、积分/秒 |

**验收清单（A1-A3 通用）**：拆解→出图→渲染→导出全链路真实素材走通；失败退款正确（故意填错 Key 验证）；SSE 通知到达；项目积分记录与账实一致。

## B. 产品功能补强（对标差距已清零后的深化）

| # | 事项 | 规模 | 说明 |
|---|---|---|---|
| B1 | 剧本超市独立市集页 | M | 当前投稿过审剧本混在 /library 市集与管理端；可拆独立「剧本超市」页（购买/订阅制、按播放分成是巨日禄未做完的方向） |
| B2 | 作品展示公开化 | S | /showcase 目前需登录；可开放匿名浏览 + 作者主页聚合其作品 |
| B3 | 素材权限矩阵落地执行 | M | 五项权限已存储+联动，但 asset_library 接口未按权限拦截（仅管理语义）；需在共享素材读取/上传/删除处校验成员 material_perms |
| B4 | 成员独立配额 | M | organizations.credit_allocation_mode 已有 pooled/independent 字段但未实现 independent 分支（成员配额 quota 列闲置） |
| B5 | 手机号登录/找回 | M | 账号中心已留占位；需接短信服务商 + users.phone 列 + 登录分支 |
| B6 | 邮箱验证/找回密码 | M | 改邮箱已做（密码验证）；找回密码需邮件服务 |
| B7 | 剧本库 tier 分级 | S | 新版 GAE 有 premium/free 分级；script_library 可加 tier 列 + 市集页筛选项 |
| B8 | 批量任务中心 | M | 全自动渲染/批量生成目前同步逐笔；量大后建议落任务队列（DB 表 + 轮询即可，不必上 MQ）+ 独立任务中心页 |
| B9 | 移动端适配 | M | 现有断点仅保证不烂；拆解台/视频页在小屏的体验需专项优化 |
| B10 | 运营位体系 | S | 首页 hero 可配置化（公告已有，扩为运营位：banner/活动入口），管理端配置 |

## C. 生产化改造（上生产环境前必做）

| # | 事项 | 规模 | 说明 |
|---|---|---|---|
| C1 | 数据库迁移 SQLite→MySQL/PG | L | better-sqlite3 同步 API 遍布全栈；建议先做 SQL 方言审计（当前用大量 SQLite 特有 datetime('now','localtime') 与字符串拼接 IN），或短期维持 SQLite+定时备份（小团队可接受） |
| C2 | 对象存储 | M | data/files 本地盘 → OSS/S3（assets.js saveUpload 与 providers.finishVideo 两处写入点收敛良好，改造成本可控） |
| C3 | 进程守护与水平扩展 | M | pm2/容器 + 健康检查；SSE 与限流是进程内存态，多实例需改 Redis（bus 与 rateLimit 两处） |
| C4 | 日志与监控 | S | stdout → 文件轮转（如 pino）；关键指标（生成成功率/退款率/供应商耗时）打点 |
| C5 | HTTPS 与域名 | S | 部署层（nginx/caddy）解决；注意 SSE 需要 proxy_buffering off |
| C6 | 支付对接 | L | 充值目前人工转账+凭证审核；接微信/支付宝需订单回调 + 幂等入账（recharge.js approve 逻辑可复用） |
| C7 | 安全加固 | M | 密码强度策略、接口幂等键、上传文件类型魔数校验、管理端操作审计日志（credit_records 已有雏形） |
| C8 | 备份自动化 | S | data/ 定时备份脚本 + 异地存储 |

## D. 技术债与优化

| # | 事项 | 规模 | 说明 |
|---|---|---|---|
| D1 | index.js 拆分 | S | 824 行主入口可拆出 auth/tasks/videos/admin 四个模块，降低合并冲突 |
| D2 | 测试体系 | M | 现有 verify_*.js 是冒烟脚本；建议引入 vitest，把 verify 场景转成断言用例（后端纯函数/路由层） |
| D3 | 前端组件抽取 | M | 弹层/表格/标签在多页重复，可抽 BaseModal/BaseTable；三主题变量已就绪 |
| D4 | 旧表清理 | S | providers 表（旧供应商管理）已无路由引用，可归档；exchanges 兑换功能未接 UI |
| D5 | providers.js 真实供应商矩阵 | M | 当前视频适配只验证过一类异步接口；多供应商（字段名差异）可加 adapter 映射表 |
| D6 | 国际化 | L | 全部中文硬编码；海外市场卖点（评估七维含海外适配）落地前需 i18n |

## 建议节奏

1. **第一周**：A1+A2+A3（真实接入验证）+ C8 备份 —— 把"演示态"变"真实态"
2. **第二周**：A4 审片 Vision + A5 成本核账 + D1 拆 index.js
3. **之后按业务方向二选一**：To B 深耕 → B3/B4/C6（权限落地+独立配额+在线支付）；To C 生态 → B1/B2/B7（市集与社区）
4. **上生产前**：C1-C5 按 C3（单机 pm2 + SQLite 维持）或 C1（多实例）两条路线二选一

## 已知问题（截至交接）

- 无 P0/P1 级 bug；以下为已记录的低优先观察项：
  - 提交拆解无 Key 时同步返回（量大会占连接），有 Key 后自然变为异步
  - 限流内存桶重启清零（C3 一并解决）
  - 作品墙/共享项目列表分页上限 60/默认（量大需翻页）
  - 移动端仅断点兜底（B9）

---

反链：

- [产品](/qmtv/product/)