game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修卡(迭代47双卡·grilling+godot-master双审修订): 卡④v3.1——开工门四项裁断销号(五裁点逐点拍板/P3·P5销号口径/T1后处理随iter令授权)+现状事实换2026-11-01盘面(smoke退役宿主改指·句柄迁移·行号实测·TEX_CAMP常量落点)+Godot风险项落卡(1024档换算式逐张登记·节点选型钉死Control根+TextureRect+子节点序·layout fail-fast校验入V14·V1场景层序断言·T2实现约束); 卡⑤v1.4——契约9 Esc四态语义与接线定稿(事件驱动_unhandled_input·禁Input轮询·不挂ui_cancel·pressed非echo)+契约3谓词钉死+契约4动线首步浮窗自收+契约5触发主体+V4/V6判据订正+死信排序约束改述+文件表补ui_modals/main_ui_build+V7扫描面扩两新件; 双审复核报告落reports——零待裁点零阻塞,迭代47可开工

Browse Source
This commit is contained in:
DKChan committed 2026-11-01 04:41:21 +08:00
1 parent ab5a45af00
commit b75688c6ca
3 files changed
+184 -107
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

reports/复核-双审-grilling与godot-master-迭代47双卡-2026-11-01.md
+59
View File
@@ -0,0 +1,59 @@
# 复核报告：迭代 47 双卡 grilling＋godot-master 双审（2026-11-01）
- **接收方**：`reports/需求卡片-营地场景图新建批-2026-10-18.md`（卡④，v3.0→v3.1）＋ `reports/需求卡片-ESC浮窗与营地顶栏批-2026-10-18.md`（卡⑤，v1.3→v1.4）。本报告是双审过程稿，裁断与订正已全部吸收进两卡，批末收尾按吸收即死退役。
- **审查构成**：四个独立子代理——卡④ grilling／卡⑤ grilling／卡④ godot-master／卡⑤ godot-master（全程只读、未落盘、未跑测试）。
- **发起**：用户令（开工前审查：零待裁点、零阻塞点、零灰色地带、符合 Godot 设计规范）。
- **裁决**：用户 2026-11-01 裁「都可以按照推荐来」——五裁点照推荐采纳、P3/P5 销号口径采纳、卡⑤ v1.4 补句、卡④ 漂移就地订正＋Godot 风险项落卡。
## 一、双审结论
| 卡 | grilling | godot-master |
|---|---|---|
| 卡④ | 有条件可开工——卡内设计待裁点确为零、重立凭据属实、与卡⑤ 接口名实闭合；但 §0.3 四道开工门实证全部未销号（会卡 T1/T2/T5），另有成片现状事实漂移 | 基本符合有风险项——分层/信号/单点纪律全对齐、零硬违反；风险＝1024×1024 源档降采样算式断裂＋核心视觉不变量机器验收零覆盖 |
| 卡⑤ | 有条件可开工——零真待裁点（Q1/Q2/Q3 留痕完整）；但三处现行文本会指导出错实现（浮窗残留缺陷级／V4 判据与契约 3 矛盾／Esc 第四态未定义） | 基本符合有风险项——浮窗选型/层序/拆件与现役先例同构、零硬违反；风险＝文件表漏列 ui_modals/main_ui_build 两必改件＋Esc 第四态连带语境分支谓词二义 |
## 二、裁断与销号落点（2026-11-01 用户裁）
| 项 | 裁断 | 卡内落点 |
|---|---|---|
| camp-scene-prompts §5 五裁点 | ①帐篷 300×170 追认现值②门扇 240×220 追认③布告板 (845,268,130,140) 挂围墙带④描边奶油色追认⑤环境子板色值不前置（T1 量化后按 art-bible §4.1 两道门登记；T5 色计数改条件步） | 卡④ §0.3－3／§9－4／§10；反哺点（§5 落文归文档批） |
| P3 点选反馈设计稿 | 销号口径＝camp.md v2.2:35-37 四态规格即设计稿；名牌文案与可点区域视觉归 T2 域内 | 卡④ §0.2／§0.3－1 |
| P5 GDD/art-bible 落文 | 销号口径＝形态落文完成；实装回填归 T6 反哺点义务，非停机条件 | 卡④ §0.2／§0.3－2 |
| T1 素材后处理发令 | /iter 开工令即含授权，不再两次发令 | 卡④ §0.3－4／T1 |
| 1024×1024 档降采样 | 逐张登记换算式；1024 档非整数缩放显式特批登记（L2＋实现报告申报局限），不回炉（追认已过审终稿优先） | 卡④ T1 |
| Esc 第四态与接线 | 契约 9 四态优先序（判据单点＝ModalStack 现开集合）＋接线定稿＝事件驱动 `_unhandled_input`＋KEY_ESCAPE、禁 Input 单例轮询、不挂 ui_cancel、pressed 且非 echo | 卡⑤ 契约 9／T0／T1／§9－1 |
| 设置语境分支谓词 | ＝`camp_esc_overlay.visible`（谁开的设置谁收），与 Esc 守卫谓词分立 | 卡⑤ 契约 3 |
| 返回主菜单浮窗残留 | 动线首步 close 浮窗；V3 断言补浮窗 closed | 卡⑤ 契约 4／T3／V3 |
| camp 截图排序约束死信 | 废止原句；按迭代 47 执行序＝卡④ 整卡先、卡⑤ 后，卡⑤ T2 限 HUD 区显式更新兜底 | 卡⑤ §0／卡④ T0 |
## 三、双审独立发现、交叉确证的灰色地带（全部落卡）
1. Esc 第四态（设置开在浮窗之上再按 Esc）——两审独立发现 → 契约 9①。
2. 返回主菜单后浮窗残留（缺陷级）——grilling 发现、godot-master 同域印证 → 契约 4。
3. V4 判据与契约 3 自相矛盾（浮窗恒 visible 由栈语义保证，非属性隐藏）→ V4 改述。
4. V6 badge 文本格式字面不等（带「钥石 」前缀）→ V6 改格式串比较。
5. CampRefreshBus「Bus」命名 vs 全局事件总线否决史（architecture.md:353）→ 卡④ T3 头注自陈＋卡⑤ 措辞「挂接/接收推送」。
6. 文件表漏列 `ui_modals.gd`／`main_ui_build.gd`（S13 触面失察；ui_modals 类变量 14→15 恰贴上限）→ 两卡文件表与存量触面一查补列。
7. 「卡④ T5 晚于卡⑤ T2」排序约束单侧声明且按执行序天然不可满足 → 死信改述（见 §二）。
8. V7 零动效扫描面漏开合编排件 → 扫描面扩两新件；V5 补「禁对退出钮 pressed.emit」；V1 补冒险语境段与 echo 断言；「进档重读」触发主体钉组合根动线尾。
## 四、卡④ 成片事实漂移订正（T0 级，v3.1 就地订正）
`game/smoke/` 已退役（git 16c6f136）→ 探针全在 `game/probe/`；smoke_all.gd 已退役（git 957391e1）→ system_test.gd（V2 :67-68／V3g :520-541）＋theme_projection_test.gd:710-717；`main.camp_overlay` 句柄已退役 → `main.ui.modals.camp_overlay`（ui_modals.gd:14）；F3/F7 行号簇换 2026-11-01 实测；F6「断点弹窗现居主菜单」失实（main.gd:118-120 注释）——T4 承接；`_on_confirm_new_adventure` 已随卡②摘除；`UiKit.TEX_CAMP_*` 尚不存在（本批 ui_kit.gd 新增十键）；`tools/gdstyle.sh` 不存在（→ static_scan.sh／gdstyle_gate.py）；presenters/core 子目录路径订正；`design/gdd/06-待办清单.md` 已迁仓库根；契约 4 行号换实数（八处 :82/90/102/114/126/139/151/165＝七口＋on_camp_buy 双尾）；终局落点 main.gd:703 → main_adventure_flow.gd:123-143。
## 五、卡⑤ F1–F10 抽验
10 条全抽：F1/F2/F3/F5/F6/F7/F8/F9/F10 属实；F4 消费点全对、行号三处系统性 ±1（keystone_badge :633→:632、modal_shell :487→:486、danger_button :700→:699）——已订正。卡外小漂：screen_flow_probe 营地旗标在 :54（:53 是菜单行）、待办清单五卡总条 :447 起——已订正。
## 六、Godot 规范审查补立（卡④）
- 节点选型钉死：Control 根＋TextureRect 层＋子节点序即 z 序；禁 CanvasLayer/z_index/Sprite2D 根（LAYER_CONTRACT 树序落位兼容）。
- V1 扩判据：camp_scene_view 子节点序＝layout 表 z 序逐层相等、纹理矩形与表逐值一致；新增 V14 layout 数据件校验（fail-fast 命中区几何）——核心视觉不变量机器验收面补齐。
- T2 实现约束：浮动经 Tween 禁 `_process`；名牌 Label mouse_filter=IGNORE；禁用态去饱和经 ShaderMaterial；名牌画面内钳制；HUD 载体循 page_shell `PRESET_TOP_WIDE` 先例。
- layout.tres 接 ConfigDB schema 类（先例 battle_layout.tres）＋加载期 fail-fast 校验。
## 七、遗留与开工判定
- **零待裁点、零阻塞点**：卡④ §0.3 四道开工门全部裁断销号；卡⑤ 零真待裁点、开工按序随卡④ 代码波（迭代内排序，非跨迭代阻塞）。
- 反哺点两件归文档批（不阻塞开工）：camp-scene-prompts §5 节改已裁＋art-bible :398 对应值落文；camp.md/art-bible 实装状态回填（T6 义务）。
- **判定：迭代 47 可开工**（卡④ → 卡⑤ 按序，`/iter` 发令即起 T0）。
reports/需求卡片-ESC浮窗与营地顶栏批-2026-10-18.md
+52 -43
View File
@@ -1,19 +1,19 @@
# 需求卡片：Esc 浮窗与营地顶栏批（营地顶部小 HUD 栏 · Esc 三钮浮窗）· 营地交互重做卡⑤
- 版本：**v1.3（现行有效卡）**。留痕：Q1/Q2/Q3 均于 2026-10-18 裁定（甲／甲／甲，见 §10，已裁非待裁）；契约 2 随 Q3 升格；卡④ 2026-10-31 已重立为 v3.0 现行有效卡，本卡随卡④ 代码波同行（改动沿革只进 git commit log）。
- 版本：**v1.4（现行有效卡）**。留痕：Q1/Q2/Q3 均于 2026-10-18 裁定（甲／甲／甲，见 §10，已裁非待裁）；契约 2 随 Q3 升格；卡④ 2026-10-31 重立、2026-11-01 修订为 v3.1 现行有效卡，本卡随卡④ 代码波同行（改动沿革只进 git commit log）；2026-11-01 grilling＋godot-master 双审后用户令修订——契约 9 Esc 四态语义与接线定稿新立、契约 3 谓词钉死、契约 4 动线补浮窗自收、契约 5 刷新触发主体补钉、V4/V6 判据订正、§0 死信排序约束改述、文件表补 ui_modals/main_ui_build 两件、触发沿 echo 过滤。
- 来源：[需求澄清-营地交互重做-2026-10-18.md](需求澄清-营地交互重做-2026-10-18.md)（唯一事实源：⑤裁决 9/10、④结构树语境、⑦切批原则⑤）
- 归属：呈现层/组合根（`game/presentation/`）——营地交互重做五卡之五
- 排期：未编入（2026-10-18 用户令：需求卡片不预占迭代号，批次归属按工作量另裁）
- 开工门：U0（用户 `/iter` 发令）＋ 零待裁点（Q1/Q2/Q3 已裁，见 §10）＋ grilling 复核门过＋ **卡④ 代码波落地后**（卡④ 2026-10-31 已重立为 v3.0 现行有效卡、设计线闭合；本卡浮窗与 HUD 落在卡④ 新建的场景屏上，排期随卡④ 代码波之后，卡片本身有效）
- 开工门：U0（用户 `/iter` 发令）＋ 零待裁点（Q1/Q2/Q3 已裁，见 §10；2026-11-01 双审零新增真待裁点）＋ grilling 复核门过＋ **卡④ 代码波落地后**（卡④ v3.1 现行有效卡、设计线闭合、开工门已裁断销号；本卡浮窗与 HUD 落在卡④ 新建的场景屏上，排期随卡④ 代码波之后，卡片本身有效）
## 0. 前置依赖与并行性
- 前置卡④（营地场景图，2026-10-31 已重立为 v3.0 现行有效卡）：Esc 浮窗的「返回主菜单」与顶栏 HUD 都落在卡④ 新建的营地场景屏上；卡④ 设计线已闭合（样张过审 2026-10-31＋art-bible v3.24 §6.2）——本卡不可先于卡④ 代码波落地，排期随④ 之后；本卡自身零美术依赖（零新素材、裁决 9/10 已给全），设计前置检查通过，卡片有效。
- **跨卡接口（保持既有名，不改名）**：①场景屏顶栏位（卡④ T2 预留；卡④ v3.0 挂接签名＝`camp_scene_view.gd set_hud_band()`，「卡⑤ 填值」）；②**营地刷新单口**（卡④ T3 定义；卡④ v3.0 定名 `camp_refresh_bus.gd` 的 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`）——本卡 HUD 刷新挂该单口，**非已退役的 `refresh_camp`**；③子界面返回钮承诺（卡④ T3——Q1 甲案前提：五界面各带返回／关闭钮）；④卡④终局落点不变量（T0 互证：现役＝终局 continue 回主菜单，`main_adventure_flow.gd:124-143` 终局出口 `_begin_session(false)`，行号 T0 复核；若后续改落点为营地则本卡「返回主菜单」动线须补会话收束）。卡④ v3.0 已原样承接上述四项，接口名无改动。
- 前置卡④（营地场景图，v3.1 现行有效卡——2026-11-01 双审修订、开工门已裁断销号）：Esc 浮窗的「返回主菜单」与顶栏 HUD 都落在卡④ 新建的营地场景屏上；卡④ 设计线已闭合（样张过审 2026-10-31＋art-bible v3.24 §6.2）——本卡不可先于卡④ 代码波落地，排期随④ 之后；本卡自身零美术依赖（零新素材、裁决 9/10 已给全），设计前置检查通过，卡片有效。
- **跨卡接口（保持既有名，不改名）**：①场景屏顶栏位（卡④ T2 预留；卡④ v3.1 挂接签名＝`camp_scene_view.gd set_hud_band()`，「卡⑤ 填值」）；②**营地刷新单口**（卡④ T3 定义；卡④ v3.1 定名 `camp_refresh_bus.gd` 的 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`）——本卡 HUD 刷新挂该单口，**非已退役的 `refresh_camp`**；③子界面返回钮承诺（卡④ T3——Q1 甲案前提：五界面各带返回／关闭钮）；④卡④终局落点不变量（T0 互证：现役＝终局 continue 回主菜单，`main_adventure_flow.gd:123-143` 终局出口 `_begin_session(false)`，行号 T0 复核；若后续改落点为营地则本卡「返回主菜单」动线须补会话收束）。卡④ v3.1 已原样承接上述四项，接口名无改动；场景根句柄名与 `LAYER_CONTRACT` 槽名由卡④ T0 定稿（显式验收点），本卡只消费不改名。
- 卡②的退出游戏钮、现役设置面——本批只复用不重做（契约 3）。
- 与卡④同批或随后（两卡触碰同一新屏）。**探针入口路径依赖卡②③链**：营地交互重做后营地只能经「菜单三钮→进入存档→选档→进档」到达——本卡 V1/V3 探针段隐含依赖该全链在位；卡②③ 工程波已随迭代 33 合回（待办清单 2026-10-18 条实况），探针段全链在位，无挂起前提。
- **多卡共改文件分界（`screen_flow_probe.gd`）**：卡④ T5 改该文件营地键语义（:53→新场景根句柄）与回退段（:119-125）；本卡 T3 扩展该文件 Esc 合成段（现 :153-165 已有「选档语境 Esc 零响应」断言）为营地语境 Esc 浮窗断言段。两段按行域分界，各自改各自段，禁互相覆盖；T0 与卡④ 对齐行域。
- **camp 截图/golden 联动**：HUD 栏落营地场景屏会改 camp 截图内容——若本批晚于卡④单跑，卡④ 刚重制的 camp 断言基线必再漂移；若同批，卡④ T5 迁移时点须晚于本卡 T2 HUD 落位（排序约束）。本卡 T2 含「HUD 落位后核漂移热区→限 HUD 区显式更新＋呈报」条；现无 camp 逐像素 golden（卡④ 契约 10）。
- **多卡共改文件分界（`screen_flow_probe.gd`）**：卡④ T5 改该文件营地旗标语义（:54→新场景根句柄；:53 是菜单行——v1.4 订正）与回退段（:119-125）；本卡 T3 扩展该文件 Esc 合成段（现 :153-165 已有「选档语境 Esc 零响应」断言）为营地语境 Esc 浮窗断言段。两段按行域分界，各自改各自段，禁互相覆盖；**分界锚＝断言段语义/段名，不锚行号**（一侧插删行会平移另一侧行号，2026-11-01 双审补立）；T0 与卡④ 对齐。
- **camp 截图/golden 联动（v1.4 改述，原排序约束句废止）**：HUD 栏落营地场景屏会改 camp 截图内容。按迭代 47 执行序（roadmap 迭代总表格内排列顺序＝执行顺序——卡④ 整卡先行、卡⑤ 后），卡④ T5 的 camp 断言基线建立在**无 HUD 场景屏**上；本卡 T2 HUD 落位后核漂移热区→限 HUD 区显式更新＋呈报（T2 已列该条）。原 v1.3「卡④ T5 迁移时点须晚于本卡 T2 HUD 落位」句在上述执行序下天然不可满足（死信），2026-11-01 用户裁改述如上；现无 camp 逐像素 golden（卡④ 契约 10）。
## 1. 目标与完成定义
@@ -32,14 +32,14 @@
4. 浮窗零动效直开直关（生涯页同款契约）；新层入 `LAYER_CONTRACT`；
5. 批末重闸按改动域选档全绿；三份 `reports/` 产出物写齐（T4）。
## 2. 现状事实（2026-10-18 实查；2026-10-31 复核行号，开工日 T0 再核）
## 2. 现状事实（2026-10-18 实查；2026-10-31 复核行号；2026-11-01 双审全量复核——F4 行号 ±1 漂移订正、F9 补全路径，开工日 T0 再核）
| # | 事实 | 出处 |
|---|---|---|
| F1 | **产品码零键盘快捷键处理**：`KEY_ESCAPE`/`ui_cancel`/`ui_accept` 在 `game/core/`＋`game/presentation/` grep 零命中——Esc 浮窗产品码从零新建，无旧路径可迁。**但探针侧已有键盘合成先例**：`screen_flow_probe.gd:156-160` 用 `InputEventKey`（keycode＝`KEY_ESCAPE`）经 `Viewport.push_input(ev, true)` 合成，断言「选档语境 Esc 零响应」（:153-165，卡⑤ 范围外的零实现断言）——键盘事件合成机制已实证，T0 由「从零 spike」改为「复核该先例并迁移到营地语境」。鼠标 `push_input` 先例＝`ui_input_probe.gd:84-116`（`InputEventMouseMotion`／`InputEventMouseButton`；原 `game/smoke/` 目录已不存在，全部探针在 `game/probe/`） | `game/probe/screen_flow_probe.gd:153-165`；`game/probe/ui_input_probe.gd:84-116` |
| F2 | 设置面在役：开＝`_open_settings()`（`main.gd:444` 薄委托→`main_overlay_flow.gd:7-9`：`start_overlay.visible=false`＋`ui.modals.flow.open(settings_overlay)`）；关＝`_on_settings_closed()`（`main.gd:448`→`main_overlay_flow.gd:11-13`：`ui.modals.flow.close`＋**`start_overlay.visible = true` 硬副作用**——营地语境照抄会在关设置后弹主菜单，须语境分支，契约 3）。开合走组合根模态编排口 `ui.modals.flow.open/close`；静态承接件是 main 同名函数逐字搬运、main 侧留薄委托，探针 `main.X` 路径零改动。`_open_settings`/`_quit_game` 菜单钮调用点见装配段（T0 复核行号） | `main.gd:444`／:448；`game/presentation/main_overlay_flow.gd:7-13` |
| F3 | 退出游戏在役：`_quit_game()`（`settings_store.save_settings()` 后 `get_tree().quit()`；无语义副作用，可原样复用） | `main.gd:143-146` |
| F4 | 钥石徽工厂件在役：`UiKit.keystone_badge` 定义 `ui_kit.gd:633`；消费点四处产品码——营地顶栏 `camp_overlay_view.gd:125`／生涯页 `career_overlay.gd:54`／状态面板 `status_panel.gd:32`／选档界面 `save_select_overlay.gd:86`（卡③ 新增），＋ `theme_projection_test.gd:853-854` 单测投影断言。HUD 栏复用该件，零新素材 | `game/presentation/views/ui_kit.gd:633`；`camp_overlay_view.gd:125`；`career_overlay.gd:54`；`status_panel.gd:32`；`save_select_overlay.gd:86` |
| F4 | 钥石徽工厂件在役：`UiKit.keystone_badge` 定义 `ui_kit.gd:632`；消费点四处产品码——营地顶栏 `camp_overlay_view.gd:125`／生涯页 `career_overlay.gd:54`／状态面板 `status_panel.gd:32`／选档界面 `save_select_overlay.gd:86`（卡③ 新增），＋ `theme_projection_test.gd:853-854` 单测投影断言。HUD 栏复用该件，零新素材 | `game/presentation/views/ui_kit.gd:632`；`camp_overlay_view.gd:125`；`career_overlay.gd:54`；`status_panel.gd:32`；`save_select_overlay.gd:86` |
| F5 | art-bible **v3.24** §6.2 现载「钥石余额：常驻画面顶部的一行小 HUD 栏（高 48px，浮层覆盖，不挤压画面）」（:396）；camp.md v2.2 §顶栏（:39-41）同述＋「刷新入口＝营地刷新单口（卡⑤同口挂接）」——与裁决 10 同向，本批把呈现位从 CampOverlay 顶栏迁场景屏 HUD | `design/art/art-bible.md:396`；`design/gdd/ux/camp.md:39-41` |
| F6 | 层序唯一事实源＝`ui_registry.gd:15-35 LAYER_CONTRACT`（`UiRegistry`；`main.gd:5` 头注自陈界面句柄与层清单归 ui 注册面）；全仓唯一落位口＝`ui_registry.gd:76 apply_layer_contract(root)`（唯一 `move_child` 点）；模态登记册序/树序断言＝`system_test.gd:94-106`（V1c 合同树序链）。浮窗新槽入该合同表，禁散落 `move_child` | `game/presentation/ui_registry.gd:15-35`／:76；`game/tests/system_test.gd:94-106` |
| F7 | 零动效契约先例：生涯页/状态面板「直开直关」——`ui_struct_probe.gd:379-391 _career_zero_motion_contract`（子树 AnimationPlayer 零命中＋视图源码 `create_tween`/`UiKit.motion` 令牌扫描）、:334-341 `_status_zero_motion_contract` 同形 | `game/probe/ui_struct_probe.gd:334-341`／:379-391 |
@@ -53,11 +53,11 @@
🔴 **契约 2 · Esc 范围＝营地语境（Q3 已确认，2026-10-18）**：浮窗只在营地场景图语境唤起（含其子界面开态——行为按 Q1 裁定的甲案：只根态响应）。**禁扩展到战斗/地图/其他屏**（用户 2026-10-18 确认「只在营地语境」；08:193 键盘面仍排 Beta，本批只落 Esc 一项）。
🔴 **契约 3 · 设置与退出本体零重做、接线允许语境分支**：设置面本体与退出行为零改（F2/F3）；**开合接线允许按语境分支**——现役 `main_overlay_flow.gd:11-13 _on_settings_closed` 带「回开始层」硬副作用（`start_overlay.visible = true`），营地语境须分支为「关设置回浮窗不回主菜单」。栈语义正解（F6/modal_stack.gd:21-41）：浮窗登记于设置层**之下**（合同表槽位在营地层与 `settings_overlay` 之间，T0 与卡④ 对齐最终槽名），`ui.modals.flow.open(settings_overlay)` 时设置层绘制在浮窗之上遮挡之（open 只隐藏登记序在设置层**之上**的层，浮窗在下不被隐藏），`close` 后遮挡解除、浮窗自然重现——「关设置回浮窗」由栈语义保证；**语境分支点＝`_on_settings_closed` 的 `start_overlay.visible = true` 硬副作用**（菜单路径保留、营地浮窗路径跳过），落 `main_overlay_flow.gd._on_settings_closed`（改）。`_quit_game`（`main.gd:143`）无语义副作用，原样复用。
🔴 **契约 3 · 设置与退出本体零重做、接线允许语境分支**：设置面本体与退出行为零改（F2/F3）；**开合接线允许按语境分支**——现役 `main_overlay_flow.gd:11-13 _on_settings_closed` 带「回开始层」硬副作用（`start_overlay.visible = true`），营地语境须分支为「关设置回浮窗不回主菜单」。栈语义正解（F6/modal_stack.gd:21-41）：浮窗登记于设置层**之下**（合同表槽位在营地层与 `settings_overlay` 之间，T0 与卡④ 对齐最终槽名），`ui.modals.flow.open(settings_overlay)` 时设置层绘制在浮窗之上遮挡之（open 只隐藏登记序在设置层**之上**的层，浮窗在下不被隐藏），`close` 后遮挡解除、浮窗自然重现——「关设置回浮窗」由栈语义保证；**语境分支点＝`_on_settings_closed` 的 `start_overlay.visible = true` 硬副作用**（菜单路径保留、营地浮窗路径跳过），落 `main_overlay_flow.gd._on_settings_closed`（改）。**语境分支谓词（2026-11-01 双审钉死）＝`camp_esc_overlay.visible`**（谁开的设置谁收：浮窗开态下关设置必回浮窗；菜单路径浮窗必未开）；与 Esc 守卫谓词（契约 9①②，按 ModalStack 现开集合判）**分立**——禁复用同一谓词。`_quit_game`（`main.gd:143`）无语义副作用，原样复用。
🔴 **契约 4 · 返回主菜单动线**：营地场景屏隐藏＋**选档层同收**（卡④ T3 口径）＋开始层恢复；营地语境⇔闲时会话（无冒险会话——卡④ 契约 6「冒险进行中不开营地」＋现役终局回菜单并 `_begin_session(false)` 收束推得），故动线本身不含会话收束；**回主菜单后菜单＝卡②三钮、断点在档不在菜单露面**（禁实现者自作主张加「继续冒险」钮——那正是契约 1 在浮窗侧禁的）；营地每笔消费即时写盘（`存档序列化.md`，行号 T0 复核），回主菜单不写档也无损。
🔴 **契约 4 · 返回主菜单动线**：**动线首步＝close 浮窗**（`ui.modals.flow.close(camp_esc_overlay)`——浮窗是模态层，与屏壳可见性无关，缺此步浮窗残留主菜单上方；v1.4 补，V3 断言含浮窗 closed）；营地场景屏隐藏＋**选档层同收**（卡④ T3 口径）＋开始层恢复；营地语境⇔闲时会话（无冒险会话——卡④ 契约 6「冒险进行中不开营地」＋现役终局回菜单并 `_begin_session(false)` 收束推得），故动线本身不含会话收束；**回主菜单后菜单＝卡②三钮、断点在档不在菜单露面**（禁实现者自作主张加「继续冒险」钮——那正是契约 1 在浮窗侧禁的）；营地每笔消费即时写盘（`design/gdd/systems/表现与支撑/存档序列化.md`，行号 T0 复核），回主菜单不写档也无损。
🔴 **契约 5 · 顶栏 HUD 单口读数＋刷新挂卡④单口**：钥石余额只经 MetaProgression/SaveManager 访问器单口读（`camp_shop_presenter.gd:62 camp_data()` 的 `keystone_balance()`；禁第二账本、禁视图自算）；**刷新挂卡④定义的营地刷新单口**（卡④ v3.0 定名 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`，非已退役 `refresh_camp`——F9）；刷新时机清单＝购买后（挂单口）／进档或回营地进入时重读／夹具直写后探针显式触发（T2 落定）。
🔴 **契约 5 · 顶栏 HUD 单口读数＋刷新挂卡④单口**：钥石余额只经 MetaProgression/SaveManager 访问器单口读（`camp_shop_presenter.gd:62 camp_data()` 的 `keystone_balance()`；禁第二账本、禁视图自算）；**刷新挂卡④定义的营地刷新单口**（卡④ v3.1 定名 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`，非已退役 `refresh_camp`——F9）；刷新时机清单＝购买后（挂单口）／进档或回营地进入时重读／夹具直写后探针显式触发（T2 落定）。**「进档/回营地进入时重读」的触发主体（v1.4 钉死）＝组合根进档动线尾（营地开层同口）显式调 `CampRefreshBus.refresh(camp_data())` 一闸**——禁 band `_ready` 自刷或自持第二入口（保 V6「显式触发才变」单口调用记录锚）。
🔴 **契约 6 · 零动效**：浮窗直开直关，子树零 AnimationPlayer、源码禁 `create_tween`/`UiKit.motion` 令牌（生涯页同款契约，F7）；减动效设置项不新增（在役项沿用）。
@@ -65,6 +65,13 @@
🔴 **契约 8 · provisional 口径留痕**：裁决 10「先按顶部小HUD栏设计」的「先」字留痕——HUD 栏形态按最小集落地（只承载钥石余额），扩项＝新裁点。
🔴 **契约 9 · Esc 输入语义四态与接线定稿（v1.4 新立，2026-11-01 用户裁采纳双审推荐）**：Esc 路由按**四级优先序**，判据单点＝ModalStack 登记册现开集合（禁手枚名单——设置面/ConfirmDialog/五子界面自然全被覆盖）：
①**除浮窗外任一登记模态开态 → 无反馈**（「设置开在浮窗之上」态被本条覆盖＝无反馈，关设置后浮窗自然重现——契约 3 栈语义；旧三态表「隔设置层误关不可见浮窗」歧义就此消解）；
②**浮窗开态 → `close(camp_esc_overlay)`**（同键唤起/关闭单义切换，Q2 甲）；
③**营地语境（`is_camp_context()`：营地场景屏 visible）→ `open(camp_esc_overlay)`**；
④**非营地语境 → 无反馈**（现役「选档语境 Esc 零响应」语义保持，契约 2）。
**接线定稿（同日裁，出 §9 白名单）**：事件驱动 `_unhandled_input`，键值判定 `KEY_ESCAPE`（配 physical_keycode 桌面惯例）；**禁 Input 单例轮询**（`Viewport.push_input` 合成链不更新 `Input.is_action_pressed` 动作态——合成探针必然测不到轮询路径）；**不挂 ui_cancel**（Beta 手柄面往 ui_cancel 挂键会致语义漂移；用户裁决原话「ESC键」；08:193 键盘面只加 KEY_ESCAPE 键值判定、不新增 InputMap action）。**触发沿＝pressed 且非 echo**、忽略释放沿（真实键盘长按 echo 连发禁翻转浮窗；V1 补合成 echo 断言零响应）。
**拆分边界纪律适用性判定（req-card 第 15 节／code-conventions §1.1）**：本卡＝**新增功能批**——新增 Esc 浮窗视图、营地顶栏 HUD 栏、Esc 键盘输入接线三类件，其余为存量文件接线改造；无「拆分存量单元／收敛／重构」动作，`camp_overlay_view.gd` 四柜台拆解退役属卡④ 职责（本卡不改该文件）。按 code-conventions §1.1 拆分判据五条，本卡不触发拆分/收敛/重构类，故不在设计契约区写拆分红线条款，仅在此写明判定理由。同理 req-card 第 13 节「禁为机检文本保留无效成员」（重构类卡必填）不适用；新增件类的「机检预算互斥＝上游缺陷停卡退回写卡段」（第 9/14 节）已写入 §8 L3 与「实现规范预算」节。
## 4. 范围边界
@@ -88,7 +95,7 @@
| `design/gdd/08-Alpha版本标准.md`（v1.13） | :193「键盘 / 手柄输入（排 Beta）」行——Esc 营地浮窗已落地（用户明示裁决，澄清⑤裁决 9），须加注防「Beta 行＝本批违例」误读 | 反哺点 · 列清单（行内加注） |
| `design/art/art-bible.md`（v3.24） | §6.2「钥石余额：常驻画面顶部的一行小 HUD 栏」（:396）呈现位从 CampOverlay 顶栏迁场景屏 HUD | 反哺点 · 列清单（权威面零直改，过用户裁决后归文档批） |
| `design/gdd/ux/camp.md`（v2.2） | §顶栏（:39-41）「钥石余额常驻顶部小 HUD 栏、刷新入口＝营地刷新单口（卡⑤同口挂接）」实装状态回填 | 反哺点 · 列清单 |
| `待办清单.md`（仓库根） | 本卡登记条（五卡总条第 438-449 行）状态推进 | 反哺点 · 列清单（实现批禁写待办清单） |
| `待办清单.md`（仓库根） | 本卡登记条（五卡总条，:447 起——原引 438-449 行号漂移，v1.4 订正）状态推进 | 反哺点 · 列清单（实现批禁写待办清单） |
| `体验验证清单.md`（仓库根） | 新增目检条（Esc 浮窗三动线/HUD 余额观感/浮窗视觉面）——登记不阻塞 | 反哺点 · 列清单（实现批禁写体验验证清单，入册条目由文档批落） |
| `roadmap.md`（仓库根） | 迭代行编入/状态刷新 | 反哺点 · 列清单（实现批禁写 roadmap） |
| `game/tests/README.md` | 能力行入表（§7 对照表「能力行」列定名） | 写卡段定名（本卡只写卡内能力行文字，README 由主 Agent 统一收口）；实现批只核对名实一致，禁写 |
@@ -101,11 +108,13 @@
| 文件 | 职责 | 改动类型 | 落位 | 对照表行 |
|---|---|---|---|---|
| `game/presentation/views/camp_esc_overlay.gd` | Esc 浮窗视图：`UiKit.modal_shell` 模态壳＋三钮（返回主菜单/设置/退出游戏，退出用 `UiKit.danger_button`）＋Q2 再按 Esc 关窗；零新素材 | 行为改动 | 新建 | V1／V2／V5／B1 |
| `game/presentation/views/camp_hud_band.gd` | 营地顶栏小 HUD 栏：承载 `UiKit.keystone_badge`（钥石余额单口读数）；订阅卡④ `CampRefreshBus.refresh()` 刷新 | 行为改动 | 新建 | V6／B2 |
| `game/presentation/views/camp_hud_band.gd` | 营地顶栏小 HUD 栏：承载 `UiKit.keystone_badge`（钥石余额单口读数）；挂接卡④ `CampRefreshBus.refresh()` 刷新 | 行为改动 | 新建 | V6／B2 |
| `game/presentation/main_esc_flow.gd` | 组合根 Esc 流程承接件：键盘输入路由＋营地语境判据＋Q2 再按关窗＋三出口动线（返回主菜单/设置/退出）；静态承接件，main 侧留同名薄委托 | 行为改动 | 新建 | V1／V3／B1／B3 |
| `game/presentation/main.gd` | 组合根：Esc 输入入口＋`main_esc_flow.gd` 同名薄委托＋返回主菜单动线接线 | 行为改动 | 复用既有（改） | V1／V3／B3 |
| `game/presentation/ui_registry.gd` | `LAYER_CONTRACT` 加 `camp_esc_overlay` 槽（登记于营地层与 `settings_overlay` 之间，契约 3 正解）＋`node()` 寻址 | 行为改动 | 复用既有（改） | V8／B1 |
| `game/presentation/main_overlay_flow.gd` | `_on_settings_closed` 语境分支：营地浮窗路径关设置回浮窗、不回主菜单（契约 3） | 行为改动 | 复用既有（改） | V4／B3 |
| `game/presentation/main_overlay_flow.gd` | `_on_settings_closed` 语境分支：营地浮窗路径关设置回浮窗、不回主菜单（契约 3；谓词＝camp_esc_overlay.visible） | 行为改动 | 复用既有（改） | V4／B3 |
| `game/presentation/ui_modals.gd` | 浮窗新句柄 `camp_esc_overlay` 落 UiModals 成员（`ui_registry.gd` node() 经 `modals.X` 寻址；13 现役句柄先例 :8-20；S13 触面——类变量 14→15 恰贴 ≤15 上限，登记预期值） | 行为改动 | 复用既有（改） | V8／B1 |
| `game/presentation/main_ui_build.gd` | 浮窗实例化装配点：`.new()`＋装配尾 `apply_layer_contract(root)`（先例 :105/:121/:242；S13 触面） | 行为改动 | 复用既有（改） | V8／B1 |
| `game/presentation/views/camp_scene_view.gd`（卡④ 新建） | 顶栏预留位 `set_hud_band()` 填 `CampHudBand` 实例（卡④ T2 跨卡接口①「卡⑤ 填值」）；本卡只填值、不改场景图铺底/命中区逻辑 | 行为改动 | 卡④ 新建（跨卡共改，仅顶栏填值） | V6／B2 |
| `game/probe/screen_flow_probe.gd` | 探针宿主：扩展现 :153-165 Esc 合成段为营地语境浮窗断言＋三动线＋Q2 关窗＋HUD 余额读数；与卡④ T5 营地键段按行域分界（§0） | 非行为改动（测试面） | 复用既有（改） | V1／V3／V4／V6 |
| `game/probe/ui_struct_probe.gd` | 浮窗三钮结构断言＋零动效契约段（仿 career :379-391）＋顶栏位/登记序结构断言 | 非行为改动（测试面） | 复用既有（改） | V2／V7／V8 |
@@ -120,8 +129,8 @@
| 新件 | 复用面（grep 同职责实现） | 唯一面（grep 同名同义标识符） | 分层与交互面（调用路径＋跨层出口） |
|---|---|---|---|
| `camp_esc_overlay.gd` | 盘上视图件＝`camp_overlay_view.gd`（CampOverlay 四柜台，随卡④ 形态退役、反参照禁复用）、`settings_overlay.gd`／`career_overlay.gd`（各有专职、无三钮 Esc 浮窗同职责实现）、`ui_kit.gd modal_shell`（工厂只产 dim+center+panel+VBox、不产完整浮窗）。grep `camp_esc`／`esc_overlay` 盘上无同职责实现 → 不能复用，须新建视图件；模态壳/按钮复用 `UiKit.modal_shell`（`ui_kit.gd:487`）／`UiKit.danger_button`（:700），零新素材零新色值 | grep `camp_esc_overlay`／`EscOverlay` 盘上无第二处；三钮文案「返回主菜单/设置/退出游戏」只此一处定义，禁在探针/T 卡各写一份 | 呈现层视图，零 Core 写调用；三钮 `pressed` → 组合根 `main_esc_flow.gd` → 现役动线（`_quit_game`／`ui.modals.flow.open(settings_overlay)`／返回主菜单）；Q2 再按 Esc 关窗由组合根路由，视图只发 `closed` 信号 |
| `camp_hud_band.gd` | 盘上钥石徽消费面四处（F4），但**无「顶栏 HUD 栏」独立视图件**——现钥石徽直接挂 CampOverlay 顶栏（`camp_overlay_view.gd:125`），随卡④ 拆解退役；新 HUD 栏须独立承载读数＋订阅刷新单口，职责不同 → 不能复用，须新建 | grep `camp_hud_band`／`CampHudBand`／`hud_band` 盘上无第二处；余额读数只经 `camp_data()` 单口（F9），禁视图自算 | 呈现层视图；`UiKit.keystone_badge`（`ui_kit.gd:633`）承载显示；订阅卡④ `CampRefreshBus.refresh(camp_data)` 单口刷新（跨卡接口②）；经卡④ `camp_scene_view.gd set_hud_band()` 顶栏预留位挂入（跨卡接口①）；零 Core 写调用 |
| `camp_esc_overlay.gd` | 盘上视图件＝`camp_overlay_view.gd`（CampOverlay 四柜台，随卡④ 形态退役、反参照禁复用）、`settings_overlay.gd`／`career_overlay.gd`（各有专职、无三钮 Esc 浮窗同职责实现）、`ui_kit.gd modal_shell`（工厂只产 dim+center+panel+VBox、不产完整浮窗）。grep `camp_esc`／`esc_overlay` 盘上无同职责实现 → 不能复用，须新建视图件；模态壳/按钮复用 `UiKit.modal_shell`（`ui_kit.gd:486`）／`UiKit.danger_button`（:699），零新素材零新色值 | grep `camp_esc_overlay`／`EscOverlay` 盘上无第二处；三钮文案「返回主菜单/设置/退出游戏」只此一处定义，禁在探针/T 卡各写一份 | 呈现层视图，零 Core 写调用；三钮 `pressed` → 组合根 `main_esc_flow.gd` → 现役动线（`_quit_game`／`ui.modals.flow.open(settings_overlay)`／返回主菜单）；Q2 再按 Esc 关窗由组合根路由，视图只发 `closed` 信号 |
| `camp_hud_band.gd` | 盘上钥石徽消费面四处（F4），但**无「顶栏 HUD 栏」独立视图件**——现钥石徽直接挂 CampOverlay 顶栏（`camp_overlay_view.gd:125`），随卡④ 拆解退役；新 HUD 栏须独立承载读数＋挂接刷新单口（接收推送，非信号订阅），职责不同 → 不能复用，须新建 | grep `camp_hud_band`／`CampHudBand`／`hud_band` 盘上无第二处；余额读数只经 `camp_data()` 单口（F9），禁视图自算 | 呈现层视图；`UiKit.keystone_badge`（`ui_kit.gd:632`）承载显示；挂接卡④ `CampRefreshBus.refresh(camp_data)` 单口刷新（跨卡接口②）；经卡④ `camp_scene_view.gd set_hud_band()` 顶栏预留位挂入（跨卡接口①）；零 Core 写调用 |
| `main_esc_flow.gd` | 盘上组合根承接件＝`main_overlay_flow.gd`（设置/状态/生涯/选档/图例/钱包六类覆盖层开合与数据投喂）、`main_adventure_flow.gd`、`main_debug_flow.gd`。**无「键盘输入路由＋Esc 三出口动线」同职责实现**；并入 `main_overlay_flow.gd` 会使其承载第二变化原因（开合数据投喂 vs 键盘输入交互），且该文件已 6 类开合 → 不能复用，须新建单一职责承接件；`main.gd` 留同名薄委托（与现行拆件模式一致，探针 `main.X` 路径零改动） | grep `main_esc_flow`／`_on_esc`／`EscFlow` 盘上无第二处；营地语境判据只此一处定义（营地场景屏 visible 且无营地子模态开态），禁散落 | 组合根拆件（静态、零成员态，仿 `main_overlay_flow.gd`）；键盘输入 → 营地语境判据 → 浮窗 `ui.modals.flow.open/close`（模态栈单口）；三出口 → 现役动线；返回主菜单 → 营地隐＋选档层同收＋开始层恢复（卡④ T3 同口径）；Core 零 UI 不破 |
### 非新增件说明
@@ -145,7 +154,7 @@
### 存量触面一查
本卡触碰存量文件：`main.gd`／`ui_registry.gd`／`main_overlay_flow.gd`／`camp_scene_view.gd`（卡④ 新建）／`screen_flow_probe.gd`／`ui_struct_probe.gd`。**T0 读数步骤写明「S13 键较 `tools/gdstyle_baseline.txt` 登记值只降不升」的预期与达成手段**：`main.gd` 组合根新增 Esc 输入入口与薄委托（不引入重复 load／循环内 await／循环内分配等 S13 违规类型，键只降不升）；`ui_registry.gd` 合同表加一槽、`node()` 加一寻址分支（不新增公开方法面）；`main_overlay_flow.gd` `_on_settings_closed` 加语境分支（单函数分支数仍 ≤8、返回 ≤6）；`camp_scene_view.gd` 只填 `set_hud_band()` 顶栏位；探针改接＝加断言段、不新增扫描面键。任何 S13 键被迫上升＝§8 L3 停卡。**`main.gd` 为组合根架构先例，其公开方法基数不在本卡新件三查面内**（第 14 节三查只对新增文件）。
本卡触碰存量文件：`main.gd`／`ui_registry.gd`／`ui_modals.gd`／`main_ui_build.gd`／`main_overlay_flow.gd`／`camp_scene_view.gd`（卡④ 新建）／`screen_flow_probe.gd`／`ui_struct_probe.gd`。**T0 读数步骤写明「S13 键较 `tools/gdstyle_baseline.txt` 登记值只降不升」的预期与达成手段**：`main.gd` 组合根新增 Esc 输入入口与薄委托（不引入重复 load／循环内 await／循环内分配等 S13 违规类型，键只降不升）；`ui_registry.gd` 合同表加一槽、`node()` 加一寻址分支（不新增公开方法面）；`ui_modals.gd` 加一成员句柄（类变量 14→15 恰贴 ≤15 上限，预期值 15）；`main_ui_build.gd` 加浮窗实例化与装配（方法面微增，T0 实测对账）；`main_overlay_flow.gd` `_on_settings_closed` 加语境分支（单函数分支数仍 ≤8、返回 ≤6）；`camp_scene_view.gd` 只填 `set_hud_band()` 顶栏位；探针改接＝加断言段、不新增扫描面键。任何 S13 键被迫上升＝§8 L3 停卡。**`main.gd` 为组合根架构先例，其公开方法基数不在本卡新件三查面内**（第 14 节三查只对新增文件）。
### 指标例外通道
@@ -157,32 +166,32 @@
### T0 事实坐实与跨卡对齐（≈0.5–1d）
- 取用：待办清单五卡总条实况（卡④ 已重立 v3.0、卡②③ 迭代 33 合回）、§0 跨卡接口、卡④ v3.0 §0.5／T2／T3、`game/tests/README.md` 能力表。
- 取用：待办清单五卡总条实况（卡④ v3.1 现行、卡②③ 迭代 33 合回）、§0 跨卡接口、卡④ v3.1 §0.5／T2／T3、`game/tests/README.md` 能力表。
- [ ] 复核 §2 F1–F10 全部 `file:line` 行号；漂移就地订正、订正不了的写明「开工日 T0 复核」，不硬编旧行号。
- [ ] 与卡④ 对齐三项接口：①顶栏预留位 `camp_scene_view.gd set_hud_band()` 填值签名；②营地刷新单口 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`；③终局落点不变量（现役＝终局 continue 回主菜单，若改落点为营地则本卡返回动线补 `_begin_session(false)`）——接口名保持既有，不改名；与卡④ 确认 `screen_flow_probe.gd` 行域分界（§0）。
- [ ] **Esc 输入合成先例复核**：读 `game/probe/screen_flow_probe.gd:153-165`（`InputEventKey`＋`Viewport.push_input` 合成 Esc、断言选档语境零响应），确认该机制可迁移到营地语境；与 §9 第 1 条接线方式选型联动，T0 定选型并回写文件结构图接线落点。
- [ ] **Esc 输入合成先例复核**：读 `game/probe/screen_flow_probe.gd:153-165`（`InputEventKey`＋`Viewport.push_input` 合成 Esc、断言选档语境零响应），确认该机制可迁移到营地语境；接线方式已定稿（契约 9——事件驱动 `_unhandled_input`＋`KEY_ESCAPE`，2026-11-01 裁），T0 复核合成链可达 unhandled 段（push_input 不更新 Input 单例动作态——禁轮询路线的实据）并回写文件结构图接线落点。
- [ ] Q1/Q2/Q3 裁定执行确认（甲/甲/甲，见 §10）；开工门核：U0 发令、grilling 复核门过、卡④ 代码波状态。
- [ ] 跑 `bash tools/gdstyle.sh game` 开发期局部读数，记录三新件预算实数与存量触面 S13 基线键（预期只降不升）；本步最窄确认，不构成验收。
- [ ] 跑 `bash tools/static_scan.sh` 开发期局部读数（gdstyle 键＝S13，闸件 `tools/gdstyle_gate.py`——原 `tools/gdstyle.sh` 不存在，v1.4 订正），记录三新件预算实数与存量触面 S13 基线键（预期只降不升）；本步最窄确认，不构成验收。
- 产出：基线 commit、三新件接口块定稿（签名/取值）、S13 读数、跨卡接口核对表、Esc 合成先例复核结论；后续卡只按本卡契约施工。
### T1 Esc 浮窗视图与键盘接线（≈1–1.5d）
- 取用：T0 三新件接口块、Esc 合成先例复核结论、`ui_kit.gd:487 modal_shell`／:700 `danger_button`／:633 `keystone_badge`、`ui_registry.gd:15-35 LAYER_CONTRACT`。
- [ ] 在 `camp_esc_overlay.gd` 实现 `setup_buttons()`：`UiKit.modal_shell`（`ui_kit.gd:487`，只产 dim+center+panel+VBox、无内置关闭件）＋三钮（返回主菜单/设置/退出游戏，退出用 `UiKit.danger_button` :700）；零新素材零新色值。
- 取用：T0 三新件接口块、Esc 合成先例复核结论、`ui_kit.gd:486 modal_shell`／:699 `danger_button`／:632 `keystone_badge`、`ui_registry.gd:15-35 LAYER_CONTRACT`。
- [ ] 在 `camp_esc_overlay.gd` 实现 `setup_buttons()`：`UiKit.modal_shell`（`ui_kit.gd:486`，只产 dim+center+panel+VBox、无内置关闭件）＋三钮（返回主菜单/设置/退出游戏，退出用 `UiKit.danger_button` :699）；零新素材零新色值。
- [ ] 在 `camp_esc_overlay.gd` 实现 `set_close_path()`／`bind_signals()`：Q2 裁甲＝再按 Esc 关窗（同键唤起/关闭单义切换），关闭由组合根路由、视图只发 `closed` 信号；三钮 `pressed` 外发不内含动线。
- [ ] 在 `main_esc_flow.gd` 实现 `is_camp_context() -> bool`：判据＝营地场景屏 visible（根态与子界面开态下皆真——子界面是模态叠加非熄屏；复用 `screen_flow_probe.gd:54` 营地旗标先例，卡④ T5 改指新场景根句柄后对齐）且无营地子模态开态（Q1 裁甲）；调试浮窗开态不影响判据（全局浮层、营地屏仍可见）。
- [ ] 在 `main_esc_flow.gd` 实现 `on_esc_input(ev: InputEvent) -> void`／`open_overlay() -> void`／`close_overlay() -> void`：营地语境 Esc → `ui.modals.flow.open(camp_esc_overlay)`；再按 Esc → `close`；非营地语境（boot 菜单）不唤起（契约 2）。接线方式按 T0 选型，禁吞他处输入。
- [ ] 在 `main_esc_flow.gd` 实现 `is_camp_context() -> bool`：判据＝营地场景屏 visible（子界面是模态叠加非熄屏；复用 `screen_flow_probe.gd:54` 营地旗标先例——:53 是菜单行、:54 才是营地旗标，v1.4 订正）；「子界面开态不唤浮窗」（Q1 甲）由契约 9① 现开集合判据承载，不并入本谓词；调试浮窗开态不影响判据（全局浮层、营地屏仍可见）。
- [ ] 在 `main_esc_flow.gd` 实现 `on_esc_input(ev: InputEvent) -> void`／`open_overlay() -> void`／`close_overlay() -> void`：按**契约 9 四态优先序**路由（①除浮窗外任一登记模态开→无反馈②浮窗开→close③营地语境→open④非营地语境→无反馈），判据单点＝ModalStack 登记册现开集合、禁手枚名单；接线定稿＝事件驱动 `_unhandled_input`＋`KEY_ESCAPE`（physical_keycode）、禁 Input 单例轮询、不挂 ui_cancel、pressed 且非 echo（契约 9 接线定稿 2026-11-01 已裁，不再 T0 选型）。
- [ ] 在 `ui_registry.gd` `LAYER_CONTRACT` 加 `camp_esc_overlay` 槽（位于营地层与 `settings_overlay` 之间，契约 3 登记序正解）＋`node()` 寻址；禁散落 `move_child`（F6）。
- [ ] 在 `main.gd` 加 Esc 输入入口与 `main_esc_flow.gd` 同名薄委托（探针 `main.X` 路径零改动）。
- [ ] 在 `main.gd` 加 Esc 输入入口（`_unhandled_input`）与 `main_esc_flow.gd` 同名薄委托（探针 `main.X` 路径零改动）；`main.gd` 的 `_unhandled_input` 将是产品码首个键盘入口——`main_esc_flow.gd` 头注自陈此身份（2026-11-01 双审注）。
- [ ] 零动效（契约 6）：浮窗子树零 AnimationPlayer、源码禁 `create_tween`/`UiKit.motion` 令牌（仿 `ui_struct_probe.gd:379-391`）。
- 产出：`CampEscOverlay.setup_buttons()`／`set_close_path()`／`bind_signals()`、`closed` 信号；`MainEscFlow.on_esc_input()`／`is_camp_context()`／`open_overlay()`／`close_overlay()`；`LAYER_CONTRACT` 新槽键 `camp_esc_overlay`；T2 按接口块接线。
### T2 营地顶栏小 HUD 栏（≈0.5–1d）
- 取用：T1 `MainEscFlow`、`camp_hud_band.gd` 接口块、卡④ `CampRefreshBus.refresh(camp_data)` 单口、`camp_scene_view.gd set_hud_band()` 顶栏预留位、`camp_shop_presenter.gd:62 camp_data()` 读数单点。
- [ ] 在 `camp_hud_band.gd` 实现 `set_balance(v: int) -> void`／`bind_refresh_bus(bus: Object) -> void`／`refresh(camp_data: Dictionary) -> void`：`UiKit.keystone_badge`（`ui_kit.gd:633`）承载，读数只经 `camp_data()` 单口（F9/契约 5，禁第二账本、禁视图自算）；订阅卡④ `CampRefreshBus.refresh(camp_data)`。
- [ ] 在 `camp_hud_band.gd` 实现 `set_balance(v: int) -> void`／`bind_refresh_bus(bus: Object) -> void`／`refresh(camp_data: Dictionary) -> void`：`UiKit.keystone_badge`（`ui_kit.gd:632`）承载，读数只经 `camp_data()` 单口（F9/契约 5，禁第二账本、禁视图自算）；挂接卡④ `CampRefreshBus.refresh(camp_data)`；载体循 UiKit `page_shell` 的 `PRESET_TOP_WIDE`＋`custom_minimum_size` 先例（ui_kit.gd:523-525），禁手动 rect。
- [ ] 在卡④ `camp_scene_view.gd` 的 `set_hud_band()` 顶栏预留位填 `CampHudBand` 实例（高 48px 浮层覆盖、不挤压画面；卡④ T2 跨卡接口①）；`camp_scene_view.gd` 场景图铺底/命中区逻辑零改（卡④ 职责）。
- [ ] 刷新时机清单落定（契约 5）：①购买后（挂单口）②进档/回营地进入时重读③夹具直写后探针显式触发——断言前须显式触发，禁依赖「自动重读」假设。
- [ ] 刷新时机清单落定（契约 5）：①购买后（挂单口）②进档/回营地进入时重读③夹具直写后探针显式触发——断言前须显式触发，禁依赖「自动重读」假设；②的触发主体＝组合根进档动线尾（营地开层同口）显式调 `CampRefreshBus.refresh(camp_data())` 一闸（契约 5 v1.4 补钉），禁 band `_ready` 自刷或自持第二入口。
- [ ] HUD 栏形态按最小集（契约 8）：只承载钥石余额；扩项＝新裁点。
- [ ] camp 截图/golden 联动：HUD 落位后核 camp 截图漂移热区→限 HUD 区显式更新＋呈报；现无 camp 逐像素 golden（卡④ 契约 10），camp 验收＝shot_probe 出图＋shot_checker 语义断言。
- 产出：`CampHudBand.set_balance()`／`bind_refresh_bus()`／`refresh()`、顶栏填值、刷新时机清单；T3 按接口块验收。
@@ -190,10 +199,10 @@
### T3 三出口动线、设置语境分支与断言批（≈1–1.5d）
- 取用：T1/T2 产物、`main_overlay_flow.gd:11-13 _on_settings_closed`、`main.gd:143 _quit_game`、`camp_shop_presenter.gd:50-53 on_camp_closed`、`screen_flow_probe.gd:153-165` Esc 合成段、`ui_struct_probe.gd:379-391` 零动效段。
- [ ] 在 `main_esc_flow.gd` 实现 `_on_return_to_menu() -> void`：营地场景屏隐藏＋选档层同收＋开始层恢复（卡④ T3 动线同口）；营地语境⇔闲时会话（契约 4 前提），动线不含会话收束；回主菜单后菜单＝卡②三钮、禁加「继续冒险」钮。
- [ ] 在 `main_esc_flow.gd` 实现 `_on_return_to_menu() -> void`：**首步 close 浮窗**（`ui.modals.flow.close(camp_esc_overlay)`——浮窗是模态层，屏壳可见性收不了它，缺此步浮窗残留主菜单上方；契约 4 v1.4 补）→ 营地场景屏隐藏＋选档层同收＋开始层恢复（卡④ T3 动线同口）；营地语境⇔闲时会话（契约 4 前提），动线不含会话收束；回主菜单后菜单＝卡②三钮、禁加「继续冒险」钮。
- [ ] 在 `main_esc_flow.gd` 实现 `_on_settings() -> void`／`_on_quit() -> void`：设置→`ui.modals.flow.open(settings_overlay)`（浮窗登记于其下、关后遮挡解除重现）；退出→`_quit_game`（`main.gd:143`，原样复用）。
- [ ] 在 `main_overlay_flow.gd` `_on_settings_closed` 加语境分支：营地浮窗路径关设置回浮窗、不回主菜单（契约 3；现役 :13 `start_overlay.visible = true` 硬副作用仅菜单路径保留）。
- [ ] 探针（宿主 `screen_flow_probe.gd`，已在 `tools/probe_gate.sh:142-146` 登记、零登记成本；不另起新文件）：扩展 :153-165 Esc 合成段——营地根态合成 Esc→浮窗可见＋三项在位；营地子界面开态合成 Esc→浮窗不唤起（Q1 甲案判据）；再按 Esc 关窗；非营地语境（boot 菜单）不唤起（契约 2）；返回主菜单动线（营地隐＋选档层收＋菜单显）；设置项开合（含营地浮窗→设置→关闭回浮窗高危路径＋「关闭设置后禁弹主菜单」反向断言）；退出项接线断言（headless 不可真退）。
- [ ] 探针（宿主 `screen_flow_probe.gd`，已在 `tools/probe_gate.sh:142-146` 登记、零登记成本；不另起新文件）：扩展 :153-165 Esc 合成段——营地根态合成 Esc→浮窗可见＋三项在位；营地子界面开态合成 Esc→无反馈（Q1 甲，契约 9①）；**设置开在浮窗之上合成 Esc→无反馈且浮窗不误关**（契约 9①——浮窗不隔层关闭，关设置后浮窗重现）；再按 Esc 关窗（契约 9②）；非营地语境（boot 菜单）不唤起（契约 9④）；**冒险语境合成 Esc→浮窗不现**（契约 2 全局接线回归面，screen_flow_probe 冒险步内）；**echo 事件合成→零响应**（触发沿 pressed 且非 echo，契约 9）；返回主菜单动线（**浮窗自收**＋营地隐＋选档层收＋菜单显）；设置项开合（含营地浮窗→设置→关闭回浮窗高危路径＋「关闭设置后禁弹主菜单」反向断言）；退出项接线断言（headless 不可真退）。
- [ ] HUD 余额断言：读数＝存档单口（夹具经**隔离存档实例直写** `meta_state._add_keystone(9999)` 先例 `game/probe/ui_click_probe.gd:74`；**不经 DebugOverlay 界面——其钥石项是只读投影** `debug_overlay.gd:194-205`）；直写后显式触发刷新断言。
- [ ] 结构断言（`ui_struct_probe.gd`）：浮窗三钮在位且仅三；零动效（仿 career :379-391）；`LAYER_CONTRACT` 登记序（浮窗入合同表、`system_test.gd:94-106` V1c 树序链复跑）；**浮窗开不波及 `debug_badge` 节点**（F10：发布态恒隐，改结构断言替代 v1.2 `visible==true` 断言）。
- [ ] 正向验收断言（v1.2 计划的人工制造红取证条目整条已删，替换为 §7 上表正向断言）：每条从真实入口进入、判据绑被测改动特有的可观测提交面（信号／入参／状态源取值／可见性／树序），在当轮真实跑批执行并通过；**禁把生产码改成错值看断言抓不抓得到、禁回退 hunk 看断言红不红**（人为制造红属伪造证据）；判据绑不上＝静态判据＋评审注记申报观测面局限，证明做不出＝停卡呈报。
@@ -215,22 +224,22 @@
## 7. 验证闸：改动—验收对照表
七格表：需求点｜改动（文件:行／行为）｜验收测试（名称＋落点＋尾缀）｜层级（单元／接口／集成／探针）｜真实入口｜判据绑定面｜能力行。**每个需求点至少一行；每个行为改动至少一行（V1–V10 需求点行＋B1–B3 行为改动专行）；每行必须有真实入口和判据绑定面——缺任一项＝该需求点未验收，卡片不成立。** 断言尾缀〔ESC批 Vn〕／〔ESC批 Bn〕，与卡片清单互相 grep。能力行格式 `既有：<能力名>；新增：<能力名>`（中文分号分隔，对齐机检与卡④ v3.0 先例），两形态名称都须在 `game/tests/README.md` 能力表在场（既有＝现役在场名，新增＝本卡定名、由主 Agent 统一收口入表；本卡只写卡内能力行文字，README 由主 Agent 收口）。
七格表：需求点｜改动（文件:行／行为）｜验收测试（名称＋落点＋尾缀）｜层级（单元／接口／集成／探针）｜真实入口｜判据绑定面｜能力行。**每个需求点至少一行；每个行为改动至少一行（V1–V10 需求点行＋B1–B3 行为改动专行）；每行必须有真实入口和判据绑定面——缺任一项＝该需求点未验收，卡片不成立。** 断言尾缀〔ESC批 Vn〕／〔ESC批 Bn〕，与卡片清单互相 grep。能力行格式 `既有：<能力名>；新增：<能力名>`（中文分号分隔，对齐机检与卡④ v3.1 先例），两形态名称都须在 `game/tests/README.md` 能力表在场（既有＝现役在场名，新增＝本卡定名、由主 Agent 统一收口入表；本卡只写卡内能力行文字，README 由主 Agent 收口）。
| 需求点 | 改动（文件:行／行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|---|---|---|---|---|---|---|
| V1 Esc 唤起（根态/子界面/关窗/非营地） | `camp_esc_overlay.gd` 浮窗视图；`main_esc_flow.gd on_esc_input()`／`is_camp_context()`／`open_overlay()`／`close_overlay()`；`main.gd` 输入入口 | `screen_flow_probe.gd:_ready`（Esc 唤起/子界面开态不唤起/再按关窗/非营地不唤起段）〔ESC批 V1〕 | 探针 | 营地场景根态合成 Esc 键事件（`InputEventKey`＋`Viewport.push_input`，先例 :156-160）→ `main_esc_flow.on_esc_input()` → `ui.modals.flow.open/close` | 根态 Esc→浮窗 `visible=true`；再按→`visible=false`（绑 open/close 调用记录＋浮窗可见性）；营地子界面开态合成 Esc→浮窗 `visible=false`（Q1 甲案，绑 `is_camp_context()` 无子模态开态判据）；boot 菜单合成 Esc→浮窗 `visible=false`（契约 2，绑语境判据返回值） | 新增：Esc 浮窗唤起与三出口动线 |
| V1 Esc 唤起（根态/子界面/关窗/非营地） | `camp_esc_overlay.gd` 浮窗视图；`main_esc_flow.gd on_esc_input()`／`is_camp_context()`／`open_overlay()`／`close_overlay()`；`main.gd` 输入入口 | `screen_flow_probe.gd:_ready`（Esc 唤起/子界面开态不唤起/再按关窗/非营地不唤起段）〔ESC批 V1〕 | 探针 | 营地场景根态合成 Esc 键事件（`InputEventKey`＋`Viewport.push_input`，先例 :156-160）→ `main_esc_flow.on_esc_input()` → `ui.modals.flow.open/close` | 根态 Esc→浮窗 `visible=true`；再按→`visible=false`（绑 open/close 调用记录＋浮窗可见性）；子界面开态／设置开在浮窗之上合成 Esc→无反馈且浮窗不误关（契约 9①，浮窗不隔层关闭）；boot 菜单与冒险语境合成 Esc→浮窗不现（契约 9④/契约 2，绑语境判据返回值）；echo 合成→零响应（触发沿 pressed 且非 echo，契约 9） | 新增：Esc 浮窗唤起与三出口动线 |
| V2 浮窗三项 | `camp_esc_overlay.gd setup_buttons()` 三钮（modal_shell＋danger_button） | `ui_struct_probe.gd:_ready`（浮窗三钮结构段）〔ESC批 V2〕 | 探针 | 浮窗视图实例化 → 三钮节点树 | 三钮节点存在且仅三（绑按钮名与数量；禁第四钮） | 既有：UI 全局主题与按钮五态（含对比度锚）；新增：Esc 浮窗唤起与三出口动线 |
| V3 返回主菜单 | `main_esc_flow.gd _on_return_to_menu()`（营地隐＋选档层同收＋开始层恢复） | `screen_flow_probe.gd:_ready`（返回动线段）〔ESC批 V3〕 | 探针 | 浮窗「返回主菜单」钮 `pressed` → `main_esc_flow._on_return_to_menu()` → 屏显编排 | 营地场景屏 `visible=false`＋选档层 `visible=false`＋`start_overlay.visible=true`（绑三处可见性；`_screen_seals()` :51-57 互斥复跑） | 新增：Esc 浮窗唤起与三出口动线 |
| V4 设置项（双路径） | `main_esc_flow.gd _on_settings()`；`main_overlay_flow.gd _on_settings_closed` 语境分支 | `screen_flow_probe.gd:_ready`（营地浮窗→设置→关闭回浮窗段）〔ESC批 V4〕＋菜单路径冒烟 V3g settings 段复跑 | 探针（＋冒烟复跑） | 浮窗「设置」钮 → `ui.modals.flow.open(settings_overlay)` → 关闭 → `_on_settings_closed` 语境分支 | 设置开→浮窗被遮挡不可见（绑 ModalStack 遮挡记账）；关闭→浮窗 `visible=true`＋`start_overlay.visible=false`（绑语境分支；反向断言「关闭设置后禁弹主菜单」） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| V5 退出项 | `main_esc_flow.gd _on_quit()` → `main.gd:143 _quit_game()`（原样复用） | `ui_struct_probe.gd:_ready`（退出钮接线结构断言）〔ESC批 V5〕 | 探针（源码/结构，headless 不可真退） | 浮窗「退出游戏」钮 `pressed` → `_on_quit()` → `_quit_game()`（`settings_store.save_settings()`＋`get_tree().quit()`） | 钮 `pressed` 连接目标＝`_on_quit`→`_quit_game`（绑信号连接与调用链；headless 不真退＝静态判据＋评审注记申报观测面局限） | 新增：Esc 浮窗唤起与三出口动线 |
| V6 HUD 余额 | `camp_hud_band.gd set_balance()`／`bind_refresh_bus()`／`refresh()`；`camp_scene_view.gd set_hud_band()` 填值；订阅卡④ `CampRefreshBus.refresh()` | `screen_flow_probe.gd:_ready`（HUD 余额读数/刷新段）〔ESC批 V6〕＋`ui_struct_probe.gd:_ready`（顶栏位结构段） | 探针（跨卡联验：购买后刷新挂卡④单口） | 隔离存档实例 `meta_state._add_keystone(9999)`（`ui_click_probe.gd:74` 先例）→ 显式触发 `CampRefreshBus.refresh(camp_data)` → `camp_hud_band.refresh()` → `keystone_badge` 读数 | `keystone_badge.value_label.text`＝`camp_data()["balance"]`（`keystone_balance()` 单口取值）；直写后显式触发刷新才变（绑单口调用记录＋badge 文本状态源） | 既有：元进度入账与锻造两轴；新增：营地顶栏 HUD 钥石读数与刷新单口同步 |
| V7 零动效 | `camp_esc_overlay.gd` 直开直关（零 AnimationPlayer、源码禁 `create_tween`/`UiKit.motion`） | `ui_struct_probe.gd:_ready`（浮窗零动效契约段，仿 career :379-391）〔ESC批 V7〕 | 探针（结构/源码扫描） | 浮窗视图子树＋`camp_esc_overlay.gd` 源码 | 子树零 AnimationPlayer＋源码零 `create_tween`/`UiKit.motion` 令牌（扫描面 >0 非空前置） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| V3 返回主菜单 | `main_esc_flow.gd _on_return_to_menu()`（营地隐＋选档层同收＋开始层恢复） | `screen_flow_probe.gd:_ready`（返回动线段）〔ESC批 V3〕 | 探针 | 浮窗「返回主菜单」钮 `pressed` → `main_esc_flow._on_return_to_menu()` → 屏显编排 | **浮窗 closed（动线首步自收，契约 4 v1.4）**＋营地场景屏 `visible=false`＋选档层 `visible=false`＋`start_overlay.visible=true`（绑四处可见性/open-close 调用记录；`_screen_seals()` :51-57 互斥复跑） | 新增：Esc 浮窗唤起与三出口动线 |
| V4 设置项（双路径） | `main_esc_flow.gd _on_settings()`；`main_overlay_flow.gd _on_settings_closed` 语境分支 | `screen_flow_probe.gd:_ready`（营地浮窗→设置→关闭回浮窗段）〔ESC批 V4〕＋菜单路径冒烟 V3g settings 段复跑 | 探针（＋冒烟复跑） | 浮窗「设置」钮 → `ui.modals.flow.open(settings_overlay)` → 关闭 → `_on_settings_closed` 语境分支 | 设置开→浮窗 `visible` 恒 true（open 只隐登记序上方层——modal_stack.gd:27-31，浮窗登记在下、由树序遮挡非属性隐藏）；关闭→浮窗重现＋`start_overlay.visible=false`（绑语境分支谓词＝camp_esc_overlay.visible；反向断言「关闭设置后禁弹主菜单」） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| V5 退出项 | `main_esc_flow.gd _on_quit()` → `main.gd:143 _quit_game()`（原样复用） | `ui_struct_probe.gd:_ready`（退出钮接线结构断言）〔ESC批 V5〕 | 探针（源码/结构，headless 不可真退） | 浮窗「退出游戏」钮 `pressed` → `_on_quit()` → `_quit_game()`（`settings_store.save_settings()`＋`get_tree().quit()`） | 钮 `pressed` 连接目标＝`_on_quit`→`_quit_game`（绑信号连接与调用链；headless 不真退＝静态判据＋评审注记申报观测面局限）；**禁对退出钮 `pressed.emit()`**（防 `get_tree().quit()` 中止探针进程——quit(0) 仅靠 probe_gate 签名兜底不假绿，2026-11-01 双审补立） | 新增：Esc 浮窗唤起与三出口动线 |
| V6 HUD 余额 | `camp_hud_band.gd set_balance()`／`bind_refresh_bus()`／`refresh()`；`camp_scene_view.gd set_hud_band()` 填值；挂接卡④ `CampRefreshBus.refresh()` | `screen_flow_probe.gd:_ready`（HUD 余额读数/刷新段）〔ESC批 V6〕＋`ui_struct_probe.gd:_ready`（顶栏位结构段） | 探针（跨卡联验：购买后刷新挂卡④单口） | 隔离存档实例 `meta_state._add_keystone(9999)`（`ui_click_probe.gd:74` 先例）→ 显式触发 `CampRefreshBus.refresh(camp_data)` → `camp_hud_band.refresh()` → `keystone_badge` 读数 | `value_label.text`＝`"钥石 %d" % camp_data()["balance"]` 格式串比较（badge 文本带「钥石 」前缀——`ui_kit.gd:632` 工厂约定单点，禁实现期自造第二格式串；`keystone_balance()` 单口取值，2026-11-01 双审订正）；直写后显式触发刷新才变（绑单口调用记录＋badge 文本状态源） | 既有：元进度入账与锻造两轴；新增：营地顶栏 HUD 钥石读数与刷新单口同步 |
| V7 零动效 | `camp_esc_overlay.gd` 直开直关（零 AnimationPlayer、源码禁 `create_tween`/`UiKit.motion`） | `ui_struct_probe.gd:_ready`（浮窗零动效契约段，仿 career :379-391）〔ESC批 V7〕 | 探针（结构/源码扫描） | 浮窗视图子树＋`camp_esc_overlay.gd` 源码 | 两新件源码（camp_esc_overlay.gd＋main_esc_flow.gd）＋浮窗子树零 AnimationPlayer＋源码零 `create_tween`/`UiKit.motion` 令牌（扫描面 >0 非空前置；扫描面扩两新件——2026-11-01 双审补立，开合编排件不脱扫） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| V8 层序与遮挡 | `ui_registry.gd` `LAYER_CONTRACT` 加 `camp_esc_overlay` 槽（营地层与 `settings_overlay` 之间）＋`node()` 寻址 | `ui_struct_probe.gd:_ready`（浮窗登记序/遮挡段）〔ESC批 V8〕＋`system_test.gd:_ready`（V1c 合同树序链 :94-106 复跑） | 探针（＋系统测试复跑） | `main.ui.LAYER_CONTRACT` 单一事实源；`ui.modals.flow.open()` 遮挡记账 | 登记册序＝合同模态序、直接子层树序＝合同序逐对相等；`debug_badge` 末位 float 类不注册（open 只动登记层，绑登记册成员性；F10 发布态恒隐，不绑 `visible==true`） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| V9 目检项登记 | `reports/iter<N>-实现报告-<日期>.md` 实机目检总清单 | 件核对（`体验验证清单.md` 登记，登记不阻塞）〔ESC批 V9〕 | 用户目检（非自动化） | 用户实机（生命周期末步统一进行，不阻塞迭代） | Esc 三动线＋HUD 余额观感＋浮窗视觉面（文字 WCAG 若入 shot_checker 取样，否则显式登记归目检并写明理由）入 `体验验证清单.md`＝登记即义务了结 | 既有：模态覆盖层编排与输入锁 |
| V10 反哺点清单 | §5 每条有落点 | 件核对表〔ESC批 V10〕 | 件核对（非自动化） | §5 同步面逐条对账 | §5 每条有 `reports/iter<N>-反哺点-<日期>.md` 落点 | 既有：模态覆盖层编排与输入锁 |
| B1 Esc 输入接线与浮窗视图（行为改动专行） | `main.gd` 输入入口/薄委托；`main_esc_flow.gd on_esc_input()`／`is_camp_context()`／`open_overlay()`／`close_overlay()`；`camp_esc_overlay.gd` 新建；`ui_registry.gd` 新槽 | `screen_flow_probe.gd:_ready`（Esc 唤起/关窗/非营地段）＋`ui_struct_probe.gd:_ready`（三钮/零动效/登记序段）〔ESC批 B1〕 | 集成 | 营地场景根态合成 Esc 键 → `main_esc_flow` → `ui.modals.flow.open/close(camp_esc_overlay)` | Esc 输入→浮窗 visible 两态（绑 open/close 调用记录）；语境判据返回值（绑 `is_camp_context()`）；浮窗三钮数量＋登记序（绑节点树与合同表） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| B2 HUD 栏落位与刷新挂单口（行为改动专行） | `camp_hud_band.gd` 新建；`camp_scene_view.gd set_hud_band()` 填值；订阅卡④ `CampRefreshBus.refresh()` | `screen_flow_probe.gd:_ready`（HUD 读数/刷新段）＋`ui_struct_probe.gd:_ready`（顶栏位结构段）〔ESC批 B2〕 | 集成 | `CampRefreshBus.refresh(camp_data)` → `camp_hud_band.refresh()` → `keystone_badge` | badge 文本＝`camp_data()["balance"]` 单口取值；顶栏位存在（结构断言，高 48px 浮层）；刷新单口调用记录（跨卡联验） | 既有：元进度入账与锻造两轴；新增：营地顶栏 HUD 钥石读数与刷新单口同步 |
| B1 Esc 输入接线与浮窗视图（行为改动专行） | `main.gd` 输入入口/薄委托；`main_esc_flow.gd on_esc_input()`／`is_camp_context()`／`open_overlay()`／`close_overlay()`；`camp_esc_overlay.gd` 新建；`ui_registry.gd` 新槽 | `screen_flow_probe.gd:_ready`（Esc 唤起/关窗/非营地段）＋`ui_struct_probe.gd:_ready`（三钮/零动效/登记序段）〔ESC批 B1〕 | 集成 | 营地场景根态合成 Esc 键 → `main_esc_flow` → `ui.modals.flow.open/close(camp_esc_overlay)` | Esc 输入→浮窗 visible 两态（绑 open/close 调用记录）；契约 9 四态路由（绑现开集合判据与 open/close 调用记录，含「设置开在浮窗之上」无反馈态）；浮窗三钮数量＋登记序（绑节点树与合同表） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
| B2 HUD 栏落位与刷新挂单口（行为改动专行） | `camp_hud_band.gd` 新建；`camp_scene_view.gd set_hud_band()` 填值；挂接卡④ `CampRefreshBus.refresh()` | `screen_flow_probe.gd:_ready`（HUD 读数/刷新段）＋`ui_struct_probe.gd:_ready`（顶栏位结构段）〔ESC批 B2〕 | 集成 | `CampRefreshBus.refresh(camp_data)` → `camp_hud_band.refresh()` → `keystone_badge` | badge 文本＝`camp_data()["balance"]` 单口取值；顶栏位存在（结构断言，高 48px 浮层）；刷新单口调用记录（跨卡联验） | 既有：元进度入账与锻造两轴；新增：营地顶栏 HUD 钥石读数与刷新单口同步 |
| B3 设置语境分支与返回主动线接线（行为改动专行） | `main_esc_flow.gd _on_return_to_menu()`／`_on_settings()`／`_on_quit()`；`main_overlay_flow.gd _on_settings_closed` 语境分支 | `screen_flow_probe.gd:_ready`（返回动线/设置双路径段）＋`ui_struct_probe.gd:_ready`（退出钮接线断言）〔ESC批 B3〕 | 集成 | 浮窗三钮 `pressed` → `main_esc_flow` 三出口 → 现役动线／`_quit_game`；设置关闭 → `_on_settings_closed` 语境分支 | 返回动线三处可见性（绑屏显编排）；设置关闭后浮窗 `visible=true`＋`start_overlay.visible=false`（绑语境分支）；退出钮连接链（绑信号连接） | 既有：模态覆盖层编排与输入锁；新增：Esc 浮窗唤起与三出口动线 |
**落点集中**：V1／B1 → T1／T3；V2／V7／V8 → T1／T3；V3／V4／V5／B3 → T3；V6／B2 → T2／T3；V9／V10 → T4。全表名实核对归 T4。
@@ -248,7 +257,7 @@
## 8. 异常分级
- **L1（自救一次）**：断言写法、探针合成键事件写法、命名、编译错误、签名拼写、测试套件 manifest 登记遗漏。
- **L2（记录继续；同一红连续三次升 L3）**：Esc 接线方式选型（§9 第 1 条域内）、浮窗壳尺寸/位次（UiKit 现行件域内）、HUD 栏位微调（顶栏域内）、行数较 T0 预期漂移但 S13 键不升。
- **L2（记录继续；同一红连续三次升 L3）**：浮窗壳尺寸/位次（UiKit 现行件域内）、HUD 栏位微调（顶栏域内）、行数较 T0 预期漂移但 S13 键不升。
- **L3（立即停卡写报告等用户）**：
- 卡④ 代码波未到位又需合并；
- Q1/Q2/Q3 裁定被执行期擅自改值（已裁＝甲/甲/甲，见 §10）；
@@ -260,8 +269,8 @@
## 9. 代拍板白名单（超清单必呈报）
1. Esc 输入接线方式（`_unhandled_input` vs InputMap 新 action vs 专用控制器）——约束：不吞他处输入、探针可合成；现 `screen_flow_probe.gd:156-160` 已有 `Viewport.push_input(InputEventKey)` 合成先例，T0 复核该先例与所选路线的兼容性（InputMap action＋轮询路线与合成探针的兼容性不预断，T0 定稿）。
2. 浮窗模态壳尺寸与位次（UiKit `modal_shell` 现行件域内，`ui_kit.gd:487`）。
1. **（v1.4 已定稿，移出白名单）Esc 接线＝事件驱动 `_unhandled_input`＋`KEY_ESCAPE`（physical_keycode）、禁 Input 单例轮询、不挂 ui_cancel、pressed 且非 echo**——契约 9 接线定稿（2026-11-01 用户裁）；白名单保留此条作裁定留痕，实现期无选型自由。
2. 浮窗模态壳尺寸与位次（UiKit `modal_shell` 现行件域内，`ui_kit.gd:486`）。
3. HUD 栏在顶栏的左右位次与间距（卡④场景屏顶栏域内）。
4. 「返回主菜单」复用卡④篝火同一处理函数（建议复用——动线同口；实现期定）。
5. 浮窗视觉面是否入 shot_checker 取样（T3 定：入＝补截图段；不入＝显式登记归目检并写明理由）。
@@ -284,11 +293,11 @@
连带：判据形态随案（T1 已列）；V1 按案分拆断言；契约 2 措辞裁后回写。
**裁定（2026-10-18）**：**甲**——只营地根态响应 Esc；子界面开着时 Esc 不唤浮窗。代拍板留痕（用户令「事项按推荐的来」，本项无推荐案，取默认甲＝语义最简；前提＝卡④ T3 承诺各子界面自带返回钮闭环，卡④ v3.0 已在内；追认单可 veto）。T1 判据＝营地场景屏 visible 且无营地子模态开态。裁定落 T0 执行＋实现报告留痕。
**裁定（2026-10-18）**：**甲**——只营地根态响应 Esc；子界面开着时 Esc 不唤浮窗。代拍板留痕（用户令「事项按推荐的来」，本项无推荐案，取默认甲＝语义最简；前提＝卡④ T3 承诺各子界面自带返回钮闭环，卡④ v3.1 已在内；追认单可 veto）。T1 判据＝营地场景屏 visible；「无营地子模态开态」由契约 9① 现开集合判据承载（v1.4，判据单点化）。裁定落 T0 执行＋实现报告留痕。
### Q2 · 浮窗的关闭/取消路径（已裁定 甲）
**背景**：`UiKit.modal_shell`（`ui_kit.gd:487`）只产 dim+center+panel+VBox、**无内置关闭件**；契约 1 禁加项⇒浮窗只有三钮，无一「关闭」。而 §4 不做清单把「任意键关闭浮窗」划为用户未裁禁自扩——Esc 自身再按的行为恰好落在被 punt 的缝隙里：Q1 两案都不覆盖「浮窗已开时按 Esc」。若不裁且无关闭钮，玩家误开浮窗后离开营地只有「回主菜单/开设置/退游戏」三条路——体感陷阱，且与卡④子界面（生涯有返回钮）的可用性水准倒挂。
**背景**：`UiKit.modal_shell`（`ui_kit.gd:486`）只产 dim+center+panel+VBox、**无内置关闭件**；契约 1 禁加项⇒浮窗只有三钮，无一「关闭」。而 §4 不做清单把「任意键关闭浮窗」划为用户未裁禁自扩——Esc 自身再按的行为恰好落在被 punt 的缝隙里：Q1 两案都不覆盖「浮窗已开时按 Esc」。若不裁且无关闭钮，玩家误开浮窗后离开营地只有「回主菜单/开设置/退游戏」三条路——体感陷阱，且与卡④子界面（生涯有返回钮）的可用性水准倒挂。
| 案 | 内容 | 代价 |
|---|---|---|
reports/需求卡片-营地场景图新建批-2026-10-18.md
+73 -64
View File
@@ -1,16 +1,16 @@
# 需求卡片：营地场景图新建批（交互式营地 · 七物件绑定 · 四柜台拆解）· 营地交互重做卡④
- 版本：**v3.0（现行有效卡）**。留痕：2026-10-21 用户令退回美术设计段待闭合；2026-10-31 用户令重立——美术设计已闭合（样张过审＋art-bible 条款版本），据 req-card 第〇步重立为现行有效卡，零设计待裁点。
- 版本：**v3.1（现行有效卡）**。留痕：2026-10-21 用户令退回美术设计段待闭合；2026-10-31 用户令重立——美术设计已闭合（样张过审＋art-bible 条款版本），据 req-card 第〇步重立为现行有效卡，零设计待裁点；2026-11-01 grilling＋godot-master 双审后用户令修订——§0.3 四道代码段开工门裁断销号（五裁点逐点拍板／P3·P5 销号口径落定／T1 后处理授权形态落定）、§2 现状事实换 2026-11-01 盘面、Godot 审查风险项落 T1·T2·V 面（1024 档换算式逐张登记／节点选型钉死／layout fail-fast 校验＋场景层序断言入 V1）。
- 来源：[需求澄清-营地交互重做-2026-10-18.md](需求澄清-营地交互重做-2026-10-18.md)（目标体验原话／目标结构树＋纵深稿／裁决 5·6·7·8·10／验收方式／切批原则④）＋ 样张过审（2026-10-31 用户裁定，清单 [artwork/candidates/_终稿裁定-2026-10-31.txt](../artwork/candidates/_终稿裁定-2026-10-31.txt)：各素材第一张样本稿为终稿、保留全部待选稿）＋ [art-bible.md](../design/art/art-bible.md) v3.24 §6.2（营地场景 10 层口径）（**唯一事实源**：样张过审 2026-10-31 ＋ art-bible.md v3.24 §6.2；配套 [camp.md](../design/gdd/ux/camp.md) v2.2／[camp-scene-prompts.md](../design/art/camp-scene-prompts.md) v1.2／[asset-path-map.md](../design/art/asset-path-map.md)／[art-assets-checklist.md](../design/art/art-assets-checklist.md) §3.5 同步；需求澄清为目标体验事实源）
- 归属：呈现层＋美术线（`game/presentation/` ＋ 场景素材）——营地交互重做五卡之四，**最大件**
- 排期：未编入（2026-10-18 用户令：需求卡片不预占迭代号，批次归属按工作量另裁）
- 开工门：**零设计待裁点，开工门＝U0**；编入迭代由 iter-plan 段发令，代码段按 `/iter` 开工，代码段开工门见 §0（不阻塞本卡作为有效卡与编迭代）
## 🔧 状态：现行有效卡（v3.0，2026-10-31 重立）
## 🔧 状态：现行有效卡（v3.1，2026-11-01 双审修订）
本卡设计线已闭合，凭据见 §0「重立凭据」：样张过审（2026-10-31）＋ art-bible v3.24 §6.2 条款版本齐备。设计待裁点清零、开工门＝U0；未编入迭代，编入由 iter-plan 段发令。属呈现层＋美术线，五卡之四。
本卡设计线已闭合，凭据见 §0「重立凭据」：样张过审（2026-10-31）＋ art-bible v3.24 §6.2 条款版本齐备。2026-11-01 grilling＋godot-master 双审通过、§0.3 四道代码段开工门全部裁断销号（用户照双审推荐采纳），设计待裁点与开工门清零；已编入迭代 47（roadmap.md 迭代总表，与卡⑤ 同波，卡⑤ 随本卡代码波之后）。属呈现层＋美术线，五卡之四。
**归属纪律**：本卡只登记代码段开工门与已裁断。前置由谁解决、何时解决、设计稿与素材由谁产出由用户定——美术/设计线＝用户自立批（铁律 2），Agent 不代跑、不代产、不自行开工设计稿。素材终稿落 `game/assets/art/` 属实现段 T1／`asset-ingest` 第 3 步，不属写卡门（用户 2026-10-31 令：只生成素材、不做后处理，开工时另发令）。
**归属纪律**：本卡只登记代码段开工门与已裁断。前置由谁解决、何时解决、设计稿与素材由谁产出由用户定——美术/设计线＝用户自立批（铁律 2），Agent 不代跑、不代产、不自行开工设计稿。素材终稿落 `game/assets/art/` 属实现段 T1／`asset-ingest` 第 3 步，不属写卡门（用户 2026-10-31 令：只生成素材、不做后处理；2026-11-01 用户裁：后处理授权随 /iter 开工令一并生效，见 §0.3－4）。
**批内批次次序（铁律 2：美术素材走自立批、不占迭代位；先产图后改代码）**：美术设计已闭合（样张过审）→ 场景素材后处理与入库（自立批，产物 `artwork/`→`game/assets/art/scene/`）→ 本卡代码段 `/iter`（与卡⑤ 同波）。工程面 ①②③ 代码已随迭代 33 合回（卡①②③ 已按吸收即死退役）；④⑤ 未编排，编入哪一迭代由用户经迭代编排段发令。
@@ -31,18 +31,18 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| -- | ------- | ---- | ---- | ---- |
| P1 | Q1 美术渠道裁定（A/B） | 用户 | **已裁＝B·插画级新产**（2026-10-22）；✦ 渠道作者自跑远程生图管线，规格沿用 art-bible §6.2／§8.1／§8.2 既有裁决 | art-assets-checklist.md §3.5 |
| P2 | 像素规格 | 用户线 | **Q6 甲过渡口径已裁**：现役 1280 工程档（1280×800）＋烛光黄 #F6C667／木色 #8A5A34；2× 源档出图、最近邻降采样；终档归样张批冻结清单后置换（反哺点登记），执行归用户线 | 契约 8 |
| P3 | 点选反馈设计稿（悬停高亮／提示文案／可点区域判定） | 用户线 | **代码段开工门**：camp.md v2.2 已定四态规格；设计稿细化未受命开工，Agent 不代跑不代产 | §0.3 |
| P3 | 点选反馈设计稿（悬停高亮／提示文案／可点区域判定） | 用户线 | **已销号（2026-11-01 用户裁）**：销号口径＝camp.md v2.2:35-37 四态规格即点选反馈设计稿（四态参数已钉死）；剩余实质＝七物件名牌文案与可点区域视觉，归 T2 域内（名牌文案按 §1 绑定表界面名逐字落、可点区域判定归 §9 白名单 3） | §0.3 |
| P4 | 参照物 | 用户 | **已补**（2026-10-23）＝`artwork/2026-10-23-营地场景/Gemini_Generated_Image_ykrc0nykrc0nykrc.jpg`，已进 camp-scene-prompts.md §1 登记为「作者提供的参照物」，与纵深稿对过表、围墙结构冲突已呈报；参照物只是参考图，保留 `artwork/`、不入 git、不入游戏目录 | camp-scene-prompts.md §1 |
| P5 | GDD／art-bible 营地条款落文 | 文档批（用户发令） | **代码段开工门**：camp.md v2.2／art-bible v3.24 §6.2 已先行落文新形态；实装状态回填与 §7.5／§2.8 同步归文档批，实现批禁写 `design/` | §5 反哺点 |
| P5 | GDD／art-bible 营地条款落文 | 文档批（用户发令） | **已销号（2026-11-01 用户裁）**：销号口径＝形态落文完成（camp.md v2.2／art-bible v3.24 §6.2 已在盘）；实装状态回填与 §7.5／§2.8 同步归 T6 反哺点义务（§5），非停机条件，实现批禁写 `design/` | §5 反哺点 |
### 0.3 代码段 `/iter` 开工门（不是设计待裁点，不阻塞重立卡与编迭代）
下列项属代码段开工门；未销号即需开工对应任务段＝§8 L3 停机呈报，禁批内自补、禁 T0 现场发挥：
1. **P3 点选反馈设计稿**：悬停高亮／提示文案／可点区域判定三项细化稿（camp.md v2.2 已定四态规格与名牌参数，设计稿只细化呈现，不阻塞本卡成立）。
2. **P5 GDD／art-bible 条款落文**：文档批对实装状态、§7.5／§2.8 的回填（实现批禁写 `design/`，逐条列 `reports/iter<N>-反哺点-<日期>.md`）。
3. **camp-scene-prompts.md §5 五个待裁点**：帐篷尺寸（现 300×170 待重定）／门扇高宽（现 240×220，围墙带仅 43px 高、叠放关系待裁）／布告板位置（现 y330 悬空、建议 (845,268,130,140) 挂回围墙带）／描边颜色追认（现按奶油色、去底技术前提，改深灰褐须换去底方案）／营地环境子板色值（art-bible §4.1 数值单点，待作者拍板）。五点阻塞坐标表定稿与接线，不阻塞出图（样张已过审）。
4. **十张终稿后处理与入库**：终稿此刻＝原始候选图本身（带通道水印、浅灰不透明底、画布 2560×1600 或 1024×1024），未做去底／擦水印／降采样／裁围墙细条；落 `game/assets/art/scene/` 属实现段 T1／`asset-ingest` 第 3 步，用户 2026-10-31 令只生成素材不做后续工序，开工时另发令。
1. **P3 点选反馈设计稿——已销号（2026-11-01 用户裁）**：销号口径＝camp.md v2.2:35-37 四态规格即点选反馈设计稿（悬停／按下／禁用／常态参数已钉死）；剩余实质＝七物件名牌文案与可点区域视觉，归 T2 域内（名牌文案按 §1 绑定表界面名逐字落，可点区域判定归 §9 白名单 3）。
2. **P5 GDD／art-bible 条款落文——已销号（2026-11-01 用户裁）**：销号口径＝形态落文完成（camp.md v2.2／art-bible v3.24 §6.2 已在盘）；实装状态回填与 §7.5／§2.8 同步归 T6 反哺点义务（§5），非停机条件。
3. **camp-scene-prompts.md §5 五裁点——已裁断（2026-11-01 用户裁，照双审推荐采纳）**：①帐篷 300×170 追认现值 ②门扇 240×220 追认现值、坐标按门洞 x520–760 对齐锚点 ③布告板 (845,268,130,140) 挂围墙带（y330 悬空案弃）④描边颜色＝奶油色追认（去底技术前提随现值锁定，改深灰褐须换去底方案全批重出、禁）⑤营地环境子板色值**不前置**——T1 量化实际用色后按 art-bible §4.1 两道门（语义检查＋RGB 三通道差）登记；未登记前 T5「截屏级 48 色计数是否新建」（§9－4）为条件步：色值已登记→拍板，未登记→该子步显式跳过＋T6 登记遗留（不阻塞批末闸，素材级二器 palette_check／standee_asset_check 已覆盖素材级执法）。camp-scene-prompts.md §5 节改已裁＋art-bible :398 对应三处值落文归文档批（§5 反哺点表已列）。
4. **十张终稿后处理与入库——发令形态已裁（2026-11-01 用户裁）**：**/iter 开工令即含 T1 后处理授权**（去底转透明〔bg 不去底、全幅不透明〕／擦通道水印／降采样／裁围墙细条／色板量化），不再两次发令；逐张画布档→目标矩形换算式登记见 §6 T1（1024×1024 档无整数倍降采样，禁现场默认）。
### 0.4 10 层拆分（现行口径，覆盖旧 8／9 张）
@@ -51,7 +51,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| z0 | `scene_camp_bg` | 不透明全幅＝天空＋远山＋整片地面＋门洞内一条通向远处的小路 | 否 |
| z1 | `scene_camp_wall` | 透明底，横贯全宽密排竖木桩墙（左右两段）＋两根略高门柱；门洞 x520–760 留透明缺口透出 bg 小路；落盘按细条 (0,240,1280,70) 裁、不做全幅 | 否 |
| z2 | `scene_camp_board` 布告板 | 挂围墙带，点进图鉴占位 | 是 |
| z3 | `scene_camp_gate` 门扇 | 半开双扇，叠在门洞上（高宽待 §0.3 裁） | 是 |
| z3 | `scene_camp_gate` 门扇 | 半开双扇，叠在门洞上（240×220 追认现值、2026-11-01 裁；坐标按门洞 x520–760 对齐） | 是 |
| z4 | `scene_camp_dummy` 木桩／`scene_camp_forge` 锻炉／`scene_camp_tent` 帐篷 | 木桩、锻炉可点；帐篷承载件不可点 | 部分 |
| z5 | `scene_camp_chest` 宝箱／`scene_camp_notebook` 笔记本 | 宝箱、帐篷旁笔记本 | 是 |
| z6 | `scene_camp_campfire` 篝火 | 最前；命中矩形只取下半（火堆），上半火焰只展示 | 是 |
@@ -105,24 +105,24 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
6. 美术约束（48 色板／禁入带／语义色／WCAG）入闸或登记缺口；**用户目检项登记 07**（生命周期末步，不阻塞）；
7. 批末重闸按改动域选档全绿；三份 `reports/` 产出物写齐（T6）。
## 2. 现状事实（开工日 T0 复核行号）
## 2. 现状事实（2026-11-01 双审全量复核换新盘面；开工日 T0 仍按「漂移即停卡核对」抽核）
| # | 事实 | 出处 |
| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| F1 | 营地场景图完全不存在（澄清④判定「完全没有 · 新建」）；现营地＝CampOverlay 四柜台覆盖层（树淬炼／锻造工坊／秘宝匣／奖励格图鉴并排，迭代 21 T6 程序占位重排——代码注释原文「视觉终稿归 HUD 营地视觉批」） | `需求澄清-营地交互重做-2026-10-18.md` §④；`game/presentation/views/camp_overlay_view.gd:86-87` |
| F2 | 营地屏壳（CampScreen）持 CampOverlay 成员；组合根 `main.camp_overlay` 句柄指向屏壳成员（探针挂载假设） | `game/presentation/scenes/camp_screen.gd:8-14`；`main.gd:112` |
| F3 | CampOverlay 结构：顶栏铭牌＋钥石徽（:64-84）；四柜台并排横滚（树淬炼 :99-109／锻造工坊 :111-137／秘宝匣 :139-159／奖励格图鉴 :161-172）；底栏关闭钮＋最近冒险条带（:174-189）；钥匙门判据读树投影（:287-296）；图鉴柜台＝结构位预留（:168「内容排 Alpha」） | `camp_overlay_view.gd` 各处 |
| F4 | 五目标界面现状：锻造工坊＝CampOverlay 内工作间（`_forge_workbench` 两区六路线）；秘宝匣＝`_ws_scroll`／`_workshop_holder`（12 件＋同调装配段＋Y 升级行）；天赋树＝`_tree_holder`（脉分组行板＋Fork 双态钮）；图鉴＝占位；生涯＝**已独立全屏页**（CareerOverlay，入口现居主菜单生涯钮，自带返回钮） | `camp_overlay_view.gd:116-137`／:144-159／:99-109／:161-172；`views/career_overlay.gd`；`main.gd:332` |
| F1 | 营地场景图完全不存在（澄清④判定「完全没有 · 新建」）；现营地＝CampOverlay 四柜台覆盖层（树淬炼／锻造工坊／秘宝匣／奖励格图鉴并排，迭代 21 T6 程序占位重排）——原引注释「视觉终稿归 HUD 营地视觉批」已随后续重构删除（2026-11-01 复核，引文退役、事实不变） | `需求澄清-营地交互重做-2026-10-18.md` §④；`game/presentation/views/camp_overlay_view.gd` |
| F2 | 营地屏壳（CampScreen）持 CampOverlay 成员；组合根句柄＝`main.ui.modals.camp_overlay`（ui_modals.gd:14；ui_registry.gd:25 LAYER_CONTRACT 模态槽）——`main.camp_overlay` 旧寻址已退役，探针挂载随句柄迁移（F8） | `game/presentation/scenes/camp_screen.gd:8-14`；`game/presentation/ui_modals.gd:14`；`game/presentation/ui_registry.gd:25` |
| F3 | CampOverlay 结构（结构在、行号以 2026-11-01 复核为基准）：顶栏铭牌＋钥石徽（:125）；四柜台并排横滚（树淬炼／锻造工坊／秘宝匣／图鉴——图鉴锁文现 :207）；底栏关闭钮＋最近冒险条带（:214 起，`_rebuild_recent` :634）；钥匙门判据读树投影 | `camp_overlay_view.gd` 各处 |
| F4 | 五目标界面现状：锻造工坊＝CampOverlay 内工作间（`_forge_workbench` 两区六路线）；秘宝匣＝`_ws_scroll`／`_workshop_holder`（12 件＋同调装配段＋Y 升级行）；天赋树＝`_tree_holder`（脉分组行板＋Fork 双态钮）；图鉴＝占位；生涯＝**已独立全屏页**（CareerOverlay，入口现经组合根函数直调——卡②已撤主菜单生涯钮、改函数直调中间态，shot_probe.gd:103／ui_struct_probe.gd:59「careerbtn 已撤」注；终态＝本批改挂帐篷旁笔记本，自带返回钮） | `camp_overlay_view.gd` 四柜台各处；`views/career_overlay.gd` |
| F5 | 营地购买写口链路：视图只发意图信号（`buy_requested`／`tree_buy_requested`／`forge_*` 等），组合根经 CampShopPresenter 转 MetaProgression 写口；投影数据＝`camp_shop_presenter.gd:62-72` `camp_data()` 单点 | `camp_overlay_view.gd:8-15`；`camp_shop_presenter.gd:62-72` |
| F6 | 断点确认弹窗现居主菜单开始冒险路径（有断点先出 ConfirmDialog 再开局）——随卡②撤钮整体移交本卡大门 | `main.gd:475-497` |
| F7 | 冒险屏已实现不动：选路屏（LevelMapScreen，`route_chosen` 前进唯一通道）与战斗屏宿住 AdventureScreen；组合根侧：`_start_adventure_from_menu`（:475-484）／`_on_confirm_new_adventure`（:487-492）／`_resume_from_menu`（:518-536）／`_start_adventure`（:579-597）／`build_adventure_params`（:564-574） | `views/level_map_screen.gd:7`；`scenes/adventure_screen.gd:36-37`；`main.gd` 各处 |
| F8 | 探针面营地段（全部随本批迁移）：ui_probe（营地入口+余额+秘宝匣 12 行断言 :28-55，深员 `_balance_label`／`_tree_buy_btns`／`_workshop_rows` :39-52）、ui_click_probe（营地购买全链 :53-127；**断点确认段 :500-528**〔经 lvbtn 驱动 ConfirmDialog 取消／开新冒险——被卡②撤钮＋本批弹窗移位双杀〕）、screen_flow_probe（营地可见态键 :53 直读 `main.camp_overlay.visible`；营地开合 :109-125 回退段直呼 `main.camp_overlay.closed.emit()`；菜单→冒险 lvbtn 步 :130-136）、shot_probe（camp 截图＋「关闭营地」钮收闭 :126-133）、ui_struct_probe（camp 结构审计 :41-49；同槽特例断言 :331／:373）、smoke_all（V2 营地屏壳实例化 :170-171；V3g 营地模态开合 :405-435；**camp_overlay_view.gd 源码断言段 :6469-6475**〔三条锁四柜台等高形态本身——`Vector2(0,336)`×3／`SIZE_FILL`×4／`SIZE_SHRINK_CENTER`≥3，随形态退役〕）、ui_contrast_probe（营地令牌段 :48-55〔UiKit 令牌恒等式，不随拆解红；新界面若不再消费 `CAMP_HEADER_BAND`／`CAMP_ROW_PLATE` 则段标签虚挂，须核签〕）、**forge_workbench_test.gd 单测**（:33 直载 camp_overlay_view.gd 并消费 `_forge_rows`／`_forge_workbench`／`open_camp`／`refresh_camp`／三 forge 信号——CampOverlay 一删即红） | `game/smoke/` 各处＋`game/tests/unit/presentation/forge_workbench_test.gd:33` |
| F6 | 断点确认链已随卡②摘除（main.gd:118-120 注释「弹窗本体与两分支逻辑归卡④大门承接」）；main.gd:475-497 现为选档委托（旧「断点弹窗现居主菜单」引文失实，2026-11-01 复核）——断点确认弹窗本卡 T4 承接（卡②移交） | `main.gd:118-120` |
| F7 | 冒险屏已实现不动：选路屏（LevelMapScreen，`route_chosen` 前进唯一通道）与战斗屏宿住 AdventureScreen；组合根侧（2026-11-01 复核行号）：`_start_adventure_from_menu` :116／`_resume_from_menu` :150／`build_adventure_params` :183／`_start_adventure` :198——`_on_confirm_new_adventure` 已随卡②摘除（T4 重立消费方编排） | `views/level_map_screen.gd:7`；`scenes/adventure_screen.gd:36-37`；`main.gd` 各处 |
| F8 | 探针面营地段（全部随本批迁移；宿主＝`game/probe/`＋`game/tests/`——`game/smoke/` 目录已于 2026-10-24 退役（git 16c6f136）、smoke_all.gd 已整体退役（git 957391e1），v3.0 的 `game/smoke/*`＋smoke_all 旧盘面写法作废）：ui_probe（营地入口＋余额＋秘宝匣 12 行断言，深员 `_balance_label`／`_tree_buy_btns`／`_workshop_rows`）、ui_click_probe（营地购买全链；**断点确认段**〔经 lvbtn 驱动 ConfirmDialog——被卡②撤钮＋本批弹窗移位双杀〕）、screen_flow_probe（营地旗标 :54 直读主菜单句柄——:53 是菜单行，v3.1 订正；营地开合 :119-125 回退段；菜单→冒险 lvbtn 步）、shot_probe（camp 截图＋「关闭营地」钮收闭；生涯段函数直调驱动 :103）、ui_struct_probe（camp 结构审计；同槽特例断言）、system_test.gd（V2 营地屏壳实例化 :67-68；V3g 营地模态开合 :520-541）、theme_projection_test.gd:710-717（四柜台等高源码断言段 `_smoke_element_details`——`Vector2(0,336)`×3／`SIZE_FILL`×4／`SIZE_SHRINK_CENTER`≥3，随形态退役）、ui_contrast_probe（营地令牌段〔UiKit 令牌恒等式，不随拆解红；新界面若不再消费 `CAMP_HEADER_BAND`／`CAMP_ROW_PLATE` 则段标签虚挂，须核签〕）、**forge_workbench_test.gd 单测**（:33 直载 camp_overlay_view.gd 并消费 `_forge_rows`／`_forge_workbench`／`open_camp`／`refresh_camp`／三 forge 信号——CampOverlay 一删即红） | `game/probe/` 各处＋`game/tests/system_test.gd:67-68`／:520-541＋`game/tests/unit/presentation/theme_projection_test.gd:710-717`＋`game/tests/unit/presentation/forge_workbench_test.gd:33` |
| F9 | camp UX spec 现行 **camp.md v2.2** 已落文可点击场景图形态（定位／场景构成与七物件绑定／10 层拆分／点选反馈四态／顶栏 48px／叠层与开合）；本批实现＝**对齐** v2.2，旧三柜台形态已由 v2.2 取代，本批只需回填实装状态与目检结论 | `design/gdd/ux/camp.md:10-51` |
| F10 | art-bible 现行 **v3.24 §6.2** 已落文营地场景 10 层口径（z0 bg 不透明全幅／z1 wall 透明细条门洞缺口／八物件层／篝火命中只下半／围墙落盘 (0,240,1280,70)）；§7.5 营地界面已改为「可点击场景图＋七物件点选」画法；§2.8 承载元素同述；本批实现＝对齐现行条款 | `design/art/art-bible.md` §6.2／§7.5／§2.8 |
| F11 | 图鉴内容在册挂起：奖励格图鉴柜台已随配比预设批整体挂起冻结（2026-10-05 用户令，06 在册），重启须用户另行发令——本批只改入口不激活内容 | `design/gdd/systems/跨局循环/生涯.md:63` |
| F12 | 贴图重构批搁置未废：营地与元进度件终稿置换（06:21-27）等交互重做定形后再议（澄清③1／§⑧5）——本批不清偿该债；四柜台拆解后原「柜台场景贴图」债对象变化，随该批重新评估 | `design/gdd/06-待办清单.md:21-27`；`需求澄清-营地交互重做-2026-10-18.md` §③1／§⑧5 |
| F13 | 营地底栏「最近冒险」条带与生涯历史回看同源（同一份 `recent_summaries`），其去留＝生涯.md P6 待裁点（期二必答）——CampOverlay 拆解后该条带无处挂，**Q4 已裁＝甲**（随四柜台拆解撤下，逐局历史回看归生涯，生涯.md P6 同批注销） | `camp_overlay_view.gd:186-189`／:536-549；`生涯.md:69` |
| F14 | 素材线纪律：`artwork/` 不入 git（`.gitignore:51` 忽略行）——批次 worktree 内无该目录、主工作区 D:/code/g-plan2 实体存在（在途工作区）；涉素材脚本须传主区绝对路径否则静默 0 张；素材替换前先归档旧档；终稿归 `game/assets/art/scene/`，消费常量 `UiKit.TEX_CAMP_*`（asset-path-map.md §3／art-assets-checklist.md §3.5） | `AGENTS.md:32`；`.gitignore:51`；art-bible §8.3 归档纪律 |
| F12 | 贴图重构批搁置未废：营地与元进度件终稿置换（待办清单.md 在册条）等交互重做定形后再议（澄清③1／§⑧5）——本批不清偿该债；四柜台拆解后原「柜台场景贴图」债对象变化，随该批重新评估（原 `design/gdd/06-待办清单.md` 路径已迁仓库根） | `待办清单.md`（仓库根）；`需求澄清-营地交互重做-2026-10-18.md` §③1／§⑧5 |
| F13 | 营地底栏「最近冒险」条带与生涯历史回看同源（同一份 `recent_summaries`），其去留＝生涯.md P6 待裁点（期二必答）——CampOverlay 拆解后该条带无处挂，**Q4 已裁＝甲**（随四柜台拆解撤下，逐局历史回看归生涯，生涯.md P6 同批注销） | `camp_overlay_view.gd`（底栏 :214 起／`_rebuild_recent` :634）；`生涯.md:69` |
| F14 | 素材线纪律：`artwork/` 不入 git（`.gitignore:54` 忽略行）——批次 worktree 内无该目录、主工作区 D:/code/g-plan2 实体存在（在途工作区）；涉素材脚本须传主区绝对路径否则静默 0 张；素材替换前先归档旧档；终稿归 `game/assets/art/scene/`；**消费常量 `UiKit.TEX_CAMP_*` 尚不存在**（全仓 grep 零命中，仅 art-assets-checklist.md:135 文字提及）——本批在 `ui_kit.gd` 新增十键（T1 先定常量、素材名跟常量走，防断链；2026-11-01 裁） | `AGENTS.md:32`；`.gitignore:54`；art-bible §8.3 归档纪律；art-assets-checklist.md §3.5 |
| F15 | 美术硬约束继续有效（澄清③4）：明亮轻快像素风、**48 色板、HSV 300°–345° 禁入带、语义色纪律、WCAG ≥4.5:1**——全局约束，不在本讨论范围翻案 | `需求澄清-营地交互重做-2026-10-18.md` §③4 |
| F16 | 像素级规格已定（Q6 甲过渡口径＋渠道 B）：1280×800 工程档、烛光黄 #F6C667／木色 #8A5A34、2× 源档出图最近邻降采样（art-assets-checklist.md §3.5）；终档归样张批冻结清单后置换（反哺点）；卡内禁自定像素规格数值 | `design/art/art-assets-checklist.md` §3.5；`design/art/art-bible.md` §6.2 |
| F17 | 机检工具面：**截屏级 48 色计数不在役**；在役＝`tools/palette_check.py`（art-bible §8.3①挂点——48 设计色板令牌＋新增色双门）＋`tools/standee_asset_check.py`（像素画单张 32 色冻结执法）；`tools/render_gate.sh`（shot_probe 七屏→shot_checker 语义断言；golden 段＝棋盘三张＋menu_boot 四张，**无 camp golden**——shot_checker.py:143 明载「camp/level 走骨架+目检清单」）；shot_checker 段＝屏级骨架／文字 WCAG／明度三档带／文字禁压纹理／文字在判据 | `tools/palette_check.py`；`tools/standee_asset_check.py`；`tools/render_gate.sh`；`tools/shot_checker.py:143` |
@@ -138,7 +138,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
🔴 **契约 3 · 大门两分支**（裁决 5，Q5 已裁＝甲）：有未完冒险→ConfirmDialog 三出口「继续上一段冒险／开始新冒险／取消」；无→「是否开始新冒险：是/否」弹窗。**点大门永远先出确认，不直接进冒险**；cancelled 恒＝无变更退回营地；弹窗类＝ConfirmDialog（三钮化＋消费方编排＝T4，卡③ 契约 3 同款互指）。
🔴 **契约 4 · 已实现界面只改挂不重做＋presenter 承接面**：锻造工坊／秘宝匣／天赋树／图鉴／生涯五界面「界面已实现 · 入口改挂」——功能、行板、写口链路零重设计（拆解＝承载面迁移）。**presenter 改造＝承载面迁移的一部分**：`camp_shop_presenter.gd` 持 `camp_overlay` 句柄（:10）、七条写口尾全部 `camp_overlay.refresh_camp(camp_data())`（:85／93／105／117／129／142／154／168）、`CampFlowContext` 持类型化字段（camp_flow_context.gd:10／22／29）、open／close 编排（:41-56）——**写口语义零改≠presenter 文件零改**：投影目标改线（五界面／场景根）、写口尾刷新改路由、open／close 编排随入口从 campbtn 迁位到卡③ 进档动作、ctx 字段语义订正、探针缝保位（main.gd:1163-1171）。改造纪律：`on_camp_attune_toggle`（:98-106）尾只 refresh_camp、不调 `_refresh_presentations`（与其余六口不一致）——**保持原样，禁「顺手统一」防行为漂移**。
🔴 **契约 4 · 已实现界面只改挂不重做＋presenter 承接面**：锻造工坊／秘宝匣／天赋树／图鉴／生涯五界面「界面已实现 · 入口改挂」——功能、行板、写口链路零重设计（拆解＝承载面迁移）。**presenter 改造＝承载面迁移的一部分**：`camp_shop_presenter.gd` 持 `camp_overlay` 句柄（:10）、写口尾刷新调用八处（七口＋`on_camp_buy` 双尾）全部 `camp_overlay.refresh_camp(camp_data())`（:82／90／102／114／126／139／151／165，2026-11-01 复核实数）、`CampFlowContext` 持类型化字段（camp_flow_context.gd:10／22／29）、open／close 编排（:41-56）——**写口语义零改≠presenter 文件零改**：投影目标改线（五界面／场景根）、写口尾刷新改路由、open／close 编排随入口从 campbtn 迁位到卡③ 进档动作、ctx 字段语义订正、探针缝保位（组合根薄委托缝，T0 复核现役行号——原引 main.gd:1163-1171 超出文件实长、系旧盘面残留）。改造纪律：`on_camp_attune_toggle` 口尾（:102）只 refresh_camp、不调 `_refresh_presentations`（与其余口不一致）——**保持原样，禁「顺手统一」防行为漂移**。
🔴 **契约 5 · 图鉴内容保持挂起**：只改入口（布告板），不激活图鉴内容（F11：2026-10-05 用户令冻结，重启须用户发令）；布告板点开的图鉴＝现行占位态（T3 定义占位壳），不是禁用态（camp.md v2.2）。
@@ -158,7 +158,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
## 4. 范围边界
**做**：场景屏＋10 层场景素材铺底＋七物件命中区与点选交互（反馈细节按 §0.3 P3 设计稿、四态规格按 camp.md v2.2）；四柜台拆解与五界面入口改挂（含 presenter 承接面改造）；大门动线两分支＋断点弹窗移位；篝火回主菜单小动线（带二次确认）；场景屏顶栏预留位；断言／探针迁移；反哺点清单。
**做**：场景屏＋10 层场景素材铺底＋七物件命中区与点选交互（四态规格按 camp.md v2.2——§0.3 P3 已销号＝camp.md v2.2 四态规格即设计稿）；四柜台拆解与五界面入口改挂（含 presenter 承接面改造）；大门动线两分支＋断点弹窗移位；篝火回主菜单小动线（带二次确认）；场景屏顶栏预留位；断言／探针迁移；反哺点清单。
**不做**（明示去向）：
- **不做贴图重构批**（澄清③1）：柜台场景贴图／钥石顶栏图标／永久强化条目图标的达标化置换——搁置未废，待交互重做完形后重新评估立项（F12）；
@@ -167,7 +167,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- 不改冒险屏／选路屏／战斗屏本体（F7 已实现不动）；
- 不做整屏样张闸、不替代样张批、不新建 camp golden（§0.5／契约 10）；
- 局内状态面板零改动（契约 6）；
- 素材后处理与入库属实现段 T1／`asset-ingest` 第 3 步、开工另发令（§0.3－4），不属写卡门；
- 素材后处理与入库属实现段 T1／`asset-ingest` 第 3 步（§0.3－4 授权形态：/iter 开工令即含授权），不属写卡门；
- ESC 浮窗与顶栏 HUD 实现 → 卡⑤（本卡只留顶栏位＋定义刷新单口）；
- 选档界面／主菜单／数据层 → 卡③／卡②／卡①。
@@ -179,13 +179,14 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
|---|---|---|
| `design/gdd/ux/camp.md` v2.2 | §定位／§场景构成与七物件绑定／§点选反馈／§顶栏／§叠层与开合：新形态已落文，本批实现后回填实装状态、样张过审留痕、实机目检结论 | 反哺点 · 列清单（实现批禁写 `design/`） |
| `design/art/art-bible.md` v3.24 | §6.2 营地场景 10 层口径已落文；§7.5 营地界面画法、§2.8 承载元素、§1.4 营地屏整屏样张排队行注记（本批不跑样张闸） | 反哺点 · 列清单（权威面零直改，过用户裁决后归文档批） |
| `design/art/camp-scene-prompts.md` v1.2 | §5「待裁」节五点已裁断（2026-11-01 用户裁：①帐篷追认现值②门扇追认现值③布告板 (845,268,130,140)④描边奶油色追认⑤环境子板色值不前置、T1 量化后按 §4.1 登记）——§5 节改已裁＋§2.3 对应坐标值；art-bible :398 三处在册值随落文 | 反哺点 · 列清单 |
| `design/gdd/systems/跨局循环/生涯.md` | :69 与营地边界表（条带 `_rebuild_recent` 随 CampOverlay 拆解去向＝Q4 已裁甲）；:63 图鉴挂起条（入口改挂注记） | 反哺点 · 列清单 |
| `design/gdd/08-Alpha版本标准.md` | 「三 · 界面」营地行（:104）形态注记改写——状态列可改；注记改写列反哺点；增删行须用户裁（三卡统一口径） | 反哺点 · 列清单 |
| `design/gdd/06-待办清单.md` | 本卡登记条；UI 贴图重构批条（:21-27）注记「四柜台对象变化、重评待交互重做完形」；图鉴挂起条注记 | 反哺点 · 列清单（实现批禁写待办清单） |
| `design/gdd/07-体验验证清单.md` | 新增实机目检条（场景观感／七物件辨识与点选反馈／大门两分支／篝火动线）——登记不阻塞 | 反哺点 · 列清单（实现批禁写体验验证清单，入册条目由文档批落） |
| `roadmap.md` | 迭代行编入／状态刷新 | 反哺点 · 列清单（实现批禁写 roadmap） |
| `game/tests/README.md` | 能力行入表（§7 对照表「能力行」列定名） | 写卡段定名（本卡只写卡内能力行文字，README 由主 Agent 统一收口）；实现批只核对名实一致，禁写 |
| `game/presentation/*`、`game/smoke/*`、`game/tests/**`（含 forge_workbench_test 迁移面）、`game/tests/golden/*`（仅棋盘／menu 既有基线复跑）、`game/assets/art/scene/*`（10 层终稿） | 实现／断言／终稿素材本体 | 实施本体（可写） |
| `game/presentation/*`、`game/probe/*`、`game/tests/**`（含 forge_workbench_test 迁移面）、`game/tests/golden/*`（仅棋盘／menu 既有基线复跑）、`game/assets/art/scene/*`（10 层终稿） | 实现／断言／终稿素材本体 | 实施本体（可写） |
| `tools/shot_checker.py` | camp 取样面语义断言段（文字 WCAG／明度三档带／文字禁压纹理／文字在判据扩 camp） | 实施本体（可写，属工具／测试面） |
## 卡前·文件结构与职责（T0 前）
@@ -194,9 +195,9 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| 文件 | 职责 | 改动类型 | 落位 | 对照表行 |
|---|---|---|---|---|
| `game/presentation/views/camp_scene_view.gd` | 交互式营地场景图视图：10 层纹理铺底（z0–z6）＋七物件命中区＋点选反馈四态＋名牌 | 行为改动 | 新建 | V1／V2／V9／V10 |
| `game/data/tables/camp_scene_layout.tres` | 10 层贴图矩形／命中矩形／z 序／门洞缺口坐标（数值单一事实源 `data/tables/`，坐标最终值随 §0.3 代码段开工门裁定落入，本卡不硬定） | 行为改动 | 新建 | V1／V2／V9 |
| `game/presentation/views/camp_refresh_bus.gd` | 营地刷新单口：各写口尾→现开界面刷新＋场景根 HUD 刷新一闸完成（卡⑤ 同口挂接） | 行为改动 | 新建 | V8／B1 |
| `game/presentation/views/camp_scene_view.gd` | 交互式营地场景图视图：10 层纹理铺底（z0–z6）＋七物件命中区＋点选反馈四态＋名牌（节点选型＝Control 根＋TextureRect 层＋子节点序即 z 序，T2） | 行为改动 | 新建 | V1／V2／V9／V10 |
| `game/data/tables/camp_scene_layout.tres` | 10 层贴图矩形／命中矩形／z 序／门洞缺口坐标（数值单一事实源 `data/tables/`；schema 类＋表现域容器类型化成员，先例 battle_layout.tres＝`core/config_db.gd`／`core/config_domain_presentation.gd`；加载期 fail-fast 校验命中区几何，T2） | 行为改动 | 新建 | V1／V2／V9／V14 |
| `game/presentation/views/camp_refresh_bus.gd` | 营地刷新单口：各写口尾→现开界面刷新＋场景根 HUD 刷新一闸完成（卡⑤ 同口挂接；头注自陈「非 autoload、非信号广播——组合根单点推送」） | 行为改动 | 新建 | V8／B1 |
| `game/presentation/views/forge_view.gd` | 锻造工坊独立可开界面（自 CampOverlay `_forge_workbench` 抽出，界面逻辑复用） | 行为改动 | 新建（抽出） | V4／B2 |
| `game/presentation/views/treasure_view.gd` | 秘宝匣独立可开界面（自 `_ws_scroll`／`_workshop_holder` 抽出） | 行为改动 | 新建（抽出） | V4／B2 |
| `game/presentation/views/tree_view.gd` | 天赋树独立可开界面（自 `_tree_holder` 抽出） | 行为改动 | 新建（抽出） | V4／B2 |
@@ -205,17 +206,19 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| `game/presentation/views/camp_overlay_view.gd` | 四柜台覆盖层拆解后退役（无消费面即删，吸收即死） | 行为改动 | 退役 | V4／V9／B2 |
| `game/presentation/views/career_overlay.gd` | 生涯页入口自主菜单改挂帐篷旁笔记本（本体零改，返回钮文案禁含「营地」） | 行为改动 | 复用既有（改入口） | V5 |
| `game/presentation/views/confirm_dialog.gd` | 三钮化（继续上一段冒险／开始新冒险／取消） | 行为改动 | 复用既有（改） | V3／B1 |
| `game/presentation/presenters/camp_shop_presenter.gd` | 投影目标改线＋七写口尾刷新改路由＋open／close 编排迁位（契约 4） | 行为改动 | 复用既有（改） | V4／V8／B1 |
| `game/presentation/core/camp_flow_context.gd` | 类型化字段语义订正 | 行为改动 | 复用既有（改） | V4／B1 |
| `game/presentation/camp_shop_presenter.gd` | 投影目标改线＋写口尾刷新改路由＋open／close 编排迁位（契约 4；路径订正——v3.0 写 `presenters/` 子目录不存在） | 行为改动 | 复用既有（改） | V4／V8／B1 |
| `game/presentation/camp_flow_context.gd` | 类型化字段语义订正（路径订正——v3.0 写 `core/` 子目录不存在） | 行为改动 | 复用既有（改） | V4／B1 |
| `game/presentation/ui_modals.gd` | 新场景根句柄与四子界面句柄落 UiModals 成员面（先例 :8-20 现役句柄；槽名 T0 定稿，2026-11-01 双审补列） | 行为改动 | 复用既有（改） | V1／V8 |
| `game/presentation/main_ui_build.gd` | 新层实例化装配点：各 `.new()`＋装配尾 `apply_layer_contract(root)`（先例 :105/:121/:242；2026-11-01 双审补列） | 行为改动 | 复用既有（改） | V1／V8 |
| `main.gd`（组合根） | 断点弹窗移位＋ConfirmDialog 三钮消费方编排＋营地入口改挂＋篝火动线＋开层互斥／关层收闭 | 行为改动 | 复用既有（改） | V3／V4／V7／B1 |
| `game/assets/art/scene/scene_camp_*.png`（10 张） | 10 层场景素材终稿（asset-ingest 第 3 步拷入，命名对齐 `UiKit.TEX_CAMP_*`） | 非行为改动（美术资源） | asset-ingest | V1／V10 |
| `game/smoke/shot_probe.gd` | camp 截图路径改场景图＋收闭改接篝火动线 | 非行为改动（测试面） | 复用既有（改） | V1 |
| `game/smoke/ui_click_probe.gd` | 七物件可达＋大门两分支＋断点确认段改走大门＋写口链迁移＋深员改指 | 非行为改动（测试面） | 复用既有（改） | V2／V3／V4 |
| `game/smoke/ui_probe.gd` | 营地入口／余额／秘宝匣深员改指新界面 | 非行为改动（测试面） | 复用既有（改） | V4 |
| `game/smoke/screen_flow_probe.gd` | 营地键新语义＋回退段改新场景根 closed／篝火动线 | 非行为改动（测试面） | 复用既有（改） | V7 |
| `game/smoke/ui_struct_probe.gd` | 反参照结构禁词＋生涯段驱动改接＋图鉴占位锚定 | 非行为改动（测试面） | 复用既有（改） | V5／V6／V9 |
| `game/smoke/ui_contrast_probe.gd` | 营地令牌段核签（CAMP_HEADER_BAND／CAMP_ROW_PLATE 消费判定） | 非行为改动（测试面） | 复用既有（改） | V10 |
| `game/smoke/smoke_all.gd` | V2 实例化／V3g 模态开合改指＋`camp_overlay_view.gd` 源码断言段 :6469-6475 重写或注销 | 非行为改动（测试面） | 复用既有（改） | V4／B2 |
| `game/assets/art/scene/scene_camp_*.png`（10 张） | 10 层场景素材终稿（asset-ingest 第 3 步拷入，命名对齐 `UiKit.TEX_CAMP_*`——常量十键本批在 `ui_kit.gd` 新增） | 非行为改动（美术资源） | asset-ingest | V1／V10 |
| `game/probe/shot_probe.gd` | camp 截图路径改场景图＋收闭改接篝火动线 | 非行为改动（测试面） | 复用既有（改） | V1 |
| `game/probe/ui_click_probe.gd` | 七物件可达＋大门两分支＋断点确认段改走大门＋写口链迁移＋深员改指 | 非行为改动（测试面） | 复用既有（改） | V2／V3／V4 |
| `game/probe/ui_probe.gd` | 营地入口／余额／秘宝匣深员改指新界面 | 非行为改动（测试面） | 复用既有（改） | V4 |
| `game/probe/screen_flow_probe.gd` | 营地旗标新语义＋回退段改新场景根 closed／篝火动线 | 非行为改动（测试面） | 复用既有（改） | V7 |
| `game/probe/ui_struct_probe.gd` | 反参照结构禁词＋生涯段驱动改接＋图鉴占位锚定＋camp 场景层序段（V1 补立） | 非行为改动（测试面） | 复用既有（改） | V1／V5／V6／V9 |
| `game/probe/ui_contrast_probe.gd` | 营地令牌段核签（CAMP_HEADER_BAND／CAMP_ROW_PLATE 消费判定） | 非行为改动（测试面） | 复用既有（改） | V10 |
| `game/tests/system_test.gd`＋`game/tests/unit/presentation/theme_projection_test.gd` | V2 实例化／V3g 模态开合改指（system_test :67-68／:520-541）＋四柜台等高源码断言段重写或注销（theme_projection_test :710-717）——`game/smoke/smoke_all.gd` 已退役，v3.0 旧位点作废 | 非行为改动（测试面） | 复用既有（改） | V4／B2 |
| `game/tests/unit/presentation/forge_workbench_test.gd` | 随锻造视图抽出同迁（断言零改、只换承载类） | 非行为改动（测试面） | 复用既有（改） | V4／B2 |
| `tools/shot_checker.py` | camp 取样面语义断言段 | 非行为改动（工具／测试） | 复用既有（改） | V10 |
| `game/tests/README.md` | 能力行入表（四列：能力｜系统｜真实入口｜代表用例） | 非行为改动（文档，写卡段） | 主 Agent 统一收口 | 全表能力行 |
@@ -230,7 +233,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| 新件 | 复用面（grep 同职责实现） | 唯一面（grep 同名同义标识符） | 分层与交互面（调用路径＋跨层出口） |
|---|---|---|---|
| `camp_scene_view.gd` | 盘上视图件＝CampOverlay（四柜台覆盖层，形态本批退役、与场景图形态正交，反参照禁复用）、CareerOverlay（生涯全屏页，职责不同）、camp_screen.gd（屏壳）。**无**「场景图铺底＋七物件命中区＋点选反馈」同职责实现 → 不能复用，须新建视图件；屏壳复用既有 `camp_screen.gd` 改造，不新建屏壳 | grep `camp_scene`／`scene_camp` 视图标识符盘上无第二处；素材消费常量 `UiKit.TEX_CAMP_*` 单点（asset-path-map.md §3），不另立路径常量 | 呈现层视图，零 Core 写调用；命中区 `_gui_input()` → `object_pressed(key: String)` 信号 → 组合根 → 开界面／写口；10 层装载经 `UiKit.load_tex()`（exists 守卫、禁 preload）；不直连 MetaProgression |
| `camp_scene_layout.tres` | grep `game/data/tables/` 无营地坐标表；坐标草案在 artwork HTML（不入 git）与 camp-scene-prompts §2.3（设计文档，非运行时数据源）。数值单一事实源要求落 `data/tables/` → 新建 | 坐标事实只此一处；禁在 `camp_scene_view.gd`／探针／T 卡各写一份坐标字面量（契约 8 禁自定规格、数值单点） | 视图启动时经 ConfigDB 单点读取；坐标最终值随 §0.3 代码段开工门（camp-scene-prompts §5 五裁点）裁定落入，本卡只定结构键不定值 |
| `camp_scene_layout.tres` | grep `game/data/tables/` 无营地坐标表；坐标草案在 artwork HTML（不入 git）与 camp-scene-prompts §2.3（设计文档，非运行时数据源）。数值单一事实源要求落 `data/tables/` → 新建 | 坐标事实只此一处；禁在 `camp_scene_view.gd`／探针／T 卡各写一份坐标字面量（契约 8 禁自定规格、数值单点） | 视图启动时经 ConfigDB 单点读取（schema 类＋表现域容器类型化成员，先例 battle_layout.tres）；坐标值按 §0.3－3 五裁点裁断（2026-11-01）由 T2 定值落入 |
| `camp_refresh_bus.gd` | grep 现役 `refresh_camp` 绑定 CampOverlay 句柄（F5），随四柜台形态**退役**（卡⑤／§0.5 明确「非已退役的 refresh_camp」）；新单口须同时刷新现开界面与场景根 HUD、职责不同 → 不能复用，须新建 | grep `camp_refresh`／刷新单口类标识符盘上无第二处；卡⑤ HUD 刷新挂此单口，不另立第二口 | 组合根拆件：七写口尾 → `CampRefreshBus.refresh(camp_data: Dictionary) -> void` → 现开界面刷新＋场景根 HUD 刷新；一次性刷新，不新增写口语义（契约 4） |
| `forge_view.gd`／`treasure_view.gd`／`tree_view.gd`／`codex_view.gd` | 界面逻辑**已实现**于 CampOverlay 内（F4：`_forge_workbench`／`_ws_scroll`／`_tree_holder`／图鉴占位）；本批是抽出承载壳、**复用既有界面逻辑**（行板／写口链路零重设计，契约 4），非从零新写 → 新建壳、迁移逻辑 | grep `forge_view`／`treasure_view`／`tree_view`／`codex_view`／`_forge_rows`／`_forge_workbench` 盘上无第二处定义；`forge_workbench_test.gd:33` 消费 `_forge_rows`／`_forge_workbench`，抽出后同迁，断言零改只换承载类 | 各视图发意图信号（`buy_requested`／`tree_buy_requested`／`forge_*`）→ 组合根 → CampShopPresenter → MetaProgression 写口（Core 零 UI 不破）；五界面各带返回／关闭钮；开合走模态栈单口、层序入 `LAYER_CONTRACT` |
@@ -252,7 +255,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| `camp_scene_view.gd` | 预期 ≤8：`setup_layers()`／`bind_hotspots()`／`set_feedback_state()`／`get_hotspot_rect()`／`set_hud_band()`／`_on_hotspot_input()` 等，远低 ≤20 | 预期 ≤12：10 层纹理句柄＋命中区表＋反馈态＋名牌节点；收编进内聚结构，低 ≤15 | 无自存量文件迁入函数 | 三查通过；T0 实测实数回填，超阈值即拆件或砍面（砍面＝退设计段裁职责） |
| `camp_refresh_bus.gd` | 预期 ≤3：`refresh()`／`bind_targets()`／`_dispatch()`，远低 ≤20 | 预期 ≤4：现开界面句柄＋场景根 HUD 句柄＋投影数据，低 ≤15 | 自 `camp_shop_presenter.gd` 迁入刷新路由；先查 `tools/gdstyle_baseline.txt` 源函数键，branches／returns／函数长超默认登记值的迁移即拆函数（拆分不改语义，不算迎合机检） | 三查通过；迁入后补跑 S13，不凭旧读数放行 |
| 四界面 view（各） | 各预期 ≤6：`open()`／`close()`／`bind_rows()`／`_on_action()` 等，远低 ≤20 | 各预期 ≤10：复用既有行板成员（`_forge_workbench`／`_ws_scroll`／`_tree_holder`），低 ≤15 | 自 `camp_overlay_view.gd` 迁入对应界面函数；逐个对 `tools/gdstyle_baseline.txt` 源键，超登记值即拆函数 | 三查通过；抽出后实测实数回填 |
| `camp_scene_layout.tres` | 不适用（数据件，无方法） | 不适用（结构键，非类变量） | 不适用（无迁入函数） | 结构键唯一，坐标值随 §0.3 开工门落入 |
| `camp_scene_layout.tres` | 不适用（数据件，无方法） | 不适用（结构键，非类变量） | 不适用（无迁入函数） | 结构键唯一，坐标值按 §0.3－3 五裁点裁断（2026-11-01）由 T2 定值落入 |
### 存量触面一查
@@ -270,18 +273,20 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- 取用：待办清单条目状态（文档设计已闭合＋美术设计已闭合＋已写卡）、§0 重立凭据、art-bible v3.24 §6.2、camp.md v2.2、camp-scene-prompts.md v1.2、`_终稿裁定-2026-10-31.txt`、布局草案-1280x800.html。
- [ ] 复核 §2 F1–F20 全部 `file:line` 行号；四柜台界面清单与探针面清单（F8）逐点过——漂移即停卡核对，不猜行号。
- [ ] 设计输入齐备检查：Q1（美术渠道＝B 已裁）／Q2（参照物已补）／Q4（条带＝甲）／Q5（三钮＝甲）／Q6（过渡口径＝甲）／Q8（出稿方式＝甲）状态逐项核为已裁；**代码段开工门**（§0.3：P3／P5／camp-scene-prompts §5 五裁点／素材后处理入库）状态逐项核——未销号项对应的任务段禁开工（缺输入＝呈报，禁批内自补）。
- [ ] 设计输入齐备检查：Q1（美术渠道＝B 已裁）／Q2（参照物已补）／Q4（条带＝甲）／Q5（三钮＝甲）／Q6（过渡口径＝甲）／Q8（出稿方式＝甲）状态逐项核为已裁；**代码段开工门**（§0.3 四项）状态逐项核为已裁断销号（2026-11-01）——若发现裁断实况反转＝L3 停机呈报，禁批内自补。
- [ ] **新场景根句柄名＋四子界面（forge/treasure/tree/codex view）＋场景层 `LAYER_CONTRACT` 槽名定稿**（显式验收点，2026-11-01 双审补立——卡⑤ 只消费不改名）；落 `ui_modals.gd` 成员面＋`main_ui_build.gd` 装配点（卡⑤ v1.4 文件表同步列）。
- [ ] **跨卡排序登记**：camp 断言基线建立在无 HUD 场景屏（本卡 T5）；卡⑤ T2 落 HUD 后由卡⑤ 限 HUD 区显式更新＋呈报（卡⑤ v1.4 §0 已对齐）。
- [ ] 规格清单依赖核检：样张批规格清单产出时点 vs 本批排期——按 Q6 甲过渡口径执行（1280 工程档＋烛光黄／木色，终档置换归反哺点），禁 T0 现场发挥。
- [ ] 跑 `bash tools/gdstyle.sh game` 开发期局部读数，记录 `camp_screen.gd`／`camp_shop_presenter.gd`／`main.gd` 当前行数、类变量、公开方法数；登记 S13 基线键（预期只降不升）。本步为最窄确认，不构成验收。
- [ ] 跑 `bash tools/static_scan.sh` 开发期局部读数（gdstyle 键＝S13，闸件 `tools/gdstyle_gate.py`——原 `tools/gdstyle.sh` 不存在，v3.1 订正），记录 `camp_screen.gd`／`camp_shop_presenter.gd`／`main.gd` 当前行数、类变量、公开方法数；登记 S13 基线键（预期只降不升）。本步为最窄确认，不构成验收。
- [ ] 与卡③ 对齐 ConfirmDialog 消费方编排机制（T4 互指）、与卡⑤ 对齐顶栏位与营地刷新单口（§0.5 跨卡接口）。
- 产出：基线 commit、S13 实数、设计凭据核对表、代码段开工门未销号清单；后续卡只按本卡契约施工。
### T1 场景素材终稿录入（asset-ingest 第 3 步，≈1–1.5d，用户另发令）
### T1 场景素材终稿录入（asset-ingest 第 3 步，≈1–1.5d；后处理授权随 /iter 开工令，§0.3－4）
- 取用：P1＝B 渠道已裁（2026-10-22）、P4 参照物已补（2026-10-23）、Q6 甲过渡口径已裁（1280×800＋烛光黄／木色、2× 源档最近邻降采样）、`_终稿裁定-2026-10-31.txt`（各素材第一张样本稿为终稿、保留全部待选稿）、camp-scene-prompts.md §2–§4。
- [ ] 按终稿裁定清单核对十层指定文件（z0 bg／z1 wall／z2–z6 八物件层），确认各取第一张样本稿为终稿、其余候选保留不删。
- [ ] 用户发令后做后处理：去底转透明（bg 不去底、全幅不透明）／擦通道水印／降采样到 1280×800（整数倍）／围墙层裁细条 (0,240,1280,70) 不做全幅／色板量化／四联底测试条——工具清单见 `design/art/art-pipeline-tools.md`；**用户 2026-10-31 令只生成素材不做后续工序，本步须开工另发令**。
- [ ] 产物落盘：`artwork/`（在途，主区绝对路径）→ 验收后终稿 `game/assets/art/scene/`；替换先归档旧档；命名 `scene_camp_<键>.png` 对齐消费常量 `UiKit.TEX_CAMP_*`（asset-path-map.md §3／art-assets-checklist.md §3.5，先定资源路径常量、素材名跟它走，防断链）。
- [ ] 后处理（**授权形态已裁 2026-11-01：/iter 开工令即含本步授权**，不再两次发令）：去底转透明（bg 不去底、全幅不透明）／擦通道水印／降采样／围墙层裁细条 (0,240,1280,70) 不做全幅／色板量化／四联底测试条——工具清单见 `design/art/art-pipeline-tools.md`。**降采样逐张登记换算式**（2026-11-01 双审补立）：2560×1600 档＝÷2 最近邻；**1024×1024 档无整数倍降采样（1024＜1280）**——按非整数缩放显式特批登记（L2 记录＋实现报告申报像素纪律局限），不回炉重出（追认 2026-10-31 已过审终稿优先、免美术线重开），禁现场默认。
- [ ] 产物落盘：`artwork/`（在途，主区绝对路径）→ 验收后终稿 `game/assets/art/scene/`；替换先归档旧档；命名 `scene_camp_<键>.png` 对齐消费常量 `UiKit.TEX_CAMP_*`（常量十键本批在 `ui_kit.gd` 新增——先定资源路径常量、素材名跟它走，防断链；asset-path-map.md §3／art-assets-checklist.md §3.5）；texture 导入口径＝mipmaps 关、filter 跟项目默认（Nearest，project.godot 现行）。
- [ ] 美术硬约束入产线（契约 7）：48 色板／HSV 300°–345° 禁入带／语义色／WCAG／Nearest；**色板机检二器复用**（`palette_check.py` 48 令牌＋新增色双门／`standee_asset_check.py` 像素 32 色冻结）。
- [ ] 方向稿选划留痕：用户 2026-10-31 已裁「第一张样本稿为终稿、保留全部待选稿、每个都还可以接受」，选划三段表进开工单；本批不再重跑方向稿工序。
- [ ] 终稿落盘「验收」口径＝契约 9（迭代内验收：截图对比＋shot_checker 机检＋样张过审留痕）。
@@ -289,11 +294,13 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
### T2 场景视图与点选交互（≈1.5–2d）
- 取用：T1 十层终稿 `UiKit.TEX_CAMP_*`、`camp_scene_layout.tres` 坐标结构键、camp.md v2.2 点选反馈四态规格、§0.3 P3 设计稿（代码段开工门）。
- [ ] 在 `game/presentation/views/camp_scene_view.gd` 实现 `setup_layers()`：按 §0.4 z0–z6 铺 10 层（bg 不透明全幅／wall 透明细条 (0,240,1280,70)／门洞 x520–760 留透明缺口透出 bg 小路／八物件层）；围墙不并回背景层、门洞不填死、门洞不被任何物件遮挡。
- 取用：T1 十层终稿 `UiKit.TEX_CAMP_*`、`camp_scene_layout.tres` 坐标结构键、camp.md v2.2 点选反馈四态规格、§0.3 P3 已销号（camp.md v2.2 四态规格即设计稿）。
- [ ] 节点选型（2026-11-01 godot-master 审查定案）：**Control 根＋TextureRect 层＋子节点序即 z 序**；禁 CanvasLayer（绕开 LAYER_CONTRACT 树序落位）、禁 z_index、禁 Sprite2D 根（项目视图全 extends Control；全屏 UI canvas_items 拉伸需 Control 锚点；ui_registry.gd:76 落位口按子节点序 move_child）。命中区＝TextureRect 分区＋`_gui_input()`（§9－3 域内确认 TextureRect 分区）。
- [ ] 在 `game/presentation/views/camp_scene_view.gd` 实现 `setup_layers()`：按 §0.4 z0–z6 铺 10 层（bg 不透明全幅／wall 透明细条 (0,240,1280,70)／门洞 x520-760 留透明缺口透出 bg 小路／八物件层）；围墙不并回背景层、门洞不填死、门洞不被任何物件遮挡。
- [ ] 实现七物件命中区 `bind_hotspots()` 与 `get_hotspot_rect()`：读 `camp_scene_layout.tres` 坐标键；七件两两不相交、不越画面、不侵入顶栏禁区 y≤48；篝火命中矩形只取下半（火堆），火焰只展示。
- [ ] 实现点选反馈四态 `set_feedback_state()`（零新素材、全程序化）：悬停＝轮廓亮边＋浮动（整像素吸附）＋名牌（下方 8px 居中、字号 14、对比 ≥4.5:1）／按下＝位移 1px／禁用＝降明度＋去饱和（仅锻炉、宝箱）／已解锁＝常态；提示文案与可点区域视觉按 §0.3 P3 设计稿销号后落（未销号＝本段禁开工）。
- [ ] 场景屏顶栏预留位 `set_hud_band()`（高 48px 浮层覆盖、不挤压画面，卡⑤ 填值）；刷新入口＝本卡 T3 定义的营地刷新单口（卡⑤ 同口挂接）。
- [ ] `camp_scene_layout.tres` 加载期 fail-fast 校验（2026-11-01 双审补立）：七命中区两两不相交／不越画面／不侵 y≤48，违则致命中止（fail-fast 红线；契约 7 几何红线机检化）。
- [ ] 实现点选反馈四态 `set_feedback_state()`（零新素材、全程序化）：悬停＝轮廓亮边＋浮动（整像素吸附）＋名牌（下方 8px 居中、字号 14、对比 ≥4.5:1）／按下＝位移 1px／禁用＝降明度＋去饱和（仅锻炉、宝箱）／已解锁＝常态。实现约束（2026-11-01 双审补立）：悬停浮动位移经 Tween（禁 `_process` 逐帧移 UI）；名牌 Label `mouse_filter = IGNORE`（防挡命中区，UiKit 惯例 ui_kit.gd:312/333）；名牌位置加画面内钳制（贴底物件防出画）；禁用态去饱和经 ShaderMaterial（modulate 只能调明度，去饱和需 shader——零新素材、代码件）。
- [ ] 场景屏顶栏预留位 `set_hud_band()`（高 48px 浮层覆盖、不挤压画面，卡⑤ 填值；载体循 UiKit `page_shell` 的 `PRESET_TOP_WIDE`＋`custom_minimum_size` 先例 ui_kit.gd:523-525，禁手动 rect）；刷新入口＝本卡 T3 定义的营地刷新单口（卡⑤ 同口挂接）。
- [ ] 叠层规则显式派生并写入 V2 断言：随 §9 第 2 条承载形态裁定派生——独立全屏页＝场景根隐藏（生涯先例）／单一内页切换＝场景根留底；「缩放虚化」是两选项之外的第三形态（涉新演出面＋素材），禁批内自选（若设计稿／用户想要，升格裁点）。
- [ ] 键盘焦点／手柄不涉（08:191-192 排 Beta；ESC 属卡⑤ 用户明示裁决面）。
- 产出：`CampSceneView.setup_layers()`／`bind_hotspots()`／`set_feedback_state()`／`get_hotspot_rect()`／`set_hud_band()`，`object_pressed(key: String)` 信号；T3 按接口块接线。
@@ -305,8 +312,8 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- [ ] 按契约 11 拆分边界纪律落四界面：每界面写职责语句与单一变化原因（实现报告逐件一行）、有集体身份；禁凑计数袋、禁沿阈值轴硬拆；拆不出内聚单元＝停卡呈报走豁免。
- [ ] 生涯页入口自主菜单生涯钮改挂帐篷旁笔记本（CareerOverlay 本体零改）；**生涯页返回钮文案禁含「营地」字样**（ui_struct_probe.gd:382 nojump 禁词表含「营地」——career_overlay.gd:27 现「返回」安全，改文案时避坑）。
- [ ] 入口改挂后各界面开合走模态栈单口；层序入 `LAYER_CONTRACT`。
- [ ] **CampShopPresenter 承接面改造（契约 4）**：投影目标改线（五界面／场景根）、七写口尾刷新改路由（经营地刷新单口——**各写口尾→现开界面刷新＋场景根 HUD 刷新一闸完成**）、open／close 编排从 campbtn 迁位到卡③ 进档动作、CampFlowContext 字段语义订正、探针缝保位（main.gd:1163-1171）；`on_camp_attune_toggle`（:98-106）尾只 refresh_camp、不调 `_refresh_presentations` 保持原样。
- [ ] 新建 `camp_refresh_bus.gd` 实现 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`（T0 接口块）；卡⑤ HUD 刷新挂此单口，非已退役的 `refresh_camp`。
- [ ] **CampShopPresenter 承接面改造（契约 4）**：投影目标改线（五界面／场景根）、七写口尾刷新改路由（经营地刷新单口——**各写口尾→现开界面刷新＋场景根 HUD 刷新一闸完成**）、open／close 编排从 campbtn 迁位到卡③ 进档动作、CampFlowContext 字段语义订正、探针缝保位（组合根薄委托缝，T0 复核现役行号——原引 main.gd:1163-1171 超出文件实长）；`on_camp_attune_toggle` 口尾（:102）只 refresh_camp、不调 `_refresh_presentations` 保持原样。
- [ ] 新建 `camp_refresh_bus.gd` 实现 `CampRefreshBus.refresh(camp_data: Dictionary) -> void`（T0 接口块）；卡⑤ HUD 刷新挂此单口，非已退役的 `refresh_camp`；头注自陈「非 autoload、非信号广播——组合根单点推送」（防被读成已否决的全局事件总线形态，2026-11-01 双审注）。
- [ ] **图鉴占位态（契约 5）**：独立界面壳＝§9 第 2 条承载形态；文案照录 camp_overlay_view.gd:168 现行锁文，「柜台结构位预留」中『柜台』称谓随形态订正（L2 记录，零新文案）；V6 断言锚定新视图占位标签。
- [ ] **开层互斥与关层收闭**：营地开层时选档层被模态栈遮挡隐藏（卡③ T2 同口径）；篝火／ESC 回主菜单＝营地层与选档层同收＋开始层恢复（现役 on_camp_closed 模式只视野开始层，选档层不在其视野——须显式）。
- [ ] CampOverlay 类退役处理（拆解后无消费面即删——吸收即死）；`main.camp_overlay` 探针句柄迁移留痕。
@@ -318,9 +325,9 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- 取用：T2 的 `object_pressed(key: String)`、T3 的 `CampRefreshBus`、F6／F7 断点弹窗与冒险编排、Q5 已裁＝甲三钮化、卡③ ConfirmDialog 契约 3。
- [ ] 大门点击→两分支确认弹窗（裁决 5）：有断点＝ConfirmDialog 三出口「继续上一段冒险／开始新冒险／取消」；无断点＝「是否开始新冒险：是/否」；点大门永远先出确认、不直接进冒险。
- [ ] **三出口弹窗形态（Q5 已裁＝甲）**：ConfirmDialog 三钮化＋**消费方编排**（组合根单实例＋待确认消费方状态量：open 前设、confirmed／cancelled 后分派；cancelled 恒＝无变更退回营地；禁每次 connect／disconnect 漂移、禁双常驻静态接线——卡③ 契约 3 同款互指）。
- [ ] 断点弹窗自主菜单移位（main.gd:475-497 逻辑整体迁来，卡②已摘除原调用）。
- [ ] 断点弹窗移位：弹窗本体与两分支逻辑自组合根摘除位迁来（卡②已摘除原调用，main.gd:118-120 注释明载归本卡大门承接；main.gd:475-497 现为选档委托、非断点弹窗——旧引文失实，v3.1 订正）。
- [ ] 「继续上一段冒险」接现役续玩编排（`_resume_from_menu` 同源）；「开始新冒险」接现役开局编排（`_start_adventure` 同源）——冒险屏／选路屏／战斗屏零改（F7）。
- [ ] 冒险发起后营地场景屏隐藏；**终局落点不变量**：现役口径＝终局 continue 回主菜单（main.gd:703）——若后续改落点为营地，营地语境可能出现未收束会话，卡⑤「返回主菜单」动线须补 `_begin_session(false)`，两卡 T0 互证。
- [ ] 冒险发起后营地场景屏隐藏；**终局落点不变量**：现役口径＝终局 continue 回主菜单（`main_adventure_flow.gd:123-143` 终局出口 `_begin_session(false)`——原引 main.gd:703 失实，v3.1 订正）——若后续改落点为营地，营地语境可能出现未收束会话，卡⑤「返回主菜单」动线须补 `_begin_session(false)`，两卡 T0 互证。
- [ ] 篝火回主菜单动线：命中区只含火堆（不含火焰），**必须二次确认**（camp.md v2.2 已裁，走 ConfirmDialog 先例）；确认后营地层与选档层同收＋开始层恢复（T3 开层互斥／关层收闭同口径）。
- [ ] `_refresh_resume_button` **不复用**（大门两分支直读 `has_breakpoint`，无钮可刷——函数随卡②删，防两卡互以为对方在处理）。
- 产出：大门两分支＋三钮消费方编排＋篝火二次确认动线；T5 按接口块验收。
@@ -332,15 +339,16 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- [ ] **无 camp golden**（契约 10）：camp 验收＝shot_probe 出图＋shot_checker 语义断言段（文字 WCAG／明度三档带／文字禁压纹理／文字在判据扩 camp 取样面）；棋盘／menu 既有 golden 复跑。
- [ ] F8 全量位点逐点迁移：
- [ ] 探针深员改指表：ui_probe `_balance_label`／`_tree_buy_btns`／`_workshop_rows`（:39-52）、ui_click_probe `_tree_buy_btns`／`_tree_fork_btns`＋三处 `main.camp_overlay.refresh_camp(main._camp_data())` 直呼（:72／99／110）、ui_struct_probe audit 根（:45）——「改挂新入口」不够，这些是成员级耦合；七命中区与笔记本命中区的探针寻址名随 T2 命名稳定化一并定。
- [ ] smoke_all:6469-6475 源码断言段：三条锁四柜台等高形态本身——按新形态重写或注销（四栏等高纪律是否迁入新界面＝§9 第 2 条裁后定）。
- [ ] theme_projection_test.gd:710-717 四柜台等高源码断言段（`_smoke_element_details`）＋system_test.gd V2 实例化（:67-68）／V3g 模态开合（:520-541）：四柜台等高三条锁按新形态重写或注销（四栏等高纪律是否迁入新界面＝§9 第 2 条裁后定）——`game/smoke/smoke_all.gd` 已退役，v3.0 旧位点作废。
- [ ] ui_click_probe:500-528 断点确认段：改走大门路径断言（与 V3 合并或互指；卡② T2 明列移交、本卡 T5 接收）。
- [ ] ui_contrast_probe:48-55 营地令牌段：核签（新界面仍消费 `CAMP_HEADER_BAND`／`CAMP_ROW_PLATE`＝段留；不再消费＝段随注销）。
- [ ] forge_workbench_test.gd 单测：随锻造视图抽出同迁（断言零改、只换承载类）；V4 复跑清单补该单测。
- [ ] 生涯段驱动改接：ui_struct_probe:54-69 与 shot_probe:103-124 现经 `_start_overlay`「生涯」钮驱动——改挂后须合成点击场景笔记本命中区；命中区若为 TextureRect／Area2D 而非 Button，`ProbeUiUtil.find_button` 失效，寻址面随 T2 扩展。
- [ ] screen_flow_probe 营地键新语义：:53 改指新场景根句柄；子界面开态时键真值按 T2 叠层规则派生；:119-125 回退段改新场景根 closed 信号或篝火动线。
- [ ] 多卡共改文件分界：screen_flow_probe（入口路径段归卡②、键语义／开合／篝火段归本卡）、ui_click_probe（入口路径归卡②、槽操作路径归卡③、营地段＋断点确认段归本卡）——每条探针注分界。
- [ ] screen_flow_probe 营地旗标新语义：:54 改指新场景根句柄（:53 是菜单行，v3.1 订正）；子界面开态时键真值按 T2 叠层规则派生；:119-125 回退段改新场景根 closed 信号或篝火动线。
- [ ] 多卡共改文件分界：screen_flow_probe（入口路径段归卡②、键语义／开合／篝火段归本卡）、ui_click_probe（入口路径归卡②、槽操作路径归卡③、营地段＋断点确认段归本卡）——每条探针注分界；分界锚＝断言段语义/段名，不锚行号（一侧插删行会平移另一侧行号，2026-11-01 双审补立）。
- [ ] 新增断言段（**正向验收断言，从真实入口进入、判据绑被测改动特有的可观测提交面**）：七物件逐一可达对应界面；大门两分支；点大门不直接进冒险（绑 `confirmed` 信号与 `route_chosen` 未发）；点大门→开局后营地场景屏隐藏；图鉴＝占位挂起态；场景根态无文字按钮列表／无四柜台面板（反参照纪律断言）；presenter 七写口尾→现开界面刷新＋场景根 HUD 刷新一闸（绑刷新单口调用记录与 HUD 状态源取值）；三钮弹窗 cancelled 恒＝无变更退回营地（绑写口零调用＋营地根 visible）。**判据绑不上＝静态判据＋评审注记申报观测面局限，证明做不出＝停卡呈报；断言只在当轮真实跑批执行并通过，不做注入破坏。**
- [ ] 美术约束机检：shot_checker 现役段扩 camp 取样；截屏级 48 色计数是否新建＝§9 第 5 条拍板（依赖 §0.3 环境子板色值代码段开工门销号）。
- [ ] 美术约束机检：shot_checker 现役段扩 camp 取样；截屏级 48 色计数是否新建＝§9 第 4 条拍板（**条件步**：§0.3－3⑤环境子板色值已按 T1 量化登记→拍板；未登记→本子步显式跳过＋T6 登记遗留，不阻塞批末闸）。
- [ ] **新增两条 headless 断言（2026-11-01 godot-master 审查补立）**：①`ui_struct_probe` camp 场景层序段——camp_scene_view 子节点序＝layout 表 z 序逐层相等、各层纹理矩形与表逐值一致（本批核心视觉不变量的机器验收面）；②`camp_scene_layout.tres` 加载期校验断言——载入数据件断言校验通过＋七命中区几何（两两不相交／不越画面／不侵 y≤48）。
- 产出：探针／断言迁移留痕表（F8 全量位点逐点「改前→改后」）＋新增断言段；T6 收口。
### T6 产出物落位卡（≈0.5d，末卡）
@@ -363,7 +371,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| 需求点 | 改动（文件:行／行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|---|---|---|---|---|---|---|
| V1 场景图形态（机检半） | `camp_scene_view.gd` 10 层铺底（z0 不透明全幅含门洞小路／z1 透明细条 (0,240,1280,70) 门洞缺口／z2–z6）；`camp_screen.gd` 改挂；`shot_probe.gd` camp 段 | `shot_probe.gd:_ready`（camp 截图段）〔营地图批 V1〕＋`shot_checker.py` 结构禁词段 | 探针 | 进入存档→选档→进档→营地场景屏（shot_probe 驱动） | camp 截图出图非空＋shot_checker 结构禁词命中（无四柜台覆盖层／无文字按钮列表）；「七要素可辨（构图）」归 V11 目检 | 新增：营地场景图十层铺底与门洞留空呈现 |
| V1 场景图形态（机检半） | `camp_scene_view.gd` 10 层铺底（z0 不透明全幅含门洞小路／z1 透明细条 (0,240,1280,70) 门洞缺口／z2–z6）；`camp_screen.gd` 改挂；`shot_probe.gd` camp 段 | `shot_probe.gd:_ready`（camp 截图段）〔营地图批 V1〕＋`ui_struct_probe.gd:_ready`（camp 场景层序段）〔营地图批 V1〕＋`shot_checker.py` 结构禁词段 | 探针 | 进入存档→选档→进档→营地场景屏（shot_probe 驱动） | camp 截图出图非空＋shot_checker 结构禁词命中（无四柜台覆盖层／无文字按钮列表）；camp_scene_view 子节点序＝layout 表 z 序逐层相等、各层纹理矩形与表逐值一致（2026-11-01 双审补立——核心视觉不变量机器验收面）；「七要素可辨（构图）」归 V11 目检 | 新增：营地场景图十层铺底与门洞留空呈现 |
| V2 七物件可达性＋叠层退避 | `camp_scene_view.gd` 七命中区＋`object_pressed` 信号；`camp_scene_layout.tres` 坐标键；组合根开界面 | `ui_click_probe.gd:_ready`（七物件合成点击段）〔营地图批 V2〕 | 探针 | 命中区 `_gui_input()` → `object_pressed(key)` → 组合根开界面 | 七物件各自对应界面 visible 断言＋场景根按 T2 叠层规则退避（树序／可见性）；绑 `object_pressed` 信号发射面 | 既有：模态覆盖层编排与输入锁；新增：营地七物件命中区点选与分界面可达 |
| V3 大门两分支＋开局收闭 | `main.gd:475-497` 断点弹窗移位；`confirm_dialog.gd` 三钮化；消费方编排 | `ui_click_probe.gd:_ready`（大门两分支段／断点确认段 :500-528）〔营地图批 V3〕 | 探针 | 大门命中区 → ConfirmDialog（三出口）→ `main._on_confirm_new_adventure()`／`_resume_from_menu()` | 有断点三出口／无断点两出口；点大门不直接进冒险（绑 `confirmed` 信号与 `route_chosen` 未发）；cancelled 绑写口零调用＋营地根 visible；开局后营地场景屏隐藏 | 既有：断点片段往返与续玩幂等；新增：营地大门两分支确认与断点续玩接线 |
| V4 五界面功能＋写口链零回归 | 四界面 view 抽出；`camp_shop_presenter.gd` 承接面；`camp_flow_context.gd` 字段；`forge_workbench_test.gd` 迁移 | `forge_workbench_test.gd:_test_forge_rows`〔营地图批 V4〕＋`ui_click_probe.gd:_ready`（写口链段）＋`smoke_all.gd:_face_snapshot` 段 | 单元＋探针 | 五界面意图信号（`buy_requested`／`tree_buy_requested`／`forge_*`）→ CampShopPresenter → MetaProgression 写口 | 树购买／Fork 切换／锻造三意图／秘宝购买／同调装配既有断言全链复跑绿；presenter 各写口尾 MetaProgression 原语调用序列不变（绑调用序列，不绑终态兜底） | 既有：元进度入账与锻造两轴；新增：四柜台拆解后五界面入口改挂与写口零回归 |
@@ -372,14 +380,15 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
| V7 篝火动线（二次确认） | `main.gd` 篝火回主菜单＋开层互斥／关层收闭；`screen_flow_probe.gd` 段 | `screen_flow_probe.gd:_ready`（篝火／开合段）〔营地图批 V7〕 | 探针 | 篝火命中区（只下半火堆）→ ConfirmDialog 二次确认 → 主菜单 | 二次确认弹窗 `confirmed` 信号先于关层；确认后营地隐藏＋选档层同收＋主菜单可见（绑可见性／层序）；命中区只含火堆不含火焰 | 新增：营地篝火回主菜单与笔记本改挂动线 |
| V8 顶栏预留位＋刷新单口 | `camp_scene_view.gd` 顶栏 HUD 位；`camp_refresh_bus.gd` 新建；presenter 七写口尾改路由 | `ui_struct_probe.gd:_ready`（顶栏位段）〔营地图批 V8〕＋`ui_click_probe.gd:_ready`（写口尾刷新段） | 探针 | 写口尾 → `CampRefreshBus.refresh(camp_data)` → 现开界面刷新＋场景根 HUD 刷新 | 场景屏顶栏 HUD 位存在（结构断言，高 48px 浮层）；各写口尾→现开界面刷新＋场景根 HUD 刷新一闸完成（绑刷新单口调用记录与 HUD 状态源取值）；卡⑤ 联验填值 | 新增：营地刷新单口与场景根 HUD 同步 |
| V9 反参照纪律 | `camp_scene_view.gd` 根态；`camp_overlay_view.gd` 退役；`smoke_all.gd:6469-6475` 源码断言段 | `ui_struct_probe.gd:_ready`（结构禁词段）〔营地图批 V9〕 | 探针 | 营地根态场景树审计 | 营地根态无文字按钮列表、无四柜台面板（结构禁词断言）；四柜台等高源码断言按新形态重写或注销（迁移留痕） | 新增：营地图鉴占位挂起态与反参照结构纪律 |
| V10 美术约束 | `tools/shot_checker.py` camp 取样面；`ui_contrast_probe.gd` 令牌核签；素材色板二器 | `ui_contrast_probe.gd:_ready`（营地令牌段）〔营地图批 V10〕＋`shot_checker.py` WCAG／明度三档带段 | 探针（机检） | camp 截图＋素材文件（`palette_check.py`／`standee_asset_check.py`） | 文字 WCAG ≥4.5:1／明度三档带／文字禁压纹理底／文字在判据；素材色板（48 令牌＋新增色双门／像素 32 色冻结）；§9 第 5 条拍板截屏计数面 | 既有：UI 全局主题与按钮五态（含对比度锚）；新增：营地场景图十层铺底与门洞留空呈现 |
| V10 美术约束 | `tools/shot_checker.py` camp 取样面；`ui_contrast_probe.gd` 令牌核签；素材色板二器 | `ui_contrast_probe.gd:_ready`（营地令牌段）〔营地图批 V10〕＋`shot_checker.py` WCAG／明度三档带段 | 探针（机检） | camp 截图＋素材文件（`palette_check.py`／`standee_asset_check.py`） | 文字 WCAG ≥4.5:1／明度三档带／文字禁压纹理底／文字在判据；素材色板（48 令牌＋新增色双门／像素 32 色冻结）；§9 第 4 条拍板截屏计数面（条件步，§0.3－3⑤） | 既有：UI 全局主题与按钮五态（含对比度锚）；新增：营地场景图十层铺底与门洞留空呈现 |
| V11 目检项登记 | `reports/iter<N>-实现报告-<日期>.md` 实机目检总清单 | 件核对（07 清单登记，登记不阻塞）〔营地图批 V11〕 | 用户目检（非自动化） | 用户实机（生命周期末步统一进行，不阻塞迭代） | 场景观感／七物件辨识（纵深稿构图可辨）／点选反馈／大门两分支／篝火动线入 07 清单＝登记即义务了结 | 新增：营地场景图十层铺底与门洞留空呈现 |
| V12 探针迁移留痕核验 | F8 全量位点逐点迁移 | 件核对表（T6 追认单）〔营地图批 V12〕 | 件核对（非自动化） | 探针脚本 diff 对账 | F8 全量位点逐点有「改前→改后」记录（契约 10 留痕义务） | 既有：模态覆盖层编排与输入锁；新增：营地七物件命中区点选与分界面可达 |
| V13 反哺点清单 | §5 每条有落点 | 件核对表〔营地图批 V13〕 | 件核对（非自动化） | §5 同步面逐条对账 | §5 每条有 `reports/iter<N>-反哺点-<日期>.md` 落点 | 既有：模态覆盖层编排与输入锁 |
| V14 layout 数据件校验（2026-11-01 新增） | `camp_scene_layout.tres` 加载期 fail-fast 校验（schema 类＋表现域容器类型化成员，先例 battle_layout.tres） | 单元套件载入数据件断言（落点＝T5 新增断言段②）〔营地图批 V14〕 | 单元 | 单元套件载入 `camp_scene_layout.tres` | 校验函数通过＋七命中区两两不相交／不越画面／不侵 y≤48（契约 7 几何红线机检化） | 既有：模态覆盖层编排与输入锁；新增：营地场景图十层铺底与门洞留空呈现 |
| B1 组合根接线总改造（行为改动专行） | `main.gd`（断点弹窗移位＋三钮消费方编排＋营地入口改挂＋篝火动线＋开层互斥）；`confirm_dialog.gd` 三钮；`camp_shop_presenter.gd` 写口尾路由；`camp_flow_context.gd` 字段；`camp_refresh_bus.gd` 单口 | `ui_click_probe.gd:_ready`（断点确认段）＋`screen_flow_probe.gd:_ready`（篝火段）〔营地图批 B1〕 | 集成 | `_on_confirm_new_adventure()`／`_resume_from_menu()`／`_start_adventure()`／`CampRefreshBus.refresh()` | 三钮消费方编排：open 前设消费方、confirmed／cancelled 后分派；cancelled 绑写口零调用；写口尾绑 `CampRefreshBus.refresh()` 调用记录＋现开界面＋场景根 HUD 同刷；`on_camp_attune_toggle` 尾只 refresh_camp 保持原样 | 既有：断点片段往返与续玩幂等；新增：营地刷新单口与场景根 HUD 同步 |
| B2 CampOverlay 退役＋五界面抽出（行为改动专行） | `camp_overlay_view.gd` 退役；四界面 view 抽出；`career_overlay.gd` 入口改挂；`smoke_all.gd:6469-6475` 源码断言段 | `smoke_all.gd:_ready`（源码断言段重写）＋`forge_workbench_test.gd:_test_forge_rows`（承载类换）〔营地图批 B2〕 | 集成 | 五界面 `open()`／`close()` → 模态栈单口 | CampOverlay 无消费面即删（吸收即死，绑 `main.camp_overlay` 句柄迁移留痕）；四界面各带返回／关闭钮；拆分沿职责轴（契约 11：职责语句／单一变化原因／集体身份，禁凑计数袋） | 既有：元进度入账与锻造两轴；新增：四柜台拆解后五界面入口改挂与写口零回归 |
**落点集中**：V1／V9／V11／V12 → T5／T6；V2／V8 → T2／T3；V3／V7 → T4；V4／V5／V6 → T3；V10 → T5；V13 → T6；B1 → T3／T4；B2 → T3／T5。全表名实核对归 T6。
**落点集中**：V1／V9／V11／V12 → T5／T6；V2／V8 → T2／T3；V3／V7 → T4；V4／V5／V6 → T3；V10 → T5；V13 → T6；V14 → T2／T5；B1 → T3／T4；B2 → T3／T5。全表名实核对归 T6。
**测试方式两分法**：V1–V10、B1–B2 机检自动化（能力验证经调试接口直改断点／钥石／解锁状态，沿用 DebugOverlay／DS_DEBUG 门控，不走正常资源积累流程）；V11 归用户目检（生命周期末步统一进行，不阻塞迭代）；V12／V13 为件核对表（非自动化，T6 追认单）。**用户目检一律「登记不阻塞」**：登记完成即卡内义务了结，验收时间由用户自行安排，不得作为批末收尾、合并或下一迭代开工的前置条件。
@@ -409,7 +418,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- **L1（自救一次）**：断言写法、探针路径、命中区微调、命名、编译错误、签名拼写、测试套件 manifest 登记遗漏。
- **L2（记录继续；同一红连续三次升 L3）**：场景屏承载形态选择（§9 域内）、点选反馈参数（§0.3 P3 设计稿域内）、四界面承载形态（§9 域内）、图鉴占位文案称谓订正、行数较 T0 预期漂移但 S13 键不升。
- **L3（立即停卡写报告等用户）**：
- 代码段开工门未销号即需开工对应任务段（§0.3：P3 点选反馈设计稿／P5 GDD·art-bible 落文／camp-scene-prompts §5 五裁点／素材后处理入库）；
- §0.3 代码段开工门裁断实况反转（四项 2026-11-01 已裁断销号；开工时发现未销号实况＝停机呈报）；
- 规格清单（样张批）终档置换未按反哺点登记；
- golden 漂移越出预期面（若涉及既有棋盘／menu 基线）；
- 发现五界面任一功能／写口链路被意外触碰（契约 4 破）；
@@ -427,7 +436,7 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
1. 场景屏承载形态（camp_screen 屏壳改造 vs 新屏壳）——约束：`LAYER_CONTRACT` 更新＋探针挂载面迁移留痕。
2. 五界面拆出后的承载形态（独立全屏页 vs 单一内页切换）＋**叠层规则派生**（独立全屏页＝场景根隐藏／单一内页切换＝场景根留底；写入 V2 断言；「缩放虚化」禁自选）。
3. 七物件命中区实现（TextureRect 分区 vs 其他）与点选反馈参数（§0.3 P3 设计稿域内）。
4. 截屏级 48 色计数工具是否新建及落点（现役＝素材级二器 F17；截屏级依赖 §0.3 环境子板色值代码段开工门销号后定）。
4. 截屏级 48 色计数工具是否新建及落点（现役＝素材级二器 F17；**条件步**——§0.3－3⑤环境子板色值已按 T1 量化登记则拍板，未登记则本子步显式跳过＋T6 登记遗留）。
5. CampOverlay 类退役范围（整类删 vs 留片段）——约束：吸收即死，禁留死代码。
6. 提交切分与 worktree 分支命名。
@@ -444,4 +453,4 @@ req-card 第〇步＋卡头 2026-10-21 退回令口径＝美术设计闭合（
- **Q6 Q1 与规格清单缺口连带裁＝甲**（2026-10-18）：过渡尺寸档＝现役 1280 工程档（1280×800）＋烛光黄 #F6C667／木色 #8A5A34；渠道 B 已裁（2026-10-22），规格落 art-bible v3.24 §6.2／art-assets-checklist.md §3.5（2× 源档出图、最近邻降采样到 1280×800）；终档归样张批冻结清单后置换（反哺点登记），执行归用户线。
- **Q8 设计稿产出方式＝甲**（2026-10-18）：批内出稿呈裁（方向稿先行纪律照旧——方向稿选划已由 2026-10-31 样张过审裁定完成，各素材第一张样本稿为终稿、保留全部待选稿）。
**代码段 `/iter` 开工门（不是设计待裁点，不阻塞重立卡与编迭代）**，见 §0.3：P3 点选反馈设计稿、P5 GDD／art-bible 条款落文、camp-scene-prompts.md §5 五个待裁点（帐篷尺寸／门扇高宽／布告板位置／描边颜色追认／环境子板色值）、十张终稿后处理与落 `game/assets/art/scene/`（实现段 T1／`asset-ingest` 第 3 步，用户 2026-10-31 令只生成素材不做后续，开工时另发令）。编入哪一迭代归 iter-plan 段发令，本卡不代裁。
**代码段 `/iter` 开工门已全部裁断销号（2026-11-01 用户裁，照 grilling＋godot-master 双审推荐采纳）**：P3 销号口径＝camp.md v2.2 四态规格即设计稿；P5 销号口径＝形态落文完成、实装回填归反哺点；camp-scene-prompts §5 五裁点＝①帐篷 300×170 追认②门扇 240×220 追认③布告板 (845,268,130,140)④描边奶油色追认⑤环境子板色值不前置（T1 量化后按 art-bible §4.1 登记）；十张终稿后处理＝/iter 开工令即含授权。**本卡零待裁点、开工门清零——迭代 47 可开工。**