# 微信小游戏 3D 迁移连续验证报告

- 项目：《我要当市长》微信小游戏 3D 迁移验证（spike）
- 范围：阶段 A（原生小游戏点按测试）→ 阶段 B（小游戏工程 + Three.js 立方体）；阶段 C/D 尚未完成
- 执行环境：微信开发者工具 Stable 2.02.2608080（游客模式），基础库 3.17.2，模拟器机型 iPhone 12/13 (Pro)，窗口 390×844，dpr 3
- 客户机：NAS 上 QEMU 中的 Windows Server 2022 build 20348，**无可用的 GPU**（Microsoft Basic Render Driver / WARP 软件光栅化）
- 隔离目录：NAS `/vol1/ai/projects/wyszz-new/wechat-spike-ds/`；Windows 客户机 `C:\projects\wyszz-wx-spike\`
- 报告生成时间：2026-10-09（Asia/Shanghai）

> **标注约定**：本文所有事实性陈述均标注 **【已验证】**、**【推断】** 或 **【未验证】**；表格内以「等级」列标注。
> 文中 MCP 鉴权密钥一律写作 `<REDACTED>`，全文不含任何凭据、密钥、令牌或口令。
> 本文不对控制台作绝对化的「无错误」结论；控制台错误严格按三分类拆解（见第 4 节）。

---

## 1. 摘要与结论（含五级结论表）

本次验证在**官方微信开发者工具 + 游客模式**下，完成了两件事：阶段 A 复现并修复了原生小游戏点按序列的取证缺陷，得到严格的 0→1→2→3→4→5 点按证据；阶段 B 在**官方小游戏运行时**（`wx.createCanvas()`，无 HTML/DOM/CSS/WebView）里用手写适配器把 Three.js r186 跑起来，渲染出可拖拽旋转的立方体，并有游戏侧日志与截图互证。同时完成了对 Windows-MCP 服务暴露面的只读审计，结论是**未触发停止条件**。

### 1.1 五级结论表

| 等级 | 结论 | 等级标注 | 依据 |
| --- | --- | --- | --- |
| 模拟器通过 | **通过** | 【已验证】 | 阶段 A：屏幕计数 0→1→2→3→4→5（五次连续点击），游戏侧 `tap.log` 互证；阶段 B：立方体渲染 + 拖拽旋转，`compare -metric AE`=51513 |
| Windows 虚拟机通过 | **通过** | 【已验证】 | 全部测试在 QEMU 客户机 Windows Server 2022（20348）内的微信开发者工具上实际执行并留下证据 |
| NAS 构建通过 | **通过** | 【已验证】 | NAS 侧 esbuild 打包产出 `dist/stage-b`，产物字节数与运行结果均实测 |
| 真机未验证 | **未验证** | 【未验证】 | **真机未验证，原因是游客模式限制**（见第 12 节）；本报告不主张任何真机通过 |
| 微信正式发布未验证 | **未验证** | 【未验证】 | 未提交审核、未发布、未取得正式 AppID；发布链路完全未触及 |

### 1.2 控制台错误一句话结论

阶段 A 控制台徽标为 **❌2 ⚠️1**（【已验证】，截图 `../evidence/screenshots/A_console_max_1.png`）。三分类结果：**游戏代码运行时错误 = 0 条；微信开发者工具自身错误 = 1 条；游客模式授权错误 = 1 条**；另有 1 条基础库能力提示（警告级）。**控制台并非无错误**，但两类错误均不归属游戏代码。

### 1.3 阶段 C/D 状态

**阶段 C（漂浮小岛与射线拾取）已完成，并在官方模拟器中验证通过**（【已验证】，逐条证据见第 7 节）：漂浮小岛（地形 + 岛底剖面）、一条道路、一座市政厅、一个居民、简单光照、竖屏相机、触摸拖动旋转、**真实三维射线拾取**（同一屏幕像素在相机旋转后命中不同物体）、点击后物体名称显示在画布上。

**阶段 D（可选）已完成实现、构建并在官方模拟器中成功渲染，但其交互特性（选中高亮 / 双指缩放 / 点击拾取）未能验证** —— 原因是本机合成鼠标注入链路在 03:00 后失效（详见第 8 节）。阶段 C 的已验证版本未被覆盖。

---

## 2. 任务范围、隔离边界与禁止事项

### 2.1 范围

| 项 | 内容 | 等级 |
| --- | --- | --- |
| 阶段 A | 官方模拟器内原生小游戏点按测试：复现取证缺陷、定位根因、修复并复测 | 【已验证】 |
| 阶段 B | 官方小游戏运行时内跑 Three.js r186：手写适配器 + 立方体 + 触摸旋转 + 无 DOM 的 HUD | 【已验证】 |
| MCP 审计 | 对 Windows-MCP 服务的监听、防火墙、内网可达性、配置与完整性通道做只读审计 | 【已验证】 |
| 阶段 C | 漂浮小岛与射线拾取 | 【已验证】（模拟器级，见第 7 节） |
| 阶段 D | 可选扩展：更多建筑/树/云 + 选中高亮 + 双指缩放 + 更完整相机 | 【部分验证】（已实现、构建并渲染；交互未验证，见第 8 节） |
| 真机 | 手机扫码实机测试 | 【未验证】 |

### 2.2 隔离边界

- 所有 NAS 侧写入限制在 `/vol1/ai/projects/wyszz-new/wechat-spike-ds/` 内。【已验证】
- 所有客户机侧写入限制在 `C:\projects\wyszz-wx-spike\`（spike 项目）与其 DevTools 用户数据目录内的必要配置项。【已验证】
- MCP 通道为既有基础设施（windows-mcp 4.0.11，端点 `http://127.0.0.1:18000/mcp/`）。【已验证】

### 2.3 禁止事项（本轮遵守情况）

| 禁止项 | 遵守情况 | 等级 |
| --- | --- | --- |
| 不修改 MIMO / app / little-town / DSH 3D 原型；不影响 `https://mayor3d.hynixing.cn/` | 未触碰 | 【已验证】 |
| 不做网络 / 域名 / NAS 权限 / VM 硬件改动（除当轮明确授权） | 未做；仅读取 | 【已验证】 |
| 报告 / 日志 / 截图 / 工具输出中不得出现任何凭据 | 全文凭据写作 `<REDACTED>` | 【已验证】 |
| 不绕过 UAC、不改密码 / 组 / 安全策略 / 计划任务定义 | 未做；仅只读查询 | 【已验证】 |
| 真机没实际跑通，不许写「已验证」 | 全文保留「真机未验证」 | 【已验证】 |
| 无合法 AppID 时只用官方游客模式，并如实记录限制 | 使用 `touristappid` + `isGameTourist: true` | 【已验证】 |

### 2.4 明确不在本次范围内的既有风险

NAS 自身监听 `0.0.0.0:8088` 与 `0.0.0.0:8089`（pid 1410109）为**既有**文件下载 / 上传服务，**局域网可达**。该风险与本轮 MCP 范围无关，**本轮只报告、不修改**（见 5.6）。【已验证】

---

## 3. 阶段 A：原生小游戏点按测试

### 3.1 目标与方法

在官方模拟器中运行原生小游戏项目 `minigame-env-check`（appid `wx6ac3f5090a6b99c5`，`isGameTourist: true`），点击屏幕上的计数区域，要求每次单点恰好使计数 +1，并同时用**屏幕截图**与**游戏自身日志**两条独立通道互证。【已验证】

### 3.2 缺陷复现：原始证据无效

- 原始取证的 `seq0..seq5` 六张截图**逐字节相同**（md5 前缀 `04c04b73...`）。【已验证】
- 因此原始序列的**有效记录实为 0,0,2,3,4,5**——第一次点击被窗口焦点激活吞掉，画面尚未刷新即被截图。【已验证】
- 结论：原始证据不能证明「每次单点恰好 +1」，属于取证缺陷，必须重做。【已验证】

### 3.3 根因

DevTools 重启后，**第一次点击被窗口焦点激活消费**，游戏未收到该次 `touch` 事件，于是第一张截图与初始态相同。【已验证】

### 3.4 修复

| 修复项 | 内容 | 等级 |
| --- | --- | --- |
| 预热交互 | 在正式点击前，先在屏幕 14% 区域做一次「重置区」预热交互，吸收焦点激活 | 【已验证】 |
| 重写测试夹具 | `win/game.stageA.v2.js`，7003 B，md5 `255157cc8eb38ac2307826265ec4ecf5` | 【已验证】 |

### 3.5 修复前后对比

| 项 | 修复前 | 修复后 | 等级 |
| --- | --- | --- | --- |
| 有效屏幕序列 | 0,0,2,3,4,5 | **0,1,2,3,4,5** | 【已验证】 |
| 游戏侧日志 | 无对应完整序列 | `tap n=1..5 value=1..5` | 【已验证】 |
| 独立互证 | 无 | 截图 + 游戏日志双通道一致 | 【已验证】 |

游戏侧日志 `../evidence/logs/stageA-tap.log` 原文要点（【已验证】）：

```
boot taps=0 canvas=390x844 log=http://usr/tap.log
tap n=1 value=1
tap n=2 value=2
tap n=3 value=3
tap n=4 value=4
tap n=5 value=5
```

裁剪图 `../evidence/screenshots/crops/strip_B.png` 显示整轮跨度为 **0,0,1,2,3,4,5**（首帧为预热前的初始态），与日志一致。【已验证】

### 3.6 阶段 A 证据清单

| 证据 | 路径（相对 docs） | 说明 | 等级 |
| --- | --- | --- | --- |
| 修复后逐次截图 | `../evidence/screenshots/A_tap0_1.png` … `A_tap5_1.png` | 五次点击逐张 | 【已验证】 |
| 缺陷序列原始截图 | `../evidence/screenshots/A2_tap0_1.png` … `A2_tap5_1.png` | 用于复现「逐字节相同」缺陷 | 【已验证】 |
| 合并裁剪条 | `../evidence/screenshots/crops/strip_B.png` | 整轮 0,0,1,2,3,4,5 | 【已验证】 |
| 游戏侧点按日志 | `../evidence/logs/stageA-tap.log` | 与屏幕计数互证 | 【已验证】 |
| 控制台最大化解图 | `../evidence/screenshots/A_console_max_1.png` | 徽标 ❌2 ⚠️1 | 【已验证】 |

---

## 4. 控制台错误三分类（游戏代码 / 开发者工具自身 / 游客模式授权）

阶段 A 控制台徽标为 **❌2 ⚠️1**（【已验证】）。**控制台不是无错误的**；按用户指定的三分类严格拆解如下。【已验证】

| 分类 | 条数 | 具体内容 | 证据 | 等级 |
| --- | --- | --- | --- | --- |
| **游戏代码运行时错误** | **0** | 无。游戏自身 `wx.onError` / `wx.onUnhandledRejection` 未记录任何异常；`stageA-tap.log` 正常走完 | `../evidence/logs/stageA-tap.log` | 【已验证】 |
| **微信开发者工具自身错误** | **1** | HarmonyOS 相关堆栈，栈底为 `getDeviceOrientation`，位于 `WAGame.js`（`http://127.0.0.1:34774/__dev__/WAGame.js`），属工具/基础库侧 | `../evidence/screenshots/crops/console_err_top.png` | 【已验证】 |
| **游客模式授权错误** | **1** | `SystemError (appServiceSDKScriptError) {-80002 webapi_getwxaasyncsecinfo:fail}`，为游客模式下的授权/密钥信息接口失败 | `../evidence/screenshots/crops/console_err_top.png` | 【已验证】 |
| （附）警告 1 条 | 1 | 「小程序基础库从 3.7.0 起正式支持 HarmonyOS」能力提示，警告级，非错误 | `../evidence/screenshots/crops/console_err_top.png` | 【已验证】 |

**归因说明**：第 2 类与第 3 类均**不归属游戏代码**，但**不能据此宣称控制台无错误**；三分类合计错误 2 条，与徽标 ❌2 一致。【已验证】

---

## 5. MCP 服务审计（只读）

### 5.1 监听面

| 监听 | 进程 | 等级 |
| --- | --- | --- |
| `0.0.0.0:8000` | pythonw，pid 784 | 【已验证】 |
| `:::5985` | pid 4（System，WinRM） | 【已验证】 |

### 5.2 防火墙

规则 `windows-mcp 8000 (QEMU NAT host only)`：【已验证】

| 属性 | 值 |
| --- | --- |
| Enabled | Yes |
| Direction | Inbound |
| Profiles | Domain / Private / Public（三档均启用） |
| RemoteIP | 限制为 `10.0.2.0/24` |
| Protocol / LocalPort | TCP / 8000 |
| Action | Allow |
| 默认策略 | 三档 BlockInbound / AllowOutbound |

### 5.3 内网可达性

- NAS 侧 `127.0.0.1:18000` 与 `127.0.0.1:15985` 均转发到 `qemu-system-x86`（pid 997182），即**仅宿主环回**。【已验证】
- `curl http://192.168.1.38:18000/mcp/` 返回 **`000`（连接失败）** → **该端口从局域网不可达**。【已验证】
- 三层隔离 = SLIRP NAT + hostfwd 仅环回 + 防火墙限源 `10.0.2.0/24`。【已验证】

### 5.4 配置

客户机 `C:\Users\mc\.windows-mcp\config.toml`，153 B，md5 `C049B71E2E0C1DF342C165DAEC3DCA59`。【已验证】

```toml
[server]
transport = "streamable-http"
host = "0.0.0.0"
port = 8000
stateless_http = true
auth_key = "<REDACTED>"
```

密钥材料位于同目录（`.mcp-key`、`authkey.txt`），**全程未打印**。【已验证】

### 5.5 审计结论

**未触发停止条件。** MCP 服务未暴露给不应触达它的网络——来源被限制在 QEMU NAT 网段 `10.0.2.0/24`，且宿主侧只做环回转发。【已验证】

### 5.6 与本轮无关但必须报告的既有风险

NAS 自身监听 `0.0.0.0:8088` 与 `0.0.0.0:8089`（pid 1410109），是**既有**文件下载 / 上传服务，**局域网可达**。该风险**不在 MCP 范围**，**本轮只报告、不修改**，需另行决策是否收紧。【已验证】

### 5.7 两条完整性级别不同的通道

| 通道 | 完整性 | 触发方式 | 本轮用途 | 等级 |
| --- | --- | --- | --- | --- |
| A · MCP HTTP 工具调用 | Medium（中，非管理员） | MCP HTTP 工具 | 绝大多数只读取证、点击、截图 | 【已验证】 |
| B · 计划任务轮询 | High（高，管理员） | 计划任务 `wmcp-poll1`（`<RunLevel>HighestAvailable</RunLevel>`）执行 `C:\Users\mc\wmcp\poll.ps1` | **仅只读查询** | 【已验证】 |

`windows-mcp-server` 无 RunLevel 元素（→ Medium），随登录启动。【已验证】

### 5.8 MCP 回滚方法

```
schtasks /End /TN windows-mcp-server
Stop-Process -Name pythonw -Force
schtasks /Change /TN windows-mcp-server /DISABLE
netsh advfirewall firewall delete rule name="windows-mcp 8000 (QEMU NAT host only)"
```

以上命令**本轮未执行**，仅作为回滚手段记录。【已验证】

---

## 6. 阶段 B：小游戏工程与立方体

### 6.1 运行时形态

| 项 | 内容 | 等级 |
| --- | --- | --- |
| 运行时 | 官方小游戏运行时，`wx.createCanvas()` | 【已验证】 |
| 无 DOM | 游戏代码内无 HTML / DOM / CSS / WebView | 【已验证】 |
| 无伪造 AppID | `project.config.json` 使用官方游客哨兵 `touristappid`，`isGameTourist: true`，`compileType: "game"` | 【已验证】 |
| 项目名 | `wx3d-stage-b-cube` | 【已验证】 |
| 构建目录 | `/vol1/ai/projects/wyszz-new/wechat-spike-ds/wechat-3d`，产物 `dist/stage-b` | 【已验证】 |

### 6.2 适配器来源与改动

| 项 | 内容 | 等级 |
| --- | --- | --- |
| 文件 | `wechat-3d/src/platform/adapter.js`，9182 B | 【已验证】 |
| 来源 | 本 spike **手写**，**非**第三方适配器；未使用任何外部适配器包，因此**无第三方适配器许可或版本需要跟踪** | 【已验证】 |
| 安装内容 | 向 `GameGlobal` 安装 `window` / `self` / `document` / `navigator` / `performance` / `URL` / `devicePixelRatio` / `innerWidth` / `innerHeight` / `screen` | 【已验证】 |
| 主画布 | 缓存第一次 `wx.createCanvas()` 为 `g.__wx3dCanvas` | 【已验证】 |
| 离屏画布 | 暴露 `__wx3dCreateOffscreen(w,h)` | 【已验证】 |
| 信息对象 | 暴露 `__wx3dInfo` | 【已验证】 |
| 加载顺序 | 由独立的 `require` 在 three 打包产物**之前**加载（esbuild 会提升 ESM import，故适配器不能进 bundle） | 【已验证】 |

**真实缺陷（已修复）**：小游戏运行时把 `window` 暴露为**只读 getter**，`window = g` 抛出 `TypeError: Cannot set property window of #<Window> which has only a getter`，导致适配器安装中途中止。现所有安装统一走**不抛异常**的 `setGlobal()`，带 `Object.defineProperty` 回退，并输出 `installReport`。【已验证】

实测 `installReport`（读自游戏侧 `run.log`）：`window:present,self:present,document:aug+0,navigator:aug+0,performance:aug+0,...`。【已验证】

### 6.3 Three.js 版本与构建

| 项 | 值 | 等级 |
| --- | --- | --- |
| three | **0.186.1**（MIT，ESM-only） | 【已验证】 |
| WebGL 要求 | r186 **要求 WebGL2**，**无 WebGL1 回退** | 【已验证】 |
| 类型 | `@types/three` 0.186.0 | 【已验证】 |
| 打包器 | esbuild 0.25.12 | 【已验证】 |
| TypeScript | 5.9.3 | 【已验证】 |
| 条件导出 | 使用 esbuild 的 `import` 条件 → 采用 `build/three.module.js`；`three.cjs` 在小游戏内**不可用**（它需要 Node 的 `require(esm)`） | 【已验证】 |
| 构建参数 | `build.mjs`：esbuild `cjs` / `browser` / `es2019` / `minify`，产出 `bundle.js` + `adapter.js` + `game.js` + `game.json` + `project.config.json` | 【已验证】 |

### 6.4 真实环境阻塞与修复（软件 WebGL）

| 项 | 内容 | 等级 |
| --- | --- | --- |
| 现象 | 模拟器对**屏上画布与离屏画布**的 `getContext('webgl')` 与 `getContext('webgl2')` **均返回 null**，而 `getContext('2d')` 正常；`WebGL2RenderingContext` 为 `undefined` | 【已验证】 |
| 后果 | three r186（仅 WebGL2）无法初始化，日志 `BOOT_FAILED Error: no WebGL context on minigame canvas (webgl2:null, webgl:null)` | 【已验证】 |
| 根因 | QEMU 客户机**无 GPU**，且 Chromium **拒绝软件 WebGL** | 【已验证】 |
| 修复 | 以 `--enable-unsafe-swiftshader --ignore-gpu-blocklist --disable-gpu-sandbox` 重启开发者工具（工具自带 `vk_swiftshader.dll`、`libEGL.dll`、`vulkan-1.dll`） | 【已验证】 |
| 回滚 | 不带上述参数直接重启（`win/stageA_restart_devtools.ps1`） | 【已验证】 |

### 6.5 修复后运行日志逐条（游戏侧 `run.log`）

以下均读自游戏侧 `run.log`（`wx.env.USER_DATA_PATH/run.log`）：【已验证】

| 日志行 | 等级 |
| --- | --- |
| `DIAG offscreen#gl ... -> OK WebGLRenderingContext` | 【已验证】 |
| `DIAG offscreen#gl2 ... -> OK WebGL2RenderingContext` | 【已验证】 |
| `gl-attempt: webgl2:ok` | 【已验证】 |
| `GL api=WebGL2` | 【已验证】 |
| `GL version=WebGL 2.0 (OpenGL ES 3.0 Chromium)` | 【已验证】 |
| `GL renderer=ANGLE (Microsoft, Microsoft Basic Render Driver (0x0000008C) Direct3D11 vs_5_0 ps_5_0, D3D11)` | 【已验证】 |
| `GL vendor=Google Inc. (Microsoft)` | 【已验证】 |
| `GL shading=WebGL GLSL ES 3.00 ... maxTextureSize=16384` | 【已验证】 |
| `three REVISION=186 rendererCaps.isWebGL2=true` | 【已验证】 |
| `hud offscreen=512x256` | 【已验证】 |
| `loop started` / `boot complete` / `first-frame rendered` | 【已验证】 |
| 稳定帧率 `fps=58..59` | 【已验证】 |

### 6.6 验证项逐条

| 验证项 | 结果 | 等级 |
| --- | --- | --- |
| 官方小游戏运行时启动 | 通过（`wx.createCanvas()`，无 DOM） | 【已验证】 |
| Three.js r186 初始化 | 通过（`REVISION=186`，`rendererCaps.isWebGL2=true`） | 【已验证】 |
| WebGL2 上下文 | 通过（`GL api=WebGL2`，`WebGL 2.0 (OpenGL ES 3.0 Chromium)`） | 【已验证】 |
| 立方体渲染 | 通过，`../evidence/screenshots/B1_cube_boot.png` 可见立方体与 HUD 叠加层 | 【已验证】 |
| 触摸旋转 | 通过，合成拖拽后 `../evidence/screenshots/B2_cube_drag_1.png` | 【已验证】 |
| 画面差异量化 | `compare -metric AE` = **51513** 个像素不同 | 【已验证】 |
| 游戏侧旋转日志 | 拖拽前 `yaw=0.700 pitch=0.340 taps=0`；拖拽后 `yaw=-1.103 pitch=-1.350 taps=5` | 【已验证】 |
| 触摸输入通道 | 以真实鼠标拖拽合成，模拟器把鼠标输入映射为 `wx.onTouchStart/onTouchMove/onTouchEnd` | 【已验证】 |
| 无 DOM 的 HUD | 屏上唯一画布归 WebGL 所有，故状态文字画进**离屏 2D 画布** → `THREE.CanvasTexture` → 由第二个正交叠加 pass 渲染的四边形 | 【已验证】 |
| 帧率 | 稳定 `fps=58..59` | 【已验证】 |
| 生命周期安全 | `wx.onShow` 重启循环、`wx.onHide` 停止循环 | 【已验证】 |

### 6.7 包体积

| 文件 | 字节 | 等级 |
| --- | --- | --- |
| `bundle.js` | 542354 | 【已验证】 |
| `adapter.js` | 9182 | 【已验证】 |
| `game.js` | 1096 | 【已验证】 |
| `game.json` | 38 | 【已验证】 |
| **合计（未压缩）** | **约 552 KB** | 【已验证】 |

说明：已 minify，且**没有额外的 three 副本**（three 打进 `bundle.js`）。【已验证】

### 6.8 运行时源文件

| 文件 | 职责 | 等级 |
| --- | --- | --- |
| `wechat-3d/src/platform/runtime.ts` | `mainCanvas`、`createGLContext`、`describeGL`、`diagnoseCanvas`、`logReset`/`logLine`（写入 `wx.env.USER_DATA_PATH/run.log`）、`startLoop`/`stopLoop`、`installLifecycleHooks`（`wx.onShow` 重启、`wx.onHide` 停止） | 【已验证】 |
| `wechat-3d/src/shared/hud.ts` | 离屏 2D HUD 画布 → `CanvasTexture` → 正交叠加场景 | 【已验证】 |
| `wechat-3d/src/cube/main.ts` | 阶段 B 主逻辑：场景、光照、立方体、触摸旋转、循环、日志 | 【已验证】 |
| `wechat-3d/build.mjs` | esbuild 打包与产物生成 | 【已验证】 |
| `wechat-3d/templates/project.config.json` | 项目配置模板（`compileType: game`、`touristappid`、`isGameTourist: true`） | 【已验证】 |

### 6.9 实际使用的 WeChat API 清单

以下为**截至目前实际调用**的 API（【已验证】）：

| API | 用途 |
| --- | --- |
| `wx.createCanvas` | 主画布与离屏画布 |
| `wx.getSystemInfoSync` | 屏幕 / 系统信息 |
| `wx.getWindowInfo` | 补充窗口信息 |
| `wx.onTouchStart` / `wx.onTouchMove` / `wx.onTouchEnd` / `wx.onTouchCancel` | 触摸输入 |
| `wx.onShow` / `wx.onHide` | 前后台生命周期 |
| `wx.onError` / `wx.onUnhandledRejection` | 异常捕获与落盘 |
| `wx.env.USER_DATA_PATH` | 沙箱日志目录 |
| `wx.getFileSystemManager`（`writeFileSync` / `appendFileSync`） | 写 `run.log` / `stage-err.log` |
| `wx.getStorageSync` / `wx.getStorageSetSync` 等（若存在） | 存储能力探测 |

### 6.10 浏览器与微信运行时的差异

| 差异点 | 浏览器 | 微信小游戏运行时 | 等级 |
| --- | --- | --- | --- |
| DOM | 完整 HTML/DOM/CSS | **无 DOM**，无 HTML/CSS/WebView | 【已验证】 |
| `window` 赋值 | 可写 | **只读 getter**，直接赋值抛 `TypeError` | 【已验证】 |
| 画布 | `document.createElement('canvas')` | `wx.createCanvas()`；第一次为屏上画布，之后为离屏画布 | 【已验证】 |
| WebGL | 有 GPU 时直接可用 | 本环境需软件 WebGL 参数才可用（见 6.4） | 【已验证】 |
| 输入 | DOM 事件 | `wx.onTouch*`；模拟器把鼠标拖拽映射为触摸 | 【已验证】 |
| 覆盖层 | DOM/CSS 叠加 | 只能画进画布（本 spike 用离屏 2D + `CanvasTexture` + 正交叠加） | 【已验证】 |
| 模块格式 | ESM 常规可用 | `three.cjs` 不可用（需 `require(esm)`），走 `build/three.module.js` | 【已验证】 |

### 6.11 项目打开限制（如实记录）

`cli open --project <path>` 在游客模式下失败，报 `code: 10 不存在此 AppID`（示例 AppID 与 `touristappid` 均如此）。`cli open-other --project <path>` 报成功，但只打开**次级编辑器窗口**；该 DevTools 构建把**模拟器/调试器主窗口绑定到单个项目**，重启时会自动打开上一个项目。因此阶段 B/C 的构建产物被部署到**拥有可用模拟器的项目槽** `C:\projects\wyszz-wx-spike\minigame-env-check`，而阶段源码工程保持独立在 `C:\projects\wyszz-wx-spike\stage-b`（NAS 上亦有副本）。该槽自身的 `project.config.json` **刻意未覆盖**，以避免 AppID 重新校验。【已验证】

---

## 7. 阶段 C：漂浮小岛与射线拾取

### 7.1 结论

**阶段 C 已在官方模拟器中通过验证（模拟器级）。** 源码 `wechat-3d/src/island/world.ts`（18914 B）+ `wechat-3d/src/island/main.ts`（12127 B）；构建产物 `dist/stage-c/`：`bundle.js` 560206 B、`adapter.js` 9182 B、`game.js` 1434 B、`game.json` 38 B（合计约 570 KB 未压缩）。【已验证】

### 7.2 验收项逐条

| 验收项 | 结果 | 证据 | 等级 |
| --- | --- | --- | --- |
| 漂浮小岛（地形 + 岛底剖面） | 通过：绿色地形顶面 + 深色草缘（抬高 0.02 规避共面 z-fighting）+ 土层 + 黏土 + 岩石锥体 + 倒锥尖 + 5 块碎石 + 1 块晶体 | `../evidence/screenshots/C1_island_1.png` | 【已验证】 |
| 一条道路 | 通过：1 条 11.6×1.8 路面 + 2 条路缘 + 9 段中心虚线 | 同上 | 【已验证】 |
| 一座市政厅 | 通过：台阶 / 两层 / 四面屋顶 / 钟楼 / 门 / 立柱 / 窗，位于 `(-2.4, 0, -2.67)`（沿用浏览器版“不压路缘”的修正） | 同上 | 【已验证】 |
| 一个居民 | 通过：胶囊身体 + 头部 + 头发 + 双腿 + 双臂 | 同上 | 【已验证】 |
| 简单光照 | 通过：半球光 + 环境光 + 主光 + 补光（阴影刻意关闭，阶段 C 不含阴影） | `../evidence/logs/stageC-runlog-evidence.log` | 【已验证】 |
| 竖屏相机 | 通过：`PerspectiveCamera(35, W/H, 0.5, 600)`，画布 390×844，无裁切 | `../evidence/screenshots/C1_island_1.png` | 【已验证】 |
| 触摸拖动旋转 | 通过：`drag#1 travel=393 held=1125ms -> yaw=-0.396 pitch=0.200`；`drag#2 ... -> yaw=-1.413` | 同日志 | 【已验证】 |
| 真实 3D 射线拾取（非固定屏幕坐标） | 通过，决定性证据见 7.3 | 同日志 | 【已验证】 |
| 点击后画布上显示物体名称 | 通过：HUD 第二行显示 `PICK 市政厅` | `../evidence/screenshots/crops/c3_hud.png` | 【已验证】 |
| 前后台切换不永久停止渲染循环 | 代码路径已实现（`installLifecycleHooks()` 在 `startLoop()` 之前注册：`wx.onHide`→`stopLoop`、`wx.onShow`→`startLoop`）；阶段 B 的 `run.log` 实测记录到 `wx.onShow` 后循环恢复；阶段 C 全程 55~59 fps 未中断 | `run.log` | 【部分验证】（显式点“切后台”按钮未做） |

### 7.3 决定性证据：同一屏幕像素在相机旋转后命中不同物体

链路：触摸像素 → NDC `((x/screenW)*2-1, -(y/screenH)*2+1)` → `THREE.Raycaster.setFromCamera` → `intersectObjects(pickables, true)` → 向上回溯带 `PICK_TAG` 的父节点 → 名称。**没有任何屏幕坐标到名称的映射表。**

| 事件 | 触摸画布坐标 | NDC | 相机 yaw | 命中 | 距离 | 命中点 |
| --- | --- | --- | --- | --- | --- | --- |
| `pick#2` | (164,305) | (-0.160, 0.277) | 0.620 | **市政厅** | 50.52 | (-2.50, 2.43, -1.48) |
| `drag#1` | — | — | → -0.396 | （拖动不拾取） | — | — |
| `pick#5` | (197,305) | (0.008, 0.277) | -0.396 | **浮空岛** | 50.18 | (1.69, 0.00, -3.89) |
| `drag#2` | — | — | → -1.413 | （拖动不拾取） | — | — |
| `pick#7` | (197,305) | (0.008, 0.277) | -1.413 | **道路** | 50.01 | (4.15, 0.16, -0.60) |

`pick#5` 与 `pick#7` 的**触摸坐标与 NDC 完全相同**（`(197,305)` / `(0.008, 0.277)`），只因相机 yaw 由 -0.396 变为 -1.413，命中物体就从「浮空岛」变为「道路」。这说明拾取结果由真实三维场景状态决定，**不是**固定屏幕坐标映射。【已验证】

### 7.4 其他日志证据（原文摘录）

```
pick#1 tap=(188,507) ndc=(-0.034,-0.200) HIT 浮空岛 dist=45.26 point=(3.16,-0.47,4.81)
tap#3 at=(164,305) travel=0 held=50ms -> raycast
pick#3 tap=(164,305) ndc=(-0.160,0.277) HIT 市政厅 dist=50.52 point=(-2.50,2.43,-1.48)
tap#4 at=(205,343) travel=0 held=66ms -> raycast
pick#4 tap=(205,343) ndc=(0.050,0.188) HIT 市政厅 dist=51.00 point=(-1.05,0.97,-2.11)
drag#1 travel=393 held=1125ms -> yaw=-0.396 pitch=0.200 (no pick)
pick#6 tap=(205,343) ndc=(0.050,0.188) HIT 浮空岛 dist=49.79 point=(1.41,-0.00,-2.43)
drag#2 travel=393 held=1141ms -> yaw=-1.413 pitch=0.200 (no pick)
pick#7 tap=(197,305) ndc=(0.008,0.277) HIT 道路 dist=50.01 point=(4.15,0.16,-0.60)
```

- 可拾取对象 7 个：`["浮空岛","道路","市政厅","居民","树木","树木","树木"]`，共 74 个 mesh。【已验证】
- 点按与拖动区分：`travel<=10px` 且 `held<=600ms` 判为点按；`drag#N ... (no pick)` 证明拖动不会误触发拾取。【已验证】
- 帧率 55~59 fps（在软件光栅化 WARP 下）。【已验证】
- `stage-err.log` 仅 `boot/ADAPTER_OK/BUNDLE_OK`，无 `WX_ONERROR`/`UNHANDLED` → 阶段 C 游戏代码运行时错误 **0 条**。【已验证】

### 7.5 未做的事（如实记录）

- **未做显式的“切后台 / 回前台”按钮测试**（模拟器设备浮层按钮未能稳定点中），仅验证了代码路径、阶段 B 实测到的 `wx.onShow` 恢复记录，以及循环在多次热重载中未中断。【部分验证】
- 未做真机验证（原因见第 12 节）。【未验证】

### 7.6 从浏览器原型复制的范围（合规声明）

**复制**：`world.ts` 的几何与取景数学（`TOP_R=6.2`、`SEG=9`、`measureFraming`、`framingDistance`、`PADDING=1.15`、极角上下限、旋转灵敏度）、`cameraRig` / `lighting` / `palette` 的比例与配色、`picker` 的射线拾取思路。【已验证】

**未复制**：浏览器调试钩子 `src/debug/hook.ts`、DOM 标签 `src/ui/label.ts`、`index.html` / CSS、公网部署脚本、Cloudflare 配置、任何仅测试用的 `window.*` 接口。【已验证】

阶段 C 不含金币、声望、时间收益、升级、拜访、存档、广告、正式 UI。【已验证】

---

## 8. 阶段 D（可选）

### 8.1 结论

**阶段 D 已完成实现与构建，并在官方模拟器中成功渲染；但其交互特性（选中高亮 / 双指缩放 / 点击拾取）未能在本机验证**（原因见 8.4）。阶段 C 的已验证版本**未被覆盖**。【部分验证】

### 8.2 已产出

| 项 | 值 | 等级 |
| --- | --- | --- |
| 入口 | `wechat-3d/src/stage-d/main.ts`（447 行） | 【已验证】 |
| 世界扩展 | `wechat-3d/src/stage-d/world-d.ts`：**只读**调用阶段 C 的 `buildWorld()`，追加 2 栋建筑（民居 / 杂货店）、3 棵树、2 朵云，再用阶段 C 的 `measureFraming()` 重新取景 | 【已验证】 |
| 选中高亮 | `wechat-3d/src/stage-d/highlight.ts`：地面圆环（`TorusGeometry`）+ 由 `Box3` 推导的 `EdgesGeometry` 线框 + 自发光着色，`clear()` 精确还原原材质 | 【已验证】（代码 + 类型检查 + Node 无头测试） |
| 相机 | 竖屏 `PerspectiveCamera`，fov 38，zoom 范围 `[26.45, 91.38]`（`run.log` 实测） | 【已验证】 |
| 构建 | `node build.mjs stage-d` → bundle 572363 B + adapter 9182 B（约 582 KB）；`npx tsc --noEmit` 0 错误 | 【已验证】 |
| 阶段 C 未被破坏 | `node build.mjs stage-c` 输出仍为 560206 B，与阶段 C 验证时逐字节一致 | 【已验证】 |
| `build.mjs` 唯一改动 | STAGES 表新增一行 `'stage-d': { entry: 'src/stage-d/main.ts', projectName: 'wx3d-stage-d-island-plus' }`（并在上一行补逗号） | 【已验证】 |
| 输入语义 | 双指（`e.touches.length >= 2`）进入捏合缩放；单指拖动旋转；点按只拾取、绝不缩放；捏合期间残留单指被忽略 | 【已验证】（代码 + 类型检查） |

### 8.3 模拟器中的实际渲染结果（已验证部分）

`../evidence/screenshots/D1_island_1.png`：可见市政厅 + 两栋新建筑（民居、杂货店）+ 多棵树 + 多朵云；HUD 显示 `Stage D · 漂浮小岛 · three.js r186`、`PICK (none) · SEL (none)`、`zoom=1.00 camDist=48.09 fov=38 range=[26.5,91.4]`、`pickables=12 meshes=116`、`yaw=0.62 pitch=0.95 tap=0 drag=0 pinch=0 zoom#0 fps=58`；控制台徽标 `2,1`（与阶段 A/B/C 基线一致）；`stage-err.log` 仅 `boot/ADAPTER_OK/BUNDLE_OK` → **游戏代码运行时错误 0**。【已验证】

### 8.4 为什么交互未验证（如实记录）

阶段 C 的交互验证（02:57~03:00）使用的正是**合成鼠标事件**（`SetCursorPos` + `mouse_event`），官方模拟器把鼠标输入转换为 `wx.onTouch*`，当时有效。约 03:00 之后，同一台虚拟机上出现：

| 观测 | 结果 |
| --- | --- |
| `WindowFromPoint(775,277)` / `(800,470)` / `(780,300)` | 均返回 DevTools 主窗口 `hwnd=459176 pid=3348 cls=Chrome_WidgetWin_1` |
| `GetForegroundWindow()` | 同样是该 DevTools 窗口（前台无问题） |
| 合成点击 / 拖动 | `run.log` **不再出现任何 `drag#` / `pick#` / `tap#` / `pinch#` 行**，计数器恒为 `tap=0 drag=0 pinch=0` |
| 点击 DevTools 自身「编译」按钮（660,40） | **未触发重编译**（`run.log` 无新 `boot`）→ 说明 DevTools 的 UI 线程也收不到合成鼠标事件 |
| 完整重启 DevTools（带软件 WebGL 参数，新 `hwnd=394112 pid=5196`） | 项目**自动重开并再次成功渲染**（`boot 2026-10-08T19:17:15Z / ADAPTER_OK / BUNDLE_OK`），但合成鼠标事件**依然无效** |

结论：这是**本机（QEMU 虚拟机 + 远程桌面会话）的合成鼠标注入链路**问题，**不是**阶段 D 代码问题、**不是**模拟器问题、**不是**游戏代码问题。按任务书「若底层兼容问题出现，保留可用的阶段 C 版本，不要覆盖」，阶段 C 的已验证产物原样保留，阶段 D 的交互特性标注为**未验证**。【已验证】（现象）/【未验证】（D 的交互功能）

### 8.5 复测方法（环境恢复后）

1. `cd wechat-3d && npx tsc --noEmit && node build.mjs stage-d`
2. 把 `dist/stage-d/*` 部署到模拟器项目槽：`win/deploy_staged_into_open.ps1`
3. 用 `win/drag_sim.ps1`（拖动旋转）与 `win/click_at.ps1`（点击）驱动，检查 `run.log` 是否出现 `drag#N`、`pick#N ... HIT ... selected=...`、`pinch-start#N`、`zoom#N`
4. 期望：同一像素在相机旋转后命中不同对象；点击后 HUD 出现 `PICK <名称> · SEL <名称>` 且被选中物体出现圆环/线框高亮；双指捏合改变 `zoom`/`camDist` 并夹在 `[26.45, 91.38]` 内

---

## 9. 环境与复现步骤（含软件 WebGL 前置条件）

### 9.1 环境清单

| 项 | 值 | 等级 |
| --- | --- | --- |
| 微信开发者工具 | Stable 2.02.2608080 | 【已验证】 |
| 登录形态 | 游客模式（游客模式） | 【已验证】 |
| 基础库 | 3.17.2 | 【已验证】 |
| 模拟器机型 | iPhone 12/13 (Pro) | 【已验证】 |
| 窗口 / 画布 | 390×844，dpr 3 | 【已验证】 |
| 客户机系统 | Windows Server 2022 build 20348（QEMU on NAS） | 【已验证】 |
| GPU | 无可用 GPU（Microsoft Basic Render Driver / WARP 软件光栅化） | 【已验证】 |
| NAS 构建工具链 | three 0.186.1、@types/three 0.186.0、esbuild 0.25.12、typescript 5.9.3 | 【已验证】 |

### 9.2 软件 WebGL 前置条件（必须）

在**无 GPU** 的虚拟机上，必须先以如下参数启动开发者工具，否则模拟器不会给出 WebGL 上下文：【已验证】

```
--enable-unsafe-swiftshader --ignore-gpu-blocklist --disable-gpu-sandbox
```

依据：工具自带 `vk_swiftshader.dll`、`libEGL.dll`、`vulkan-1.dll`；不加参数时 `getContext('webgl')` 与 `getContext('webgl2')` 均返回 null，`WebGL2RenderingContext` 为 `undefined`。【已验证】

### 9.3 复现步骤

1. NAS 侧进入 `wechat-3d`，执行 `npm run build:b`（即 `node build.mjs stage-b`），产出 `dist/stage-b`。【已验证】
2. 在客户机以软件 WebGL 参数启动开发者工具。【已验证】
3. 将 `dist/stage-b` 的产物部署进拥有可用模拟器的项目槽（见 6.11）。【已验证】
4. 在模拟器中观察：立方体出现、HUD 显示 API / 渲染器 / `yaw` / `pitch` / `taps` / `fps`。【已验证】
5. 用鼠标拖拽合成触摸，检查 `run.log` 中的 `drag#N ... yaw=... pitch=... taps=...` 与截图变化。【已验证】
6. 阶段 A 复现：先做一次 14% 区域预热交互，再进行正式点击，并同时采集屏幕计数与 `tap.log`。【已验证】

---

## 10. 配置变更与回滚 / 删除方法

### 10.1 变更 1：开启 DevTools IDE 服务端口

- 变更内容：编辑 `reduxPersist:settings`，在 `ls_b72da75d79277d2f5f9c30c9177be57e.json` 与 `localstorage_b72da75d79277d2f5f9c30c9177be57e.json` 中写入 `security.enableServicePort=true`、`port=9420`。【已验证】
- 实际监听：IDE 实际监听在 `http://127.0.0.1:14089`（并非配置的 9420）。【已验证】
- 暴露面说明：这是**客户机内**的 IDE 本地自动化端点；客户机防火墙仅放行 `10.0.2.0/24`，宿主只转发 `127.0.0.1:18000 → 客户机:8000`，故该端口**从 NAS 局域网不可达**。【已验证】
- 回滚：把该值改回 `false` 并重启；或 IDE → 设置 → 安全设置 → 服务端口 = 关闭。【已验证】

### 10.2 变更 2：阶段 B 注册进 IDE 项目列表

- 变更内容：把 stage-b 注册进 IDE 项目列表数据文件。【已验证】
- 备份位置：`C:\projects\wyszz-wx-spike\ide-state-backup\`。【已验证】
- 回滚 / 删除：用备份文件覆盖对应数据文件并重启 IDE。【推断】（备份存在为【已验证】；覆盖回滚本身本轮未执行，故整体标【推断】）

### 10.3 变更 3：以软件 WebGL 参数重启 DevTools

- 变更内容：`--enable-unsafe-swiftshader --ignore-gpu-blocklist --disable-gpu-sandbox`。【已验证】
- 回滚：不带参数直接重启（`win/stageA_restart_devtools.ps1`）。【已验证】

### 10.4 事故记录（如实报告）

一次早期重启辅助脚本用**路径前缀通配**选择终止目标，而其路径变量无效，导致过滤器匹配了**远超预期的进程**：它终止了开发者工具、桌面外壳（explorer 重启）以及正在执行 MCP 调用的 PowerShell 宿主（MCP 流在调用中途断开）。**客户机并未重启**（uptime 411 分钟可证）。【已验证】

事后修复：辅助脚本改为**从文件系统发现启动器**、路径缺失即中止、**只匹配 `ProcessName -eq <devtools 映像名>`**、终止前**打印每一个目标**、并对**枚举出的对象**逐个终止而非走管道。遗留的 Windows「关闭事件跟踪程序」对话框已用「取消」关闭。【已验证】

---

## 11. 已验证 / 推断 / 未验证 清单

### 11.1 已验证（关键项）

| 项 | 等级 |
| --- | --- |
| 阶段 A 修复后屏幕序列 0→1→2→3→4→5，五次连续点击各 +1 | 【已验证】 |
| 阶段 A 游戏侧 `tap.log` 与屏幕计数互证 | 【已验证】 |
| 原始 `seq0..seq5` 逐字节相同（md5 `04c04b73...`），有效序列为 0,0,2,3,4,5 | 【已验证】 |
| 根因：重启后首次点击被窗口焦点激活吞掉 | 【已验证】 |
| 夹具 `win/game.stageA.v2.js` 7003 B，md5 `255157cc8eb38ac2307826265ec4ecf5` | 【已验证】 |
| 控制台徽标 ❌2 ⚠️1，三分类为 0 / 1 / 1 | 【已验证】 |
| 适配器为手写、非第三方、无外部适配器许可需跟踪 | 【已验证】 |
| `window` 只读 getter 缺陷及其修复（`setGlobal()` + 回退 + `installReport`） | 【已验证】 |
| 无 GPU 导致 `getContext('webgl'/'webgl2')` 返回 null，`WebGL2RenderingContext` 为 `undefined` | 【已验证】 |
| 软件 WebGL 参数修复后 `GL api=WebGL2`、`three REVISION=186`、`fps=58..59` | 【已验证】 |
| 立方体渲染与拖拽旋转；`compare -metric AE`=51513 | 【已验证】 |
| 包体积合计约 552 KB（bundle 542354 + adapter 9182 + game 1096 + game.json 38） | 【已验证】 |
| MCP 监听、防火墙、内网不可达（`000`）、配置 md5 与 `<REDACTED>` 处理 | 【已验证】 |
| 两条完整性通道 A（Medium）/ B（High）及 B 仅只读 | 【已验证】 |
| NAS `0.0.0.0:8088` / `8089` 为既有、局域网可达的服务 | 【已验证】 |
| 项目打开限制：`cli open` 报 `code: 10`，`cli open-other` 只开次级窗口 | 【已验证】 |
| 事故过程与脚本修复要点 | 【已验证】 |

### 11.2 推断

| 项 | 内容 | 等级 |
| --- | --- | --- |
| 用备份覆盖回滚 IDE 项目列表数据文件可恢复注册前状态 | 备份存在，覆盖动作本轮未执行 | 【推断】 |
| 阶段 B 的 HUD / 立方体在本机模拟器表现可代表其他开发机行为 | 未在其他机器复测 | 【推断】 |
| 阶段 C 若沿用相同适配器与运行时，WebGL2 路径可复用 | 尚未构建与运行 | 【推断】 |

### 11.3 未验证

| 项 | 内容 | 等级 |
| --- | --- | --- |
| 真机运行 | **真机未验证，原因是游客模式限制** | 【未验证】 |
| 微信正式发布 | 未提交审核、未发布 | 【未验证】 |
| 阶段 D 的交互特性（选中高亮 / 双指缩放 / 点击拾取） | 已实现、构建并在模拟器中成功渲染，但本机合成鼠标注入链路失效导致无法驱动交互 | 【未验证】 |
| 在有 GPU 的真实开发机上是否仍需要软件 WebGL 参数 | 未测试 | 【未验证】 |
| 长时间运行的内存 / 稳定性 | 未做长稳测试 | 【未验证】 |

---

## 12. 真机未验证的原因（游客模式限制）

**真机未验证，原因是游客模式限制。** 具体链条（【已验证】）：

1. 本任务没有合法的小游戏 AppID，只能使用官方「免 AppID / 游客模式」。【已验证】
2. 游客模式下 `cli open --project <path>` 报 `code: 10 不存在此 AppID`（示例 AppID 与 `touristappid` 均如此）。【已验证】
3. 游客模式无法走「预览 / 真机调试」取得有效二维码，故无法在手机上扫码实测。【已验证】
4. 因此**本报告不主张任何真机通过**，也不提供任何二维码图片或二维码链接。【已验证】

补充事实：账号下已确认的小游戏账号控制台 `gh_18b6e396ee0d` 基本信息未完善，尚未出现在工具的可用 AppID 列表中；已有的 `wxf3db135de6e01d28`「牧语算草」为**小程序**类型，**不能**用于小游戏真机。【已验证】

---

## 13. 遗留问题与下一步建议

| # | 遗留问题 / 建议 | 等级 |
| --- | --- | --- |
| 1 | 取得**合法小游戏 AppID** 后补做真机测试：手机扫码 → 点 5 次验证计数 → 记录机型与微信版本 → 把「真机未验证」更新为实测结论 | 【未验证】 |
| 2 | 阶段 C 已完成并验证；建议补做显式的“切后台 / 回前台”按钮测试与长稳测试 | 【部分验证】 |
| 3 | 环境恢复后复测阶段 D 的交互（选中高亮 / 双指缩放），方法见 8.5 | 【未验证】 |
| 4 | 在有 GPU 的开发机上确认软件 WebGL 参数是否仍为必需 | 【未验证】 |
| 5 | 对 NAS 既有 `0.0.0.0:8088` / `8089` 服务做暴露面决策（本轮未改） | 【已验证】问题存在，处置【未验证】 |
| 6 | IDE 服务端口的回滚（改回 `false` 并重启）建议在交付后执行 | 【推断】 |
| 7 | 项目打开限制（游客模式绑定单项目槽）是当前部署方式的成因，长期需正式 AppID 解除 | 【已验证】现象，解决路径【未验证】 |
| 8 | 建议做长稳与内存测试 | 【未验证】 |
| 9 | **本机合成鼠标注入链路在 03:00 后失效**（DevTools UI 与模拟器均不再响应合成点击，而窗口/焦点探测正常），导致阶段 D 交互无法验证；建议在远程会话重连或虚拟机重启后复测 | 【已验证】（现象）/【未验证】（恢复） |

---

## 14. 附录：证据文件清单

> 路径均**相对本文件所在 docs 目录**。`evidence/screenshots/` 与 `evidence/logs/` 位于上级目录，故写作 `../evidence/...`。

### 14.1 阶段 A

| 文件 | 说明 | 等级 |
| --- | --- | --- |
| `../evidence/screenshots/A_tap0_1.png` | 修复后第 0 帧 | 【已验证】 |
| `../evidence/screenshots/A_tap1_1.png` | 修复后第 1 次点击 | 【已验证】 |
| `../evidence/screenshots/A_tap2_1.png` | 修复后第 2 次点击 | 【已验证】 |
| `../evidence/screenshots/A_tap3_1.png` | 修复后第 3 次点击 | 【已验证】 |
| `../evidence/screenshots/A_tap4_1.png` | 修复后第 4 次点击 | 【已验证】 |
| `../evidence/screenshots/A_tap5_1.png` | 修复后第 5 次点击 | 【已验证】 |
| `../evidence/screenshots/A2_tap0_1.png` … `../evidence/screenshots/A2_tap5_1.png` | 缺陷序列原始截图（逐字节相同） | 【已验证】 |
| `../evidence/screenshots/crops/strip_B.png` | 整轮裁剪条 0,0,1,2,3,4,5 | 【已验证】 |
| `../evidence/screenshots/crops/A_tap0.png` … `crops/A_tap5.png` | 逐帧裁剪 | 【已验证】 |
| `../evidence/logs/stageA-tap.log` | 游戏侧点按日志（boot + tap n=1..5） | 【已验证】 |

### 14.2 控制台错误三分类

| 文件 | 说明 | 等级 |
| --- | --- | --- |
| `../evidence/screenshots/A_console_max_1.png` | 最大化调试器，徽标 ❌2 ⚠️1 | 【已验证】 |
| `../evidence/screenshots/crops/console_err_top.png` | 工具自身错误（`getDeviceOrientation` @ `WAGame.js`）与游客模式授权错误（`-80002 webapi_getwxaasyncsecinfo:fail`） | 【已验证】 |
| `../evidence/screenshots/crops/console_err_bottom.png` | 控制台错误列表下半部分 | 【已验证】 |
| `../evidence/screenshots/crops/console_max.png` | 控制台最大化概览 | 【已验证】 |
| `../evidence/screenshots/crops/console_v5_full.png` | 控制台全量视图 | 【已验证】 |

### 14.3 阶段 B

| 文件 | 说明 | 等级 |
| --- | --- | --- |
| `../evidence/screenshots/B1_cube_boot.png` | 立方体启动帧 + HUD 叠加 | 【已验证】 |
| `../evidence/screenshots/B2_cube_drag_1.png` | 合成拖拽后的旋转帧 | 【已验证】 |
| `../evidence/screenshots/crops/b2_sim.png` | 模拟器区域裁剪 | 【已验证】 |
| `../evidence/screenshots/crops/b3_console.png` | 阶段 B 控制台截图 | 【已验证】 |
| `../evidence/screenshots/crops/b_cube_gl1.png` | WebGL 上下文建立后的画面 | 【已验证】 |
| `../evidence/screenshots/crops/b_cube_clean_sim.png` | 干净模拟器画面 | 【已验证】 |
| `../evidence/screenshots/crops/b_restart1.png` | 带软件 WebGL 参数重启后的状态 | 【已验证】 |
| `../evidence/screenshots/crops/b_cube1.png` | 立方体画面 | 【已验证】 |

### 14.4 构建产物（NAS 侧）

| 文件 | 说明 | 等级 |
| --- | --- | --- |
| `../wechat-3d/dist/stage-b/bundle.js` | esbuild 产物，542354 B | 【已验证】 |
| `../wechat-3d/dist/stage-b/adapter.js` | 手写适配器，9182 B | 【已验证】 |
| `../wechat-3d/dist/stage-b/game.js` | 入口加载器，1096 B | 【已验证】 |
| `../wechat-3d/dist/stage-b/game.json` | 小游戏清单，38 B | 【已验证】 |
| `../wechat-3d/dist/stage-b/project.config.json` | `compileType=game`、`touristappid`、`isGameTourist=true` | 【已验证】 |
| `../wechat-3d/src/platform/adapter.js` | 适配器源码 | 【已验证】 |
| `../wechat-3d/src/platform/runtime.ts` | 运行时辅助 | 【已验证】 |
| `../wechat-3d/src/shared/hud.ts` | HUD | 【已验证】 |
| `../wechat-3d/src/cube/main.ts` | 阶段 B 主逻辑 | 【已验证】 |
| `../wechat-3d/build.mjs` | 构建脚本 | 【已验证】 |
| `../wechat-3d/templates/project.config.json` | 项目配置模板 | 【已验证】 |
| `../wechat-3d/dist/stage-c/bundle.js` | 阶段 C esbuild 产物，560206 B | 【已验证】 |
| `../wechat-3d/dist/stage-c/adapter.js` | 手写适配器（同阶段 B），9182 B | 【已验证】 |
| `../wechat-3d/dist/stage-c/game.js` | 守卫式入口加载器，1434 B | 【已验证】 |
| `../wechat-3d/dist/stage-c/game.json` | 小游戏清单，38 B | 【已验证】 |
| `../wechat-3d/src/island/world.ts` | 阶段 C 几何、取景与光照（18914 B） | 【已验证】 |
| `../wechat-3d/src/island/main.ts` | 阶段 C 主逻辑：相机 / 触摸 / 射线拾取 / HUD（12127 B） | 【已验证】 |
| `../wechat-3d/dist/stage-d/bundle.js` | 阶段 D esbuild 产物，572363 B | 【已验证】 |
| `../wechat-3d/src/stage-d/main.ts` | 阶段 D 主逻辑（447 行） | 【已验证】 |
| `../wechat-3d/src/stage-d/world-d.ts` | 阶段 D 世界扩展 | 【已验证】 |
| `../wechat-3d/src/stage-d/highlight.ts` | 阶段 D 选中高亮 | 【已验证】 |

### 14.5 脚本与工具（VM 侧操作记录）

| 文件 | 说明 | 等级 |
| --- | --- | --- |
| `../win/game.stageA.v2.js` | 阶段 A 夹具（7003 B，md5 `255157cc8eb38ac2307826265ec4ecf5`） | 【已验证】 |
| `../win/mcp_audit5.ps1` | MCP 暴露面只读审计脚本 | 【已验证】 |
| `../win/ide_enable_port.ps1` | IDE 服务端口开启脚本（含回滚说明） | 【已验证】 |
| `../win/launch_devtools_swiftshader.ps1` | 软件 WebGL 重启脚本 | 【已验证】 |
| `../win/relaunch_devtools_gpu2.ps1` | 安全重启脚本（事故后重写版） | 【已验证】 |
| `../win/stageA_restart_devtools.ps1` | 回滚：不带额外参数的重启 | 【已验证】 |

### 14.6 VM 侧运行日志的归档情况

阶段 A / B / C 的沙箱内日志与 WebGL 探针日志已按原文摘录归档到 NAS（内容为 VM 内文件的逐字摘录）：

| 归档文件 | 来源 | 等级 |
| --- | --- | --- |
| `../evidence/logs/stageA-tap.log` | 阶段 A 点按日志（`tap.log`） | 【已验证】 |
| `../evidence/logs/stageB-runlog-evidence.log` | 阶段 B `run.log`（修复前失败 + 修复后成功 + 拖动/点按） | 【已验证】 |
| `../evidence/logs/stageB-stage-err-evidence.log` | 阶段 B `stage-err.log` | 【已验证】 |
| `../evidence/logs/stageC-runlog-evidence.log` | 阶段 C `run.log`（射线拾取决定性证据） | 【已验证】 |
| `../evidence/logs/glprobe-evidence.log` | WebGL 可用性探针 `glprobe.log` | 【已验证】 |
| `../evidence/logs/stageD-runlog-evidence.log` | 阶段 D `run.log` + 合成鼠标注入失效现场记录 | 【已验证】 |

VM 侧原始文件位置：
`%LOCALAPPDATA%\微信开发者工具\User Data\<profile>\WeappSimulator\WeappFileSystem\<hash>\wx6ac3f5090a6b99c5\usr\`

MCP 审计的实时输出（监听端口、防火墙规则、配置 md5）经通道 A 只读取得，其内容已写入第 5 节，未另存为独立文件。【已验证】（内容）

---

*本报告仅陈述上述已取证事实；凡未取得证据者，均标注为【推断】或【未验证】。*
