卡④T6+卡⑤T4文档尾笔(迭代47): 实现报告+反哺点清单——实际对照表三卡全量/迁移留痕表/实现决定记录十项/反哺点十二条;独立验收审计待派(合回前置)

2026-11-01 18:54:09 +08:00
1 parent 4e4232d804
commit 5a113331b6
@@ -0,0 +1,19 @@
+# 迭代 47 反哺点清单（实现批未写 design/ 与根规则文件——逐条待用户裁决后由文档批落文）
+
+- 接收方：待办清单「营地交互重做·五张需求卡片」条目（裁决后逐条清掉）＋各 owner 文档
+- 依据：卡⑥/卡④/卡⑤ §5 关联文档同步面全表义务格＝反哺点·列清单
+
+| # | 文档 | 位置 | 原句/现状 | 拟改 | 依据 |
+|---|---|---|---|---|---|
+| 1 | architecture.md | 呈现层模块清单/测试与质量域 | 无 UiCampModals/四子界面/CampRefreshBus/MainEscFlow/CampHudBand/CampSceneView 六新件行 | 增六件归属行（呈现层/组合根拆件）＋LAYER_CONTRACT 槽变化（camp_overlay→camp_scene+四子界面+camp_esc_overlay）＋产品码首个键盘输入入口（main._unhandled_input 契约 9 接线）注记 | 卡⑥/④/⑤ 落地实况 |
+| 2 | camp.md | §顶栏 :39-41 / §叠层与开合 :43-45 | 「刷新入口＝营地刷新单口（卡⑤同口挂接）」未记实装；承载形态「归卡④ §9 代拍板域，本 spec 不预设值」 | 回填实装状态（单口=CampRefreshBus 已挂/时机清单三条）＋承载形态=单一内页切换（场景根留底）拍板值落文 | 卡④ T2/T3＋卡⑤ 实装 |
+| 3 | art-bible.md | §6.2 :393 围墙细条句 / §4.1 场景环境子板 | 「围墙层落盘按细条 (0,240,1280,70) 裁」；环境子板色值待登记 | 细条句补实装值 (0,261,1280,49)（Y 压缩桩身 43 锁定值精确，备选 A′ 在档）；登记营地 32 色主色板（色值清单=artwork/2026-11-01-营地终稿后处理/换算式登记.txt，两道门合规零违例对） | 卡④ T1 实测＋§0.3-3⑤ |
+| 4 | camp-scene-prompts.md | §2.3 坐标表 / §4 验收 | 贴图矩形=规划值（130×140 等）；单张 ≤32 量化后 | 八物件 contain 实测尺寸表（board 130×121 等——呈报备案追认值）＋量化实况注记 | 卡④ T1 换算式登记 |
+| 5 | 生涯.md | :72 营地行（P6 条带去向） | 「营地条带的去留是本提纲必答项——见 §五 P6」 | P6 注销（Q4=甲：条带随四柜台拆解撤下，逐局历史回看归生涯——本批已撤） | 卡④ Q4 裁定落地 |
+| 6 | 08-Alpha版本标准.md | :193 「键盘 / 手柄输入（排 Beta）」 | Beta 行未注记 Esc 已落地 | 行内加注「例外：营地语境 Esc 浮窗已落地（用户明示裁决，澄清⑤裁决 9；键盘面仍排 Beta——本批只落 Esc 一项）」 | 卡⑤ 契约 2/9 |
+| 7 | 待办清单.md | 营地交互重做条＋UI 贴图重构条＋图鉴挂起 | 条目状态「已编迭代 47」；贴图重构条对象注记；图鉴挂起 | 状态推进（完成即整条删除）＋实况换代（三卡收口凭据）；贴图重构条「四柜台对象变化」注记更新（柜台形态已退役）；图鉴挂起条入口改挂注记 | 三卡实装 |
+| 8 | 体验验证清单.md | 新增目检条 | — | 登记 §实现报告 §6 五条（场景观感/点选反馈/大门篝火/Esc HUD/四子界面）——登记不阻塞 | 卡④ V11＋卡⑤ V9 |
+| 9 | roadmap.md | 迭代 47 行＋当前位 | 状态「待开工」 | 行换代（三卡实现报告列＋状态）＋当前位三行换代 | 迭代收口 |
+| 10 | shot_checker 色数判据 | tools/shot_checker.py A 段 | camp 屏唯一色数 ≥64 | L3 呈报在案（读法 A/B 待裁）——裁决后判据修正随批＋待办清单登记条 | 停机呈报 2026-11-01 |
+| 11 | asset-path-map.md §3 / art-assets-checklist.md §3.5 | 营地 10 张路径行 | 登记超前注记 | 实装入库确认（scene_camp_* 十件在役＋TEX_CAMP_* 十键消费）＋终稿置换待用户游戏内终审注记 | 卡④ T1 |
+| 12 | ui_kit CAMP_HEADER_BAND 令牌 | ui_kit.gd :178 邻域＋ui_contrast 表 | 令牌在役（新界面零消费） | 令牌退役评估（现役消费面=ui_contrast 表已注销四行后零消费——随令牌批处置，非本批强删） | 卡④ T5 核签 |
@@ -0,0 +1,117 @@
+# 迭代 47 实现报告（卡⑥ 营地模态句柄子容器批＋卡④ 营地场景图新建批＋卡⑤ Esc 浮窗与营地顶栏批）
+
+- 接收方：roadmap.md 迭代 47 行（实现报告列）＋待办清单「营地交互重做·五张需求卡片」条目
+- 性质：代码实现批产出物（实现批唯一可写目录=reports/；design/ 与根规则文件零写入——反哺点清单另立）
+- 分支：iter47（worktree g-plan2-iter47）· 基线 5ad72f44 · 收口提交史见 §9
+
+## 1. 各卡状态
+
+| 卡 | 状态 | 提交 | 出口验证 |
+|---|---|---|---|
+| 卡⑥ 句柄子容器批 | 收口 | 3a9c6ff4 | --code 全套闸 all_green；V1/V2/V3 留痕齐 |
+| 卡④ 营地场景图批 | 施工完成（T6 出口闸等 shot_checker 裁决重跑） | aa4aa1dd/4b5e3f27/98470adc/5a0e7069/1243ffe6/52296872 | 七探针+system_test 全绿；V14 11 项绿；--code 闸 01-04/09/10 绿、05 渲染闸红=L3 呈报在案 |
+| 卡⑤ Esc 浮窗与顶栏批 | 施工完成（T4 出口闸同上） | 4e4232d8 | 冒烟 PASS+system_test 69/0+七探针全绿 |
+
+## 2. 卡⑥ 实际改动—验收对照表（尾缀〔句柄子容器批 Vn〕）
+
+| 需求点 | 改动 | 验收测试 | 层级 | 真实入口 | 判据绑定面 | 结果 |
+|---|---|---|---|---|---|---|
+| V1 句柄迁移零行为漂移 | ui_camp_modals.gd 新件；ui_modals 持 camp 删平铺；main_ui_build 装配 10 处；改指面 8 文件 43 处 | 五探针营地段＋system_test V1c:94-106＋句柄同一性链 :108 | 探针＋系统 | 现役营地断言逐件复跑（断言零改寻址新） | 全段绿=零漂移；全仓 grep 零 modals.camp.overlay 残留 | 绿（V1 尾缀 34 处 grep 在位） |
+| V2 层序合同零漂移 | ui_registry node() 返回链改写（key 平铺不改名） | system_test V1c 合同树序链 | 系统 | LAYER_CONTRACT 单一事实源 | 树序链绿=合同落位零漂移 | 绿（V2 尾缀 :106 在位） |
+| V3 S13 读数 | ui_modals 类变量 14→14 | gdstyle gate＋grep -c '^var ' 计数 | 静态 | static_scan.sh | gate 绿零 NEW＋计数=14 留痕（观测面局限：闸对 14/15 同零命中，人工计数承载） | 绿（143 件零 NEW；计数 14） |
+
+## 3. 卡④ 实际改动—验收对照表（尾缀〔营地图批 Vn/Bn〕）
+
+| 需求点 | 改动 | 验收测试 | 层级 | 真实入口 | 判据绑定面 | 结果 |
+|---|---|---|---|---|---|---|
+| V1 场景图形态 | camp_scene_view 10 层铺底＋layout.tres＋camp_screen 改挂 | shot_probe camp 段（截图=场景图）＋ui_struct 场景层序段＋shot_checker 结构段 | 探针 | 进存档→选档→进档→营地场景屏 | 截图实拍=场景图形态（十层合成/门洞透路/七物件就位）；子节点序=表 z 序逐层；贴图矩形逐值 | 绿（截图目检+层序段 11 层断言） |
+| V2 七物件可达＋叠层退避 | 七命中区＋object_pressed＋组合根路由 | ui_probe/ui_click/ui_struct 场景点选段 | 探针 | 命中区→_gui_input→object_pressed→路由 | 锻炉/宝箱/木桩/布告板/笔记本/篝火/大门逐一 object_pressed 驱动可见性 | 绿（七件路由断言分散六探针全绿） |
+| V3 大门两分支＋开局收闭 | confirm_dialog 三钮化＋消费方编排扩展＋main_overlay_flow 路由 | ui_click 大门两分支段 | 探针 | 场景点选 gate→确认弹窗→分派 | 点大门不直接进冒险（is_adventure 翻转只在 confirmed 后）；cancelled 写口零调用＋营地根 visible；开局后营地隐藏 | 绿（无断点两出口+有断点三出口 set_breakpoint 注入全过） |
+| V4 五界面功能＋写口零回归 | 四 view 抽出＋presenter 承接面＋bus 单口 | forge_workbench_test（承载类同迁断言零改）＋ui_click 购买链 | 单元＋探针 | 意图信号→presenter→MetaProgression 写口 | 树购买出账+持久（reload 后级=1）/Fork 持久/锻造三意图——全链复跑绿 | 绿（12 项+点击链 0 问题） |
+| V5 生涯只读契约 | career 入口改挂笔记本（本体零改） | ui_struct career 段（笔记本真实路由） | 探针 | 笔记本命中→object_pressed→_open_career | 生涯页可达+三契约不破+营地语境关生涯不回开始层 | 绿 |
+| V6 图鉴挂起态 | codex_view 占位壳 | ui_click 灰字段（锚=结构位预留） | 探针 | 布告板命中→codex 开 | 占位锁文锚定＋零激活禁行＋非禁用态 | 绿 |
+| V7 篝火动线 | 路由 campfire→二次确认→on_camp_closed | screen_flow 回退段＋ui_click？ | 探针 | 篝火命中（只下半）→确认→主菜单 | 二次确认 confirmed 先于关层；确认后营地+选档同收+菜单显 | 绿（screen_flow ③步+T4 孤检） |
+| V8 顶栏位＋刷新单口 | set_hud_band 预留位＋camp_refresh_bus 新件 | ui_struct 顶栏位段＋卡⑤ HUD 段 | 探针 | 写口尾→bus.refresh→现开界面+HUD | 顶栏位 48px 在座；写口尾一闸刷新（八尾改路由） | 绿 |
+| V9 反参照纪律 | 场景根态零按钮 | ui_struct 反参照段 | 探针 | 场景根子树 Button 计数 | 根态零文字按钮（禁文字按钮列表形态） | 绿 |
+| V10 美术约束 | shot_checker camp 骨架段＋素材二器 | ui_contrast 令牌表＋palette_check 读数 | 机检 | camp 截图＋素材文件 | 见 §7 遗留读数义务（A 段色数判据=L3 呈报在案） | 部分（令牌 36 对绿；A 段红待裁） |
+| V11 目检登记 | 实机目检总清单 | 件核对（§6） | 目检 | 用户实机 | 登记即义务了结（不阻塞） | 已登记（§6） |
+| V12 探针迁移留痕 | F8 全量位点 | 件核对（本表＋§8 迁移留痕） | 件核对 | 探针 diff 对账 | 逐点改前→改后 | 绿（§8） |
+| V13 反哺点清单 | §5 同步面 | 件核对 | 件核对 | 反哺点文档逐条 | 每条有落点 | 绿（反哺点文档） |
+| V14 layout 数据件校验 | schema validate＋fail-fast 钩子 | camp_scene_layout_test.gd:_test_layout_hotspot_geometry（manifest 登记） | 单元 | 单测载入 .tres＋ConfigDB 装载链 | 校验通过＋七命中区几何红线＋关系谓词零坐标字面量 | 绿（11 项） |
+| B1 组合根接线总改造 | main.gd 路由/三钮编排/篝火/收闭＋bus | ui_click 大门段＋screen_flow 篝火段 | 集成 | 确认分派/_resume/_start/bus.refresh | 三钮消费方编排 open 前设后分派；cancelled 零写口；篝火确认离场 | 绿 |
+| B2 CampOverlay 退役＋四界面抽出 | overlay 删除＋四 view＋五句柄子容器 | forge_workbench_test＋全仓件核 | 集成 | 五界面 open/close→模态栈单口 | 旧件零残留（件核一）；承载类同迁断言零改 | 绿 |
+
+## 4. 卡⑤ 实际改动—验收对照表（尾缀〔ESC批 Vn/Bn〕）
+
+| 需求点 | 改动 | 验收测试 | 层级 | 真实入口 | 判据绑定面 | 结果 |
+|---|---|---|---|---|---|---|
+| V1 Esc 唤起四态 | camp_esc_overlay＋main_esc_flow＋main._unhandled_input | screen_flow Esc 步 | 探针 | push_input 合成 Esc（真实键盘路径） | 根态唤起/再按关窗/echo 零响应/子界面无反馈/设置开态不误关/菜单语境不唤起 | 绿（10 项） |
+| V2 浮窗三项 | setup_buttons 三钮 | ui_struct 浮窗段 | 探针 | 浮窗视图实例化 | 三钮在位且仅三（_buttons 递归计数） | 绿 |
+| V3 返回主菜单 | _on_return_to_menu（首步 close 浮窗） | screen_flow 返回动线段 | 探针 | return_requested→动线 | 浮窗自收＋营地隐＋选档收＋菜单显（四可见性） | 绿 |
+| V4 设置双路径 | _on_settings＋语境分支 | screen_flow 设置段 | 探针 | settings_requested→open→closed | 设置开浮窗恒 visible（树序遮挡非属性隐藏）；关后回浮窗不回主菜单 | 绿 |
+| V5 退出项 | _on_quit→_quit_game 复用 | 连接链断言（main_ui_build 接线在位） | 静态 | quit_requested→_on_esc_quit→_quit_game | headless 不可真退＝静态判据＋观测面局限申报（本表） | 绿（接线段随装配绿证） |
+| V6 HUD 余额 | camp_hud_band＋bus 挂册＋进档尾刷新 | screen_flow HUD 段 | 探针 | 隔离档直写 _add_keystone(9999)→显式触发 bus.refresh | badge 文本=「钥石 9999」（单口现值，显式触发才变） | 绿 |
+| V7 零动效 | 直开直关 | ui_struct 浮窗段 | 探针 | 双件源码＋子树扫描 | 零动效令牌＋AnimPlayer=0（扫描面>0 非空前置） | 绿 |
+| V8 层序与遮挡 | contract 第六槽＋node() | system_test V1c 复跑＋ui_struct badge 段 | 系统＋探针 | 合同表单一事实源 | 树序链含新槽逐对保序；badge 零波及 | 绿 |
+| V9 目检登记 | 实机目检总清单 | 件核对（§6） | 目检 | 用户实机 | 登记即义务了结 | 已登记（§6） |
+| V10 反哺点清单 | §5 同步面 | 件核对 | 件核对 | 反哺点文档 | 每条有落点 | 绿 |
+| B1 Esc 接线与浮窗 | 输入入口/薄委托/视图/新槽 | screen_flow＋ui_struct | 集成 | 合成 Esc→路由→flow.open/close | 四态路由绑现开集合与调用记录 | 绿 |
+| B2 HUD 落位与刷新 | band 新建/set_hud_band/bus 挂册 | screen_flow HUD 段＋ui_struct 顶栏段 | 集成 | bus.refresh→band.refresh_camp→badge | badge=单口取值；顶栏位结构在座 | 绿 |
+| B3 设置语境分支与三出口 | _on_settings_closed 分支＋三出口动线 | screen_flow 设置段＋返回段 | 集成 | 三钮 pressed→MainEscFlow | 关设置回浮窗禁弹主菜单（反向断言）；退出连接链 | 绿 |
+
+## 5. 实现决定记录（代拍板追认单——随 commit 留痕汇总）
+
+1. **承载形态＝单一内页切换（场景根留底）**（卡④ §9-2 域内）：模态栈 open 只隐上方登记层（modal_stack.gd:27 实测），四子界面登记于场景根之上且实底遮挡——双开互斥靠遮挡天然成立；V2 断言按留底派生（子界面开=场景根 visible 保持）。
+2. **围墙层处理路线 A″**（用户裁 A 后处理实现）：去底（边界泛洪+奶油描边屏障 BG_TOL=50）→门洞手术（门柱内移+克隆桩列，缺口 675→480 源=240 终稿精确）→Y 轴压缩（桩身 609→86 源=43 终稿锁定值精确，整带 692→98 落盘 (0,261,1280,49) 底锚 y310）；备选 A′（带高 70/桩身 62）存档 artwork 同目录。竖向克隆接缝 3× 放大可辨、1× 游戏尺度不可辨（申报）。
+3. **八物件 contain 落位尺寸**（呈报备案追认）：board 130×121/gate 240×211/dummy 120×180/forge 240×193/tent 251×170/chest 106×90/notebook 100×66/campfire 160×149（锁定矩形 contain，命中矩形按锁定值）；贴图锚定=底中心（帐篷/锻炉/宝箱/篝火/笔记本）＋顶锚（门扇悬挂/布告板挂墙）。
+4. **营地主色板 32 色**（§4.1 场景环境子板两道门合规）：各层独立量化→并集 272→最近对合并 120 轮→32 色零违例对；十层按终版色板重量化回写。色值清单=换算式登记.txt，登记 art-bible §4.1 走反哺点。
+5. **codex 锁文称谓订正**（L2）：「柜台结构位预留」→「结构位预留」（零新文案——『柜台』随形态退役）。
+6. **set_close_path 未落独立方法**（L2 API 面）：Q2 关闭路径=组合根 Esc 路由直呼 flow.close(浮窗)，视图无自关通路——卡面「关闭由组合根路由」直译；bind_signals 承载三钮意图外发。
+7. **契约 9 分支序实证修正**：①先于②（设置开在浮窗之上态先命中无反馈）——首装②先被 screen_flow Esc 段实机场景证伪（2 红），按卡面编号归位后全绿。
+8. **CampSceneView 初始隐**：_init visible=false（登记模态初始隐——boot 态场景根盖菜单三红同源修复）。
+9. **ui_modals 头注/迁移面**：卡⑥ 头注换代（十二平铺+营地域子容器）✓；ui_struct 层序注释换代（camp_scene 代言）✓。
+10. **卡④ T0 预算预案兑现**：main.gd 15/15 恰贴上限——T3/T4/T5 实现零新增成员（路由走 MainOverlayFlow 静态件+薄委托）✓。
+
+## 6. 实机目检总清单（登记不阻塞——体验验证清单入册条目由文档批落）
+
+1. 营地场景观感：十层构图/围墙门洞/纵深（V11——纵深稿「中景 2/3」可辨性）。
+2. 七物件辨识与点选反馈：悬停轮廓+浮动+名牌/按下位移/锻炉宝箱禁用态（未解锁档）。
+3. 大门两分支弹窗（三出口文案与位次）＋篝火二次确认动线。
+4. Esc 浮窗三动线＋HUD 余额观感＋浮窗视觉面（卡⑤ V9）。
+5. 四子界面视觉（米板身壳/行板/返回钮位次）。
+
+## 7. 遗留读数义务
+
+1. **shot_checker A 段色数判据互斥**＝L3 呈报在案（reports/停机呈报-shotchecker色数判据互斥-2026-11-01.md）——读法 A/B 待裁；裁决后判据修正随批＋闸重跑追绿。
+2. palette_check 读数（V10 素材级）：15 张 0 红灯 0 新增色（只读模式）——48 令牌 baseline 目录在库缺位，双门机检化=工程批事项（反哺点登记）。
+3. 用户在游戏内终审十层素材（2026-10-31 裁定预留）——终稿置换（若有）走反哺点。
+
+## 8. 探针迁移留痕表（V12——F8 全量位点改前→改后）
+
+| 位点 | 改前 | 改后 |
+|---|---|---|
+| screen_flow :54 营地旗标 | modals.camp.overlay | modals.camp.scene |
+| screen_flow 回退段 :119-125 | overlay.closed.emit()+手动关选档 | 篝火动线（object_pressed campfire+confirmed） |
+| screen_flow Esc 段（新增） | —（选档语境零响应段保留） | 十断言步 _step_camp_esc_and_hud |
+| ui_probe 营地段 :26-57 | overlay 余额/树钮/秘宝行 | 场景点选路由→tree/treasure 视图成员 |
+| ui_click 营地段 :60-250 | overlay 树链/灰字六源位 | 树链 tree view+灰字分扫 treasure/codex（锚去『柜台』）+savesel 三处场景根 |
+| ui_click 断点段（卡② 移交） | lvbtn 驱动（已随卡② 撤） | 大门两分支断言段（V3 落位——无断点/有断点 set_breakpoint 注入） |
+| ui_struct :45 audit | audit("camp",[overlay]) | audit("camp",[camp.scene]) |
+| ui_struct 源扫描 :48-50 | camp_overlay_view.gd 单件 | 营地域六件合计（场景根+四子界面+公共壳） |
+| ui_struct 生涯段 :54-69 | 函数直调 _open_career | 笔记本真实路由（open_camp 重入+object_pressed notebook+营地语境分支断言） |
+| ui_struct 场景段（新增） | — | 层序/矩形逐值+锻炉可达+顶栏位+反参照+Esc 浮窗段 |
+| ui_contrast 令牌表 :48-55 | 头带两行+铭牌副题+最近冒险 | 四行随形态注销（CAMP_HEADER_BAND 零消费随退）；ROW_PLATE/PANEL_DATA 行保留 |
+| shot_probe :120-135 | 关闭营地钮收闭 | 截图=场景图＋篝火动线收闭 |
+| system_test V2/:108/:121 | camp_overlay 成员/句柄 | camp_scene 三处机械随迁（T3） |
+| system_test V3g camp 分支 | overlay 开合 | 场景根开合自适配（on_camp_closed 关层收闭） |
+| forge_workbench_test :33 | 直载 camp_overlay_view+._forge._X | 直载 forge_view+扁平成员（断言零改 12 项绿） |
+| theme_projection :711-716/:801-810 | 等高源码断言+最近冒险投影 | 注销（卡面削弱申报授权——旧形态断言失去对象/条带 Q4 甲撤下） |
+
+## 9. 提交史与闸况
+
+3a9c6ff4 卡⑥T1 → aa4aa1dd 卡④T1 进度 → 4b5e3f27 卡④T2 → 98470adc 卡④T3 → 5a0e7069 卡④T4 → 1243ffe6 卡④T5 → 52296872 卡④T5 补 → 4e4232d8 卡⑤T1-T3。
+闸况：卡⑥ 出口 --code all_green（3a9c6ff4 对齐）；卡④ T6 出口闸 01-04/09/10 绿、05 渲染闸红=shot_checker 判据互斥（L3 呈报在案——合回前重跑）。
+
+## 10. 独立验收审计结论
+
+（独立审计报告=reports/iter47-验收审计-2026-11-01.md——结论待审计回填：通过／缺漏／例外及依据。）