# 3D 原型 · 验证结果与性能资源记录

> 日期：2026-10-08 ｜ 环境：NAS Docker `node:22-bookworm-slim`（Node v22.23.3 / npm 10.9.9）+ headless Chromium 154（CDP `127.0.0.1:9222`）
> 原始数据：`docs/verify-report.json`（由 `tools/cdp-verify.mjs` 自动生成，可复跑）

---

## 一、验证执行记录（逐条对照要求）

| # | 要求 | 结果 | 证据 |
| --- | --- | --- | --- |
| 1 | TypeScript 类型检查 | ✅ 通过（`tsc --noEmit` 0 错误，strict 模式） | 构建日志 `npm run build` |
| 2 | 生产构建 | ✅ 通过（`vite build` 1.5s，12 模块） | `dist/` 产物 |
| 3 | 竖屏视口打开原型 | ✅ 390×844（DPR 2）竖屏视口渲染正常 | `screenshots/01-default.png` |
| 4 | 鼠标拖动旋转 ≥ 10 次 | ✅ **10/10 全部生效**（页面内计数 0 → 10） | `verify-report.json: mouseDrag` |
| 5 | 触摸拖动模拟 ≥ 10 次 | ✅ **10/10 全部生效**，使用 CDP `Input.dispatchTouchEvent` 原生触摸事件（非鼠标伪造），页面内触摸计数 0 → 10 | `verify-report.json: touchDrag.method` |
| 6 | 点击市政厅 / 建筑 / 居民，名称与模型一致 | ✅ 4/4 一致：`市政厅`→市政厅、`建筑·住宅占位`→建筑·住宅占位、`建筑·商业占位`→建筑·商业占位、`居民·小明（占位）`→居民·小明（占位）；**附加对照组**：点击空白天空返回 `null`（证明射线真实求交、无固定坐标假点击） | `verify-report.json: clickPick` |
| 7 | 截图 3 张 | ✅ `01-default.png` 默认浮空岛；`02-rotated.png` 旋转后（方位角 39.6° → 598.2°，明显不同视角）；`03-clicked.png` 点击反馈（名称条「市政厅」+ 对象高亮） | `screenshots/` |
| 8 | 真机 | ⚠️ **真机未验证**（本轮无真实手机） | — |
| 9 | 微信开发者工具 | ⚠️ **微信端未验证**（本轮无微信开发者工具） | — |

### 旋转精度抽查

- 定量抽查：单次 200 px 水平拖动 → 方位角 +85.9°，与理论值（200 × 0.0075 rad/px = 85.9°）**完全一致**，拖动映射无漂移。

---

## 二、性能与资源记录

### 源码与依赖

| 指标 | 数值 |
| --- | --- |
| 原型源码文件数 | **8 个 `.ts`**（`main.ts` / `config.ts` / `platform/types.ts` / `platform/browser.ts` / `world/island.ts` / `world/props.ts` / `controls/orbit.ts` / `interaction/pick.ts`） |
| 其它工程文件 | `index.html`、`vite.config.ts`、`tsconfig.json`、`package.json`、`docker-compose.yml`、`tools/cdp-verify.mjs` |
| npm 直接依赖 | **4 个**：`three@0.186.1`（运行时）、`@types/three@0.186.0`、`typescript@5.9.3`、`vite@6.4.4`（后三者为开发依赖） |
| npm 总包数（含传递依赖） | **23 个**（`npm install` 实际安装；lockfile 共 24 条含根包） |

### 生产构建体积

| 产物 | 原始 | gzip |
| --- | --- | --- |
| `dist/index.html` | 2.22 kB | 1.09 kB |
| `dist/assets/index-*.js`（原型代码） | 11.66 kB | 4.80 kB |
| `dist/assets/three-*.js`（three 单独 chunk） | 525.82 kB | 131.74 kB |
| **JS 合计** | **537.48 kB** | **136.54 kB** |

> 对微信小游戏的意义：gzip 后 136.5 kB 的 JS，相对 4 MB 主包限额占比很小（**资料推断**，未在微信侧验证）。

### 纹理 / 模型 / 几何

| 指标 | 数值 |
| --- | --- |
| 纹理数量与尺寸 | **0 张图片纹理**（全部纯色材质）；运行时 `renderer.info.memory.textures = 3`（阴影贴图等内部渲染纹理） |
| 模型数量 | **0 个外部模型文件**（无 glTF / obj / fbx）；**22 个网格**由 Three.js 内置几何体程序化拼装 |
| 几何体 / 材质 | 18 个几何体、17 个材质 |
| 三角形数量 | 场景几何 **580 三角形**；单帧渲染统计 **1116–1136**（含阴影通道重复绘制） |
| Draw call | 44–46（含阴影通道） |

### 浏览器运行时表现

| 指标 | 数值 |
| --- | --- |
| 运行时报错 | **0**（`window.onerror` / `unhandledrejection` / console error / CDP exception 全为空；调试期曾有 favicon 404，已修） |
| FPS（headless 软件渲染 SwiftShader） | **22–33 FPS**（3 次采样：31 / 28 / 31 等） |
| 桌面拖动旋转流畅度 | 拖动 10 次全部生效、角度精确；**注意：该 FPS 是无 GPU 的软件渲染下限值，不能代表真机**（真机未验证） |
| 竖屏视口显示 | ✅ 390×844 下整岛、道路、市政厅、两建筑、居民全部可见，名称条与提示条不遮挡主体 |
| 缩放（实验功能） | 滚轮与双指 pinch 已实现并限幅（0.65×–2.1×）；headless 无法模拟真实双指手感，**稳定性「尚未验证」**，若真机不稳定可整体移除（只删 `OrbitController.handleWheel/pinch` 分支，不影响旋转与点击） |

---

## 三、验证方法说明（可复现）

1. 构建：`docker run --rm -u 1000:1000 -v .../3d-spike:/app -w /app node:22-bookworm-slim npm run build`
2. 服务：`vite preview`（Docker 内，端口 `192.168.1.38:4180`）
3. 验证：`node tools/cdp-verify.mjs http://192.168.1.38:4180/ screenshots docs/verify-report.json`
   - 输入命令「发出即忘」（该 Chromium 的 `Input.*` 回执会挂起），所有效果通过页面内 `window.__spike.stats` 读取确认；
   - 点击坐标来自 `window.__spike.project(name)`（把 3D 对象包围盒中心投影到屏幕），再走真实 CDP 鼠标事件 → 页面内射线检测，**没有任何固定坐标伪造**。
