MobileGL/docs/Disaggregated/notes/p5f/f0-magma.md

f0 普查 · §2.2 Magma（DirectVulkan）跨角色读写

基线：feat/disaggregated @ 8b68b92c（代码头 25fba0d5 之后的提交只动文档）。行号均以该 HEAD 为准。 范围：MobileGL/MG_Backend/DirectVulkan/** 一侧所有直接读前端对象 / 读 client 镜像 / 写 client 存储的站点。 只读普查：本文件是唯一产物，未改任何代码、未构建、未跑测试。

0. 总判断

1. Magma 在 transport 下的 draw/dispatch 路径今天根本跑不通，这不是推断而是守卫的直接后果：顶点/索引/UBO/SSBO/indirect 缓冲的同步都汇到 VkBufferManager::AcquireResidentSlice / AcquireStreamedSlice，两者第一动作就是 bufferObject->SyncPersistentMappedRange()（VkBufferManager.cpp:657、:708），而该方法在 transport + apply 线程下无条件 Fatal{RoleViolation, "buffer-legacy-arm"}（MG_State/GLState/BufferState/BufferObject.cpp:415-440，守卫条件 PushIsArmed() && OnServerRole()，PersistentMapTracker.cpp:526-535）。CI 侧与之一致：integration-magma-split 只有两条 DirectVulkan.Split.NamedBlit.*，且预期红（在 Clear 的 GetFramebufferBindingSlot 读处就 abort，MobileGL/MG_IntegrationTest/CMakeLists.txt:2411-2437，.github/workflows/test.yml:1353-1381）。所以"今天为何能工作"对本目录绝大多数站点的诚实回答是：monolith / pull 臂下同线程直接成立；inproc split 下只有不设缓冲的 verb（Clear/Blit/GenerateMipmap 等）能走到，凡是 draw 带缓冲即具名 Fatal。lockstep（Magma 永不发布 kCapRunAheadApply，CONTRACT-P5E.md:68、§6.1）保证每条记录设障，使未加守卫的 BARRIER_PULLED 读在非 strict 下作为 admitted pull 计数（rsp）而非 Fatal——但 guard 类站点不吃这一套，任何 strictness 下都 abort。
2. T5 属实且已被 P5c tx 处理：transport 下生成 mip 改写 server 的 staged shadow，不再写 client 的 level 存储；但留了两处具名残余（见 §2）。
3. C1 四处 caps 读属实已改走 server backend（见 §3）。
4. 对象类 BARRIER_PULLED 字段的 Magma 读点全部在 draw/dispatch/blit/readback/mipmap/XFB 路径上，逐字段清单见 §4。其中 8 行的退役标签是 "P5e (Espryt unbarriered), P7 (Magma)"，第 9 个 GetTextureObject 标的是裸 "P7"（Espryt 半边已在 P5c tx 退役），合计 9 个 Magma 相关行——与任务书的"9 个"一致。
5. 除字段读外，Magma 还有三类结构性跨角色耦合：前端地址键控的 twin registry / memo（§5）、server 在 apply 线程上创建与销毁前端类型对象（§6）、以及对前端 BufferObject 的直接方法调用（§7）。

1. 术语与机制前提（本次普查用到的）

• MGB_CTX 在 push 构建下 = &MG_Pipe::gPipeInputs（MG_Pipe/PipeInputsSwitch.h:17-21）；在 pull 构建下 = MG_State::pGLContext。Magma 全树的对象访问器读都经此宏。
• lockstep：Magma 臂的 CallMask 不含 kCapRunAheadApply，每条记录都设障，apply 时 client 停在 WaitForApplied。
• 双层守卫（均在 MOBILEGL_BUILD_DISAGGREGATED 下）：Fatal{RoleViolation, "MGPipeSlots"}（MG_Impl/Pipe/SlotAllocator.cpp:32-70，挂在 Acquire/FindByLifetimeId/Free，:330/:317/:339）；Fatal{RoleViolation, "buffer-legacy-arm"}（BufferObject.cpp:47-66，挂在 MappedData :992 / ShadowAllocationBytes :1002 / GetChangeSerial :1025 / HasDefinedContent :1034 / IsMapped :1049，以及 SyncPersistentMappedRange :434-437）；Fatal{RoleViolation, "texture-legacy-arm"}（MipmapStorage.cpp:30-60，被 MGPipeTextureLegacyArmScope 豁免）。
• Magma 的具名豁免 scope：MagmaP7AllocatorDebtScope（MG_Impl/Pipe/SlotAllocator.h:223-248，P5e ruling 12 改名后专指 Magma 的四笔 apply 线程分配器债，且按后端种类 keyed——Espryt 借用即 Fatal，SlotAllocator.cpp:47-55）。

2. T5（P5c 审计行，ROADMAP.md:57）核验：属实，已迁移，但有残余

原状（ROADMAP 记的行号已漂移）：EnsureGenerateMipmapStorageAllocated 现在位于 Renderer/VulkanRenderer.cpp:1590-1637（非 :1562-1590），其中 texture.AllocateStorage(...) :1632、texture.MarkStorageDirty(...) :1633 直接写前端 TextureObjectMipmap 的 level 存储。调用点在 GenerateMipmap（def :11378，非 :11317）。

现状（P5c tx 已落地）：GenerateMipmap 在 transport 下改走 EnsureGenerateMipmapShadowAllocated（:1655-1682），把生成的链定义在 server 的 StagedTextureStore 上、以 twin 地址为键（KeyForTwinAddress，:1670）；monolith 臂保持原样（:11464-11474 的三元）。跨进程：成立。

残余两处，均已被代码注释自认：

• 形状读：EnsureGenerateMipmapShadowAllocated(*resource, baseMipLevel, texture->GetUploadTargets())（:11470）——upload-target 列表仍读前端对象。注释 :1653-1654 明说："The upload-target list still comes from the frontend object - a shape READ, the P7 registry's residual"。
• GenerateMipmap 头部仍经 MGB_CTX->GetTextureUnitObject(...)（:11401，BARRIER_PULLED）取得前端纹理，并把它传给 m_textureManager->NeedsMipChainGrowth(*texture)（:11420）与 SyncTextureAndGetDescriptor(*texture)（:11442、:11477）——后者进入 §5.1 的前端地址键控同步，读 client mip shadow（见 §5.2 的 texture-legacy-arm）。

P5f 处置建议：T5 本体无需再做；残余随 §4 的 GetTextureUnitObject / §5.1 的纹理 twin 迁移一起消失（upload-target 列表可随纹理描述符/记录供给）。

3. C1（ROADMAP.md:67）核验：四处全部属实，已改走 server backend

四处均在 MG_Config::Transport != Monolith 时读 MG_Remote::Server::ServerLoopInstance().Backend()->GetDynamicParameters()（server 自己的 backend），monolith 臂保持 pActiveBackendObject：

#	站点（当前 HEAD）	函数
1	DirectVulkan.cpp:714-733（split 臂 :723-728）	ShaderStorageBlockBinding，MaxShaderStorageBufferBindings 越界检查
2	Renderer/VulkanRenderer.cpp:676-712（split 臂 :682-693）	ApplyLineWidthState，aliased line-width clamp
3	Renderer/VertexInputStateFactory.cpp:252-264	narrowFloat64Arrays 判定（SupportsFloat64VertexAttributes）
4	Renderer/VertexInputStateFactory.cpp:515-527	ToVkVertexFormat 的 Long 臂同一 flag 判定

（ROADMAP 记的 :713-715 / :667-676 / :249-250 / :502-503 均略有漂移，指向相同代码。）DirectVulkan.cpp:20 起的 #if MOBILEGL_BUILD_DISAGGREGATED include 即为此。跨进程：成立（server 读自己的 backend 对象）。Espryt 回落臂（DirectGLES/Utils.cpp:50）不在本普查范围。

4. 九个 "P7 (Magma)" BARRIER_PULLED 字段的 Magma 读点

字段归属以 MG_Pipe/FieldOwnership.def:53-107（非 sticky 行）与 :178-192（sticky forward 行）为准。"draw 路径"= 经 SetupDraw(:6801) / TrySetupDrawFastPath(:6375) / GetOrCreatePipeline(:5250) 到达；"dispatch 路径"= 经 DispatchCompute(:7419) / DispatchComputeIndirect(:7472) 到达。

4.1 GetBoundVertexArray — 6 站，全部在 draw 路径

• DirectVulkan.cpp:805（BuildClosedLineLoopIndices，LINE_LOOP 重写）：读出 VAO 的索引缓冲绑定后 indexBufferShared->SyncPersistentMappedRange() + MappedData()（:814-815）——后者在 transport 下是 Fatal{buffer-legacy-arm}。即 Magma 的 LINE_LOOP indexed draw 在 split 下今天是具名 Fatal，不是静默错。
• DirectVulkan.cpp:929（MultiDrawElementsImpl :913）：只读 EBO 绑定存在性以决定逐条回放。
• VulkanRenderer.cpp:6446（TrySetupDrawFastPath）、:6852（SetupDraw）：每次 draw 的对象读；fast path 还有 handle 臂（ResolveVaoHandle，:6452-6458，MagmaPipeTrackHArmIsHandles），但 handle 由 vao.GetLifetimeId() 推出——仍以前端对象为源。
• VulkanRenderer.cpp:12550（MultiDrawElementsIndirectCount :12528）、:12651（MultiDrawElementsIndirect :12629）。

今天为何能工作：同地址空间 + 每条记录设障；值是 client 残余填充的 SharedPtr<VertexArrayObject>（PipeFill.cpp:1902-1905 一带，见 FieldOwnership.def:68-71 的引文）。跨进程：不成立（前端堆 SharedPtr）。

4.2 GetBufferBindingPoint / GetBufferBindingPointCount — 3 + 2 站，draw 与 dispatch 都到

• UniformManager.cpp:1205 + :1200（ResolveStorageBufferDescriptor :1157，SSBO/原子计数器绑定解析，draw/dispatch 共享）。
• UniformManager.cpp:2035 + :2030（ResolveUniformBufferPayload :1979，UBO 绑定解析，draw/dispatch 共享）。
• VulkanRenderer.cpp:11764（BeginXfbCaptureForDraw :11714，BufferTarget::TransformFeedback，XFB 捕获，draw 路径）。

三处取到绑定点后都继续 bindingPoint.GetBoundObject() 拿前端 BufferObject，再走 §7 的 buffer legacy arm。跨进程：不成立（BindingSlotRange1D 前端基址指针，PipeFill.cpp:2591-2592 的 "four raw bases" 同类）。GetBufferBindingPointCount 是 sticky forward（FieldOwnership.def:147-148），退役标签 "P7/P13"。

4.3 GetFramebufferBindingSlot — 13 站

• draw 路径：VulkanRenderer.cpp:3158（GetShaderTransformFlags，判 default FBO 决定 Y-flip 编译位）、:5510、:5730（GetOrCreatePipeline，深度/模板附件门控与 render-pass 相容性）、:6360（GetBaseTransformFlagsRaw 的 MOBILEGL_ASSERT——注意：INFO 级别下断言被编译掉，这站不总是执行）、:6465（fast path）、:6845（SetupDraw）、UniformManager.cpp:560（ResolveSamplerDescriptor 的 feedback-loop 诊断）。
• 其余 verb：VulkanRenderer.cpp:7648（Clear——这就是 integration-magma-split 预期红的那一对 GetFramebufferBindingSlot@Clear，CMakeLists.txt:2411）、:8016（QueueClearBufferPayload）、:9024/:9025（BlitFramebuffer 的 bound 臂；具名臂见 §5.4）、:9660（CopyTexSubImage2D，Read 靶）、:10371（ReadPixels，Read 靶）。

读到的都是前端 BindingSlot<FramebufferObject> 指针再 GetBoundObject()。跨进程：不成立。

4.4 GetImageTextureBinding — 4 站，draw 与 dispatch 都到

• UniformManager.cpp:1021（ResolveStorageTexelBufferDescriptor :991）、:1312（ResolveStorageImageDescriptor :1276）、:1867（CollectStorageImageTextures :1818）、:1955（CollectSamplerImageFeedback :1900，sampler/image 子资源重叠危害探测）。

返回前端 ImageTextureBinding 基址后的元素。跨进程：不成立。

4.5 GetTextureUnitObject — 8 站（与 FieldOwnership.def:90 的 "8 Magma sites" 吻合）

• UniformManager.cpp:511（ResolveSamplerDescriptor，随后 textureUnit.GetSamplerObject() :512 取前端 SamplerObject）、:787（ProgramSamplesOnlySingleLevelTextures）、:826（ResolveSamplerTexture）、:852（ResolveSamplerTextureRaw）、:1679（ResolveSampledBinding）。
• VulkanRenderer.cpp:9652（CopyTexSubImage2D）、:11157（GetTexImage——class C，split 下 client 侧已具名拒绝，EmitTables.cpp:1673-1675）、:11401（GenerateMipmap）。

指针指进 client 的纹理单元数组（PipeInputs.h:669 的解引用 + PipeFill.cpp:274 的裸指针填充）。跨进程：不成立。

4.6 GetProgramForDraw / GetProgramForDispatch — 3 + 2 站

• draw：VulkanRenderer.cpp:6384（TrySetupDrawFastPath）、:6815、:6853（SetupDraw）。
• dispatch：VulkanRenderer.cpp:7424（DispatchCompute）、:7476（DispatchComputeIndirect）。（FieldOwnership.def:97 注里写的 :7327 已漂移。）

拿到前端 SharedPtr<ProgramObject> 后整个 program 内容都从前端对象读：ProgramFactory::ComputeHash/GetOrCreateProgram 读 program.GetGeneratedSpirv()（ProgramFactory.cpp:2469-2473、:3472）；ResolveUniformBufferPayload 读 program.GetUBOData()/GetUBOSize()（UniformManager.cpp:1992-1993，具名 UBO host payload，ROADMAP.md:142 D-B8 的已知形状）、GetUniformBlockBinding/GetUniformBlockName/GetUBOSizeAt（:2028/:2033/:2063）。跨进程：不成立。Espryt 在 P5e pa 的证明（"记录早就带着逐 link 的 ProgramArchive"，ROADMAP.md:31）对 Magma 尚未接线——Magma 的 program 记录载体是否存在，本次未核实到（未知，fm 包第一天要回答）。

4.7 GetTransformFeedbackProgram — 2 站，draw 路径

• VulkanRenderer.cpp:11725（BeginXfbCaptureForDraw）、:11824（EndXfbCaptureForDraw）。前端 SharedPtr<ProgramObject>。跨进程：不成立。配套读还有 IsTransformFeedbackActive/Paused（:11716/:11722，值类，记录供给，成立）、GetBoundTransformFeedbackLifetimeId（:11667，值类）、GetTransformFeedbackGeneration（:11801，值类）、HasOpenTransformFeedbackSpan（:11684，sticky forward，"P7/P9"——前端 XFB span 表查询，不成立）。

4.8 GetTextureObject — 1 站

• VkTextureManager.cpp:810（SyncTextureAndGetDescriptor 内）：按 GL name 查前端纹理对象表以注册 alive 追踪；查不到就 texture.weak_from_this()（:821）——把前端对象的 control block 存进 server 侧 map。sticky forward，退役标签裸 "P7"。跨进程：不成立。

4.9 相邻但非 "P7 (Magma)" 的字段读（列出以免漏网）

• GetBufferBindingSlot（"P8/P9/P13"，15 靶合一数组）13 站：DirectVulkan.cpp:283（ResolveIndirectCommandBytes，DrawIndirect）、:407（MultiDrawArraysIndirect）、:470（MultiDrawArraysIndirectCount，Parameter）、:538（DrawElementsIndirect）、:591（DrawArraysIndirect）；VulkanRenderer.cpp:7520（DispatchComputeIndirect，DispatchIndirect）、:11126（GetTexImage，PixelPack）、:12560/:12566、:12661、:12731（multi-draw indirect 各站）；UniformManager.cpp:910（ResolveTexelBufferDescriptor）、:1053（ResolveStorageTexelBufferDescriptor——这两站是 textureBuffer->GetBufferBindingSlot()，前端 TextureBuffer 对象自身的方法）。indirect 路径取到前端 buffer 后普遍跟 SyncPersistentMappedRange()（如 DirectVulkan.cpp:285、VR:7525）——transport 下具名 Fatal。
• GetTransformFeedbackPausedPrimitiveCounter（FATAL 行）：DirectVulkan.cpp:1256（GetQueryResult64 :1228）、:1303（BeginXfbPrimitivesQuery :1294）。两个入口都是 class C（EmitTables.cpp:1690-1693），split 下 client 侧先拒绝，今天不可达；行为一致，归 §2.7，不归 P5f。
• GetPixelStoreParameters(false)（pack 半，APPLIER_DERIVED）：VulkanRenderer.cpp:11127。跨进程成立。注意 FieldOwnership.def:208 注里写的 ":10980" 已漂移（该行现在是 MOBILEGL_ASSERT），真身在 :11127——文档漂移，供 fm 顺手修注。

5. 前端地址 / 前端身份键控的 twin registry 与 memo

5.1 VkTextureManager（纹理 twin）

• TextureIdentity{ ITextureObject* texture, Uint64 lifetimeId }（VkTextureManager.h:126-145），m_textureResources / m_aliveObjects 均以此为主键；hash 混入前端对象地址（:144）。m_syncedTextureMemo[8] 直接以 const ITextureObject* 比较（:708-715，"A dead-then-reused texture address cannot false-hit: the new object carries a new lifetime id"）。
• SyncTexture（VkTextureManager.cpp:1745-1796+）整体裹在 MGPipeTextureLegacyArmScope（:1755）里——注释 :1748-1754 自认："Magma's texture sync still reads - and clears - the CLIENT's mip shadow: the dirty scan below, and UploadDirtyMipLevels' texel reads / region reads / MarkStorageDirty(false) clears"。这是 §2.2 意义上最大的一块：读 client 纹素字节 + 写（清脏）client 存储，guard 是 texture-legacy-arm，scope 内豁免。
• ToStorageMipLevel/ToStorageArrayLayer(ITextureObject*)（VkTextureManager.h:113-126）全树散布，读前端 view 父链。

跨进程：不成立。P5c 只迁了 Espryt 的 sync（走 StagedTextureStore 句柄键），Magma 的 server 侧 sync 是 P7 的活。

5.2 VkBufferManager（缓冲 twin）

• twin 指针直接写进前端对象：bufferObject->SetBackendResource(resource)（VkBufferManager.cpp:305、:601），读出对称（:291、:299）。GetBackendResource/SetBackendResource 是前端 BufferObject 上的 mutable 槽——server 写 client 内存。
• AcquirePersistentMap（:598-646）seed 时读 bufferObject.MappedData()（:631）。
• AcquireResidentSlice（:649-699）/ AcquireStreamedSlice（:701-）：每 draw 调用，含 SyncPersistentMappedRange()（:657/:708）、GetSize()、GetChangeSerial()（:726）、MappedData() 整缓冲上传（:682/:768）。transport 下第一行即 Fatal{buffer-legacy-arm}（见 §0.1）。

跨进程：不成立；且今天是 guarded Fatal，不是静默读。

5.3 draw 路径上的地址键控小缓存

• ConvertedVertexStreamKey.buffer = sourceBufferShared.get()（VulkanRenderer.cpp:4106-4116）+ GetChangeSerial()（:4107）+ MappedData() 转换读（:4127）——UploadAndBindVertexStreams 内，前端 buffer 地址做 memo 键 + 读 client 字节。
• UploadAndBindIndexBuffer 的 restart-index 替换臂：indexBufferShared->SyncGpuWrites() + MappedData() + GetSize()（:4421-4423）——SyncGpuWrites 在 transport 下有反向通道臂（BufferObject.cpp:571-590 起），但那是 client 线程语义；apply 线程调它的行为本次未逐行走通（未知，大概率在 MappedData() 的 guard 处先 Fatal）。
• SetupDrawSnapshot（VR:6388-6470 一带）以 program.GetLifetimeId()、前端 VAO/FBO 的地址与 lifetime id 做键（:6446-6468）。
• UniformManager.h 的 memo 族（SamplerResolveMemo :418 起、FastRebindMemo :363、m_globalUboMemo :392、m_descriptorReuseMemo :341）以 binding + program lifetime id / 版本号做键——键本身是值，但值全部来自前端对象读出。
• ProgramFactory::ProgramLookupCache.program 存前端 ProgramObject*（ProgramFactory.h:582-587）。
• g_programResourceCaches（DirectVulkan.cpp:103-108）以 GL name 为键、lifetime id 校验（:166-189）——GetShaderStorageBlockIndex/Binding（:313/:332，client 侧查询路径）与 ShaderStorageBlockBinding（:714，P5b 的 set_storage_block_binding 记录会经 sink 在 apply 线程到达）都会进 TryGetDirectVulkanProgram（:274-280），后者调 sticky forward ValidateProgramName + GetProgramObject（"P9" 行）——server 按名字探前端名字表，跨进程不成立；GL-name 键控的 cache 本身是 server 内存，成立。

5.4 具名 blit 端点解析（P5c G6 / P5e ruling 12）

• VulkanRenderer.cpp:8974-9022：split 臂从 applier 的 verb 句柄工作区取 ReadFbo/DrawFbo 句柄（:8989-8991），随后 resolveEndpoint lambda 里直接拼写 MG_State::pGLContext（:8997、:9004、:9005）与 MG_Pipe::MGPipeSlots()（:8999、:9003），全程裹 MagmaP7AllocatorDebtScope（:8995）。这是 DirectVulkan 全树仅有的 pGLContext 与 MGPipeSlots() 直接拼写。跨进程：不成立（前端 FBO 池 + client 分配器）。P7 的退役方式注释已写明（:8983-8984："P7 retires it by carrying the object identity in the record"）。
• 附带发现：ARCHITECTURE.md:460 的 C 门原文是 grep -c 'pGLContext' MG_Backend/ == 0，当前 HEAD 实测非零——VulkanRenderer.cpp 3 处代码命中（:8997/:9004/:9005）+ MGPipe/PipeInputs.h:822 一处注释。该门是否仍在 CI 以 ==0 执行、还是已改为白名单，本次未核实（未知）；若仍按字面执行则门已破，值得在 f1 之前确认。

5.5 MagmaPipeIdentityTables（MagmaPipeArms.h:370-529）

Magma 自己的 {slot, gen} mint，按 lifetime id 把前端 VAO/Buffer 映到 server 侧 slot 表（HandleOf :515-518）；VertexInputStateFactory::VaoBackendMemos 以该 handle 为键（VertexInputStateFactory.h:149-171）。表本身是 server 私有内存，成立；但 lifetime id 的获取仍靠读前端对象（vao.GetLifetimeId()），身份源是 §4.1 的字段读—— mint 干净、水源脏。P5f 无需动表，动的是喂它的字段。

6. server 在 apply 线程上创建 / 销毁前端类型对象

• 隐藏 blit 资源：VulkanRenderer.cpp:4475-4491（ShaderObject/ProgramObject）、:4527-4540（两个 SamplerObject）；隐藏 depth-mipmap 资源：:4567-4617。销毁走 ShutdownBlitResources/ShutdownDepthMipmapResources（:4544-4562、:4634-4643），已裹 MagmaP7AllocatorDebtScope（:4559、:4640）——注释自认析构会触发 client death helper 的 lifetime-id 探测。注释 :4552-4553 明说："P7 gives these resources storage that is not a frontend object"。
• UniformManager 占位纹理：MakePlaceholderTextureObject（UniformManager.cpp:167-189，GetFallbackTexture :1410/:1435、GetFallbackMultisampleTexture :1451/:1497-1499 调用），以及 m_unboundStorageImageTextures（UniformManager.h:317）。每构造一个纹理对象都会 MGPipeMintTextureHandle + MGPipeEmitTextureResourceCreate（TextureObject.cpp:143-170，push 构建下无条件 mint）——apply 线程上的 MGPipeSlots().Acquire 无 scope 即 Fatal{RoleViolation, "MGPipeSlots"}（SlotAllocator.cpp:330、:47-59）。也就是说 Magma 的占位纹理在 split 下首次需要时即具名 Fatal（与 ROADMAP.md:127 "占位纹理原生化 → P7" 互证）。ProgramObject/ShaderObject/SamplerObject 的构造不 mint（grep 无命中），故隐藏 program/sampler 的创建本身今天不触发守卫，只有析构的探测被 scope 兜住。

跨进程：不成立（server 进程里没有 MG_Impl/MG_State 的 client 语义，构造出的对象也不该存在）。P5f 处置：随 P7 的"内部 shader 烘焙 / 占位纹理原生化"换成 server 原生资源；f1 双块演习时这些点会以 Fatal 形式自己报出来。

7. 对前端 BufferObject 的直接方法调用（写 client 存储的边）

• bufferObject->MarkGpuWritten() 直写臂已按 P5c ev 改掉：三处都是 #if MOBILEGL_PIPE_PUSH → MGPipeAnnounceBufferGpuWritten(...) / #else 直写 双臂（UniformManager.cpp:1077-1085、:1241-1247；VulkanRenderer.cpp:11774-11781）。announce 内部经 MagmaP7AllocatorDebtScope 做 client 分配器的 lifetime-id 反查（ResourceTracker.h:710-743，:728 是"第四笔债"），找到句柄则走 OnGpuWritten → SEG_EVENT；找不到句柄则回退直写 client 对象（:738）。跨进程：announce 主臂成立；回退臂不成立；scope 内的分配器探测不成立。
• bufferObject->EnsureGpuResidentStorage()（UniformManager.cpp:1077、:1239；VulkanRenderer.cpp:11774）：transport 下早退 return false（BufferObject.cpp:877-880，R-6 的第二道门），但早退之前已读 m_resource.IsGpuResident() / m_isMapped（:856、:866）——无守卫的 client 内存读，今天靠同地址空间成立，跨进程不成立。
• indexBufferShared->SyncGpuWrites()（VR:4421）：见 §5.3。

8. 写 client 存储 / 读 client 镜像的其他站点

• RecordError（写前端错误队列）：VulkanRenderer.cpp:1367、:1371（RecordClearBufferError/RecordTextureCopyError 帮手）、:1427（RecordUnsupportedFramebufferError）、DirectVulkan.cpp:735（ShaderStorageBlockBinding）。transport 下 PipeInputs::RecordError 改走 ServerSessionInstance().PostGlError → SEG_EVENT kEventGlError（PipeFill.cpp:2164-2178），client 在 drain 点入账。跨进程：成立（排序是 P9 的已知债）。
• InvalidateCompileEnv（写前端编译环境）：BackendObject_DirectVulkan.cpp:390（InitCapabilities）、:788（ApplyVulkanCapabilitiesForTesting）。transport 下 PipeInputs::InvalidateCompileEnv 已删除为空操作（PipeFill.cpp:2143-2156，失效改由 caps 重发布完成）。跨进程：成立。
• SwapchainObject 默认 FBO 附件写：transport 下走 OnSurfaceChanged → SEG_EVENT（SwapchainObject.cpp:323-339），monolith 臂仍直写 pDefaultFramebufferInfo 的 AllocateStorage/SetInternalFormat（:342-358）。跨进程：成立（P5c ev / R3 已处理，ROADMAP.md:64）。
• GetTextureImage（VR:11162-11209+）：入口签名直接吃前端 SharedPtr<ITextureObject>（DirectVulkan.h:101 声明、DirectVulkan.cpp:768 入口），内部 SyncTextureAndGetDescriptor(*textureObject)（:11175）+ 无 GPU 存储时回退 MG_Impl::GLImpl::CopyTextureImageToClientOrPBO_State（:11205）——直接调 MG_Impl 函数读 client shadow 写 client 目标缓冲。但两个 GL 入口都是 class C（EmitTables.cpp:1673-1675），split 下 client 先拒绝，今天不可达；若 P9 要放开，这是整条臂的跨进程形状问题，先记着。

9. 值类读取（非债，列出备查）

以下 accessor 在 DirectVulkan 下被读、但属 RECORD_SUPPLIED / APPLIER_DERIVED，跨进程成立，不需 P5f 动作：IsCapabilityEnabled(Indexed)、GetRenderStateParameters(Version)、GetPipelineStateVersion、GetStencilState、GetColorMaskIndexed、GetDepthMask、GetBlendColor/Func/Equation、GetScissorBox、GetViewportIndexed、GetDepthRangeIndexed、GetClearColor/Depth/Stencil、GetActiveTextureUnit、GetCurrentVertexAttribute、GetPatch*、GetPolygon*、GetLineWidth、GetLogicOp、GetCullFaceMode、GetDepthFunc、GetMinSampleShadingValue、GetClampReadColor、GetProvokingVertexMode（VR:13229）、IsTransformFeedbackActive/Paused、GetTransformFeedbackGeneration、GetBoundTransformFeedbackLifetimeId，以及三 shutter GetTextureBindGeneration/GetSamplingResolutionGeneration（VR:6477/:6659/:6907/:6913/:7031/:7050/:7361/:7387 等，P5c rv 起 APPLIER_DERIVED，server 自答）。g_dynamicStateShadow（VR:290-409）是纯 server 侧 memo，成立。

10. 未知 / 留给 fm 的问题

1. Magma 的 program 内容（SPIR-V、UBO 初值）是否已有记录载体（类似 Espryt 的 ProgramArchive）——本普查未在 wire schema 侧核实；若没有，4.6 是 fm 最大的一块。
2. SyncGpuWrites 从 apply 线程在 transport 下的实际行为（BufferObject.cpp:590 起的臂是否假设 GL 线程）。
3. ARCHITECTURE.md:460 的 C 门是否仍以 ==0 执行（当前实测非零，见 §5.4）。
4. indirect draw 无绑定缓冲（client 指针）时，记录在 wire 上如何携带命令字节、server 端 ResolveIndirectCommandBytes 的 client 指针解引用在严格双块下的归类（指针随记录过来，值无意义——大概率走 client-memory 升级的具名拒绝，待 f1 的红来确认）。
5. GetTexImage/GetTextureImage 若 P9 放开，VR:11162 起的整条前端对象签名链需要重新设计（§8）。