blind/任务文档_v2收尾.md

# 林夏 v2 收尾任务文档

## 一、游戏开发任务

### G1: 手势系统升级 — gestures.js

**现状**: 仅支持 6 种手势（单击/双击/四方向滑动），无长按、无多指手势  
**目标**: 新增长按(1s)、两指长按(暂停)、三指点击(退出)

**交付物**:
- 长按检测：touchstart 后 1000ms 无移动 → emit `longpress`
- 两指长按检测：两指同时触屏 1000ms → emit `twofinger_longpress`
- 三指点击检测：三指同时触屏后抬起 → emit `threefinger_tap`
- touchmove 监听：移动超阈值取消长按
- 键盘映射：L=长按, P=暂停, Q=退出

**测试case**:
1. 单指按住 1.5s 不动 → 触发 longpress，不触发 singletap
2. 单指按住 0.3s 抬起 → 触发 singletap，不触发 longpress
3. 单指按住后滑动 → 触发 swipe，不触发 longpress
4. 双指按住 1.5s → 触发 twofinger_longpress
5. 双指快速点击（<1s）→ 不触发任何事件（忽略）
6. 三指同时触屏后抬起 → 触发 threefinger_tap
7. 键盘 L/P/Q 分别触发对应事件

---

### G2: 变量系统补全 — engine.js

**现状**: 使用 `UNREAD` 变量，缺少 `REPLY_COUNT`  
**目标**: 添加 `REPLY_COUNT`，在玩家做出非沉默选择时递增

**交付物**:
- `vars` 对象新增 `REPLY_COUNT: 0`
- `_handleChoice()` 中非沉默选择时 `REPLY_COUNT++`
- 结局 C 判定改用 `REPLY_COUNT <= 2`

**测试case**:
1. 选择右滑(温暖) → REPLY_COUNT 递增 1
2. 选择下滑(沉默, isSilence=true) → REPLY_COUNT 不变
3. 双击跳过选择 → REPLY_COUNT 不变
4. 全程极少回复(REPLY_COUNT<=2) + 全部已读 → 触发结局 C

---

### G3: 长按手势处理 — engine.js

**现状**: 无长按处理  
**目标**: playing/choosing 状态重播当前消息音频；其他状态广播未读数

**交付物**:
- `_onLongPress()` 方法
- playing/responding/reacting → 中断当前播放，重播 currentMsg.audio
- choosing → 重播 currentMsg.audio（不退出选择状态）
- idle/notification → TTS 播报 "当前未读 N 条消息"

**测试case**:
1. playing 状态长按 → 当前语音重头播放
2. choosing 状态长按 → 重播 NPC 问题，仍可继续选择
3. idle 状态长按 → TTS 播报未读数
4. ending 状态长按 → 无反应

---

### G4: 暂停/退出机制 — engine.js

**现状**: 无暂停/退出功能  
**目标**: 两指长按暂停，单击恢复，三指点击退出

**交付物**:
- 新状态 `paused`
- `_onPause()`: 保存当前状态、停止所有音频/震动、TTS 播报暂停提示
- `_onResume()`: 恢复到 choosing/idle（语音无法断点续播）
- `_onExit()`: 仅 paused 状态可用，TTS 播报感谢后返回开始页
- hint 栏显示暂停状态提示

**测试case**:
1. playing 状态两指长按 → 音频停止，进入 paused，TTS 播报暂停
2. paused 状态单击 → 恢复游戏
3. paused 状态三指点击 → 退出到开始页
4. 非 paused 状态三指点击 → 无反应
5. ending 状态两指长按 → 无反应（结局不可暂停）

---

### G5: 选择状态语音提示 — engine.js

**现状**: 进入 choosing 仅播放 choiceReady 音效 + confirm 震动  
**目标**: 追加 TTS 播报 "等待回复"

**交付物**:
- `_enterChoosing()` 中 SFX_UI.choiceReady() 后追加 TTS.speak('等待回复')

**测试case**:
1. 播放完 NPC 语音进入选择 → 听到 "叮" + TTS "等待回复"
2. 快速双击跳过 → TTS 被中断，不卡住

---

### G6: 结局语音化 — engine.js

**现状**: 结局使用 `_showCaption(text)` 显示视觉文字（与零视觉设计矛盾）  
**目标**: 结局台词通过 TTS 朗读（后续替换为预录音频）

**交付物**:
- `_endingA/B/C/D/E` 中 `_showCaption(text)` → `TTS.speak(text)`（保留 caption 作为补充）
- 结局 E 周南语音播完后 TTS 说 "好"

**测试case**:
1. 触发结局 A → 听到水壶声 + TTS "明天再说"
2. 触发结局 D → 听到鸟鸣声 + TTS "早上好"
3. 触发结局 E → 周南语音 + TTS "好"
4. TTS 不可用时 → caption 仍然显示（降级方案）

---

### G7: 内容安全 — engine.js + index.html

**现状**: 无内容预警和求助信息  
**目标**: 游戏开始前播报内容预警，结局后显示心理支持热线

**交付物**:
- `start()` 开头：TTS 播报 "本游戏涉及孤独、家庭关系等情感话题，请在舒适的状态下体验"
- 结局播完后：TTS 播报 "如需倾诉，全国心理援助热线 400-161-9995"
- index.html 开始页添加内容预警文字

**测试case**:
1. 游戏启动 → 先听到内容预警，再开始环境音
2. 任意结局完成后 → 听到热线播报
3. 开始页可见内容预警文字

---

### G8: 分支补全 — story.js

**现状**: MSG-10/11 follow-up 缺少沉默(down)选项  
**目标**: 补全所有未闭合分支

**交付物**:
- MSG-10 right follow-up: 添加 down(沉默) 选项
- MSG-10 up follow-up: 添加 down(沉默) 选项
- MSG-11 up follow-up: 添加 down(沉默) 选项

**测试case**:
1. MSG-10 温暖回复后 → 可选右滑/上滑/下滑（沉默）
2. MSG-10 追问后通话 → 可选右滑/上滑/下滑（沉默）
3. MSG-11 追问后 → 可选右滑/左滑/下滑（沉默）

---

### G9: 操作指南更新 — index.html

**现状**: 开始页操作说明缺少长按和安全手势  
**目标**: 补充完整操作说明

**交付物**:
- 添加 "播放中" 长按重播说明
- 添加 "随时可用" 安全手势分组（两指长按暂停、三指点击退出）

**测试case**:
1. 开始页显示完整操作说明，含长按和安全手势

---

## 二、音频制作任务（需 VoxCPM2 服务）

### A1: 结局旁白音频

**现状**: 结局台词无预录音频，依赖 TTS  
**目标**: 用林夏声线生成 5 条结局旁白

**交付物** (5 个 MP3):
| 文件名 | 台词 |
|---------|------|
| `v2_ending_a_linxia_wav_v1.mp3` | "明天再说。" |
| `v2_ending_b_linxia_wav_v1.mp3` | "寄出去了。" |
| `v2_ending_c_linxia_wav_v1.mp3` | "今晚就这样。" |
| `v2_ending_d_linxia_wav_v1.mp3` | "早上好。" |
| `v2_ending_e_linxia_wav_v1.mp3` | "好。" |

**测试case**:
1. 每个文件 < 3s，采样率 24kHz+，音色一致
2. 语气匹配情境（A 疲惫温柔、D 平静、E 轻快）

---

### A2: 系统提示音频

**现状**: 无系统提示预录音频  
**目标**: 生成游戏流程中的系统语音提示

**交付物** (4 个 MP3):
| 文件名 | 台词 |
|---------|------|
| `v2_sys_wait_reply_wav_v1.mp3` | "等待回复" |
| `v2_sys_paused_wav_v1.mp3` | "游戏已暂停。单击继续，三指点击退出" |
| `v2_sys_content_warning_wav_v1.mp3` | "本游戏涉及孤独、家庭关系等情感话题，请在舒适的状态下体验" |
| `v2_sys_hotline_wav_v1.mp3` | "如需倾诉，全国心理援助热线 400-161-9995" |

**测试case**:
1. 音色使用林夏声线，语速适中
2. 暂停提示 < 5s，内容预警 < 8s

---

### A3: 新增分支台词音频

**现状**: MSG-10/11 补全的 down 分支缺音频  
**目标**: 生成沉默后 NPC 反应音频

**交付物** (3 个 MP3):
| 文件名 | 角色 | 台词 |
|---------|------|------|
| `v2_msg10_rw_react_silent_wav_v1.mp3` | 妈妈 | "那早点睡啊。" |
| `v2_msg10_call_react_down_wav_v1.mp3` | 妈妈 | "……没事就好。早点睡。" |
| `v2_msg11_r3_react_silent_wav_v1.mp3` | 阿哲 | "行吧，那我不来了。" |

**测试case**:
1. 音色与对应角色现有音频一致
2. 语气自然，符合上下文

---

### A4: MSG-16 后期处理

**现状**: seg5-6 是奶奶无声电话的描述段，需要电话底噪叠加  
**目标**: 与 MSG-08 未知号码呼吸声使用匹配的底噪

**交付物**:
- `lv11_0200_mom_voice_01_seg5_wav_v1.mp3` 叠加电话底噪
- `lv11_0200_mom_voice_01_seg6_wav_v1.mp3` 叠加电话底噪

**测试case**:
1. seg5-6 可听到轻微电话底噪（与 MSG-08 sfx_breathing_unknown_v1.mp3 风格匹配）
2. 底噪不盖过妈妈说话声（底噪 -18dB 以下）

---

## 三、执行顺序

```
阶段一（代码 — 立即执行）:
  G1 → G2 → G3/G4/G5 → G6 → G7 → G8 → G9

阶段二（音频 — 需 VoxCPM2）:
  A1 → A2 → A3 → A4

阶段三（集成）:
  结局音频替换 TTS → 系统提示音替换 TTS → 回归测试
```