# 《我要当市长》DSH 3D 原型 —— 公网预览补齐与穿模复核报告

> **本任务为 DSH 独立对照实验。MIMO 不得读取、修改或删除本目录。
> DSH 也不得读取或修改 MIMO 的工作目录。**

| | |
|---|---|
| 报告方 | DSH（deepseek-v4.1-flash） |
| 工作目录 | `/vol1/ai/projects/wyszz-new/3d-spike-ds/` |
| 报告日期 | 2026-10-08 |
| 本轮范围 | ① 穿模复核与修复 ② hynixing 公网预览配置 ③ 外网验证 ④ 真机访问地址 |
| 隔离状态 | 未读取 `3d-spike-mimo/`、`app/`、`little-town/`、`3d-spike/`；未读取任何其它模型产物 |
| 前端版本 | three r186 (0.186.1) + TypeScript 5.9.3 + Vite 8.3.3 |

---

## 0. 结论摘要（先说结论）

| 本轮任务 | 结果 |
|---|---|
| ① 穿模复核与修复 | ✅ **完成**。网格级检测出 **10 处真实穿模**，全部集中在道路与市政厅、道路与商店之间；已按「只调位置」修复，**复测 0 处穿模** |
| ② hynixing 公网预览配置 | ❌ **未完成（阻塞）**。本机不存在可自行扩展的本地代理入口，新增公网入口必须**新建 DNS 记录 + 新建隧道**，属于「修改域名」，且目标子域名未指定 → 按规则**立即停止**，不猜域名、不读凭据 |
| ③ 外网验证 | ⛔ **未做**。无真实外网通道，**不声称外网可用** |
| ④ 真机访问地址 | ⚠️ 只能提供**局域网**地址：`http://192.168.1.38:5190/`（已实测）。**公网地址待主控方按 §7 清单开通后下发** |

> **一句话**：穿模已彻底清干净并复测通过；局域网手机地址已可用；公网那一步卡在「需要一个新的子域名 + 需要动用 Cloudflare 凭据」，这两件事都必须由主控方决定，DSH 不自行猜测、不自行改域名。

---

## 1. 现状检查结果（对应任务第二节）

只检查了 `3d-spike-ds`，未触碰其他目录。

### 1.1 当前源码、构建方式、运行端口

| 项 | 值 |
|---|---|
| 源码 | `src/` 下 10 个 `.ts` + 1 个 `.css`，约 1255 行 |
| 构建 | `npm run build` → Vite 8.3.3（Rolldown 类原生打包），~0.33 秒 |
| 产物 | `dist/index.html` + `dist/assets/index-CsO9wMzL.js` + `index-CwFv4K4e.css` |
| 产物体积 | JS 557,760 B（gzip -9 **139,379 B**）／CSS 1,999 B（979）／HTML 1,337 B（881） |
| 运行时依赖 | 仅 `three` 一个 |

### 1.2 当前 preview 服务是否仍在运行

| 服务 | 地址 | 状态 |
|---|---|---|
| 上一轮启动的 `vite preview`（后台作业 `bash-128`） | `http://127.0.0.1:5181/` | ✅ 仍在运行（仅本机回环） |
| 本轮新增的静态服务器 | `http://192.168.1.38:5190/` | ✅ 运行中（局域网可访问） |

### 1.3 当前 hynixing 反向代理/隧道/站点配置中是否已有可用入口

**结论：没有可自行扩展的入口。** 依据（全部为实测）：

1. **hynixing 全部由 Cloudflare 隧道承载，且隧道是「远端托管」的。**
   `files.hynixing.cn`、`nas.hynixing.cn` 均解析到 Cloudflare 地址（`2606:4700:…`）。
   `/etc/cloudflared/` 下**只有 7 个 `*-token` 文件，没有任何 `config.yml`**：
   ```
   hermes-chat-token  hermes-console-token  hermes-files-token  hermes-ledger-token
   hermes-power-token  mc-dl-token  token
   ```
   隧道以 `run --token-file …` 方式启动；创建它的既有脚本
   `/vol1/ai/_scripts/nas-console-cf-deploy.py` 里明确写着
   `"config_src": "cloudflare"` —— 即 **hostname → 本地服务的 ingress 规则存在
   Cloudflare 云端，不在本机任何文件里**。因此本机**没有**一个「加一行 upstream」
   就能生效的代理配置。
2. **fnOS 系统 nginx 与 hynixing 无关。**
   运行中的 nginx 是 `/usr/trim/nginx/sbin/nginx`（编译前缀 `/usr/trim/nginx`），
   监听 80/443/5666/5667 且全是 `default_server`。
   在 `/usr/trim/nginx/conf/`、`/etc/nginx/`、`/vol1/ai/_nginx/` 三个位置
   grep `hynixing` → **0 条命中**。改它有实际风险（它是 fnOS 系统服务），
   且属于「修改 NAS 系统配置」，本轮明确禁止。
3. `/vol1/ai/_nginx/conf/nginx.conf` 是一份**未在运行**的配置（只监听
   Tailscale 地址 `100.114.191.104:8080/8081`，当前无进程监听这两个端口）。

### 1.4 当前是否已有独立的公网代理方式

已有的独立公网方式就是「**一个服务 = 一条独立隧道 = 一个独立子域名**」，
共 7 条，每条都绑定在既有业务上（files / console / ledger / power / chat / mc）。
**没有**通用的、可任意挂载静态站点的公网入口。

### 1.5 当前是否有端口冲突

无冲突。本轮特意核对了可用端口：`5190/5191/5192` 均空闲，选用 **5190**。
（注：`4180` 被容器 `wyszz-3d-spike-preview` 占用 —— **该容器不是 DSH 创建的，
DSH 全程未启动、未修改、未停止任何容器**。`5173/5174` 分别为 `wyszz-probe`/`wyszz-app`。）

---

## 2. 穿模复核方法与基线结果

### 2.1 为什么不能靠肉眼

浮空岛在竖屏里只占约 87% 宽度，道路宽 1.8 个世界单位，
「台阶扎进路面 0.02」这种量级在 828×1792 的截图上只有约 1 像素。
**肉眼判不出，必须量化。**

### 2.2 检测器

新增 `scripts/clash-check.mjs`（`npm run clash`）：

- 在真实页面里遍历场景，取**每个网格的所有顶点**变换到世界空间，算出精确 AABB；
- 对**跨顶层对象**的网格两两做相交测试，报出**三轴重叠量**与重叠体积；
- 同一对象内部的重叠不计（例如市政厅的台阶本来就该贴着主楼）；
- 阈值 `EPS = 0.002`：小于 2mm 视为「相切」，不算穿模。

> **为什么要做到网格级**：第一版只算「顶层对象合并 AABB」，报出 7 对相交，
> 其中 `道路↔树木`、`道路↔居民` 是**误报** —— 合并 AABB 把「树冠的横向跨度」
> 和「路缘石的高度」都算了进去。降到网格级后这两对自动消失，剩下 10 对全部为真。
> 这一步是必要的：**否则会去修不存在的问题。**

### 2.3 基线结果（修复前）

顶层对象 10 个，网格 64 个。**网格级真实穿模 10 对，全部与道路有关：**

| # | 对象 A | 对象 B | 重叠 (x, y, z) | 重叠体积 | 说明 |
|---|---|---|---|---|---|
| 1 | 道路 | 市政厅 | (3.10, 0.16, **0.40**) | **0.1984** | **前台阶**埋进路面板，台阶顶 0.18 高出路面 0.16 |
| 2 | 道路 | 市政厅 | (3.10, 0.18, 0.14) | **0.0781** | 前台阶切进**路缘石** |
| 3 | 道路 | 市政厅 | (2.70, 0.20, 0.09) | **0.0486** | 主楼**前墙**切进路缘石 |
| 4 | 道路 | 建筑·商店 | (2.31, 0.195, **0.0946**) | **0.0426** | 商店旋转后的**最近角**插进路缘石 |
| 5 | 道路 | 市政厅 | (0.62, 0.195, 0.07) | 0.0085 | 正门门体 |
| 6 | 道路 | 市政厅 | (0.62, 0.155, 0.05) | 0.0048 | 门框 |
| 7–10 | 道路 | 市政厅 | (≈0.19, ≈0.175, ≈0.10) | 0.0033 ×4 | 门廊 **4 根立柱**穿透路面板 |

**根因（一句话）**：市政厅与商店是**先建模、后摆位**的，摆位时没有对着道路的
占位盒核算，导致两者的**正面装饰构件**（台阶/门/立柱/店角）正好压在
道路板 + 路缘石的带状区域内。

### 2.4 基线中被排除的误报

| 对 | 合并 AABB 结论 | 网格级真相 |
|---|---|---|
| 道路 ↔ 树木 | 重叠 (1.088, 0.2, 0.098) | **无穿模**。树冠虽横向跨到路面投影内，但树冠在 y≥0.585，路面只到 y=0.20；该高度上只有树干（半径 0.09），离路缘石还有 0.37 |
| 道路 ↔ 居民 | 重叠 (0.671, 0.04, 0.547) | **无穿模**。居民脚底 y=0.16 **正好等于**路面顶 0.16（站在路上，符合预期）；0.04 的 y 重叠来自路缘石/虚线的 AABB，不在居民所在位置 |

---

## 3. 穿模实际修改内容

**改动文件（1 个）**：`/vol1/ai/projects/wyszz-new/3d-spike-ds/src/scene/world.ts`
**改动性质**：仅调整两个 `Group` 的 `position`。**未改任何几何、材质、名称、旋转、光照或交互逻辑。**

### 3.1 市政厅

```diff
-  g.position.set(-2.6, 0, -2.05);
+  // 穿模修复（2026-10-08）：原为 (-2.6, 0, -2.05)。
+  // 原位置下市政厅的前台阶/正门/门廊立柱整体压在道路上……
+  g.position.set(-2.4, 0, -2.67);
```

| | 原值 | 新值 | 位移 |
|---|---|---|---|
| x | −2.60 | −2.40 | **+0.20**（向岛心） |
| z | −2.05 | −2.67 | **−0.62**（远离道路） |

**效果**：整组世界 z 上界由 **−0.50 → −1.12**，完全退到路缘石外沿（−1.04）之后，
留 **0.08** 余量。同时 x 向岛心挪 0.20，使最外侧角点到岛缘仍有 **0.51** 余量。

### 3.2 商店

```diff
-  g.position.set(3.15, 0, 1.95);
+  // 穿模修复（2026-10-08）：原为 (3.15, 0, 1.95)。
+  // 商店绕 y 轴旋转 0.3 rad，其最近角（局部 (-0.975, -0.75)）落在世界 z=0.945……
+  g.position.set(3.15, 0, 2.2);
```

| | 原值 | 新值 | 位移 |
|---|---|---|---|
| z | 1.95 | 2.20 | **+0.25**（远离道路） |

**效果**：店身最近点由 z=**0.945 → 1.195**，退到路缘石外沿（1.04）之后，
留 **0.155** 余量。

### 3.3 为什么这样修而不是改几何

- 两处的**相对关系本来就是对的**（台阶该在楼前、店角该是方的），错的是**整组离路太近**；
- 任务允许的调整手段就是「位置、缩放或高度」，**纯平移是最小改动**；
- 平移不触碰任何网格数据，因此**不可能**改变对象名称、射线命中或渲染批次。

---

## 4. 修复后复测

```
$ npm run clash
网格级真实穿模 相交对象对: 0
  （无）

【仅两个轴重叠 = 共面贴合，非穿模】: 10
  浮空岛 <-> 道路      overlap=(11.6, 0, 2.08)      ← y 重叠恰为 0：道路正坐在草地上
  浮空岛 <-> 市政厅     overlap=(3.1, 0, 2.858)      ← y 重叠恰为 0
  浮空岛 <-> 建筑·民居   overlap=(2.072, 0, 2.072)    ← y 重叠恰为 0
  浮空岛 <-> 建筑·商店   overlap=(2.682, -0.005, 2.641) ← 5mm 悬空，故意的防 z-fighting 偏移
  浮空岛 <-> 居民      overlap=(0.67, -0.16, 0.548)  ← 居民站在路面上，脚底 = 路面顶
  浮空岛 <-> 树木      overlap=(10.448, 0, 5.799)   ← y 重叠恰为 0
  道路  <-> 市政厅      overlap=(3.1, 0.2, -0.08)    ← z 已是 -0.08：留出 0.08 间隙
  道路  <-> 建筑·民居   overlap=(2.072, 0.2, -0.074) ← 留出 0.074 间隙
  市政厅 <-> 建筑·民居   overlap=(-1.764, 2.545, 2.066) ← x 相距 1.764
  建筑·民居 <-> 建筑·商店 overlap=(1.177, 1.305, -2.122) ← z 相距 2.122
```

**判定：0 处穿模。** 剩余 10 条全部满足「至少一个轴的重叠为负或恰为 0」，
即**互相分离或恰好相切**，属于正常的「物体放在地面上」的贴合，不是交叠。

**同时复核的功能项全部未受影响：**

| 检查 | 结果 |
|---|---|
| 对象名称 | 市政厅 / 建筑·民居 / 建筑·商店 / 居民 —— **一字未改** |
| 射线点击（4 个对象） | ✅ 全部命中且名称正确 |
| 空白处负样本 | ✅ 正确不命中 |
| 鼠标拖动旋转 | ✅ 10/10 |
| 触摸拖动旋转 | ✅ 10/10 |
| 滚轮缩放 / 双指缩放 | ✅ 均生效 |
| 竖屏适配 | ✅ 4 种竖屏尺寸无溢出 |
| 控制台错误 / 页面错误 | ✅ 0 / 0 |

### 4.1 三种视角的肉眼复核（对应任务要求）

| 视角 | 方位角 / 极角 | 截图 |
|---|---|---|
| 默认 | 0.620 / 0.950 | `shots/01-default-island.png` |
| 旋转 A | 1.798 / 1.136 | `shots/02-rotated-island.png` |
| 旋转 B（第三个角度） | 1.054 / 0.888 | `shots/03-rotated-angle-b.png` |

另加两张**穿模证据特写**（拉近 6 档滚轮后按对象投影位置裁剪）：

- `shots/05-closeup-cityhall_front.png` —— 市政厅正前方：台阶与道路之间是一条**完整的草地条**，无任何构件插进路面；
- `shots/06-closeup-shop_curb.png` —— 商店与路缘石交界：店角与路缘石之间有**清晰草地间隙**。

---

## 5. 仍然存在的观察项（**均非穿模**，未改，记录备查）

| # | 位置 | 现象 | 原因 | 是否影响视觉/点击 |
|---|---|---|---|---|
| 1 | 建筑·商店 店面 | 橱窗、招牌、雨棚开在**背向道路**的一侧（道路在 z≤0.9，商店 z≥1.196） | 建模时店面定在局部 +z，摆位时该朝向恰好背离道路 | **不影响点击**（射线仍命中整组）；视觉上「店铺背对马路」，属**朝向设计问题**，非穿模。修它需要**旋转 180°**，超出本轮允许的「位置/缩放/高度」范围 → **留给主控方决定** |
| 2 | 建筑·商店 底面 | 底面 y=0.005，比草地高 5mm | 全场景统一的**防 z-fighting 偏移惯例**（道路虚线同样是 −0.005 埋入） | 不可见（约 0.3 px），**有意为之** |
| 3 | 岛底晶体 | `world.ts` 注释写「一点点视觉焦点」，但**完全埋在岩锥内部，不可见** | 晶体在 (−0.4, −2.6, 0.4)，离轴 0.566，而该高度岩锥内切半径 ≈ 3.88 → 深埋 | 不是穿模（在自身对象内部）。**属建模冗余**：一个写了意图但零视觉贡献的几何体。修它需要把它外移，超出本轮范围 → **留给主控方决定** |
| 4 | 岛底嵌岩 ×5 | 4 块可见（穿出岩锥 0.19–0.99），第 1 块 (3.1, −2.2, 2.0) 几乎全埋 | 同上，手工摆位未按岩锥半径核算 | **有意为之**（就是要「嵌」在截面里制造层次感），可见的 4 块效果符合设计 |
| 5 | 树木 3 棵 | 互不相交（最近两棵间距 1.97 > 树冠半径和 1.12） | — | 无问题 |

> 观察项 1、3 都**不影响本轮验收**（不是穿模、不影响点击），已如实记录。
> 若主控方希望一并处理，请明确授权 —— 本轮按任务边界**只修穿模、不动其他**。

---

## 6. 局域网地址与验证结果

### 6.1 服务

新增 `scripts/serve-dist.mjs`（`npm run serve`），一个**极简静态服务器**：

| 特性 | 说明 |
|---|---|
| 端口 | **5190**（独立，与本机任何既有服务都不冲突） |
| 监听 | `0.0.0.0:5190` → 局域网可访问 |
| 发布范围 | **只有 `dist/`**，且**只认白名单扩展名**（html/js/css/png/svg/woff/glb…） |
| 目录列表 | **关闭**（目录路径一律 404） |
| 源码/映射/配置 | **不发布**（`.map`、`.json`、`.env`、`.ts` 全部 404） |
| 路径穿越 | 拒绝（`..`／反斜杠／空字节／绝对路径） |
| 错误信息 | 固定文案，**不含任何文件系统路径** |
| 缓存 | `index.html` = `no-cache`（保证刷新拿到最新资源清单）；带哈希的 `assets/*` = 一年不可变缓存 |
| 安全头 | `X-Content-Type-Options: nosniff`、`Referrer-Policy: no-referrer`、`X-Frame-Options: SAMEORIGIN` |
| 后端 | **无**。不代理、不执行、不读任何密钥 |

**手机真机访问地址（同一 WiFi）：`http://192.168.1.38:5190/`**

### 6.2 局域网验证结果（**全部实测通过**）

| # | 验证项 | 结果 |
|---|---|---|
| 1 | **局域网地址可访问** | ✅ `GET http://192.168.1.38:5190/` → **200**，1337 B，`text/html` |
| 2 | JavaScript 加载 | ✅ `assets/index-CsO9wMzL.js` → 200，557,760 B，`text/javascript` |
| 3 | CSS 加载 | ✅ `assets/index-CwFv4K4e.css` → 200，1,999 B，`text/css` |
| 4 | 模型/纹理 | ✅ 本原型**零外部资源**（0 贴图、0 模型文件），全部几何在 JS 内程序化生成 → 不存在资源 404 风险 |
| 5 | **刷新路径** | ✅ 连续加载 **3 次**：每次请求数均为 3（html+js+css），**4xx/5xx = 0**，失败请求 = 0，控制台错误 = 0 |
| 6 | 浮空岛可以旋转 | ✅ 真实鼠标事件跑满：鼠标 10/10、触摸 10/10 |
| 7 | 可以缩放 | ✅ 滚轮 + 双指捏合均生效 |
| 8 | 点击名称正确 | ✅ 市政厅 / 建筑·民居 / 建筑·商店 / 居民 **全部正确**；空白处正确不命中 |
| 9 | 竖屏无裁切/横向滚动 | ✅ `scrollWidth > innerWidth` = **false**；4 种竖屏尺寸均无溢出 |
| 10 | 无目录列表 / 调试密钥 / 内部路径 | ✅ `/assets/` → 404；`.env`、`package.json`、`src/main.ts`、`../package.json` → **全部 404**；页面无调试面板 |

**关键佐证**：局域网地址与 `127.0.0.1:5181` 生成的 6 张截图**逐字节相同**
（129064 / 118514 / 123522 / 136910 / 46183 / 76068 B）——
说明经局域网网卡取到的内容与回环**完全一致**，没有代理改写、没有 MIME 错误、没有降级。

---

## 7. hynixing 公网地址与验证结果

### 7.1 结果：**未完成（阻塞）**

| 项 | 状态 |
|---|---|
| hynixing 公网地址 | **不存在**。DSH 未创建、未下发 |
| 公网配置 | ❌ **未完成** |
| 外网实测 | ⛔ **未做**（无通道） |

> ### ⛔ 本文档**不写**「公网配置已完成，但外网实测待主控方确认」
> 任务原文规定该措辞用于「**公网配置已完成、只是没有真实外网通道测试**」的情形。
> 本轮的实际情形是**公网配置本身就没有完成**，因此按任务另一条规定
> 「如果公网配置无法完成，必须如实报告阻塞原因」处理。**不谎报已完成。**

### 7.2 阻塞原因（3 条，均为实测事实）

1. **本机没有可自行扩展的代理入口。**
   hynixing 的 7 条隧道全是「远端托管」(`config_src: cloudflare`)，
   ingress 规则在**云端**，本机只有 `*-token` 文件 —— 没有任何本地文件
   「加一行 upstream」就能生效。fnOS 系统 nginx 里 hynixing 命中数为 **0**，
   且它是系统服务，改动属禁止项。
2. **新增公网入口 = 新增 DNS 记录 = 修改域名。**
   给原型一个公网地址，必须**新建一个子域名 CNAME** 指向新隧道。
   任务明确禁止 DSH「自行注册或修改域名」。
3. **动用 Cloudflare 凭据需要授权。**
   建隧道 + 写 DNS 需要 `/vol1/ai/agents/hermes/access/cf.env` 里的
   API Token（该文件**存在**，但按规则 **DSH 全程未读取其内容**）。

### 7.3 缺少的具体信息（请主控方补齐）

| # | 缺失项 | 为什么 DSH 不能自己决定 |
|---|---|---|
| ① | **目标子域名** | 任务明确「不要猜测域名」。DSH 不知道主控方想用哪个名字 |
| ② | **是否授权使用 Cloudflare 凭据** | 属「修改域名」，需主控方授权 |
| ③ | **是否加 Cloudflare Access 保护** | 参照 `nas.hynixing.cn` 用了邮箱一次性码；3D 原型是否也需 |
| ④ | **暴露范围确认** | 是否允许该原型**对全网公开、无鉴权**（原型无任何敏感数据，但需主控方拍板） |

### 7.4 主控方最小操作清单（二选一，约 3–5 分钟）

> DSH 已把能做的都做完了：**静态服务已就绪、隧道脚本已写好并自测了拒绝逻辑**。
> 剩下的是「决定域名」+「授权凭据」两步。

#### 前置（已完成，无需操作）
```bash
cd /vol1/ai/projects/wyszz-new/3d-spike-ds
npm run build && npm run serve      # 已在 0.0.0.0:5190 运行
curl -I http://192.168.1.38:5190/   # 已验证 200
```

#### 方案 A（推荐）：用 DSH 写好的脚本，一条命令

新增 `scripts/deploy-public-preview.py`，派生自已验证过的
`nas-console-cf-deploy.py`，沿用「独立隧道 + 独立端口 + 独立 systemd 单元」模式。
它**刻意不提供默认域名**：不传 `PUBLIC_HOST` 直接退出（已实测 `exit 2`），
从机制上杜绝猜测。

```bash
cd /vol1/ai/projects/wyszz-new/3d-spike-ds
PUBLIC_HOST=<你决定的子域名> \
  /mnt/ssd/apps/trim.hermes/runtime/python/bin/python3 scripts/deploy-public-preview.py
sudo systemctl daemon-reload && sudo systemctl enable --now cloudflared-wyszz-3d-spike
```
脚本会依次完成：建隧道 `wyszz-3d-spike` → 写 ingress `HOST → 127.0.0.1:5190`
→ 落令牌到 `/etc/cloudflared/wyszz-3d-spike-token`(600) → 写 systemd 单元
→ 建 DNS CNAME（proxied）→ 建 Access 应用（可用 `PUBLIC_NO_ACCESS=1` 关闭）。
**脚本不打印任何令牌内容。**

#### 方案 B：纯 Cloudflare 后台手工点

1. Zero Trust → Networks → Tunnels → 新建隧道 `wyszz-3d-spike`；
2. Public Hostname 填你选的子域名，Service 填 `http://127.0.0.1:5190`；
3. 按提示把连接器装到本机（或复用方案 A 生成的 systemd 单元）；
4. （可选）Access → Applications → 给该域名加「邮箱一次性码」策略。

#### 开通后 DSH 可继续做的验证（请把域名回给我）
```bash
SPIKE_URL=https://<你开通的域名>/ node scripts/e2e.mjs       # 全量断言
SPIKE_URL=https://<你开通的域名>/ SPIKE_OUT=shots/public SPIKE_LABEL=public node scripts/shots.mjs
```
届时补齐任务要求的「公网地址打开后的页面」「公网地址打开后的点击反馈」两张截图。

---

## 8. 公网暴露范围

### 8.1 当前实际暴露范围（**只到局域网**）

| 范围 | 是否暴露 | 内容 |
|---|---|---|
| 公网（Internet） | ❌ **完全没有** | 无公网入口、无 DNS 记录、无隧道 |
| 局域网 `192.168.1.38:5190` | ✅ 是 | **仅** `dist/` 里的 3 个静态文件（index.html + 1 JS + 1 CSS） |
| 回环 `127.0.0.1:5181` | ✅ 是 | 同上（上一轮的 vite preview，仅本机） |
| 文件系统其余部分 | ❌ 否 | 白名单扩展名之外一律 404；目录列表关闭 |
| 后端 / 数据库 / 密钥 | ❌ 否 | 本原型**无后端**，静态服务器不读任何环境变量或凭据 |

### 8.2 若按 §7.4 开通公网后的暴露范围

| 项 | 范围 |
|---|---|
| 暴露内容 | **仅** `dist/` 的 3 个静态文件（约 561 KB），页面无输入框、无接口、无鉴权令牌、无用户数据 |
| 不暴露 | Docker socket ❌、NAS 管理端口 ❌、目录列表 ❌、调试面板 ❌、源码/映射 ❌、任何凭据 ❌ |
| 建议 | 加 Cloudflare Access 邮箱验证（方案 A 默认开）；`nosniff`/`no-referrer` 等安全头已由 `serve-dist.mjs` 下发 |
| 风险 | 原型本身无敏感数据；主要风险是**若不加 Access，任何人拿到域名即可看到原型画面**（仅为演示画面，不含业务逻辑） |

---

## 9. 未验证项目（**不声称已通过**）

| 项 | 状态 | 原因 |
|---|---|---|
| **外网（公网）访问** | ⛔ **未验证** | 未创建公网入口（§7） |
| **公网地址加载/旋转/缩放/点击** | ⛔ **未验证** | 同上 |
| **真机（真实手机）触摸** | ⛔ **真机未验证** | 无真机。触摸为 CDP `Input.dispatchTouchEvent` 合成事件 |
| **微信小游戏端** | ⛔ **微信端未验证** | 无微信开发者工具，且任务禁止安装 |
| 手机浏览器厂商差异（iOS Safari / 各家 Android WebView） | ⛔ 未验证 | 无真机 |
| 移动网络（4G/5G）下的加载 | ⛔ 未验证 | 无外网通道 |

**关于「局域网地址」与「公网地址」的区分**：`http://192.168.1.38:5190/`
是**局域网**地址，**不是**公网地址。本文档任何位置都未把它当作公网通过。

---

## 10. 截图清单

### 10.1 本地/局域网截图（`shots/` 与 `shots/lan/`）

| # | 文件 | 字节 | 内容 |
|---|---|---|---|
| 1 | `shots/01-default-island.png` | 129,064 | **穿模修复后的默认视角**（828×1792 竖屏） |
| 2 | `shots/02-rotated-island.png` | 118,514 | **穿模修复后的旋转视角 A** |
| 3 | `shots/03-rotated-angle-b.png` | 123,522 | 旋转视角 B（第三个角度，专门复查穿模） |
| 4 | `shots/04-click-name-label.png` | 136,910 | 点击市政厅后的名称反馈 |
| 5 | `shots/05-closeup-cityhall_front.png` | 46,183 | **穿模证据特写**：市政厅前台阶 vs 道路 |
| 6 | `shots/06-closeup-shop_curb.png` | 76,068 | **穿模证据特写**：商店角 vs 路缘石 |

`shots/lan/lan-*.png` 为**同一组画面经局域网地址 `http://192.168.1.38:5190/` 取得**，
逐字节与上表相同 —— 即「局域网打开后的页面」与「局域网打开后的点击反馈」的实证。

**竖屏**：以上全部为 414×896 @ DPR 2 = **828×1792 竖屏**，即任务要求的「竖屏页面」。

### 10.2 未能产出的截图（**不伪造**）

| 任务要求 | 状态 |
|---|---|
| 「公网地址打开后的页面」 | ⛔ **未产出** —— 公网地址尚不存在（§7） |
| 「公网地址打开后的点击反馈」 | ⛔ **未产出** —— 同上 |

> **不拿局域网截图冒充公网截图。** 开通公网后可用 §7.4 的命令补齐。

---

## 11. 回滚方法

### 11.1 代码回滚（穿模修复）

改动只有 `src/scene/world.ts` 里的两行 `position.set`：

```diff
- g.position.set(-2.4, 0, -2.67);   // 市政厅（新）
+ g.position.set(-2.6, 0, -2.05);   // 市政厅（原）
- g.position.set(3.15, 0, 2.2);     // 商店（新）
+ g.position.set(3.15, 0, 1.95);    // 商店（原）
```

回滚后 `npm run build` 即可。**注意**：回滚会同时恢复 10 处穿模。
若本目录已纳入 git，等价于 `git checkout -- src/scene/world.ts`。

### 11.2 局域网服务回滚

```bash
pkill -f "scripts/serve-dist.mjs"      # 停静态服务（5190 端口释放）
pkill -f "3d-spike-ds"                 # 停上一轮的 vite preview（5181）
```
本轮**未创建任何容器 / systemd 单元 / 开机自启**，所以无需其他清理。

### 11.3 若将来执行了 §7.4 的公网开通，回滚为

```bash
sudo systemctl disable --now cloudflared-wyszz-3d-spike
sudo rm -f /etc/systemd/system/cloudflared-wyszz-3d-spike.service \
           /etc/cloudflared/wyszz-3d-spike-token
sudo systemctl daemon-reload
# 再删除 Cloudflare 后台的：隧道 wyszz-3d-spike、DNS 记录 <子域名>、（若建了）Access 应用
```

### 11.4 整目录删除

```bash
pkill -f "3d-spike-ds" || true
ls -d /vol1/ai/projects/wyszz-new/3d-spike-ds     # 确认路径无误
rm -rf /vol1/ai/projects/wyszz-new/3d-spike-ds
```

---

## 12. 新增/修改文件清单（绝对路径）

### 修改（1 个）
| 文件 | 改动 |
|---|---|
| `/vol1/ai/projects/wyszz-new/3d-spike-ds/src/scene/world.ts` | 市政厅、商店两个 `position.set`（+ 修复说明注释） |
| `/vol1/ai/projects/wyszz-new/3d-spike-ds/src/main.ts` | 新增只读 `window.__SPIKE_WORLD__` 供穿模检测器读取场景（不参与渲染/交互） |
| `/vol1/ai/projects/wyszz-new/3d-spike-ds/package.json` | 新增 `serve` / `clash` / `shots` / `refresh` 四个脚本 |

### 新增（6 个）
| 文件 | 用途 |
|---|---|
| `.../scripts/clash-check.mjs` | **穿模检测器**（网格级 AABB，输出 `docs/clash-report.json`） |
| `.../scripts/serve-dist.mjs` | **局域网静态服务器**（0.0.0.0:5190，白名单 + 无目录列表） |
| `.../scripts/shots.mjs` | 截图脚本（对任意 base URL 通用，含穿模特写） |
| `.../scripts/refresh-check.mjs` | 刷新路径验证（连续 3 次加载） |
| `.../scripts/deploy-public-preview.py` | **公网入口挂载脚本（未执行，供主控方授权后使用）** |
| `.../docs/clash-report.json` | 穿模检测机器可读结果 |

### 新增截图（12 张）
`shots/01..06-*.png` + `shots/lan/lan-01..06-*.png`

---

## 13. 是否可以进入 0.1 第二步

### 结论：**不建议现在进入。**

理由不是穿模（穿模已清零），而是**本轮的公网目标没有达成**：

| 门槛 | 状态 |
|---|---|
| 3D 原型可运行、可旋转、可缩放、可点击 | ✅ 达成 |
| 穿模清零 | ✅ 达成（10 → 0） |
| 局域网手机可访问 | ✅ 达成（`http://192.168.1.38:5190/`） |
| **公网地址可访问** | ❌ **未达成**（阻塞，需主控方给域名 + 授权） |
| **真机实测** | ❌ 未达成（无真机） |

**建议顺序：**
1. 主控方先按 §7.4 补上「目标子域名 + 授权」→ 公网入口开通；
2. DSH 补做公网地址的加载/旋转/缩放/点击验证与两张公网截图；
3. **再由主控方用真机打开局域网或公网地址**做一次真机触摸确认；
4. 上述都过了，再谈是否进 0.1 第二步。

若主控方认可「公网与真机验证可以推迟」，那么**仅就 3D 原型本体而言，穿模已清零、
交互与竖屏适配均实测通过，具备进入 0.1 第二步的技术条件** —— 但这是主控方的决定，
DSH **不自行进入**。

**本轮到此停止，未进入 0.1 第二步，未接入任何经济系统。**

---

## 附录 A · 本轮执行的验证命令

```bash
cd /vol1/ai/projects/wyszz-new/3d-spike-ds

npm run typecheck                 # tsc --noEmit            -> 0 错误
npm run build                     # vite build              -> 0.33s
npm run clash                     # 网格级穿模检测            -> 0 处穿模

npm run serve                     # 局域网静态服务 0.0.0.0:5190
curl -I http://192.168.1.38:5190/ #                         -> 200

npm run e2e                                                        # 回环，PASSED
SPIKE_URL=http://192.168.1.38:5190/ node scripts/e2e.mjs           # 局域网，PASSED
SPIKE_URL=http://192.168.1.38:5190/ node scripts/refresh-check.mjs # 刷新 x3，PASS
SPIKE_URL=http://192.168.1.38:5190/ SPIKE_OUT=shots/lan SPIKE_LABEL=lan node scripts/shots.mjs

# 公网脚本的「拒绝猜测」自测（不会发任何网络请求）
python3 scripts/deploy-public-preview.py    # -> exit 2「未设置 PUBLIC_HOST」
```

## 附录 B · 环境与隔离记录

- 系统：fnOS 1.2.0604（Debian 12 bookworm），内核 6.18.18，x86_64，16 核，15 GiB
- Node v24.15.0 / npm 11.12.1；Chromium 154.0.8037.57（`/usr/bin/chromium`）
- 无头渲染：ANGLE / SwiftShader，**WebGL 2.0** 可用
- **本轮安装软件数：0**；**本轮创建容器数：0**；**systemd 单元改动：0**
- 未修改：路由器、防火墙、SMB、SSH、NAS 权限、`docker-compose.yml`
- 未读取：`3d-spike-mimo/`、`app/`、`little-town/`、`3d-spike/`、
  以及 `/vol1/ai/agents/hermes/access/cf.env` 的**内容**
- `4180` 端口的容器 `wyszz-3d-spike-preview` **不是 DSH 创建的**，DSH 未以任何方式操作它

## 附录 C · 本轮新增的工具经验

1. **AABB 检测必须做到网格级。** 顶层合并 AABB 会产生真实误报
   （树冠跨度、路缘石高度都被算进去），第一版 7 对里有 2 对是假的。
   网格级 + 2mm 阈值后，10 对全部为真。
2. **「重叠体积」比「是否重叠」有用得多。** 只看布尔值会去修 0.003 的立柱，
   而漏掉 0.198 的台阶。按体积排序后修复优先级一目了然。
3. **旋转过的物体要手算角点，别信 AABB。** 商店 AABB 角点半径 5.85 看似出岛，
   实际旋转后真实角点半径只有 5.08 —— 用 AABB 判断「是否出岛」会误判。
4. **同一工作可以用「截图逐字节比对」证明链路一致。**
   局域网与回环两组截图字节完全相同，比任何「看起来正常」都硬。
5. **远端托管的 Cloudflare 隧道没有本地 ingress 文件。**
   排查「能不能自己加一个上游」时，关键判据是
   `/etc/cloudflared/` 下有没有 `config.yml` —— 只有 `*-token` 就是远端托管，
   本机加不了。
