MobileGL/docs/Disaggregated/notes/p9/W2-REMINT.md

# P9 W2：`texture-remint-pull`——重铸不需要拉取

> 2026-09-29，分支 `p9/w2`（基线 `ad705a73`）。交接：[`HANDOFF-P9.md`](HANDOFF-P9.md) §3 W2 / W4。
> 裁定（集成方）：采纳 A——不做拉取协议，删 `OnTexturePullRequest`；monolith Espryt 的缺陷不在 P9 修（§6 单列）；W2-b 只退回 store；W4 不做（§5 只记测量）。

## 1. 结论

两个后端在 split 下重铸都只用 server 自己的字节，client 从不参与：

| 后端 | split | monolith |
|---|---|---|
| Espryt | `RequireImageBindableStorageByHandle`（`MobileGL/MG_Backend/DirectGLES/Managers.cpp:6289`，`c1bf7e15` 落地）：驱动上存在的层逐层读回旧 GPU 纹理（`ReadTextureLevelTight`），pending 盒用 `StagedTextureStore` 合并后整层重放；已 immutable 且无需加宽的原样保留（keep） | 前端臂 `RequireImageBindableStorage`（`Managers.cpp:6459`）重放 client 影子 |
| Magma | 重建带 `STORAGE` 的 VkImage，`PreserveTextureContentsOnRecreate`（`MobileGL/MG_Backend/DirectVulkan/Renderer/VkTextureManager.cpp:289`）GPU→GPU；wire 臂 `SyncWireTextureShape` 的 `preserve`（`:2254`） | 同一套（`SyncTextureResource`，`:3313`） |

- **只读 store 不够**：store 只有 client 上传过的字节；GPU 写过的层（渲染目标、clear、生成的 mip）在 store 里是旧的或没有。普查里 Espryt 的两次重铸都是 store 无字节的渲染目标（§4）。
- `Fatal{UnmigratedEmulation, "texture-remint-pull"}` 的两处标记都在前端臂里，transport 下不可达（P7 与本次普查都是 0 次），随本包删除。

## 2. 改了什么

| 包 | 内容 |
|---|---|
| W2-a | 回读前问驱动这一层在不在、尺寸对不对（`NativeTextureLevelHasExtent`，`DirectGLES/WireTextureReadback.inc:290`，`glGetTexLevelParameteriv`）。不在：store 覆盖就重放 store，否则跳过（GL 定义为未定义内容）。修的是：在最后一次 sync 之后才定义（空数据，或空数据 + 局部上传）的层，旧代码去读它 → FBO 不完整 → `Fatal{ResourceUnavailable, "image-promotion-readback"}`，合法 GL 让会话死掉 |
| W2-b | 驱动拒绝回读（设备上 SNORM / 16 位 norm / 无 `EXT_color_buffer_float` 的浮点不可渲染）而 store 覆盖该层 → 重放 store（= monolith 的答案），`MGLOG_W_ONCE` 带 `remint-readback-fallback`；store 也不覆盖才保留原 Fatal。测试旋钮 `MGITEST_ESPRYT_FORCE_REMINT_READBACK_FAILURE`（server 读） |
| W2-c | 删两处 `texture-remint-pull` 标记（transport 专用的提前标记块 + 循环内标记）；`PipeCatalogue.EveryUnmigratedEmulationIsNamedOnce` 5 → 4；「remint stall class」注释改写 |
| W2-d | `TextureRemintPulls`（`trp=`）在 server 路径也计：ByHandle 重铸已有存储时 +1（keep 不计），名字不改 |
| W2-e | 删 `OnTexturePullRequest`，`kMGPipeCallbackCount` 9 → 8；op 50 `ResourceSubDataComplete` 留作退役行（解码仍拒收），不改 `protocol.fbs` |
| W2-f/g | `TextureRemintPullScenario`：14 例 × 两后端 × {monolith, Split, Spawn, Tcp}；另有 `DirectGLES.{Split,Spawn}.RemintFallback.` 4 例（W2-b 旋钮，tcp 不带，理由同 `MAGMA_SERVER_ENV_KNOB_NO_TCP`） |

没改：Magma 无功能改动；`MOBILEGL_PIPE_TEXEL_RETAIN_MB`（`Config.h:400-403`）已无消费者但不在 PUSH 守卫内，删它动 pull 的 `Features` / `ConfigLoader`（G1），留到 P13。

## 3. 覆盖矩阵（场景 14 例）

内容 → 采样 draw（让后端持有存储）→（按例）GPU 写 → `glBindImageTexture` → compute `imageLoad` 拷到一张「sync 之前就 image 绑定」的 RGBA8 → FBO 回读，比 GL 正确答案。

| 例 | 内容来源 | store | 驱动上的层 | Espryt mono / pull | Espryt split / spawn / tcp | Magma 全部臂 |
|---|---|---|---|---|---|---|
| A 可变，上传 | 上传 | 有，= GPU | 有 | ✓ | ✓ | ✓ |
| B 可变，上传 → GPU clear | GPU | 旧 | 有 | **✗ 旧影子** | ✓ | ✓ |
| C immutable RGBA8，上传 → clear | GPU | 旧 | 有 | **✗** | ✓（keep） | ✓ |
| D 空定义 → clear | GPU | 无 | 有 | **✗ 零** | ✓ | ✓ |
| E clear → 未 sync 的局部上传 | GPU + 盒 | 盒 | 有 | **✗** | ✓（合并） | ✓ |
| F `glGenerateMipmap` 的 level 1 | GPU | 无 | 有 | **✗ 零** | ✓ | ✓ |
| F2 上传的 level 1 → clear | GPU | 旧 | 有 | **✗** | ✓ | ✓ |
| G sync 后空定义 level 1，绑 level 0 | — | 无 | **无** | ✓ | ✓（W2-a 前 Fatal） | ✓ |
| G2 sync 后以更大尺寸空定义 level 0 | — | 无 | 旧尺寸 | 不 Fatal | 不 Fatal | 不 Fatal |
| G3 G + 局部上传，绑 level 1 | 上传 | 整层 | **无** | ✓ | ✓（W2-a 前 Fatal） | ✓ |
| H 加宽 rg8 immutable，上传 → clear | GPU | 旧 | 有 | **✗** | ✓（promote） | ✓ |
| H2 / I / J 加宽 rg8 / RGBA8_SNORM / RGBA16_SNORM，仅上传 | 上传 | 有 | 有 | ✓ | ✓ | ✓ |

「谁都没有字节」只剩 G / G3，而那里 GL 不要求字节（G）或字节就在 store（G3）。Espryt 重铸代价：一次 `glFinish` + 逐层回读 + 整层重传，主机 0.3–6.5 ms / 次；GPU→GPU 是优化，只记录。

## 4. 普查（主机 lavapipe/llvmpipe，77 行 × {monolith, inproc} = 154 次，`MOBILEGL_PIPE_STATS=1`）

口径同 P7 E1（CI 旋钮、每条单独 `ctest`、`-j 2`）；154 次 rc 全 0、`Fatal{` 0 行。只有下表非零，其余 71 行全零：

| case | 后端 | monolith 重铸已有存储（`trp`） | split | mono / split SSIM |
|---|---|---|---|---|
| `iris-photon-v1.3b` | GLES | 1，RGBA16F 1 层，GPU ≠ 影子 | promote 1，回读 165,888 B，store 无字节，0.3 ms | 0.998774617 / 同（纹理随后被整张覆盖） |
| `iris-derivative` | GLES | 1，RGBA16F 1 层，GPU ≠ 影子 | promote 1，回读 3,279,360 B，store 无字节，6.5 ms | **0.996196552 / 0.996376198**（§6） |
| `create-indirect` | GLES | 0（首次分配，9 层） | 0（首次分配） | 0.999961275 / 同 |
| `iris-photon-v1.3b` / `iris-derivative` / `iris-iterationrp` | Vulkan | STORAGE 升级 1 / 1 / 4 | 1 / 1 / 5 | 全 `preserve`（GPU→GPU） |

与 P4a 的「780 个统计窗口 2 次」同两条 trace。测量用的是临时插桩（未提交），跑器与原始数据在 `~/w7/notes/p9/w2census/`。

## 5. W4：反向通道事件量（inproc，server 侧逐事件计，同一次普查）

| 量 | 读数 |
|---|---|
| `OnBufferWriteback` | 只有 `create-indirect`：两后端各 6 片、7,180 B，最大单片 6,656 B（上限 SEG_EVENT / 4 = 64 KiB） |
| `OnGpuWritten` | 只有 `create-indirect` × Vulkan：7,093 条（每条 1 个 whole-buffer range，几乎全在第一帧）；Espryt 同 trace 0 条 |
| `OnGlError` / 阻塞（ring 满）/ 丢弃 | 0 / 0 / 0 |

Magma 的 7,093 条是冗余的：transport 臂每次 draw / dispatch 对每个可写 SSBO / texel buffer / XFB 目标发一条 whole-buffer `OnGpuWritten`（`VkBufferManager.cpp` 的 `MarkWireBufferGpuWritten`），而 client 早已按同一组绑定自标保守集（`MG_Remote/Client/GpuWritePending.h`）；Espryt 的同名生产者 P5e fb 已在 transport 下删掉。**裁定：没有阻塞、没有丢弃 = 没有实测需求，不做。** 以后要做，改动是「transport 下只保留 server 簿记、不发事件」。今天没有逐 EventKind 的计数器，`eventDropped` 也不进 stats 行。

## 6. dev 缺陷：monolith Espryt 重铸重放过期影子（不在 P9 修，单独立项）

> **2026-09-29 已修**：dev `568090f0`（重铸前先把驱动上的各层读回影子，immutable 且无需加宽的分配直接保留），P11 合并进本线（`notes/p11/INTEGRATOR-DECISIONS-P11.md` ID-P11-6）；`TextureRemintPullScenario` 对 monolith DirectGLES 的 7 例 skip 已撤，iris-derivative 的 monolith SSIM 0.996196817 → 0.996376498，与 split 各臂相同。下文是当时的记录。

- **一句话原因**：前端臂 `RequireImageBindableStorage`（`Managers.cpp:6459`）把每个已定义层标脏、从 client `MipmapStorage` 重放进新 carrier，而影子从没见过 GPU 写的内容（渲染目标、clear、`glGenerateMipmap` 的层、`imageStore`）；immutable RGBA8 也走这条（monolith 没有 split 的 keep）。
- **复现**：本场景的 B、C、D、E、F、F2、H 在 `DirectGLES.TextureRemintPullScenario.*`（monolith）和 pull 构建（`build-linux`）逐例同错（B：读到上传的图案而不是 clear 的绿；D、F：读到零）。Magma 两臂全对。场景对 monolith DirectGLES 这 7 例按名 skip，理由指向本节。
- **真实证据**：`iris-derivative` × DirectGLES，P7 普查 §3 #6 那个「未归因」的 ~26.9k px 系统差。monolith 在该 trace 重铸一张 854×480 RGBA16F（GPU ≠ 影子）；把前端臂改成重放 GPU 字节（临时实验）后 monolith 的 `actual.png` 与 split 逐字节相同（sha `ebbe8e9d…`），SSIM 0.996196552 → 0.996376198（更近 golden）。`iris-photon-v1.3b` 同样重铸一次，但纹理随后被整张覆盖，无可见差。
- **建议修法**：前端臂在重放前，对 `hadBackendStorage` 且无 pending 的层从旧驱动纹理读回（Espryt 已有同一把工具 `ReadTextureLevelTight`，目前只编进 `MOBILEGL_BUILD_DISAGGREGATED`）写进影子再重放；或更干净地学 Magma：`glCopyImageSubData` / 着色器拷贝 GPU→GPU，影子不参与。
- **G1**：函数主体是 pull 构建共用代码；任何修法都会动 pull 的 `.text`（`ReadTextureLevelTight` 还得搬出 disaggregated 守卫）。按规矩在 dev 上单独修，不在 P9。

## 7. 未决 / 观察

- **keep 路径的一个排序缺口（非重铸问题）**：C 在 Espryt split 上不加 barrier 时 30 次里 3 次读到 clear 之前的纹素（加 `glMemoryBarrier(GL_ALL_BARRIER_BITS)` 后 0 / 30），失败与通过两种运行里 server 的每个同步决定完全一样（临时日志：keep、无 regen、无上传）。GL 不要求 framebuffer 写之后、imageLoad 之前加 barrier；promote 路径因 `glFinish` 回读被串行化，所以只有 keep 暴露。怀疑 llvmpipe 的 compute image 读没有等待挂起的光栅场景，未归因。场景在 dispatch 前加了 barrier（注释写明），这件事单独记。
- **设备格式风险**：Adreno 830 上 SNORM 等格式的回读是否被拒没测（本包不碰设备）；W2-b 让这种情况退回 store，只有「GPU 写过 + 不可读 + store 无字节」才 Fatal。
- 多重采样：`ReadTextureLevelTight` 对 MS 直接失败；ES 没有 MS image 单元，只有「MS + 需加宽 + 已有存储」才进 promote。理论可达，没见过。

## 8. 门与 red-once（R-16）

| 门 | 红的方式（临时改动，已还原，真跑过） | 结果 |
|---|---|---|
| G：`ALevelDefinedWithoutDataAfterTheLastSyncDoesNotEndTheSession` | 去掉 W2-a 检查 | Split / Spawn / Tcp 3 / 3 `Subprocess aborted` |
| G3：`APartialUploadIntoALevelDefinedAfterTheLastSyncReachesTheImage` | W2-a 与 W2-b 一起去掉（G3 被两者各自兜住） | 3 / 3 aborted（G 同） |
| `RemintFallback.*`（W2-b） | 退路改回 Fatal | 8 / 8 aborted |
| `trp=`（W2-d） | 删 server 路径的 +1 | inproc 上 A、H 红，C（keep）保持绿 |
| Espryt 读 GPU 是承重的 | 不改代码，整组 split 场景带 `MGITEST_ESPRYT_FORCE_REMINT_READBACK_FAILURE=1`（= 只读 store） | B、E、F2、H 读到旧字节，D、F aborted（store 无字节）；C（keep）、A、G、G2、G3、H2、I、J 绿 |
| Magma 的 GPU→GPU 保留 | 两臂 `preserve` 恒 false | 4 臂 × 12 例红（G2、G3 除外） |
| 回调数、名单 | `static_assert` + `PipeCatalogue.ReverseChannelHasTenCallbacks`（断言 8）、`EveryUnmigratedEmulationIsNamedOnce`（断言 4） | 编译期 / 名单钉 |