Stabilize machine manager WebGL resources

docs/glb-machine-manager/03-推进台账.md

@@ -26,6 +26,14 @@
 - MILL700 验证 132 节点、126 网格、深度 6 的树显示；选择 `MILL700-A-主轴-JT2` 得到父级局部原点 `X=-3.969, Y=-204.276, Z=405.633 mm`；内部节点拖放及八部件根节点拖放通过。
 - 为避免大模型选择卡顿，树选择只更新坐标面板；预览使用共享只读几何/材质的节点克隆，层级变更后才重建变换树。MGR-12 verified。
 
+## R06 / 2026-09-20 / WebGL framebuffer 稳定性
+
+- 用户截图显示 `texImage2D width or height out of range`、`glRenderbufferStorageMultisample` 超限和 framebuffer zero-size 连续错误，导致层级管理界面不稳定。
+- MILL700 三张纹理实际为 `1024x1024`、`1604x1205`、`1604x1205`，不是纹理超限；风险来自特定 GPU、DPR 和 DevTools 短视口组合下的多重采样 drawing buffer。
+- 管理器 WebGL renderer 关闭 MSAA，读取 `MAX_RENDERBUFFER_SIZE`、`MAX_TEXTURE_SIZE` 和 `MAX_VIEWPORT_DIMS`，按 90% 安全边界及最多 4096² 像素动态降低 DPR；宽高不足 2px 时暂停 resize/render。
+- 发布 `render-state`、实际 pixel ratio、buffer size 和 GPU 上限诊断；context lost 后停止动画循环，避免重复 framebuffer 错误刷屏。
+- 模拟页面 `1154x220`、DPR 3：CSS `656x655`、drawing buffer `984x982`、GPU 上限 `8192`，控制台警告/错误 0。MILL700 层级树及 AC/BC 生产回归通过。MGR-13 verified。
+
 ## R02 / 2026-09-20 / 部件装配、标定、应用与验收完成
 
 - 新增 `machine-manager.ts`：通用自包含 GLB 部件加载、SHA-256、深复制、八角色和两条机械链校验、AC/BC URDF 生成、组合场景、底座/整机 userData、组合哈希。

docs/glb-machine-manager/04-任务矩阵.md

@@ -14,3 +14,4 @@
 |MGR-10 PBR 预览照明|verified|MGR-04|高金属度 GLB 在管理器中具有可辨识表面；PMREM、色彩空间、曝光和多向补光生效|
 |MGR-11 Z-up 机床坐标|verified|MGR-04,MGR-05|`camera.up=(0,0,1)`，机床 Z 竖直、XY 地面；导入模型信息和原始变换不修改|
 |MGR-12 GLB 层级树管理|verified|MGR-02,MGR-04|原始层级按 tree 显示；根/内部节点拖放、循环拒绝、节点原点坐标和 MILL700 深层结构验收通过|
+|MGR-13 WebGL 资源稳定性|verified|MGR-10,MGR-12|禁用超限 MSAA；drawing buffer 按 GPU 上限和像素预算缩放；零尺寸/context lost 不连续绘制；短视口 DPR3 无警告|

docs/glb-machine-manager/05-验收证据.md

@@ -16,8 +16,8 @@
 - 状态：verified；浏览器错误 0。
 - 覆盖：8 部件导入和预览、原点显隐、数值/TransformControls 变换、组合 GLB 导出、AC/BC 应用、底座 userData、物理零点、非法层级拒绝、BC 五轴程序。
 - 截图：
-  - `coverage/glb-machine-manager/manager-ac-config.png`，SHA-256 `70238293d81a0063e413d4bf3b2b0f0bc4c8453e45256e32fb625ff9e92b9609`
-  - `coverage/glb-machine-manager/managed-bc-running.png`，SHA-256 `6e14ff6bc4e493f57e55bb601ded84319ce86f064f7a811595c1e4498b1827a0`
+  - `coverage/glb-machine-manager/manager-ac-config.png`，SHA-256 `6e53968722744d8fc4dc753d83ee8bad3c6c3ce0d41c34d64214b5586faf2dc5`
+  - `coverage/glb-machine-manager/managed-bc-running.png`，SHA-256 `2a28290ff58b3a0d3250ee5ebb1bc636a2cc8b8f62828b41764435501f97d385`
 
 ## E03 / R02 / 生产构建浏览器闭环
 
@@ -46,7 +46,7 @@
 - report_id：`GLB-MGR-E05`；报告 SHA-256 `7c479b36396abc6f7466ed8b54cc83216dd72c30ba11fa0c667e6491d47c2171`。
 - 结构：132 节点、126 网格、深度 6、126 材质，其中 110 个 `metalness >= 0.9`。
 - 检查：已有内部层级完整保留；管理器使用 `studio-pmrem`、sRGB 输出、ACES、曝光 `1.45` 和多向补光；浏览器错误为 0。
-- 截图：`coverage/glb-machine-manager/mill700/mill700-studio-lighting.png`，SHA-256 `e741ae55623f28399565c4296e5d679a71fba346232ce043edc5ab0c8901d6b4`。
+- 截图：`coverage/glb-machine-manager/mill700/mill700-studio-lighting.png`，SHA-256 `289255511eccce697ec0c6f002a44588475e9042fa12f23646ea02c4c63a3b60`。
 
 ## E06 / R04 / Z-up 坐标
 
@@ -62,3 +62,11 @@
 - 拖放：`MILL700-A-门1-JT1` 拖到 `MILL700-A底座` 后，草稿父路径等于目标稳定源路径；原始 GLB SHA-256 保持 `bf37130681cc6462412e52744519516e8ade2a3212dd69153c0b1b3e415bcf66`。
 - 八个独立 GLB 的根树节点拖放通过；随后 AC/BC 应用、导出和程序运动回归仍通过。
 - 控件契约：101 个控件，新增 `machine-tree-node` 和 `machine-tree-origin`；TypeScript、生产构建、双画布测试通过，浏览器错误 0。
+
+## E08 / R06 / WebGL framebuffer 稳定性
+
+- 状态：verified。
+- 触发环境：页面 viewport `1154x220`，deviceScaleFactor 3，模拟底部停靠 DevTools 和高 DPI。
+- 修复后：管理器 CSS `656x655`，drawing buffer `984x982`，`MAX_RENDERBUFFER_SIZE=8192`，MSAA=false，控制台 warning/error=0。
+- renderer 诊断字段：`machine-manager-webgl-antialias=false`、`render-state=ready`、动态 `pixel-ratio/buffer-size/max-buffer`。
+- MILL700 132 节点树选择/拖放通过；生产 AC/BC 管理器闭环通过，浏览器错误 0。

docs/glb-machine-manager/06-决策记录.md

@@ -39,3 +39,7 @@ UI 允许用户选择父级以建立层级和发现错误；应用时只接受
 ## D10 / 层级编辑使用稳定源路径覆盖
 
 GLB 树节点 ID 使用导入时的子节点索引路径，不使用可能重复或缺失的节点名称。拖放保存 `sourcePath -> targetPath` 草稿覆盖，每次从原始场景克隆后应用，因此重复编辑稳定且不污染导入资产。根 GLB 之间继续使用部件 `parentId`，内部节点不允许跨 GLB 直接重挂。
+
+## D11 / 管理器优先保证 framebuffer 可创建
+
+管理器不依赖 MSAA；高 DPI 清晰度由受限 DPR 提供。drawing buffer 必须同时满足 GPU 维度上限和 4096² 像素预算，不能把异常 DOM 尺寸直接传给 WebGL。零尺寸和 context lost 视为暂停状态，不继续调用 render 产生重复错误。

docs/glb-machine-manager/README.md

@@ -11,7 +11,7 @@
 
 现有整机 GLB + 内嵌 URDF 导入能力继续保留。新管理器生成与现有 `linuxcnc.machine/1` 相同的严格结构，再通过已有配置、Worker、WASM 和 Three.js 投影链运行。
 
-当前状态：MGR-01 至 MGR-12 全部 verified，MILL700 实测覆盖照明、Z-up、132 节点层级树、拖放和节点原点。最新台账 R05，浏览器证据 `GLB-MGR-E01/E02/E05/E07`，截图和报告位于 `coverage/glb-machine-manager/`。
+当前状态：MGR-01 至 MGR-13 全部 verified，MILL700 实测覆盖照明、Z-up、132 节点层级树、拖放、节点原点和 WebGL 资源降级。最新台账 R06，浏览器证据 `GLB-MGR-E01/E02/E05/E07/E08`，截图和报告位于 `coverage/glb-machine-manager/`。
 
 文档：