xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 8 Pull Requests 4 Actions Packages Projects Releases 7 Wiki Activity
Files
ecfe471ee7f28decaf55ba3794de0bdabe940b94
xiaoxia-saas/docs/task-breakdown-v2.md
T
灵应 bbb4878f58
CI/CD Pipeline / Validate Code Quality And Tests (push) Has been cancelled
Details
CI/CD Pipeline / Frontend Lint (push) Has been cancelled
Details
Deploy / Deploy Staging (push) Has been cancelled
Details
Deploy / Build Production Runtime Images (push) Has been cancelled
Details
Deploy / Deploy Production (push) Has been cancelled
Details
Deploy / Production Browser E2E (push) Has been cancelled
Details
docs: 添加 V21 UI 开发文档和任务拆解文档
2026-06-30 22:17:39 +08:00

631 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
AIGC:
Label: "1"
ContentProducer: 001191110102MACQD9K64018705
ProduceID: 15868733686388_0/project_7655981463858544923-files/docs/task-breakdown-v2.md
ReservedCode1: ""
ContentPropagator: 001191110102MACQD9K64028705
PropagateID: 15868733686388#1782829049594
ReservedCode2: ""
---
# 小虾 SaaS 开发路线图 v2 - 可执行任务拆解
> 文档版本：V2.0
> 生成时间：基于「小虾 SaaS 完整开发路线图 v2」
> 项目 ID：7655981463858544923
---
## 一、总览表
### 1.1 阶段总览
| 阶段 | 名称 | 总人天 | 并行关系 | 关键依赖 |
|------|------|--------|----------|----------|
| **阶段 0** | 收尾确认 | 1 | - | CI 流水线、各 Agent 就绪 |
| **阶段 1** | V21 UI 升级 | 21-29 | 后端可并行 Phase 8 | V21 UI 原型稿 |
| **阶段 2** | Phase 8 模板编排 | 27-30 | 与阶段 3 并行 | V21 UI（部分）、FFmpeg |
| **阶段 3** | CosyVoice 集成 | 17-20 | 与阶段 2 并行 | V21 UI、阿里云 API Key |
| **阶段 4** | 多平台发布 | 24-28 | 依赖阶段 1 完成 | V21 UI、各平台账号 |
| **阶段 5** | Phase 9 智能剪辑 | 30 | 依赖阶段 2 | Phase 8 完成 |
| **总计** | | **120-135** | | |
### 1.2 关键依赖关系图
```
┌─────────────────┐
│ 阶段 0 │ 收尾确认
│ CI + v0.1.101 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 阶段 1 │ V21 UI 升级
│ Sprint 1-4 │
└────────┬────────┘
│
┌──────────────────┼──────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 阶段 2 │ │ 阶段 3 │ │ 阶段 4 │
│ 模板编排引擎 │ │ CosyVoice │ │ 多平台发布 │
│ (后端优先) │ │ (可并行) │ │ (依赖阶段1) │
└────────┬────────┘ └────────┬────────┘ └─────────────────┘
│ │
└────────┬──────────┘
│
▼
┌─────────────────┐
│ 阶段 5 │
│ 智能剪辑 │
│ (依赖阶段2) │
└─────────────────┘
```
---
## 二、阶段 0：收尾确认（当前）
### 2.1 阶段目标
确认 CI 流水线全绿，生产环境 v0.1.101 稳定运行。
### 2.2 前置条件
- 所有开发 Agent 完成角色配置
- CI/CD 流水线正常
- 生产环境可访问
### 2.3 任务列表
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 0.1 | CI 流水线全绿确认 | 部署发布专家 | 无 | 0.5 | P0 | 所有 pipeline 状态为 pass，无红色失败 |
| 0.2 | 生产环境 v0.1.101 稳定运行确认 | 业务服务器运维 | 无 | 0.5 | P0 | API 响应正常，日志无 ERROR，用户反馈正常 |
| 0.3 | 文档对齐确认（分工手册同步） | 灵应（总协调） | 无 | 0 | P1 | 各 Agent 确认分工职责 |
### 2.4 里程碑
- **M0.1**: CI 全绿通过
- **M0.2**: 生产环境 24h 无异常
---
## 三、阶段 1：V21 UI 升级（Sprint 1-4）
### 3.1 阶段目标
1:1 还原 V21 UI 设计原型，统一全局设计系统，完成 20 个前端任务。
### 3.2 前置条件
- V21 UI 原型设计稿（已提供）
- 前端代码库可访问
### 3.3 Sprint 1：基础对齐
#### 任务列表
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 1.1 | 设计系统 CSS 变量统一 | 前端编码 | 无 | 0.5 | P0 | `global.css` 中包含完整 CSS 变量，主题切换正常 |
| 1.2 | 主布局组件 AppLayout | 前端编码 | 1.1 | 1 | P0 | AppLayout 渲染正常，侧边栏+头部+内容区布局正确 |
| 1.3 | 侧边栏组件 Sidebar | 前端编码 | 1.2 | 1 | P0 | 导航菜单可点击，图标正常，当前页面高亮 |
| 1.4 | 页面头部组件 PageHead | 前端编码 | 1.2 | 0.5 | P0 | 标题+面包屑渲染正常，支持响应式 |
| 1.5 | 基础组件封装 | 前端编码 | 1.4 | 2 | P1 | Button/Input/Select/Modal 等组件样式统一 |
#### 里程碑
- **M1.1**: 设计系统 CSS 变量 100% 覆盖
- **M1.2**: 布局组件 3 个（AppLayout/Sidebar/PageHead）完成
---
### 3.4 Sprint 2：核心页面改造
#### 任务列表
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 1.6 | 一键生成页面 | 前端编码 | 1.3, 1.5 | 2 | P1 | 页面完整渲染，表单提交正常，响应式正常 |
| 1.7 | 素材库页面 | 前端编码 | 1.5 | 1.5 | P1 | 素材列表展示，上传/删除功能正常 |
| 1.8 | 配音库页面 | 前端编码 | 1.5 | 1.5 | P1 | 配音列表展示，预览播放正常 |
| 1.9 | 标题库页面 | 前端编码 | 1.5 | 1.5 | P1 | 标题列表展示，复制/编辑功能正常 |
| 1.10 | 成片库页面 | 前端编码 | 1.5 | 2 | P1 | 成片列表展示，播放/下载功能正常 |
#### 里程碑
- **M1.3**: 5 个核心页面（生成/素材/配音/标题/成片）完成度 ≥ 95%
---
### 3.5 Sprint 3：次要页面改造
#### 任务列表
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 1.11 | 控制台页面 | 前端编码 | 1.2 | 1.5 | P2 | Dashboard 数据展示正常，图表渲染正常 |
| 1.12 | 模板库页面 | 前端编码 | 1.5 | 1 | P2 | 模板列表展示，筛选功能正常 |
| 1.13 | 任务历史页面 | 前端编码 | 1.5 | 1 | P2 | 历史任务列表展示，分页功能正常 |
| 1.14 | 订阅管理页面 | 前端订阅 | 1.5 | 1.5 | P2 | 订阅方案展示，升级/续费流程正常 |
| 1.15 | 剪辑计划编辑器 | 前端编码 | 1.5 | 1 | P2 | 基础时间线渲染，支持拖拽排序 |
#### 里程碑
- **M1.4**: 5 个次要页面完成
---
### 3.6 Sprint 4：新增页面
#### 任务列表
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 1.16 | 查重检测页面组 | 前端编码 | 1.5 | 1.5 | P1 | 查重列表/详情/报告页面完整可用 |
| 1.17 | 我的音色页面 | 前端编码 | 1.5 | 1 | P1 | 克隆音色列表展示，预览功能正常 |
| 1.18 | 音色克隆 Modal | 前端编码 | 1.17 | 1 | P1 | 上传音频界面正常，进度展示正常 |
| 1.19 | 账号管理页面 | 前端编码 | 1.5 | 1 | P1 | 平台账号绑定/解绑功能正常 |
| 1.20 | 首页落地页 | 前端编码 | 1.2 | 1 | P3 | 落地页完整展示，CTA 按钮正常 |
#### 里程碑
- **M1.5**: 所有 20 个前端任务完成
- **M1.6**: V21 UI 整体验收通过
---
### 3.7 前后端依赖说明
**V21 UI 升级为纯前端任务**，无后端改动依赖。但部分页面需标注：
| 页面 | 后续功能依赖 | 阶段 2/3 的前置条件 |
|------|-------------|---------------------|
| 剪辑计划编辑器 (1.15) | Phase 8 剪辑编辑器 | 阶段 2 完成后对接 |
| 配音库页面 (1.8) | CosyVoice 升级 | 阶段 3 完成后对接 |
| 我的音色页面 (1.17) | CosyVoice 音色克隆 | 阶段 3 完成后对接 |
| 账号管理页面 (1.19) | 多平台发布 | 阶段 4 完成后对接 |
---
## 四、阶段 2：Phase 8 模板编排引擎
### 4.1 阶段目标
实现剪辑模板管理和自动化编排能力，支持基于素材分类和质量分的智能选片，以及通过 FFmpeg 按 EditPlan 拼接成片。
### 4.2 前置条件
- V21 UI 布局组件就绪
- FFmpeg 已安装（构建/业务服务器）
- 素材库数据模型就绪
### 4.3 任务列表（按模块）
#### 4.3.1 后端任务
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 2.01 | 数据模型：EditTemplate + EditPlan | 后端编程 | 无 | 2 | P0 | SQLAlchemy 模型创建，数据库迁移成功 |
| 2.02 | 数据模型：TemplateClipConfig + EditPlanClip | 后端编程 | 2.01 | 1 | P0 | 嵌套模型定义正确，关联关系正确 |
| 2.03 | API：模板管理 CRUD (`/api/v1/edit-templates`) | 后端编程 | 2.02 | 2 | P0 | GET/POST/PUT/DELETE 接口正常，Swagger 文档更新 |
| 2.04 | API：剪辑计划 CRUD (`/api/v1/edit-plans`) | 后端编程 | 2.02 | 3 | P0 | 计划创建/查询/更新/删除正常 |
| 2.05 | API：剪辑生成 (`/api/v1/edit-plans/{id}/generate`) | 后端编程 | 2.04 | 2 | P0 | 触发生成任务，返回 job_id |
| 2.06 | 服务层：EditTemplateService | 后端编程 | 2.03 | 1 | P0 | 模板 CRUD 业务逻辑正常 |
| 2.07 | 服务层：AutoClipService（智能选片） | 后端编程 | 2.04 | 3 | P0 | 按分类/质量分/时长筛选逻辑正确 |
| 2.08 | 服务层：EditPlanService | 后端编程 | 2.04 | 1 | P0 | 计划状态管理逻辑正常 |
| 2.09 | 服务层：VideoComposeService（FFmpeg 编排） | 后端编程 | 2.07, 2.08 | 4 | P0 | FFmpeg 命令生成正确，视频拼接正常 |
| 2.10 | 服务层：JobService（异步任务） | 任务调度专家 | 2.09 | 2 | P0 | 任务队列正常，进度推送正常 |
| 2.11 | 代码审计：Phase 8 后端 | 代码审计 | 2.01-2.10 | 2 | P0 | 审查报告通过，无高危问题 |
| 2.12 | 安全审计：Phase 8 后端 | 安全审计 | 2.11 | 1 | P1 | 无 SQL 注入/XSS/敏感信息泄露 |
#### 4.3.2 前端任务
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 2.13 | 模板库页面升级 | 前端编码 | 阶段 1 完成 | 2 | P0 | 模板类型展示，模板预览功能正常 |
| 2.14 | 剪辑计划编辑器（完整版） | 前端编码 | 2.03, 2.04 | 3 | P0 | 时间线编辑，素材拖拽，保存/加载正常 |
| 2.15 | 素材选择器优化 | 前端编码 | 2.07 | 1 | P0 | 按分类/质量分筛选，素材预览正常 |
| 2.16 | 预览播放器 | 前端编码 | 2.14 | 1.5 | P1 | 预览播放正常，进度条正常 |
| 2.17 | 生成进度展示 | 前端编码 | 2.10 | 1.5 | P0 | 实时进度展示，状态更新正常 |
| 2.18 | 代码审计：Phase 8 前端 | 代码审计 | 2.13-2.17 | 1 | P0 | 审查报告通过 |
#### 4.3.3 前后端并行说明
| 并行组 | 后端任务 | 前端任务 | 依赖点 |
|--------|---------|---------|--------|
| 组 A | 2.01-2.03（模板数据模型+API） | 2.13（模板库页面） | 前端可先做 UI，后对接 API |
| 组 B | 2.04-2.08（计划 CRUD+服务层） | 2.14-2.15（编辑器+选择器） | 后端先定义 API 契约，前端按契约开发 |
| 组 C | 2.09-2.10（FFmpeg+异步任务） | 2.16-2.17（预览+进度） | 后端先完成 JobService，前端对接 |
### 4.4 里程碑
- **M2.1**: 模板 CRUD API 完成，Swagger 文档更新
- **M2.2**: 剪辑计划 CRUD API 完成
- **M2.3**: FFmpeg 拼接生成视频完整播放
- **M2.4**: 剪辑编辑器前端完整可用
- **M2.5**: Phase 8 整体验收通过
---
## 五、阶段 3：CosyVoice 集成
### 5.1 阶段目标
集成阿里云 CosyVoice 服务，实现高质量 TTS 文字转语音和音色克隆功能。
### 5.2 前置条件
> ⚠️ **用户需配合事项**：
> - 提供阿里云 DashScope API Key
> - 确认阿里云 CosyVoice 服务已开通
> - 提供阿里云 AccessKey ID/Secret（用于 OSS 上传）
### 5.3 任务列表（按模块）
#### 5.3.1 后端任务
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 3.01 | 配置：config.yaml 添加 CosyVoice 配置 | 后端编程 | 无 | 0.5 | P0 | 配置文件包含 api_key、base_url 等配置项 |
| 3.02 | 数据模型：VoiceCloneProfile | 后端编程 | 3.01 | 0.5 | P0 | 模型创建成功，状态字段正确 |
| 3.03 | 数据模型：TTSJob | 后端编程 | 3.02 | 0.5 | P0 | 模型创建成功，关联关系正确 |
| 3.04 | API：配音列表 (`/api/v1/voices`) | 后端编程 | 3.03 | 1 | P0 | 返回预置音色+用户克隆音色 |
| 3.05 | API：音色克隆 (`/api/v1/voice-clones`) | 后端编程 | 3.03 | 2 | P0 | 创建克隆任务，返回 task_id |
| 3.06 | API：TTS 合成 (`/api/v1/tts`) | 后端编程 | 3.04 | 2 | P0 | 发起合成，返回 audio_url |
| 3.07 | 服务层：CosyVoiceService | 后端编程 | 3.05, 3.06 | 5 | P0 | 预置音色列表、克隆、TTS 合成正常 |
| 3.08 | 服务层：音色克隆流程 | 后端编程 | 3.07 | 4 | P0 | 音频上传→API调用→voice_id 返回完整 |
| 3.09 | 代码审计：CosyVoice 后端 | 代码审计 | 3.01-3.08 | 1.5 | P0 | 审查报告通过 |
| 3.10 | 安全审计：CosyVoice 后端 | 安全审计 | 3.09 | 1 | P1 | API Key 加密存储，无敏感信息泄露 |
#### 5.3.2 前端任务
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 3.11 | 配音库页面升级 | 前端编码 | 阶段 1 完成 | 2 | P0 | 预置音色+克隆音色 Tab 分类展示 |
| 3.12 | 克隆音色卡片（我的音色库） | 前端编码 | 3.05 | 1 | P0 | 克隆音色列表，播放/删除功能正常 |
| 3.13 | 克隆 Modal | 前端编码 | 3.12 | 1.5 | P0 | 上传音频/录制功能，进度展示正常 |
| 3.14 | 一键生成对接 | 前端编码 | 3.11 | 1 | P0 | 配音选择支持用户克隆音色 |
| 3.15 | 克隆进度展示 | 前端编码 | 3.08 | 0.5 | P1 | 显示克隆状态（processing/ready/failed） |
| 3.16 | 代码审计：CosyVoice 前端 | 代码审计 | 3.11-3.15 | 1 | P0 | 审查报告通过 |
#### 5.3.3 与阶段 2 并行说明
| 并行关系 | 说明 |
|----------|------|
| 阶段 2 与阶段 3 可并行 | 后端模板编排和 CosyVoice 集成无直接依赖 |
| 前端可同时对接 | 前端完成 V21 UI 后，可同时开发 Phase 8 编辑器和 CosyVoice 页面 |
| 资源冲突注意 | 需协调后端 Agent 时间，避免任务重叠 |
### 5.4 里程碑
- **M3.1**: CosyVoice 配置就绪，API Key 验证通过
- **M3.2**: TTS 合成 API 正常，预置音色可用
- **M3.3**: 音色克隆全流程通（上传→克隆→生成配音）
- **M3.4**: 配音库升级页面完成
- **M3.5**: CosyVoice 整体验收通过
---
## 六、阶段 4：多平台发布
### 6.1 阶段目标
实现视频一键发布到快手、抖音、小红书三大平台（视频号暂不支持）。
### 6.2 前置条件
> ⚠️ **用户需配合事项**：
> - 注册快手开放平台账号并完成认证
> - 注册抖音开放平台账号并完成企业资质认证（需注册资本≥50万）
> - 注册小红书开放平台账号
> - 提供各平台 App Key / App Secret
### 6.3 任务列表（按平台）
#### 6.3.1 平台抽象层（通用）
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 4.01 | 数据模型：PlatformAccount | 后端编程 | 无 | 1 | P0 | 模型创建，Token 加密存储 |
| 4.02 | 数据模型：PublishTask | 后端编程 | 4.01 | 1 | P0 | 发布任务状态机正确 |
| 4.03 | API：平台列表 (`/api/v1/platforms`) | 后端编程 | 4.02 | 0.5 | P0 | 返回支持的平台列表 |
| 4.04 | API：账号管理 (`/api/v1/accounts`) | 后端编程 | 4.01 | 1.5 | P0 | 账号绑定/解绑/查询正常 |
| 4.05 | 服务层：BasePlatformService 抽象 | 后端编程 | 4.03 | 1 | P0 | OAuth/上传/发布接口定义 |
| 4.06 | 服务层：PublishService | 后端编程 | 4.05 | 1 | P0 | 发布任务调度逻辑正常 |
| 4.07 | 代码审计：平台抽象层 | 代码审计 | 4.01-4.06 | 1 | P0 | 审查报告通过 |
#### 6.3.2 快手集成
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 4.11 | 服务层：KuaishouService | 后端编程 | 4.07 | 2 | P0 | OAuth 授权、视频上传、草稿发布正常 |
| 4.12 | API：快手发布 (`/api/v1/publish/kuaishou`) | 后端编程 | 4.11 | 2 | P0 | 创建发布任务，状态同步正常 |
| 4.13 | 前端：账号管理页面完善 | 前端编码 | 阶段 1 完成 | 1 | P0 | 快手账号绑定/解绑 UI 正常 |
| 4.14 | 前端：发布弹窗（快手） | 前端编码 | 4.12 | 1 | P0 | 选择快手，填写标题，发布正常 |
| 4.15 | 错误处理：快手 API | 后端编程 | 4.12 | 0.5 | P1 | Token 过期/上传失败/审核拒绝 正确处理 |
| 4.16 | 代码审计：快手集成 | 代码审计 | 4.11-4.15 | 0.5 | P0 | 审查报告通过 |
#### 6.3.3 抖音集成
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 4.21 | 服务层：DouyinService | 后端编程 | 4.07 | 2.5 | P0 | OAuth 授权、视频上传、内容发布正常 |
| 4.22 | API：抖音发布 (`/api/v1/publish/douyin`) | 后端编程 | 4.21 | 2.5 | P0 | 创建发布任务，状态同步正常 |
| 4.23 | 前端：发布弹窗（抖音） | 前端编码 | 4.14 | 1 | P0 | 选择抖音，填写标题/话题，发布正常 |
| 4.24 | 错误处理：抖音 API | 后端编程 | 4.22 | 1 | P1 | 权限不足/内容违规/频率限制 正确处理 |
| 4.25 | 代码审计：抖音集成 | 代码审计 | 4.21-4.24 | 0.5 | P0 | 审查报告通过 |
#### 6.3.4 小红书集成
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 4.31 | 服务层：XiaohongshuService | 后端编程 | 4.07 | 2 | P0 | OAuth 授权、图片/视频上传正常 |
| 4.32 | API：小红书发布 (`/api/v1/publish/xiaohongshu`) | 后端编程 | 4.31 | 2 | P0 | 创建发布任务，审核状态同步正常 |
| 4.33 | 前端：发布弹窗（小红书） | 前端编码 | 4.14 | 1 | P0 | 选择小红书，填写标题/正文，发布正常 |
| 4.34 | 错误处理：小红书 API | 后端编程 | 4.32 | 1 | P1 | 内容审核拒绝/频率限制 正确处理 |
| 4.35 | 代码审计：小红书集成 | 代码审计 | 4.31-4.34 | 0.5 | P0 | 审查报告通过 |
#### 6.3.5 批量发布功能
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 4.41 | API：批量发布 (`/api/v1/publish/batch`) | 后端编程 | 4.12, 4.22, 4.32 | 2 | P1 | 多平台批量发布，状态分别同步 |
| 4.42 | 前端：批量发布 UI | 前端编码 | 4.14, 4.23, 4.33 | 1 | P1 | 多选平台，一键发布 |
| 4.43 | 发布历史页面 | 前端编码 | 4.13 | 1 | P1 | 发布历史展示，状态筛选正常 |
#### 6.3.6 视频号说明
> ⚠️ **暂不支持**：微信视频号目前暂无视频发布 API，待官方开放后评估。
### 6.4 里程碑
- **M4.1**: 快手集成完成，测试视频发布成功
- **M4.2**: 抖音集成完成，测试视频发布成功
- **M4.3**: 小红书集成完成，测试笔记发布成功
- **M4.4**: 批量发布功能完成
- **M4.5**: 多平台发布整体验收通过
---
## 七、阶段 5：Phase 9 智能剪辑
### 7.1 阶段目标
引入 AI 能力，实现 AI 自动生成标题、AI 智能裁剪、AI 字幕生成。
### 7.2 前置条件
- Phase 8 模板编排完成（必需）
- AI 服务可用（GPT-4/通义千问/阿里云 ASR）
### 7.3 任务列表（按能力）
#### 7.3.1 AI 标题生成
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 5.01 | 数据模型：AITitleSuggestion | 后端编程 | 阶段 2 完成 | 1 | P1 | 模型创建成功 |
| 5.02 | API：生成标题 (`/api/v1/ai/titles`) | 后端编程 | 5.01 | 2 | P1 | 返回 5-10 个标题建议 |
| 5.03 | 服务层：TitleGeneratorService | 后端编程 | 5.02 | 3 | P1 | 调用 LLM 生成营销文案 |
| 5.04 | 前端：AI 标题面板 | 前端编码 | 5.03 | 2 | P1 | 标题列表展示，一键选择/编辑 |
| 5.05 | 代码审计：AI 标题 | 代码审计 | 5.01-5.04 | 0.5 | P1 | 审查报告通过 |
#### 7.3.2 AI 智能裁剪
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 5.11 | 数据模型：SmartCropResult | 后端编程 | 阶段 2 完成 | 1 | P2 | 模型创建成功 |
| 5.12 | API：智能裁剪 (`/api/v1/ai/smart-crop`) | 后端编程 | 5.11 | 3 | P2 | 返回裁剪区域序列 |
| 5.13 | 服务层：SmartCropService | 后端编程 | 5.12 | 5 | P2 | 基于内容理解自动裁剪 |
| 5.14 | 前端：智能裁剪工具 | 前端编码 | 5.13 | 2 | P2 | 可视化裁剪预览，比例切换正常 |
| 5.15 | 代码审计：AI 裁剪 | 代码审计 | 5.11-5.14 | 0.5 | P2 | 审查报告通过 |
#### 7.3.3 AI 字幕生成
| 序号 | 任务 | 负责 Agent | 前置任务 | 预估人天 | 优先级 | 验收标准 |
|------|------|-----------|----------|----------|--------|----------|
| 5.21 | 数据模型：SubtitleTrack + SubtitleSegment | 后端编程 | 阶段 2 完成 | 1 | P1 | 模型创建成功 |
| 5.22 | API：生成字幕 (`/api/v1/ai/subtitles`) | 后端编程 | 5.21 | 2 | P1 | 返回字幕时间轴数据 |
| 5.23 | 服务层：SubtitleService（ASR 集成） | 后端编程 | 5.22 | 4 | P1 | 语音转文字，时序对齐 |
| 5.24 | 前端：字幕编辑器 | 前端编码 | 5.23 | 2 | P1 | 时间轴字幕编辑，样式调整 |
| 5.25 | 代码审计：AI 字幕 | 代码审计 | 5.21-5.24 | 0.5 | P1 | 审查报告通过 |
#### 7.3.4 与阶段 2 依赖说明
| 依赖项 | 说明 |
|--------|------|
| Phase 8 必须完成 | Phase 9 的 AI 能力需要基于 EditPlan/成片进行处理 |
| FFmpeg 拼接依赖 | AI 字幕需要嵌入视频，依赖 FFmpeg 服务 |
| 素材库依赖 | AI 裁剪需要访问原始素材 |
### 7.4 里程碑
- **M5.1**: AI 标题生成功能可用
- **M5.2**: AI 智能裁剪功能可用
- **M5.3**: AI 字幕生成功能可用
- **M5.4**: Phase 9 整体验收通过
---
## 八、部署与验收计划
### 8.1 部署策略
| 阶段 | 部署时机 | 部署目标 | 回滚方案 |
|------|----------|----------|----------|
| 阶段 0 | 立即 | v0.1.101 稳定 | 已有 |
| 阶段 1 | Sprint 4 完成后 | Staging 验证 | Feature Flag |
| 阶段 2 | Phase 8 完成后 | Staging + Production | Feature Flag |
| 阶段 3 | CosyVoice 完成后 | Staging + Production | Feature Flag |
| 阶段 4 | 各平台完成后 | Staging 验证 | Feature Flag |
| 阶段 5 | Phase 9 完成后 | Staging 验证 | Feature Flag |
### 8.2 验收检查清单
#### 阶段 1 验收
| 检查项 | 标准 |
|--------|------|
| CSS 变量 | 覆盖所有设计 token，支持主题切换 |
| 布局组件 | Sidebar/Header/PageHead 渲染正确，响应式正常 |
| 核心页面 | 生成/素材/配音/标题/成片 5 个页面完成度 ≥ 95% |
| 功能回归 | 已有功能不受影响，API 调用正常 |
#### 阶段 2 验收
| 检查项 | 标准 |
|--------|------|
| 模板管理 | CRUD + 模板预览正常 |
| 剪辑计划 | 创建/编辑/保存/删除正常 |
| FFmpeg 拼接 | 生成视频完整播放，无花屏/音画不同步 |
| 自动选片 | 按分类/质量分筛选有效 |
#### 阶段 3 验收
| 检查项 | 标准 |
|--------|------|
| TTS 合成 | 预置音色合成正常，音频清晰 |
| 音色克隆 | 上传音频 → 克隆 → 生成配音 全流程通 |
| 配音库 | 预置+克隆分类展示正常 |
| 一键生成 | 配音选择支持克隆音色 |
#### 阶段 4 验收
| 检查项 | 标准 |
|--------|------|
| OAuth | 各平台授权正常，Token 刷新正常 |
| 视频上传 | 成片上传成功，进度展示正常 |
| 发布 | 视频成功发布到对应平台，链接可访问 |
| 错误处理 | Token 过期/上传失败/审核拒绝 正确提示 |
#### 阶段 5 验收
| 检查项 | 标准 |
|--------|------|
| AI 标题 | 生成 5-10 个标题，可一键应用 |
| AI 裁剪 | 生成多个比例裁剪方案，可预览 |
| AI 字幕 | 字幕时间轴准确，支持编辑和嵌入 |
---
## 九、Agent 工作量汇总
### 9.1 按 Agent 统计
| Agent | 职责 | 阶段 | 预估人天 | 备注 |
|-------|------|------|----------|------|
| **前端编码** | 核心前端开发 | 1, 2, 3, 4, 5 | 25-28 | 订阅页面由前端订阅负责 |
| **前端订阅** | 订阅管理页面 | 1 (Sprint 3) | 1.5 | 阶段 1 期间 |
| **后端编程** | 核心后端开发 | 2, 3, 4, 5 | 38-42 | 含平台抽象层 |
| **代码审计** | PR 代码审查 | 0-5 | 10-12 | 每个阶段多次审查 |
| **安全审计** | 安全扫描 | 2, 3 | 2-3 | 按需触发 |
| **任务调度专家** | 定时任务、队列 | 2 | 2 | Phase 8 JobService |
| **部署发布专家** | CI/CD、合并 | 0-5 | 3-5 | 按阶段部署 |
| **业务服务器运维** | 生产环境 | 0-5 | 3-5 | 按需响应 |
| **构建服务器运维** | CI 基础设施 | 0-5 | 2-3 | 按需响应 |
| **API 文档维护** | 接口文档 | 2, 3, 4, 5 | 3-5 | 按 API 变更更新 |
| **灵应（总协调）** | 协调调度 | 全程 | - | 不计入人天 |
### 9.2 工作量分布图
```
前端编码 ████████████████████████████ 25-28 天
后端编程 ████████████████████████████████████████ 38-42 天
代码审计 ██████████████████████ 10-12 天
部署发布 ██████████████ 3-5 天
其他 Agent ████████████████ 10-16 天
────────────────────────────────────────────────────────
总计 ██████████████████████████████████████████████████ 86-103 天
```
### 9.3 并行执行建议
| 时间段 | 前端任务 | 后端任务 | 说明 |
|--------|---------|---------|------|
| 第 1-4 周 | 阶段 1 Sprint 1-4 | 阶段 2 后端 (2.01-2.10) | 前端 V21 UI，后端 Phase 8 |
| 第 3-6 周 | 阶段 3 前端 (3.11-3.16) | 阶段 3 后端 (3.01-3.10) | CosyVoice 前后端并行 |
| 第 5-8 周 | 阶段 4 前端 (4.13-4.43) | 阶段 4 后端 (4.01-4.35) | 多平台发布 |
| 第 7-12 周 | 阶段 5 前端 (5.04, 5.14, 5.24) | 阶段 5 后端 (5.01-5.23) | AI 智能剪辑（需等阶段 2） |
---
## 十、用户需配合事项清单
> 以下事项需要用户主动配合，否则相关阶段无法推进。
### 10.1 紧急事项（影响阶段 3 启动）
| 事项 | 负责方 | 优先级 | 状态 |
|------|--------|--------|------|
| 提供阿里云 DashScope API Key | 用户 | 🔴 紧急 | ⏳ 待提供 |
| 确认阿里云 CosyVoice 服务已开通 | 用户 | 🔴 紧急 | ⏳ 待确认 |
| 提供阿里云 AccessKey ID/Secret | 用户 | 🔴 紧急 | ⏳ 待提供 |
### 10.2 高优先级事项（影响阶段 4 启动）
| 事项 | 负责方 | 优先级 | 状态 |
|------|--------|--------|------|
| 注册快手开放平台账号 | 用户 | 🟡 高 | ⏳ 待注册 |
| 注册抖音开放平台账号 + 企业认证 | 用户 | 🟡 高 | ⏳ 待注册 |
| 注册小红书开放平台账号 | 用户 | 🟡 中 | ⏳ 待注册 |
| 提供各平台 App Key / App Secret | 用户 | 🟡 高 | ⏳ 待提供 |
### 10.3 中优先级事项（影响体验优化）
| 事项 | 负责方 | 优先级 | 状态 |
|------|--------|--------|------|
| 反馈 V21 UI 原型修改意见 | 用户 | 🟢 中 | ⏳ 待反馈 |
| 提供 FFmpeg 服务器权限 | 用户 | 🟢 中 | ⏳ 待确认 |
### 10.4 需持续关注事项
| 事项 | 负责方 | 说明 |
|------|--------|------|
| 视频号 API 开放动态 | 用户 | 暂不支持，关注官方更新 |
| 各平台政策变化 | 用户 | 抖音/小红书审核政策可能变化 |
---
## 十一、风险提示与缓解措施
| 风险 | 影响 | 缓解措施 |
|------|------|----------|
| 抖音 API 申请被拒 | 高 | 提前准备企业资质，了解申请规范 |
| 小红书审核严格 | 中 | 内容合规性检查，控制发布频率 |
| 视频号无 API | 高 | 持续关注官方动态，暂无替代方案 |
| CosyVoice API 变更 | 低 | 封装服务层，隔离外部依赖 |
| 前端任务延期 | 中 | 拆分为更小的 Sprint，增加人力 |
---
## 附录
### A. 相关文档
| 文档 | 路径/链接 |
|------|-----------|
| V21 UI 开发指令 | `/app/data/所有对话/主对话/frontend-v21-ui-development-plan.md` |
| Agent 分工手册 | `/app/data/所有对话/主对话/recent_memory/project/agent-role-manual.md` |
| 原始路线图 | `/app/data/所有对话/主对话/xiaoxia-development-roadmap-v2.md` |
| 抖音开放平台 | https://open.douyin.com/ |
| 快手开放平台 | https://open.kuaishou.com/ |
| 小红书开放平台 | https://developers.xiaohongshu.com/ |
| 阿里云百炼 CosyVoice | https://help.aliyun.com/zh/model-studio/voice-cloning-user-guide |
### B. 版本历史
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| V2.0 | 2025-01 | 初始版本，基于路线图生成完整任务拆解 |
---
> **文档说明**：本任务拆解基于「小虾 SaaS 完整开发路线图 v2」制定，所有预估人天引用自原路线图文档。实际执行中可根据团队情况调整。
---
> 本内容由 Coze AI 生成，请遵循相关法律法规及《人工智能生成合成内容标识办法》使用与传播。
Reference in New Issue View Git Blame Copy Permalink