game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,553 Commits 23 Branches 0 Tags
bbd49abfb012102cb288fa4031fee6ed83d78da2
Commit Graph
35 Commits
Author SHA1 Message Date
DKChan 6b1e447d27 feat(调试入口): 全局浮层角标——UI 最顶层、任何 UI 不遮挡（2026-10-16 用户令） 
用户定稿：调试入口不做置顶钮式按需出现，要的是「UI 最顶层浮层、不被任何 UI 遮挡」。
实现=三枚屏内角标（菜单右下/战斗 HUD 右下/地图顶栏）合并为一枚全局浮层角标：

- LAYER_CONTRACT 末位新增 {"key": "debug_badge", "kind": "float"}——只落树序（最顶绘制序）、
  不注册 ModalStack：open() 遮挡记账只隐藏登记层，故任何模态/覆盖层开都不遮它（用户需求
  的机制根因）；_layer_node 补映射；main 直接子层、构建走 ui_assembler.build_debug_badge
- 位置：右下角 16px 惯例位；地图屏底栏 85px 常驻→_sync_status_entry 按 map_on 抬 offset
  至底栏上方 16px；战斗屏状态角标经 MarginContainer 让位（right 16/bottom 52）不再被压
- 屏内角标全退役：menu_screen/board_zone_view/level_map_screen 三处 debug_badge 删除，
  main 两处接线与 _sync_status_entry 四条可见性/置灰行清除（浮层常显不置灰——点它就是开浮窗）
- 浮窗 desc 文案改「UI 最顶层「调试」浮层角标随时可开——任何界面不遮挡」
- 断言/探针换代：smoke V2f 查 main.debug_badge boot 可见；click_probe 遮挡判据移至设置面
  开中段（浮层角标此时仍应可见=直接验「不遮挡」）；tune_probe ①点击路径与⑨对局中角标
  全改 main.debug_badge（T2 防线断言不动——浮窗 non_locking×遮挡复活×has_open 组合回归）

冒烟 1127/0 过；全量闸待跑。
 2026-10-16 23:53:57 +08:00
DKChan 9a72394652 chore(代码卫生): 头注存量清偿批——82 文件按两类白名单改写为 ## 文档注释载体 
按 code-conventions §1.4.1 第三轮定稿执行：core 22+schemas 18+presentation 根 14+views 28，全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述，保留职责摘要+真实使用约束（防事故禁令/单一入口/信号契约每信号一行）。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行（波一 core+schemas、波二 presentation+views，并发≤2）。验收=tools/verify_comment_only_change.py 逐字节校验（82 文件头注区外逐行一致=零行为变更）+audit_file_headers 全绿；纯注释批免冒烟（先例 5843270）
 2026-10-16 23:28:07 +08:00
DKChan d1b2e519ce feat(调试): DS_DEBUG 环境变量门控写死=true——用户令「直接写死，不读环境变量」（2026-10-16） 
- main.gd:219 原 OS.get_environment("DS_DEBUG")=="1" 读取退役，_debug_entry 恒 true
  （启动即开浮窗+两屏角标；var 注释与 6 处会话门控注释同步换代）
- 闸断言换代：smoke V2f 由「态==环境变量」改「恒开」断言；ui_click_probe 原
  「未设时浮窗不得默认开」反转为「未恒开即失守」；ui_tune_probe 删自设环境变量
  死代码（OS.set_environment 行）+三处消息/注释换代
- 其余 6 文件 10 处注释/文案清扫（ui_assembler/debug_overlay 含浮窗内用户可见
  工具提示/modal_stack/board_zone_view/level_map_screen/README）——全库 DS_DEBUG
  引用清零，无新旧并存
- 发布前删除事项：main.gd:219 一行（用户知悉；无 CI，两道恒开断言会红兜底）
 2026-10-16 03:08:31 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档） 
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
 2026-10-15 23:52:30 +08:00
DKChan 5f9d8e7b77 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
DKChan b605022001 feat(迭代27 T5): 波五a 类型闸拉起+存量收口——审计器 0 存量+warning 配置在位 
P1-6 类型闸（须 T1-T4 全落后——本波按执行顺序锁殿后）:
- tools/audit_type_hints.py 新机器闸（V7）: R1 无类型容器注解/R2 有值返回缺返回类型/
  R3 参数缺类型三规则+行级 # type-hint: ignore 显式白名单通道；产品码 core/data/presentation
- 存量收口: 368 处显式 Array/Dictionary 非参数化注解→机械参数化（Array[Variant]/
  Dictionary[Variant, Variant] 零行为面）；13 处参数真类型（SaveManagerCore/ConfigDb/
  BattleOrchestrator/MinesweeperRules/LevelRunner/SettingsStore 等）
- 白名单豁免四处: board_generator generate/_attempt/legality/_finalize 的 db 参——
  测量面 _BoardRowStub 冒烟夹具鸭子型注入（typed 参拒 stub）
- project.godot 拉起 gdscript/warnings/untyped_declaration=1（V7 源码断言在 smoke _smoke_type_gate）
- static_scan 新 S9 类型闸规则；顺修历史 cd 错位（9-24 布局迁移后 /.. 落 game/ 致守卫
  恒跳过静默空转——修复后 S1-S4/S9 首次实跑全绿）+S1/S2 增 ADR-0007-exempt 标记豁免通道
  （main _seed_value 引擎熵源=文档化豁免面）

验收: 冒烟 1081/0（+V7×2）+run_all 27 套+static_scan 全绿+probe click+render golden+对拍三变体全同
 2026-10-15 01:05:17 +08:00
DKChan 6fd7d782cc refactor(迭代27 T3): 波三 账本收口——RunLedger 单类持四账+刷新双账删副本+gp_final 键删影子账——逐位一致对拍全同 
P1-4 共享账本 Ledger 类化（裁点②甲 单类持四账）:
- game/core/run_ledger.gd: attune_charges/vision_counter/adventure_counters/bonus 四账
  单类承载；战斗侧只拿 read/append 原语（attune_charge_has/set/consume、vision_count_add、
  counters_seed_snapshot/merge_export、bonus_add_axis）——战末 export/开局 seed 时点语义不变
- AdventureRunner 持账（run_ledger）→ LevelRunner set_run_ledger+sync_attune_inventory
  （原四散 setter 收口）→ enc 单键 ledger 下传；编排器三裸引用成员退役为 _ledger 原语调用
- 调试/单场缺省新账=零扰动面（vision_counter 缺省空=不计，原 enc 缺键守卫语义保留）

P1-2 刷新双账收口:
- main 刷新计数副本（run_scope.refresh_used_round）删除；单一事实源=编排器受理计数
- presentation_snapshot 成文面升键 refresh_used（can_refresh 邻位）——HUD 余量/遥测
  round_refresh_index 单源读快照；V5 快照一致性断言×3（smoke+ui_click HUD 文本比对）

P1-3 GP 影子账收口:
- adventure_runner summary 增 gp_final 键（close_wallet 清账前快照）
- gp_shadow_ledger.gd 全件退役删除；main 委托缝/会话账本成员删除；终局面板 GP 行
  取数=summary 键；ui_probe 影子账断言换代为 summary 键断言

验收: 逐位一致对拍三变体全同；冒烟 1079/0+run_all 26 套+probe click+render golden 0.00%
 2026-10-14 23:25:45 +08:00
DKChan c5a09fd90c refactor(改名批): 暂停层/暂停角标→状态面板/状态角标——用户令全量改名(文案4处+标识符全套PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族+探针快照键+注释与探针消息86处清零;行为契约四件零动——只读R4/模态遮罩P2甲/输入锁R3/零动效P4甲)+render_gate截图键shot_pause→shot_status同步+文档六面(元进度v1.19/07/生涯/06条/architecture json+html;camp零命中;08-Alpha版本标准untracked禁碰留置)——冒烟938/0+run_all24套+probe --click/--full+render_gate全绿;rg 暂停|pause game/归零 2026-10-13 05:41:59 +08:00
DKChan 4688d09627 fix(presentation): 奇物呈现修复批——C 区/关卡页聚合行退役改逐件行「件名 ×N」+卡面摘族名（僵尸呈现整改，呈现改法=甲）+07/报告§五.5/battle.md/README/06 条收口移除+反哺点⑤销账+475 号状态记录 2026-10-12 08:04:16 +08:00
DKChan dd2c57c4cf ⑦T2: 输入锁死防护+P2甲角标迁宿主+T3当局数据只读区块（三件互锁一批落码）——modal_stack 增 has_open_excluding_any 多排除式查询（has_open_excluding 委托零语义变）；main.gd 输入锁/暂停角标置灰/暂停守卫判据全改排除式排除调试浮窗（审计🔴S1+防线：DS_DEBUG默认开×遮挡复活×has_open=棋盘锁死破局）+开冒险/续玩路径显式关浮窗+_show_debug_overlay 门禁改向对局中可开（C6 单口保持）+_start_debug_levels/_on_tune_simulate 对局中守卫（长程异步模拟与活跃结算并存态不开放）+DS_DEBUG=1 启动即开（P3甲）+当局数据六项只读投影 _debug_run_data/_current_master_seed 单点（:1174 诊断种子重算冒充病灶同批改向）+模态开合单口挂 _sync_debug_overlay；P2甲：战斗屏 HUD 角标对（HBox 并排锚角距16px）+地图屏顶栏调试角标（17卡③同形制 DS_DEBUG 门控）+开始层 dbgbtn 退役（ui_assembler 返回键集换代）；T3：debug_overlay 当局数据只读区块（种子/关卡/节点/HP/GP/钥石六项标签喂入制零信号连接零动效）+is_running 语义拆分（模拟在跑≠对局禁用）+set_context_locked 对局中两钮禁用+desc 文案换代；冒烟 811/0 2026-10-07 06:43:50 +08:00
DKChan d44fdd54c5 暂停层组B：两屏入口角标+has_open守卫+四探针断言+冒烟数据一致性（迭代17卡③T2） 
- modal_stack.gd 新增 has_open_excluding(skip)：排除式开态查询（地图屏系登记册模态成员=常态
  屏态，其上角标必须可点；只读查询零副作用，登记序/开合记账语义零改动）
- board_zone_view.gd 战斗屏 HUD 右下角+level_map_screen.gd 地图屏顶栏 GP 徽右——各一枚「暂停」
  角标（debug 角标同形制：UiKit.button 紧凑豁免宽度基准+FS_HINT 字号降档；可见性/置灰归组合根，
  信号连接归组合根 ADR-0001；非对局期显式不可见防菜单误现——P1 丁）
- main.gd 接线：两角标 pressed→_on_pause_badge_pressed（守卫兜底处理器：他层开着即拒开——
  常态防线=置灰，探针 emit 绕过 disabled 时由此兜住；地图屏开态经 has_open_excluding 不计自身）
  +_sync_pause_entry 单一同步点（可见性=_level_active∧屏态；置灰=has_open）挂模态开合单口与
  屏级互斥口/进局/离局/续玩五路径
- ui_struct_probe：pause 结构断言+只读性契约（游戏语义信号清单巡检——pressed/toggled/text/
  value/item/gui_input/focus/closed 十二名，白名单外零连接，合法连接恰 2=关闭钮+closed 外发）
  +零动效契约（子树零 AnimationPlayer+源码零 create_tween——R5/P4 甲）【首跑 L1 修正：全集
  巡检把 Godot 容器布局生命线连接（child_order_changed/item_rect_changed 等引擎自动脏标记）
  误判非法——收敛为信号名清单，任务书 v1.1「巡检信号名清单落码列全」本意】
- ui_input_probe case⑯：暂停层输入锁语义（角标真点击 press+release 开层→锁期挖掘零穿透→
  「继续」关层→同格挖掘重新到达；十七断言 PASS）【首跑 L1 修正：域恰 2 枚时 flag_t 带旗+dig_t
  揭开后零无旗格可取——case 挪全 case 之尾+前沿移位扩大可挖域兜底（板面扰动零波及）】
- ui_click_probe：战斗屏角标开合/守卫断言（图例开着=置灰+emit 兜底拒开）+地图屏角标一次性
  case（选路前开/关，地图屏选路态零扰动）；ui_contrast_probe 增钥石徽深墨/烛光黄对（12 对全绿）
- smoke_all._pause_overlay_projection：暂停层投影==MetaProgression 访问器逐项（余额徽/锻造三行/
  工坊六行解锁态/天赋树概览——隔离档 smoke_meta 复用，+5 check）
- 任务书回填 T0 基线注记（冒烟 783/0·run_all 17 套·交集核对零命中，HEAD=44328b1 时点）
- T2 闸读数：冒烟 788/0（基线 783/0，+5 本批）· ui_input 十七断言 PASS · ui_struct 全绿 ·
  ui_contrast 12 对 PASS · ui_click 问题=0 · ui_layout_probe 退出码 0；纯呈现零数值=零 MC
 2026-10-06 22:38:36 +08:00
DKChan 56e1ae3b45 fix: 判官复验四修——①styled_slider 槽轨实高（HSlider 槽=按 stylebox min 高绘制，零 margin=0-2px 不可见实测；12px 实高+深棕填充+描边）②三选一卡类型脚注行（demo .src 同位五族词——卡下半空底修）③地图顶栏对齐 demo（关卡名入框板+GP 烛光胶囊+左右两极，裸文本/居中悬置退役）④审计探针标题屏种子断点（有档态=继续上局主钮亮出对齐⑤；开始冒险前收种子避清档确认断流）——冒烟782/0+probe_gate --click全绿+ui_audit_probe 问题=0 2026-10-06 07:55:15 +08:00
DKChan 5e2fa8bb87 feat: 审计差距②③背景/形态三件（T5-T8）——T5 屏底氛围层单点（backdrop_tile 0.14/vignette/beams/地图渐变 #4A3B2A→#3A2E22@40%；start/map/camp 三面旧满铺石纹退役，地图换层 tint 保 0.14 档）+T6 商店全屏页壳（page_shell 56px 通栏顶条+爬价规则行 set_visit_info〔shop_bp_visit_buys×shop_price_a 投喂三口〕+底注池源；bcard D1=232×352+图标槽 76/60）+T7 三选一同壳全屏（GP 汇总行+底部确认钮+免费注记）+T8 设置两列对齐（label 定宽 140/why 内联/返回 90 紧凑；减动效行核证=reduced_motion 单设置同驱 motion_scale+结算演播，demo 两行系同一设置不拆）——冒烟782/0+probe_gate --click全绿 2026-10-06 07:15:49 +08:00
DKChan 58e8903a3c fix: 审计差距①④⑤⑦四件落地（底栏85定高+特性行限宽截断/结算两列账行+DIM_NIGHT压暗0.62/0.6+紧凑钮/标题屏主操作语义对齐demo/E5爆破带回滚magic族）+danger_button min_w参数化（放弃90宽）——轻闸冒烟782/0+probe_gate --click全绿；两探针适配两列账行（ui_probe _gp_val/ui_click_probe 名值拼串）；ui_audit_probe.gd.uid 侧车补提交 2026-10-06 06:56:14 +08:00
DKChan 1b2ecf6400 iter16ui T7：P6甲缩放纪律落码（状态九枚常规档24→32px=1×·mini16维持；柜台四枚64源20→32px=0.5×；BCard图标槽56→40px=2×；地图头像定高48宽随源比46×48纵横异倍消除；手绘十枚20/40双档消费点核查=全部1×无需动）+P10乙记忆态换装「地板纹理+灰罩α.66」（FOG_MEMORY_PLATE平涂退役；记忆墨对合成底6.71:1≥4.5实测复算）+art-bible §8.2显示档例外登记+§6.5记忆态条款换代双侧落文；轻闸冒烟782/0+三探针绿；board_shot系窗口化探针归T10人闸 2026-10-06 03:45:54 +08:00
DKChan e0fd7cb8d7 iter16ui T6：P3甲FS_*六档字号档位表立项（CAPTION12/HINT14/BODY16/SUB18/TITLE24/H1=34）+全库裸字号归档107位点（就近映射；4动态位点除外；settlement_fx两处span错位写入当场修复）+11px六处提FS_CAPTION并入P11豁免清单+art-bible §7.4档位表与豁免清单落文（条带内读数=血数一处；caption档逐处清单）；轻闸冒烟782/0+三探针+layout全绿 2026-10-06 03:38:51 +08:00
DKChan af5f317aea iter16ui T4a：N4a裸色全量收ui_kit（T0普查实数25处/10文件原值搬运——任务书N4a记5处系漏记）+N4c类型色五族TG_*立项（四族实机值+第五族TG_AOE #E25676 demo补族）+tg_band()同源分族判定（Q4甲三选一/货架同判；aoe/blast归AOE=reward.tres现成spark_aoe/clear_blast消费面；max_hp归回复族）+商店货架固定默认带改分族；探针白名单清零=呈现层裸Color8=0；轻闸冒烟782/0+三探针绿 2026-10-06 03:19:13 +08:00
DKChan 6812ebbb73 奇物批T3+T4：relic_*→feat_*词族全换（feat_table.gd/feats.tres/feats_engine.gd三文件改名+.uid+feat_flags/feat_id/feat_row等全token+config_db注册键feats两端+entities.yaml换代注记——kind值relic/身份前缀relic:/relics存档键/摘要键按数据契约保留）；T4渠道白名单过滤（_draw_curio_candidates(channel)：通关渠道只出专长/节点渠道零专长——过滤式不拆池，TIER_QUOTAS锚零改动，devour货架保底随渠道定位退役，迁移保feat_id，pick_curio测试feat_id透传；冒烟773/0+run_all 16全绿+断点往返PASS） 2026-10-05 19:28:20 +08:00
DKChan c571af226f merge: 奇物概念收口与词族对齐（迭代15②号卡·文档与数据层） 
概念层由用户逐轮裁定定稿（《奇物》v1.0→v2.7），本批只做落地对齐。

主要内容：
- 新建 design/gdd/systems/冒险循环/奇物.md v2.7（本概念唯一定义文档）
- 新建 design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md
  （loop engineering 八件成文 + 12 条批末验收断言 + 11 条设计契约含 6 条停机级）
- 代码词族对齐：feature_* → FEATURE_KINDS/feature_quota_*/feature_value_*
  （adventure_table.gd 24 字段 + 方法 + 常量，adventure.tres 21 键，值零变更）
- 三个 schema 补概念指路注释；relic_table.gd / adventure_table.gd 概念注释指向奇物.md
- ux/battle.md、level-map.md、HUD框架.md、06-待办清单.md、02-系统清单.md、
  registry/entities.yaml 同步称谓与元信息

六处冲突解法：
- 02-系统清单.md：版本历史整段重编（master v0.1-v1.3 原号复原，奇物系列从 v1.4 起）
- ux/battle.md：取分支侧新称谓，但「魔法道具槽」须写「秘宝槽」（master v1.3 已更名）
- adventure_table.gd：合成并集（取本批改名 + 保留 master SR-1 商店刷新三字段）
- level_map_screen.gd：块1 取 master M5 底栏结构，块2 取本批配色与称谓
- registry/entities.yaml：7 处三方混战，块1-5/7 取 master，块6 取本批
- roadmap.md：迭代 15 两卡并存（①调试 已落籍 / ②奇物 待开工）

合并后自查修正：
- 批量替换误伤 70 处（清图奖励/安全格奖励/关卡大奖励/奖励身份预读 等
  属地图战斗资源域；「奖励道具经济」旧文件名与「迭代 10 奖励重构」属历史留痕）→ 全部回退
- battle.md 历史修订行误改 → 恢复 master 原文
- 奇物.md 5 处死链（../ux/ 少一层、魔法道具.md 已更名）→ 修
- registry 条目 markdown 链接 → 改纯路径（同文件惯例）
- 奇物.md R1 散文段 656 字 → 拆段，现在零结构性告警

验证读数（合并后主区全量复跑）：
- 冒烟 755 项 / 0 失败，三闸全过
- ui_input_probe 十六断言全绿
- ui_layout_probe 四区尺寸逐位吻合 battle.md 规格
- doc_link 死链 0；doc_term 与基线同；gdd_lint 零新增
- 旧标识符残留全 0；_status_box 未成死代码，四个投喂键齐全
 2026-10-05 07:24:15 +08:00
DKChan ef82c036c3 M5 冒险地图（UI落码第二波）——节点1.4×(73×50层距零改)+候选烛光黄(金只留当前位G4)+节点类型文字标签(当前位/·可选)+底栏合并单条亮米板(头像+生命蓝条+属性+加成/流派件;道具槽不摆=无成文出口注记)+放弃危险钮+_status_box退役+node_overlay休息面板plate9化。投喂键全保留。闸=冒烟747/0+probe_gate全绿+layout 0 2026-10-05 02:11:41 +08:00
DKChan 5cf7f4b6ae 立《特性》概念：局内加强物品统一命名为「特性」，两种形态收敛为枚举值 + 文档/称谓/数据层标识符统一 
- 新增 design/gdd/systems/冒险循环/特性.md（概念唯一定义文档）
  定义=一次冒险内角色自身得到的提升（不是持有物）；作用范围、生命周期、
  获取途径（战场奖励/商店·训练）、关联与边界五要素齐全；数值一律指路表不入正文
- 02-系统清单：冒险循环补行 + 命名对照表补 ADVENTURE_FEATURE
- registry entities.yaml：新增 feature 概念条目（owner/referenced_by）+ adventure_table 字段名同步
- 数据层标识符 112 处换名（值零变更）：BONUS_IDS→FEATURE_KINDS、bonus_token_count→feature_quota、
  bonus_value→feature_value、token_*/bonus_*_flat→feature_quota_*/feature_value_*
- 称谓统一 94 处：旧称「流派件/数值件/本关强化」→ 特性 + 形态修饰语（规则改写型/属性加成型）
- 两张 schema 顶部加概念指路注释，代码可直接查到定义文档
- 06-待办清单：BD 分层条目现状改写 + 新增「命名统一后续」条目（relic 词族与类名对齐待实施）

未动：类名与文件名（Godot .uid/.tscn 引用需跑测试自证）、断点存档键（兼容）
 2026-10-05 01:46:35 +08:00
DKChan fec30644bd T3(D3): ArmedTimer helper——三处武装确认计时机制收口（P4乙：缝零动+视觉零变化） 
新件 game/presentation/armed_timer.gd（RefCounted）：武装/回落/超时/减动效档四能力
（motion_still 档判单点；elapsed 相位取数——1Hz 连续呼吸视觉零变化；窗口<=0=挂起语义）。
三处迁移：
①AP 条弃图刷新（ap_bar_view）：tween 秒表(4.0s)→ArmedTimer；三探针缝
  press_refresh_for_probe/confirm_visible/press_confirm_for_probe 语义等价零动
  （click 探针 :513-515 弃图确认链断言全绿实证）；字面量 4.0 升 REFRESH_CONFIRM_WINDOW_S。
②选路放弃钮（level_map_screen）：_process 帧驱动倒计时+1Hz 呼吸→timer.tick+elapsed 相位；
  减动效静态半透变体语义零变化（档判据归 motion_still）；真实二击路径零改。
③战斗总结结算框（main）：_settlement_stop_pending 裸布尔→ArmedTimer 挂起态属性化
  （窗口 0；读=armed/写=arm/disarm——探针与冒烟直读写接缝语义零变化；main 无 _process
  无需 tick 线）。
闸：click 三种子绿（7/9191、11/7343、23/6026 帧）+冒烟 718/0+run_all 15+ui_probe 绿。
 2026-10-04 07:10:00 +08:00
DKChan 22417783db T2(D2): 探针只读出口——BoardView/level_map_screen 四出口落地+私有域直入清零（全探针绿+冒烟718/0） 
出口四件（形态仿 fx_probe 先例：只读 Dictionary 快照）：
- BoardView.cells_probe()/diggable_probe()（键面同构快照）+hover_probe()/fog_params_probe()
  （后两件=D2 清单外同类项随批收口：_hover 1 处+_fog_lantern/_fog_enabled 2 处，完成定义
  「私有域直入清零」口径，26 处 > 任务书盘点 ~22 处——超出面系断言消息实参里的隐性直读）
- level_map_screen.layout_probe(nodes)/canvas_probe()（origin+min_size 快照）
消费侧改写：ui_input_probe 24 处（含循环体三处快照局部变量防逐迭代 duplicate）、
ui_probe 2 处、ui_click_probe 1 处；grep 复核 _cells/_diggable/_hover/_fog_*/_layout/_canvas
探针侧零残留。组合根接缝面（_row_queue 等）按边界注记不入本卡。烟测断言数 718 持平。
 2026-10-04 06:56:20 +08:00
DKChan f1a351f3bc 流派件持有呈现v2（用户二连反馈「战斗界面/关卡选择页都看不到局内奖励」）：①关卡选择页补齐——底部状态栏本关加成框内追加流派件持有行（set_relic_holdings 组合根投喂+与加成行并框任一非空整框显示）；②战斗C区流派件段上移至本关强化前（构筑核心优先+防clip_contents下部裁切不可见——用户实测「战斗界面没看到」的主因候选）；③投影逻辑抽 HudPresenter.relic_holdings_lines 静态共用（战斗C区/关卡页两处同源防漂移）+main 两处 open_choices 投喂；冒烟718/0三闸（基底6c20740——并行挖掘风险调研批纯文档无冲突） 2026-10-04 04:50:41 +08:00
DKChan cd1ed95b55 merge: master(04edd55 硬锁v3.1/probe适配四件/出度≤2新模板/血量pct修复)并入修复批——解冲突3处（ui_click_probe三态分派取master侧+ProbeUiUtil助手统一/main.gd锁期点击缓存重放保留+排播变量以RowPacer委托面承接/row_pacer新增pump_ended注入回调承接v3.1演播完边沿重放）+修复解冲突引入的解析错误（三态分派链缩进）；闸=冲烟636/0+run_all 15套+headless五探针绿+窗口化三件绿+熵增PASS；ui_click_probe budget耗尽与typed-array错误经纯master对照=1:1同源（master既有，归T17在飞批） 2026-10-02 10:42:52 +08:00
DKChan 5584feb6e5 T4 UiKit色彩骨架收口段: modal_shell/modal_dim收10处overlay骨架（dim色/min_size/panel参数化对照表在报告，探针私有件同名同层级保留）+label加color参收全层两行式+裸色收口（standee/camp/stage/level_map/board_world Color8→UiKit档13色+HEX_LOG_*/HEX_ROUTE/SEED 13档——值逐字节不变）+杂并七件（UiKit.scaled收双实现/到达拍块合并/点阵合并/画布常数单点/瓦片词表单点化/占位文案const/with_bar判据/bonus内联lambda改具名）；ArmedConfirm三处语义异构降级记06（不做了半套）；闸=冲烟636/0+run_all 15套+八探针全绿+熵增闸PASS 2026-10-02 09:07:06 +08:00
DKChan be772cfb2f T17反馈批收官: ①结算演播硬锁v3.1——锁期点击缓存+演播完边沿自动重放（玩家操作零丢失——实机卡死感根因=锁期点击被吞无反馈）②恢复被平反的两修复——血量口径（置满/回血封顶含pct）+选路呈现（干线偏移+非候选降透明）——probe卡死真因=probe未适配迭代10 BonusPickOverlay（假阳性扣压平反）③减动效按钮——文案不刷新bug修+语义命名「结算演出动画：完整/快速」+操作提示内联④出度≤2全套（用户拍板）——level_table第七检fanout_violation+L2L3十张模板重建（tools/t17_fanout2_rebuild.py五骨架出度≤2/层宽≤4/类型序列保持/自校验四检）+层宽上限5废止（数学不相容）改4+钉固断言5处随新图+文档两处（生成v0.6/地图v1.3）⑤probe适配BonusPick三态（替换/result继续/待选确认）+预算耗尽放弃收口+排播豁免；闸=冒烟628/0+run_all 15套+三探针+doc三闸零新增；连带义务=MC读数基线随图变漂移全旧锚作废只测不判，重锚归下一测量批 2026-10-02 08:11:06 +08:00
DKChan ca57fd39d5 revert: 暂回滚选路呈现两主因修复（干线偏移+非候选降透明）——ui_click_probe卡死归因隔离用（该修复与推进逻辑无数据面交集但实证相关，卡因待专项归因；修复本体挂单独批回炉） 2026-10-02 05:00:14 +08:00
DKChan 9ed597b452 T17反馈修复批: ①debug调生命上限后当前血不同步bug修复——冒险账本置满/通关回血封顶口径改生效上限同式（表值+永久强化flat+加算区flat后乘TunePanel pct，与LevelRunner.effective_max_hp逐字同源；旧口径两处只算flat：26→104时开局血仍26/回血封顶按26算）+smoke回血断言窗口同步×5口径（pct=0恒等MC锚零漂移）②第17项选路呈现两主因修复（B线调研定位）——通道干线mid_x按源y偏移消共线重叠+选路停点非候选通道降透明35%（旧态：金岔路与石色结构网焊接成整列可走假象）；闸=冒烟628/0+ui_probe/ui_input/fx三探针绿（ui_click_probe worktree环境不稳定卡死未决，主区复跑为准） 2026-10-02 04:56:55 +08:00
DKChan 79427d0f98 iter8-T8 卡⑤ 打磨包：①图例解码=RAP 行（LegendOverlay 构造参数表值注入 rap_refresh_cost——禁字面量）+九徽章解码条目（攻守爆医弱穿魔行金九键）②放弃按钮文案收敛 level-map 4 字上限（基态「放弃」，同失败结算语义移确认态）③判定文案两处措辞统一（phase_text 相位行战斗结束→随 battle_end_text 同词战斗胜利/失败）④封印旗纹理=素材在盘缺位（board/ui 全目录核证无旗件）→降级案维持文字占位+06 债务登记（HUD框架节新条目）——闸：冒烟 596/0+click/input/layout 全绿 2026-09-29 20:19:28 +08:00
DKChan 104cea6461 fix(review-batch3): 类型收紧生产清零137处(P1-2三步+延伸)+autoload class_name(ConfigDb/RngServiceCore)与_init标注(P2-1)+validate_skill_pool_links/ShopTable标注(P2-4)+相位enum外String面(P2-2)+typed-rows探针实证.tres装载转换；smoke缝合20处rows.assign+str(bb)同语义；审计生产双归零(240→103/83→59全测试链)，单测7套绿，冒烟576/0同基线 2026-09-29 07:01:29 +08:00
DKChan 6dcd40bce8 feat(ux): T3+T4 视觉终稿落码+转场挂点——GOLD_DONE/底栏墨色/血条深底/Boss 双描边+换层 tint 渐变挂点(UiKit.motion 包装) 2026-09-28 13:56:28 +08:00
DKChan 4ece929315 feat(ux): T2 节点图标组接线——五键量化过复用闸四道+load_tex 守卫接线+字形退役(缺位回退) 2026-09-28 13:51:41 +08:00
DKChan a055722372 feat(ux): T3 全链流程随独立屏——兑付覆盖层本屏域内弹出+出屏分支 
_submit_choice 节点类型分支：战斗/Boss=出屏（visible=false 后发射）；奖励/恢复/商店=本屏保持激活发射——兑付覆盖层由节点事件在本屏域内弹出（模态栈打开低层自动隐藏高层本屏、关闭自动恢复，零机制改动复用），兑付确认回图即本屏就地刷新（open_choices 幂等，was_visible 判据不重放淡入）。组合根 _on_route_chosen 改视图去留随动：出屏才收栈记录+_exit_level_screen 回战斗屏；放弃/冒险终局强制回战斗屏呈现摘要（T2 已落）。零自动推进纪律零改动。轻闸=冒烟 557/0+五探针 PASS（click_probe 岔路/商店路径含域内弹出全程实测）。
 2026-09-28 06:42:39 +08:00
DKChan ae2ca4ffd4 feat(ux): T2 独立屏落地——RouteOverlay 升格 LevelMapScreen+组合根屏级互斥 
类/文件改名 route_overlay.gd→level_map_screen.gd（RouteOverlay 退役，uid 随迁）；屏底=暗幕 0.6 半透→不透明 BG_ROOT+石纹底噪（TEX_BACKDROP_STONE load_tex 守卫缺位纯色回退，spec Layout 形态升格）；open_choices 进入转场 alpha 淡入 200ms（UiKit.motion；就地刷新/模态栈恢复不重放）。
组合根：_battle_root 宿主引用留存+_level_screen_active 状态+_enter/_exit_level_screen 单一出口（进屏隐战斗屏/出屏显战斗屏）；_on_choices_presented 走进屏；_on_route_chosen 出屏分支；_on_adventure_finished 强制回战斗屏呈现摘要（放弃入口终局兜底）。_input_locked/模态登记序（节点层与商店层之间）不变——兑付覆盖层域内弹出的遮挡恢复语义由模态栈零改动复用。
探针机械改名 main.route_overlay→main.level_screen（ui_probe 5/ui_click_probe 4/ui_input 5/ui_tune 2 处）。坑⑤再证：新 class_name 后未刷编辑器缓存致四探针 Parse Error 超时——--editor --quit 后全绿。轻闸=冒烟 557/0+五探针 PASS。
 2026-09-28 06:40:16 +08:00