设计闭合(零豁免五键+补件批): architecture v1.25落文——S13三条豁免注销(main/battle_orchestrator/tune_sim),七新件登记行(ui_registry/board_hover/RoundCycle/BattleFacts/cell两层域件/standee两件/breakpoint_store),轴丁两件设计闭合,attune改判,gdstyle inner-class计数截断缺陷登记;用户再裁恢复D2/D4拆件并按D5留债写入尾波条目(批末豁免登记步骤不执行);新卡《gdstyle尾波补件批》v1.0(零待裁点,估时2.5-3.5天,待iter42合回编入);待办清单新增补件批与零豁免五键两条目;roadmap迭代42状态按用户口述订正为进行中

reports/需求卡片-gdstyle尾波补件批-2026-10-29.md

@@ -0,0 +1,134 @@
+# 需求卡片——gdstyle 尾波补件批
+
+> **版本状态**：v1.0 定稿——零待裁点（2026-10-29 用户裁：恢复尾波卡 v2.0 裁去的 D2/D4 两拆件项；D5 五降值键＝留债、零豁免延伸）。
+> **接收方**：待办清单条目「gdstyle 尾波补件批——悬停域与断点域拆件（2026-10-29 登记）」。
+> **来源**：尾波清偿批设计闭合后的用户再裁（D2/D4 改判拆件）。**唯一事实源**：`design/engineering/architecture/architecture.md` v1.25（「模块归属·呈现层」表 board_hover 行、「核心层」表 breakpoint_store 行、「冒险域拆分」节断点随动句、「呈现层装配」节屏成员寻址句）。
+
+## 1. 目标与完成定义
+
+这批做什么：把尾波卡 v2.0 裁去的两个拆件项恢复执行——board_view 悬停域拆出 board_hover、adventure_runner 断点域拆出 breakpoint_store。三个 gdstyle 键随之降值（board_view 类变量 32→约30、adventure_runner 类变量 28→约22；board_view 公开方法 27 持平——全为契约面）。
+
+什么状态算完：
+
+1. 两新件在库、宿主成员迁出、键账达第 3 节预期（降值口径，不承诺清零）。
+2. 行为零变化：同种子下事件流、断点快照、棋盘渲染逐位一致。
+3. 批末代码域闸全绿；三键终值按留债口径记入实现报告（禁落 architecture 豁免登记）。
+
+## 2. 设计事实源
+
+architecture.md v1.25 三处在册设计（2026-10-29 零豁免裁设计闭合）：board_hover 行（职责语句「悬停预承诺呈现域」、拟收 11 函数族＋2 成员、耦合边界）、breakpoint_store 行（职责语句「存档断点组装与回放唯一承载」、拟收 6 成员＋函数族、27 键冻结）、「冒险域拆分」节随动句（拼盘与读侧策略机组拆出、应用层落盘口不变）。
+
+## 3. 现状事实（2026-10-29 实查；行号为迭代 42 合回前基线——T0 必须按当轮 master 重测重锚，board_view 的 `_paint_cell` 届时已由迭代 42 拆为五段、行号必漂移）
+
+- board_view.gd：悬停域成员 `_hover`（:70）、`_last_click`（:71）；函数族 11 个＝`_hover_at`（:442）、`_on_shell_mouse_exited`（:453）、`_detect_chord`（:475）、`_on_cell_hover`（:486）、`_on_cell_unhover`（:491）、`_refresh_hover_after_paint`（:497）、`_apply_hover_visuals`（:503）、`_clear_hover_visuals`（:531）、`_set_cursor_shape`（:538）、`_show_path_preview`（:542）、`_hide_path_preview`（:552）。`_r0`（:72）是出生展开区资格域成员（:238/:296/:563 三消费方），**不随迁**——划入悬停件即凑计数袋。
+- adventure_runner.gd：断点域成员 6 个＝`_save_manager`（:35）、`_resume_bp`（:36）、`_pending_next_level`（:30）、`_last_level_payload`（:31）、`_last_treasure_cleared`（:32）、`_loadout_seeded`（:37）；常量 `BREAKPOINT_FIELDS`（:539-568，27 键）；函数族＝`_snapshot_breakpoint`（:571）、`_bp_parts`（:583）、`_bp_read`（:636）、`_bp_strategy`（:646）、`_bp_read_int`（:651）、`_resume_ledger`（:182）、`_resume_curio_state`（:193）、`_resume_params`（:218）、`_resume_counters`（:237）；公开入口 `resume_adventure`（:94）留宿主薄壳。
+- 测试触面：`game/tests/unit/core/breakpoint_resume_test.gd:185` 直读 `AdventureRunnerScript.BREAKPOINT_FIELDS`——随件迁改址（判据零变化）。
+- 键账：board_view 类变量 32（键留债目标约 30）、公开方法 27（持平——27 个逐类核对全为探针契约面与依赖单向纪律承载面）；adventure_runner 类变量 28（留债目标约 22）。
+
+## 4. 设计契约（违反即返工的红线条款）
+
+- 🔴 **行为零变化**：同种子下事件流/断点快照/存档往返/棋盘渲染逐位一致；玩家可见面零变化。
+- 🔴 **断点键集冻结**：`BREAKPOINT_FIELDS` 27 键逐键冻结（键名、策略标签、键序零变化）；随件迁移只换承载文件，不换键面。
+- 🔴 **RNG 零触碰**：本批零新流、零消费序变化（断点回放 restore 同序取号；悬停域无随机）。
+- 🔴 **呈现零变化**：悬停反馈三语义（光标/边框/路径预览）行为逐点保持；棋盘 golden 三张对拍差异非零即红。
+- 🔴 **拆分边界纪律**（判据权威＝code-conventions §1.1，卡内执行条款）：①拆出单元须有职责语句与单一变化原因（实现报告逐件一行）；②集体身份——命不出名字的打包＝凑计数袋，禁；③「过阈值」只作发现信号；④拆不出内聚单元→停卡呈报；⑤禁沿阈值轴拆。
+- 🔴 **禁为机检文本保留无效成员**：禁止为迎合机检消息文本保留或新增无效成员/别名；机检键与卡片契约互斥＝停卡呈报。
+- 🔴 **残留键留债（D5 零豁免裁）**：三键降值后留基线冻结禁恶化；**禁落 architecture 豁免登记**；禁为凑阈值硬拆。
+
+## 5. 范围边界
+
+做什么：第 3 节两拆件项（board_hover、breakpoint_store）。
+
+不做什么：迭代 42 在飞范围零触碰（_paint_cell 拆五段、循环内 new、_enter_node、商店委托壳——并排卡承接）；单格/站桩状态件（呈现层状态件批承接）；main.gd/battle_orchestrator/tune_sim 五键（零豁免五键各批承接）；三残留键的终局清偿（留债，后续窗口再议）。
+
+## 6. 关联文档同步面
+
+| 文档 | 关联点 | 同步义务 |
+|---|---|---|
+| design/engineering/architecture/architecture.md | 两新件登记行（建件后「实现批建件」改现状）；「冒险域拆分」节随动句核对 | 设计权威文档——实现批禁直改；逐条列进 `reports/iter<N>-反哺点-<日期>.md`，用户裁决后归文档批落文 |
+| game/tests/README.md | 「棋盘悬停反馈」行代表用例列（本批复用既有探针、零新增断言——预计零改动）；断点行入口句核对 | 机械面文档——实现批禁写；如需更新由写卡段后续卡修订版同批处理 |
+| design/gdd/systems/ | 无关联文档——结构整改不改游戏规则与玩家可见行为 | 无修订预期；契约句被触碰＝停卡呈报走反哺点通道 |
+
+## 7. 任务卡 T0..T3
+
+**T0 读数重锚与对账（0.25–0.5 工作日）**
+
+- [ ] 以当轮 master 重测 board_view/adventure_runner 三键实测值与第 3 节全部 file:line；漂移处就地改卡并记录；对不上即停卡呈报
+- [ ] 复核 11＋9 函数族现行键面（`tools/gdstyle_baseline.txt` 无其函数级键——逐字搬运零新键；实查确认）
+
+**T1 board_hover 拆件（0.75–1 工作日）**
+
+- [ ] 建 `game/presentation/views/board_hover.gd`（RefCounted；构造＝引用束注入：cells 容器引用、minesweeper 只读引用、diggable 集合引用＋壳层光标写入与 hover_forbidden 注入 Callable）
+- [ ] 悬停函数族 11 个＋成员 `_hover`/`_last_click` 迁出（函数体逐字搬运）；三入站口（`_gui_input`/`_on_cell_input`/`click_cell`）留宿主委托；`hover_probe()` 留宿主读件投影（返回语义零变化）；`_r0` 留宿主
+- [ ] 孤立验证：`tools/probe_gate.sh --click`＋`--full` 全绿；`tools/render_gate.sh` 棋盘 golden 三张差异 0.00%（非零即停机呈报）
+
+**T2 breakpoint_store 拆件（1–1.5 工作日）**
+
+- [ ] 建 `game/core/breakpoint_store.gd`（RefCounted；构造＝引用束注入：db、rng、主角账三件、curio/stop/bank/loadout 引用——防 max-parameters 新键）
+- [ ] 断点域 6 成员＋`BREAKPOINT_FIELDS`＋函数族 9 个迁出（逐字搬运）；`resume_adventure` 留宿主薄壳；`set_save_manager` 转发件
+- [ ] `breakpoint_resume_test.gd:185` 改址为 breakpoint_store 常量（判据零变化——第 14 节申报）
+- [ ] 孤立验证：`--script res://tests/run_all.gd -- --only=breakpoint_resume,save_rng_roundtrip,cross_system_flow` 全绿＋`python tools/run_smoke.py`
+
+**T3 键账对账与收口（0.5 工作日）**
+
+- [ ] 批末代码域闸全绿（`tools/run_all_gates.sh --code`）
+- [ ] 三键终值对账（board_view 约30/27、adventure_runner 约22）——留债口径记入实现报告
+- [ ] 产出物落位卡：实现报告与反哺点清单写齐方算收口
+
+合计估时约 2.5–3.5 工作日。编队注记：编入待迭代 42 合回；与呈现层状态件批同代时推荐其先行——board_view 的 u.st 写入面改型后，hover 拆件在新写入面上施工。
+
+## 8. 验证闸——改动—验收对照表
+
+域口径：本批改动全为 `game/` 下非 .md 行为载体——批末跑代码域闸；里程碑步（T 段）出口跑一次全套闸，波内修复只做出红最小单元的最窄确认，新增测试先行孤立验证再并入全套。总判据＝每行改动以「既有断言面全绿＋golden 零差异」证明零行为漂移；全量闸电池＝冒烟＋系统测试＋run_all 全量＋probe_gate --click --full＋render_gate＋static_scan（含 S13 对账）。
+
+| 行 | 需求点 | 改动（文件:行/行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
+|---|---|---|---|---|---|---|---|
+| V1 | 悬停域拆件 | board_hover.gd 新建；board_view.gd 函数族与 :70-71 成员迁出 | 复用 ui_input_probe 悬停三语义断言（case①到达/②禁入/③路径预览）＋ui_click_probe＋type_glow_shot_probe；新增断言零条 | 探针 | 合成 InputEventMouseMotion/MouseButton 经 `_gui_input` 入站口；`hover_probe()` 读面 | 探针可见性断言面（hover_probe 返回值、光标形状、格件 st 边框/点迹字段）＋golden 三张零差异 | 既有：棋盘悬停反馈（三语义光标／目标格边框／路径预览点迹） |
+| V2 | 断点域拆件 | breakpoint_store.gd 新建；adventure_runner 断点函数族与 6 成员迁出 | 复用 breakpoint_resume_test 全套＋save_rng_roundtrip_test＋cross_system_flow_test:_feats_breakpoint_roundtrip；新增断言零条；:185 改址（第 14 节申报） | 单元＋集成 | AdventureRunner.resume_adventure()／start_adventure() × SaveManagerCore 断点域 | 断点快照往返逐键断言面（27 键冻结——键名/策略/键序零变化） | 既有：断点片段往返与续玩幂等；既有：旧档迁移链与断点续玩零跳号（集成） |
+
+反向核对：diff 中每个行为改动均有行——本批申报行为改动为零（全部非行为改动＝结构整改，判据＝零漂移证明）。孤儿断言：无（零新增断言）。
+
+## 9. 异常分级
+
+- **L1 自救**：迁移函数编译错、探针调用面改址漏改——就地修复重跑最窄确认。
+- **L2 记录继续**：实测值与预期区间偏离但同档位——记入实现报告「实现决定记录」。
+- **L3 停机写报告等用户**：①拆分边界纪律④触发（含 `_r0` 归属认定被实现期证伪）；②机检预算互斥——新件实数超第 12 节预算或迁移函数现出超标键＝停卡退回写卡段；③golden 对拍差异非零；④S13 键恶化或基线外新键；⑤断言面被下游兜底吸收致判据绑不上。
+
+## 10. 代拍板白名单
+
+1. 迁移函数头注指址微调（词表与语义不动）。
+2. 新件私有 helper 命名微调（职责语义不变）。
+3. 断言失败消息尾缀〔补件 Vn〕分配与措辞。
+4. 改址机械改写（preload 顺序、空行排版）。
+
+## 11. 待裁点
+
+零待裁点，开工门=U0。（裁决记录：2026-10-29 用户裁——恢复 D2/D4 拆件；D5 五降值键留债、零豁免延伸；`_r0` 留宿主；断点域六成员全迁。）
+
+## 12. 落位与可复用性预检
+
+- **board_hover.gd（新增）**：复用面核查——悬停预承诺逻辑现行全在 board_view（11 函数族全仓无第二实现，无既有件可复用）；不能并入 TilePalette（瓦片装载）、HeroSprite（英雄演出）、CellUnit（格件绘制）——悬停预承诺与三者是不同变化原因。落点唯一：`game/presentation/views/` 新件，board_view `_init` 建为子件（HeroSprite 挂载先例）。调用路径：只被 board_view 持有与调用，输入经宿主入站口委托，禁反向持宿主引用（注入回调单向）。
+- **breakpoint_store.gd（新增）**：复用面核查——断点拼盘与读侧策略现行在 adventure_runner（`BREAKPOINT_FIELDS` 登记单源唯一）；不能并入 save_manager（存档 IO 原语与冒险断点语义是两个变化原因——SlotStore 拆分已立界）、不能并入 MetaStateStore（元进度数据件）。落点唯一：`game/core/` 新件。调用路径：只被 adventure_runner 调用；宿主经件组装快照后写盘，应用层落盘口不变。
+- **新增函数**：零——全部为既有函数体逐字搬运。零新增数据件、零新增常量表（`BREAKPOINT_FIELDS` 为迁移非新增）。
+
+## 13. 实现规范预算（gdstyle 默认阈值对账）
+
+| 新件 | 公开方法 ≤20 | 类变量 ≤15 | 迁移函数对账 |
+|---|---|---|---|
+| board_hover.gd | 预算 6（悬停驱动入口） | 预算 2（`_hover`/`_last_click`）＋引用束成员 | 11 函数现行均无超标键（基线无其函数级键）；`_apply_hover_visuals` 分支 5 |
+| breakpoint_store.gd | 预算 8（快照/回填/读侧入口族） | 预算 6（拟拆成员）＋引用束 | `_bp_parts` 现行 49 行/9 局部（:583-630 实测）均在默认阈值内；`_resume_*` 四函数无超标键 |
+
+存量触面一查：board_view 6 键与 adventure_runner 1 键 T0 读数写明「S13 键较登记值只降不升」预期；`_init` 一律引用束注入防 max-parameters 新键。
+
+## 14. 测试削弱申报
+
+1. `breakpoint_resume_test.gd:185`——`AdventureRunnerScript.BREAKPOINT_FIELDS` 直读随件迁改址为 breakpoint_store 常量；判据零变化，仅常量承载文件换代。
+2. 除此之外禁删断言、禁放宽阈值、禁缩小扫描面、禁把真实入口换成下层直调；未申报的削弱由独立验收审计判红。
+
+## 15. 独立验收审计
+
+合并前由未参与实现的会话或子代理执行；报告落 `reports/iter<N>-验收审计-<日期>.md`。审计至少做四件事：逐行核对第 8 节对照表（测试存在、真执行、尾缀可 grep、真实入口未绕过改动点）；抽查判据绑定面；检查测试削弱（对照第 14 节申报）；核对两行「非行为改动」判定的零漂移证明是否在当轮真实跑批中成立。未过不得合并。
+
+## 16. MC／数值与 RNG 零触碰声明
+
+本批零数值改动、零数据表改动、零 RNG 流词表改动——断点回放 restore 同序取号、悬停域无随机。MC 对拍不跑。