README.md 3.3 KB
管道模型开发验收
运行环境只以项目根 AGENTS.md 的“运行环境”一节为准。当前验收必须复用该节的共用驾驶舱入口，不另起端口、服务器或新的验收产品页。是否启动/构建/调试仍需要当前对话的明确授权。
cockpitAcceptance.js 是验收工具，不是生产模块。需要复验时可在 mapService.publishDevHook() 临时使用 DEV + pipeVerify=1 查询条件加载它，将现有Viewer、host、setViewMode和正式applyViewPreset接口传入。所有操作均在同一驾驶舱路由；验完撤掉临时挂载，不把工具控件作为产品交付。必须走正式相机预设接口：直接写 Viewer.camera.lookAt 会被相机控制循环覆盖，使“目标已选”与实际画面不一致。
验收项目：
- 对排水管按networkLevel分类：0/缺失为污水、1为雨水，非法值为灰色未知；备注/名称不参与。燃气红、供水蓝、污水绿、雨水青，非排水行业不受等级影响。窨井作为独立紫色符号核验，不把上一个管体的像素统计归到窨井。
- 地面视图靠近时必须保留全部2D线；只在管线视图模型完整就绪后对其近景导引设600m下限。返回地面、失败或加载中立即恢复全距离；切换不重新创建GPU批次。
- 缺源/可靠插值管径的显示默认：燃气DN160、供水DN400、排水DN800。来源为visual-default、diameterM仍null，源径缺失和显示占位计数分别保留。
- 近景：显示粗度是源/推算管径×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设置绕过许可。工具参数/会话异常如实记入票据，不无限重复失败调用。