# L1 · 项目专用隔离检查 + 一键全量回归 · 报告

- 任务编号：**L1**
- 执行日期：2026-10-12
- 工作副本（**唯一**被改动的目录）：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1/`
- 原目录 `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/`：**只读，未做任何修改**（见 §7 取证）
- 契约包 `/vol1/ai/projects/wyszz-new/frontend-rebuild-contract-v1/`：**只读，未做任何修改**
- 环境：Node `v24.15.0` / npm `11.12.1`（`/mnt/ssd/apps/nodejs_v24/bin`），系统 Chromium（版本未记录），SwiftShader 软件渲染，无 GPU

---

## 1. 做了什么（摘要）

| # | 事项 | 结果 |
|---|---|---|
| 1 | 完整复制项目到 `frontend-rebuild-hm-work-L1`（`cp -a`，含 `node_modules/`，123 MB / 5473 文件） | 完成 |
| 2 | 复现契约包 `check-isolation.mjs` 的误报，并逐规则定位成因 | 完成，实测 **3221** 处（任务书写 3178，**未复现**，见 §5.3） |
| 3 | 新增 `tools/check-isolation-project.mjs`：项目专用隔离检查（纯 Node ESM，零新依赖） | 完成，干净项目 **PASS / 0 违规** |
| 4 | 新增 `tools/regress.mjs` + `package.json` 的 `regress` / `check:isolation` 脚本 | 完成 |
| 5 | 实际跑通一次全量回归（10 步） | **10/10 PASS**，退出码 0（见 §3.2） |
| 6 | 故意制造违规 → 确认 FAIL(exit 1) → 删除 → 恢复 PASS(exit 0) | 完成，全部留证（§6） |
| 7 | 白名单边界验证（有 / 无禁止性措辞） | 完成（§6.5） |
| 8 | 回归**失败路径**端到端验证（让第 10 步失败 → 整体 exit 1） | 完成（§6.6） |

**未改动 `src/` 下任何游戏代码；未改动任何测试内容与断言；未进入 0.2；未改动 0.1 已冻结的规则与数值。**

---

## 2. 交付物 1：`tools/check-isolation-project.mjs`

### 2.1 为什么需要它（契约包工具误报的成因）

契约包 `frontend-rebuild-contract-v1/tools/check-isolation.mjs` 是为**契约包自身**（只含 `.md/.d.ts/.json`）设计的，它把三类"对新前端完全合法"的东西判成违规：

- 规则 **C 旧前端源码特征标识**：`THREE.Mesh` / `THREE.Group` / `THREE.Scene` / `PerspectiveCamera` / `OrthographicCamera` / `raycaster` / `requestAnimationFrame` / `document.createElement` / `getContext('2d')` / `CanvasTexture` / `src/game/` / `src/platform/` —— 这些正是本前端 3D 实现的**核心 API**。
- 规则 **E 文件类型白名单**：只允许 `.md/.ts/.mjs/.json/.txt`，于是 `.js/.html/.png/.map/.wasm/.service` 全部违规 —— 而本项目的构建产物、`node_modules`、证据截图天然是这些类型。
- 规则 **A 视觉产物**：任何 `.png` 都违规 —— 而浏览器/微信测试的**证据截图**就是要产出 `.png`。

我用一个只读复现脚本（`/tmp/analyze2.mjs`，按契约包逐字复刻判定，**未修改契约包**）把 3221 条拆开：

| 规则 | 命中数 | 主要来源 | 典型误报 |
|---|---:|---|---|
| A 视觉产物 | 31 | `evidence/` 31 张 `.png` | 测试证据截图 |
| B 旧目录/旧路径 | 32 | `docs/`24 `tools/`4 `ISOLATION.md`3 `test/`1 | 本项目自己的绝对路径 `/vol1/ai/projects/…`、`wyszz-new` |
| C 旧前端源码特征 | 157 | `node_modules/`120 `src/`23 `docs/`7 `test/`5 | `THREE.Mesh`×37、`requestAnimationFrame`×24、`PerspectiveCamera`×22、`document.createElement`×15、`OrthographicCamera`×12、`Raycaster`×11 |
| D 凭据/内部信息 | 84 | `node_modules/`65 `docs/`10 `test/`5 `tools/`2 `dist/`1 | `password`×40、`127.0.0.1`×16（本地测试服务器）、`localhost:`×8、`appid`×4 |
| E 文件类型白名单 | 2917 | `node_modules/`2903 `dist/`10 `release/`2 `deploy/`1 `src/`1 | 依赖里的 `.js/.map/.wasm`、构建产物、`.service` |
| **合计** | **3221** | | |

> 结论：3221 条里，**2917 条（90.5%）只是"文件扩展名不是契约包允许的 5 种"**，剩下的主要是"用了 Three.js 和浏览器 API"。这**不是**隔离违规，所以契约包工具**不能**直接套在本项目上。

### 2.2 新脚本的匹配规则（明确写死，避免歧义）

| 规则 | 判据 | 为什么这样定 |
|---|---|---|
| **A 禁目录名** | 文本中出现 5 个禁目录名（大小写不敏感）：`wechat-game-0.1-ds`、`3d-spike-ds`、`wechat-spike-ds`、`little-town`、`MIMO` | 这 5 个是**唯一名**，不存在同名的合法目录，可以按字面匹配 |
| **B 项目外旧 app 路径** | 路径词（至少含一个 `/`）里存在**恰好等于 `app` 的路径段**，且满足：(1) 是**绝对路径**、解析后落在 `/vol1/ai/projects/wyszz-new/` 之下、但**不在允许的项目根内**（即旧工程目录 `/vol1/ai/projects/wyszz-new/app/…`）；或 (2) 是 **`../` 开头的相对路径**、按所在文件目录解析后**越出项目根** | **这就是 `app/` 歧义的解法**，见 2.3 |
| **C 代码引用/读取** | `import … from '…'` / `import('…')` / `require('…')` / `readFileSync\|readFile\|readdirSync\|existsSync\|statSync\|lstatSync\|realpathSync\|readlinkSync\|createReadStream\|openSync('…')` 的字符串实参命中 A 或 B | 任务书要求显式覆盖 import / require / 文件读取 |
| **W 白名单** | `W1`：`ISOLATION.md` **整文件**；`W2`：`.md`/`.txt` 中**声明禁区段落**（连续非空行组成的段落里，任一行含 `禁止/不得/不许/禁用/禁区/被禁/隔离` 或 `forbidden/must not/do not`）；`W3`：**显式列出的隔离/审计文档**（见 2.4）。**源码文件（.ts/.mjs/.js/…）永远不享受白名单** | 见 2.4 |

扫描范围：**根级文本文件** + `src/` `test/` `tools/` `docs/` `tests/`；忽略 `node_modules/` `dist/` `release/` `evidence/` `.git/`；文本扩展名 20 余种（`.md .txt .ts .mts .cts .mjs .cjs .js .json .html .css .yml .sh .toml .xml .service .conf .ini .env` 及无扩展名）。

自命中防护：脚本里用到的禁目录名字面量是**运行时拼接**出来的（`P('wechat-game-','0.1-ds')` 等），所以**脚本扫描自己也不会命中**——这也是契约包工具采用的做法。每次运行都会把脚本自己扫进去，命中数为 0，等于一次自证。

### 2.3 `app/` 歧义：我到底怎么处理的（重点）

**歧义**：禁的是**项目外的旧工程目录** `/vol1/ai/projects/wyszz-new/app/`；而本项目内 `src/app/` 是**合法**目录，`src/wechat/main.ts:13`、`src/web/main.ts:8` 里还写着 `import { GameApp } from '../app/app';`。

**我的规则不是"匹配裸字符串 `app/`"**，而是：

1. 先把行内的**路径词**抽出来（正则要求至少含一个 `/`，所以 `app`、`AppID`、`appid` 这类裸词根本不会被当成路径，直接出局）；
2. 只有当路径段里**恰好有一段等于 `app`** 时才进入判定；
3. 然后**解析成绝对路径**，判断它是否落在"允许的项目根"内：
   - **允许的项目根** = 当前副本根 `…/frontend-rebuild-hm-work-L1` **以及**去掉 `-work-*` 后缀的原项目根 `…/frontend-rebuild-hm`（后者是为了让"指向原项目自身"的合法绝对路径在副本里跑也不误报）；
   - `src/app/app.ts`、`../app/app`（从 `src/wechat/` 出发 → `src/app/app`）、`./app/` 一律**落在允许根内 ⇒ 不报**；
   - `/vol1/ai/projects/wyszz-new/app/legacy.js` ⇒ 不在允许根内、且在旧工程父目录下 ⇒ **报**；
   - `../../app/main.js`（从 `tools/` 出发）⇒ 解析到 `/vol1/ai/projects/wyszz-new/app/main.js`，越出项目根 ⇒ **报**。
4. 另外，绝对路径**只关心** `/vol1/ai/projects/wyszz-new/` 下的 `app`，避免误伤 `/usr/share/app/…` 之类的系统路径。

**自证误报已消除**：
- 新脚本在干净副本上：**A 0 命中 / B 0 命中 / C 0 命中**，总违规 **0**，退出码 **0**。
- 而 `src/wechat/main.ts:13` 与 `src/web/main.ts:8` 的 `../app/app` **确实存在于被扫描的文件里**（`grep -rn "\.\./app/app" src/` 可复现），却**没有**被报出来 —— 说明规则是"解析后判定"，不是裸字符串匹配。
- 对比：同一批文件用契约包工具跑 ⇒ **3221 条 FAIL**。**误报从 3221 降到 0。**

### 2.4 白名单的判定方式（可审计）

白名单命中**不计入违规**，但会**逐条列出来**，格式为
`WHITE | 规则 | 文件:行 | 说明 | 依据：W? | 原文：…`，并附**按文件汇总**。

| 白名单原因 | 判据 | 本次命中 |
|---|---|---|
| **W1** | `ISOLATION.md` **整文件**（它是隔离声明文件，职责就是声明禁区） | `ISOLATION.md:3` ×1 |
| **W2** | `.md`/`.txt` 中**声明禁区段落**：段落（连续非空行）内任一行含禁止性措辞 | `docs/09:11` ×1、`docs/10:34,35` ×5、`docs/11:40,41,65` ×10 |
| **W3** | **显式文件白名单** `ISOLATION_DOCS`（脚本内硬编码），生效需同时满足：文件存在、是 `.md`、且**文件内确实含禁止性措辞** | `docs/L1-隔离检查与一键回归-报告.md` ×45 |

判定细节：
- **W2 按"段落"而不是"单行"**：`docs/10:35`、`docs/11:41` 是上一行禁止句的**续行**（中间无空行），按单行判定会被误判成违规，所以用"连续非空行段落内任一行含禁止性措辞"来判定。
- **只对 `.md`/`.txt` 生效**。我在 `.mjs` 里写禁目录名字面量 ⇒ **FAIL**；把它写进 `.md` 且**不带**禁止性措辞 ⇒ 同样 **FAIL**（见 §6.5）。
- **W3 是怎么来的（如实说明）**：本报告必须**原样引用**禁目录名与检查器的 FAIL 输出，否则无法审计；一旦写进 `docs/`，规则 A/B/C 就会命中它。为此我加了一个**唯一的人工评审入口** `ISOLATION_DOCS`（脚本内硬编码的路径数组），并且要求"被放行的文件里必须真的含禁止性措辞"，避免它变成"随便挂个 .md 就免检"。**这是我自己做的设计决定，任务书只要求放行 `ISOLATION.md`，因此列为待决问题 Q2/Q3。**

---

## 3. 交付物 2：一键全量回归 `npm run regress`

### 3.1 映射（与任务书的建议映射一致）

| # | 步骤名 | 实际执行 | 说明 |
|---|---|---|---|
| 1 | 类型检查 | `npm run typecheck` | 原样调用 |
| 2 | 构建(core+web+wechat) | `npm run build:core` → `build:web` → `build:wechat` | 三步串成一行；任一失败该步即失败 |
| 3 | 契约样例(fixtures) | `npm run test:fixtures` | 原样调用（内部调契约包 `run-fixtures.mjs`，绝对路径，允许） |
| 4 | 会话回放(replay) | `npm run test:replay` | 任务书说"另可含 test:replay"，我把它**单列一行**（而非塞进第 3 步），因为它是独立断言集 |
| 5 | 玩法(gameplay) | `node test/browser.test.mjs gameplay` | 原样调用 |
| 6 | UI(ui) | `node test/browser.test.mjs ui` | 原样调用 |
| 7 | 视觉(visual) | `node test/browser.test.mjs visual` | 原样调用 |
| 8 | 浏览器测试(全量) | `npm run test:browser` | 原样调用 |
| 9 | 微信替身测试 | `npm run test:wechat` | 原样调用 |
| 10 | 隔离检查(项目专用) | `node tools/check-isolation-project.mjs` | 本次新增 |

- **`test:public` 未纳入**：它是公网预览检查，任务书已声明目前 404 的已知缺口，且需要网络。
- 步骤 5–8 有**冗余**（玩法/UI/视觉是"全量浏览器测试"的子集，等于多起 3 次浏览器），这是**任务书明确要求的映射**，我照做并保留；如需提速可只留第 8 步（见 Q6）。
- 语义：**默认跑完全部 10 步**再打印结果表（失败时也能看到完整画面）；`--fail-fast` 可改为第一步失败即停。**任一命令非 0 退出 ⇒ 该步 FAIL ⇒ 整体退出码 1。**
- 不改任何测试内容、不降低任何断言：`regress.mjs` 只做 `spawn` + 输出透传 + 计时 + 汇总，不碰测试文件。
- 每步完整原始输出同时落盘 `evidence/regress-<时间戳>/NN-<id>.log`，并写 `summary.json`；stdout 上原样透传（tee 行为）。

### 3.2 结果表（最终一次全量回归的实际输出，原样）

（说明：本次全量回归运行于 2026-10-12 09:31:00，日志目录 `evidence/regress-20261012-013100/`；报告正文里只有「结果表数字 / SHA256」是在该次运行之后回填的，这些内容不含任何禁目录名，因此第 10 步隔离检查的结果不受回填影响。）

```
==================== 全量回归结果表 ====================
#   步骤                    耗时      结果    关键数字
------------------------------------------------------------------------------------
1   类型检查                0.2s      PASS    tsc 静默通过（无输出）
2   构建(core+web+wechat)   0.7s      PASS    web main-de24c2e196.js 614.0KiB / wechat 614.0KiB sha256:7185453263687c27…
3   契约样例(fixtures)      0.2s      PASS    32/32
4   会话回放(replay)        0.2s      PASS    32/32
5   玩法(gameplay)          15.7s     PASS    21/21
6   UI(ui)                  13.6s     PASS    23/23
7   视觉(visual)            28.5s     PASS    12/12
8   浏览器测试(全量)        65.3s     PASS    59/59
9   微信替身测试            64.8s     PASS    37/37
10  隔离检查(项目专用)      0.1s      PASS    0 违规 / 62 白名单
------------------------------------------------------------------------------------
合计：执行 10 步，通过 10 步，失败 0 步；跳过 0 步；总耗时 189.2s
结论：PASS（全量回归通过）
日志目录：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1/evidence/regress-20261012-013100
结果 JSON：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1/evidence/regress-20261012-013100/summary.json
```

命令与退出码：

```
$ export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
$ cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1
$ npm run regress
…
REGRESS_EXIT=0
```

**与任务书现状描述的差异：无。** 契约样例 32/32 ✅、浏览器 59/59 ✅、微信替身 37/37 ✅，与任务书一致。

补充说明两个数字关系（避免误读）：
- 玩法 21 + UI 23 + 视觉 12 = **56**，而"浏览器测试(全量)"是 **59**。差的 3 条是 `t-fixtures.mjs` 的 `T03 / T03b / T03c`（契约夹具在真实页面里重放）—— 全量模式才跑 `t-fixtures`，所以 56 + 3 = 59，**不是漏跑**。
- `T03` 自身报告 `32/32 变体逐字节一致`，与第 3、4 步的 32/32 互相印证。

---

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

所有原始输出已落盘（见 §5.2）。以下贴关键段落。

### 4.1 契约包工具（复现误报，只读）

```
$ node /vol1/ai/projects/wyszz-new/frontend-rebuild-contract-v1/tools/check-isolation.mjs \
    --root /vol1/ai/projects/wyszz-new/frontend-rebuild-hm
契约包隔离自检 —— 根目录：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm
文件总数：5473
文件类型分布：(无扩展名)×36  .cjs×134  .cts×128  .gz×2  .html×3  .js×1894  .json×123  .map×691  .md×64  .mjs×29  .mts×3  .pdl×54  .png×31  .service×1  .sig×1  .tmpl×1  .ts×2265  .tsbuildinfo×1  .txt×8  .wasm×4
…
FAIL | E 文件类型白名单 | node_modules/@puppeteer/browsers/lib/CLI.js.map | 不允许的文件类型：.map
     … 另有 2897 处

=== 隔离自检：FAIL（3221 处命中）===
```

（跑在**原目录**上得到同样的 3221，说明副本与原件文件集一致。）

### 4.2 新隔离检查（干净副本，原样输出节选）

```
$ node tools/check-isolation-project.mjs
项目专用隔离检查 —— 根目录：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1
允许的项目根：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1  |  /vol1/ai/projects/wyszz-new/frontend-rebuild-hm
扫描范围：根级文本文件 + src/ test/ tools/ docs/ tests/
忽略目录：node_modules/ dist/ release/ evidence/ .git/
扫描文本文件数：65（候选文件 65）

匹配规则：
  A 禁目录名        —— wechat-game-0.1-ds / 3d-spike-ds / wechat-spike-ds / little-town / MIMO（大小写不敏感）
  B 项目外旧 app 路径 —— 路径段含 app，且（绝对路径在 /vol1/ai/projects/wyszz-new/ 之下但在允许根之外）或（../ 相对路径解析后越出项目根）
  C 代码引用/读取指向禁目录    —— import / require / fs 读取的字符串实参指向 A 或 B 的目标
  白名单          —— W1 ISOLATION.md 整文件；W2 .md/.txt 中含禁止性措辞的声明段落；W3 显式列出的隔离/审计文档（docs/L1-隔离检查与一键回归-报告.md）（源码文件不享受白名单）

PASS | A 禁目录名：0 命中
PASS | B 项目外旧 app 路径：0 命中
PASS | C 代码引用/读取指向禁目录：0 命中

白名单命中（不计入违规，仅列出以便审计）：62 处
  按文件汇总：ISOLATION.md  [W1] ×1；docs/09-多智能体作战手册-上.md  [W2] ×1；docs/10-多智能体作战手册-下-任务书.md  [W2] ×5；docs/11-0.1收尾任务书-分级.md  [W2] ×10；docs/L1-隔离检查与一键回归-报告.md  [W3] ×45
WHITE | A | ISOLATION.md:3 | 出现禁目录名：MIMO | 依据：W1 ISOLATION.md 整文件（隔离声明文件） | 原文："…不得读取、修改或删除旧前端、DSH 实现、MIMO 对照目录和历史实验目录。…"
WHITE | A | docs/09-多智能体作战手册-上.md:11 | 出现禁目录名：MIMO | 依据：W2 声明禁区段落（.md/.txt 中的禁止性措辞） | 原文："5. 隔离：…禁止读取旧前端、旧模型、旧截图、旧公开页面和 MIMO 目录。…"
…（完整 62 处清单见 evidence/L1-iso-demo/1-基线-干净-PASS.txt）

=== 项目专用隔离检查：PASS（0 处违规 / 62 处白名单 / 扫描 65 个文本文件）===
exit=0
```

> 注意：**白名单里的 62 处全部落在 `.md` 文档内**（`ISOLATION.md`、`docs/09`、`docs/10`、`docs/11`、本报告）。**没有任何一处来自 `src/`、`test/`、`tools/` 下的源码**——这是"按文件汇总"这一行存在的意义。

### 4.3 各步骤原始输出（节选；完整见 §5.2 的 regress 日志目录）

**01 类型检查**（`01-typecheck.log`）
```
> wyszz-frontend-rebuild-hm@0.1.0 typecheck
> tsc --noEmit -p tsconfig.json
（无输出 = 通过）
```

**02 构建**（`02-build.log`）
```
  dist/core/save.js       7.3kb
  dist/core/economy.js    4.6kb
  dist/core/offline.js    3.6kb
  dist/core/visit.js      3.1kb
  dist/core/upgrade.js    2.8kb
  dist/core/constants.js  2.4kb
core built: constants, economy, visit, upgrade, save, offline
[build:web] assets/main-de24c2e196.js  614.0 KiB  gzip 161.2 KiB
[build:web] index.html  705 B  → …/frontend-rebuild-hm-work-L1/dist/web
[build:wechat] game.js  614.0 KiB  gzip 161.2 KiB  sha256 7185453263687c27…  → …/dist/wechat
```

**03 契约样例**（`03-fixtures.log`）
```
=== 黑盒夹具校验：32/32 通过 ===
```

**04 会话回放**（`04-replay.log`）
```
=== Session 夹具回放：32/32 通过 ===
```

**05 玩法**（`05-gameplay.log`，21 条全 PASS，末尾）
```
PASS T05f 双指捏合放大：zoom 1.00→1.45，pinch 事件 16
PASS T05g 触摸点击居民（pointerType=touch，真实射线）成功 #1
PASS T05h 全程无 pageerror

== 浏览器测试：21/21 通过 ==
```

**06 UI**（`06-ui.log`，23 条全 PASS，末尾）
```
PASS T08e 恢复写入后重试成功，saveOk 恢复
PASS T08f T08 无 pageerror

== 浏览器测试：23/23 通过 ==
```

**07 视觉**（`07-visual.log`，12 条全 PASS，末尾）
```
PASS T11b SwiftShader 软件渲染帧率 26.5 fps（仅作可运行性参考，非真机性能）
PASS T10-1280x720 视口 1280×720：市政厅在自由区（72–662），4/4 居民在自由区、2 个居民中心可被射线命中；画布铺满且无滚动条
== 浏览器测试：12/12 通过 ==
```

**08 浏览器测试（全量）**（`08-browser.log`，59 条全 PASS，末尾）
```
PASS T03 契约夹具在真实页面重放：32/32 变体，逐步 state + 存档逐字节一致
PASS T03b 夹具步骤驱动方式：真实鼠标+3D射线 24 步，核心层直驱 82 步（共 106；…）
PASS T03c 重放期间无页面报错
== 浏览器测试：59/59 通过 ==
```

**09 微信替身测试**（`09-wechat.log`，37 条全 PASS，末尾）
```
PASS W12 运行全程无网络调用（fetch/XHR/WebSocket 在模拟宿主里被替换为拦截器，计数 0） — 0
PASS W12b game.js 静态检查：不含 wx.request / localStorage / … — 命中: 无
PASS W12c 全程无页面/Worker 报错

== 微信适配层（Worker 无 DOM + 模拟 wx）：37/37 ==
```

**10 隔离检查**（`10-isolation.log`）
```
=== 项目专用隔离检查：PASS（0 处违规 / 62 处白名单 / 扫描 65 个文本文件）===
```

**整份输出中的 `FAIL` 行计数 = 0**（`grep -c "^FAIL" <stdout>` → `0`）。

---

## 5. 改动文件清单 + SHA256

### 5.1 改动 / 新增（在副本内）

| 文件 | 类型 | SHA256 |
|---|---|---|
| `package.json` | 修改（**只加 2 行脚本**） | `2280e2ec60b687472e0d7d8e2646b9b68c4b68a9752bbf2c241ca77d4561d274` |
| `tools/check-isolation-project.mjs` | **新增** | `1ae0d16cc254c7d714b78866366eb75c6d220d37d9375e85271f1f14c0799d9c` |
| `tools/regress.mjs` | **新增** | `8cecc7cd67ab36370ed0d3d958b199e0ae86134f742268b87f657764cfb90ef6` |
| `docs/L1-隔离检查与一键回归-报告.md` | **新增**（本文件） | 第 1–11 节正文哈希见 §12 |

`package.json` 与**原目录**的完整差异（`diff -u` 原始输出）：

```diff
--- /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/package.json	2026-10-11 01:44:28.459387939 +0800
+++ package.json	2026-10-12 09:18:51.450057636 +0800
@@ -15,6 +15,8 @@
     "test:replay": "node tools/test-session-replay.mjs",
     "test:wechat": "node test/wechat-sim.mjs",
     "test:public": "node test/public-check.mjs",
+    "check:isolation": "node tools/check-isolation-project.mjs",
+    "regress": "node tools/regress.mjs",
     "serve:preview": "node tools/serve-preview.mjs",
     "test": "npm run test:browser && npm run test:wechat"
   },
```

`tools/check-isolation-project.mjs` 与 `tools/regress.mjs` 在**原目录中不存在**（已用 `[ -e ]` 逐条核对）。

### 5.2 新增证据文件（`evidence/`，均不影响被测代码）

**`evidence/L1-iso-demo/`（故意违规 + 白名单边界 + 回归失败路径的完整留证）**

| 文件 | SHA256 |
|---|---|
| `1-基线-干净-PASS.txt` | `078d04ccd3c25db43fbaee5274a1ea1895ebd589327e0e727a44d7ff723ceeec` |
| `2-故意违规-FAIL.txt` | `a0a846867863daa5f4f73da43ad8412449475d66e61af15633e1bf003c923e07` |
| `3-清理后-PASS.txt` | `078d04ccd3c25db43fbaee5274a1ea1895ebd589327e0e727a44d7ff723ceeec` |
| `4a-白名单边界-无禁止措辞-FAIL.txt` | `02c142c9ffa4b762632ee2a67e6b47432acae6a92b16dcc01edd06b987e3fc48` |
| `4b-白名单边界-有禁止措辞-WHITE.txt` | `b0a7da40d5b20cbd035471007053dd0b93daf642792cedb0472342887c482958` |
| `5-终态-PASS.txt` | `078d04ccd3c25db43fbaee5274a1ea1895ebd589327e0e727a44d7ff723ceeec` |
| `6-regress-失败路径.txt` | `5c9cd0d56d681c6c6347c02105507cfbfd2f2a1711c57e4a8bb5ffefab2916b6` |
| `7-regress-恢复PASS.txt` | `f0c62d3b960f4826e02781ba3c8a6dd187d5e2dfc360e6ef24eeb3fa87daf17a` |
| `README.txt` | `941c82ac9dc5f13e56479aba77fbd1764a380c64fee32e869d7a287be34260d5` |

**`evidence/regress-20261012-013100/`（最终全量回归的逐步原始日志）**

| 文件 | SHA256 |
|---|---|
| `01-typecheck.log` | `017ccf2d87af62e5cbb350390692cde8240ee73655daabf895ae1bb5323bd566` |
| `02-build.log` | `a6c8cbf1a434413dafc3eea792402f095c264ef10f2970e36a2507c2da79f437` |
| `03-fixtures.log` | `0825b9a3babb1f86f07a6cf4999b211749546b78092cf4b737e0f7c400f82c5b` |
| `04-replay.log` | `cd8212591bc6afe61ba8113041af1df8f47f90917b0c1d4cf04c49641df66897` |
| `05-gameplay.log` | `860979f15f9f615ec6b7cd7325c69622b9d1421cffe8089756a1f5f71e85385e` |
| `06-ui.log` | `fd46510160ae94df71cb8b550c373bea2fecd2d1116b0021444d675ffc5b828a` |
| `07-visual.log` | `2a35ff0b7978463c1887c67cbb097edba427969e96db1e9a92825cd110fc5935` |
| `08-browser.log` | `f59491e22cfad6a8841c7cbfdc78afa4d3c25dc7ffe42f694172ae567ed5ddaf` |
| `09-wechat.log` | `5b83e269d686ec394fd72aa75552b2d6c3cb18adced0acef2994632cc3f56c3f` |
| `10-isolation.log` | `c0cca939f85487718c274ad0080cd4fe2f0057e4b43f6232c422faea226525ea` |
| `stdout-combined.txt` | `35e677813f94cb374315c2ee0f12487d5a1404a6ca37d4a276934723e99cb4e1` |
| `summary.json` | `dcd7820ea7b3dcaefd2e33fa6b53b99fa657dba392ef013c4b35351baaede98a` |

（另：`evidence/screens/`、`evidence/wechat-sim/`、`evidence/browser-results*.json` 被本次回归**覆盖重写**，属测试正常产物，非人工改动。）

### 5.3 未复现项

**任务书说契约包工具"误报 3178 条"，我实测 3221 条（原目录、副本一致，文件总数均为 5473）。差 43 条。原因未验证**，我**不猜测**：可能与当时测量时点的文件集/目录内容不同有关。我把 3178 当作"未能复现的既有描述"如实记下，不凑数。

---

## 6. 故意违规验证（完整过程）

全部原始输出见 `evidence/L1-iso-demo/`（`README.txt` 为本次运行的完整 tee 记录）。

### 6.1 基线（干净项目）

```
$ node tools/check-isolation-project.mjs
PASS | A 禁目录名：0 命中
PASS | B 项目外旧 app 路径：0 命中
PASS | C 代码引用/读取指向禁目录：0 命中
=== 项目专用隔离检查：PASS（0 处违规 / 62 处白名单 / 扫描 65 个文本文件）===
exit=0
```

### 6.2 制造违规

```
$ cat tools/__iso_selftest_a.mjs
// 临时违规样本 A：非文档源码里出现禁目录名字面量（用完即删）
export const legacyDir = 'wechat-game-0.1-ds';

$ cat tools/__iso_selftest_b.mjs
// 临时违规样本 B：绝对路径读取旧工程 app 目录（用完即删）
import { readFileSync } from 'node:fs';
export const src = readFileSync('/vol1/ai/projects/wyszz-new/app/legacy.js', 'utf8');

$ cat tools/__iso_selftest_c.mjs
// 临时违规样本 C：相对路径穿越出项目根（用完即删）
export const legacy = '../../app/main.js';

$ printf '参考目录：wechat-game-0.1-ds 里有旧实现。\n' > docs/__iso_selftest_doc.md
```

### 6.3 检查器报出（FAIL / exit 1）

```
$ node tools/check-isolation-project.mjs
FAIL | A | tools/__iso_selftest_a.mjs:2 | 出现禁目录名：wechat-game-0.1-ds | 原文："export const legacyDir = 'wechat-game-0.1-ds';"
FAIL | A | docs/__iso_selftest_doc.md:1 | 出现禁目录名：wechat-game-0.1-ds | 原文："参考目录：wechat-game-0.1-ds 里有旧实现。"
FAIL | B | tools/__iso_selftest_b.mjs:3 | 指向项目外旧 app 路径：/vol1/ai/projects/wyszz-new/app/legacy.js → /vol1/ai/projects/wyszz-new/app/legacy.js | 原文："export const src = readFileSync('/vol1/ai/projects/wyszz-new/app/legacy.js', 'utf8');"
FAIL | B | tools/__iso_selftest_c.mjs:2 | 指向项目外旧 app 路径：../../app/main.js → /vol1/ai/projects/wyszz-new/app/main.js | 原文："export const legacy = '../../app/main.js';"
FAIL | C | tools/__iso_selftest_b.mjs:3 | 代码引用/读取指向禁目录："/vol1/ai/projects/wyszz-new/app/legacy.js" | 原文："export const src = readFileSync('/vol1/ai/projects/wyszz-new/app/legacy.js', 'utf8');"

=== 项目专用隔离检查：FAIL（5 处违规 / 62 处白名单）===
exit=1
```

三条规则 **A / B / C 全部被触发**；`.md` 里没有禁止性措辞的禁名也**照样报出**（证明白名单不是"凡 `.md` 一律放行"）。

### 6.4 删除后恢复 PASS / exit 0

```
$ rm -f tools/__iso_selftest_a.mjs tools/__iso_selftest_b.mjs tools/__iso_selftest_c.mjs docs/__iso_selftest_doc.md
$ ls tools/__iso_selftest_* docs/__iso_selftest_*
ls: cannot access 'tools/__iso_selftest_*': No such file or directory
ls: cannot access 'docs/__iso_selftest_*': No such file or directory      # ← 无残留

$ node tools/check-isolation-project.mjs
PASS | A 禁目录名：0 命中
PASS | B 项目外旧 app 路径：0 命中
PASS | C 代码引用/读取指向禁目录：0 命中
=== 项目专用隔离检查：PASS（0 处违规 / 62 处白名单 / 扫描 65 个文本文件）===
exit=0
```

### 6.5 白名单边界验证（附加）

样本文件：`docs/__iso_selftest_doc.md`（单行）

| 内容 | 结果 | 退出码 |
|---|---|---|
| `参考目录：wechat-game-0.1-ds 里有旧实现。` | **FAIL**（1 处违规） | 1 |
| `禁止读取 wechat-game-0.1-ds 里的旧实现。` | **PASS**（该行转白名单，0 违规） | 0 |

→ 白名单**只对"声明禁区"生效**，且**只在 `.md`/`.txt` 生效**。验证后该临时文件已删除，终态复跑为 PASS / 0 违规。

### 6.6 回归失败路径端到端验证（附加）

```
$ printf 'export const legacy = "%s";\n' 'wechat-game-0.1-ds' > tools/__iso_selftest_regress.mjs
$ npm run regress -- --skip gameplay,ui,visual,browser,wechat
…
10  隔离检查(项目专用)      0.1s      FAIL
合计：执行 5 步，通过 4 步，失败 1 步；跳过 5 步；总耗时 1.3s
结论：FAIL（失败步骤：隔离检查(项目专用)）
exit=1                      # ← 任一步失败 ⇒ 整体非 0

$ rm -f tools/__iso_selftest_regress.mjs
$ npm run regress -- --skip gameplay,ui,visual,browser,wechat
10  隔离检查(项目专用)      0.1s      PASS    0 违规 / 62 白名单
合计：执行 5 步，通过 5 步，失败 0 步；跳过 5 步；总耗时 1.3s
结论：PASS（全量回归通过）
exit=0
```

→ "任何一步失败 ⇒ 整体失败（非 0 退出）" 已端到端验证。

---

## 7. 取证：原目录未被改动

```
$ find /vol1/ai/projects/wyszz-new/frontend-rebuild-hm -newermt "2026-10-12 09:11:00" -not -path "*/node_modules/*"
（空）

$ ls -la /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/
-rw-r--r--  1 root root   564 Oct 10 22:49 ISOLATION.md
-rw-r--r--  1 root root  1119 Oct 11 01:44 package.json
…（全部 mtime 均早于本次会话开始时间 09:11）
```

本次会话内**没有任何**原目录文件被创建或修改；对原目录只做了 `ls`、`read`/`cat`、`du`、`diff`，以及**只读**地跑了一次契约包检查器。

---

## 8. 读过的目录 / 文件清单

**读过的目录（全部在允许范围内）**
- `/vol1/ai/projects/wyszz-new/`（仅 `ls` 顶层）
- `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/`（原项目，只读）：`ls -la`、`du`、顶层文件清单
- `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/{src,src/app,test,tools,docs,tests}/`（目录清单）
- `/vol1/ai/projects/wyszz-new/frontend-rebuild-contract-v1/`（`ls`）与 `…/tools/`（`ls`、读源码）
- `/vol1/ai/projects/wyszz-new/docs/`（**仅 `ls` 文件名**；企划书 v0.3 / 迭代计划 v2 / 计划修改报告的**正文未读**，L1 不需要）
- `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1/`（副本，全部工作在此）

**读过的具体文件**
- 原目录：`package.json`、`ISOLATION.md`
- 契约包：`tools/check-isolation.mjs`（全文）、`tools/run-fixtures.mjs`（全文）
- 副本：`package.json`、`ISOLATION.md`、`test/browser.test.mjs`、`test/lib.mjs`、`test/t-fixtures.mjs`（尾部）、`test/wechat-sim.mjs`（尾部）、`tools/build-core.mjs`、`tools/build-web.mjs`、`tools/build-wechat.mjs`、`tools/test-fixtures.mjs`、`tools/test-session-replay.mjs`、`tests/session-replay.ts`、`docs/02`/`docs/03`/`docs/04`（仅 grep 关键数字）

**未访问**：`wechat-game-0.1-ds/`、`3d-spike-ds/`、`wechat-spike-ds/`、`/vol1/ai/projects/wyszz-new/app/`、`MIMO` 目录、任何旧截图 / 旧公开页面 / 旧模型素材、`docs/` 里的旧截图与旧"第二步"报告。**契约包未被修改。**

> 需如实披露：本会话的**默认工作目录**被 harness 设为 `/vol1/ai/projects/little-town`（`pwd` 输出即为它）。我**没有读取该目录下的任何文件**，所有命令都显式 `cd`/`workdir` 到副本目录；但"`little-town` 出现在会话上下文里"这一事实本身予以记录。

---

## 9. 未验证项（一律如实标注）

1. **微信官方模拟器 / 真机 / AppID 上传：未验证。** 本次只跑替身模拟（`test/wechat-sim.mjs`，Worker 无 DOM + 模拟 `wx`），它**不能**替代真机结果。
2. **`npm run test:public` 公网预览检查：本次未运行、未验证。** 按任务书它是已知 404 缺口，且需网络；未纳入回归。
3. **契约包工具"3178 条"：未复现**（实测 3221），差异原因未验证（见 §5.3）。
4. **真机性能：未验证。** 视觉测试里的 26.5 fps 是 **SwiftShader 软件渲染**下的可运行性参考值，不是真机帧率。
5. **Chromium 具体版本：未记录 / 未验证**（只知来自 `/usr/bin/chromium` 探测）。
6. **白名单规则的完备性：仅在本次构造的样本上验证。** 没有历史真实违规样本可做回归，无法证明"任何形式的真实违规都不会被白名单吞掉"。
7. **契约包检查器本身的正确性：未验证**（不在 L1 范围；我只读了它的源码来定位误报，未跑它的正向场景）。
8. **`ISOLATION_DOCS`（W3）白名单未被外部评审**：这是我自行加入的放行入口，是否可接受由 Lead 判定（Q2/Q3）。

---

## 10. 我不确定的地方 / 待决问题

**不确定**
1. `MIMO` 我用了**大小写不敏感**匹配（`/mimo/i`）。当前项目无任何 `mimo` 字样子串，所以没有误报；但若将来代码里出现类似 `mimoX` 的标识符会误报。是否改成大小写敏感，我不确定。
2. 规则 B 把"**任何**解析后越出项目根的 `../…/app/…` 相对路径"都算违规（不限于 `/vol1/ai/projects/wyszz-new/app`）。这更严，但理论上会误伤"指向别的合法外部目录且恰好有 `app` 段"的写法（当前项目没有这种写法）。
3. 白名单 W2 我按**段落**判定，因此 `docs/10`、`docs/11` 这两份**任务书本身**里对禁目录名的引用被放行了。严格说它们"确实引用了禁目录名"，是否应放行，我判断不了。
4. **W3 是我自己加的**：本报告必须原样引用禁目录名与 FAIL 输出，否则规则 A/B/C 必然命中它。我选择加一个显式文件白名单而不是"让回归失败"或"把禁名从报告里抹掉"，但这是设计判断，不是任务书明确要求的。

**待决问题（需要 Lead 决定，我不猜）**
- **Q1**：`docs/10-多智能体作战手册-下-任务书.md` 与 `docs/11-0.1收尾任务书-分级.md`（副本内）含禁目录名**字面量**，目前靠 W2 白名单放行。保留（并接受白名单）还是改写 / 移除？
- **Q2**：`ISOLATION_DOCS`（W3）这个"文件级放行入口"是否保留？如果 Lead 要求"白名单只允许 `ISOLATION.md`"，那么本报告与 `docs/10`、`docs/11` 都会导致 FAIL —— 需要先决定**怎么处理隔离报告里的禁名引用**（抹掉？放 `evidence/`？还是接受白名单？）。
- **Q3**：是否要把 W3 的判定从"硬编码路径数组"改成外部清单文件（如 `tools/isolation-whitelist.json`），以便评审与审计？
- **Q4**：契约包工具的 3178 与我实测的 3221 差 43 条 —— 需要 Lead 提供当时的测量上下文（在哪个目录、什么时点）才能定论。
- **Q5**：`regress` 是否默认改为 `--fail-fast`？（当前默认跑完全部，便于看完整表，但失败时会白跑后续重步骤。）
- **Q6**：步骤 5–8 的浏览器冗余（玩法 / UI / 视觉各 1 次 + 全量 1 次，约 124 s）是否保留？任务书要求了这个映射，我照做了；若只为"守门"，可只留第 8 步。
- **Q7**：`check:isolation` 与 `regress` 两个脚本是否要**回填到原目录** `frontend-rebuild-hm/`？本次按硬规则只在副本里工作，**原目录未改**。
- **Q8**：`test:public` 在公网预览恢复后是否纳入 `regress`？（需要网络；纳入后回归不再是纯离线。）

---

## 11. 复核命令（供 Lead 一键复现）

```bash
export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L1

npm run check:isolation          # 期望：PASS（0 处违规），exit 0
npm run regress                  # 期望：10/10 PASS，exit 0，末尾打印结果表
node /vol1/ai/projects/wyszz-new/frontend-rebuild-contract-v1/tools/check-isolation.mjs --root . \
  | tail -1                      # 期望：FAIL（3221 处命中）—— 对照用，说明为何需要专用脚本
```

---

## 12. 本报告自身的 SHA256

本报告 **第 1–11 节正文**（即本行之前的全部内容）的 SHA256：

```
19cf9cb9d52e3f29f849cc195302920de90e5e68e56702020267b101052f94ca
```

说明：
- 文件无法包含自身的最终哈希，因此这里给的是**去掉第 12 节本身**之后的内容哈希；该值稳定、可复现（本节文字不影响它）。
- 复现方式：`awk '/## 12\. 本报告自身的 SHA256/{exit} {print}' docs/L1-隔离检查与一键回归-报告.md | sha256sum`。
- 整个文件（含本节）的最终 SHA256 见回传消息；本节文字不含任何禁目录名，不影响隔离检查结果。
