P12「server 自有屏幕窗口」子集 — 计划与交接（2026-09-24）

接 P7 收官（../p7/HANDOFF-2026-09-23.md）。基线 feat/disaggregated@9f669e52。包树 ~/w7/p12-onscreen，分支 p12/onscreen（从 9f669e52 分出，15 个 (P12) 提交）。任务书 BRIEF-onscreen.md，只读审计 map-*.md（四份），本页是交接与余项。

1. 这一包做了什么

按用户裁定（BRIEF-onscreen.md §User rulings，四条）：Android 上的 server 自己创建 ANativeWindow（自己的 SurfaceView），把 IPC 渲染流渲染到屏幕上；离屏（pbuffer）与上屏两条路径都保留， 同一时刻只有一条活跃，在 server 初始化 / context 创建时决定；拓扑为进程内 server——display Activity 自己的进程里用一个线程跑 TCP server 并直接渲染进它的 SurfaceView，会话在该进程内串行；client 侧用一个 新的 WindowKind::ServerOwned 接入，且此模式下 client 完全无头（eglCreateWindowSurface 接受 NULL），窗口几何由 server 回传。

落地的形状（15 提交，53 文件，+4566/−110）：

面	内容
wire	`WindowKind::ServerOwned = 7`（fbs 追加）、控制修订 2 → 3、`SurfaceRefusal` / `SurfaceReply`（width/height/refusal）、codec 的 ServerOwned 规则（仅 `CreateWindowSurface`、`nativeToken == 0`、`SetWindowHandle` 具名拒绝）、非零 token 的 latch 行
server 窗口	`MG_Remote/Server/ServerDisplay.{h,cpp}`（不透明窗口 + hooks + lease + 有界 `Detach`）、ServerOwned 臂的 one-mode-per-session latch、无显示时的具名拒绝、失窗在 apply 线程释放、`ServerWindowLost` 家族行
client	`MOBILEGL_IPC_SURFACE=server`（`Config.h` / `ConfigLoader.cpp`）→ 无头窗口 surface、一次 ServerOwned `CreateWindowSurface`、不发 `SetWindowHandle`、geteometry 进 EGL state 后才返回
进程内 server	`RunSession` 改为返回退出码、`TcpSupervisor` 把已认证会话交给线程（Busy / 会话间 `ResetSessionLatch` / 后端按进程钉住 / 非阻塞 stop）、fork 出的会话子进程 `PR_SET_PDEATHSIG` 随监督进程去
Android	`MobileGLDisplayActivity`（`:mglwin`，全屏 SurfaceView，aspect-fit，env 在库加载前应用）、display server 的 JNI（`DisplayServerJni.cpp` + 几何 up-call）、与 `MobileGLServerService` 共享环境、同一时刻只有一个 server（Activity 停 service，service 杀 `:mglwin`）
工具	`tcp_device_server.py --surface window\|pbuffer`、Linux glws 的 `MOBILEGL_TRACE_SURFACE=window`
Espryt	远端会话的 window-surface extent 随其默认 framebuffer 格式发布（仅 split 构建，pull 构建不动；G1）

2. 门与证据

G1（硬约束）：pull 构建 .text 0xa52203 不变、符号 0 增 0 减。门日志 gate/gate-android1.log 报 a52203，但那一行印的是 added=30570 removed=30570——这是错的读法：比较基准 ~/w7/logs/p12/pull-syms-base.txt 是用 nm --defined-only … | awk '{print $3}' 生成的（每个目标文件的符号头行 + 符号），而比较时用的是无 awk 的全量 nm 输出，两边不同源，于是"全部新增又全部删除"。交接时已独立复核：在 ~/w7/pipe（pull 构建，恰在 9f669e52）与 p12-onscreen 两个 build-linux 上直接 nm --defined-only | awk '{print $3}' | sort 后 comm，added 0 / removed 0，符号集各 30570 全同； readelf -S 两边 .text 都是 a52203。G1 成立；门脚本的那一行输出应在 P12 收尾时修好（见 §4）。

主机门（gate/gate-android1.log，head 29b7b284，dirty=0，2026-09-24 00:55–01:04）：

unit 2601、integration-split 322、spawn 239、tcp 243、magma-split 125、magma-spawn 104、magma-tcp 89、 integration-gpu 2188 × 2（monolith / inproc）全绿。
integration-magma-full-split 558 报 1 红（IterationRPProgram203Scenario 的 exposure texel）。这不是本包引入的：交接时独立复核，用 ctest 注册的那组环境变量直跑该用例，p12-onscreen 3/3 绿、mismatches=0/262656；整条车道 -j 8 重跑两遍也 558/558 绿。它是既有/环境敏感项，树上早有记录：../p05/p05-results/value-types-v1.md 判为构建目录 configure 差异（MG_IntegrationTest/CMakeLists.txt 只在 MOBILEGL_ITEST_VK_ICD 匹配 lvp_icd|lavapipe 时才挂三个 MOBILEGL_MAGMA_* 修复开关），../p7/magma-a.md §6.2 记它在该 worktree 3/3 稳定红且还原后端改动照样红，../p7/INTEGRATOR-DECISIONS-P7.md ID-P7-22 改判为"环境敏感而非 tcp 专属"。 p12-onscreen 两个 build 目录的 MOBILEGL_ITEST_VK_ICD 都已钉到 lavapipe，ctest -N -V 确认注册时带着三个修复变量。
卫生 12 项全 OK；fatal census 79 / link ratchet 171 不变；parity 0；protocol revision pin 报 revision 3 holds。

真机（Redmi 2f7cbe2e，Adreno 830，证据 device/，device/evidence-strip.png 为九格拼图）：七个编号检查在两个 head（984db455、a4a940db、29b7b284）上跑过，trial-*/ 是按 head 归档的旧轮次。

#	检查	结果
1	Espryt 上屏（OpenRA，`--window-surface`，`MOBILEGL_IPC_SURFACE=server`）	ssim 1.000000；server 日志 `surface=window 640x480 owner=server`；屏幕截图非黑
2	Magma 上屏（OpenRA）+ 同进程第二个会话（`minecraft-1.21.4-startup`）	ssim 1.000000 / 0.999999511；两臂都 `owner=server`
3	串行第二会话 + `Refuse{Busy}`	第二会话绿；并发客户端拿到 `Refuse{Busy}`（rc=134）后长会话照常收尾绿
4	失窗（`surfaceDestroyed`）	`Fatal{ServerWindowLost}` → 会话 latch → client 读干净 device lost；Activity 回来后新会话 ssim 1.0，`:mglwin` 存活
5	离屏 service（不带旋钮）	ssim 1.0，`surface=pbuffer 640x480`（离屏路径未被破坏）
6	负控：`MOBILEGL_IPC_SURFACE=server` 打离屏 server	双侧具名 `Refuse ServerOwned (NoServerDisplay)`；随后同 service 的离屏会话绿
7	一台设备上只有一个 server	Activity 起来杀 service、service 起来杀 `:mglwin`，互相都验证了

审查后复测（`feat/disaggregated@1fb18d9e`，2026-09-24）

审查修复后的同一 P12 实现 head 已在 Redmi 2f7cbe2e（Adreno 830）重建并复跑七项检查。结果与上表一致：Espryt OpenRA SSIM 1.000000；Magma OpenRA / Minecraft startup 1.000000 / 0.999999511；串行第二会话和 Refuse{Busy} 通过；HOME 失窗得到 ServerWindowLost 干净 device-lost，surface 释放 15 ms，Activity 存活且重附后新会话 SSIM 1.0；pbuffer 与 NoServerDisplay 负控通过；Activity / service 互斥通过。第 6 项初次尝试与上一会话回收竞态命中 Busy；临时测试副本等待 2 秒后重跑，双侧具名拒绝和后续 pbuffer 会话均通过，仓库脚本未改。

审查后主机 P12 定向 CTest 46/46 通过：ServerDisplayTest、ServerLoopTest、InProcessServer、SupervisorChildren、ServerOwnedSurface。这组定向测试不等于完整主机门。证据在测试机 /home/swung/w7/logs/p12-verify-1fb18d9e/；日志、APK 和截图按证据数据规则未入仓库。当前 0fe01588 相对验证 head 只有文档整理及文档检查配置更新。

3. 收官处置（2026-09-29）

两个出口门都过了（(b) CROSSHOST-ACCEPTANCE.md、(a) FCL-ACCEPTANCE.md），MG_Remote/CONTRACT-P12.md 已写，gate.sh 的 G1 已改。ROADMAP P12 行与任务书里原先"未落地"的每一项，处置如下：

项	处置
in-process server 的 `unix:` 监听	✅ 已做（`c16fb5a8a`）
FCL env 与 plugin APK 开关表接线	✅ FCL 走 `/sdcard/FCL/mg_env.txt`；plugin / trace 两个 APK 都带 Render Server 屏与二进制（`1987bdff5`）；FCL fork 新增版本设置「游戏退到后台时不暂停」（FCL 仓库，已提交 `241471515`）
DirectGLES `g_Display` / `g_Surface` / `g_Context` 去全局	不做：每进程一个会话时不需要 → `DEBTS.md`
cached-app freezer 的完整处理	不做：文档从未定义它；FCL 后台暂停的实测答案见契约 → DEBTS
多 context	不做（同上）→ DEBTS
D8 窗口种类白名单（拒 X11 / Win32Hwnd / None）	不做：仍接受并把 token 强转为指针 → DEBTS（无主，等 Windows / X11 client）
TLS	仍开放 → DEBTS
逐条裁定日志	✅ `INTEGRATOR-DECISIONS-P12.md`（ID-P12-1..15）
文档债（`ARCHITECTURE.md:526` 旧路径、`protocol.fbs` 旧注释、`CURRENT_STAGE_PROGRESS` 的"real windows cross processes"）	✅ 已清（设计文本已迁到 `design/`，`design/08-runtime-and-platform.md` 记上屏路径与几何）
IPC 顺序两处说法不一致	✅ ROADMAP 现为 P5 … P6.5 → Ph → P12 → P9 → P10 → P11
`IterationRPProgram203Scenario`	ID-P12-12：按"既有、环境敏感"读，不阻塞
a6 行 A8-3…A8-15 与 CONTRACT-P6 §7.2 D8 的逐行处置	由契约与裁定日志覆盖，没有逐行列出
收官审查	用户裁定（2026-09-29）不派 agent / Codex 审查；由本人核对契约断言（发现两处措辞错误已改）并跑 G1
G1	G1（Arch，clang++，pull 构建，`6e35ea2c`）：`.text` `0xa52203` = 基线，符号增 0 减 0

4. 收官前立刻做过的

gate.sh 的 G1 只在同机同编译器的基线上比较，否则说"未比较"并给做法，不再印无意义的 added / removed。
notes/p7/INTEGRATOR-DECISIONS-P7.md 里一条指向已缩成索引的 ARCHITECTURE.md:531 的引用改到 design/08-runtime-and-platform.md:7（文档引用门原先在 HEAD 上红）。

5. 工装在哪

任务书与审计：本目录 BRIEF-onscreen.md、map-apk-process.md、map-client-surface.md、 map-docs-contract.md、map-server-surface.md。
门与包树：gate.sh、setup-tree.sh、fix-icd.sh、g1-base-names.sh、p203.sh；主机门日志 gate/。
真机：android/（dev.sh、check1/3/4/5/7.sh、final-run.sh、precheck.sh、redonce-tools.sh、 redonce-twins.sh、hostrepro.sh、verify-apk.sh 等），证据 device/。
没进仓库的（按 ../notes/README.md "证据数据"的规则）：~/w7/logs/p12/device/**/logcat*.txt 等约 66 MB 设备日志、APK、pull-syms-base.txt*（2.5 MB nm 转储）。要复核请去产生它们的机器。

10 KiB Raw Blame History Unescape Escape