Files
MobileGL/docs/Disaggregated/notes/p13/HANDOFF-2026-10-06.md
T

54 lines
8.2 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.
# P13 交接(2026-10-06)
> 计划 [`PLAN-P13.md`](PLAN-P13.md),裁定 [`INTEGRATOR-DECISIONS-P13.md`](INTEGRATOR-DECISIONS-P13.md),进度表 [`README.md`](README.md),CI 清理记录 [`docs/ci/ci-cleanup-log.md`](../../../ci/ci-cleanup-log.md)。
## 1. 状态
| 波 | 状态 | 提交(`p13` 分支) | CI |
|---|---|---|---|
| CI 基线修复 | 已推 | `cde6512b` IN_LIST / TCP 端口;`0cbb1a84` spawn Welcome 冷启动预算;`c9085533` apitrace 子模块(分支 `mobilegl/android-trace-replay` 的 `45843686`:着色器 / 程序名按类型映射,修 1.17) | 基线 Test `37414803850`、APK `37405703442`,逐条归类见 ci-cleanup-log |
| W1 | 已推 `5ff33cbb` | runtime_mode_proof monolith = 无 MG_Remote;push 无 MG_Remote 控制库 + 零 MG_Remote 检查;retrace-split 不再因控制库失败整体跳过;skip 普查 | Test `37425662897`:除 verify-split 的 FencePoll 测试竞态(已修 `0a47038a`)与普查无基线外全绿 |
| W2 + W3a | 已推 `55de98a0` | 普查基线 `c6cb5dea`;`68b56165` `9f05e665` `3e11c848` W2;`55de98a0` W3a | Test `37433779649` / APK `37433779654`(交接时排队中,被旧 run 卡住,已 force-cancel 旧 run) |
| W3b | 本地 | `9e14c16d`…`a4d10dd9`、`daf2b44c`、`4d2a2443`、`1d380a6e`、`3e36bd6c`、`938f4b11`、`883b8614` | 本地:unit 2908 绿;integration-gpu monolith 3640/3640;inproc 与 split/spawn/tcp 在跑 |
| W3c | 本地 | `e2c90986` | 本地 unit 绿 |
| W4a(一项) | 本地 | `3e2aff1d` 14a:indirect 无 client 数组不再回读命令缓冲;新 `ResourceReadbacks` 计数与场景用例 | 未编译验证 |
推送规则:W3b/W3c 等 W2/W3a 的 run 绿或红已归类后再推;推前 `git fetch` 看 feat 有无他人提交。
## 2. 关键事实(实现中发现,计划里没有或有误)
- **bit 4 不能退役**:它同时门控 P5c rv 的 `set_context_values`。W3c 只删 ResidualValueBlock,bit 4 仍固定开。
- **不需要控制面修订号 +1**:删结构后 `kMGPipeWireCatalogueDigest` 变化,wireFingerprint 随之变化,新旧端按名拒绝。
- **CMake 旧缓存**:`MOBILEGL_PIPE_PUSH=OFF` / `MOBILEGL_PIPE_LEGACY_MEMOS=ON` 在旧构建树(含 FCL 的 Gradle `.cxx`)里是默认值,所以是 WARNING + 忽略,不是 FATAL。
- **位图固定开(ID-P13-3)在 W3b 落地**:`ConfigLoader` 对清 bit 0-13 的掩码 `Fatal{PipeSubsystemsFixedOn}` + abort;Off / Refused 车道改为 `DirectGLES.SubsystemMaskRefusal.<Lane>` 具名拒绝对照(`Harness/RefusedMaskControl.cmake`,读日志确认原因)。各解析函数里 `legacyMemosEnabled` 改为常量 `true`,只为单元测试的掩码扫描不 abort;这些分支 W6 删。
- **monolith 仍走借用槽位的单元列表**(`UnitTexturesByHandle()` 在 monolith 为 false)——这是 W4c 要换的。`UnitMemoRefusesToDriveATwinFromAnotherTexture` 恢复并钉 P2 掩码(单元车道没有 P4a consumer,0x3fff 下建不出记录);红检已做(见 ci-cleanup-log)。
- **单元车道无法创建纹理记录**(`NoP4aConsumer`),任何需要纹理记录的白盒单元用例都要放到集成层。
- **本地 CMake 必须 3.31.10**:CMake 4.x 下 gtest 的 ENVIRONMENT 列表转义不同,集成用例把 `MOBILEGL_BACKEND_TYPE=DirectGLES;__EGL_VENDOR...` 当成一个变量,全部假红。
## 3. 本地环境(WSL archlinux)
- `~/mgl-p13-src`:从主仓库克隆的 LF 工作副本(`origin` = Windows 主仓库,分支 `p13`),子模块从主仓库本地拉。`~/mgl-p13-tools/sync.sh` 同步到 `p13` 已提交状态并从主仓库工作区按 sha256 物化 LFS fixture(有 29 个缺)。apitrace 子模块的第三方子模块已 `--depth 1` 拉过;glslang External 用 `update_glslang_sources.py` 拉过。
- 构建:`~/mgl-p13-tools/build_split.sh`(`~/mgl-p13-split` + `~/mgl-p13-retrace`),`build_push.sh`(`~/mgl-p13-push`,FCL 形态),`itest.sh <build> <tag>`(CI 同款 integration-gpu)。PATH 前置 `~/mgl-p13-tools/venv/bin`(CMake 3.31.10)。
- 经验:WSL 命令一律写成脚本文件再 `MSYS_NO_PATHCONV=1 wsl -d archlinux -- bash <file>`,`bash -lc '...'` 的引号与 `$` 会被吃;Git Bash 的 heredoc 会吃掉反斜杠,Python 编辑脚本用 Write 工具写文件再运行。
- 工具:scratchpad 下 `pyunifdef.py`(W3b 用的部分求值器)、`retire_names.py`(从普查基线退役具名用例)。
- `~/mgl-p13-apitrace`:apitrace CLI(`apitrace dump`)。
## 3b. W4 设计要点(W4a 落地时的实际做法)
- **谓词**:`MG_Config::DataArmIsRecord()` / `RecordArmAliasesFrontend()`(`Config.h`)。monolith 的 `MonolithTakesRecordArm` 由 `MOBILEGL_PIPE_DATA_ARM`(默认 `record`,W4-W6 专用)且后端为 DirectGLES 时才为真;Magma 在其一次性换臂时加入。无 MG_Remote 构建恒 false(W5 改)。
- **三类分支**:K(生命周期、角色、caps 来源、传输层级)留 `Transport`;F(数据臂)改谓词;S(store 是否复制)问 `CopiesIntoServerStorage()`——`M:3910` 那处若误用谓词会把所有别名基址清空。
- **verb 端口**(`EmitTables.cpp`「THE MONOLITH VERB PORT」):monolith 下被端口接管的槽位跑 EmitTables 的同一套规划与 pre-verb 钩子,再把记录交给进程内 `ServerVerbSink`(它写 `VerbIndirectBuffer` 等并调真表)。由 `MobileGL/Init.cpp`(SHARED)安装,不由 `MG_Backend/Init.cpp` 装——后者是 server 对象,装会让链接棘轮报新前端引用。W4a 端口槽位:20 个 draw + 2 个 dispatch。后续波把新 verb 同时加进 `InstallMonolithVerbPort` 与 `ApplyOnMonolithPort` 的 switch。
- **§1.4 别名刷新**:`RefreshAliasedStoreFromGpu`(`Managers.cpp`):读回 GL buffer → `OnBufferWriteback`(前端把字节拷进它的影子,即别名基址)→ 清 `serverGpuWritten`、盖 serial、bump epoch。前提:monolith 记录臂在 sub-data 与 respecify 时就铸 twin;孤立 respecify 也带影子基址(上传仍按描述符的 `HasDefinedContent` 门控);`contentSinceRespecify` 代替别名 store 没有的覆盖集回答流式写法。
- **GPU 写标记**:`GpuWriteSetIsClientSide()` 改谓词,client 侧的保守集由端口的 `MarkGpuWritesForDraw` 打;后端只标自己的 twin(`serverGpuWritten`)。image 单元仍在前端臂(W4c),其 buffer-texture 写在前端臂里额外标 twin。
- **单元测试**:`BufferTest` 三例断言前端臂的 map 推送,钉 `ScopedMonolithFrontendArm`,W6 随前端臂删。
- **W6 待办(monolith 登记的余项)**:`F1WireScenario` 在 `SetUp` 用 `SplitRuntimeSkipReason()` 整组跳过 monolith,所以 Magma 的 `MGITEST_MAGMA_FORCE_SHADER_MIPMAP` 车道(`ShaderMip1/2.`、`DepthMip.`)还没有 monolith 登记;它的断言读 `emitSeq`(编码器序号),monolith 记录臂走路由表不经编码器。W6 删前端臂时把 F1 的门改成「记录臂」并换掉 `emitSeq` 证据,再补 monolith 登记、退役对应的 census 跳过。
- **Magma 换臂**(同一会话稍后):一次性;`MonolithTakesRecordArm` 对两后端都为真。坑:服务端产生的字节(回读落入 pack buffer 的 `LandReadbackInBuffer`、纹理重铸 / 再生成的 `Adopt`)绝不能被别名 store 当基址——缓冲侧用 `MGPipeServerOriginatedWriteScope` 走「直接上传 GL + 标 GPU 写」,纹理侧 `Adopt*` 默认复制、只有客户端记录的 run 传 `frontendShadow=true`(曾造成 use-after-free:重铸后首 16 字节是 malloc 元数据)。
- **本机 retrace**:`~/mgl-p13-tools/sync.sh` 才物化 LFS fixture(`sb.sh` 用的 `sync2.sh` 会把它们复原为指针);跑前设 `MOBILEGL_GPU_HANG_BUDGET_MS=0`。
- 完整的 site 分类表与后续步骤(W4b 纹理别名 store、W4c、Magma)见 Plan 代理的设计(会话 scratchpad `W4-design.md`;要点已并入本节)。
## 4. 下一步
1. W2/W3a 的 CI:看完归类;然后推 W3b/W3c(普查基线已同提交退役名字)。
2. W4a 起:按计划 §1.2 的 F 类分支换臂。建议先引入一个 `MG_Backend::DataArmIsRecord()`(DISAGG 构建恒 true),逐子系统替换 `Transport != Monolith`,每个子系统跑一次 monolith 全量 integration-gpu(两后端)+ split 车道;§1.4 的别名 store 刷新先做(缺陷 a/b/c 依赖它)。
3. 14a 已在本地(`3e2aff1d`),先编译验证。