# 23: Three.js 管线增强

**What to build:** 对选中的重点管段、接头、阀门或断面使用 Three.js 做局部增强。Cesium 继续承担地理主图，Three.js 不接管场景。

Blocked by: 22
Status: ready-for-agent
Assignee: codex
Type: task
Labels: ready-for-agent, wayfinder:task

## 验收标准

- [ ] 只有选中或配置为重点的对象进入 Three.js 增强视图。
- [ ] Cesium 与 Three.js 通过选中对象和领域状态联动。
- [ ] 支持重点管段、接头、阀门或断面占位展示。
- [ ] 增强视图可关闭并返回地理主图上下文。
- [ ] 不用 Three.js 重建全市地理管线。
- [ ] 有选中对象联动单测或走查记录。

## 诊断与实施方案

现状：完整正文、评论（无）、标签与关系均已核验；无 needs-triage，前置[Cesium 地理管线渲染](22-cesium-pipeline-rendering.md)已关闭。已有 Cesium 管线/glTF、构件与点选优先链属其它票成果；驾驶舱模块没有 Three.js 导入或局部增强视图，本票确未动工。构件主图有 GPU 实例批次，拾取必须按 instanceId 对应真实对象，不能把批次第一项冒充所选对象。

维护者本轮通过 grilling 确认：采用可关闭的单对象局部查看窗；原 Cesium 相机、筛选及原有点位/设备详情保留。只展示当前可见的被选中管段/构件，不重建全市管线；接头、阀门及断面允许示意占位，并明确非工程模型、无来源尺寸/朝向不冒充真实字段。

实施：纯领域增强计划 + 管线领域选择态 + Three.js 服务层 + 局部查看窗；Cesium 拾取保持设备/监测点优先，落空再识别管段/构件。行业筛选移除、引导态、关闭及离开页面均撤下局部渲染，异步加载过期不得重新挂回。

已确认测试边界：CockpitShell 用户路径、单对象增强计划公开接口、局部渲染服务公开接口。直接 Node 离线回归覆盖未选不建场景、换选/筛选不残留、单对象限制、关闭释放资源及地图上下文保留。按 AGENTS.md 跳过 build/dev/debug/浏览器/GPU验证。

## 进度

诊断及 grilling 完成，当前实施中。前置已关闭、无 needs-triage。下一步实现单对象选择/Three服务/查看窗/拾取联动，然后离线自查与code-review；build/debug/浏览器按项目规则跳过。

## Comments

### local — 2026-10-15T03:23:04.491Z
已按维护者选择冻结局部查看窗与三个公开测试边界。阶段闸门通过；Status: claimed 记录本地认领，开始实施。

## Answer