# Cesium 地理管线渲染 — 本轮验证记录

## 范围与基线

- 基线提交：`09905be058d0d784c7c7a6ba8fe2ba739f2c7291`。工作区已有大量并行未提交改动；本轮修改前快照保存在 `before/`，用于精确归属。
- 维护者确认：地面/管线两种视图都保留管线；按已发布字段收口。真实埋深暂缓，现有虚拟 2m 不冒充实测；没有管线业务状态契约，不借用监测点/设备词表。
- 材质为可选透传，缺失为空；源管径与示意插值沿用已有实现，不声称本轮新增真实几何接线或管体素材。

## 本轮新修复

1. `domain/pipeNetwork.js`：折线顶点逐个校验结构与有限数；任一点非法则整条进入无地图位置清单，不跳点重连。后端 renderable 准入仍是前置，未增加第二套地理范围判定。
2. `services/cesiumEngine.js`：普通拾取前景为本管线数据源实体/管体批次时，使用公开 `Scene.drillPick` 找第一个非管线对象。保留其它对象的前后遮挡与既有设备/聚合优先分派；普通点选不做多层拾取。
3. 新增 `verify/t22-pipeline-rendering.mjs`，使用真实域函数、Cesium Entity/DataSource 与可控制的 GPU 拾取边界，覆盖12组行为。
4. 既有测试桩维护：t41 移除将公开 drillPick 误认私有 API 的检查；t45 注入新增拾取依赖，并补齐此前缺失的差量索引/指纹/实体返回值。

## 离线检查（实际执行）

| 检查 | 结果 |
| --- | --- |
| t22-pipeline-rendering | 12/12 通过 |
| t24-pipe-layer | 18/18 通过 |
| t24-pipe-layer-flow | 17/17 通过 |
| t33-jitter-diff | 15/15 通过 |
| t41-point-locate-anchor | 46/46 通过 |
| t45-selection-continuity | 19/19 通过（修正测试桩后） |
| t47-overlap-effects | 27/27 通过 |
| git diff --check（本轮4个既有文件） | 通过；仅提示既有换行转换 |

这些脚本直接以 Node 执行，不调用 package scripts、不启动服务、无需浏览器或外部网络。没有进行全仓测试：存在多会话在制品，本轮只检查直接受影响链路。

### T45 既存假失败的证据

首轮 T45 的「monitoring point creates a visible name label」报 `markerEntityIndex is not defined`，其余18项通过。`verify/t22-t45-baseline.mjs` 使用修改前引擎快照与原桩只读复现同一错误，确认非本轮拾取修复造成。补测试桩依赖后19/19通过，生产标记差量实现没有改动。

## 验收的实际边界

- 新断言覆盖完整路径、坏中间顶点、后端未准入、源/缺失管径、可选材质、行业筛选及被拦清单、四模式与引导态、两视图的透明度计划、管线/构件/管体遮挡点选、其它对象保持遮挡、坐标转换、无多层能力降级、实体差量同步及撤下。
- 四模式常驻、半透明参照、真实几何既有浏览器证据归真实数据接线票24及地形基线票21，本轮未重复宣称新执行。
- 遵守 AGENTS.md，已跳过 build/debug 验证：未构建、未启动/重启服务器、未运行浏览器调试或截图。本轮 GPU 遮挡、多层拾取性能与运行态画面没有重新实测。
- 设备展开后的投影近邻入口在本轮修改前即已优先返回，沿用既有交互规则；新遮挡用例验证普通拾取分支，不能扩展宣称设备投影近邻链的GPU遮挡已实测。

## 两轴审查

- Standards：硬违规0、判断性 smell 0。比较修改前快照与本轮改动，未混入并行基线。
- Spec：未发现可确认的新增规格违背；既有接线/渲染成果与本轮两处修复分开归属。GPU/浏览器和设备投影近邻分支作为验证边界记录，不虚报整链实测。