# 管段可见性修复与实际证据

状态：用户“看不见、看不清楚”的近景问题已取得修复后的真实驾驶舱画面；原票要求的平均FPS≥30、四类最终样例和浏览器模板404仍未全部完成，票保持claimed/open。

## 修复

- 五类语义色：燃气红、供水蓝、污水绿、雨水青、窨井紫。雨污严格读取用户指定的 `remark`；缺失/同时包含两类时为灰色，不按名称或编码猜。
- 后端几何响应原样透传 `remark`，显式null，不写数据库、不改几何准入。真实排水3735条备注已加载，雨水2526、污水1209。
- 源/双侧推算管径保持原值；只将显示粗度放大8倍并限制在1.5–3m，轴向长度与坐标不变，中心线仍地表采样减虚拟埋深2m。
- 管体用UNLIT自定义材质、表面法线明暗；CSS sRGB先转线性RGB，避免双重提亮导致颜色漂白。材质随模型释放。
- 600m外保留4px同色地表导引线，近景以已就绪体积模型为主；缺素材/地表失败仍全距离保留折线/符号。PolylineGraphics被metadata更新替换时，距离限制重新恢复，相关红灯回归已修复。
- 管线视图默认pitch-35°、距离×0.2、地形/建筑alpha0.18；地面视图仍恢复不透明，中心与heading保持。
- 另实测发现scene-grade shader使用GLSL1 `varying` 使WebGL2停止渲染，改为 `in` 后共用页正常渲染。此文件有其他会话建筑/图标在制品，提交仅选择该一行。

## 画面与像素（分清来源）

项目共用入口由最新 AGENTS.md 规定，后续只使用该入口，不另起服务器。本轮临时开发验收控件挂在同一驾驶舱，测试后从生产服务代码撤除。

| 证据 | 实际范围 |
|---|---|
| [visibility-4k-real-pipes.jpg](visibility-4k-real-pipes.jpg) | **更新共用入口规则前**的独立隔离Viewer，真实全量管线4480实例/24语义色批，3840×2160 canvas；隐藏Entities并扣除模型关闭时背景，污水green2369、rain/cyan162015，像素通过。图片为截图工具自动下采样预览，不能用于重新统计4K像素。 |
| [visibility-shared-cockpit-near.jpg](visibility-shared-cockpit-near.jpg) | **共用驾驶舱正式Viewer**、viewport3840×2160，实际地图canvas3790×1930；镜头走正式cameraControl.applyViewPreset，因此不会被生产循环拉回。截图真实污水近景绿、雨水青、供水蓝三维管体清晰；材质已修正sRGB。 |
| 共用页污水像素 | 最初直接写Viewer的临时控件被正式镜头覆盖，结果green491虽然检测到管体，但不能当近景定位成功。随后改用正式相机接口并拿到上述近景截图。 |
| 共用页燃气像素 | 目标TCRQ202609080008（remark燃气），正式相机近景，隐藏导引与背景差分，GAS106654；全视野其它管体也参与统计，所以这是红色真实管体存在/可见证据，不是仅目标实例的尺寸测量。未保存同一目标截图，不能把后续窨井截图称为燃气截图。 |
| [visibility-shared-manhole-purple.jpg](visibility-shared-manhole-purple.jpg) | 实际目标YL-YJ-003的独立紫色窨井点符号与“窨井”标签。该对象不是glTF，之前残留的燃气像素读数不适用于窨井；紫色只按这张实际画面和real-Cesium符号回归核验。 |

## 性能实测与未完成

- 隔离4K管体+真实地形运动45°/10s：约0.99 FPS；隐藏模型/符号并关闭地形后的空場景约1.015 FPS；页面visible/focused未丢焦点。
- 同一环境原生requestAnimationFrame（未加载管网）6帧/5.0667s，约0.987 FPS。由此可确定浏览器帧调度本身只有约1Hz，不能把这一数值解释为管体GPU瓶颈，也不能宣布性能达标。
- 环境GPU字符串：ANGLE/NVIDIA GeForce RTX 4060 Ti/Direct3D11，hardwareConcurrency20。工具强制带设备preset，虽然width/height覆盖后actual viewport和canvas为4K，userAgent仍为iPad、devicePixelRatio约2。
- 恢复正常桌面帧调度后应在共用正式Viewer重新测平均FPS≥30、P95/最大帧间隔，记录focus/visibility/viewport/canvas。当前未通过，不降低门槛。
- 四类glTF隔离样例与模板404浏览器画面仍待完整验收；离线adapter 404/error恢复符号与真实四色显示已分别通过，不混为全票通过。

## 验证

- 新颜色/备注/显示粗度/窨井/仅备注重绘回归通过；t32-adapter新增“PolylineGraphics替换后600m限制仍恢复”通过。
- 既有t32补径、ready/error/清理、t24/t33和t21视图中心保持回归继续通过。
- 后端remark回归先因缺键红灯，再最小透传修复后几何22/22通过；最终Cockpit全量488/488通过。备注透传提交`1d1461a5`，仍本地未推送；后端分支与origin/master分叉的提醒保留，不进行未经要求的push/重置。
- 本次明确授权下最终前端构建退出0（Vite约65s），临时验收挂载与public测试页已撤除，13组直接相关回归脚本全部通过。未另起新的共用服务，保留用户管理的8000入口。
- 数值证据见[visibility-performance.json](visibility-performance.json)，acceptancePassed=false；约1Hz调度的具体来源尚未确定，不声称已证明浏览器限帧设置。

下一步：恢复正常桌面browser_*会话和帧调度，完成性能/404/四类最终验收，达标才close并追加map gist。所有临时注入都从正式代码移除，其他会话工作树与暂存文件保留。