digital-psychology/.ai/product/feature-spec/cece-frontend-re/complete-design/99-emulator-validation.md

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

启动与截图：

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 中单独列「合规替换」列，避免把禁词写进产品文案。