# 13 · 真机验收结果记录模板

> **填写前必读（硬规则）**
>
> 1. **没有测过的项必须填 `未验证`，不能留白，也不能填 `通过`。**
> 2. 只填你**亲眼看到**的。听说的、推测的、别人转述的，一律不算，写进"问题描述"里并标注来源。
> 3. 每一项都记下**你实际看到的数字或文字**（例如顶栏显示的是 `每分钟 +10.0` 还是别的）。
> 4. 截图请存到同一个目录，文件名写进本表。建议命名 `shot-<项号>-<短描述>.png`。
> 5. 官方模拟器的结果和真机的结果**分开填**（本模板给每个测试环境各留一份）。
> 6. 结果只有三种取值：`通过` / `失败` / `未验证`。**不要写"大概通过""基本可以"。**
> 7. 操作步骤见 `docs/12-真机与官方模拟器验收手册.md`。

---

## 一、环境信息

### 1.1 测试环境 A：微信开发者工具 · 官方模拟器

| 项目 | 填写 |
|---|---|
| 测试环境 | 微信开发者工具 官方模拟器（不是替身宿主） |
| 开发者工具版本号 | |
| 操作系统 / 版本 | |
| AppID 类型 | ☐ 正式小游戏 AppID　☐ 小游戏测试号　☐ `touristappid`（产物自带）　☐ 其它： |
| AppID（可打码后 4 位） | |
| 基础库版本（详情 → 本地设置 → 调试基础库） | |
| 模拟器机型 / 尺寸设置 | |
| 测试日期 | |
| 测试人 | |
| 是否改动过产物文件 | ☐ 未改动　☐ 改动过（说明：） |

### 1.2 测试环境 B：真机

| 项目 | 填写 |
|---|---|
| 机型（例如 iPhone 15 Pro / 小米 14） | |
| 系统版本（例如 iOS 18.2 / Android 15） | |
| 微信版本 | |
| 基础库版本（vConsole 的 WeChat 页里看） | |
| 设备像素比 / 分辨率（若能看到） | |
| `benchmarkLevel`（Android 才有；可在 vConsole 里看） | |
| 是否带刘海 / 灵动岛 | ☐ 是　☐ 否 |
| 开发者工具版本号（打包上传用的那个） | |
| AppID 类型 | ☐ 正式小游戏 AppID　☐ 小游戏测试号　☐ `touristappid`（产物自带）　☐ 其它： |
| 进入方式 | ☐ 预览扫码　☐ 真机调试扫码　☐ 体验版 |
| 测试日期 | |
| 测试人 | |
| 网络环境（Wi-Fi / 4G / 5G） | |

### 1.3 产物指纹（导入前先核对）

在电脑上执行：`sha256sum game.js game.json project.config.json MANIFEST.json`（在 `dist/wechat/` 目录下）

| 文件 | 期望 SHA256 | 实测 SHA256 | 是否一致 |
|---|---|---|---|
| `game.js` | `7185453263687c277f293c2b01d7992c1e70450b2c33a3944a724974635d2517` | | ☐ 一致 ☐ 不一致 |
| `game.json` | `82526622d158db584fe0783eb469d01eaaa33a85360c28d83bf2b01cb031b8ec` | | ☐ 一致 ☐ 不一致 |
| `project.config.json` | `113e97a6b1b13773e91d5aec0aa9b9441a4c81667b1e5f074b0e2f088b770094` | | ☐ 一致 ☐ 不一致 |
| `MANIFEST.json` | `e72bcdca5a8413df123cb71d1333bb413935adf370e45c73a39ae6ed11da6f65` | | ☐ 一致 ☐ 不一致 |

---

## 二、逐项结果

**结果取值：`通过` / `失败` / `未验证`。没测的必须写 `未验证`。**

建议**每个测试环境各复制一份本表**填写（模拟器一份、真机一份），不要混在一张表里。

| # | 检查项 | 预期（应看到什么） | 结果 | 实测记录 / 备注 | 截图文件名 |
|---|---|---|---|---|---|
| 1 | 首屏：城市与资源栏 | 竖屏浮空岛 + 城市；顶栏 `Lv1`、金币 `0.0`、`每分钟 +10.0`、`声望` 与 `可用 0 · 寻访 0` | | | |
| 2 | 单指拖动旋转 | 岛屿跟随旋转，松手有惯性；不触发寻访/升级 | | | |
| 3 | 双指缩放 | 平滑缩放（设计范围 0.62×～1.45×）；不误触发点击 | | | |
| 4 | 点击**居民** → 寻访 | 飘字 `+3 金币`、`+1 声望`；金币 +3.000；`可用`、`寻访` 各 +1；无冷却、无上限 | | | |
| 5 | 点击**市政厅** | 走升级入口（不是寻访）：金币够则扣费升级，不够则提示缺口 | | | |
| 6 | 点击道路 / 岛边 / 树 / 云 / 天空 | **什么都不发生** | | | |
| 7 | 拖动后松手 | 不触发寻访（位移 >10px 触摸 / >8px 鼠标，或 >600ms，或出现第二指） | | | |
| 8 | 连续快速点击升级入口 | 每次都单独生效，不被面板阻断，逐次扣费升级 | | | |
| 9 | 金币不足时点升级 | toast `金币不足，还差 N 金币`；按钮变灰 `需要 20 金币 · 还差 N 金币`；**金币一分不扣、等级不变** | | | |
| 10 | Lv1→Lv2 后的速率与下次费用 | toast `市政厅升至 Lv.2 · 每分钟 +12.0`；顶栏 `每分钟 +12.0`；底栏 `升级市政厅 → Lv.3` + `花费 25 金币` | | | |
| 11 | 进后台再回前台 → 离线收益 | 弹面板：`欢迎回来，岛主！` / `你离开了 <时长>` / `+<收益>` / `离线收益（已自动入账）` / `市政厅 Lv.1` / `每分钟 +10.0` / `结算后金币 <数>` / `收下` | | | |
| 11a | 离线 1 小时（Lv1）的数值 | 收益正好 **+600 金币**（600000 毫币） | | | |
| 12 | 第二次回前台 | **不再弹面板**，不再加金币（同一区间只结算一次） | | | |
| 13 | 完全退出后重新打开 | 不补发离线金币 | | | |
| 14 | 重启后存档保留 | 等级 / 金币 / 声望 / 寻访与关闭前一致 | | | |
| 15 | 帧率观察 | 主观流畅；Android 微信 7.0.7+ 开发版/体验版可用 `胶囊按钮 → 开发调试 → 打开性能监控面板` 看客观数据 | | | |
| 16 | 发热 | 记录 10～15 分钟后的主观感受（凉 / 温 / 烫）与时间点 | | | |
| 17 | 文字遮挡 / 重叠 | 顶栏、底栏、`Lv.N 市政厅` 牌、飘字、toast、离线面板文字均完整可读 | | | |
| 18 | 刘海屏适配 | 顶栏不被刘海 / 状态栏 / 圆角遮挡（**已知风险项**：代码未读 `safeArea`） | | | |
| 19 | 运行期网络请求 | 无任何第三方请求 | | | |
| 20 | 反复前后台组合 | 不重复发钱、不漏发 | | | |
| 21 | 存档状态卡 | 正常：绿点 + `已保存` / `自动存档`；失败：红点 + `存档失败` / `请稍后重试` + toast | | | |
| 22 | Console 无报错 | 启动与操作过程中无红色报错 | | | |
| 23 | Console 指纹日志 | 5 条 `[fingerprint] ... OK` + `all OK` + 一行含 `platform=wechat` | | | |
| 24 | 其它（自行补充） | | | | |

### 2.1 补充项（如果做了就填，没做填 `未验证`）

| # | 检查项 | 结果 | 备注 | 截图文件名 |
|---|---|---|---|---|
| S1 | 上传代码（需要正式 AppID） | | | |
| S2 | 设为体验版并在另一台手机打开 | | | |
| S3 | 真机调试窗口中的 Console / Sources 面板可用 | | | |
| S4 | vConsole 在真机上可打开并看到日志 | | | |
| S5 | 官方性能监控面板（Android 微信 7.0.7+）可用 | | | |

---

## 三、问题描述

每个问题单独一行（或一段），不要合并。严重程度用 `P0`（阻塞，必须马上处理）/ `P1`（严重，影响验收结论）/
`P2`（一般，可记录后继续）/ `P3`（轻微，纯体验）。

| 编号 | 严重程度 | 对应检查项 # | 现象（客观描述） | 复现步骤 | 期望 vs 实际 | 截图 / 日志文件名 |
|---|---|---|---|---|---|---|
| Q1 | | | | | | |
| Q2 | | | | | | |
| Q3 | | | | | | |

**判定提示：**
- 如果出现"**离线收益被重复发放**"或"**存档丢失**"，请直接记为 **P0**，停止测试并把时间点、截图、vConsole 日志一起交上来。
- 如果第 18 项（刘海屏）被遮挡，记为 **P1 或 P2**（这是已知风险项，见 `docs/12` §3.4）。

---

## 四、截图清单

| 文件名 | 对应检查项 # | 内容说明 | 拍摄/截图时间 |
|---|---|---|---|
| `shot-01-firstscreen.png` | 1 | | |
| | | | |
| | | | |

**截图规范（尽量做到）：**
- 首屏、离线面板、升级成功、升级金币不足，各至少一张。
- 真机截图请**带上系统状态栏**（这样才能看出刘海遮挡）。
- 文件名用英文/数字，避免空格。

---

## 五、原始记录粘贴区

把下面这些**原始内容**原样粘进来（不要改写、不要只写摘要）：

1. **官方模拟器 Console 全文**（从编译开始到操作结束）：
```
（粘贴在这里）
```

2. **真机 vConsole 日志全文**：
```
（粘贴在这里）
```

3. **真机调试窗口"信息视图"里的手机信息**（型号 / 系统 / 微信版本 / 通信延时）：
```
（粘贴在这里）
```

4. **性能监控面板 / PerfDog 的原始数据**（如果测了）：
```
（粘贴在这里）
```

5. **导入时工具的任何提示 / 警告原文**：
```
（粘贴在这里）
```

---

## 六、结论

| 项目 | 填写 |
|---|---|
| 官方模拟器：通过项数 / 失败项数 / 未验证项数 | __ / __ / __ |
| 真机：通过项数 / 失败项数 / 未验证项数 | __ / __ / __ |
| 是否存在 P0 | ☐ 无　☐ 有（编号：） |
| 是否发现与契约数值不符 | ☐ 无　☐ 有（说明：） |
| 是否发现与 `docs/12` §3.3 的差异说明不一致 | ☐ 无　☐ 有（说明：） |
| **本环境是否可以判定 0.1 验收通过** | ☐ 可以（全部项通过或合理豁免）　☐ 不可以（有失败项）　☐ 无法判定（仍有未验证项） |
| 测试人签字 / 日期 | |

> **注意**：只要还有**未验证**项，就不要写"可以判定验收通过"。
> 未验证就是未验证，它不是通过。

---

## 七、附：可以照抄的空白表

如果要在多台设备上分别测试，把下面这段复制多份。

```
================ 测试环境：________（模拟器 / 真机） ================
机型：________   系统版本：________   微信版本：________
基础库版本：________   开发者工具版本：________
AppID 类型：________   测试日期：________   测试人：________

#1  首屏（城市+资源栏）        → 结果：________   截图：________   备注：
#2  单指拖动旋转               → 结果：________   截图：________   备注：
#3  双指缩放                   → 结果：________   截图：________   备注：
#4  点击居民寻访（+3金币/+1声望）→ 结果：________   截图：________   备注：
#5  点击市政厅（升级入口）      → 结果：________   截图：________   备注：
#6  点击道路/岛边/树/云/天空     → 结果：________   截图：________   备注：
#7  拖动不触发寻访             → 结果：________   截图：________   备注：
#8  连续点击升级入口           → 结果：________   截图：________   备注：
#9  金币不足不扣费             → 结果：________   截图：________   备注：
#10 Lv2 速率 12/分钟、下次费用 25→ 结果：________   截图：________   备注：
#11 离线收益面板               → 结果：________   截图：________   备注：
#11a 离线1小时=+600金币         → 结果：________   截图：________   备注：
#12 二次回前台不重复结算        → 结果：________   截图：________   备注：
#13 完全退出重开不补发          → 结果：________   截图：________   备注：
#14 重启后存档保留             → 结果：________   截图：________   备注：
#15 帧率观察                   → 结果：________   截图：________   备注：
#16 发热                       → 结果：________   截图：________   备注：
#17 文字遮挡/重叠              → 结果：________   截图：________   备注：
#18 刘海屏适配                 → 结果：________   截图：________   备注：
#19 运行期无第三方请求          → 结果：________   截图：________   备注：
#20 反复前后台组合             → 结果：________   截图：________   备注：
#21 存档状态卡                 → 结果：________   截图：________   备注：
#22 Console 无报错             → 结果：________   截图：________   备注：
#23 Console 指纹日志           → 结果：________   截图：________   备注：

问题记录：
  Q1 [P_] 项#__：________________________________________
  Q2 [P_] 项#__：________________________________________

结论：通过 __ / 失败 __ / 未验证 __
===================================================================
```
