Improve GLB manager lighting for metallic models

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

@@ -1,5 +1,15 @@
 # 推进台账
 
+## R03 / 2026-09-20 / 管理器 GLB 预览亮度修复
+
+- 用户反馈三维机床管理器导入 GLB 后模型太黑。
+- 根因：管理器使用 MeshStandard/Physical PBR 材质，但独立编辑场景没有环境贴图、输出色彩空间和色调映射，高金属度部件几乎只能反射黑色背景。
+- 修复：增加 RoomEnvironment → PMREM 工作室环境、sRGB 输出、ACES Filmic tone mapping、1.45 专用曝光，并增加半球光、环境光、暖主光、冷补光和轮廓光；背景和网格提升为中性工作区灰色。
+- 原 GLB 的 color、metalness、roughness 和纹理不改写；运行模型材质也不受影响。
+- 使用仓库根目录 `/home/mes006/linuxcncWebWASM/MILL700-U_1.glb` 实测：9,418,852 bytes，SHA-256 `bf37130681cc6462412e52744519516e8ade2a3212dd69153c0b1b3e415bcf66`；132 节点、126 网格、最大层级深度 6，110 个高金属度材质。
+- E05 浏览器验收通过，截图显示原有 MILL700 层级模型在管理器中可辨识；报告和截图位于 `coverage/glb-machine-manager/mill700/`。
+- 当前任务：MGR-10 已验证，等待保存和发布。
+
 ## R02 / 2026-09-20 / 部件装配、标定、应用与验收完成
 
 - 新增 `machine-manager.ts`：通用自包含 GLB 部件加载、SHA-256、深复制、八角色和两条机械链校验、AC/BC URDF 生成、组合场景、底座/整机 userData、组合哈希。

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

@@ -11,3 +11,4 @@
 |MGR-07 控制面板接入|verified|MGR-03,MGR-06|“三维机床管理”入口；应用复用 LOAD_WORKSPACE/PROGRAM_LOAD，失败不改旧模型|
 |MGR-08 坐标一致性|verified|MGR-07|AC/BC 的 X/Y/Z/A或B/C、刀长、工件和路径由 WASM 状态正确驱动|
 |MGR-09 浏览器验收收口|verified|MGR-04,MGR-05,MGR-08|交互/错误/构建/浏览器截图报告通过，03–05 完整更新|
+|MGR-10 PBR 预览照明|verified|MGR-04|高金属度 GLB 在管理器中具有可辨识表面；PMREM、色彩空间、曝光和多向补光生效|

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

@@ -37,3 +37,13 @@
 - `node scripts/test_glb_machine_motion.mjs`：verified；报告 `coverage/glb-machine-manager/regression-motion/motion.report.json`，SHA-256 `91c3fa8ed8037aac8e71b8c76d54c38db9dc011ae25f63553966860b624aa626`。AC/BC 各 41 个同时五轴变化 tick、42 个样本，最大误差分别约 `2.26e-16`、`2.48e-16`。
 - `git diff --check`：通过。
 - `scripts/validate_glb_machines.mjs` 未重跑：本地缺少 `gltf-validator` 包；旧示例 GLB 未修改，历史 Khronos 校验报告仍为 verified。该依赖边界不影响新管理器的浏览器导入、导出和运行证据。
+
+## E05 / R03 / MILL700 PBR 预览照明
+
+- 状态：verified。
+- 命令：`PLAYWRIGHT_MODULE=/home/mes006/.npm/_npx/e41f203b7505f1fb/node_modules/playwright/index.mjs node scripts/test_machine_manager_mill700_browser.mjs`
+- 模型：`MILL700-U_1.glb`，9,418,852 bytes，SHA-256 `bf37130681cc6462412e52744519516e8ade2a3212dd69153c0b1b3e415bcf66`。
+- report_id：`GLB-MGR-E05`；报告 SHA-256 `bdb39d0a44c2561f806c268c791b7fd03d6e6f2a0dca51d0e1bc9ce3069a4db1`。
+- 结构：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 `0a20bac14708634ddf8e7267236488c3d28526477669ba16dcb880182e2ce11a`。

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

@@ -27,3 +27,7 @@ UI 允许用户选择父级以建立层级和发现错误；应用时只接受
 ## D07 / 组合 GLB 只通过显式导出生成
 
 普通编辑和“应用到 Web LinuxCNC”不触碰用户原文件。只有用户点击“导出组合 GLB”时才用 GLTFExporter 生成新文件。导出包含部件层级、URDF、底座标定 userData 和整机场景标定 userData。
+
+## D08 / 编辑器照明不修改资产材质
+
+模型过暗通过 Three.js 场景的 PMREM 环境、色彩管理、曝光和补光解决。不得为了预览可见而覆盖导入材质的颜色、金属度、粗糙度或纹理，否则导出结果会偏离用户资产。

docs/glb-machine-manager/README.md

@@ -11,7 +11,7 @@
 
 现有整机 GLB + 内嵌 URDF 导入能力继续保留。新管理器生成与现有 `linuxcnc.machine/1` 相同的严格结构，再通过已有配置、Worker、WASM 和 Three.js 投影链运行。
 
-当前状态：MGR-01 至 MGR-09 全部 verified，功能提交为 `8aab531`。最新台账 R02，浏览器证据 `GLB-MGR-E01/E02`，截图和报告位于 `coverage/glb-machine-manager/`。
+当前状态：MGR-01 至 MGR-10 全部 verified，MILL700 实测证据为 `GLB-MGR-E05`。最新台账 R03，浏览器证据 `GLB-MGR-E01/E02/E05`，截图和报告位于 `coverage/glb-machine-manager/`。
 
 文档：