51-untitled.md 6.6 KB

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

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

给维护者的实施清单

  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,已关闭)、设备模型与内部详情(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 复跑通过;归类为「需人工测试」,补齐人工接手说明、实施清单与可复跑命令。
  • 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)。