# 管线构件 glTF 实施与验收记录

状态：实施已完成，验收未全部通过，issue 保持 claimed/open。

**2026-10-13管径规则补充与事实更正**：用户已确认双侧按长度插值，见[管径补全实施](diameter-implementation.md)。下文“真实接口正管径0”的旧观察只表示当时API没有diameter字段，不能证明数据库全缺径；已修复后端透传并实测3332源数据/18推算/1918未补。最新驾驶舱4480实例/19批。原4K与浏览器故障验收仍待完成。

## 实施边界

- 四类原始低多边形素材：样条管体、弯头、阀门、支管；支管提供三通和十字变体。glTF 模板与外部同名 bin 位于 public/cockpit/models/pipes。
- Cesium 1.145.0 使用 EXT_mesh_gpu_instancing。按空间/行业/类型分批，批内 GPU 实例化，同类批次复用稳定外部几何 URL；不逐构件加载模型。
- 使用地表采样高程减虚拟埋深 2m。已知管径 mm→m；无管径保留折线。构件约 1m 标准外形、固定示意朝向，明确非真实安装信息。
- 就绪事件后替换降级；初始/后续资源失败、地表采样失败保持或恢复备用符号。失败批按 30s 冷却在后续同步中重试。输入不变不重建，稳定批保留，清层跨首次动态 import 和模型加载都作废旧结果。

## 双轴复核与修复

Standards 轴提出批次全量拆建、失败永不恢复、迟到加载浪费资源三项判断；Spec 轴提出坐标北向镜像、跨批不共享 GPU 几何、缺实测等问题。已修复：

1. ENU→glTF 使用 [N,U,E]，与当前 Cesium [z,x,y] 校正互逆；回归用独立矩阵验证。
2. 每类外部 bin 的稳定绝对 URL 供 Cesium GPU 资源缓存跨批复用。
3. 批级指纹、retain 与冷却重试；template/model await 后检查存活代次。
4. 复核又发现的首次动态 import 清理竞态已获得红灯复现，再加 Viewer 代次守卫通过回归。
5. 地表采样失败发布 terrainFailed 并在已有状态面板解释。

## 已获得证据

- 本轮授权后最终 yarn build 成功（退出码0，Vite构建54.43s，包含最后的导入代次守卫与terrainFailed说明，且临时public验收页已移除）；仓库既有 bundle/script/Browserslist 警告仍存在。
- 新回归覆盖管径与原路径、未知类型、三通/十字变体、glTF 单网格实例流、轴转换、真正 ready 前不撤下备用表达、后续资源错误恢复、跨批整条路径就绪、冷却重试、清层后迟到结果不复活。
- 既有 t24 管线领域、t24 链路、t33 管线差量回归通过，未把并行差量修复混入本票提交。
- 隔离浏览器：6 实例、5 批，spline=2、elbow/valve/branch/cross 各 1；pending=0、failed=0、未知 regulator 保留 1 个符号。截图见 [isolated-types.png](isolated-types.png)。该截图是窄模拟视口，十字变体位于边缘，不能替代完整 4K 四类画面验收。
- 自动续跑 Round 1：新增真实 Cesium 坐标/事件、仅替换 terrain/GPU I/O 的适配层回归 `t32-adapter-behavior.mjs`。通过：pending期间保留符号、ready才撤下、同类模板只取一次且跨批同bin URL、名称变化零模型重建、只改一个管径仅重建一批、后续error恢复符号、destroy释放、地表失败发布terrainFailed、模板404保留符号。此为离线适配边界证据，不替代浏览器/FPS。
- 浏览器参数冲突已进一步核实：插件 `lib/index.mjs` 的 SESSION_STOP_PARAMS（101–109）及 browser_session.parameters（4431–4455）没有把 session/requestId/设备等标为 required；当前模型工具契约却要求全字段，运行层 resolveStop（3135–3137）同时给 session/requestId 必报互斥错。问题落在工具暴露/调用契约，未修改插件或绕过 browser-skill。
- 真实只读接口：5268 条 LineString 的正管径数为 **0**，唯一合法 Point 是 MANHOLE / YL-YJ-003，pointType=null。因此按已确认规则，真实页面应为 **5269 个折线/符号对象、0 个 glTF 实例**；隔离浏览器读取与此一致。这证明降级诚实，不证明全量 GPU 实例性能。

## 尚未完成

1. 3840×2160 页面可见、固定 45°/10s 镜头运动下平均 FPS≥30，记录 P95/最大帧间隔与环境。要分别测试真实降级数据与明确标记的隔离 GPU 压力样例；不能给真实缺径数据补造尺寸后宣称真实模型完整。
2. 隔离页 `?missing=valve`（及另一类）实际 404 下备用符号、计数和画面验证。离线 lifecycle error 回归已过，但浏览器故障注入尚未执行。
3. 完整驾驶舱对现有模式/行业显隐和模型状态说明复验。期间遇到的总览 donutBlock 缺失导入已由其他工作补齐，但本轮尚未拿到修复后的完整页面证据。
4. 清除本轮验收 Agent Window 的设备模拟并恢复有效工具会话。当前工具 schema 强制提供所有字段，off 与 device/width/height、session 与 requestId 等互斥参数无法省略；observe cursor/maxDepth、debug slowMs 等同样冲突。snapshot/press/screenshot 曾可取得部分证据，后续会话失去注册且达到 5-session 上限，无法继续符合技能规则的浏览器验证。没有改用外部进程控制浏览器。

下一步：恢复浏览器工具的可选参数/会话，按 tools/pipe-models/README.md 复现上述验收；全部达标后发 resolution comment、close、再次 report 并给 map 追加具名 gist。当前不 close，也不把未完成结论写入 Decisions so far。