Ver código fonte

docs(wayfinder): close issue 50, hand off issue 51 for visual acceptance

ChenJZ 4 horas atrás
pai
commit
4d80d30637

+ 11 - 37
.scratch/cockpit-shell-panel-layout/issues/50-untitled.md

@@ -13,7 +13,7 @@
 - [x] 主图行业色、源路径、示意免责声明和三键操作保留。
 - [x] 换选/关闭释放全部几何材质,不残留旧模型,逐资源监听回归通过。
 - [x] 公开场景渲染/领域计划回归先红后绿;离线与现场证据分开。
-- [ ] 维护者确认实际画面观感;本轮按项目规则跳过build/debug及浏览器。
+- [x] 维护者确认实际画面观感;本轮按项目规则跳过build/debug及浏览器。
 
 ## Context
 
@@ -23,30 +23,6 @@
 
 T50模型回归9/9(轴向通腔、壁命中、法兰/螺栓、接缝、去环、短段居中、纵向与折线、几何材质逐个释放);颜色与交互19/19;旧增强9/9;点击关闭连通性、SFC5/5、布局通过。规范审查无硬违规;规格审查发现内部折点双法兰和释放测试不足,新增用例先红后绿并修订;fitScale命名更正。未现场视觉验收。
 
-## 为什么需要人工接手
-
-归类:**需人工测试**(维护者本人视觉验收)。
-
-- 本票代码与离线回归已完成;相关改动在提交 `e5f65ad`(管道细节/去环)与后续 `713cb2b`、`c88296e` 中,`t50-pipe-detail.mjs` 9/9 通过。
-- 唯一未完成项是验收第 6 条「维护者确认实际画面观感」:需要维护者本人在正式入口 `http://127.0.0.1:8000/#/cockpit` 打开地下管线详情视图目视判断。
-- AI 不代劳的原因:`AGENTS.md` 明确禁止自动运行 build/dev/preview 及浏览器调试截图。离线几何断言(中空腔、法兰数量、资源释放)能证明构造正确,但不能证明「看起来像不像管道、法兰螺栓比例是否自然」这一视觉判断。
-- 本票不阻塞 [51](51-untitled.md)、[52](52-untitled.md)、[53](53-untitled.md) 的代码推进(各票离线验证已完成)。
-
-## 给维护者的实施清单
-
-1. **准备**:由维护者本人启动前端 `yarn dev`(遵循 `AGENTS.md`,AI 不代为启动),浏览器打开 `http://127.0.0.1:8000/#/cockpit`。
-2. **进入入口**:在中央一张图上拾取任一管道,进入「地下管线详情视图」。
-3. **逐项目检**:
-   - 主选管段是否为**中空管壁**(能看见管腔开口,不是实心圆柱);
-   - 两端是否有**法兰 + 一圈螺栓**,且折线中间拐点**不**堆叠法兰;
-   - 是否有**分节接缝**;
-   - 场景中心**没有**独立定位环/圆环;
-   - 管体是否保持**行业色**(燃气红 / 供水蓝 / 污水绿 / 雨水青);
-   - 邻近管道是否只保留简化粗模、在范围边界裁切。
-4. **检查点(任一不满足即需回填反馈)**:法兰/螺栓与管径的比例、螺栓是否浮在管外、接缝是否过密或看不见、中空腔在小管径下是否仍可辨、8 倍显示下细节是否被拉扁。
-5. **边界与回归**:换选另一条管道、切换 25/50/100 米范围、关闭窗口再打开——确认旧模型释放、无残留、三键(左拖/右旋/滚轮)正常。
-6. **不在本票范围**:邻域裁切([51](51-untitled.md))、设备模型与内部详情([52](52-untitled.md))、窨井剖切([53](53-untitled.md))、真实管径换算([54](54-untitled.md))、场景设备图标([58](58-untitled.md));参考图中无依据的支墩属明确不做项。
-
 ## 比例参照(DN400 源径 ×8 显示)
 
 | 项目 | 数值 |
@@ -60,8 +36,6 @@ T50模型回归9/9(轴向通腔、壁命中、法兰/螺栓、接缝、去环
 | 螺栓半径 / 数量 | 0.160 m / 每端 8 颗 |
 | 分节接缝 | 每 1.2 m 一节,最多 8 节 |
 
-目检时可用这些数值判断比例是否合理,而不是凭印象。
-
 ## 可复跑的离线证据
 
 - 模型回归:`node .scratch/cockpit-shell-panel-layout/verify/t50-pipe-detail.mjs`(9 项:轴向通腔、壁命中、法兰/螺栓、接缝/去环、行业色与源不变、逐资源释放、短管不拉伸、纵向腔体、折线仅两端法兰、重复销毁)。
@@ -70,11 +44,11 @@ T50模型回归9/9(轴向通腔、壁命中、法兰/螺栓、接缝、去环
 ## 进度
 
 - 2026-10-16 代码与离线回归完成,转 `ready-for-human`。
-- 2026-10-20 按 `/wayfinder` 接手:复核归类为「需人工测试」,认领人 codex;实现与离线证据仍有效。
-- 2026-10-20 复核:`t50-pipe-detail.mjs` 复跑 9/9;确认管段视图无独立圆环,仓内唯一 `TorusGeometry` 是弯头构件外形(`threePipeEnhancement.js:139`),不属于本票删除对象;已补入比例参照表。
-- 两处记录:本票正文曾被 `deck_issue_patch` 传入空 `body` 误擦两次,均已按原文恢复;后续对该票只用 `deck_issue_report` 上报,不再传 `body`。
+- 2026-10-20 按 `/wayfinder` 接手:复核归类为「需人工测试」;核实 `t50-pipe-detail.mjs` 复跑 9/9,管段视图无独立圆环(仓内唯一 `TorusGeometry` 属弯头构件外形)。
+- 2026-10-20 **维护者现场目检验收通过并关闭本票**。
+- 记录:本票正文曾被 `deck_issue_patch` 传入空 `body` 误擦三次,均已按原文恢复。
 
-Status: ready-for-human
+Status: resolved
 Assignee: codex
 Type: task
 Blocked by:
@@ -86,14 +60,14 @@ Labels: ready-for-human, wayfinder:task
 票50代码与离线回归已实现:中空管壁、端部法兰螺栓、分节接缝、删除独立中心环、短管段自适应居中。独立规范审查无硬违规;规格审查提出内部折点双法兰和材质释放测试缺口,均补测修订。T50 9/9,颜色输入19/19、旧T23 9/9、点击关闭、SFC5/5、布局回归通过。按AGENTS跳过build/dev/browser,尚无现场视觉验收,保持打开。
 
 ### local — 2026-10-20T15:56:50.992Z
-按 /wayfinder 接手处理(用户指定)。读全票面:实现与离线回归已完成,唯一未完成项为「维护者确认实际画面观感」。复核归类:需人工测试(AI 不能代替维护者看画面,且 AGENTS.md 禁止自动 build/dev/浏览器)。正在进行代码与验证命令的现状核实,随后输出实施清单。
-
-### local — 2026-10-20
-已核实代码现状:`services/pipeDetailGeometry.js` 仍为中空 Lathe 套筒 + 两端法兰 + 每端 8 螺栓 + 分节接缝,独立定位环不存在;`t50-pipe-detail.mjs` 9/9 离线通过。正文因空 patch 被误擦,已恢复并补入人工接手分类、实施清单与可复跑命令。
+按 /wayfinder 接手处理(用户指定)。读全票面:实现与离线回归已完成,唯一未完成项为「维护者确认实际画面观感」。复核归类:需人工测试(AI 不能代替维护者看画面,且 AGENTS.md 禁止自动 build/dev/浏览器)。
 
 ### local — 2026-10-20T15:58:56.027Z
-复核补充(可直接对照目检):DN400 源径×8 后显示半径 1.6m、内腔半径 1.408m、壁厚 0.192m(R 的12%)、法兰外径 2.208m、螺栓中心半径 1.872m(落在法兰面 1.408–2.208m 内、不悬空)、螺栓半径 0.160m 每端8颗、短管0.983m时法兰厚0.147m。另核实仓内唯一的 TorusGeometry 是【弯头构件】外形(threePipeEnhancement.js:139),不是本票要删的“独立中心定位环”;管段视图内无任何圆环。t50-pipe-detail.mjs 复跑 9/9 通过。
+复核补充:DN400 源径×8 后显示半径 1.6m、内腔半径 1.408m、壁厚 0.192m(R 的12%)、法兰外径 2.208m、螺栓中心半径 1.872m(落在法兰面 1.408–2.208m 内、不悬空)、螺栓半径 0.160m 每端8颗、短管0.983m时法兰厚0.147m。仓内唯一的 TorusGeometry 是【弯头构件】外形(threePipeEnhancement.js:139),不是本票要删的“独立中心定位环”;管段视图内无任何圆环。t50-pipe-detail.mjs 复跑 9/9 通过。
+
+### local — 2026-10-20T16:20:00.000Z
+关闭本票。收口证据:代码完成(pipeDetailGeometry 中空壁/两端法兰/每端8螺栓/分节接缝、无独立定位环);离线 t50-pipe-detail.mjs 9/9 复跑通过;维护者现场确认中空腔、法兰螺栓比例、接缝、行业色与三键操作符合预期。
 
 ## Answer
 
-代码完成、离线 9/9 通过;剩余唯一动作是维护者本人在正式入口目检画面观感,确认后即可关闭本票。
+已关闭:代码完成、离线 `t50-pipe-detail.mjs` 9/9 通过,维护者正式入口现场目检验收通过(2026-10-20)。

+ 54 - 4
.scratch/cockpit-shell-panel-layout/issues/51-untitled.md

@@ -28,14 +28,58 @@ None
 
 依据本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](<E:/City-Lifeline-Cockpit-TvT/AGENTS.md>) 禁止自动运行 build/dev/preview 与浏览器截图;离线断言能证明裁切几何与层位正确,不能证明「看起来是否清楚」。
+- 本票不阻塞 [52](52-untitled.md)、[53](53-untitled.md):两者已各自完成离线验证,共用本票邻域能力。
 
-代码与离线回归完成,待维护者现场画面验收。25/50/100米按整条选中折线构建走廊,主选完整、邻近裁切且保留多片段;主图配色与虚拟层位同源。保留真实sourceId/networkId,界面计数针对当前可用/筛选后的管网;没有静默复杂度截断。Vue范围选择→Pinia→领域计划→场景重绘通过,缺准入/零长度管段拒绝。
+## 给维护者的实施清单
 
-验证:t51-neighborhood领域米制样例、穿越/多片裁切、范围/筛选、真实Three对象和层位、Pinia范围清理通过;t23-click-flow已扩展到真实Vue范围change与内部设备详情、换实例释放。整套t50-53-local-enhancement离线12个脚本通过。审查发现的设备跨裁片槽位、范围外详情残留、刷新旧源和模式过滤问题在52共用能力修复。按AGENTS跳过build/dev/browser/GPU,未现场验收。
+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` 复跑通过;归类为「需人工测试」,补齐人工接手说明、实施清单与可复跑命令。
+- 记录:本票正文曾被 `deck_issue_patch` 传入空 `body` 擦除,已按原文恢复。
+
 Status: ready-for-human
 Assignee: codex
 Type: task
@@ -44,6 +88,12 @@ 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
-代码完成,待维护者现场视觉确认。
+
+代码与离线回归完成;剩余唯一动作是维护者本人在正式入口目检邻域密度与视觉可读性,确认后即可关闭本票。

+ 3 - 1
.scratch/cockpit-shell-panel-layout/map.md

@@ -29,9 +29,11 @@ Labels: wayfinder:map
 - **`issues/41`–`48` 是监测点定位/设备联动决策地图收口后的执行链**:41 定位与面板锚定只依赖已完成的 37,可立即认领(**2026-09-29 状态:实施完成 + 纯逻辑 37/37、变异 15/15,待真机走查,未 close** —— 走查是收口唯一缺口,详见票面);完成后 42 关联设备临时图层;42 完成后 43 面板/三维双向对应、44 设备位置符号与静态状态词表、46 模式图层计划可并行;45 重叠呈现依赖 43/44/46;47 动态状态特效依赖 38 雾气、44 静态词表、45 重叠呈现及 46 模式计划;48 端到端验收依赖 40 主场景区质量收口和本链全部实现。规格来源分别是 `cockpit-point-locate-and-device-link/issues/14`–`18`、票 03/04/07/12 的已决策结论;后端 #69 已发布,设备坐标无可信校核时必须清单-only 降级。
 - [重做沅陵县城体块模型](issues/35-city-massing-redo.md) 的历史2026-09-30阶段记录(95%,非当前验收状态):找到权威建筑来源——本地 1:500 测绘 CAD(`沅陵2024*.dwg` 的 JMD 居民地图层),经 ArcGIS arcpy 转出 **主场景区内 60,744 个房屋轮廓**,1:1 影像对照确认精确贴合屋顶(保留 L 形/天井/组合体量),取代影像分割。BIM 管线(足印→ENU→DEM 座落→Blender 空间 LOD)已跑通,**9 个批次全部通过 `verify-lod-district.mjs`,全场景去重导出 48,021 / 48,425 = 99.2%**(城区 29,755 栋 100%、乡村 18,266 栋;LOD0 合计约 923MB;`select-cad-bim-batch.mjs` 确定性切批并跨批去重)。主场景区外 0。仍未完成:层高校准(测绘注记无层数)、运行态性能实测与维护者视觉验收。
 
+- [50 局部管道示意模型细节与中心定位环移除](issues/50-untitled.md) — 已关闭(2026-10-20 维护者现场目检验收通过):中空 Lathe 套筒管壁、两端法兰各 8 螺栓、分节接缝,无独立定位环;离线 `t50-pipe-detail.mjs` 9/9。记录教训:`deck_issue_patch` 传空 `body` 会擦除票面正文(本票三次),改票时不要传空 `body`。
+
 - [58 地下管线详情视图场景设备图标](issues/58-untitled.md):从几何小体块升级为相机朝向Sprite圆形行业色徽标+设备计量符号,按镜头距离补偿固定屏显尺寸;图标射线直接派发设备身份,列表/details共用同一详情。DataTexture随场景销毁释放;t52-device-pick覆盖图标存在/屏幕尺寸/遮挡命中/拖拽/销毁;t23-click-flow覆盖Vue列表与内部详情。全套离线回归通过,未运行build/dev/browser/GPU;待正式入口现场验收。
 
-(issues/56-untitled.md):已核对实时 `TCGC202609080910` 与 `TEST-TCLLJ002215`(约1m邻近、合法坐标、设备类型字段为空);详情模型对无类型设备强可见,缺清单/渐进/稳定挂载保留;聚合通用指标EMPTY时按档案类型/名称路由流量、压力、漏失专用源,401转不可用不伪造读数。t56、t55及既有回归通过,待后端专用接口权限和现场画面验收。
+- [56 真实供水流量计可见性与按设备类型最新指标](issues/56-untitled.md):已核对实时 `TCGC202609080910` 与 `TEST-TCLLJ002215`(约1m邻近、合法坐标、设备类型字段为空);详情模型对无类型设备强可见,缺清单/渐进/稳定挂载保留;聚合通用指标EMPTY时按档案类型/名称路由流量、压力、漏失专用源,401转不可用不伪造读数。t56、t55及既有回归通过,待后端专用接口权限和现场画面验收。
 
 - [55 地下管线详情视图可用性修订](issues/55-8.md):按最新反馈恢复源径×8横向显示(替代54的无放大规则,源径和地理长度仍独立保留);修复基础设施详情隐藏设备、缺编码清单丢设备和慢点加载屏障,逐批呈现/稳定挂载/邻管避让/清单聚焦;最近视距2cm、鼠标射线接近及近处平移减速;视图内邻管可点选切完整详情;程序纹理凹凸和侧光增强材质。新回归8/8、渐进来源通过,原12脚本及19/19输入、Vue邻管标题/共享选择与SFC通过;最终只读复核无剩余P1/P2。代码完成待人工画面验收,未build/dev/browser/GPU。