# 管道模型开发验收

运行环境只以项目根 AGENTS.md 的“运行环境”一节为准。当前验收必须复用该节的共用驾驶舱入口，不另起端口、服务器或新的验收产品页。是否启动/构建/调试仍需要当前对话的明确授权。

`cockpitAcceptance.js` 是验收工具，不是生产模块。需要复验时可在 `mapService.publishDevHook()` 临时使用 DEV + `pipeVerify=1` 查询条件加载它，将现有Viewer、host、setViewMode和正式applyViewPreset接口传入。所有操作均在同一驾驶舱路由；验完撤掉临时挂载，不把工具控件作为产品交付。必须走正式相机预设接口：直接写 Viewer.camera.lookAt 会被相机控制循环覆盖，使“目标已选”与实际画面不一致。

验收项目：

- 按真实备注区分管体颜色；燃气红、供水蓝、污水绿、雨水青。窨井作为独立紫色符号核验，不把上一个管体的像素统计归到窨井。
- 近景：显示粗度是源/推算管径×8、限制1.5–3m，非工程尺寸。保存实际近景截图。只看ready/batch计数不能证明可见。
- 像素：关闭Entity导引线，再比较glTF模型隐藏/显示前后的同一视角帧，扣除背景；确认目标色像素。记录viewport和实际地图canvas，两者可能不同。
- 远景：600m外出现同色4px导引线；元数据变化导致PolylineGraphics替换后，距离限制应恢复。
- 四类隔离样例：工具可在同一个Viewer的独立数据源加载样条、弯头、阀门、三通/十字；显式标记隔离，不进入后端或业务统计。原始管网可见计数不应被解释为这批合成样例。
- 模板缺失：用临时查询 `pipeMissing=valve`（或elbow/branch）使工具仅为指定模板返回404；验证实例失败后符号仍可见。生产fetch/源文件/后端不改。须以新页面realm开始，避免成功模板缓存掩盖故障。
- 性能：页面真实可见且聚焦，10s固定45°相机运动，按postRender计帧，报告平均FPS、P95和最大帧间隔、GPU、viewport与canvas。目标为4K平均FPS≥30，静止时按需渲染读数不作通过证据。
- 先测原生requestAnimationFrame基线。若未加载管网的浏览器rAF与空场景都只有约1Hz，说明测量环境受限；不要把它归为管体性能结论，也不宣称达标。

`visibility.html` / `acceptance.html` 保留早期隔离反馈工具源码，仅供理解历史截图/像素证据；最新规则要求使用同一共用驾驶舱路由，它们不再作为可另行访问的验收入口，不能复制进public产品目录。

浏览器控制一律使用browser-skill注入工具，不以另一个进程控制浏览器，不改Automation设置绕过许可。工具参数/会话异常如实记入票据，不无限重复失败调用。