# 局部增强可调范围邻域地下管网 ## What to build 局部查看选中管段周围的地下邻域管网，默认50米，可切换25/50/100米。距离按整条选中折线计算，主选段完整、邻近管道仅范围内片段。保留当前行业/模式筛选，主选突出、邻近简化，不重建全市。 ## Acceptance criteria - [x] 以整条管段为邻域对象，25/50/100米选择与标注一致。 - [x] 正确裁切穿越边界的长折线及多段片段，不把显示截断当真实断口。 - [x] 行业色及虚拟埋深层次与主图同源，不伪造地理/工程高程。 - [x] 当前筛选、换选、空集、准入不合格及过期结果正确处理。 - [x] 保留sourceId/networkId真实设施主键，不能以code冒充关联主键。 - [x] 密集场景有可解释的加载/覆盖状态，不能静默删数据冒称完整。 - [x] 公开领域米制样例、实际渲染输出、Vue范围切换离线回归。 ## Blocked by None ## 待现场验证 - [x] 正式入口下邻域密度、尺寸和设备模型视觉验收（本轮未运行浏览器）。 ## Context 依据本effort local-network-enhancement-spec.md及已确认8项问答。后续设备和窨井共用邻域能力；不是工程连通拓扑。外观票50可独立推进，本票不被其视觉验收阻塞。 ## 验证 `t51-neighborhood.mjs` 覆盖（2026-10-20 复跑通过）： - 默认 50 米按整条折线取邻域（不是中点圆）：主选完整、穿越管道在 ±50 m 处裁切； - 25 米切换与非法范围回退 50； - 筛选移除对象、空集时视图不显示； - 折线离开再进入邻域拆成两片，不跨空白连接； - 真实 Three 渲染 3 个邻域对象，雨水层在供水下方、燃气层在上方（虚拟埋深层次）； - 真实 ID 保留（`networkId`/`sourceId`），源对象零改动； - Pinia `setRadius`/`clear` 复位到 50。 整套 `t50-53-local-enhancement` 12 个脚本通过；Vue 范围切换见 `t23-click-flow.mjs`。 ## 为什么需要人工接手 归类：**需人工测试**（维护者本人视觉验收）。 - 7 项验收已全部勾选，代码与离线回归完成；唯一未完成项在「待现场验证」一节。 - 交付物是**空间密度与视觉可读性**判断：邻域内管道/构件是否过密、标注与计数是否可读、25/50/100 米切换后场景信息密度是否符合预期。这三件事只能在实际画面里判断。 - AI 不代劳的原因：[AGENTS.md]() 禁止自动运行 build/dev/preview 与浏览器截图；离线断言能证明裁切几何与层位正确，不能证明「看起来是否清楚」。 - 本票不阻塞 [52](52-untitled.md)、[53](53-untitled.md)：两者已各自完成离线验证，共用本票邻域能力。 ## 给维护者的实施清单 1. **准备**：由维护者本人启动 `yarn dev`（AI 不代启动），浏览器打开 `http://127.0.0.1:8000/#/cockpit`。 2. **进入入口**：在中央一张图上拾取一条管道，进入「地下管线详情视图」。 3. **逐项目检**： - 默认范围是否为 **50 米**，下拉是否提供 25/50/100； - 主选管段是否**完整**显示（不被裁断）； - 邻近管道是否只保留范围内片段，端头是**显示边界**而非真实断口； - 切换 25 / 100 米时，邻域内对象数量是否随范围明显变化； - 燃气/供水/污水/雨水是否保持主图行业色，层位高低是否可辨； - 顶部计数（管道 X 条 · 构件 Y 个）是否与实际看到的大致相符。 4. **检查点（任一不满足即需回填）**：密集区域是否糊成一片、裁切端是否被误读成管道断口、范围切换是否卡顿或相机跳变、计数与实际不符、颜色与主图不一致。 5. **边界与回归**：换选另一条管道、把全局行业筛选切到另一个行业、清空筛选——确认邻域随筛选变化且不报错；三键（左拖/右旋/滚轮）正常。 6. **不在本票范围**：管道外观细节与去环（[50](50-untitled.md)，已关闭）、设备模型与内部详情（[52](52-untitled.md)）、窨井剖切（[53](53-untitled.md)）、真实管径与材质（[54](54-untitled.md)）、场景设备图标（[58](58-untitled.md)）。 ## 可复跑的离线证据 - `node .scratch/cockpit-shell-panel-layout/verify/t51-neighborhood.mjs` - `node .scratch/cockpit-shell-panel-layout/verify/t50-53-local-enhancement.mjs`（整套 12 个脚本） - Vue 范围切换：`node .scratch/cockpit-shell-panel-layout/verify/t23-click-flow.mjs` 规格：[局部邻域管网与窨井剖切](../local-network-enhancement-spec.md)。 ## 进度 - 2026-10-16 代码与离线回归完成，转 `ready-for-human`。 - 2026-10-21 按 `/wayfinder` 接手：读全票据、认领 codex；核实 `t51-neighborhood.mjs` 与 `t50-53-local-enhancement.mjs` 复跑通过；归类为「需人工测试」，补齐人工接手说明、实施清单与可复跑命令。 - 2026-10-21 **维护者现场验收通过并关闭本票**（邻域密度、25/50/100 切换、裁切端、行业色与层位、计数与三键均符合预期）。 - 记录：本票正文曾被 `deck_issue_patch` 传入空 `body` 擦除，已按原文恢复。 Status: resolved Assignee: codex Type: task Blocked by: Labels: ready-for-human, wayfinder:task ## Comments ### local — 2026-10-21T02:43:11.729Z 按 /wayfinder 接手处理（用户指定）。读全：未认领、无阻塞、7 项验收已勾；剩余唯一未完成项是「待现场验证：正式入口下邻域密度、尺寸和设备模型视觉验收」。复核归类：需人工测试（维护者本人视觉验收）。先核实代码与离线证据现状，再确认归类并输出实施清单。 ### local — 2026-10-21T02:50:00.000Z 复核完成：`t51-neighborhood.mjs` 覆盖整条折线邻域、25/50/100 切换、穿越裁切、离域再入拆片、真实 Three 层位、真实 ID 与 Pinia 复位，复跑通过。正文被空 patch 擦除，已恢复并补入人工接手分类、实施清单与可复跑命令。 ### local — 2026-10-21T03:20:00.000Z 维护者现场验收通过，关闭本票。收口证据：7 项验收全部勾选；`t51-neighborhood.mjs` 与整套 `t50-53-local-enhancement.mjs` 12/12 复跑通过；现场确认邻域密度可读、25/50/100 切换生效、裁切端是显示边界非断口、行业色与层位正确、计数可用、三键正常。 ## Answer 已关闭：代码与离线回归完成（`t51-neighborhood.mjs` + 整套 12/12），维护者正式入口现场验收通过（2026-10-21）。