# AI有声书 v2 - UX优化 - 主计划

> 状态: ACTIVE
> 创建: 2026-05-07
> 更新: 2026-05-07
> 团队: audiobook-v2-ux (frontend-dev, backend-dev, reviewer)
> 决策记录: .plans/audiobook-v2-ux/decisions.md

---

## 1. 项目概述

AI 有声书 v2 用户体验优化，基于 2026-05-07 全面页面审查。38 个功能已全部完成，本次优化不改动核心业务逻辑，聚焦用户体验提升。

**工作范围**：
- 前端：my-uniapp-vue3/
- 后端：server/

**优化项**：18 项（OPT-01 ~ OPT-18），分 4 个优先级

---

## 2. 文档索引

| 文档 | 位置 | 内容 |
|------|------|------|
| 架构 | docs/architecture.md | 系统组件、数据流、技术栈 |
| API 契约 | docs/api-contracts.md | 前后端接口定义 |
| 不变量 | docs/invariants.md | 不可违反的系统边界 |

---

## 3. 阶段概览

### 优化项分布

| 优先级 | 数量 | 优化项 |
|--------|------|--------|
| P0 必须优化 | 3 | OPT-01 按钮合并, OPT-02 轮询超时, OPT-03 首页最近收听 |
| P1 重要优化 | 5 | OPT-04 简洁模式, OPT-05 睡眠定时器, OPT-06 全局骨架屏, OPT-07 生成按钮固定, OPT-08 一键完整生成 |
| P2 体验提升 | 6 | OPT-09 封面升级, OPT-10 手势切换, OPT-11 我的页动态化, OPT-12 反馈页面, OPT-13 套餐动画, OPT-14 全局过渡 |
| P3 锦上添花 | 4 | OPT-15 热词缓存, OPT-16 返回按钮, OPT-17 歌词时间轴, OPT-18 确认弹窗 |

### 实施路线图

- **第一阶段**：P0 紧急修复（预计 8h）
  - Day 1: OPT-02（轮询超时修复，2h）
  - Day 2: OPT-01（操作按钮合并，3h）
  - Day 3: OPT-03（首页最近收听，3h）

- **第二阶段**：P1 重要优化（预计 14h）
  - Day 4-5: OPT-04（创建书籍简洁模式，4h）
  - Day 5: OPT-05（睡眠定时器，2h）
  - Day 6: OPT-06（全局骨架屏，3h）
  - Day 6: OPT-07（生成按钮固定，1h）
  - Day 7-8: OPT-08（一键完整生成，4h）

- **第三阶段**：P2 体验提升（预计 8.5h）
  - Day 9: OPT-09（封面升级，2h）+ OPT-14（全局动画，1.5h）
  - Day 9-10: OPT-10（手势切换，2h）+ OPT-13（套餐动画，1h）
  - Day 10: OPT-11（我的页面动态卡片，2h）+ OPT-12（反馈页面，2h）

- **第四阶段**：P3 锦上添花（预计 6h）
  - Day 11: OPT-15 + OPT-16 + OPT-17 + OPT-18

---

## 4. 任务汇总

| # | 任务 | 负责人 | 状态 | 计划文件 |
|---|------|--------|------|----------|
| P0-1 | OPT-02 轮询超时修复 | backend-dev | pending | .plans/audiobook-v2-ux/backend-dev/task-opt02/ |
| P0-2 | OPT-01 按钮合并 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt01/ |
| P0-3 | OPT-03 首页最近收听 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt03/ |
| P1-1 | OPT-04 创建书籍简洁模式 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt04/ |
| P1-2 | OPT-05 睡眠定时器 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt05/ |
| P1-3 | OPT-06 全局骨架屏 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt06/ |
| P1-4 | OPT-07 生成按钮固定 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt07/ |
| P1-5 | OPT-08 一键完整生成 | frontend-dev + backend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt08/ |
| P2-1 | OPT-09 封面升级 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt09/ |
| P2-2 | OPT-10 手势切换 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt10/ |
| P2-3 | OPT-11 我的页动态化 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt11/ |
| P2-4 | OPT-12 反馈页面 | frontend-dev + backend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt12/ |
| P2-5 | OPT-13 套餐动画 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt13/ |
| P2-6 | OPT-14 全局过渡 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt14/ |
| P3-1 | OPT-15 热词缓存 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt15/ |
| P3-2 | OPT-16 返回按钮修复 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt16/ |
| P3-3 | OPT-17 歌词时间轴 | frontend-dev + backend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt17/ |
| P3-4 | OPT-18 确认弹窗 | frontend-dev | pending | .plans/audiobook-v2-ux/frontend-dev/task-opt18/ |

---

## 5. 后端配套变更

| 优化项 | 后端变更 |
|--------|----------|
| OPT-02 | WebSocket 推送生成完成事件 |
| OPT-03 | 提供用户最近播放记录 API |
| OPT-08 | POST /api/book-generator/batch-generate 编排接口 |
| OPT-12 | POST /api/feedback 反馈提交接口 |
| OPT-17 | TTS 生成时返回 LRC 格式时间戳 |

---

## 6. 当前阶段

**当前**：P0 阶段 - OPT-02 轮询超时修复（backend-dev）
