# 16 — 项目目录整理

Status: resolved
Type: task

## 需求

> 整理一下当前的项目目录，该删的删，该挪得挪

## 删了什么

| 删掉的 | 大小 | 理由 |
| --- | --- | --- |
| `tools/.cache/` | 471 MB | Edge CDP profile 缓存，每次跑对拍都会重建 |
| `tools/shots/*`（留 `baseline-pre-refactor`） | 457 MB | 历史对拍截图，唯一还在用的是那份重构前基线 |
| `.scratch/dist-baseline/` | 96.9 MB | `.gitignore` 里写明"验证完即删"的临时判据 |
| `.scratch/sim-failed/` | 51.8 MB | `assertParses` 失败时的模块转储 |
| `.scratch/fileproto/` | 38.0 MB | file:// 协议探针产物 |
| `.scratch/sim-scripts/` | 15.2 MB | 从自包含页抽出的内联脚本 |
| `.scratch/timing/`、`.scratch/probe/` | 2.7 MB | 探针产物 |
| `.scratch/tmp.txt` | — | 临时文件 |
| `.scratch/compare-presets.mts` | — | 重构等价性一次性对拍，基线已删 |
| `tools/ascii.mjs`、`frame.mjs`、`subject.mjs` | — | 零引用（且 git 里有，可找回） |
| `wallpapers/audios/` | 空 | 0 条目、无代码引用 |

释放约 **1.11 GB**（1870 MB → 737 MB）。注意 `tools/.cache` 会在下次对拍时重新长出来——
这正说明它是纯缓存。

## 挪了什么

- `wallpaper-source.txt`（根目录）→ `wallpapers/sources.txt`。它是壁纸的**来源 URL 清单**，
  放在根目录是散落的，归到它所描述的数据旁边。
- 已发布基线从 `.scratch/dist-baseline/project.json`（96.9 MB 目录里的一个小文件）
  → `.scratch/published-project.json`（3895 字节）。`diff-project.mts` 跟着改。

## 没删什么（以及为什么）

- `masters/`（75 MB）：`.gitignore` 写明"无损音频母带：只在本地留存"。
- `tools/shots/baseline-pre-refactor/`（30 MB）：**不能重新生成**（是重构前拍的），
  而 `verify-visual-equivalence.mts` 靠它判"渲染有没有被改坏"。
- `dist/`（388.8 MB）：可再生产物，但调试服正在用它，删了要重建才有得看。
- `tools/{capture,cdp,diff,serve,shot,compare,heatmap,rawdiff,atlas-pages}.mjs`：都有引用。

## 顺手修掉一个"空验证"

清理时发现 `verify-visual-equivalence.mts` 有个真问题：

```js
if (!existsSync(a) || !existsSync(b)) { console.log("缺少文件，跳过"); continue }
...
failed === 0 ? `视觉等价：${checked} 组全部与重构前逐像素相同`
```

我删掉了它的"当前截图"目录之后，它把 **0 组比对报成了"0 组全部逐像素相同"**——一句绿色的空话。

> 一个不检查前置条件的验证等于没有验证。

改成：缺文件就**直接失败**并打印出该跑哪两条命令；结尾再兜一道 `checked !== combos.length`。

**证明它会红**：删掉截图后跑，得到
`✗ 缺少 6 个截图，无法比对：…` 与明确的补救命令；补拍之后再跑，得到真正的
`视觉等价：6 组全部与重构前逐像素相同`。

## 验证

整理后全量回归，全绿：

- `pnpm check`：四个分发、`check:dist` / `check:syntax` / `check:paths` 全过
- 调试服冒烟、浏览器冒烟、面板还原度（10 组）、热更新、开发模式构建开关
- 四档自包含包 `file://`、静态托管预览、sim 门禁、内联守卫、模块改写
- `diff-project`（用精简后的基线）、`verify-visual-equivalence`（6 组逐像素相同）