verification.md 3.6 KB

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/浏览器和设备投影近邻分支作为验证边界记录,不虚报整链实测。