完善 xyzbc-trt OPFS 与 AXIS 首屏等效

web-rtcp-5axis-xyzbc-trt-sim-plan/working/03-推进台账.md

@@ -1,5 +1,51 @@
 # 03-推进台账
 
+## 2026-07-02 Web OPFS 强制与 AXIS 首屏等效实现轮次
+
+### 本轮目标
+
+接续用户要求“Web 的文件使用 OPFS 系统”，把浏览器端 machine files、session snapshot、tool table 保存链路从可 fallback 改为目标 app 默认强制 OPFS，并完成 T-026 AXIS 首屏等效验收。
+
+### 已做事项
+
+- 修改 `app/src/runtime/linuxcnc-machine-file-staging.js`：
+  - `saveMachineFileStagingPlan()` 的存储解析支持 `requireOpfs`。
+  - 当目标 app 要求 OPFS 但浏览器缺少 `navigator.storage.getDirectory()` 或非安全上下文时直接报错，不再静默落到 memory fallback。
+- 修改 `app/src/runtime/five-axis-session.js` 和 `app/src/runtime/tool-db-simulation.js`：
+  - session snapshot 与 tool table 保存同样支持 `requireOpfs`。
+- 修改 `app/src/state/store.js` 和 `app/src/main.js`：
+  - 浏览器 UI 默认对 machine file staging、session save/restore、tool DB save 启用 `requireOpfs=true`。
+  - Node/测试显式传入 storage 时仍保留内存存储能力，用于非浏览器 smoke。
+- 修改 `tests/browser/xyzbc_trt_browser_smoke.html`：
+  - 断言启动 staging `storageMode=opfs`。
+  - 从 OPFS 读回 `xyzbc_switchkins.ngc`，确认包含 `M428/M429`。
+  - 保存并从 OPFS 读回 session snapshot，确认包含 `machineProfile=xyzbc-trt`。
+  - 保存并从 OPFS 读回 tool table，确认包含 `T2/Z10`。
+  - 断言 AXIS 首屏区域 dataset 和能力矩阵。
+- 修改 `app/src/ui/gmoccapy-shell.js` 与 `app/src/styles/gmoccapy.css`：
+  - 增加 AXIS 首屏等效状态带，覆盖 program、coordinates、status、MDI、switchkins、override、tool、preview、execution、axis-buttons。
+  - 各首屏区域输出 `data-axis-ui-section/profile/coordinates`，供浏览器验收。
+- 修改 `tools/collect-web-xyzbc-trt-evidence.mjs` 与 `tools/compare-xyzbc-trt-evidence.mjs`：
+  - 新增 `axisMainUi` evidence 和 compare 检查。
+  - Web evidence 中 Node 采集仍使用 memory storage；真实浏览器 OPFS 以 `smoke:browser` 为准。
+- 更新 `04-任务矩阵.md`：
+  - T-006/T-014/T-016 增加真实 OPFS 验收描述。
+  - T-026 标记为完成。
+
+### 验证情况
+
+- `npm --prefix web-rtcp-5axis-xyzbc-trt-sim-plan/app run smoke:node` 通过。
+- `npm --prefix web-rtcp-5axis-xyzbc-trt-sim-plan/app run build` 通过，输出 `gmoccapy_static_build=ok`。
+- `npm --prefix web-rtcp-5axis-xyzbc-trt-sim-plan/app run smoke:browser` 通过，输出 `xyzbc_trt_browser_smoke=ok`，其中已验证 OPFS 写入和读回。
+- `npm --prefix web-rtcp-5axis-xyzbc-trt-sim-plan/app run evidence:web` 通过。
+- `npm --prefix web-rtcp-5axis-xyzbc-trt-sim-plan/app run evidence:compare` 已生成真实失败报告：当前 20/25 通过；新增 AXIS 首屏检查通过，剩余 5 项仍来自 native preview/execution path 样本缺失。
+
+### 下一步
+
+1. 继续 T-019/T-037：在 `/home/mes123456/cnc_wams/linuxcnc/scripts/rip-environment` 下重跑 native evidence，使 native path 进入 20ms 可比状态。
+2. 继续 T-028/T-030：补 basic_sim 等效 task/HAL 细节和 Ngcgui/remap 子程序执行验收。
+3. 继续 T-038：基于真实 native 状态流复核 Web 按钮、HAL pin、路径和状态联锁。
+
 ## 2026-07-02 Tool table 到 tool-offset 闭环实现轮次
 
 ### 本轮目标