# 99 · 安卓模拟器采集验证协议

> 设计已定稿；本文件规定**如何用模拟器把 🟡/待证项变成 ✅ 或 Diff 回写**。

---

## 1. 目标

1. 对照 `complete-design` 各页的 **校验 ID（V-\*）** 采集证据。  
2. 差异写入 Diff 表 → 回写对应设计文档 / OpenAPI。  
3. 不阻塞当前 Feature Complete：未验证项保持「设计定稿 (D) + 待模拟器」。

---

## 2. 环境准备

| 项 | 建议 |
|---|---|
| 模拟器 | Android Emulator API 33+，安装官方测测 APK（或应用商店包） |
| 代理 | mitmproxy / Charles；模拟器 Wi‑Fi 代理指向宿主机 |
| HTTPS | 安装 user CA；若 SSL Pinning 失败则改用 UI 录屏 + 布局层次（uiautomator） |
| 账号 | 新号 + 会员号各一；记录手机号不入库文档 |
| 录制 | 每条 V-\* 至少：截图 1 +（可选）HAR 片段 + 操作步骤 |

### 2.1 本机已装（2026-08）

| 项 | 路径 / 名称 |
|---|---|
| SDK | `ANDROID_HOME=/opt/homebrew/share/android-commandlinetools` |
| AVD | `YuXinGu_API34`（Pixel 7 / API 34 / google_apis / arm64） |
| Agent Skill | `/Users/jack/tools/android-adb-skill` → `./tools/android` + `~/.claude/skills/android-*` |
| Cursor Rule | `.cursor/rules/android-adb.mdc` |
| 冒烟截图 | `.tmp/cece-validation/smoke/screen.png` |

启动与截图：

```bash
emulator -avd YuXinGu_API34 -no-audio -gpu auto &
adb wait-for-device
./tools/android screenshot --out .tmp/cece-validation/smoke/screen.png --json
```

> 测测 APK 仍需另行安装后，才能跑 Batch A–D。

证据目录建议（本地，勿强求进 git）：

```
.tmp/cece-validation/
  YYYYMMDD/
    V-H01/
      steps.md
      screen.png
      traffic.har   # 可选
```

---

## 3. 采集步骤（单条 V-\*）

1. 打开设计文档中的校验 ID 定义（预期 UI/文案/API）。  
2. 冷启动 App → 按步骤复现到目标屏。  
3. 截图；若可抓包，过滤 host，保存相关 request/response。  
4. 填写结果：`PASS` / `DIFF` / `BLOCKED`（如 pinning、地区限制）。  
5. `DIFF` 必须写：期望（设计）vs 实际 + 建议改设计或改实现。

---

## 4. 优先级批次

### Batch A — 五 Tab 骨架（先做）

| ID | 主题 | 文档 |
|---|---|---|
| V-H01～ | 首页楼层顺序与运营位 | `10-page-home` |
| V-G01～ | 消息分类与未读 | `11-page-message` |
| V-A01～ | 问一问 AI/人工切换 | `12-page-ask` |
| V-L01～ | 连麦/在线列表 | `13-page-online` |
| V-U01～ | 我的列表与资产条 | `14-page-mine` |

### Batch B — 星座与合盘

| ID | 主题 | 文档 |
|---|---|---|
| V-N01～ | 本命轮盘与锁点 | `20-module-astrology` |
| V-S01～ | 五图顺序、邀请、附近默认 | 同上 |
| V-F01～ | 日运字段 | 同上 |

### Batch C — 测评与沉浸

| ID | 主题 | 文档 |
|---|---|---|
| V-T01～ | 测评进度与结果锁 | `21-module-tests-immersive` |
| V-P01～ | 广场 | 同上 |
| V-B01～ / V-M01～ / V-R01～ | 沙盘/小镇/塔罗 | 同上 |

### Batch D — 商业与系统

| ID | 主题 | 文档 |
|---|---|---|
| V-O01～ | 会员价与支付 | `40-ops-commerce` |
| 路径对照 | API 与 30 章一致性 | `30-data-api` |

---

## 5. Diff 登记表（模板）

复制到当次验证笔记：

| ID | 结果 | 期望（设计） | 实际（模拟器） | 处置 | 回写文件 |
|---|---|---|---|---|---|
| V-S01 | DIFF | 五图顺序 A-B-C… | 顺序为… | 改设计 / 改实现 | `20-module-astrology.md` |

处置约定：

- **改设计**：以竞品真机为准，更新 complete-design，证据链加 E\*。  
- **改实现**：愈心谷已按设计开发则排期对齐。  
- **忽略**：明确合规/品牌差异（词表），在文档标「刻意差异」。

---

## 6. 与 Evidence First 的衔接

- 模拟器截图/HAR → 记入 `cece-frontend-re/README.md` 证据表新行（E8+）。  
- 原 🟡 项验证通过后改为 ✅，去掉「仅设计定稿」标注。  
- 完整设计包门禁：**不**因未跑模拟器而撤销 Design Complete。

---

## 7. 愈心谷侧注意

验证测测时允许看到其原生产物用词；**落地愈心谷 UI 时仍走词表**，Diff 中单独列「合规替换」列，避免把禁词写进产品文案。