Files
MobileGL/docs/Disaggregated/notes/p5f/HANDOFF-CI-INPROC-20260920.md
T

204 lines
17 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CI / inproc 功能补齐交接(2026-09-20,用户要求停止)
> 用户最后明确要求:“写个交接文档,不要继续你未完成的任务了”。已停止继续实现、构建、测试和推送,只整理本交接。所有子 agent 已结束/中断;停止时检查没有本任务的 retrace / CTest / replay 进程在运行。最后启动的完整 retrace 已自行结束,结果已读入本文。
>
> **任务尚未完成,GitHub CI 尚不能宣称全绿。本轮修复没有 push,也没有合并到 `feat/disaggregated`。**
## 1. 用户确定的范围
- `feat/disaggregated` 的主产物必须编译拆分实现,并实际以 `inproc` 执行主验收。
- 普通 OpenGL 功能场景、完整 retrace 矩阵都应迁移并通过。不得用 skip、降低 SSIM、缩矩阵、吞退出码或“仅记录 census”替代实现。
- 明确验证 monolith 内部机制的对照保留 monolith,不强改成 inproc。
- D/P 只是 `MOBILEGL_BUILD_DISAGGREGATED` / `MOBILEGL_PIPE_PUSH` 两个编译开关;运行时还需 `MOBILEGL_TRANSPORT=inproc`。已向用户解释,后续尽量直接说中文。
- 本轮是此前 P5f / Magma run-ahead / RD32 性能工作的后续 CI 修复。历史 P5f 完成不等于现在扩展出的全部 inproc 功能验收完成。
## 2. 工作树、提交与未提交改动
基础目录:`C:/Users/geekerwan/AndroidStudioProjects/FoldCraftLauncher/`。
| 用途 | 路径 / 分支 | 停止时 HEAD |
|---|---|---|
| 本轮所有实现,后续应从这里继续 | `MobileGL-ci-fix` / `codex/fix-github-ci` | **`70c8230b3e05a8d62d881d4996db27e0ad251936`** |
| 用户交付树,尚未集成本轮修复 | `MobileGL-disagg` / `feat/disaggregated` | **`30b1bf25a4ea5ed8394dc9909c420051633c5115`** |
| WSL Arch 测试树 | `/home/swung/w7/p5f-int` / `codex/ci-fix` | **`70c8230b3e05a8d62d881d4996db27e0ad251936`** |
| 默认会话 cwd | `MobileGL` / `dev` | 不是本轮修改树,勿误改 |
`MobileGL-ci-fix` 有两份**未提交、不能当成已验证成品**的改动:
- `.github/workflows/test.yml`
- `.github/workflows/apk.yml`
这是 fm 最后审查 artifact 清理时留下的修改:Linux cleanup 等待/识别 `retrace-split`;保留失败 case 的 fixture 和结果;两工作流先成功读取完整 GitHub 分页 inventory,再执行删除,避免 process substitution 的 API 失败被当成“没有失败用例”。修改已落盘,但 agent 随后结束,未拿到完整最终校验/提交回报。后续先审 diff,不要直接丢掉,也不要假定已测试。
本交接文档另外新增在 CI 树和交付树,尚未提交。交付树原 `HANDOFF-P5F.md` 顶部增加了本交接入口。
### 必须保留的交付树现有修改
- `MobileGL-disagg/build.gradle`:SHA256 `331C22D6509AC5E5794F135E27D024675808220EC5001E404803BAB889DF1FF5`
- `MobileGL-disagg/android-plugin/app/build.gradle.kts`:SHA256 `FA7F21664A05A7172376DD47E00F435158D20E2F6422626C5D932B3228CF950C`
- `.trace-work/`、`Testing/`、`docs/Disaggregated/inproc-dataflow.html` 均为停止时已有未跟踪内容。
- 前两份 Gradle 改动是先前 FCL 本地测试 plumbing,与本轮新提交的 Gradle wiring 有重叠。最终集成要逐项协调,尤其旧 embedded-FCL arm64 限制;不要 reset 或把无关修改一起提交。
- FCL 父仓库此前有 `UU FCL/src/main/java/com/tungsten/fclauncher/FCLauncher.java` 等用户改动,不属于本轮。
- 不修复既有 DiligentCore gitdir 噪声。看状态/差异可用 `--ignore-submodules` / `--ignore-submodules=all`。
### WSL 状态
停止时除了 `tools/trace_replay/fixtures/` 的 LFS 实体文件外,WSL tracked 源码无差异。fixture 显示很多 `M`:这是把 LFS pointer 替换成已按 pointer SHA256 校验的真实文件,**不是换 golden**。共补齐 92 个 LFS 文件,来源为已有 `/home/swung/mgl/MobileGL` 或 Windows CI 树。不要直接 reset 成 pointer 后又把解包失败误当 renderer 失败。
未跟踪的 `Testing/`、`build-pull/`、`build-trace-ci/` 保留。`build-pull/` 原已存在。
Windows → WSL 的正常同步方式(不要让 Linux git 直接操作 Windows 工作树):
```bash
git -C ~/w7/p5f-int fetch /mnt/c/Users/geekerwan/AndroidStudioProjects/FoldCraftLauncher/.git/modules/MobileGL refs/heads/codex/fix-github-ci
git -C ~/w7/p5f-int -c submodule.recurse=false merge --ff-only FETCH_HEAD
```
## 3. 已完成的实现与关键提交
以下均已提交在 CI 分支;“已实现”不替代第 4 节的实际验证范围。
| 主题 | 提交 / 说明 |
|---|---|
| CI 主产物与完整双模式矩阵 | `7e82ea0f`、`bb3a5199`、`97ce032f`:目标分支主库/APK 开 D/P + INPROC;完整 **77 个 case/backend × 2 transport = 154**;日志、artifact、汇总分模式;独立 OFF/pull 库供错误库负控 |
| 清除旧“预期红 / census 算通过” | `347bb90c`:客户端数组专用通道必须绿并纳入主 GPU/split 标签;全量 inproc CTest 退出码为硬门 |
| 合法 monolith 对照 | `11132981`:指针/slot ABA、CSO 开关、resource/object mask、direct-adoption 计数等机制对照明确 monolith;普通像素功能保持当前模式。`03c6b8c9` 纠正 TextureUploadShape,应仍测 inproc,测试内等真实 applied boundary |
| 原 Linux CI 红 | `08c63f77`:统计等绘制 Present applied;`10bfd29f`:E1 负控改为观察真实协议 wait,避免要求所有 run-ahead draw 在 VERB_BARRIER=0 时必崩 |
| Android 回放生命周期 | `7fd83133`:retained ReplaySession、重建时取消旧 callback/unbind、trace configChanges 整数资源、native 原子 lease、ANativeWindow 生命周期;防两个 Activity 同时进入 JNI 全局回放 |
| 客户端顶点/索引 | `beba0256`:复制到 owned 普通 wire buffer;GPU EBO/indirect/count 先真实同步;保留 baseVertex/baseInstance/drawID;新增 GL 回归 |
| XFB / 查询 | `d0c6fdbc`、`70df57bb`、`8eaebc90`、`e2d6e33d`:Magma wire capture、真实 native query/result、XFB lifetime 删除、空捕获 buffer lazy readback;`4610b573` 防首次握手在 renderer 未创建时调用 Vulkan timer hook;`c7de0dff` 补齐 32 个 verb-boundary 的逐项断言 |
| GLES image / view / SSO | `c1bf7e15`、`57e0f6be`:server-owned promotion、native view;`c3a5d2f5`:空 image slot 保持实际 unit,避免高位空槽误解绑 unit 0,非当前 SSBO 程序先发布;`e2d6e33d`:sampler high-water tracker、whitebox peek 在 apply 线程执行 |
| 纹理读回 / PBO | `29b5e064`、`7875e28c`、`c0b40ff5`、`859c0efb`、`44cac27b`:真实服务端 GPU bytes、PACK/PBO 由 client 写入、texture 大回复分块、完整目的范围检查、避免同步 PBO 回复后虚构 pending GPU write;`f5234b9e` signed/half depth 编码 |
| sparse mip / packed format | `cf0f77b0` 暂时隔离 GLES native BASE/MAX;`40c5443f` **MGPSubData 72 → 88 字节**,携带完整 level extent;`ed01f4e3` 同时修 GLES hook 与通用 applier 的 adoption;`616f3c90` 按 Vulkan format 能力设置 attachment usage、只允许真正无 backing 且非 GPU-dirty 的 server stage 读回;`d339053e` RGB 展开前真实长度/溢出检查 |
| framebuffer / MSAA | `1389e8e7` cube face→layer;`ec4ca06d` color resolve;`0cb0e9af` RP2 depth/stencil resolve;`7b926429` 经纯 GPU 单 aspect buffer 中转保留另一 aspect,并补正确 resolve-write 屏障 |
| packed-float mip 生成 | `5310ff62` 缺 native blit 时用真实 GPU shader 逐 mip/layer 生成;`2426abb8` backend 裁 logical mip window;`70c8230b` frontend immutable/view 不再重分配或截断 owner,mutable 只更新生成窗口,新增窗口回归 |
注意:`MGPMipPlan.LevelCount` 在当前组合里保持 **logical end-exclusive**,不是 `BaseLevel` 后的数量。backend 先减 logical base,再映射 storage root。这个语义不可单边改。
GLES 的 texture-view 功能原本需 `MOBILEGL_ESPRYT_ENABLE_TEXTURE_VIEW=1`。相关功能 case 的 CTest recipe 已显式开启;早先 view construction 失败不是 CapsMirror 非虚函数问题。
## 4. 验证快照:不要混淆不同提交
统一证据目录:
- WSL:`/home/swung/w7/ci-fix-logs/`
- Windows:`C:/Users/geekerwan/.codex/tmp/github-ci-fix-20260920/`
### 4.1 完整 unit / GPU 最近一次整轮
**`5922e54b`**:`/home/swung/w7/ci-fix-logs/full-5922e54b/`
- unit:2319 总数,2308 pass、10 skip、1 fail。唯一失败为 `FieldOwnershipTest.VerbBoundaryOpsCoverEveryVerbShapedCall`,已在 `c7de0dff` 修复并单项复测 PASS。
- GPU inproc:1443 总数,1198 pass、221 skip、24 fail。
- 24 个失败都曾用独立日志重新复现:`full-5922-failure-probes/summary.json`,有 command、原输出、XML、首 Fatal。
- 后续 **`ed01f4e3` 的这 24 个精确失败全部复测 PASS,0 skip**:`failure-recheck-ed01/summary.json`。
- **没有在最终 `70c8230b` 上重跑完整 unit、完整 GPU、完整 monolith GPU。** 不能把“24/24 修复”写成“最后完整门全绿”。221 个 skip 也尚未做最终逐项分类审计。
其它已执行证据:
- E1 三个协议用例 baseline 绿 → 关必要 barrier 仅两个指定断言红 → restored 绿;smoke/redcheck 通过。见 `e1-control-current2/`、`e1-control-driver2.log`、`control-smoke-current.log`、`redcheck-control-current.log`。尚需最终头完整 split 负控(包括 E3)与其它出口门。
- `4610b573` 的 Magma query 13 项:13 PASS / 0 SKIP / 0 FAIL,真正 inproc/REQUIRE_GPU=1,零 Fatal:`magma-init-4610-query13/summary.json`。此前 6 个 skip 的直接原因是旧 query 返回 0,并非仅 COUNTER_BITS 广告问题。
- `40c5443f` 的 4 项 GLES XFB / TextureParams:4 PASS,相关 tracker 回归 PASS:`gles-final4-40c5/summary.json`。
- depth/stencil aspect 修复:`depth-aspect-buffer.{log,stdout,xml}`,增强 case PASS,Vulkan/sync validation 无 VUID/SYNC 错误。
### 4.2 最新新增窗口回归仍有一个失败
在 **`70c8230b`**:
- `F1WireScenario.GenerateMipmapHonorsMutableBaseAndMaxWithoutChangingOtherLevels`:两后端 PASS。证据 `mip-window-70c/summary.json`。
- `F1WireScenario.GenerateMipmapThroughViewKeepsOwnerLevelsAndLayersOutsideItsWindow`:Magma PASS,**GLES FAIL**。证据 `mip-view-window-70c/summary.json`。
- 断言:`F1WireScenario.cpp:596`,`owner mip 3, layer 0` 有 4/4 texel 不对。该 view 应只改变 root mip 3 / layer 1;窗口外 layer 0 被改变。
- 已分给 fr,但该 agent 随后退出,**没有这项修复的未提交半成品或完成报告**。仍需定位 GLES view mip 生成 / owner stage replay,不能减断言。
### 4.3 完整 Linux inproc retrace 已结束:67/77,10 失败
**这是停止整理时读取的最终结果,不是最初工具尚在运行时的 15/77 进度。**
证据:`/home/swung/w7/ci-fix-logs/retrace-inproc-70c8230b-hydrated/`
- `results.xml`、`ctest.log`、`matrix.json`、`cases.txt`
- **77 总数,67 PASS、10 FAIL、0 SKIP**,原阈值未修改。
- 单 case `result.json`、`mobilegl.log`、`retrace.log`、actual/diff 在:
`/home/swung/w7/p5f-int/build-trace-ci/tools/trace_replay/<case>/<backend>/output/`
- 首次 `retrace-inproc-ed01f4e3/` 是 LFS pointer 解包失败,不能当 renderer 结果。之后校验补齐 92 个实体文件才跑上面这轮。
10 个失败:
| case | backend |
|---|---|
| `minecraft-1.21.4-fabric-iris-sundial-lite-in-world` | DirectVulkan |
| `minecraft-1.21.4-fabric-iris-iterationt-in-world` | DirectGLES、DirectVulkan |
| `minecraft-1.21.4-fabric-iris-iterationt-nodsa-in-world` | DirectGLES、DirectVulkan |
| `improved-transparency-minecraft-26.3` | DirectGLES、DirectVulkan |
| `minecraft-1.21.4-fabric-iris-iterationrp-in-world` | DirectVulkan |
| `minecraft-1.21.4-fabric-iris-bsl-esc-menu-854` | DirectGLES、DirectVulkan |
停止时只读取了已有输出,未继续诊断或修复:
- Sundial Vulkan:`ssim=0.000046370`,阈值 `0.99`,mismatchPixels `408472`,真实图像不匹配。
- 其余日志中有 7 次 `Fatal{RingOverrun, "SEG_STAGE"}`:单 blob `34,603,008` / `56,623,104` / `134,217,728` 字节超过 `33,554,432` 字节 stage。
- 另有 2 次 `Fatal{InitialBytesNotCarried, "resource_respecify"}`,描述 initial content 的后续 subdata 没有发出。
- 尚未逐 case 完成这 9 个 Fatal 的对应/根因分析。不能把放大 stage、放宽阈值或跳过 case 直接当迁移完成。
- 完整 monolith retrace 本轮未跑;新头 Android retrace / AVD lifecycle 实跑也未完成。
### 4.4 Android 构建与旧远端失败
Windows 已成功编译 trace/plugin Release APK,各含 arm64-v8a + x86_64,D/P/INPROC=ON:
- `android-plugin/app/build/outputs/apk/trace/release/MobileGL-plugin-trace-release-5922e54.apk`
- `android-plugin/app/build/outputs/apk/plugin/release/MobileGL-plugin-release-5922e54.apk`
- 日志:Windows evidence 目录的 `android-gradle-full-ready.log`,`BUILD SUCCESSFUL in 8m 8s`。
- APK/native SHA 和二进制 marker:`android-local-built-identity.json`。这是较早 5922 标记产物,**不是最终头产物,也没有声称已在设备/AVD 跑过本轮 APK**。
- 主库及 trace 编译依赖已初始化(排除了 DiligentCore);glslang 的 `update_glslang_sources.py` 已成功执行。
- Windows Java selector loopback 需要当前命令的 `JAVA_TOOL_OPTIONS=-Djdk.net.unixdomain.tmpdir=C:/T`;Gradle `-Pmobilegl.xxx=...` 参数在 PowerShell 要整段加引号。
旧远端 `30b1bf25` 两轮均已完成且红:
- Test run `35513925180`:`integration-split-strict` job `106089389584`,`integration-split` job `106089389592`。
- APK run `35513925171`:Vulkan create-indirect retrace job `106089768679`。
- Windows `android-latest-vulkan/` 的 logcat 确认 Activity relaunch 后两个回放 TID(2276 / 2289)重叠;与先前 Bliss 的重复 JNI 生命周期根因一致。`7fd83133` 是代码修复,仍需新头远端验证。
- **本轮新修复从未 push,远端还没有这些提交的 CI 结果。**
## 5. 后续明确的未完成事项
仅在用户重新授权继续后执行:
1. 先审查并收尾两份未提交的 artifact-cleanup workflow diff。
2. 修最新 GLES view mip-window 回归。
3. 修上述 10 个完整 retrace 失败:大 stage blob、initial bytes 携带、Sundial 实际像素错误;保持完整矩阵与阈值。
4. 最终头重跑完整 unit、完整 inproc GPU、明确 monolith 对照;审查剩余 skip 的真实原因。
5. 跑完整 split strict / dual-block / clientarray / E1/E3 / run-ahead / generated/include/模式证明等适用门。部分已有老头证据,不等于最终头全绿。
6. 重建最后提交的两 ABI Android APK;验证真实 AVD overlay/recreate 生命周期和完整两 transport retrace。
7. push 修复分支,实际观察 GitHub workflows 结束并修远端差异;再协调交付树 Gradle 现有修改,合入/push `feat/disaggregated`,确认远端 SHA。
8. 写最终报告。不要把当前 handoff 或历史 P5f close-report 当成本轮完工证明。
## 6. 恢复所需命令与工具说明(未在停止后执行)
WSL `build-split` 已配置 D/P/INPROC。`build-trace-ci` 是独立 replay runner,使用:
```text
MOBILEGL_TRACE_REPLAY_MOBILEGL_LIBRARY=/home/swung/w7/p5f-int/build-split/libMobileGL.so
```
retrace 用的是共享库,**只 build `MobileGLIntegrationTest` 不会更新它**;修改后需构建 `MobileGL`。CTest integration 多数链接静态库。
Windows evidence 目录已有复现助手,都是本任务临时脚本,不是产品代码:
- `run-feature-probes.py`:从 CTest discovery 保留 recipe,强制真实 inproc/strict/role/REQUIRE_GPU,逐 case 私有 log/stdout/XML;可 `--regex` 或 `--failed-junit`。
- `run-ci-retrace.py`:按原 `github-test-matrix` 精确选 77 项,`ctest --tests-from-file`,mode 参数为 inproc/monolith;输出按 HEAD 命名。
- `run-current-full.sh`:完整 unit 后完整 inproc GPU,两个退出码均报告。
- `summarize-results.py`:只读 JUnit 汇总。
- `hydrate-trace-fixtures.py`:校验 LFS pointer SHA 后从现有实体缓存复制,初次已成功,无需盲目重复。
当前 replay 已结束,无需恢复旧 session。未来两 transport 运行会共用 build-trace-ci 的 case 输出目录,**不要同时跑它们覆盖同名图片/日志**,下一轮前先归档已有失败证据。
多 agent 曾共享同一文件并发生提交夹带:`c3a5d2f5` 带入 query agent nativeDelete hunk,`e2d6e33d` 又带入 root LevelWidth adoption,直到 `40c5443f` 才是完整可编译组合。现在提交链配套已齐全。以后每次提交逐 hunk 检查归属;不要让另一 agent 的未完成 hunk 混入独立提交。
子 agent 在 completed/errored 后,`send_message` 不会启动新工作;恢复需 `followup_task`。本次所有 agent 已停止,不存在后台继续修复的约定。
## 7. 历史设备成果,仅作背景
本轮之前已交付 Magma inproc / run-ahead / RD32 性能修复;`70fb6689` 下 RD32 Magma inproc **116.73 FPS**,同包 monolith **115.01 FPS**。Redmi `2f7cbe2e`,FCL 包尾 `.mgdebug.debug`,MC `26.3-rc-3`。历史已安装库 SHA256:`11f26ca1f1d6c9a3d89134c31b2348306e669b1d9ebcc2fc77c7f5def2b4f818`。
这些是历史头证据,**不代表 `70c8230b` 或后续代码已完成 Redmi E2E/性能验收**。原世界/options 已在先前工作恢复并核验,勿无故再改。