Files
MobileGL/docs/Disaggregated/notes/p7/HANDOFF-2026-09-22.md
T

7.8 KiB
Raw Blame History

P7 集成交接(2026-09-22 夜,集成者会话收尾)

这一页是给接手 agent 的机械清单:哪些已落地、哪些在跑、哪些没做完、每一步的命令。裁定与数字见 INTEGRATOR-DECISIONS-P7.md(到 ID-P7-43)、CURRENT_STAGE_STATUS.md、MG_Remote/CONTRACT-P7.md。

0. 铁律(不变)

  • 只在 WSL ~/w7/pipe(集成树)和各 ~/w7/p7-<slug> 包树工作;绝不碰 Windows 主 dev 树 …\FoldCraftLauncher\MobileGL;Windows 侧只用 worktree …\MobileGL-disagg。
  • 绝不从 Windows 经 UNC 对 ~/w7/pipe 跑 git(会留下 .git/index.lock);git 只在 WSL 里跑。
  • 推送只按 SHA:git fetch wslpipe feat/disaggregated && git merge --ff-only FETCH_HEAD && git push origin <sha>:refs/heads/feat/disaggregated(Windows worktree)。
  • 提交禁止任何 Co-Authored-By 尾注(用户明令;scratchpad/pick.sh 在 --amend 时自动剥)。
  • 性能只记录不做门;不顺手修 dev 的 bug;每包一次 fable 审查;rule I / J / G1 / G14 见 CONTRACT-P7 §0。
  • 给子代理的 prompt 必须先写明层级(常设指令 + 「最新一句已由集成者执行」),否则它们会把用户最新一句当唯一指令拒做;需要 Opus 5.5 时走 Workflow model:"claude-opus-5-5"(Agent 工具的 opus 仍是 Opus 5),本轮因拒做问题全部改走 Agent 工具 + fable。
  • wsl.exe -d Arch -- bash -lc '…$x…' 会吞 $var:一律写脚本文件再 MSYS_NO_PATHCONV=1 wsl.exe -d Arch -- bash /mnt/c/…/x.sh;长输出别 | head(SIGPIPE 会杀脚本),重定向到日志再看。

1. 现状(本会话结束时)

  • origin/feat/disaggregated = 87584d0b(尾注已改写;B2 r1/r2、B3 返工 + 修复轮、V1、F 片 1–3、E1)。
  • 集成树 ~/w7/pipe 头 = 见 git log(B3 修复 r2/r3、V1 修复轮、B2 r3/r4、M2、F 修复轮、docs 到 ID-P7-43);每一步的门都全绿(唯一红 = InitialCapsStartup.ANullInitialSnapshot… flake,X2 在修)。推送时机:接手者先跑一次 ~/w7/logs/p7-gate-template.sh(sed s/TAG/<tag>/g),绿即推。
  • 手机(Redmi 2f7cbe2e):装的是 p7w5(top.mobilegl.plugin.p7w1.trace),supervisor 0.0.0.0:40613,token p7w1b-lan-token-20260922;主机侧同 stamp 制品 ~/w7/logs/p7w5host/host/(树 ~/w7/p7-w5host)。
  • 用户已加 WSL 路由 192.168.21.181/32 via 192.168.31.1 dev eth0(重启 WSL 会丢,需重加)。

2. 在跑的 agent(结果会写到 ~/w7/notes/handoff/)

名 树 / 产物 接手动作
M2 审查 ~/w7/notes/handoff/review-m2.md(verdict land with fixes,一条 must-fix:memo 句柄复用 ABA) 已派 M2 r2(fable)修;结果 ~/w7/notes/handoff/m2-r2.md
M2 r2(fable) ~/w7/p7-magma-m2 在 6f67fd7f 之上的新提交 cherry-pick → 门 → 审查 → 推
F 修复轮审查 ~/w7/notes/handoff/review-f-fix.md 按 verdict 派修复轮或落地
B3 r3 + B2 r4 审查 ~/w7/notes/handoff/review-b3r3-b2r4.md 同上
V1 修复 r2(fable) ~/w7/notes/handoff/v1-fix-r2.md,树 ~/w7/p7-verify-split 在 723bb93f 之上 cherry-pick → 门(含 verify 构建)→ 审查
X2 flake(fable) ~/w7/notes/handoff/x2-caps-flake.md,树 ~/w7/p7-x2-caps-flake cherry-pick → unit 门
窗口 1b 矩阵 ~/w7/logs/p7w1b/paced.log(=== ALL DONE 结束)、~/w7/logs/p7w1b/paced/pass{1,2}/<case>/(driver.log、client log、phone-logcat.txt) 写 notes/p65/window-1b-p7w5.md(每例状态 / 原因 / 两遍是否一致;已知:main-menu 类 server 死亡、OpenRA 偶发 ReadbackDeclined、1.21.11-main-menu 超时)+ ID + CONTRACT-P7 §7

3. 机械步骤(每包相同)

# 1) cherry-pick(自动剥尾注;有冲突会停)
bash ~/w7/notes/tools/pick.sh <worktree-name> <base-sha> <sha…>       # 脚本在本会话 scratchpad,或重写:逐个 cherry-pick + amend 掉 Co-Authored-By
# 2) 门(模板:build-split + build-linux G1 + census + ratchet + parity + 八车道 + 审计 + OpenRA split 回放 + verify 构建)
sed 's/TAG/<tag>/g' ~/w7/logs/p7-gate-template.sh > ~/w7/logs/p7-gate-<tag>-inner.sh
sed -i '2i export MOBILEGL_FLATC_EXECUTABLE=/home/swung/w7/flatc-build/flatc' ~/w7/logs/p7-gate-<tag>-inner.sh
rm -f ~/w7/pipe/build-split/Testing/Temporary/LastTestsFailed.log
setsid nohup bash ~/w7/logs/p7-gate-<tag>-inner.sh > ~/w7/logs/p7-gate-<tag>.log 2>&1 < /dev/null & disown   # 等 "=== DONE-VERIFY"
# 3) 审查:fable、只读、按 file:line 出 verdict(land / land with fixes / rework)
# 4) 文档:INTEGRATOR-DECISIONS 加一行 ID、CURRENT_STAGE_STATUS §1/§2/§4/§5、ROADMAP P7/Ph/P3b 行、CONTRACT-P7 §12 抄包 note 的债;
#    python3 scripts/check_doc_citations.py --rev HEAD --strict docs/Disaggregated/*.md docs/Disaggregated/notes/p7/INTEGRATOR-DECISIONS-P7.md MobileGL/MG_Remote/CONTRACT-P7.md
# 5) 推送(Windows worktree):git fetch wslpipe feat/disaggregated && git merge --ff-only FETCH_HEAD && git push origin $(git rev-parse HEAD):refs/heads/feat/disaggregated

pipe 的 tcp fixture 端口是 40713(build-split)、40714(build-verify),别改回 40613(会撞包树的 fixture)。

4. 没做完的(按优先级)

  1. M2 r2 must-fix 落地(见 §2)——在它落地前,wire 臂有一处已知的中帧 use-after-free 可达点(memo 按裸 VkBuffer 句柄命中)。
  2. p7w6 APK + 手机 server 重部署:sed 's/p7w5/p7w6/g' ~/w7/logs/p7w5-apk-inner.sh > ~/w7/logs/p7w6-apk-inner.sh(在 pipe 头上跑;stamp p7w6-<head>;产物 ~/w7/logs/p7w6/trace-p7w6.apk;adb install -r;tcp_device_server.py start …(见 supervisor-start.sh,改 token ≥16 字节)。F 改了 wireFingerprint:旧 server + 新 client 只会 no Welcome (rc=6)。然后:bsl-esc-menu-854 DirectVulkan pbuffer spawn + inproc 各 3 遍(M2 的设备验收,记 maps 与 wbuf[] 行)、窗口 1b 用 p7w6 重跑一遍(对照 DataBind 是否消除 250 ms 配对窗口)、门 3 终局(分母 36:三遍逐位 + spawn 臂同会话,run_android_retrace_local.py --matrix --backend DirectVulkan --use-pbuffer --transport inproc|spawn --repeat 3)。
  3. M3:descriptor set 在长帧内无界(UniformManager::AcquireDescriptorSet 只在 BeginFrame/drain 回卷)——按 submit-index 证明回卷每个 layout 的游标;review-m2.md 域外 (b)。
  4. B4:WaitForSubmitsUpTo 聚合等待 + WaitForFrameSerial 的「答 true 而未完成」(restart 不 continue,且不再读 record)+ 两处陈旧注释 + CollectGarbage/pruneWire 在 wire 臂从不执行(VulkanRenderer.cpp SetupDraw)+ §12 裁判点名的 Magma 债。
  5. F2:D11 五处 + PH-2、PH-6 drop-with-latch、PH-1 (3)(4)、PH-7 (5) fork 前认证——前置是能向 spawn/TCP server 投递畸形记录的对端字节驱动(fuzz 臂 2 第一块);ServerSpawn.cpp 清洗名单补 Ipc.SpinUs/ServerAffinity/Audit(M2 r2 顺带)。
  6. wave 3:棘轮 88 = monolith draw 路径的 #if(link_ratchet.py --bucket,notes/p7/magma-b2.md §4.3 逐符号点名)。
  7. wave 4:CTS AFTER(inproc × DV 五块 vs notes/p7/device-window-1/CTS-base/,≤0.5 pp,新增 crash = 0;tools/cts/caselists/,设备 /data/local/tmp/mgcts)。
  8. wave 5:fuzz 三臂、P7 收官异模型整体审查(ID-66)。
  9. 小件:retrace_gate.py 只覆盖 monolith 条目——pipe 门现用 ~/w7/logs/pipe-retrace.sh(借 ~/w7/p7-magma-b3/build-split/tools/trace_replay/mobilegl_trace_replay);把 MOBILEGL_BUILD_TRACE_REPLAY=ON 配进 pipe 的 build-split 后可删这层借用。P5D-INPROC-PERFORMANCE.md 的 Adreno 数字重取(§12)。测量树 ~/w7/m2-meas*、~/w7/rev-* 可删。
  10. 文档同步:Claude Docs 主进度页(34576d4c-…)每次落地一段;记忆文件 disaggregated-plan.md。