# 岁月时书 - 客户端需求文档 V1

> **产品定位**：一款帮助用户（尤其是中老年人）通过 AI 引导对话，将人生故事整理成回忆录的移动应用。

---

## 1. 产品概述

### 1.1 核心价值

- 让每个人都能轻松记录自己的人生故事
- 通过 AI 引导式对话，降低写作门槛
- 自动将对话内容整理成结构化的回忆录
- 提供舒适的阅读和分享体验

### 1.2 目标用户

- 主要用户：中老年人群（50岁以上）
- 次要用户：想要记录家族故事的年轻人
- 使用场景：日常空闲时间、与家人交流后、睡前回忆

### 1.3 设计原则

- 简洁易用：界面清晰，操作简单
- 温暖亲切：配色柔和，文案亲切
- 无压力记录：不强制用户持续输入
- 类微信体验：借鉴熟悉的交互模式

---

## 2. 功能模块

### 2.1 应用架构

```
├── 对话列表（首页 Tab）
│   └── 聊天详情页
├── 回忆录（Tab）
│   ├── 目录页
│   ├── 章节阅读页
│   └── 全文阅读页
└── 我的（Tab）
    ├── 个人信息
    ├── 套餐与付费
    └── 帮助与设置
```

---

## 3. 用户故事

### EPIC 1：对话列表模块

#### US-1.1 查看对话列表

**用户故事**
> 作为用户，我希望打开应用后能看到与AI助手的对话入口，让我快速开始聊天。

**功能要求**
- 应用启动默认进入对话列表页
- 页面标题显示「岁月时书」
- V1 版本仅显示一个默认对话：「回忆录助手」
  - 头像（📖 emoji）
  - 对话标题：回忆录助手
  - 最近一条消息预览（单行省略）
  - 时间戳（刚刚/分钟前/小时前/日期）
- 点击对话项进入聊天详情
- 不支持用户创建新对话（后续版本支持多 Agent）

**界面要素**
- 顶部紫色背景 Header
- 对话列表区域（奶油色背景）
- 底部 Tab 导航栏

#### US-1.2 查看使用提示

**用户故事**
> 作为新用户，我希望看到引导提示，让我知道如何使用这个应用。

**功能要求**
- 对话列表底部显示「小贴士」卡片
- 内容说明应用使用方式
- 卡片样式温和不突兀

---

### EPIC 2：聊天详情模块

#### US-2.1 进入沉浸式聊天

**用户故事**
> 作为用户，我希望进入一个专注的聊天界面，就像在微信里和朋友聊天一样。

**功能要求**
- 顶部导航栏：
  - 返回按钮（圆角方形）
  - 对话标题（居中）
  - 在线状态提示
- 隐藏底部 Tab 导航
- 消息列表支持滚动
- 新消息自动滚动到底部

**界面要素**
- 紫色 Header 区域
- 奶油色消息区域
- 时间分隔线（如"今天 14:30"）

#### US-2.2 发送文字消息

**用户故事**
> 作为用户，我希望能输入文字来讲述我的回忆，就像发微信一样简单。

**功能要求**
- 底部输入区域：
  - 多行文本输入框
  - 输入框自动扩展高度
  - 发送按钮（有文字时激活）
- 用户消息显示为右侧气泡（紫色背景）
- 发送后立即显示（乐观更新）
- 支持键盘弹出时自动调整布局

#### US-2.3 接收 AI 回复

**用户故事**
> 作为用户，我希望 AI 能主动提问和追问，帮助我把记忆说得更完整。

**功能要求**
- AI 消息显示为左侧气泡（白色背景）
- 显示「正在输入…」动画（三个跳动的点）
- AI 回复风格：
  - 温和亲切
  - 引导式提问
  - 适时鼓励和肯定
  - 帮助回忆细节

**AI 引导示例**
- "这个故事真让人感动！😊 能再详细说说当时的场景吗？"
- "听起来是一段珍贵的回忆呢！那个时候您多大年纪？"
- "太有画面感了！这件事对您的人生有什么特别的影响吗？"

#### US-2.4 语音输入

**用户故事**
> 作为用户，我希望能用语音讲述故事，打字太累了。

**功能要求**
- 输入区域显示麦克风图标
- 点击切换到语音输入模式：
  - 按住说话，松开发送
  - 上滑取消发送
  - 显示录音时长和波形动画
- 语音消息发送后：
  - 显示语音气泡（带时长标识）
  - 后端自动转写为文字
  - AI 基于转写文字进行回复
- 支持点击语音气泡播放

**技术要点**
- 使用 Expo AV 进行录音
- 音频格式：AAC / M4A
- 最长录音时长：60秒
- 上传至 OSS 后发送消息

**已知限制（待补方案）**
- 若长语音采用“边录边分段上传”，用户点击“取消录音”时，只能停止后续录制与后续切片上传。
- 对于已经上传到服务端的分段，当前系统没有“整段作废/整轮撤销”的服务端丢弃机制。
- 因此，现阶段无法严格保证“取消录音 = 本次整段语音完全不进入 ASR/Agent”。
- 后续若要支持该语义，需要服务端增加基于 `voice_session_id` 的撤销/丢弃能力，并确保已上传分段不会继续进入转写、聚合和 AI 回复链路。

#### US-2.5 图片发送（后续版本）

**用户故事**
> 作为用户，我希望能发老照片来丰富我的故事。

**功能要求（后续版本）**
- 输入区域显示更多（+）图标
- 点击提示「功能开发中」
- V2 版本支持从相册选择或拍照

---

### EPIC 3：回忆录模块

#### US-3.1 查看回忆录目录

**用户故事**
> 作为用户，我希望看到我的对话被整理成一本有章节的书，让我有成就感。

**功能要求**
- 页面标题显示「回忆录」
- 书籍信息卡片：
  - 书名（如"这一生"）
  - 副标题（如"我的回忆录"）
  - 最后更新时间
- 章节列表：
  - 章节编号和标题
  - 章节状态指示：
    - ✅ 完整（complete）
    - 🔄 部分完成（partial）
    - ⏳ 待开始（pending）
  - 页数显示（可选）

**章节示例**
1. 童年与家庭 ✅
2. 上学的日子 🔄
3. 工作与事业 ⏳
4. 爱情与婚姻 ⏳

#### US-3.2 阅读单个章节

**用户故事**
> 作为用户，我希望能像读书一样阅读已整理好的章节内容。

**功能要求**
- 点击章节进入阅读模式
- 页面切换动画（从右滑入）
- 顶部导航：
  - 返回目录按钮
  - 更多操作按钮（...）
- 章节内容展示：
  - 章节标题
  - 正文内容（舒适排版）
  - 支持段落引用样式
- 滚动阅读体验

#### US-3.3 阅读全文

**用户故事**
> 作为用户，我希望能一口气读完整本回忆录，而不是一章章点开。

**功能要求**
- 目录页显示「阅读全文」浮动按钮
- 点击进入全文阅读模式
- 按章节顺序展示所有内容
- 章节之间有分隔

#### US-3.4 导出与分享（占位功能）

**用户故事**
> 作为用户，我希望能把回忆录分享给家人或导出成 PDF 打印。

**功能要求（V1 占位）**
- 阅读页更多菜单：
  - 导出 PDF 选项
  - 分享选项
- 点击后提示「功能开发中」

---

### EPIC 4：个人中心模块

#### US-4.1 查看个人信息

**用户故事**
> 作为用户，我希望在一个地方看到我的账户信息，知道自己是谁。

**功能要求**
- 个人信息展示：
  - 头像（图标占位）
  - 昵称
  - 当前套餐标识（如"免费体验版"）

#### US-4.2 套餐与付费

**用户故事**
> 作为用户，我希望知道如何升级获得更多功能。

**功能要求**
- 套餐设置区块：
  - 升级套餐入口
  - 我的订单入口
- 点击后提示「功能开发中」

#### US-4.3 帮助与支持

**用户故事**
> 作为用户，我希望遇到问题时能找到帮助。

**功能要求**
- 帮助区块：
  - 常见问题入口
  - 反馈与客服入口
  - 关于我们入口
- 底部显示版本号

---

## 4. 界面设计规范

### 4.1 配色方案

| 颜色名称 | 色值 | 使用场景 |
|---------|------|---------|
| Deep Purple | #200028 | 深色文字、强调元素 |
| Medium Purple | #6B4C7C | 主题色、Header 背景、按钮 |
| Slate Purple | #6A6478 | 次要文字 |
| Lavender | #E8E0EC | 浅色背景、分隔线 |
| Cream | #FAF8F5 | 主要内容区背景 |
| White | #FFFFFF | 卡片背景、气泡背景 |

### 4.2 字体规范

- 大标题：32px, 600 weight
- 页面标题：24px, 600 weight
- 正文：15-16px, 400 weight
- 辅助文字：12-13px, 400 weight

### 4.3 间距规范

- 页面边距：20px
- 卡片内边距：16px
- 元素间距：8-12px
- 圆角：12-16px

### 4.4 交互规范

- 点击反馈：activeOpacity 0.7-0.8
- 页面切换：300ms 滑动动画
- 加载状态：骨架屏或加载指示器

---

## 5. 技术要求

### 5.1 技术栈

- 框架：React Native + Expo
- 路由：Expo Router
- 动画：React Native Reanimated
- 图标：@expo/vector-icons (Ionicons)

### 5.2 兼容性要求

- iOS：14.0+
- Android：API Level 24+ (Android 7.0+)

### 5.3 性能要求

- 首屏加载：< 2s
- 页面切换：< 300ms
- 消息发送响应：< 100ms（本地）

---

## 6. V1 功能清单

### 核心功能 ✅

- [x] 对话列表展示
- [x] 对话详情与消息交互
- [x] 文字消息发送
- [x] 语音消息发送（录音 + 转写）
- [x] AI 自动回复（真实 LLM）
- [x] 回忆录目录展示
- [x] 章节内容阅读
- [x] 全文阅读模式
- [x] 个人中心基础信息

### 后续版本功能 ⏳

- [ ] 图片发送与 AI 理解
- [ ] PDF 导出
- [ ] 分享功能
- [ ] 套餐升级与付费
- [ ] 用户登录/注册

---

## 7. 后续迭代方向

### V1.1 增强功能

- 图片消息发送与 AI 理解
- 回忆录编辑功能
- 流式 AI 回复（打字机效果）

### V1.2 多 Agent 支持

- 支持创建多个对话
- 不同功能的 AI 助手（如：故事整理助手、照片回忆助手等）
- 对话管理（删除、归档）

### V1.3 社交功能

- 分享到微信/朋友圈
- 家庭成员协作
- 回忆录评论

### V2.0 完整体验

- 用户登录注册
- 付费套餐系统
- PDF/实体书导出
- 多语言支持