22: Cesium 地理管线渲染

What to build: 使用 Cesium 渲染真实几何读模型提供的管线折线；消费已提供的管径、材质（缺失保持未知），与监测点及设备点位保持正确交互层级。

Blocked by: 21 Status: resolved Assignee: codex Labels: ready-for-agent

验收标准（维护者本轮确认后修订）

管线折线、源管径和可选材质由适配层提供，缺失不伪造；管径示意插值沿用已决策的管径规则。
管线进入系统后在四个一级模式、地面/管线两种视图中保留；视图切换改变相机与地表/瓦片透明度。
管线视图下地形与 3D Tiles 为半透明参照，不完全隐藏。
管线可按行业筛选；业务状态筛选不在本轮范围（几何契约尚未发布状态及跨行业词表）。
管线交互优先级低于监测点和设备点位，不吞掉普通拾取路径中被管线覆盖的点选；展开设备保留既有投影近邻优先规则。
无效坐标管线不上图，但保留在「无地图位置」清单中；不得删除非法顶点后重连剩余点。
有管线数据映射和筛选单测，以及覆盖管线遮挡点选的回归用例。

本轮范围裁定

维护者确认采用当前领域决策：两种视图都保留管线；按已发布字段收口。真实埋深目前无法取得，暂不处理。现有虚拟埋深 2m 保持明确的非实测语义，不计作后端埋深。状态筛选不借用监测点/设备状态，不为此在本轮追加后端实施。材质仅作可选透传，不声称真实端点已完整发布材质。

原有实现归属

原「未动工」记录已过时。现有真实几何接线由设施点位与管线真实几何图层接线交付；管体与构件、示意管径、虚拟埋深属于管线构件素材与实例化渲染的已有成果，本票不重复认领。半透明参照与视图相机既有验收归3D Tiles 与地形基线。

本轮实施与证据

domain/pipeNetwork.js：pipePositions 不再过滤坏顶点后重连；任一顶点结构非法或非有限数，整条进入「无地图位置」清单，保留编码与原因。后端 renderable 准入规则保持为前置。
services/cesiumEngine.js：前景为本管线图层实体或管体批次时，用公开 Scene.drillPick 穿过管线；首个非管线对象仍按正常遮挡处理。设备/监测点共用入口，普通点选不执行多层拾取；展开设备保留原有投影近邻入口。
新增管线行为回归：真实领域函数与 Cesium Entity/DataSource、受控场景拾取边界，覆盖12组行为。
修复既有验证桩：T41 不再误禁公开 drillPick；T45 补齐差量索引/指纹依赖和新拾取函数。首轮 T45 的 markerEntityIndex is not defined 已用修改前快照复现为既存问题，补桩后19/19通过。

实际离线结果：T22 12/12、T24映射18/18、T24链路17/17、T33差量15/15、T41锚定46/46、T45连续性19/19、T47特效27/27，共154项通过。两轴审查：Standards硬违规0/判断0；Spec未发现可确认的新增违背。详细记录见实施验证记录。

进度

实施完成并按维护者修订后的交付范围收口。直接相关离线回归共154项通过，两轴静态审查无新增阻断项；构建、服务器、浏览器与GPU验证依项目规则跳过。真实埋深暂缓、管线状态无发布契约，均不计作已完成。完整证据和验证边界见下文及实施验证记录。

Comments

local — 2026-10-14T02:41:55.883Z

按用户指派认领，先核验完整票据、父图、前置关系和已有实施；无 needs-triage，前置「3D Tiles 与地形基线」已关闭。通过 grilling 由维护者确认常驻显隐与按已发布字段收口。

local — 2026-10-14T03:51:00.436Z

Resolution：按维护者确认的常驻管线与已发布字段范围关闭。补齐坏顶点整条拦下、仅穿过管线的普通点位拾取；154项相关离线回归通过，Standards 0、Spec无新增阻断项。未进行build/debug/browser/GPU复验；真实埋深暂缓，状态无契约。完整验收、已有成果归属和限制已写入正文及实施验证记录，所属map已追加gist。

Answer

按已发布字段完成 Cesium 管线交付面核验，补齐坏顶点不得重连和管线不吞点选两处缺口；154项相关离线回归通过，规范/规格双轴无新增阻断项。真实埋深暂缓、状态筛选未有契约，保持当前虚拟埋深明确非实测语义。验证边界如进度区所述。

22-cesium-pipeline-rendering.md 4.8 KB History Raw