Эх сурвалжийг харах

docs(issue-50): record human-handoff class and visual checklist

ChenJZ 19 цаг өмнө
parent
commit
60cecf6ddd

+ 58 - 3
.scratch/cockpit-shell-panel-layout/issues/50-untitled.md

@@ -23,9 +23,56 @@
 
 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 显示)
+
+| 项目 | 数值 |
+| --- | --- |
+| 显示半径 R | 1.600 m |
+| 内腔半径 | 1.408 m |
+| 管壁厚 | 0.192 m(R 的 12%) |
+| 法兰外径 | 2.208 m(R×1.38) |
+| 法兰厚度 | ≤0.480 m(短管 0.983 m 时 0.147 m) |
+| 螺栓中心半径 | 1.872 m(落在法兰面 1.408–2.208 m 内,不悬空) |
+| 螺栓半径 / 数量 | 0.160 m / 每端 8 颗 |
+| 分节接缝 | 每 1.2 m 一节,最多 8 节 |
+
+目检时可用这些数值判断比例是否合理,而不是凭印象。
+
+## 可复跑的离线证据
+
+- 模型回归:`node .scratch/cockpit-shell-panel-layout/verify/t50-pipe-detail.mjs`(9 项:轴向通腔、壁命中、法兰/螺栓、接缝/去环、行业色与源不变、逐资源释放、短管不拉伸、纵向腔体、折线仅两端法兰、重复销毁)。
+- 相关批次:`node .scratch/cockpit-shell-panel-layout/verify/t50-53-local-enhancement.mjs`。
+
 ## 进度
 
-代码完成,离线通过;待现场视觉验收。准备继续51邻域管网。
+- 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`。
 
 Status: ready-for-human
 Assignee: codex
@@ -35,10 +82,18 @@ Labels: ready-for-human, wayfinder:task
 
 ## Comments
 
-
 ### local — 2026-10-16T07:57:00.375Z
 票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 被误擦,已恢复并补入人工接手分类、实施清单与可复跑命令。
+
+### 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 通过。
 
 ## Answer
-代码完成,待维护者现场视觉确认。
+
+代码完成、离线 9/9 通过;剩余唯一动作是维护者本人在正式入口目检画面观感,确认后即可关闭本票。