feat: P1 合盘/星座/问答与测测完整设计包及模拟器取证工具
落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
jackyu66git
@@ -0,0 +1,131 @@
|
||||
# 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 中单独列「合规替换」列，避免把禁词写进产品文案。
|
||||
Reference in New Issue
Block a user