Files
MobileGL/docs/Disaggregated/notes/p7/INTEGRATOR-DECISIONS-P7.md
T

27 lines
9.7 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.
# P7 集成者裁定日志
> 形式沿用 P5e 的 `INTEGRATOR-DECISIONS-P5E.md`:一条裁定一个 ID,只记「定了什么、为什么、影响哪些文件」,不记来回。计划正文见 [`PLAN-PH-P34B-P7.md`](PLAN-PH-P34B-P7.md)。
| ID | 日期 | 裁定 | 理由 | 影响 |
|---|---|---|---|---|
| ID-P7-1 | 2026-09-22 | PH-1「`Session::Fail` 翻成每会话闩」按四片重定界:(1) supervisor 读 `waitpid` status 并命名子进程死亡;(2) 两处头层裸 `abort`(`Server/StagedShadow.h:115`、`Server/StagedTextureStore.h:344`)改走漏斗;(3) 只对对端字节可达站点做 latch-and-decline;(4) 负控。**98 处 `SessionFail` 的字面翻转拒做**。 | ≥9 处返回引用的站点没有诚实返回值;§12.3 进程级 `eglTerminate` 使闩住的进程也服务不了第二会话;P6.5 fork-per-session 已给出「下一连接照常服务」。 | `ServerMain.cpp`、`Server/Staged*.h`、`PipeWireCodec.cpp`、`PipeApplier.cpp`、`ServerLoop.cpp`、`SurfaceOpCodec.cpp` |
| ID-P7-2 | 2026-09-22 | PH-6 取 drop-with-latch:`ReserveEventOrBlock` 两处 BUSY 拒绝改置 forfeit 闩 + `CountDrop()` + 返回 scratch,`ServerLoop` park 谓词见闩走正常 Stop;`kEventBacklogWaitMs` 改 `MOBILEGL_IPC_EVENT_WAIT_MS`(默认 2000)。**不等 PH-1**。 | 一个函数、一个标志、一个配置字段即闭;30 s 的「测量」从来不是测量;解耦掉 6–10 天的闩迁移。 | `ServerSession.cpp:215-263`、`ServerLoop.cpp:403-406`、`ConfigLoader` |
| ID-P7-3 | 2026-09-22 | OQ-21:**令牌足够,不做 TLS**。令牌常量时间比较、≥16 字节、无令牌只 loopback;数据面以 `Welcome.dataNonce`(CSPRNG 128 位)绑定到已认证的控制连接,认证在 fork 之前完成。TLS 作为 P12 的开放项保留。 | Ph 门的威胁模型是「任何人都能连的远程代码路径」,不是窃听:局域网 GL 命令流不含凭据。令牌 + 连接绑定关掉前者;TLS 是另一个多天项且应有自己的路线图行。 | `protocol.fbs`(`Welcome` 追加字段 → `wireFingerprint` 随之变)、`SocketTransport.cpp`、`Handshake.h`、`ServerMain.cpp` |
| ID-P7-4 | 2026-09-22 | 出口门 3(真机 ssim 1.0)的分母排除 `minecraft-1.21.4-rd12-odinlite-in-world` 与 `create-indirect`;`iterationrp` 按 `apk.yml:460-462` 带三个 Magma 旋钮。 | OQ-17:两者在 `dev@81b17c0b` 就在 Adreno 830 上坏,非本分支造成。 | `CONTRACT-P7.md`、设备矩阵跑器 |
| ID-P7-5 | 2026-09-22 | `SetupDrawSnapshot` 探测字段塌 dirty mask、`VertexInputStateFactory` 内容寻址 CSO **本阶段拒做**,记入优化阶段。 | `VulkanRenderer::SetupDraw` 在非 monolith 传输下分支到 `SetupWireDraw`(`:6946`),monolith 快照机制在 split 下不跑;无性能门;改 monolith 表动 pull `.text`。 | 无 |
| ID-P7-6 | 2026-09-22 | D18 取 21-memo 普查的读法(节点稳定容器纪律;负控 C 必须仍能到达已发货臂)。 | 两名反驳者对指涉不一致,必须由集成者定一个。 | `CONTRACT-P7.md` 一句 |
| ID-P7-7 | 2026-09-22 | 184 符号棘轮归 P7 wave 0;baseline 存符号列表而非计数;`--assert-monotone` 只对新增符号红,消失只提示重基线。 | 裸计数的棘轮在「清一个加一个」时通过;P6.5 行从未接收该移交。 | `scripts/link_ratchet.py`、`scripts/data/link_ratchet_baseline.txt`、`test.yml` |
| ID-P7-8 | 2026-09-22 | 实现方 `opus`、审查方 `fable`;每包合并前聚焦审查一次,阶段收官整体审查一次。 | ID-66「实现方与审查方错开」;本环境无 Codex。 | 过程 |
| ID-P7-9 | 2026-09-22 | 性能只记录不设门(沿用 2026-09-08);wave 2-B 若实测 CSO 缓存为热点才做 P7-5 的 server 半边。 | 路线图纪律。 | 过程 |
| ID-P7-10 | 2026-09-22 | wave 0 之前不派任何 `@P7` 拒绝退役的活。 | 今天没有一条车道能让 Magma 两进程用例变红,每个修复都需要 red-once。 | 过程 |
| ID-P7-11 | 2026-09-22 | pull 构建(`MOBILEGL_PIPE_PUSH=OFF`)必须**连测试一起**编过:`MG_Test/Util/PipeStatsTest.cpp:137` 用了 push-only 的 `PipeStats::Gauge`,已加 `#if MOBILEGL_PIPE_PUSH` 并保留用例名以维持名集合奇偶。CI 的 pull control 作业关了 `MOBILEGL_BUILD_TEST` 所以看不见——这是 CI 的一处盲区,随 wave 0 的 CI 改动补一条「pull 构建含测试」的编译步骤。 | 「默认 ALL target 必须完整构建」。 | `PipeStatsTest.cpp`、`test.yml` |
| ID-P7-12 | 2026-09-22 | 出口门 3 **逐 case 对 monolith 臂**判(同会话;三遍逐位相同;≥ 阈值;与 monolith 读数之差 ≤ 0.0005;OpenRA 两臂 1.000000),不是对 golden 的平 1.0;分母 = 39 − 3 = **36**,排除 monolith 自己就红的 create-indirect(OQ-17)、1.21.11-main-menu(trace UBO 对齐伪差)、iris-photon。 | E0a 实测 monolith × DV 对 golden 在 0.996–1.000,只有 OpenRA 是 1.0;「pbuffer monolith 1.0」是 OpenRA 的事实不是规则。 | `CONTRACT-P7.md` §7.1/7.2、`device-window-1/E0-attribution/exclusions.md` |
| ID-P7-13 | 2026-09-22 | iris-photon 归 `dev` 侧独立条目(Adreno 830 的 `vkCreateGraphicsPipelines` 对 photon 程序返回 `VK_ERROR_UNKNOWN`,`PipelineFactory.cpp:660`,monolith SSIM 0.0089,lavapipe 绿);不进 P7 出口门。 | OQ-17 先例:monolith 级的 Magma × Adreno 失败不是分离缺陷;拆分不借机顺手修。 | `exclusions.md` |
| ID-P7-14 | 2026-09-22 | wave 0 三个包的命名/分桶裁定一并批准:C——`ResourceUnavailable`→`ServerCrashed`(不是 `SegmentMismatch`)、Magma 漏斗家族词保持 `UnmigratedVerb`、`Refuse{ProtocolMismatch}` / `Refuse{InitialCapsSnapshot}` 进 `LOCAL_REFUSAL_WORDS` 允许表;R——`FatalFunnel.cpp.o` 归 SHARED、`MG_Backend/Init.cpp.o` 按 a6 归 SERVER、Espryt 桶地板 5(`MG_Pipe::` 槽分配器符号,`# P13`)、P3b/P4b 可清数 9;L——`MagmaRunAheadScenario` / `MagmaWireCacheScenario` 只注册 inproc 臂(`MAGMA_INPROC_ONLY`),跨进程 hold / peek 记债;六处 `MGL_ITEST_MAGMA_*_ENVIRONMENT` 改用 `VULKAN_ENV`。 | 各包报告里的理由成立;改名会作废历史普查计数;一致性胜过「含义不变」。 | `scripts/ci/fatal_census.py`、`link_ratchet.py`、`spawn_lane_parity.py`、CMake |
| ID-P7-15 | 2026-09-22 | 新增 wave 2 包 **X1**(inproc 下 GL 线程 memcpy 写进不可写映射的 SIGSEGV)进 P7 出口门 3 关键路径;其两条残余(屏蔽 SIGSEGV 的非 GL 线程写者、`RefaultOfANonWriteAccess`)与「P5d 的 Adreno mprotect 臂数字存疑」记 `CONTRACT-P7.md` §12,不阻塞 P7。 | 26.3 在门 3 分母里;机制是 bionic 指针标记 0xb4 与内核 `si_addr` 比较,与后端、run-ahead、persistent push 无关(E1/E4a/E4b)。 | `PersistentMapTracker.cpp`、`notes/p7/x1-persistent-map-segv.md` |
| ID-P7-16 | 2026-09-22 | 出口门 5 = **五个可测块**(texture 1055 / shader-image 125 / packed-pixels 4732 / dsa 371 / ssbo 124),UBO 块(GTF 模块)在本 CTS 提交 `0b04c470e` 无 kc-cts 不可运行,记 unrun;API 版本 **KHR-GL46**(设备探针列出 697 例,`mgprobe` PASS 含 default_fb=ok);`$BASE` 用 pre-wave-2 库 `p7w1-d260f110`,AFTER 同版本同 caselist。 | 设备探针结果;caselists README 已预告 GTF 缺席。 | `tools/cts/caselists/`、`notes/p7/device-window-1/CTS-base/` |
| ID-P7-17 | 2026-09-22 | E2(present credit 扫描)与 E0b 的 ARMED 三遍确定性**不单独跑**:E1 已证明 run-ahead 整条线出局(OpenRA lockstep 仍 0.989、崩溃 case 照崩),确定性在 F1 修复后的复测里按 §7.2 一起做。 | runbook §5 的判别规则;设备时间省给 wave 2 复测与 CTS。 | `E1-lockstep/README.md` |
| ID-P7-18 | 2026-09-22 | F1 落地(`5d698cb9`):split 起会提到 `MG_State::Init()` 之前(`InitSplitRolesBeforeState()`),`CapsMirror::ServerConsumes` 不再从 placeholder 作答(他线程 bring-up 在飞时等 250 ms,否则 `Fatal{CapsBeforeFirstSnapshot}`);**批准** `MG_Config::SplitTransportRequestedByConfig` 作为该门的武装闩——任何绕过 `MG_ConfigLoader::Init()` 手设 `Transport` 再造前端对象的生产路径都会退回 placeholder 作答,今天只有 `ServerLoopTest` 这么做且写了理由。 | 发射者是确定性的(11 个默认纹理在起会前 `resource_create`),主机也发生;不做「把警告调轻 / callMask 全 1」。 | `MobileGL/Init.cpp`、`MG_Backend/Init.cpp`、`CapsMirror.{h,cpp}`、`ClientSession.cpp` |
| ID-P7-20 | 2026-09-22 | wave 2-C 落地(`04292f06..205793ca`)并批准其五条:§5.4 白盒(opcode 49 上 wire)在 P11 采纳档落地前不可达,以「server 按表发布 + 镜像收到」为验收;`g_programResourceCaches` 的 monolith 删除归 P13(G1);`buffer-window` 家族词暂留 `UnmigratedVerb`(改 `ProtocolCorruption` 记 §12);`vertex-layout` 屏蔽原因是七种不是六种;死亡缺口是 server twin 泄漏而非 client slot 泄漏(framebuffer 用例两边计数)。`p7_worktree.sh` 补 `MOBILEGL_ITEST_VK_ICD` 钉。 | 各条理由见 `notes/p7/magma-c.md`。 | `CONTRACT-P7.md` §3.2/§12、`p7_worktree.sh` |
| ID-P7-19 | 2026-09-22 | OpenRA 真机分歧改判为 **wire 臂的 GPU 时序竞态**(冷驱动缓存 = 慢 pipeline 创建 → 最终帧回读在最后几批 draw 完成前采样),归 wave 2-B 第 0 片;主机 red-once 用 pipeline 创建延迟旋钮复现;真机验收 = 三次 `pm clear` 冷跑 1.0。F1 保留(机制正确)但不再被当作分歧原因。 | E7:`pm clear` 三遍 0.976493989 / 14658 逐字相同、热跑 1.0、冷 monolith 1.0、`FRAMESINFLIGHT=1` 一绿一红;两臂 client/server 日志逐行相同;diff 只缺最后画的对象。 | `WireFramebuffer.inc`、`VulkanRenderer.cpp`、`F1-verify/README.md` |