Xiaoxia AI
10 KiB
小虾 SaaS 功能升级优化路线图
状态：生效中
基线版本：v0.1.14
制定时间：2026-06-23
负责人：小虾 🦐
1. 背景
旧版桌面剪辑软件已经形成了一套以“剪辑工作台”为核心的本地自动剪辑经验：素材库、智能分类、素材缺口诊断、标题库、批量生成、成片历史、错误诊断与自动修复。
SaaS 版目前已经打通 MVP 主链路：登录、工作空间、项目、素材上传、异步处理、真实 FFmpeg 生成、成片下载、生产发布与基础权限边界。下一阶段的重点不是继续临时堆功能，而是把旧版软件中真正有价值的剪辑经验，按标准化、模块化方式迁移到 SaaS。
2. 总目标
把小虾 SaaS 从“能上传素材并生成 MP4 的 MVP”升级为“具备素材诊断、标题资产、成片管理、任务追踪、模板编排和智能增强能力的自动剪辑平台”。
核心原则：
- 文档先行，开发前明确需求、接口、页面、测试、验收、发布。
- 模块隔离，素材、标题、生成、成片、任务、权限分别设计和验收。
- 不做假入口，未实现能力必须显示“暂未开放”或禁用。
- 长任务必须异步，必须有状态、进度、失败原因和重试策略。
- 每次上线必须通过本地测试、CI、生产 smoke 和真实用户主链路验收。
- 生产机不得承担构建任务，生产发布必须使用预构建产物和镜像。
3. 当前基线
3.1 已验证生产能力
- 账号注册、登录、登录态清理。
- 工作空间与项目管理。
- 项目级素材库。
- 单文件与批量上传。
- 上传后异步 ingest job。
- 真实 FFmpeg 生成 MP4。
- 成片下载。
- 基础权限边界：匿名、非成员访问项目/素材/上传会被拦截。
- 生产发布链路：runtime-builder 构建，生产机加载镜像和产物。
- 未开放功能显式“暂未开放”。
3.2 旧版核心能力差距
- 缺少素材智能视图：推荐、慎用、高风险、未使用、最近使用、待复核。
- 缺少素材准备度和缺口诊断。
- 缺少完整标题库：分类、常用、使用次数、自动选标题。
- 缺少成熟成片历史、封面预览、复核流和批量下载。
- 缺少统一任务中心：上传、分类、生成、下载任务状态与日志。
- 缺少速度/均衡/质量优先、多候选生成和筛选策略。
- 缺少模板驱动的剪辑计划预览。
- 缺少 ASR 字幕、TTS 配音、BGM 混音、转场包装和脚本到剪辑计划。
4. 阶段路线
阶段 0：生产稳定与现状冻结
目标：确认当前 SaaS MVP 稳定可用，避免后续升级带着旧问题滚雪球。
步骤：
- 固定当前生产基线版本和能力清单。
- 真实浏览器跑通：登录 → 工作空间 → 项目 → 批量上传 → 生成 → 下载。
- 收集所有截图、错误文案、卡顿、失败提示。
- 按账号、项目、素材、任务四个维度定位根因。
- 更新当前发布表面文档，明确可用和不可用功能。
验收标准：主链路真实用户可完成一次完整生成并下载 MP4。
阶段 1：旧版功能拆解成 SaaS 模块
目标：把旧版桌面软件能力拆成 SaaS 可开发模块，禁止散落开发。
模块划分：
- 素材中心：视频素材库、配音素材库、批量上传、素材分类、智能视图、缺口诊断。
- 标题中心：标题库、标题分类、常用标题、使用次数、自动选标题。
- 剪辑生成中心：生成模式、生成数量、生成质量、多候选生成、进度、停止、重试。
- 成片中心：成片列表、封面预览、下载、批量下载、复核状态、生成参数回放。
- 任务中心：上传任务、分类任务、生成任务、失败原因、日志追踪、可重试。
- 权限与审计：工作空间成员权限、素材权限、成片权限、任务权限、操作记录。
验收标准：每个旧版功能都有明确 SaaS 模块归属、数据对象、页面入口和验收标准。
阶段 2：素材中心升级
目标：优先迁移旧版“素材智能诊断”，这是区别普通剪辑工具的核心能力。
步骤：
- 设计素材扩展字段：素材类型、分类、风险分、质量分、使用次数、最近使用时间、复核状态。
- 明确分类结果属于 project、asset_library、asset 三层中的哪一层。
- Worker 上传后自动分类：口播、场景、待复核。
- 增加智能视图接口：全部、口播、场景、待复核、推荐、慎用、高风险、未使用、最近使用。
- 前端素材页增加筛选标签、统计摘要和复核状态。
- 增加素材缺口诊断接口，输出准备度分数、问题、建议。
- 前端增加“素材诊断”面板。
验收标准：用户上传一批素材后，系统能告诉用户“够不够剪、缺什么、哪些素材慎用、哪些素材推荐使用”。
阶段 3：标题库升级
目标：把旧版标题库迁移成团队和项目可复用的内容资产。
步骤：
- 设计标题表：workspace_id、project_id、title、category、favorite、use_count。
- 后端实现标题增删改查。
- 实现标题搜索、分类筛选、常用标题。
- 实现“自动选一个”逻辑：优先常用、低使用次数、匹配项目分类。
- 生成页接入标题库选择。
- 生成成功后更新标题使用次数。
验收标准：用户可以维护标题资产，生成时可手选或自动选择标题，不需要每次手填。
阶段 4：成片中心升级
目标：让生成结果可管理，而不是只生成一个下载链接。
步骤：
- 设计成片状态：生成中、成功、失败、待复核、可发布。
- 保存生成参数：素材库、标题、模式、数量、模板、时间。
- 生成结果增加封面图或首帧预览。
- 前端成片页展示列表、预览、下载、失败原因。
- 增加批量下载。
- 增加“标记为可发布/需复核”。
验收标准：用户能回看历史成片，知道每条视频怎么生成、能不能发布，并可批量处理结果。
阶段 5：任务中心与错误追踪
目标：所有长任务都可追踪、可解释、可重试。
步骤：
- 统一任务模型：upload、classify、generate、download/export。
- 统一状态：queued、running、completed、failed、cancelled。
- 每个任务保存进度、当前步骤、失败类型、原始错误、用户提示。
- 前端增加任务中心入口。
- 失败任务支持重试。
- 所有用户可见错误都必须映射成人话提示。
验收标准：任何失败都能回答四句话：哪一步失败、为什么失败、能不能重试、用户该怎么办。
阶段 6：Phase 8 模板与编排引擎
目标：从“黑盒生成视频”升级为“模板驱动的剪辑计划”。
步骤：
- 设计模板模型：模板名称、场景结构、素材要求、时长规则、标题规则。
- 设计 EditPlan：一次生成前先形成剪辑计划。
- 设计 EditPlanClip：每个片段对应素材、开始时间、持续时间、转场、音频。
- 自动选片：根据素材分类、风险、质量、使用次数选择素材。
- 前端增加剪辑计划预览。
- 用户确认后再执行 FFmpeg 生成。
- 生成结果绑定模板和剪辑计划。
验收标准：用户能看到“系统准备怎么剪”，确认后再生成，而不是黑盒随机生成。
阶段 7：Phase 9 智能增强
目标：补齐真正智能剪辑能力。
步骤：
- ASR 字幕：识别配音或视频语音，生成字幕。
- TTS 配音：文本生成配音，未配置服务时 UI 不开放。
- BGM 混音：背景音乐、音量 ducking、淡入淡出。
- 转场包装：片段间转场、片头片尾、水印。
- 脚本到剪辑计划：输入脚本，生成素材需求和剪辑结构。
- 智能推荐：根据素材库情况推荐模板和生成策略。
验收标准：小虾从“视频生成工具”升级成“智能剪辑助理”。
阶段 8：权限、安全与商业化准备
目标：为正式商业 SaaS 做底座。
步骤：
- 扫权限边界：素材列表、成片下载、生成任务、标题库、任务日志。
- 工作空间成员权限细化：owner、admin、member、viewer。
- 操作审计：上传、删除、生成、下载、邀请成员。
- 配额体系：素材容量、生成次数、并发任务、存储周期。
- 订阅和账单继续保持“暂未开放”，等后端完整后再启用。
验收标准：多人使用不会越权，资源可计量，后续可接商业化。
5. 开发包顺序
- 生产 UAT 问题清零与当前能力冻结。
- 素材智能视图与素材缺口诊断。
- 标题库。
- 成片中心。
- 任务中心。
- 模板与剪辑计划。
- ASR、TTS、BGM、转场智能增强。
- 权限、审计、配额、商业化底座。
6. 每个开发包必须交付的内容
每个开发包必须包含：
- 需求说明。
- 数据模型设计。
- API 设计。
- 前端页面设计。
- Worker/异步任务设计，如适用。
- 权限边界说明。
- 错误提示与失败处理说明。
- 单元测试和集成测试。
- 前端 type-check 和 build。
- 生产 smoke 或手工验收记录。
- 发布说明和回滚点。
7. 禁止事项
- 禁止未设计数据模型就直接写页面。
- 禁止后端未实现时前端假成功。
- 禁止把长任务做成同步阻塞接口。
- 禁止跳过 workspace/project/member 权限校验。
- 禁止生产机承担 Web/API/Worker 构建。
- 禁止未经 smoke 就说生产完成。
- 禁止把旧版功能散落迁移，必须归入模块和开发包。
8. 最近下一步
立即执行：
- 完成生产 UAT：登录 → 工作空间 → 项目 → 批量上传 → 生成 → 下载。
- 记录所有真实问题。
- 补充
docs/SAAS-UPGRADE-EXECUTION-CHECKLIST.md。 - 开始第一个正式开发包：生产 UAT 问题清零与当前能力冻结。