# oracle/ —— Windows 真值源工具

**独立 Windows/MSVC 工程，不在主 CMake 树内。** 施工文档：[`../docs/steps/00-oracle.md`](../docs/steps/00-oracle.md)

## 两条轨

| 轨 | 产物 | 状态 |
|---|---|---|
| **Oracle-Lite**（只用 `granny2.dll` C API） | `granny_probe.exe` · `oracle dump` CLI · 最小 D3D9 渲染器 | 必做，关键路径 |
| **Oracle-Full**（+ 抽出的 `EterGrnLib`） | `oracle_etergrn` + 层② dump | 延后，demo 不需要 |

## 目录

```
oracle/
  oracle.c                  ★ Oracle-Lite 全部：probe（T1）+ dump（T3 层① / T5 蒙皮顶点）
  CMakeLists.txt            Windows/MSVC 工程，链泄露 SDK 的 granny2_x64.lib
  RUNBOOK.md                怎么 build+run（原生 Windows / Wine / stretch: POSIX 移植）
  GRANNY-VERSION.md         版本判定 + 候选对比（待跑 probe 填实）
  FORMAT.md                 dump 二进制布局 + 坐标约定
  vendor/                   锁定的 granny2 DLL（T1 选定后 git-track）
  render/                   独立最小 D3D9 → PNG（T6，不依赖 EterGrnLib；待写）
  selfcheck.*               T7 自检（Windows CI runner；逻辑见 RUNBOOK.md「selfcheck」）
  full/                     Oracle-Full：oracle_etergrn + 层② dump（T2/T4，延后）
```

## 状态

- [x] `oracle.c` —— probe + dump（层① 世界矩阵 + mesh N 蒙皮顶点）
- [x] **macOS + Wine 跑通**（`build-wine.sh` = MinGW-w64 交叉编译 + wine-stable）。Granny **2.9.12.0**。
- [x] **T1** DLL 选定 + probe vs `gr2dump` 逐字段一致（`GRANNY-VERSION.md`）
- [x] **T3/T5** 层① dump + 蒙皮顶点 dump 跑通；**M2 门禁·主对拍 PASS**：
  - `warrior_cheongrin` bind + `dance_1` @ t={0, 4.7, 11.333, 20}：骨骼矩阵 `max|Δ| ≤ 4.1e-5`、蒙皮顶点 `max‖Δ‖ ≤ 6.5e-5`
  - `assassin`（双 root，非单位 InitialPlacement）bind：`3.1e-5 / 4.6e-5`
  - 对拍工具 `tools/oracle_diff`（libgr2 侧读 `.bin` 逐字段比）
- [ ] T8 noise_floor.json（跑同 dump 100 次 + 换相邻 DLL 一次，取 `max|Δ|`）
- [ ] T6 D3D9 确定态截图 harness（M1 视觉对拍用）
- [ ] Oracle-Full（层②，`EterGrnLib`）—— 延后

## 输出

- dump → `../test/oracle_dumps/`（格式见 `FORMAT.md`）
- 噪声地板 → `../test/noise_floor.json`（T8，M2 用它设 ε）