局部增强可调范围邻域地下管网

What to build

局部查看选中管段周围的地下邻域管网，默认50米，可切换25/50/100米。距离按整条选中折线计算，主选段完整、邻近管道仅范围内片段。保留当前行业/模式筛选，主选突出、邻近简化，不重建全市。

Acceptance criteria

以整条管段为邻域对象，25/50/100米选择与标注一致。
正确裁切穿越边界的长折线及多段片段，不把显示截断当真实断口。
行业色及虚拟埋深层次与主图同源，不伪造地理/工程高程。
当前筛选、换选、空集、准入不合格及过期结果正确处理。
保留sourceId/networkId真实设施主键，不能以code冒充关联主键。
密集场景有可解释的加载/覆盖状态，不能静默删数据冒称完整。
公开领域米制样例、实际渲染输出、Vue范围切换离线回归。

Blocked by

None

待现场验证

正式入口下邻域密度、尺寸和设备模型视觉验收（本轮未运行浏览器）。

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、53：两者已各自完成离线验证，共用本票邻域能力。

给维护者的实施清单

准备：由维护者本人启动 yarn dev（AI 不代启动），浏览器打开 http://127.0.0.1:8000/#/cockpit。
进入入口：在中央一张图上拾取一条管道，进入「地下管线详情视图」。
逐项目检：
- 默认范围是否为 50 米，下拉是否提供 25/50/100；
- 主选管段是否完整显示（不被裁断）；
- 邻近管道是否只保留范围内片段，端头是显示边界而非真实断口；
- 切换 25 / 100 米时，邻域内对象数量是否随范围明显变化；
- 燃气/供水/污水/雨水是否保持主图行业色，层位高低是否可辨；
- 顶部计数（管道 X 条 · 构件 Y 个）是否与实际看到的大致相符。
检查点（任一不满足即需回填）：密集区域是否糊成一片、裁切端是否被误读成管道断口、范围切换是否卡顿或相机跳变、计数与实际不符、颜色与主图不一致。
边界与回归：换选另一条管道、把全局行业筛选切到另一个行业、清空筛选——确认邻域随筛选变化且不报错；三键（左拖/右旋/滚轮）正常。
不在本票范围：管道外观细节与去环（50，已关闭）、设备模型与内部详情（52）、窨井剖切（53）、真实管径与材质（54）、场景设备图标（58）。

可复跑的离线证据

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

规格：局部邻域管网与窨井剖切。

进度

2026-10-16 代码与离线回归完成，转 ready-for-human。
2026-10-21 按 /wayfinder 接手：读全票据、认领 codex；核实 t51-neighborhood.mjs 与 t50-53-local-enhancement.mjs 复跑通过；归类为「需人工测试」，补齐人工接手说明、实施清单与可复跑命令。
记录：本票正文曾被 deck_issue_patch 传入空 body 擦除，已按原文恢复。

Status: ready-for-human 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 擦除，已恢复并补入人工接手分类、实施清单与可复跑命令。

Answer

代码与离线回归完成；剩余唯一动作是维护者本人在正式入口目检邻域密度与视觉可读性，确认后即可关闭本票。

51-untitled.md 6.1 KB Histórico Raw