---
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 生成，请遵循相关法律法规及《人工智能生成合成内容标识办法》使用与传播。
