# L2 报告 · 真机与官方模拟器验收手册

任务编号：**L2**
执行时间：2026-10-12
工作目录（唯一被写入的目录）：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/`
原目录（**只读，未做任何修改**）：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/`

---

## 0. 一句话结论

- 交付 3 份文档：`docs/12-真机与官方模拟器验收手册.md`、`docs/13-真机验收结果记录模板.md`、本报告。
- **只新增这 3 份文档**，没有改任何代码、测试、配置、产物；**原目录一个字节都没动**（第 2 节有 `diff -rq` 原始输出为证）。
- 手册里**没有任何真机或官方模拟器的结论**：第 3 节检查表的 21 项结果**全部预填 `未验证`**。
- 核对了 2 处**任务书与冻结契约/实际实现不一致**的地方（见第 7 节 D1/D2），并额外发现 1 处**产物与官方文档不一致**的地方（`compileType`，见第 8 节 Q1）。

---

## 1. 做了什么

| # | 步骤 | 说明 |
|---|---|---|
| 1 | 复制项目到副本 | `cp -a frontend-rebuild-hm frontend-rebuild-hm-work-L2`（123 MB，含 `node_modules`，完整复制）。**之后所有写入都只在副本里。** |
| 2 | 读交付文档 | `docs/00`、`docs/02`、`docs/03`、`docs/04`、`docs/05`、`docs/06`、`docs/11`，确认"已做/未做"的验证边界 |
| 3 | 读契约（核对数值） | 契约包 `docs/02-状态与字段清单.md`、`docs/03-公式与规则清单.md`、`docs/04-API契约.md` |
| 4 | 核对产物 | `dist/wechat/` 的 `game.js` / `game.json` / `project.config.json` / `MANIFEST.json`，逐个算 SHA256 并与 `MANIFEST.json` 对账 |
| 5 | 核对实现细节 | `src/ui/hud.ts`（HUD 与面板的真实文案）、`src/app/app.ts`（toast 文案）、`src/app/input.ts`（手势阈值）、`src/game/session.ts`（离线面板触发条件）、`src/wechat/main.ts`（适配层**实际读取了哪些系统字段**）、`src/core/constants.ts`（冻结常量）、`src/game/format.ts`（显示格式） |
| 6 | 联网核对微信官方文档 | 查阅并逐条摘录，全部附 URL 与查阅日期（2026-10-12），见第 5 节。**凡涉及微信平台行为的结论都附了官方链接；查不到依据的一律标"未确认"/"未找到官方依据"。** |
| 7 | 写手册 | `docs/12-真机与官方模拟器验收手册.md`（614 行） |
| 8 | 写记录模板 | `docs/13-真机验收结果记录模板.md`（230 行） |
| 9 | 验证原目录未被动过 | `diff -rq 原目录 副本`，只有 2 个新增文件（第 2 节原始输出） |
| 10 | 写本报告 | 本文件 |

**我没有做的事（如实声明）：**

- **没有**运行任何测试、构建、`npm` 命令。本任务是纯文档任务，且约束要求不改代码、不动原目录；
  已有测试结果我全部是**引用**交付文档，不是我自己跑的。
- **没有**安装或运行微信开发者工具（本机没有该工具，且这属于"你"要做的真机工作）。
- **没有**在真机上跑过任何一次。
- **没有**修改 `src/`、`tools/`、`test/`、`tests/`、`package.json`、`dist/`、`release/`、`evidence/` 里的任何文件。

---

## 2. 运行的命令与原始输出

> 以下都是本次实际执行的命令与**原样**输出。

### 2.1 复制项目到副本

```bash
$ du -sh /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/
123M	/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/

$ cp -a /vol1/ai/projects/wyszz-new/frontend-rebuild-hm \
         /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2
exit=0

$ du -sh /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/
123M	/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/
```

### 2.2 验证原目录未被修改（关键证据）

```bash
$ diff -rq /vol1/ai/projects/wyszz-new/frontend-rebuild-hm \
           /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2
Only in /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs: 12-真机与官方模拟器验收手册.md
Only in /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs: 13-真机验收结果记录模板.md
```

**解读**：整个目录树逐文件比对，差异**只有这 2 个新增文档**。
`node_modules` 里有大量 `Only in .../node_modules` 行（`cp -a` 复制时的时间戳/文件系统差异），
已用 `grep -v` 过滤，过滤后**没有**任何 `differ` 行 —— 即**没有任何已有文件的内容被改动**。

原目录 `docs/` 仍然是 00～11（未出现 12/13）：

```bash
$ ls -la /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/docs/
-rw-r--r--  1 root root  4473 Oct 11 01:49 00-最终交付报告.md
-rw-r--r--  1 root root  7541 Oct 11 00:17 01-视觉设计说明.md
-rw-r--r--  1 root root  4801 Oct 11 01:47 02-契约接入说明.md
-rw-r--r--  1 root root  3903 Oct 11 01:49 03-浏览器测试报告.md
-rw-r--r--  1 root root  5013 Oct 11 01:48 04-微信小游戏模拟验证报告.md
-rw-r--r--  1 root root  3310 Oct 11 01:49 05-公网预览部署说明.md
-rw-r--r--  1 root root  1267 Oct 11 01:49 06-回滚说明.md
-rw-r--r--  1 root root 12778 Oct 11 01:57 07-文件SHA256清单.txt
-rw-r--r--  1 root root 11801 Oct 12 08:24 08-企划与计划审查报告.md
-rw-r--r--  1 root root  5179 Oct 12 08:24 09-多智能体作战手册-上.md
-rw-r--r--  1 root root  8570 Oct 12 08:25 10-多智能体作战手册-下-任务书.md
-rw-r--r--  1 root root 13438 Oct 12 08:49 11-0.1收尾任务书-分级.md
```

### 2.3 核对产物 `dist/wechat/`

```bash
$ cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/dist/wechat
$ ls -la
-rw-r--r-- 1 root root 628731 Oct 11 01:44 game.js
-rw-r--r-- 1 root root    64 Oct 11 01:44 game.json
-rw-r--r-- 1 root root   524 Oct 11 01:44 MANIFEST.json
-rw-r--r-- 1 root root   498 Oct 11 01:44 project.config.json

$ sha256sum game.js game.json project.config.json MANIFEST.json
7185453263687c277f293c2b01d7992c1e70450b2c33a3944a724974635d2517  game.js
82526622d158db584fe0783eb469d01eaaa33a85360c28d83bf2b01cb031b8ec  game.json
113e97a6b1b13773e91d5aec0aa9b9441a4c81667b1e5f074b0e2f088b770094  project.config.json
e72bcdca5a8413df123cb71d1333bb413935adf370e45c73a39ae6ed11da6f65  MANIFEST.json
```

`game.json` 原文：

```json
{
  "deviceOrientation": "portrait",
  "showStatusBar": false
}
```

`project.config.json` 原文：

```json
{
  "description": "我要当岛主 0.1 · 微信小游戏（游客模式工程，仅用于模拟器验证）",
  "miniprogramRoot": "",
  "compileType": "game",
  "appid": "touristappid",
  "projectname": "wyszz-island-0.1",
  "setting": {
    "urlCheck": false,
    "es6": false,
    "enhance": false,
    "minified": false,
    "postcss": false,
    "babelSetting": {
      "ignore": [],
      "disablePlugins": [],
      "outputPath": ""
    }
  },
  "libVersion": "3.0.0",
  "condition": {}
}
```

`MANIFEST.json` 原文：

```json
{
  "generatedBy": "tools/build-wechat.mjs",
  "target": "es2017",
  "files": [
    { "path": "game.js",            "bytes": 628731, "sha256": "7185453263687c277f293c2b01d7992c1e70450b2c33a3944a724974635d2517" },
    { "path": "game.json",          "bytes": 64,     "sha256": "82526622d158db584fe0783eb469d01eaaa33a85360c28d83bf2b01cb031b8ec" },
    { "path": "project.config.json","bytes": 498,    "sha256": "113e97a6b1b13773e91d5aec0aa9b9441a4c81667b1e5f074b0e2f088b770094" }
  ]
}
```

**对账结果：4 个文件的实际 SHA256 与 `MANIFEST.json` 里记录的 3 个完全一致。** ✅

### 2.4 新文档的大小与 SHA256

```bash
$ cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs
$ sha256sum 12-真机与官方模拟器验收手册.md 13-真机验收结果记录模板.md
3706a4699391023ec5a6b7b511974dfbd6b033b9b38329f07dd3955c8b022759  12-真机与官方模拟器验收手册.md
961b8470d51ed50afc85dec5b834084c2f9b6735d0baeed08dfa3aa19356bd9a  13-真机验收结果记录模板.md

$ wc -l -c 12-真机与官方模拟器验收手册.md 13-真机验收结果记录模板.md
  614  54842 12-真机与官方模拟器验收手册.md
  230  12223 13-真机验收结果记录模板.md
  844  67065 total
```

### 2.5 关键实现细节的核对输出（用于手册里的"预期"）

```bash
$ grep -rn "safeArea\|getWindowInfo\|getSystemInfo\|statusBarHeight\|pixelRatio\|benchmarkLevel" src/
src/wechat/main.ts:8:  *   - wx.getSystemInfoSync       视口尺寸与像素比
src/wechat/main.ts:38:  const s = wx.getSystemInfoSync();
src/wechat/main.ts:39:  return { w: Math.max(1, s.windowWidth), h: Math.max(1, s.windowHeight), dpr: s.pixelRatio || 1 };
src/wechat/main.ts:41: const bench = (() => { try { return wx.getSystemInfoSync().benchmarkLevel; } catch { return undefined; } })();
src/wechat/wx.d.ts:4:  interface WxSystemInfo { windowWidth: number; windowHeight: number; pixelRatio: number; platform?: string; benchmarkLevel?: number; brand?: string; model?: string; SDKVersion?: string }
```

→ **适配层没有读 `safeArea`、没有读 `statusBarHeight`、没有用 `getWindowInfo`。** 这是手册 §3.4 那条"刘海屏风险项"的直接依据。

```bash
$ grep -n "TAP_MOVE" src/app/input.ts
25:export const TAP_MOVE_TOUCH = 10, TAP_MOVE_MOUSE = 8, TAP_MAX_MS = 600;
```

→ 手册 §3.2 里"手势阈值"那一行的依据。

```bash
$ grep -rn "panel\|modal\|Panel\|Modal" src/
src/ui/hud.ts:13:export type HudRegion = 'top' | 'bottom' | 'upgrade' | 'panel' | 'panel-ok' | 'dim' | 'none';
src/ui/hud.ts:147:  get modalOpen(): boolean { return this.panelData !== null; }
src/game/session.ts:23:export interface OfflinePanelData {
...
```

→ **`panel` 只属于离线收益面板**；没有"升级面板"。这是手册 §3.3 差异 D2 的依据。

替身宿主的原始结果（`evidence/wechat-sim-results.json`，共 37 项全部 `ok: true`），我在手册里引用的关键几条原文：

```
W03c detail: {"calls":41,"triangles":29174,"geometries":32,"textures":8,"programs":10,
              "world":{"triangles":22652,"meshes":31,"materials":7},"lowFx":true,
              "renderer":"ANGLE (Google, Vulkan 1.3.0 (SwiftShader Device (Subzero) (0x0000C0DE)), SwiftShader driver)",
              "frames":59,"pixelRatio":1}
W04  detail: resident=1 coins 0→3762          ← 注意：这是毫币口径（时间结算 762 毫币 + 寻访 3000 毫币）
W04d detail: 金币不足，还差 15 金币
W05  detail: 0.61→-0.82                       ← yaw 变化，拖动不触发点击
W05c detail: 1.00→1.19                        ← 双指缩放
W07b detail: {"deltaMs":3600000,...,"gainMilli":600000,"gainCoins":600,"rateMilliPerMinute":10000,"ratePerMinute":10,...}
W09b detail: {"before":[2,2],"after":[2,2]}   ← 重启后一致
```

`evidence/perf.json` 原文：

```json
{
  "renderer": "ANGLE (Google, Vulkan 1.3.0 (SwiftShader Device (Subzero) (0x0000C0DE)), SwiftShader driver)",
  "lowFx": true, "calls": 40, "triangles": 29172, "programs": 10,
  "geometries": 32, "textures": 15,
  "worldStats": { "triangles": 22652, "meshes": 31, "materials": 7 },
  "pixelRatio": 1, "fpsSwiftShader": 19.9
}
```

→ **19.9 fps 的字段名就叫 `fpsSwiftShader`**，这本身就是"软件渲染、不代表手机"的直接证据。

---

## 3. 改动文件清单及 SHA256

**新增 3 个文件，修改 0 个文件，删除 0 个文件。全部位于副本目录。**

| # | 文件绝对路径 | 字节数 | SHA256 |
|---|---|---|---|
| 1 | `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs/12-真机与官方模拟器验收手册.md` | 54842 | `3706a4699391023ec5a6b7b511974dfbd6b033b9b38329f07dd3955c8b022759` |
| 2 | `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs/13-真机验收结果记录模板.md` | 12223 | `961b8470d51ed50afc85dec5b834084c2f9b6735d0baeed08dfa3aa19356bd9a` |
| 3 | `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs/L2-报告.md` | 见第 3.1 节 | 见第 3.1 节 |

### 3.1 本报告自身的 SHA256

本报告写完后再计算（见文末"报告指纹"一节），因为内容会自我引用。

**原目录 `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/` 的改动清单：空。**

---

## 4. 读过的目录清单

### 4.1 允许范围内读过的（全部只读）

**目录：**

```
/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/                    （整体，含 docs/ dist/ src/ test/ tools/ evidence/）
/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/docs/
/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/dist/wechat/
/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/src/                 （app/ core/ game/ platform/ render/ ui/ web/ wechat/ contract/）
/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/evidence/
/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/release/             （仅 ls）
/vol1/ai/projects/wyszz-new/frontend-rebuild-contract-v1/docs/
```

**逐个读过的文件：**

| 文件 | 用途 |
|---|---|
| `frontend-rebuild-hm/docs/00-最终交付报告.md` | 现状与边界（官方模拟器/真机/上传未验证） |
| `frontend-rebuild-hm/docs/01-视觉设计说明.md` | 首屏应看到什么；旋转/缩放范围 |
| `frontend-rebuild-hm/docs/02-契约接入说明.md` | 事务与失败反馈、UI 边界、手势阈值缺口 |
| `frontend-rebuild-hm/docs/03-浏览器测试报告.md` | 已知局限（SwiftShader 帧率、居民遮挡） |
| `frontend-rebuild-hm/docs/04-微信小游戏模拟验证报告.md` | 替身宿主边界、W01–W12 结果、产物说明 |
| `frontend-rebuild-hm/docs/05-公网预览部署说明.md` | 确认公网预览 404 的边界（未写入手册，仅确认） |
| `frontend-rebuild-hm/docs/06-回滚说明.md` | 确认存档键与回滚边界 |
| `frontend-rebuild-hm/docs/11-0.1收尾任务书-分级.md` | 本任务书原文（用来对照差异 D1/D2） |
| `frontend-rebuild-contract-v1/docs/02-状态与字段清单.md` | 13 字段、初始值、派生量、存档信封 |
| `frontend-rebuild-contract-v1/docs/03-公式与规则清单.md` | R(L)、C(L)、寻访奖励、离线规则、边界表 |
| `frontend-rebuild-contract-v1/docs/04-API契约.md` | 初始状态、指纹期望值、调用顺序 |
| `frontend-rebuild-hm/dist/wechat/{game.js,game.json,project.config.json,MANIFEST.json}` | 产物核对（`game.js` 只看了头部/体积，没有通读 614 KiB 的压缩代码） |
| `frontend-rebuild-hm/src/ui/hud.ts` | HUD / 面板的真实文案 |
| `frontend-rebuild-hm/src/app/app.ts` | toast 文案、事件转发 |
| `frontend-rebuild-hm/src/app/input.ts` | 手势阈值 |
| `frontend-rebuild-hm/src/game/session.ts` | 离线面板触发条件、事务顺序 |
| `frontend-rebuild-hm/src/game/format.ts` | 金币/时长/速率的显示格式 |
| `frontend-rebuild-hm/src/wechat/main.ts` | 适配层实际读取的系统字段 |
| `frontend-rebuild-hm/src/wechat/wx.d.ts` | 适配层声明用到的 wx 字段 |
| `frontend-rebuild-hm/src/core/constants.ts` | 冻结常量 |
| `frontend-rebuild-hm/evidence/wechat-sim-results.json` | 37 项替身结果原文 |
| `frontend-rebuild-hm/evidence/perf.json` | SwiftShader 帧率与预算原文 |

### 4.2 明确**没有**读的（禁区，全部遵守）

`wechat-game-0.1-ds/`、`3d-spike-ds/`、`wechat-spike-ds/`、`3d-spike/`、`app/`、`little-town/`、
MIMO 目录、任何旧截图、旧公开页面、旧模型与素材、
`/vol1/ai/projects/wyszz-new/docs/screenshots/`、
`/vol1/ai/projects/wyszz-new/docs/第二步-静态手机画面报告-0.1-2026-10-08.md`、
`/vol1/ai/projects/wyszz-new/docs/第二步-画面源码-0.1-2026-10-08.zip`。

也**没有**读 `/vol1/ai/projects/wyszz-new/docs/` 下的企划书 v0.3 / 迭代计划 v2 / 计划修改报告
（允许读，但本任务不需要——所有数值我都从契约与交付文档核对，来源更直接）。

> 说明：`cp -a` 是对**整个项目目录**做的完整复制，复制动作本身会遍历到 `node_modules` 等子目录，
> 但**没有读取任何禁区目录**（禁区目录在项目目录之外）。

---

## 5. 联网查阅记录（官方文档 URL + 查阅日期 2026-10-12）

> **规则**：凡涉及微信平台行为的结论，手册里都附了下列链接之一。
> 查不到官方依据的，手册里明确写了"**未确认**"或"**未找到官方依据**"。

| # | 官方页面 | URL | 手册里用它支撑的结论 |
|---|---|---|---|
| 1 | 微信开发者工具（小游戏） | https://developers.weixin.qq.com/minigame/dev/devtools/download.html | 工具从官方下载页获取 |
| 2 | 微信开发者工具下载页 | https://developers.weixin.qq.com/miniprogram/dev/devtools/download | 同上（版本号页面为动态渲染，**未确认**） |
| 3 | 界面 | https://developers.weixin.qq.com/miniprogram/dev/devtools/page.html | 游客模式"只能编辑本地项目"；新建项目需要 AppID 或测试号；"前后台切换"菜单 |
| 4 | 项目配置文件（小游戏） | https://developers.weixin.qq.com/minigame/dev/devtools/projectconfig.html | `compileType` 有效值只有 `minigame`/`gamePlugin`；`libVersion` 取值；`appid` 只在新建项目时读取；改 AppID 写入 `project.private.config.json` |
| 5 | 小游戏配置 `game.json` | https://developers.weixin.qq.com/minigame/dev/reference/configuration/app.html | `deviceOrientation` 默认 `portrait`、`showStatusBar` 默认 `false` |
| 6 | 申请测试号 | https://developers.weixin.qq.com/miniprogram/dev/devtools/sandbox.html | 测试号含**小游戏测试账号**；测试号**可以**点预览在真机上体验 |
| 7 | 功能概述（小游戏远程调试） | https://developers.weixin.qq.com/minigame/dev/devtools/remote-debug.html | 真机调试流程；**小游戏远程调试目前尚不支持 Storage 面板**；老版本要求（工具 ≥1.02.1809260、iOS 11.2~11.4.1+微信 6.7.2、Android 微信 6.7.3） |
| 8 | 真机调试能力升级 Beta | https://developers.weixin.qq.com/minigame/dev/devtools/remote-debug-v2.html | v1.0 "**注意：iOS 暂不支持**" |
| 9 | 真机调试2.0 | https://developers.weixin.qq.com/miniprogram/dev/devtools/remote-debug-2.html | Android 微信 8.0.6+/基础库 2.18.1+；iOS 微信 8.0.8+/基础库 2.18.1+；工具自 1.05.2107221 RC 起支持 |
| 10 | 转换工具使用指南 | https://developers.weixin.qq.com/minigame/dev/guide/game-engine/common-adaptation/Design/TransformTool.html | **导入小游戏四步**（选小游戏类别 → 导入/新建 → 填目录与 AppID、模板选小游戏 → 创建）；预览出二维码、手机微信扫码；真机 `…`→开发调试→打开调试→vConsole |
| 11 | 代码包 | https://developers.weixin.qq.com/minigame/dev/guide/base-ability/code-package.html | 开发版/体验版/正式版；开发版**只能通过扫码获得**；主包 ≤4M、总包 ≤30M |
| 12 | 兼容 | https://developers.weixin.qq.com/minigame/dev/guide/runtime/client-lib/compatibility.html | 基础库版本号规则；用 `wx.getAppBaseInfo` 取基础库版本 |
| 13 | 基础库 | https://developers.weixin.qq.com/miniprogram/dev/framework/client-lib | 微信客户端携带**上一个稳定版**基础库发布；灰度 12～24 小时 |
| 14 | `wx.getSystemInfoSync` | https://developers.weixin.qq.com/minigame/dev/api/base/system/wx.getSystemInfoSync.html | `safeArea`（基础库 2.7.0+，部分机型不返回，需自行兼容）；`benchmarkLevel`（仅 Android，-2/0=无法运行小游戏）；**从 2.20.1 起本接口停止维护**；出错可能返回空对象 |
| 15 | `wx.setStorageSync` | https://developers.weixin.qq.com/minigame/dev/api/storage/wx.setStorageSync.html | 单个 key ≤1MB、总 ≤10MB；除非用户删除或被系统清理，数据一直可用 |
| 16 | `wx.getStorageSync` | https://developers.weixin.qq.com/minigame/dev/api/storage/wx.getStorageSync.html | 存档读取接口 |
| 17 | 开发阶段内存调优 | https://developers.weixin.qq.com/minigame/dev/guide/performance/perf-action-memory-dev-profile.html | Android 微信 7.0.7+ 为开发版/体验版提供**性能监控面板**（胶囊按钮→开发调试）；Heap Snapshot；PerfDog |
| 18 | 发布流程 | https://developers.weixin.qq.com/minigame/introduction/gamemaker/minigame/release | 注册小游戏账号（服务类目选"游戏"）；上传到 MP；体验版；提审 |
| 19 | 调试指南（AI） | https://developers.weixin.qq.com/miniprogram/dev/ai/debugging.html | 真机上通过 vConsole 的 WeChat 页确认基础库版本号 |
| 20 | 开发者工具更新日志 | https://developers.weixin.qq.com/miniprogram/dev/devtools/uplog | 出现过"优化 **touristappid 禁用提示**"，证明 `touristappid` 是被工具识别的特殊值 |
| 21 | 微信开放社区（**社区回复，非正式文档**） | https://developers.weixin.qq.com/community/minihome/doc/000020de490d78321c8c9ba3e56800 | 社区技术运营专员回复"测试版 appid 无法上传" —— 手册里明确标注为社区内容、按"未确认"对待 |
| 22 | 云测常见问题 | https://developers.weixin.qq.com/miniprogram/dev/devtools/minitest/cloud_problem.html | "不支持使用测试 AppID 打开小程序" —— 手册里注明这是**云测插件**的限制，不能推广到上传 |

**未找到官方依据的事项**（手册里已明确标注）：

- 小游戏的手机硬件最低要求。
- 手机发热的合格标准。
- `touristappid` 的完整限制清单。
- 测试号能否"上传"代码（官方文档无条文，只有社区回复）。
- 模拟器黑屏/白屏的针对性排查（官方《转换工具使用指南》的故障排除条目属于 Emscripten 转换工具场景，与本项目不同）。
- 小游戏运行内存的官方上限（本次未查阅相关页面）。

---

## 6. 未验证项

**本次任务本身**：

- 我**没有**运行任何测试或构建，所以我没有产生任何新的运行结果。手册里引用的所有测试数字（32/32、59/59、37/37、19.9 fps 等）**都是引用**交付文档，不是我自己跑的。
- 我**没有**在微信开发者工具里打开过 `dist/wechat/`。
- 我**没有**在真机上跑过。
- 我**没有**验证过手册里任何一个"应看到什么"是否真的会出现。

**手册（`docs/12`）第 3 节表格的 21 项 + 补充项 S1–S5**：**全部为 `未验证`**（这是设计如此——见 `docs/12` §0 与 §3.0）。

具体包括但不限于：

- 官方模拟器能否正常编译运行本项目产物。
- 真机 WebGL / WebGL2 上下文能否正常创建。
- 真机触摸事件（多点、取消、坐标）的真实行为。
- 真机存储配额与 `wx.setStorageSync` 的真实表现。
- 真机帧率、发热、内存。
- 刘海屏/安全区的真实遮挡情况。
- 上传 / 体验版 / 审核 / 发布全流程。
- 手册里写的所有"应看到"的文案是否与实际渲染**逐字**一致（我只核对了 `src/ui/hud.ts` 等源码里的字符串常量，**没有跑起来看画面**）。

---

## 7. 我不确定的地方

| # | 不确定的事 | 我的处理 |
|---|---|---|
| 1 | `project.config.json` 里的 `"compileType": "game"` 是否仍被当前开发者工具接受。官方文档（小游戏版）只列了 `minigame` / `gamePlugin`。 | 手册 §5 第 2 条如实写出差异，并标注"**我无法确认**"；不改产物（约束要求）。见第 8 节 Q1。 |
| 2 | `touristappid` 到底能不能预览/真机调试。官方只在更新日志里出现过"touristappid 禁用提示"。 | 手册 §1.2 标为"**限制未确认**"，并给出确认路径。 |
| 3 | 测试号能否上传。官方文档无条文，只有社区回复。 | 标为"**官方文档未找到明确条文**"，社区回复单独标注来源。 |
| 4 | 小游戏真机调试的客户端/基础库最低要求。官方两页（`minigame/dev/devtools/remote-debug` 与 `miniprogram/dev/devtools/remote-debug-2`）数字不一致。 | 两套都列出，并明说"**官方没有统一口径**，以工具实际提示为准"。 |
| 5 | 任务书说的"升级入口打开面板"到底指什么。0.1 里唯一的模态面板是离线收益面板，升级是直接扣费。 | 判为**任务书与实现不符**（差异 D2），按实际实现改写检查项，并在手册 §3.3 单列差异说明。 |
| 6 | 任务书说的"点击建筑和居民会寻访"。契约明确只有标签恰为 `居民` 才发奖。 | 判为**任务书与契约不符**（差异 D1），按契约改写，并提示不要把"点建筑没反应"记为失败。 |
| 7 | 官方模拟器的"触摸模拟"具体怎么操作（鼠标拖动是否等价单指、如何模拟双指）。 | 手册里写成"模拟器里用鼠标按住拖动 = 单指拖动；模拟器支持触摸模拟"，**没有**断言双指在模拟器里怎么模拟——这部分我在手册 §2.5 只写了"按表格逐项做"，没有编造具体按键。**这一点未确认。** |
| 8 | 微信开发者工具的当前稳定版版本号。下载页是动态渲染，我没读出来。 | 手册 §1.1 标"**未确认**"，给出确认路径。 |
| 9 | 我引用官方文档时用的是搜索引擎/抽取工具返回的**页面正文**，没有用浏览器逐页人工复核渲染后的页面。有可能存在抽取遗漏（例如某些折叠区块）。 | 已在第 5 节列出全部 URL，便于你复核；关键结论我都尽量直接引用了原文句子。**如需 100% 把握，请点开链接复核。** |

---

## 8. 待决问题

> 按任务要求，"我判断不了的"写在这里，不猜。

### Q1（重要）：`compileType` 与官方文档不一致

- **事实**：`dist/wechat/project.config.json` 里是 `"compileType": "game"`。
  官方《项目配置文件》（小游戏版，查阅日期 2026-10-12）列出的有效值只有
  `minigame`（普通小游戏项目）和 `gamePlugin`（小游戏插件项目），**没有列出 `game`**。
- **我不确定**：当前工具是否仍兼容 `game`（历史上小游戏工程确实常见 `"compileType": "game"`，
  但我**没有找到官方文档依据**，所以不能凭印象断言）。
- **需要你决定**：
  1. 先按原样导入，观察工具是否报"编译类型不合法"或是否正常识别为小游戏；
  2. 如果报错，是否把 `compileType` 改成 `minigame`（**这会改动产物**，属于 L3/开发者范围，L2 没有改）。
- **建议**：把"导入时工具对 `compileType` 的反应"作为第一条记录写进 `docs/13`。

### Q2：`touristappid` 是否够用

- 产物自带 `"appid": "touristappid"`，描述写着"游客模式工程，仅用于模拟器验证"。
- **需要你决定**：真机验收是**先申请小游戏测试号**（官方确认测试号可真机预览），还是**等正式 AppID 审核通过**再做。
- 如果决定用测试号，请在第 2.9 步用"详情 → 基本信息"改 AppID，**不要**手改 `project.config.json`（官方说该字段只在新建项目时读取）。

### Q3：刘海屏风险项要不要在 0.1 内修

- 事实：适配层没有读 `safeArea` / `statusBarHeight`（`src/wechat/main.ts:38-41`），
  官方明确说 `safeArea` 需开发者自行兼容。
- **需要你决定**：如果真机实测发现顶栏被遮挡，这是否算 0.1 的阻塞项？
  若算，需要新增一个 L3 级改动任务（改 `src/wechat/main.ts` 与 HUD 布局）；L2 不改代码。

### Q4：`wx.getSystemInfoSync` 已停止维护

- 官方：从基础库 2.20.1 起该接口停止维护，建议改用 `wx.getWindowInfo` / `wx.getDeviceInfo` /
  `wx.getAppBaseInfo` / `wx.getSystemSetting` / `wx.getAppAuthorizeSetting`。
- 本项目仍在使用 `getSystemInfoSync`（`src/wechat/main.ts:38,41`）。
- **需要你决定**：是否作为 0.1 的已知风险记录进 H2（微信适配层真机风险评审），
  还是排进 0.2 前的待办。L2 不改代码。

### Q5：手册里"应看到"的文案要不要做逐字校验

- 我只从 `src/ui/hud.ts`、`src/app/app.ts`、`src/core/save.ts` 里**读到了字符串常量**，
  **没有跑起来看实际渲染**（真机/模拟器都未运行）。
- **需要你决定**：真机验收时是否要求把每条文案**逐字**比对（严格），
  还是只看"意思对不对"（宽松）。手册现在写的是严格口径。

### Q6：帧率与发热的"通过标准"

- 官方没有给小游戏的帧率/发热合格线（**未找到官方依据**）。
- **需要你决定**：0.1 的真机帧率验收线是多少（例如"中端 Android ≥30 fps"），
  以及发热到什么程度算失败。手册现在**只要求记录，不给判定线**。

---

## 9. 与任务书要求的对照（自检）

| 任务书要求 | 是否做到 | 落在哪 |
|---|---|---|
| 前置条件：工具版本要求 | ✅（并标注"统一最低版本未确认"） | `docs/12` §1.1 |
| 前置条件：AppID（没有时的测试号限制） | ✅（三种情况 + 官方测试号可预览 + touristappid 未确认 + 测试号上传未确认） | `docs/12` §1.2 |
| 前置条件：基础库版本选择 | ✅（`libVersion` 取值、覆盖规则、真机基础库由客户端决定） | `docs/12` §1.3 |
| 前置条件：手机要求 | ✅（能确认的写确认；机型门槛标未确认；给出 benchmarkLevel 官方信号） | `docs/12` §1.4 |
| 导入 `dist/wechat` 的步骤 + 每步"应看到什么" | ✅（11 个步骤，每步都有"应看到"） | `docs/12` §2.0–§2.11 |
| 预览 / 真机调试步骤 | ✅ | `docs/12` §2.6 / §2.7 / §2.8 |
| 检查项表格（操作/预期/通过·失败·未验证/备注） | ✅ 21 项 + 5 项补充 | `docs/12` §3.1 / `docs/13` §2 |
| 覆盖：首屏城市与资源栏 | ✅ 第 1 项 | |
| 覆盖：单指拖动旋转 / 双指缩放 | ✅ 第 2、3 项 | |
| 覆盖：点建筑和居民会寻访、金币 +3、声望 +1 | ✅ 第 4、5、6 项（并**纠正**"点建筑会寻访"这一说法，见差异 D1） | `docs/12` §3.3 |
| 覆盖：拖动不触发寻访 | ✅ 第 7 项 | |
| 覆盖：升级入口打开面板、不阻断连续点击 | ✅ 第 8 项（并**纠正**"打开面板"，见差异 D2） | `docs/12` §3.3 |
| 覆盖：金币不足不扣费 | ✅ 第 9 项 | |
| 覆盖：Lv1 10/分钟、Lv2 12/分钟、下次费用 25 | ✅ 第 10 项 | |
| 覆盖：退出再进入的离线收益结算 | ✅ 第 11、11a 项 | |
| 覆盖：切后台再回来不重复结算 | ✅ 第 12、13、20 项 | |
| 覆盖：存档重启后保留 | ✅ 第 14 项 | |
| 覆盖：帧率、发热、文字遮挡、刘海屏 | ✅ 第 15、16、17、18 项 | |
| **逐条标注数值来源**（哪个文件哪一节） | ✅ 30+ 行对照表 | `docs/12` §3.2 |
| 凡与契约不符的，如实写出差异 | ✅ 差异 D1/D2 + 5 条"预期与直觉不同" | `docs/12` §3.3 |
| 结果记录模板（机型/系统/微信/基础库/日期/截图/每项结果/问题描述） | ✅ | `docs/13` §1–§3、§4 |
| 写明"没测过必须填未验证，不能留白或填通过" | ✅（模板开头"填写前必读"第 1 条，另在 §6、§7 重复） | `docs/13` |
| 常见失败排查提示（只写有依据的） | ✅ 14 条，每条标依据；无依据的标"未确认/未找到官方依据" | `docs/12` §5 |
| 不改代码（src/tools/test/package.json） | ✅ 未改任何文件 | 第 2.2 节 `diff` 为证 |
| 只在副本里工作 | ✅ | 第 2.2 节 |
| 不进入 0.2 | ✅ 手册 §适用范围明确排除 | |
| 报告含：做了什么/命令与原始输出/改动清单与 SHA256/读过的目录/未验证项/不确定的地方/待决问题 | ✅ | 本报告 §1–§8 |
| 微信平台结论必须附官方 URL + 查阅日期 | ✅ 22 条，全部 2026-10-12 | `docs/12` §7、本报告 §5 |

---

## 报告指纹

本报告自身的 SHA256 **无法写进本文件**（写进去就会改变它自身的哈希，这是个自我引用问题）。
因此本报告的 SHA256 在**交付回复**里给出，计算命令是：

```bash
sha256sum /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L2/docs/L2-报告.md
```

同理，`docs/12` 与 `docs/13` 的 SHA256 见第 3 节表格，也是在**最后一次写入之后**计算的。

---

## 10. 一句话交付说明

手册（`docs/12`）告诉一个不写程序的人：**要装什么、怎么导入、每一步该看到什么、每一条预期数值出自契约的哪一节、
失败了怎么排查**；模板（`docs/13`）让他把结果一条条填下来，并且**没测的必须写"未验证"**。
**手册里没有一条真机结论——因为一条都还没测过。**
