Files
MobileGL/docs/Disaggregated/ROADMAP.md
T

34 KiB
Raw Blame History

MGPipe 路线图

状态:P0、P0.5、P1、P2、P3a、P4a、P5、P5b 已收官2026-09-16,代码头 82683d4a)。当前头、逐门数字、开放项与下一步见 CURRENT_STAGE_PROGRESS.md;设计见 ARCHITECTURE.md;逐阶段实测见 MEASUREMENTS.md下一个是 P5cinproc 的共享内存读点归零,2026-09-17 已审计、已计划、未开始,见下文"P5c 计划"),然后才是 P6 spawn transport

通用纪律(每个 commit

  • 默认 ALL target 必须完整构建;禁止提交热路径插桩(CI grep 门)。
  • 每个门必须能因它存在的理由变红:每个门带阴性对照并真跑过一次红(R-16);公共 GL 看不见的改白盒断言。
  • 正确性门是硬门;性能对着 pull 臂只记录、不作阻塞门(用户 2026-09-08push 比 pull 多约 10% 逐线程 CPU 已被接受;专门的优化阶段排在路线图推完之后)。唯一不可谈判的是数字必须真的采到。
  • 每阶段出口跑一次五部分门(ARCHITECTURE.md §13.2);性能判据是逐线程 CPU 时间;设备对比走 reboot-clean + 同热窗口配对 A/B,只用 Redmi 2f7cbe2edevices/pin-verification-2026-09-07.md);Windows 机器不是正确性门。
  • G1pull 构建的符号集与 .text 字节对基线恒等(每阶段 0/0/0/0);G2pull 与 push 的 ctest 名集合相同;G14:测试名只增不删;G5:保护区字节一致。
  • 拆分不借机顺手修 dev 的 bug:句柄化过程中发现的 dev 侧缺陷记成独立条目、独立 PR(开放问题 15、17)。
  • 过程(用户 2026-09-16,ID-66):不过度验证;轮次间不做对抗性审查,每个 P 阶段收官由 Codex 审一次,发现进入下一阶段首轮;只读 / 非核心任务派给 Codex;实现方与审查方错开模型族。

两条跑道分开:monolith 跑道 P0 → P0.5 → P1 → P2 → P3a → P4a → P3b/P4b → P7 → P8 → P13,每段可独立交付、可随时中止;IPC 跑道 P5 → P5b → P5c → P6 → P9 → P10 → P11 → P12。目标顺序:先完整的 separate-thread renderingP5b,已达成),再让 inproc 变成只经 wire 交换的诚实两角色(P5c),最后才是 separate-process transportP6,此时只是传输替换)。

阶段

阶段 状态 落地什么 验收门 / 证据
P0 卫生、度量、门、骨架 边界计数器;PipeCalls.def 完整目录 + payload POD + 生成器 G1G7 + CI pipe-gatesgen_pipe_dirty_surface.pycheck_doc_citations.pyMOBILEGL_PIPE_* 开关;MG_Remote/{Protocol,Transport} 骨架 + protocol.fbs + flatc-check + MG_Test/Wire;三个严格 no-op 收益;spike A / Bretrace --env 透传 单元 / 集成 / trace 逐名不变;wire 层测试绿;两台设备字节 / 调用基线在案;spike 结论。MEASUREMENTS.md §1
P0.5 值头与制品头抽取 5d99ee43 MG_Pipe/MGPipeValueTypes.hProgramArtifacts.hVisit() 归档 + sizeof 绊线;CI -H include 闭包断言(scripts/check_include_closure.py+ scripts/symbol_report.py 测试名零删除、.text 不变、符号 0 增 / 0 删 / 42 重命名
P1 PipeInputs 替换与 verify harness MG_Backend/MGPipe/PipeInputs.h(63 字段);277 处箭头 + 58 行非箭头逐条转换;逐 verb 类填充点;逐 verb 世代 poisonG4 影子比对器 + verify CI 模式;push-on-mutation 三字段 pull nm 不变;单元 1485×3integration-gpu 878integration-verify 818 零 Fatal79 retrace verify 79/79 armed 零分歧。§2
P2 渲染状态 CSO + 第一片 Track H + 残余值块 738b289d Trackerdirty 位、5 个聚合世代、抑制器);dirty-surface 成门;MGPipeRenderStateSpans chunk 表 + G7CsoCache64);create/bind_render_state + set_dynamic_stateSyncRenderState 一行不动);pixel pack / patch / attrib defaultsResidualValueBlock 棘轮 1248 → 8Espryt slot 表 + Magma vertex input 重键(11 条 memo 删除 + 2 条重键);MOBILEGL_PIPE_LEGACY_MEMOS;三个 capability 真存储 G1 4 处认定 resize、.text +160 BG2 名差 0;单元 1566×3integration-gpu 916 三臂;retrace 79/79 push + verify;对照 44/44。GO/NO-GO2026-09-08):继续。§3
P3a handle wave 1Espryt):buffer、VAO fde5fda3 九条 resource_* + 五条 vertex-input 调用接线到句柄形 MGPipeResourceOps;第七张 Espryt slot 表;ResourceRespecifykNeedsAck 谓词;VAO twin 六条身份 memo 在句柄臂退役、四条重键;mpr 定义;位 7/8push 默认 0x1ff 五部分门全绿:G1 0/0/0/0 .text +0G5 十一函数;单元 1619×3integration-gpu 958 五臂;verify 842retrace 79/79 ×2。实际 1 天。§4
P4a handle wave 2Espryt):FBO / 纹理 / sampler / program 8c458cd5 十四条族调用接线(framebuffer state、sampler state / view、texture params、shader images、shader state、draw / dispatch program、global constants);纹理 / renderbuffer 复用 resource_*(目录不加行);六种 kind 按 {slot, gen} 重键;CompositeResolverNamed = 3 framebuffer 记录;消费者门 + 客户端依赖表;位 9–12,push 默认 0x1fffemulation 在 split 下具名 Fatal 全门:G1 0/0/0/0G5 17 区;G2 2902;单元 1785×3integration-gpu 1117 七臂;verify 920retrace 79/79;八族拒绝普查 0PipeApplyPeek 白盒对照。实际 1 天。§5
P5 传输 + inproc applier + 发射表 ff2994d9..37fc4fdb 同一 codec 上的 InProcessTransport;四种 build flavour;发射表三类 / caps mirror / reply mailboxapply-thread context 终身持有;lockstep verb barriertight ReadPixelspersistent-map 块推送;G8 字段归属生成器;split 测试 / CI / APK 车道;八包(c0 契约、w1 codec、s1 session、p1 归属、b1 persistent map、t1 车道、c1 路由、v1 server+ j0 / x2 / v1-r3 收尾 jointOpenRA inproc 2/2 SSIM 1.0integration-split 21/21E1 14/14 红;G1 0/0/0/0。收尾头全门在 E3(a) 停止(设计性 skip 被判红),Part 2/4 未到达;收官审查 1 blocker / 10 major / 2 minor → P5b r1/r2。§6
P5b inproc verb migration 37fc4fdb..82683d4a class-C 普查决定顺序;d1 19 / i1 7 / t2 6 / f1 11 槽迁移;sync 五槽;具名 blitGLES mip descriptorr1 / r2;收官审查三项修复。发射表 A=2 / B=54 / C=15 主机全门 348d22a4 completeintegration-split 107/107;合并普查零回退、79 trace 72/6/1Redmi 正确性 8/8 + 四臂 A/B、barrier tax 首测。§7
P5c inproc 共享内存读点归零 下一个2026-09-17 已计划,未开始) server 端纹理 staged shadowSEG_EVENT 的三个 producersink / twin 按记录里的句柄解析;applier_reset / object_death 控制记录;值类 BARRIER-PULLED 行改残余值记录;角色守卫门。详见下文"P5c 计划" 角色守卫开启下 integration-split / 普查 / 79 trace 全绿且每层守卫能红;纹理 0xDD audit 红一次;SEG_EVENT 往返红一次;rsp 只剩对象类行且按帧测得;Redmi 四臂复测记录
P6 spawn transport P5c 之后 SocketTransportsocketpair + fork/execveenvp 剔除 + 强制 monolith 双保险);ServerMainMOBILEGL_IPC_SERVER_PATH + dladdr 兜底;有界重试握手;EOF 即时退出;device-lost latchEGL forwarder 的控制面帧;P5c 留下的 s_synced / g_syncedRenderStateParameters 按 context 世代重置 P5b 的完整渲染路径在 spawn 下绿;进程树只多一个子进程;HeadlessGL fork 预检无孤儿;OpenRA 在 Adreno 830 上 split SSIM ≥ 0.99
P3b / P4b 深化(Espryt 待排 按存储属主键控的发射游标与 view 索引重映射;g_fboTextureSyncListResolvedTextureBindingMemo / SamplerPassMemo / image sweep / program registry 重键;XFB scatter 搬到 client;删 fragColor 重推导 workaround 与 g_broadcastMemo*raw-depth-fetch sampler 原生化;回读 / pack stateP4a 记下的 R-3 / R-4 / R-5 / R-7 / R-10 / R-11ProgramArtifacts.h 的 NDK 尺寸钉 纹理 / program 场景;CTS texture_* / shader_image_* / packed_pixels 在 0.5 pp 内;每一个 Iris traceTextureUploadShapeScenario 升级成门
P7 DirectVulkanMagma)全量迁移 待排 其余 10 个子系统:SetupDrawSnapshot 探测字段塌成 dirty mask;占位纹理原生化;具名 UBO host payloadD-B8);内部 shader 烘焙;VertexInputStateFactory 内容寻址 CSO;D18 容器纪律保留 集成 + trace 在 Magma 的 push 与 split 下全绿;verify 零分歧;nm -D libMobileGLServer.so | grep glslang 为空;CTS 0.5 pp 内。再基线检查点:中点完成子系统 < 40% 立即重定基线
P8 emulation 下放 + 索引宿主镜像 + 协议广度 待排 MG_Impl/Pipe/HostResolve.cpp(client 数组范围、最大索引扫描、*IndirectCount 解析,逐站点 reconcile);Server/IndexHostMirrorCopyImage 镜像搬到 clientviewport-array 回放验证;generate_mipmap 计划 + CPU 回退纹素;大 blob carrier(开放问题 11);无 present fence tickkCapDriverOrderedXfbCapture '^DirectGLES\.Split\.''^DirectGLES\.' 逐名相同;trace split 双后端 SSIM ≥ 0.99 含两个 coherent_as_flush fixtureClientArrayAfterComputeWriteScenariocreate-indirectroundtrips-per-frame 读零;index-mirror-bytes 逐用例发布
P9 反向通道 待排 SEG_REPLY 异步 slot 池;PBO 回读 fire-and-forgetOnGpuWritten 收窄;OnBufferWriteback 批处理 + epoch 排序;OnXfbScatterReadyOnTextureWritebackOnMipLevelsGenerated;纹理拉取四条缓解 + 终止符;OnGlError 有序;OnSurfaceChangedOnLog 分级;SEG_EVENT 溢出策略;class-C 的 readback 尾 回读 / XFB 场景在 split 下绿;TextureRemintPullScenario(含无解用例);拉取计数逐 trace 发布;两条故障注入
P10 sync / query / present 节奏 待排 client 铸造 query handle;轮询入口成门铃点 + MOBILEGL_IPC_POLL_ESCALATEfence 完成度来自逐 fence 退休;非 present fence tickpresent 1:1credit 默认 1roundtrip 计数器与输入延迟直方图;class-C 的 query / swap-interval 尾 query / XFB / AsyncCompile 场景在 split 下绿;trace 上 draw / state / upload 路径 roundtrip 读零;零 timeout 轮询有界退出;配对 A/B 记录
P11 persistent map 与 ≥16 MiB 采纳 待排 POST 探针档位选择(T0 主攻,Adreno 可选 T1,T2 回退);SEG_ADOPT 生命周期绑 completedFrameSerial LargeArenaAdoptionScenario 在所选档下绿;26.3 与两个 Create fixture SSIM ≥ 0.99Adreno 830 上 p99 帧时与峰值 RSS 对采纳基线(163→21 ms / 40→115 fps / ~400 MB)回归不超过 10%
P12 Android 生产窗口路径 待排 android:process=":mgl" Service 收 Java Surfaceserver 生命周期绑 ActivityFCL env 与 plugin APK 开关表接线 Minecraft 经 FCL 在 spawn 模式下于 Adreno 830 双后端入世界;杀 server 产生干净 device-lost latch
P13 退役 pull 路径 待排 SnapshotFromGLContext() 非 verify 分支、MGB_CTXMOBILEGL_PIPE_PUSHMOBILEGL_PIPE_LEGACY_MEMOS;保留 MOBILEGL_PIPE_VERIFYMGPipe recorder;删 set_residual_value_state;在计数器活着的情况下重调幸存缓存容量 static_assert(sizeof(ResidualValueBlock) == 0);三道纯度门在非 verify 构建上转绿;recorder 金标建立;monolith 逐线程 CPU 不差于 P0 基线

CTS 周转单独计价(gl44to46 约 56,271 例):逐阶段只跑该阶段可能影响的具名块;完整 caselist 只在架构边界与合并 dev 之前跑,放 CI 不放关键路径。

P5c 计划:inproc 的共享内存读点归零(审计头 a79a0af62026-09-17

为什么插在 P6 之前P5 / P5b 的 inproc 只把 verb 记录、SEG_STAGE blob、reply 与 caps 快照做成了 wire。对 a79a0af6 的只读静态审计(~/w7/notes/p5c/p5c-audit-v1.md,59 行清单,逐条在该头上重新解析)证明两个角色之间仍有一批不经任何载体的直接内存读写,靠 verb barrier 与同一地址空间才正确。它们不是传输问题:spawn 换掉的只是 ring 的传递方式,而这些读写在另一个进程里根本没有对应内存。P5c 的目标是让 inproc 诚实——两线程之间除 SEG_CMD / SEG_STAGE / SEG_REPLY / SEG_EVENT / caps 快照 / 控制帧之外零直接访问——从而 P6 只是传输替换。本节只是计划,尚未实现。

审计清单(按家族;file:linea79a0af6 为准,完整 59 行见报告)

# 方向 直接访问的是什么 站点 今天为何能工作 现有守卫 P5c 载体
T1 S→C 读 纹理纹素resource_subdata 已把 level 字节放进 SEG_STAGE,但 ApplyTextureUpload 只做门与累积、把指针丢掉,Espryt 同步时从 client 的 MipmapStorage 重读纹素;纹理对象的形状与脏区也直接读前端对象 丢指针 MobileGL/MG_Pipe/PipeApply.cpp:989-1008;重读 DirectGLES/Managers.cpp:7315MapMipmapData)、:6940:7129:7198;形状 :7314:7332:6878-6880DirectGLES/DirectGLES.cpp:8502-8507:8528-8529;脏区 DirectGLES/Managers.cpp:7360:7371 barrier + 同地址空间 :整个纹理家族不在 FieldOwnership.defrsp / MOBILEGL_IPC_STRICT_ERRORS / MOBILEGL_IPC_AUDIT 都看不见 server 端纹理 staged shadowbuffer StagedShadowStore 的纹理半边);SyncMipmapsToBackend 改读它,形状与脏区读描述符
T2 S→C 读写 client 的 slot 分配器 MGPipeSlots()mip / CopyTex / twin 创建时按前端 GetLifetimeId() 在 client 分配器里查找甚至铸造 DirectGLES/DirectGLES.cpp:8087DirectGLES/SlotTables.h:392-400HandleOfFindByLifetimeId);铸造 DirectGLES/SlotTables.h:232GetOrCreate)、:418:428DirectGLES/Managers.cpp:2708:4293:5627DirectGLES/DirectGLES.cpp:6706:8185:8564:8659 barriermip 只 Find 不 mint 无(MOBILEGL_ASSERT 在 INFO 构建失效) 记录已带句柄(MGPMipPlan::ResMGPCopyFromFramebuffer::DstMGPBlit::ReadFbo/DrawFbo)→ GetOrCreate(MGPipeHandle)DirectGLES/SlotTables.h:278
T3 S→C 读 具名 blitclient 临时改绑自己的 read / draw 绑定槽,server 经 MGB_CTX 读绑定槽 client MobileGL/MG_Remote/Client/EmitTables.cpp:741-786server DirectGLES/DirectGLES.cpp:7782-7785 barrier + RAII 恢复 rspGetFramebufferBindingSlot 记录里的 ReadFbo / DrawFbosink 侧按句柄解析(MobileGL/MG_Remote/Server/PipeApplier.cpp:228-244
T4 S→C 读 CopyTexImage2D / CopyTexSubImage2D 经纹理单元绑定槽取目的纹理 DirectGLES/DirectGLES.cpp:8561-8563:8656-8658 barrier rspGetTextureUnitObject 记录里的 Dst 句柄
T5 S→C 写 Magma 生成 mip 直接写 client 的 level 存储(Espryt 的重推导臂没有 Magma 对应) DirectVulkan/Renderer/VulkanRenderer.cpp:1562-1590(调用 :11317 barrier 与 GLES 同形:只按描述符验证
B1 S→C 读 BufferObject::HasDefinedContent(),每个 ensure 的 draw 都读 DirectGLES/Managers.cpp:3147-3148EnsureBufferResourceForHandle:3141-3146 自述为债) barrier 描述符旁的 live-content 位,client 发布
B2 S→C 读 HandleOfBuffer 每次 ensure 读前端 GetLifetimeId() DirectGLES/Managers.cpp:2705-2716 barrier + memo 记录里的句柄
B3 S→C 读 旧 buffer 臂(MappedData() / IsMapped() / GetChangeSerial())在 split 构建里位 7 清零时可达,arm resolver 只打一行 MGLOG_D DirectGLES/Managers.cpp:2586-2620;臂体 :1012-1022:1119-1121:2944-2949:3281-3327 同进程 有传输时具名拒绝(同 Fatal{PipeLegacyMemosDisabled} 的形状)
B4 S→C 读写 XFBSharedPtr<BufferObject> 跨整个 span 持有,结束时 WritebackFromBackendscatter 对 client shadow 读改写 DirectGLES/DirectGLES.cpp:950:1060:1077:1081:1172:1185 barrier OnBufferWriteback / OnXfbScatterReady 事件——P9 的题材,P5c 只记账
R1 S→C 写 反向通道是 apply 线程直接调进 client 的 MG_StateOnBufferWriteback裸指针塞进 MGPBlobRef.Offsetclient 侧再转回指针;consumer 会拒绝任何真实段 生产 DirectGLES/Managers.cpp:2339-2343Ops_H_Readback);消费 MobileGL/MG_Impl/Pipe/ResourceTracker.h:553-572(拒绝真实段 :560-564 同地址空间 + barrier SEG_EVENT kEventBufferWritebackconsumer 已在(MobileGL/MG_Remote/Client/ClientSession.cpp:176-267),全仓零 producerMobileGL/MG_Remote/Server/ServerSession.cpp:484-492 无调用者)
R2 S→C 写 OnGpuWritten 直接调进 client trackerMagma 更是绕过回调直接 MarkGpuWritten() Espryt DirectGLES/Managers.cpp:2729-2752,喂入 DirectGLES/DirectGLES.cpp:568:616:2601Magma DirectVulkan/Renderer/UniformManager.cpp:1075:1231DirectVulkan/Renderer/VulkanRenderer.cpp:11618 同地址空间 MGLOG_E_ONCE SEG_EVENT kEventGpuWrittenconsumer MobileGL/MG_Remote/Client/ClientSession.cpp:227-236
R3 S→C 写 默认 framebuffer 附件(pDefaultFramebufferInfo)由 server 在 surface 创建时写 DirectGLES/DirectGLES.cpp:11519-11620Magma DirectVulkan/Renderer/SwapchainObject.cpp:276-335 barrier;罕见 SEG_EVENT kEventSurfaceChangedconsumer stub MobileGL/MG_Remote/Client/ClientSession.cpp:242-253
R4 S→C 写 sticky forwardRecordError 写 client 错误队列;InvalidateCompileEnv 写 client 编译环境(在 stamped verb 之外静默 no-op MobileGL/MG_Impl/Pipe/PipeFill.cpp:1753-1756:1764-1772 barrier rspstrict 下 Fatal RecordErrorOnGlError 事件(顺序保证是 P9 的);InvalidateCompileEnv 的活已由 R-12 caps 重发布完成(MobileGL/MG_Remote/Client/CapsMirror.cpp:78-80),删 forward
R5 MGPipeCallbacks 十个回调只装了两个,且都是 apply 线程内联调用;SEG_EVENT 段已创建、映射、握手公告、每个 reply verb 后排空,但没有任何生产者 安装 MobileGL/MG_Impl/Pipe/ResourceTracker.h:606-613;段 MobileGL/MG_Remote/Server/ServerSession.cpp:285-301;排空 MobileGL/MG_Remote/Client/ClientSession.cpp:836 溢出 latch 与 eventDropped 已建未用 本身就是载体
C1 S→C 读 Magma 四处直接读 client 镜像 pActiveBackendObject->GetDynamicParameters()Espryt 已改走 server 自己的 backend);Espryt 的格式表回落臂在 server backend 为空时读 client 镜像 DirectVulkan/DirectVulkan.cpp:713-715DirectVulkan/Renderer/VulkanRenderer.cpp:667-676DirectVulkan/Renderer/VertexInputStateFactory.cpp:249-250:502-503DirectGLES/Utils.cpp:50 镜像值等于快照 server 自己的 Backend()->GetDynamicParameters();回落臂拒绝
G1 shared gPipeInputsclient 残余填充写、applier 写、server 的 36 行 BARRIER-PULLED 读 MobileGL/MG_Backend/MGPipe/PipeInputs.h:806;填充 MobileGL/MG_Impl/Pipe/PipeFill.cpp:2798applier MobileGL/MG_Pipe/PipeApply.cpp:1415-1560stamp MobileGL/MG_Backend/MGPipe/PipeInputs.cpp:103-132rsp MobileGL/MG_Backend/MGPipe/PipeInputs.cpp:72 只靠 verb barrier 保证单写者 rsp + strict Fatal + poison 值类行(GetActiveTextureUnitGetMaxTouchedTextureUnitGetTouchedBufferBindingPointCountGetCurrentVertexAttribute、XFB 六项、三个世代)→ 每 verb 一条残余值记录或按 Coverage.def 由 server 自答;对象类行GetBoundVertexArrayGetProgramForDraw/DispatchGetTextureUnitObjectGetImageTextureBindingGetFramebufferBindingSlotGetBufferBindingSlot/Point、sticky GetTextureObject / GetProgramObject)返回前端对象指针、无法序列化,留 P3b/P4b/P7/P8 的 twin 表
G2 C→S 写 GL 线程在 FreshlyPrimed 时整体 MGPipeApplierReset() server 的 g_applier MobileGL/MG_Impl/Pipe/PipeFill.cpp:2654-2656MobileGL/MG_Pipe/PipeApply.cpp:1202-1299 barrier 的后置条件(validate 时无在飞记录) make-current 边上的 applier_reset 控制记录
G3 C→S 写 六种前端对象死亡:栈上结构体指针经 mailbox 送到 apply 线程(framebuffer 没有 wire delete opcode DirectGLES/Managers.cpp:206-228 阻塞 + 同地址空间 object_death wire 记录
G4 C→S 控制 十二个 Server* EGL forwarder 经 one-slot mailbox 传函数指针 + void* 栈局部 MobileGL/MG_Remote/Client/BackendObject_Remote.cpp:125-264MobileGL/MG_Remote/Server/ServerLoop.cpp:543-598 阻塞 Fatal{ApplyThreadNotRunning} P6 的控制面帧(P5c 不做)
G5 C→S 读 ServerLoop::OnApplyThread() 每条 routed 记录读;bring-up 直接读 loop.Backend() / MGPipeGetResourceOps() MobileGL/MG_Remote/Client/WireTables.cpp:71MobileGL/MG_Backend/Init.cpp:100:145:164-170:247 同进程 client 本地角色标志;caps 快照的 cap 位(P6 顺手)
G6 shared 前端地址 / lifetime-id 键控的 Espryt twin registry;持前端裸指针的 memoResolvedDrawBuffers::Entry::frontend、三张 texture sync list);server 读 pDefaultFramebufferInfog_rawDepthFetchSamplerStateScopedDefaultUnpackState::s_synced 从不按 context 世代重置 DirectGLES/Managers.h:309-377:1185DirectGLES/DirectGLES.cpp:61-62:1958-1987:2846DirectGLES/Managers.cpp:5806-5812 barrier / server 私有 P3b/P4b 的 twin 表重键与 D-C1s_synced 按 context 世代重置归 P6
A1 barrier 的 client 半边断言从未接线:InBarrierWait() 零调用点,只有 ApplyThreadIsInsideApplier 在 emit 时检查 MobileGL/MG_Remote/Client/ClientSession.cpp:880:748-753 接上,或删掉契约里的这句声明

已确认 wire-clean、不进 P5cbuffer 全家族(Ops_H_* 只拿句柄 + 记录 + SEG_STAGE 字节,StagedShadowStore::Adopt 复制,Fatal{StageSnapshotTooNarrow} 六处);resource_respecify 初始字节双向拒绝;persistent map 仿真档按块过 SEG_STAGEFatal{RoleViolation} 挡住 apply 线程;CreateShaderState 归档是一个 blobcaps 的格式表与 renderer 字符串走 CapsSnapshot 控制帧(GetCaps 记录本身已死,只是卫生项);tight ReadPixelsDrawVbo 用户索引;fence 家族;gMGPipeSegmentResolvergBackendFunctionsTable 的角色划分。

包与顺序

内容 关闭的行
c0c 契约 MG_Remote/CONTRACT-P5C.md:纹理 staged shadow 的所有权与覆盖规则;SEG_EVENT 记录与 blobref 约定(Seg = kSegEvent);sink / twin 按句柄解析的规则;applier_reset / object_death 记录;角色守卫的语义(有传输时 apply 线程触前端对象表面、GL 线程触 server 状态表面都是 Fatal{RoleViolation});残余值记录的字段表;把纹理家族补进 FieldOwnership.def
tx 纹理 StagedTextureStoreApplyTextureUpload 采纳 SEG_STAGE 字节到 server 侧 level shadowSyncMipmapsToBackend、形状读、脏区改读描述符与 shadow;Magma mip 改按描述符;MOBILEGL_IPC_AUDIT0xDD 覆盖纹理 T1、T5T2 的 mip 半边随之)
ev 反向通道 ServerSession::PublishEvents 接三个 producerwriteback / gpu-written / surface-changed),consumer 的段臂改为解析 kSegEventMagma MarkGpuWritten 改走回调;RecordError 进事件(顺序仍 P9);删 InvalidateCompileEnv forward;溢出策略沿用 ARCHITECTURE.md §11.7 R1R5
hd 句柄解析 blit / mip / CopyTex / HandleOfBuffer 的 sink 与 twin 按记录里的句柄解析(GetOrCreate(MGPipeHandle)),server 不再触 MGPipeSlots()HasDefinedContent 改读描述符的 live-content 位;Magma 四处 caps 读改 server backendUtils.cpp 回落臂拒绝 T2、T3、T4、B1、B2、C1
ct 控制记录 applier_resetobject_death 两条 wire 记录(framebuffer 首次有 delete opcode);mailbox 只剩 EGL forwarder 给 P6 G2、G3
rv 残余值 值类 BARRIER-PULLED 行改为每 verb 的残余值记录(或 server 自答),gen_pipe_field_ownership.py 把它们改成 RECORD-SUPPLIED;对象类行保持 BARRIER-PULLED 并逐行标注归属阶段 G1 的值类半边
gt 角色守卫(两层 Fatal{RoleViolation},仅 split 构建、有传输时生效);InBarrierWait 接线;旧 buffer 臂传输拒绝;rsp 按帧进 stats 行并在四条 A/B trace 上测得;CI 加一条 MOBILEGL_IPC_STRICT_ERRORS=1 + 角色守卫的 integration-split 车道 A1、B3,以及所有行的红一次证据

顺序:c0c → tx / ev / hd 并行 → ct / rv → gt 收口。每包自带 red-onceR-16),阶段末一次 Codex / Kimi 审查(ID-66)。

出口门(E-P5c

  1. 角色守卫下全绿:守卫开启时 integration-split107)、broad inproc 车道对 348d22a4 普查零回退、79 trace 无新增首阻塞;关掉任一层守卫必须能在一条具名用例上变红。
  2. 纹理字节不再回读 clientMOBILEGL_IPC_AUDIT=1 对纹理 staged 字节的 0xDD 填充在四条 A/B trace 上无失败;把采纳改回丢指针必须变红。
  3. SEG_EVENT 有生产者:三条事件的往返单元与集成用例;排空点上 eventDropped == 0;把 producer 改回裸指针必须变红。
  4. rsp 分类完成:四条 A/B trace 每帧 rsp 已测;剩余读全部是对象类行,名单由 FieldOwnershipTest 钉住,值类行为 0。
  5. Redmi 四臂复测(记录,不设门):writeback / gpu-written 改走事件后 barrier tax 重新记录。
  6. G1 0/0/0/0、G2 / G14、G5 照旧。

留给后续阶段的(P5c 不碰)

对象类 BARRIER-PULLED 行与 twin registry 的前端键(P3b/P4b、P7);XFB scatter / OnXfbScatterReadyOnTexturePullRequest 与终止符、OnGlError 有序化(P9);EGL forwarder 的控制面(P6);copy-image-shadow-mirror 与 CopyTex 纹素回写(P8 / P9);s_synced / g_syncedRenderStateParameters 的 context 世代重置(P6)。

里程碑

  • P2 出口(2026-09-08):GO/NO-GO 判定继续——五部分门全绿,逐线程 CPU 代价约 +10% 被接受;tracker 绝对 ns 上限降为记录项。
  • P3a / P4a 出口(2026-09-08:各 1 天,远低于 27 / 39 天的再基线绊线,未触发重定基线。
  • P5 出口(2026-09-16:缩减路径首个 IPC 帧;最终全门在 E3(a) 停止;红米四臂的 split 均停在索引 drawbarrier tax 未测(归 P5b)。
  • P5b 出口(2026-09-16,已达成):主机全门 348d22a4 complete79 trace 72/6/1;设备源头 82683d4aAPK p5bcodex2Redmi 正确性 8/8——四条 A/B trace 双后端首次在设备上 inproc 渲染;barrier tax 首测 splitpush 逐线程 CPU p50 +5.9% +18.2%。
  • 仍是方向、不据此伪造新日历:全功能 split(P8 之后)、纯度门在非 verify 构建上转绿(P13)。

再基线检查点仅剩一条:P7 中点完成子系统 < 40% 立即重定基线(P3a 的检查点发现不了 Magma 特有的超期)。

P5 / P5b 出口记录的债务

债务 去向 / 当前口径
P5 的 27 个普通 inproc wrong-answer(历史计数) 2214 layered + 3 packed depth/stencil + 5 framebuffer recycle)→ P4b/P7 texture readback3 → P7 query1 inspection → P61 FBO/RBO delete 用例在 r1 定向验证中通过,完整像素因果未隔离。最终计数以 MEASUREMENTS.md §7.2 的同名比对为准
rsp residual inputs STRICT_ERRORS reduced lane 19 abort / 2 skiprsp=35 只是有 stamp 读点的下界,无 verb stamp 的 sticky / non-verb forward 仍可绕过计数;P7/P8 补逐字段归类,其余按字段的 P3b/P4b/P7 退役
SEG_REPLY 2 MiB 单槽 payload cap 更大 readback 需要 P6+ chunking 或专用 carrierID-47
GetCaps 的两个 blobref 目前不骑 record;一旦运输,必须有 server→client carrier rule,不能套 SEG_STAGE
PACK-PBO readback P5 具名拒绝;真实形状是 server 写 buffer resource、client MarkGpuWrittenP6ID-57
ABI fingerprint 不混 segment sizes;改变 8/32/16 MiB + 256 KiB ledger 时仍欠这项
默认 32 MiB staging 目标负载单次 128 MiB 上传装不进默认 stage;普查 / Redmi 显式 256 MiB profile,默认不改;分块 / 专用 carrier 归 P8(开放问题 11
P5b 的 inproc 依赖 具名 blit 的 scoped client binding + barriermip descriptor 的 registry 身份查询依赖 barrier-held objectFBO death 的 inproc mailbox。P6 必须替换
未迁移与仿真路径 15 个 class-C 槽(query / sync 尾 / GetTexImage / SetSwapInterval)→ P9 / P10client vertex arrays、multi-draw client indices、RGB 三通道 CPU mip、renderbuffer copy endpoint、未绑定 named clear、texture-remint-pull 仿真保留具名拒绝 → P8 / P9Magma split compute / image 路径 82 个错答 → P7
E2 wire 内容控制 draw-drop 是 OpenRA 的有效控制(758 drawsSSIM 0.000036);clear-drop 被全屏 overdraw 掩盖,不能作控制
max record bytes 实测 reduced / OpenRA maxrec=784 B,默认 cap 4 MiB;只代表所测负载,后续索引 / indirect 尾仍须记录
树外脚本 普查跑器、wsl_p5_gate.sh、Redmi 定频行都在 ~/w7/notes/git merge 不会传播
临时 CI trigger 合入 dev 前删除 test.yml / apk.ymlfeat/disaggregated TEMPORARY trigger

开放问题

P0 已回答的不再列出(spike A 的域、spike B 的分档、posix_spawn 不可用、OOM 探测惯用法、GetInteger64i_v/GetProgramiv 退役、D21 与 RenderbufferObject lifetime id、动态 accessor 基线)。

  1. client 侧 dirty 走查的真实每 draw CPU 代价。 已答(P2–P4a):推送没有在拉取基线之下净减少;Release 下 P2 边界 +612%P3a 在 VAO 切换密的 rd12 上再加 +1719 ptP4a 在 Espryt 上 +3.45.7 ptMEASUREMENTS.md §3–§5)。用户 2026-09-08 接受,性能自此只记录。
  2. 真实语料上纹理重铸拉取的发生率。 已答(P4a):可忽略,保留 LRU 维持默认 0——79 例 × 两后端 780 个统计窗口里共 2 次(iris-photoniris-derivative 各 1,只在 DirectGLES)。但 P5b 下这条路径是具名 Fatal,正是这两条 trace 加 create-indirect GLES 的首阻塞(P9)。
  3. spike B 的 untrusted_app 域复核。 两台设备的分档在 shell 域测得;从应用进程再跑一次 extmem_probespike A 的 exec 钩子已可用)。P11 前做。
  4. 渲染状态的 wire 粒度。 已答(P2):16 个边界 / 15 个 chunk7 pipeline 396 B + 8 dynamic 772 BCSO LRU 64 暂定,P13 重调。
  5. 无存储的 capability。 已答(P2):FramebufferSrgbDepthClampTextureCubeMapSeamless 三个都补了真存储,sizeof(RenderStateParameters) 仍 1168。
  6. 具名 UBO host payload 的形状(D-B8)。 Magma 在 26.3 世界每帧重打包 331 KB 具名 UBO 字节,Espryt 为 0。要么冻结第二变长尾形状,要么走备选(Magma 直接描述符绑定常驻 VkBuffer range,独立 dev PR)。P7。
  7. MG_Util 的切割缝。 server 需要 SPIRV-Cross / ESSL 转译缓存 / 格式处理器 / POST 探针,client 需要 glslang 与反射层;MG_Util 内部是否有干净的 Transpile-vs-Reflect 缝未审计。P7。
  8. 一份反射归档能否服务三个消费者。 Espryt 那一半已答(P4a):能且不需要复制。Magma 的两个消费者(DirectVulkan.cppglGetProgramResource* 重跑反射)未答。P7。
  9. viewport-array 回放能否塞进一次 draw_vbo:各遍之间观察到的状态是否与今天一致未验证。P8。
  10. ResidentSubData 的不对称。 P3a 原样保留:SubDataResidentkOptionalMagma 未补实现、kCapResidentSubData 未接线。P7 / 独立 dev PR。
  11. SEG_STAGE 的上限。 目标负载已实测单次 128 MiB 上传,超过默认 32 MiB;普查与 Redmi 统一显式 256 MiB,默认不变,分块路径未实现。P8 需要 MC in-world / Create 的占用分布与更大 blob 的 carrier 设计。
  12. P13 之后 split-only 渲染 bug 的 server 侧第二意见。 verify 构建 + recorder 只覆盖推送内容,不覆盖后端对它的解释。
  13. 烘焙后的内部 shader 能否在没有活 ProgramObject 的情况下表达 uniform location 与 UBO 布局。 未做原型。P7。
  14. 推送模型改变哪些按拉取模式调过的缓存命中率。 幸存者容量在 P13 重调。一条线索:设备上 26.3 Espryt 的 sve ≈ draw 数(每 draw 重发一次 sampler-view 集合),桌面只有 ~0.07/draw;列入 P3b/P4b 优化清单。
  15. monolith 的 *IndirectCount 不调 SyncGpuWrites() 是不是潜在缺口。 独立 dev 问题,拆分不得借机顺手修。
  16. 索引宿主镜像的实际内存占用。 MC / Sodium / Iris 语料里 element-array buffer 总量未测;若显著超 64 MiB,退化路径的频率与代价必须实测。P8。
  17. create-indirect fixture 在 Adreno 830 上的失败dev@81b17c0b 就有的(基线 APK 复现),不是本分支造成;rd12 + Magma 在两台 Adreno 830 上的 scudo::reportMapError 崩溃同样是 dev 侧。两者排除在设备 A/B 之外、留在桌面语料里;P8 要在 create-indirect 上断言 roundtrips-per-frame == 0,所以 dev 的修复在别人的关键路径上。