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

59 lines
7.8 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 集成交接(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. 机械步骤(每包相同)
```bash
# 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`。