出口报告:暂停层只读入口批(迭代 17 卡③)
批次:功能性 UI 交互新增(纯呈现零数值改动=零 MC;核心层零改动)。
worktree:g-plan2-iter17-pause(分支 iter17-pause-20261006,基点 = master 44328b1)。
任务书:design/research/任务书-暂停层只读入口批-2026-10-05.md(v1.1 零待裁点,U0 已发;T0 基线回填已落任务书头注)。
本报告按「吸收即死」纪律属中间文档,寿命=迭代寿命;结论已同步写进 06 / roadmap / active.md。
执行备注:本批由两次会话接力完成——T0/T1 与组 B 大部系前任会话(因额度中断),断点续跑会话完成组 B 收尾(两处探针断言口径 L1 修正)与 T3-T5。
一、完成定义五条逐条判定(任务书 §1.2)
| # |
判定项 |
判定 |
依据 |
| 1 |
入口可达 |
✅ |
战斗屏 HUD 右下角+关卡地图屏顶栏各一枚「暂停」常驻角标(P1 丁);主菜单零角标(_sync_pause_entry 以 _level_active∧屏态门可见性);ui_input case⑯ 角标真点击开层绿、ui_click 两屏 case 绿 |
| 2 |
只读数据正确 |
✅ |
冒烟 _pause_overlay_projection 5 断言(余额徽/锻造三行/工坊六行/天赋树概览 == MetaProgression 访问器逐项);结构探针只读巡检=层子树游戏语义信号连接白名单外零连接,合法连接恰 2(关闭钮+关层外发);层内唯一控件=「继续」 |
| 3 |
公共件复用 |
✅ |
全部构成件经 UiKit 工厂(modal_shell/panel_skinned/label/button/keystone_badge)+现行色板 token;badge 工厂件 Q10 甲收编入 ui_kit 并同步迁营地钥石徽(观感零变化);零新素材零新色值零新字体;ui_contrast 12 对含钥石徽深墨/烛光黄新对 |
| 4 |
模态纪律 |
✅ |
PauseOverlay 登记进 main.gd 登记册设置层同档、确认弹窗之前(P2 甲);登记序=树序=z 序注记同步换代;带 dim 遮罩;开合走 _open_modal/_close_modal 单口;has_open_excluding 排除式开态查询(只读零副作用);ui_click 守卫 case 绿(他层开着=置灰+emit 兜底拒开) |
| 5 |
重闸全绿+人闸 |
✅(机检半)/⏳(人闸待用户) |
机检读数见 §三;实机目检清单=design/qa/iter17-pause-human-gate-checklist-2026-10-06.md(A-H 八节:双屏入口/守卫态/只读性数据正确/零动效与排播副作用观察/与设置面关系/代拍板追认/R4 口径披露/机检佐证),人闸=用户实机目检 |
二、任务卡完成态(T0-T5)
| 卡 |
状态 |
提交/落点 |
| T0 |
✅(前任) |
worktree 建立+基线回填任务书头注(冒烟 783/0·run_all 17 套·probe_gate 默认段绿·F1-F10 实核绿·迭代 15② 交集零命中);HEAD 时点=44328b1 |
| T1 |
✅(前任) |
c08a901(组 A:pause_overlay.gd 本体+badge 工厂件收编+营地钥石徽迁移+main.gd 接线)+ fc9eb1e(pause_overlay.gd.uid 边车随批) |
| T2 |
✅(续跑会话收尾) |
d44fdd5(组 B:两屏角标+has_open_excluding+守卫处理器与 _sync_pause_entry 单一同步点+四探针断言+冒烟投影断言+任务书 T0 注记随批)。前任中断于代码写完未跑闸态;续跑两处 L1 修正(见 §四)后全闸绿 |
| T3 |
✅(续跑会话) |
无代码改动,闸读数见 §三 |
| T4 |
✅(续跑会话) |
design/qa/iter17-pause-human-gate-checklist-2026-10-06.md |
| T5 |
✅(续跑会话) |
本报告+06 状态行+roadmap 卡③行+active.md 快照/台账 380 |
三、闸读数(T0 基线 → 批末)
| 闸 |
基线(T0) |
批末 |
判 |
| 冒烟(run_smoke 全量) |
783/0 |
788/0(+5=本批投影断言) |
✅ |
| run_all |
17 套全绿 |
17 套全绿(exit 0) |
✅ |
| ui_input_probe |
默认段绿 |
十七断言 PASS(+⑯暂停层输入锁:真点击开层/锁期零穿透/关后恢复无残留) |
✅ |
| ui_struct_probe |
默认段绿 |
全屏零红(+pause 结构断言+只读性契约+零动效契约) |
✅ |
| ui_contrast_probe |
默认段绿 |
12 对测点 PASS(+钥石徽深墨/烛光黄对,≥4.5:1) |
✅ |
| ui_click_probe |
轻闸三件外 |
done=true 问题=0(+战斗屏开合守卫 case+地图屏一次性 case) |
✅ |
| ui_layout_probe |
— |
exit 0(观察型布局树工具,无断言判语) |
✅ |
| doc 三闸 |
— |
doc_link_audit 绿 / doc_term_audit 绿 / gdd_lint 存量红(见 §五-2,本批零新增——06/07 两文件本分支零触碰) |
✅(零新增口径) |
| 熵增闸 |
— |
存量红(见 §五-1,主区同红佐证) |
移交披露 |
| MC |
— |
零跑(纯呈现零数值改动——两入口铁规) |
✅ |
四、L1 修正记录(T2 续跑首轮探针红两处,均为断言口径、非产品代码缺陷)
- ui_struct_probe 只读巡检:前任落码为「子树全控件 × get_signal_list() 全集」巡检——首跑把 Godot 容器系统对每控件自动建立的布局生命线连接(child_order_changed/item_rect_changed/visibility_changed/size_flags_changed/minimum/maximum_size_changed → 引擎内部脏标记方法)全数误判非法。修正=收敛为游戏语义信号名清单(pressed/button_down/button_up/toggled/text_changed/text_submitted/value_changed/item_selected/gui_input/focus_entered/focus_exited/closed 十二名)——这正是任务书 v1.1「巡检信号名清单 T2 落码时列全进探针」的本意;清单外任何新连接一律红须入册。
- ui_input_probe case⑯ 取格:原逻辑假设 case⑥ 后域内必余「无旗可挖格」——首跑实测踩中「域恰 2 枚」形态(flag_t 已插旗+dig_t 已揭开后域内零无旗格;旗不可拔=
flag_present 拒绝在册)。修正=case 挪至全 case 之尾(板面扰动零波及)+域空时前沿移位兜底(真实点击 move 扩大可挖域,复用探针既有 _pick_frontier 手法)。修正后一轮全绿,无复发。
五、存量问题移交(均非本批产生,主区 master 同态)
- 熵增闸红:
design/diagrams 子目录越界——00712d5(2026-10-05 GDD 系统架构总图批)落籍时新增 design/diagrams/(JSON+HTML 两件)但未同批修订 CLAUDE.md Project Layout 与 repo_structure_audit.py 白名单,属该批收尾漏步;主区现跑同红已实证。处置建议=用户拍板「diagrams 收编为合法类别」或「两件归位」,随下一文档批或直接小批办理;本批不代修(最小批面)。
- gdd_lint 存量红:06/07 两文件 R3 修订注记/删除线残留/R4 缺版本历史/R7 括号跨度超限——全为历史批次落文注记(本分支对两文件零 diff);doc 三闸「零新增」口径达成。
- registry 存档版本注记滞后 v4→v5——生涯批(台账 379)已登记移交,本批未触碰 registry,维持在册。
六、代拍板记录(白名单内决断,commit 留痕,目检可推翻——追认单见目检清单 F 节)
| # |
项 |
决断 |
出处 |
| 1 |
关闭钮文案 |
「继续」(紧凑 90 宽返回钮,设置面先例形制) |
T1 c08a901 |
| 2 |
层内行序 |
余额徽→属性锻造→道具工坊→天赋树(营地屏同序,MetaTable.FORGE_ATTRS 序) |
T1 c08a901 |
| 3 |
角标文案与落点 |
「暂停」;战斗屏=HUD 右下角(角距 16px,debug 角标同形制);地图屏=顶栏 GP 徽右侧 |
T2 d44fdd5 |
| 4 |
断言编号与 case 命名 |
ui_input case⑯;ui_struct 契约 ⑧只读⑨零动效;冒烟 _pause_overlay_projection |
T2 d44fdd5 |
| 5 |
只读巡检信号清单 |
十二名游戏语义信号(§四-1) |
T2 d44fdd5 |
七、提交哈希清单(worktree 内全部,含前任)
| 提交 |
内容 |
c08a901 |
T1:暂停层组 A(pause_overlay 本体+badge 工厂收编+营地钥石徽迁移+main 接线) |
fc9eb1e |
T1:pause_overlay.gd.uid 边车随批 |
d44fdd5 |
T2:暂停层组 B(两屏角标+守卫+四探针断言+冒烟投影断言+任务书 T0 注记) |
| (收口提交) |
T4+T5:目检清单+本报告+06 状态行+roadmap 卡③行+active.md |
八、遗留人闸项
- 实机目检(唯一硬人闸):
design/qa/iter17-pause-human-gate-checklist-2026-10-06.md A-H 八节,重点=双屏入口/守卫态/只读性/零动效/排播队列排空副作用确认项(D2——开层瞬间待播明细行瞬时入带,与「暂停」直觉之差,既有各弹层同款行为)。
- 存量移交三项(§五),均不阻塞本批。
- Esc 快捷通道=已在 06 键盘/手柄条登记(P1 丁裁点),随键盘批统一办理,本批不落码。
终态 = worktree 内全部提交,未合并、未 push(合并落回 master 由用户/编排会话执行)。