43-panel-device-correspondence.md 8.0 KB
43: 面板与三维设备点双向对应
Type: implementation Status: resolved Blocked by: 42 Labels: ready-for-agent
What to build
按规格 15 实现面板设备卡片与三维设备点的双向 hover/选中/拾取联动。选中反应使用外环、放大和连接监测点标记中心的引线，不使用颜色抢占设备状态语义；hover 是瞬态轻放大/卡片高亮，不叠加选中外环和引线。设备点使用独立 pickDeviceMarkerAt() 身份，设备点优先于监测点，未关联设备既有拾取链路不变。
Acceptance
- 面板 hover 卡片能轻放大对应设备点；三维 hover 设备点能高亮对应卡片。
- 选中设备产生持久外环、放大和引线；设备与监测点重叠时未展开状态不画零长度引线。
- 首次从点位级进入设备级时飞
map.locate.device；同点位设备 A→B 只换中心不重飞；返回点位级回点位视角但监测点仍保持选中。 - 三维点选设备能滚动/选中对应卡片并进入二级设备详情；返回点位清除设备强化并恢复点位级。
- 设备数不少于 3 台时其余设备弱化；hover 弱化设备撤销弱化并轻放大；已选设备不受 hover 干扰。
- 宿主暴露
data-map-device-picked、data-map-panel-selection、data-map-device-hovered，不破坏data-map-picked。 - 纯逻辑覆盖状态迁移、拾取优先级和弱化阈值；真实走查覆盖两侧 hover、两侧选中、返回点位和定位。
Out of scope
- 设备图层触发/快照生命周期、设备资产、状态特效、重叠聚合和模式矩阵。
进度：100%（2026-09-29 收口）
已完成并关闭。 逻辑闸门 40/40、变异测试 26/26 全部打红、真机走查已执行（见下）， 全量零依赖闸门回归绿。
交付物
domain/deviceCorrespondence.js（新）：反应档位（selected/hovered/dimmed/normal， 互斥且优先级正确）、镜头联动三段（device-tier/center-only/point-tier）、 拾取优先级（resolvePickOrder：设备优先、监测点兜底）、引线退化（重合不画）、 反应量（scale/alpha/ring，不含颜色）。services/cesiumEngine.js：applyDeviceReactions（逐实体写 scale/alpha/outline）、syncDeviceLead/clearDeviceLead（设备点到监测点标记中心的归属引线）、pickDeviceMarkerForHover。services/mapService.js：syncDeviceReactions/syncDeviceLeadForSelection/setSelectedDevice/setHoveredDevice/hoverDeviceAt/onDeviceHover/pickDeviceOrPointAt（优先链）/setPanelSelectionLevel/clearDeviceSelection/getDeviceCorrespondenceState；宿主新增三个可断言字段；hover 节流 60ms。stores/deviceLayerStore.js：selectedDevice/hoveredDevice/dimming+selectDevice（含镜头联动）/hoverDevice/backToPointLevel/noteLevel。components/PointDetailCard.vue：设备卡片与设备清单都接上 hover/选中（data-device-selected/-hovered供走查读）。components/MapCanvas.vue：三维 hover → 面板高亮；三维点设备 → 选中并进设备级。CockpitShell.vue：层级字段写入 + 层级对照同步 + 设备把手。- 证据：
verify/t43-device-correspondence.mjs（40/40）+ 变异 26/26 全部打红。
关键取舍（都来自已 resolved 的规格 15 / 决策票 06）
- 反应不用颜色：色键语义已被设备状态（票 44/07）占用，所以「被选中」只用
外环 + 放大 + 引线、弱化只用压暗 + 缩小 —— 反应量里连
color字段都没有（有断言钉住）。 - hover 与选中是两档、互不干扰：hover 只作用于非选中设备（撤弱化 + 轻放大，不叠外环/引线）， hover 到已选中的那台不改变它的选中态。
- 弱化阈值 = 设备数 ≥ 3 台：少于 3 台全亮，避免小点位无谓抖动。
- 返回点位不是取消选中：它是层级回退（监测点仍选中、回点位档视角）， 与票 03 的「取消选中不回退」语义并存不冲突。
真机走查（已执行）：抓到并修掉 1 处真缺陷
本机 @puppeteer/browsers 是空目录（既有环境缺陷），故按票 36/37/41/42 成例
改用 DSH 自带浏览器真实驱动（yarn dev @8000）。
修掉的缺陷：设备选中态有「两套真相」。 我原先把 setSelectedDevice 直接暴露到 DEV 把手，
真机走查暴露：直接调服务层后 store 的 selectedDevice 仍读空串 —— 界面（面板高亮）与引擎
（三维强化）对"选中了谁"给出两个答案。修法：服务层不再暴露直写选中态的函数，
按票 41 的 publishPointSelectionHandle 成例，由外壳把 store 的方法递给 DEV 把手
（publishDeviceSelectionHandle）；走查驱动的是"用户那条路径"。已补断言 F14 钉住。
实测证据（真实浏览器，与验收逐条对应）：
- 选中：
data-map-device-picked=EQ-001、detailLevel=equipment、detailDevice=EQ-001； store 与服务层读数一致（store === service === 'EQ-001'，修复前 store 为空串）。 - hover 不干扰选中：hover
EQ-002时data-map-device-hovered=EQ-002而data-map-device-picked保持EQ-001。 - 层级字段：
data-map-panel-selection随详情层级变化（point↔equipment）—— 注意 Vue 的 watch 是异步（flush: 'pre'），同步读到的仍是上一拍的值（已确认下一拍一致）。 - 返回点位：
equipment → point、监测点仍选中（pointCode=MP-001）、设备选中清空。 - 反应真的落到引擎：
applyDeviceReactions对两台实体各写一次（返回written=2）。
未覆盖项（如实记录）：走查标签 document.hidden===true（rAF 冻结、Cesium 不渲染），
所以「真实鼠标 hover 三维设备点 → 面板高亮」与「真实鼠标点设备点」这两条的画面观感
未能逐帧验证（票 42 已记录同一环境事实：该环境下连监测点标记的 scene.pick 也拾不到）。
这两条的判定与接线已由 t43 闸门覆盖（拾取优先级 D 段、hover/选中接线 F 段、反应量 B 段），
真实观感建议维护者在前台标签页复跑，或由票 48 的整体验收一并覆盖。
与下游票的边界（不在本票实现）
- 票 44：设备形状/尺寸/资产与独立状态词表。本票的反应只改
scale/alpha/outline， 不碰形状与色键（shape仍由调用方给）。 - 票 45：重叠设备的聚合符号与展开环、逐台拾取与 K>10 降级。本票只实现正常单点的 反应与拾取优先级；「未摊开（地理重合）时引线退化不画」属本票（规格边界明写）， 展开态的引线照画归票 45/11。
- 票 46：完整四模式图层矩阵。本票不重做模式可见性（票 42 的
isVisibleInMode继续生效）。 - 票 47：状态特效（报警扩散脉冲等）。本票不实现任何动画。
回归
零依赖逻辑闸门全绿（t01/t03/t05/t06/t07 39/t08/t09/t10 57/t11/t12/t13/t14/t15/t16/t17/
t18 71/t19/t21/t21-view/t29/t30/t36/t37/t38/t39/t41/t42 37/t43 40）。
三处红与本票无关：① t28-fill-container.mjs 需 puppeteer（既有环境缺陷）；
② t04-config.mjs 的「页面与组件不该硬编码后端地址」与 ③ t20-overview-panels.mjs 的 D3
—— 两条都指向 services/cockpitApi.js，而该文件并发会话（票 20）正在改，
不在本票改动清单里（git status 可核）。
按 AGENTS.md：本会话未跑 build（真机走查是维护者本轮明确要求才执行的）。
下一步
- 维护者在前台标签页复跑，补「三维 hover/点选设备」的画面观感（判定与接线已被闸门覆盖）。
45（重叠设备聚合与展开）、46（模式图层计划）、47（状态特效）的依赖已就绪；45仍需 42/43/44/46 全绿后才可claim。