chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令）

- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例） - 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行） - 纯注释改动零行为变更，按用户令免测试免冒烟
2026-10-15 04:08:38 +08:00
1 parent d5eea25f9c
commit 5f9d8e7b77
@@ -2,8 +2,8 @@
 # 实现 GDD：design/ux/battle.md（D 区 AP 条 44px——点阵+数字〔pattern 5 点阵资源显示〕、
 # 停手按钮居左、图例+弃图刷新按钮居右〔雷图右上角〕；弃图刷新确认微交互与常规确认不同位
 # 〔pattern 7 破坏性确认异位：RAP 扣费 · 旧板旗作废显式代价〕）。
-# 2026-09-26 信息归属批：RAP 读数（点阵+数字）自 C 区迁入本条、置弃图刷新按钮左邻
-# （RAP 唯一消费口 = 弃图刷新——就近原则；RAP 清零反馈/资源拒绝脉冲载体随迁）。
+# RAP 读数（点阵+数字）在本条、置弃图刷新按钮左邻
+# （RAP 唯一消费口 = 弃图刷新——就近原则；RAP 清零反馈/资源拒绝脉冲载体同处）。
 # Date: 2026-09-12
 # 高内聚边界：纯视图——意图经信号外发（stop_pressed/refresh_confirmed/legend_toggled），
 # 状态由组合根经 setter 注入；刷新可用性预判 = RAP≥8 读数（行动经济 无推送信号——每次调用返回后重查）。
@@ -3,13 +3,8 @@
 # 实时流 / 点击展开回看 overlay〔pattern 6 模态纪律〕；行模板「{行为} {值} → {目标}（来源）」、
 # 聚合计数行、零值行可见、效果行 value≠pool_value 禁相加、未生效四类行 icon/划线形状冗余、
 # highlight 金框〔flag_hit/clear_reward_h2/perfect_broken〕、击杀标记）。
-# Date: 2026-09-12（基础 = 2026-09-11 13 类行协议格式化版；2026-09-15 格面资源批 15→10 类：
-# 删 item / consumed_ineffective / use_rejected / window_open / window_skip 五类——可选类道具与窗口下线，
-# 战斗结算 行协议清单同步；2026-09-16 护甲等级掷点批：伤害行补掷点读数/档位随行标注 + nat20 金框高亮；
-# 同日 敌人技能池批：施放行 = 蓄力行 charge 改型〔增益技 0 伤害施放、具名技能〕；
-# 2026-09-20 八型批呈现层漏网修复（真人试玩卡断）：伏击退役拆除伤害行 attach 字段后，
-# 基线+伏击与普通+穿刺+魔法三分量两拆行分支未同步拆除——敌方行（带 baseline 无 attach）
-# 格式化即 Invalid access，结算段中途夭折、界面卡死；两分支随批拆除，行上归因只剩掷点随行）
+# Date: 2026-09-12（行协议格式化版；现行 10 类；伤害行带掷点读数/档位随行标注 + nat20 金框高亮；
+# 施放行 = 蓄力行 charge 改型〔增益技 0 伤害施放、具名技能〕）
 # 高内聚边界：战斗结算 步骤流 → 玩家文案的全部格式化规则内聚于此；来源文案映射来自 SettlementTable。
 class_name BattleLogView
 extends PanelContainer
@@ -1,20 +1,18 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
 # 实现 GDD：design/ux/battle.md（B 区战斗画面 252px 全宽——主角站桩（左）+ 兑现演出区（中）+
-# 敌方站桩 ×1–3（右）〔2026-09-20 全站桩拍板——卡片式退役〕；顶部中央轮次·阶段指示；
+# 敌方站桩 ×1–3（右）；顶部中央轮次·阶段指示；
 # 底部结算明细带（布局决策 D1 常驻双舞台分屏））。
-# Date: 2026-09-12（2026-09-20 站桩改造批：HeroCardView/EnemyCardView 退役，StandeeView 换装；
-# setter 面契约保持——set_enemies/clear_enemies/on_step_row_fx/gray_all_enemies 签名不变）
-# 战斗舞台 Node2D 迁移批 Phase B 2026-09-26（循环 1 T2 壳 + T3 站桩迁入；ADR-0006 /
-# board-node2d-migration-plan §3）：根壳 PanelContainer → Control（类名/尺寸 252px/树内位置
-# 不变），内部两半区——「Node2D 舞台半区 = SubViewportContainer + SubViewport + StageWorld
-# （站桩本体 StandeeBody 世界精灵）」+「Control 文本半区 = round_label / stage_center /
-# log_view 三件原样保留（C1 永久 Control）」。SubViewport 逻辑分辨率 = 壳层像素 1:1（stretch，
-# 禁任何缩放系数——C2/C5）；字体显式注入挂点 set_world_font（C6，Phase A BoardView 同款）。
-# T3 批内代拍板默认（待追认）：①enemy_box 语义改写「站桩壳层伴随件容器」（HBoxContainer →
-# Control，子件 = 各站桩的 StatusSlotRow 伴随件，手动定位随世界同步——探针 :97 计数面不变）；
-# ②hero_standee/enemy 站桩 = StandeeBody（Node2D 世界本体，行为面契约逐项保持 C3），其
-# slot_row 成员 = 壳层伴随件引用；③定位同步 = 世界→壳层换算单点 world_to_shell，重建/重排
-# 挂点调用（零每帧成本，C4）。旧 StandeeView（Control）随迁退役删除。
+# Date: 2026-09-12（setter 面契约：set_enemies/clear_enemies/on_step_row_fx/gray_all_enemies
+# 签名稳定——探针与组合根零改造面）
+# 结构（ADR-0006 / board-node2d-migration-plan §3——B 区战斗舞台归 Node2D）：根壳 Control（类名/
+# 尺寸 252px/树内位置不变），内部两半区——「Node2D 舞台半区 = SubViewportContainer + SubViewport +
+# StageWorld（站桩本体 StandeeBody 世界精灵）」+「Control 文本半区 = round_label / stage_center /
+# log_view 三件」。SubViewport 逻辑分辨率 = 壳层像素 1:1（stretch，禁任何缩放系数——C2/C5）；
+# 字体显式注入挂点 set_world_font（C6，与 BoardView 同款）。
+# enemy_box = 站桩壳层伴随件容器（Control，子件 = 各站桩的 StatusSlotRow 伴随件，手动定位随世界
+# 同步——探针计数面不变）；hero/enemy 站桩 = StandeeBody（Node2D 世界本体，行为面契约逐项保持 C3），
+# 其 slot_row 成员 = 壳层伴随件引用；定位同步 = 世界→壳层换算单点 world_to_shell，重建/重排挂点
+# 调用（零每帧成本，C4）。
 # 高内聚边界：容器+组合视图——站桩槽位管理、轮次指示、结算行演出分发改由 setter 面承接；
 # 结算流水格式化归 BattleLogView，核心状态→文案装配归 hud_presenter.gd。
 class_name BattleStageView
@@ -1,10 +1,10 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 棋盘 Node2D 迁移批 Phase A 2026-09-23：CellUnit——BoardView SubViewport 世界内逐格渲染件（Node2D）。
-# 固定叠层序（ADR-0006 Decision 4）：砖面底 < 变异纹带 < 数字/徽章 < 旗 < 焦点高亮——本批全部程序化
-# _draw 等价平移现行占位视觉；每层留 texture 槽位（art-bible §8.2 格面 32×32 暂定档——终稿 1:1 换入，
-# 本批不实现纹理加载）。无 class_name（类名缓存面纪律——BoardView 经 preload 使用）。
+# CellUnit——BoardView SubViewport 世界内逐格渲染件（Node2D）。
+# 固定叠层序（ADR-0006 Decision 4）：砖面底 < 变异纹带 < 数字/徽章 < 旗 < 焦点高亮——全部程序化
+# _draw 占位视觉；每层留 texture 槽位（art-bible §8.2 格面 32×32 暂定档——终稿 1:1 换入，
+# 纹理加载未实现）。无 class_name（类名缓存面纪律——BoardView 经 preload 使用）。
 # 字体：font 槽位缺省 = ThemeDB.fallback_font（与旧 Button 缺省主题字体同源）；注入挂点归
-# BoardView.set_world_font（SubViewport 内主题不自动继承主场景，Phase B 复用面）。
+# BoardView.set_world_font（SubViewport 内主题不自动继承主场景，两舞台复用面）。
 # 行为等价（缺陷①回归约束）：格件常驻定长、逐格重绘由 BoardView 驱动，本类零游戏状态——渲染数据
 # 全部由 BoardView 每次 paint 写入（bg_sb/glyph/badge），呼吸微光由 BoardView 就地改 bg_sb 边框。
 extends Node2D
@@ -2,19 +2,18 @@
 # 实现 GDD：design/ux/battle.md（战斗屏 D 区 BoardView——格态/悬停预承诺光标/可挖域呼吸微光/
 # BFS 路径预览/奖励徽章/结算期去饱和锁输入）。
 # Date: 2026-09-12（battle.md 战斗屏改造批；基础 = 2026-09-11 HUD框架-lite 版）
-# 棋盘 Node2D 迁移批 Phase A 2026-09-23：渲染本体由「GridContainer + 逐格 Button」平移为
-# 「Control 壳 + SubViewportContainer + SubViewport + BoardWorld(Node2D) + CellUnit(Node2D)」
-# （ADR-0006 / docs/architecture/board-node2d-migration-plan.md §2）。对外契约逐项保持：
+# 棋盘渲染本体 = Control 壳 + SubViewportContainer + SubViewport + BoardWorld(Node2D) +
+# CellUnit(Node2D)（ADR-0006 / docs/architecture/board-node2d-migration-plan.md §2）。对外契约：
 # 类名/extends/三信号/click_cell/_cells 键面（Vector2i→格单元，值 Button→CellUnit）/
 # board()/set_desaturated()/set_identity_resolver()/set_variant_mask_resolver()/set_cell_area()/
 # rebuild()/refresh()/set_dig_glow_enabled()——探针与组合根零改造。
 # 命中 = 壳层 _gui_input + 板级公式单点换算（ADR-0006 Decision 3，_cell_at 为唯一公式函数；
 # SubViewportContainer 逻辑分辨率恒等于板像素尺寸（stretch 1:1，无缩放比），换算只需减居中偏移）。
-# 程序化占位视觉等价平移（数字三档/旗/徽章/危险红/变异遮蔽 "?"/呼吸微光/悬停/路径预览/R₀ 豁免）；
-# CellUnit 叠层 texture 槽位留好（本批不接纹理资产）。新增只读属性 cell_size（旧私有名 _cell 契约化出口）。
-# 棋盘小人贴图批 2026-09-25：英雄=BoardWorld 独立 Sprite2D（移动实体不进格面语义——计划书 §3.A；
-# refresh diff last_hero_pos 驱动位移 Tween+站/走两帧+flip_h 朝向；素材缺位回退格内字形「人」）；
-# 挖掘=挥铲三帧特效（BoardFxView）+角色弹跳 Tween；格面五 texture 槽零改动。
+# 程序化占位视觉：数字三档/旗/徽章/危险红/变异遮蔽 "?"/呼吸微光/悬停/路径预览/R₀ 豁免；
+# CellUnit 叠层 texture 槽位留好（纹理资产接 CellUnit）。只读属性 cell_size 为格尺寸契约出口。
+# 英雄 = BoardWorld 独立 Sprite2D（移动实体不进格面语义——计划书 §3.A；refresh diff last_hero_pos
+# 驱动位移 Tween+站/走两帧+flip_h 朝向；素材缺位回退格内字形「人」）；挖掘 = 挥铲三帧特效
+# （BoardFxView）+角色弹跳 Tween；格面五 texture 槽位固定。
 # 高内聚边界：只读 排雷玩法 查询面（+地图战斗资源 身份解析回调）做渲染与意图识别，动作经信号外发——不调用核心写接口
 # （settle_batch 归组合根编排），不持久持有战斗态（minesweeper 引用随 refresh 更新，仅作只读查询）。
 # 行为等价：格件常驻、逐格重绘在 refresh 内完成，无布局回流（缺陷①回归约束——CellUnit 定长不增删，
@@ -1,10 +1,10 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 棋盘 Node2D 迁移批 Phase A 2026-09-23：BoardWorld——棋盘 Node2D 世界根（SubViewport 内
+# BoardWorld——棋盘 Node2D 世界根（SubViewport 内
 # CellUnit 容器）。职责单点：世界级材质挂点（set_desaturated 去饱和挂此处，CellUnit
 # use_parent_material 链下随世界灰化）+ 主题/字体显式注入槽位（SubViewport 不自动继承主场景
-# Control 主题——ADR-0006 Negative 项；Phase B 两舞台共用骨架，ADR-0006 Decision 5）。
+# Control 主题——ADR-0006 Negative 项；两舞台共用骨架，ADR-0006 Decision 5）。
 # 无 class_name（类名缓存面纪律——BoardView 经 preload 使用）。
-# 立体原型批 2026-09-24（用户拍板「三档厚度实机对比」）：板块伪立体绘制——正俯视纸雕风，
+# 板块伪立体绘制（正俯视纸雕风）：
 # 顶面方格不变（数字可读性硬指标不受伤），厚度全部画在网格矩形外的正面/右侧悬崖带：
 # 正面（背光暗）+右侧（微受光）+列分隔缝（ITB 悬崖列感）+岩层横纹+底部悬浮影（厚档）+
 # 顶面接触 AO。零布局/命中改动（悬崖向网格外延展，世界尺寸由 BoardView._update_world_size 加 D）。
@@ -1,6 +1,5 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 实现 GDD：design/ux/battle.md（D 区扫雷图 ~760×548 容器〔底行 520→548——停点前移批 2026-09-23，
-# 原 A 区顶栏空间并入〕——顶部 AP 条 44px〔左：点阵+停手；
+# 实现 GDD：design/ux/battle.md（D 区扫雷图 ~760×548 容器〔底行 548——原 A 区顶栏空间并入〕——顶部 AP 条 44px〔左：点阵+停手；
 # 右：图例+弃图刷新〕、棋盘主体居中、toast 槽上缘内侧、演出层）。
 # Date: 2026-09-12
 # 高内聚边界：容器组合 + 信号转发——动作意图全部信号外发到组合根，零核心写调用。
@@ -1,15 +1,14 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-09-21（元进度实现批——营地覆盖层呈现；2026-10-12 迭代 21 T6 营地统一重排——
-# 四柜台并排〔2026-10-11 锻造工坊裁决会话 A② 裁〕：树淬炼柜台=树脊柱界面形态=主界面 /
-# 锻造工坊柜台〔钥匙门：forge_workshop 点亮前锁定态，点亮=工作间两区六路线行板——迭代 23 T6 实装〕/
+# Date: 2026-09-21（营地覆盖层呈现；营地统一重排——四柜台并排：树淬炼柜台=树脊柱界面形态=主界面 /
+# 锻造工坊柜台〔钥匙门：forge_workshop 点亮前锁定态，点亮=工作间两区六路线行板〕/
 # 秘宝匣柜台〔钥匙门：ks_workshop 点亮前锁定态，点亮=现工坊内容整体迁入——六行+同调装配段+Y 升级行〕/
-# 奖励格图鉴柜台常开独立位；宽度不足横向滚动条。旧属性锻造柜台退役〔攻防所有权切分——
-# 生命唯一入口=树脊柱、攻/AC 唯一入口=锻造工坊路线〕）。
-# 锁定态零副作用纪律（2026-10-11 用户令，延续）：锻造工坊工作间锁定态（钥匙未点亮）开/关零副作用
-# ——零写档、零报错、面板内无任何可交互购买路径（锁定行纯文案；点亮后交互面归 T6 行板意图信号）。
+# 奖励格图鉴柜台常开独立位；宽度不足横向滚动条；无属性锻造柜台
+# 〔生命唯一入口=树脊柱、攻/AC 唯一入口=锻造工坊路线〕）。
+# 锁定态零副作用纪律：锻造工坊工作间锁定态（钥匙未点亮）开/关零副作用
+# ——零写档、零报错、面板内无任何可交互购买路径（锁定行纯文案；点亮后交互面归行板意图信号）。
 # 信号面/投影契约：buy_requested(attr)〔现仅 Y 刷新升级行消费——装配段双入口之一 Q1 裁乙〕/closed、
 # attune_toggled/tree_buy_requested/tree_fork_toggled、forge_buy_requested/forge_unlock_requested/
-# forge_select_requested（迭代 23 T6——锻造三意图；写口唯一归 MetaProgression 锻造写口族）、
+# forge_select_requested（锻造三意图；写口唯一归 MetaProgression 锻造写口族）、
 # open_camp(data)/refresh_camp(data)。
 # 挂接方式：开合与开始层互斥仿设置面先例（开始覆盖层非模态且树序在后——打开本层前由组合根
 # 隐藏开始层，规范 2.3 遮挡纪律）。
@@ -1,13 +1,11 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 生涯覆盖层·只读全屏页（迭代 18 卡④ 生涯界面实装批·期一 2026-10-07——需求卡片 v1.2 裁点全甲；
-# 设计权威 design/gdd/systems/跨局循环/生涯.md v0.1 期一范围）。
-# 裁决落形：P1/P2 甲=汇总段两类六项（冒险总局数/通关局数/各关通关次数/Boss 首杀/Boss 总击杀/
-# 钥石余额——逐行只读；原「三柜台解锁完成度概览」三投影〔属性锻造/道具工坊/天赋树〕整行删
-# ——2026-10-12 用户裁：生涯页不统计天赋树与账号成长态，只统计终身计数）；P3 甲=登记 modal_stack
-# 营地同档（设置层旁、确认弹窗之前——登记序=树序=z 序，组合根 addChild 同位）；P4 甲=零跳转
+# 生涯覆盖层·只读全屏页（期一；设计权威 design/gdd/systems/跨局循环/生涯.md 期一范围）。
+# 呈现口径：汇总段两类六项（冒险总局数/通关局数/各关通关次数/Boss 首杀/Boss 总击杀/
+# 钥石余额——逐行只读；不统计天赋树与账号成长态，只统计终身计数）；登记 modal_stack
+# 营地同档（设置层旁、确认弹窗之前——登记序=树序=z 序，组合根 addChild 同位）；零跳转
 # （页内零「前往他处」入口，仅只读展示+关闭）+局内不放生涯入口（开始覆盖层「营地与系统」组唯一入口）。
 # 期二/期三内容（历史回看/图鉴/单局明细）零触碰——页内无任何期二占位件。
-# 只读契约（需求卡片契约 3/4）：数据快照由组合根 open_career 喂入（每次开层实时读 SaveManager
+# 只读契约：数据快照由组合根 open_career 喂入（每次开层实时读 SaveManager
 # 计数访问器 + MetaProgression 访问器重建——状态面板 R4 同构，快照仅单次开层生命周期，跨开层
 # 零持有）；本类零核心访问、零写通路——唯一信号 closed（关闭意图，组合根经模态栈单口收口）。
 # 零动效（状态面板 P4 甲先例同款）：直开直关，无 tween 无 AnimationPlayer。
@@ -1,10 +1,10 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-10-01（迭代 10 奖励重构批——level-clear.md v2 三选一选择面承载）
+# Date: 2026-10-01（三选一选择面承载）
 # 提升三选一覆盖层（模态）：非末关通关的选择停点呈现——部分回血反馈 + 三卡点选 + 确认兑付。
 # 高内聚边界：文案拼装归 Narrator（组合根喂入），选择意图经信号外发；视图零核心引用。
 # 交互范式 = node_overlay choice_box 按钮族 + 选路两段式（点选→确认）复用，零新原语。
-# 状态机：pick（三卡点选→确认）→ result（兑付反馈→继续）。〔replace 满位替换子态随迭代 22 T5
-# 拆除——装配不可变契约 1（冒险中零更换途径），core 写口与组合根接线同批摘除。〕
+# 状态机：pick（三卡点选→确认）→ result（兑付反馈→继续）。无 replace 子态——
+# 装配不可变契约 1（冒险中零更换途径）。
 class_name CurioPickOverlay
 extends Control

@@ -1,14 +1,13 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-10-04（迭代 14.5 调试整合批——主菜单三散件（随机种子/角色数值调整板/两层调试入口）收一张调试浮窗，
-# 原 views/tune_panel.gd 整体吸收退役）
-# 开发调试浮窗：全局可开（迭代 18 卡⑦——DS_DEBUG=1 会话启动即开〔组合根 _ready〕+战斗屏 HUD/关卡地图屏
-# 两枚角标再开〔P2 甲，17卡③状态角标同形制〕；遮挡语义=ModalStack 登记制：他模态开时暂隐、关后自动恢复；
-# 旧「仅开始菜单可开」门随入口迁宿主退役）。当局数据只读区块=本局种子唯一查看位（T3，P4 甲六项）。
+# Date: 2026-10-04（主菜单调试三散件（随机种子/角色数值调整板/两层调试入口）收一张调试浮窗）
+# 开发调试浮窗：全局可开（DS_DEBUG=1 会话启动即开〔组合根 _ready〕+战斗屏 HUD/关卡地图屏
+# 两枚角标再开；遮挡语义=ModalStack 登记制：他模态开时暂隐、关后自动恢复）。
+# 当局数据只读区块=本局种子唯一查看位（六项）。
 # 列表页形态可扩展：后续调试项按区块往下追加，超高滚动。
 # 纯视图边界（规范 1.3）：数值应用/批量模拟/对局启动全部经信号外发由组合根承接
 #（apply_requested / simulate_requested / debug_levels_requested / closed）；
 # 当局数据经 update_run_data setter 喂入（只读投影零回读）；模拟进度与报告经 setter 注入——
-# 零核心写、不拼报告文案（装配归 HudPresenter）。零动效（零 tween/AnimationPlayer——17卡③契约）。
+# 零核心写、不拼报告文案（装配归 HudPresenter）。零动效（零 tween/AnimationPlayer）。
 # 探针接缝（ADR-0004"合成输入走真实翻译出口"口径）：press_apply_for_probe 等三键 = 按钮真实信号路径。
 class_name DebugOverlay
 extends Control
@@ -1,10 +1,10 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 实现 GDD：design/ux/battle.md（C 区角色信息 240×548——2026-09-26 信息归属拍板精简：
+# 实现 GDD：design/ux/battle.md（C 区角色信息 240×548：
 # 攻击(+修正来源角标)/护甲 AC 数据框 + 秘宝槽（预留）+ 特性列表（预留）。
 # HP 条/立绘占位/状态效果槽/RAP 池/GP/钥石退役——HP 与状态唯一展示面 = B 区站桩（同一数据
 # hud_presenter 双投喂 B/C 两区的重复展示）；RAP 迁 D 区 AP 条（贴弃图刷新消费口）；
 # GP（中循环）/钥石（大循环）迁出战斗屏）。
-# Date: 2026-09-12（2026-09-26 C 区精简批重写）
+# Date: 2026-09-12
 # 高内聚边界：纯视图 setter 面——装配（含修正文案/AC 投喂）归 hud_presenter.gd；定长槽 + clip_contents
 # （缺陷①回归约束）。
 class_name HeroInfoPanelView
@@ -1,21 +1,17 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-09-17（分支节点图批——关卡节点地图 v1.0 图版选路呈现）
-# 2026-09-28 关卡画面实装批（M-1 迭代 1 T4——level-map.md 三拍板落地）：
-#   ① 三停点标题定稿（布局决策 1——清偿台账 143：「继续前进（战斗房）」入口措辞矛盾退役）
-#   ② 图上点击选路唯一通道（布局决策 2）——候选按钮整列退役；候选节点亮金描边 = 可点目标，
-#      悬停预承诺（描边加粗+指针）后点击提交；press_candidate 探针入口改走图上命中同路径
-#   ③ 放弃冒险二次确认（布局决策 3）——首击转确认态（文案+危险红脉冲约 3 秒超时回落），二击提交
-#   ④ 顶栏语境：关卡名（level_row.display_name）+ GP 常驻徽章（2026-09-26 二轮拍板去向落地面）
-#   ⑤ 底部状态栏（布局决策 4）：生命/属性/特性三组常读（零加成隐藏），放弃按钮右端异位
-# 关卡画面（独立屏，Level Map Screen——2026-09-28 形态升格批 M-2 迭代 3 T2：原 RouteOverlay 模态
-# 覆盖层升格独立屏，spec level-map.md 形态章节同批改写）：全屏不透明独占呈现——激活期战斗屏宿主
+# Date: 2026-09-17（关卡节点地图 v1.0 图版选路呈现）
+# 布局决策（level-map.md）：① 三停点标题定稿 ② 图上点击选路唯一通道——候选节点亮金描边 = 可点目标，
+#    悬停预承诺（描边加粗+指针）后点击提交；press_candidate 探针入口走图上命中同路径
+# ③ 放弃冒险二次确认——首击转确认态（文案+危险红脉冲约 3 秒超时回落），二击提交
+# ④ 顶栏语境：关卡名（level_row.display_name）+ GP 常驻徽章
+# ⑤ 底部状态栏：生命/属性/特性三组常读（零加成隐藏），放弃按钮右端异位
+# 关卡画面 = 独立屏（Level Map Screen）：全屏不透明独占呈现——激活期战斗屏宿主
 # 由组合根整体隐藏（非暗幕半透、零透出）。零自动推进的玩家停点语义不变：唯一前进通道 =
 # 图上点候选节点 → route_chosen(node_id) → 组合根转 runner.pick_next_node。
 # 高内聚边界：只读 runner 成文出口（nodes()/visited_ids()/node_index/next_candidate_ids()/level_row/
 # hero_hp/gp/effective_*/bonus）做渲染，无任何写面；图形为程序化占位质量（占位纪律）。
-# 放弃入口（2026-09-21 用户拍板「放弃接口也要有」——台账 119）：选路停点 = 天然非战斗期（接口契约：
-# 战斗中放弃一律拒绝），按钮常驻底栏右端；可见性归组合根（只在冒险模式开——放弃的语义对象是
-# "整局冒险"；调试两层无节点图天然不可达）。
+# 放弃入口：选路停点 = 天然非战斗期（接口契约：战斗中放弃一律拒绝），按钮常驻底栏右端；
+# 可见性归组合根（只在冒险模式开——放弃的语义对象是"整局冒险"；调试两层无节点图天然不可达）。
 class_name LevelMapScreen
 extends Control

@@ -1,8 +1,8 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-09-29（迭代 8 卡④ 最小设置面）
+# Date: 2026-09-29（最小设置面）
 # 设置覆盖层（纯视图边界规范 1.3 同款）：音量滑杆/全屏/减动效三件+返回（退出游戏已提级开始菜单）。
 # 生效与持久化全经 SettingsStore 单点（实时应用+即改即存）；本类零核心触碰。
-# 减动效转正承载（测试调整板旧开关退役——设置面唯一入口，卡④ AC③）。
+# 减动效开关 = 设置面唯一入口（旧测试调整板开关已移除）。
 # 探针接缝：retarget(store) = 隔离存档换注口（同 camp 换注先例）；控件引用公有只读供断言。
 class_name SettingsOverlay
 extends Control
@@ -1,11 +1,11 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 战斗舞台 Node2D 迁移批 Phase B 2026-09-26（循环 1 T2/T3）：StageWorld——B 区战斗舞台 Node2D
+# StageWorld——B 区战斗舞台 Node2D
 # 世界根（SubViewport 内站桩本体容器）。ADR-0006 分工：Node2D = D 区棋盘 + B 区战斗舞台；
-# 与 BoardWorld（Phase A）同构。职责单点：主题/字体显式注入槽位（SubViewport 不自动继承主场景
+# 与 BoardWorld 同构。职责单点：主题/字体显式注入槽位（SubViewport 不自动继承主场景
 # Control 主题——ADR-0003 Decision 4；set_world_font 同款挂点，null = ThemeDB.fallback_font 与
-# 旧 Label 缺省主题同源）+ 站桩本体装载面（T3 迁入）。无 class_name（类名缓存面纪律——
+# 旧 Label 缺省主题同源）+ 站桩本体装载面。无 class_name（类名缓存面纪律——
 # BattleStageView 经 preload 使用）。
-# 坐标空间钉死（台账 160 纪律延伸）：世界内 = 局部排布坐标（SubViewport 逻辑分辨率 =
+# 坐标空间钉死：世界内 = 局部排布坐标（SubViewport 逻辑分辨率 =
 # 壳层像素 1:1，无缩放系数——C2/C5）；壳层/fx 层 = 全局含容器偏移，换算单点在
 # BattleStageView.world_to_shell()。
 extends Node2D
@@ -1,15 +1,14 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 实现 GDD：design/ux/battle.md（B 区全站桩形态——2026-09-20 用户看对照样张拍板，台账 99：
-# 主角与敌人均为无框立绘+底座，英雄卡/敌人卡卡片式整体退役禁再提）。
-# 战斗舞台 Node2D 迁移批 Phase B 2026-09-26（循环 1 T3）：站桩本体自 Control（旧 StandeeView，
-# 退役删除）平移为 Node2D 世界精灵（ADR-0006：B 区战斗舞台归 Node2D）。行为面契约逐项保持：
+# 实现 GDD：design/ux/battle.md（B 区全站桩形态——主角与敌人均为无框立绘+底座，
+# 英雄卡/敌人卡卡片式整体退役禁再提）。
+# 站桩本体 = Node2D 世界精灵（ADR-0006：B 区战斗舞台归 Node2D）。行为面契约逐项保持：
 # set_data/set_hero/_set_hp/set_idle/set_effects/set_effects_cleared_feedback/set_order/set_pending/
 # _play_intent_motion/set_portrait_texture(tex,flip)/mark_dead/is_dead/flash_hit/_revive/
 # _update_name_line/_refresh_portrait_glyph（调用点 hud_presenter/main/探针零改造目标——C3）。
-# 等价平移基线 = 旧 Control 占位表现（C9）：立绘贴图（flip/NEAREST/整数 2× 档）+ 底座 + 血条
+# 表现基线（C9）：立绘贴图（flip/NEAREST/整数 2× 档）+ 底座 + 血条
 # （直角递减 tween）+ 顺位徽标 + 意图徽标（弹入+立绘前倾一次性动画）+ 名字行（纯名+护甲类型
-# 图标——2026-09-26 终裁 AC 不展示）+ 受击闪白 + 死亡灰化摇摆塌陷（禁瞬消）+ 复活 + 字形占位
-# 回退（人/▂/▆/█/✕/敌）。批内代拍板默认（待追认）：①状态图标行（slot_row）与悬停 tooltip 保留
+# 图标——AC 不展示）+ 受击闪白 + 死亡灰化摇摆塌陷（禁瞬消）+ 复活 + 字形占位
+# 回退（人/▂/▆/█/✕/敌）。代拍板默认：①状态图标行（slot_row）与悬停 tooltip 保留
 # Control 载体挂壳层（tooltip 机制零返工）——本体的 slot_row 成员 = 壳层伴随件引用；
 # ②状态行隐藏时序 = 随 mark_dead 同拍隐藏；③清空反馈微文案挂伴随件父层（壳层）。
 # 文字全部经 draw_string + 世界字体（world.world_font 或 ThemeDB.fallback_font——C6 挂点链）。
@@ -1,11 +1,9 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 局内状态面板·只读（迭代 17 卡③ 状态面板只读入口批 2026-10-06——需求卡片 v1.1；事实源=06-待办清单
-# 「解锁界面与钥石呈现的交互形态（残余：状态面板只读入口）」）。
-# 裁决落形：P1 丁=入口为战斗屏 HUD / 关卡地图屏常驻角标（入口装配在 ui_assembler/两屏，本类不含入口）；
-# P2 甲=登记 modal_stack 设置层同档（确认弹窗之前）带 dim 遮罩；P3 甲=展示钥石余额+进度概览
-# （道具工坊六件解锁态 / 天赋树已购概览——层内行序与分组复用营地屏同序；属性锻造三行段随
-# 迭代 21 柜台退役连带删除——数据源 forge_levels 域已清退）；P4 甲=进出零动效直开直关
-# （无 tween 无 AnimationPlayer——R5）。
+# 局内状态面板·只读。
+# 呈现口径：入口为战斗屏 HUD / 关卡地图屏常驻角标（入口装配在 ui_assembler/两屏，本类不含入口）；
+# 登记 modal_stack 设置层同档（确认弹窗之前）带 dim 遮罩；展示钥石余额+进度概览
+# （道具工坊六件解锁态 / 天赋树已购概览——层内行序与分组复用营地屏同序；无属性锻造段）；
+# 进出零动效直开直关（无 tween 无 AnimationPlayer——R5）。
 # 只读契约：R4 数据只读同源——账面快照由组合根 open_status 喂入（每次开层实时读 MetaProgression
 # 访问器重建，快照仅用单次开层生命周期，跨开层零持有）；本类零核心访问、零写通路——唯一信号
 # closed（关闭意图，组合根经模态栈单口收口）。R1 公共件单点：全部构成件经 UiKit 工厂产出
@@ -2,8 +2,8 @@
 # 实现 GDD：design/ux/battle.md（C 区状态效果槽 ×4〔增益状态 D1×①〕——effect_id→定稿 PNG 纹理图标、
 # 层数角标、剩余结算次数点、悬停 tooltip（来源+语义+剩余）；空态 = 槽隐藏（数据框上移补位，
 # EC12 空态裁决）；极性映射 = 战斗结算 SettlementTable 效果语义而非 magnitude 符号〔增益状态 D1×③〕）。
-# 2026-09-24 状态图标接入批：程序化占位字形（▲◇▼◎⚔✕☾⇧▣）+ 按极性染色退役——定稿九枚 PNG
-# （白剑/白盾/白眼+绿↑红↓箭头语言，用户逐键验收，圣经 §4.6.1 v2.2 纹样系统）自带极性，裸图标呈现。
+# 图标 = 定稿九枚 PNG
+# （白剑/白盾/白眼+绿↑红↓箭头语言，圣经 §4.6.1 纹样系统）自带极性，裸图标呈现；无程序化占位字形。
 # Date: 2026-09-12
 # 高内聚边界：纯视图——效果投影装配归 hud_presenter.gd；增益状态 纯被动容器零信号——刷新绑 战斗结算
 # 结算编排完成时点（battle.md 更新触发注记）。