chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令）
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例） - 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为 现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行） - 纯注释改动零行为变更，按用户令免测试免冒烟
This commit is contained in:
DKChan committed
1 parent
d5eea25f9c
commit
5f9d8e7b77
94 files changed
+386
-458
No files matched your search
@@ -1,6 +1,6 @@
|
||||
# 武装确认计时器（迭代 13 T3/D3——P4 乙裁决：只统一计时+脉冲机制，视觉三处各自保留）。
|
||||
# 收口债：三处二次确认计时机制异构（AP 条弃图刷新=tween 秒表 / 选路放弃钮=_process 帧驱动
|
||||
# 倒计时 / 战斗总结结算框=纯载荷暂存裸布尔）——本件消掉「计时机制三种实现」漂移源。
|
||||
# 武装确认计时器（只统一计时+脉冲机制，视觉三处各自保留）。
|
||||
# 背景：三处二次确认计时机制异构（AP 条弃图刷新=tween 秒表 / 选路放弃钮=_process 帧驱动
|
||||
# 倒计时 / 战斗总结结算框=纯载荷暂存裸布尔）——本类为单一计时实现。
|
||||
# 保缝纪律：AP 条三探针缝（press_refresh_for_probe/confirm_visible/press_confirm_for_probe）
|
||||
# 语义等价零动；放弃钮真实二击路径零改；结算框挂起态经组合根属性继续可读写（探针接缝）。
|
||||
# 减动效档：档判据单点 motion_still()——脉冲相位由视觉层取 elapsed 自算（1Hz 连续呼吸
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# 营地/商店投影控制器（迭代 13 T4/D4——二期家族③ 自 main.gd 迁出；规范 1.1 单一职责）：
|
||||
# 营地/商店投影控制器（规范 1.1 单一职责拆件）：
|
||||
# 营地面开合/快照投影/锻造·同调·天赋树·Fork 购买与切换 + 商店房购买/离开（pool 与 product 双面）。
|
||||
# 装配纪律（ADR-0001，仿 treasure_interact_controller 先例）：信号连接不在此发生——campbtn/
|
||||
# camp_overlay 四信号/shop_overlay 两信号由组合根接至本类 on_* 入口；模态栈/呈现刷新/续玩按钮
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# 提升三选一与替换子交互控制器（迭代 13 T4/D4——二期家族① 自 main.gd 迁出；规范 1.1 单一职责）：
|
||||
# 三选一交互控制器（规范 1.1 单一职责拆件）：
|
||||
# 三选一停点编排（presented→pick→confirm/refresh→resolved→continue）+ 同调位替换子态
|
||||
#（presented→chosen）+ TP0 令牌池卡片文案装配（"kind|tier|feat_id" 复合键）+ 工坊显示名投影。
|
||||
# 装配纪律（ADR-0001，仿 treasure_interact_controller 先例）：信号连接不在此发生——curio_overlay
|
||||
# 四信号与 adventure 两信号由组合根接至本类 on_* 入口；模态栈/演播后排窗/呈现刷新/终局面/
|
||||
# 推进失败 fatal 经组合根回调注入；adventure/runner 随局更替——现值回调注入；兑付写调用唯一
|
||||
# 经 adventure.pick_curio/apply_node_curio（core 侧单口，本类零直写；替换子交互随迭代 22 T5 拆除——装配不可变契约 1，冒险中零更换途径）。
|
||||
# 经 adventure.pick_curio/apply_node_curio（core 侧单口，本类零直写；无替换子交互——装配不可变契约 1，冒险中零更换途径）。
|
||||
extends RefCounted
|
||||
|
||||
const Narrator := preload("res://presentation/battle_narrator.gd")
|
||||
|
||||
@@ -1,14 +1,13 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# Date: 2026-09-13（封装审查 O1/O2 修复批——自 main.gd 拆出，规范 1.1 审视线 / 单一实现纪律）
|
||||
# Date: 2026-09-13（自 main.gd 拆出——规范 1.1 审视线 / 调试语义单一实现纪律）
|
||||
# 调试模式编排控制器：单场遭遇（第 1/2 层）与连续两层（HP 关内延续）的模式状态机与战斗生命周期。
|
||||
# 职责边界：层序/携带 HP + 战斗结算 生命周期编排（创建 / begin_battle）。
|
||||
# 2026-09-15 格面资源批：库存与共享 地图战斗资源 随可选类道具删除下线——层间延续只剩 HP
|
||||
# （"库存与 HP 关内延续"语义收窄为"HP 关内延续"，O2 单一实现点随之收窄）。
|
||||
# 授权先例：与 tune_sim_controller 同款（code-review 2026-09-12 批）——控制器承接模式编排，
|
||||
# 层间延续 = HP 关内延续（库存与共享 地图战斗资源 已下线）。
|
||||
# 授权边界：与 tune_sim_controller 同款——控制器承接模式编排，
|
||||
# 组合根仍持有全部信号接线（battle_created 先于 begin_battle 发出，ADR-0001 接线唯一归组合根）
|
||||
# 与终局 UI 决策；玩家意图写调用（settle_batch / 刷新）不经本类。
|
||||
# E4 收口（2026-09-13）：加成生效值经注入 Callable 供给（组合根从面板百分比现算）→ encounter
|
||||
# 显式传入战斗——零表写，"双写叠加/双基线同步"整类隐患随表写移除。
|
||||
# 加成生效值经注入 Callable 供给（组合根从面板百分比现算）→ encounter
|
||||
# 显式传入战斗——零表写。
|
||||
extends RefCounted
|
||||
|
||||
signal battle_created(settlement, level: int, carry_hp: int) # begin_battle 前——组合根完成信号接线（ADR-0001）
|
||||
|
||||
@@ -3,13 +3,13 @@
|
||||
# 组装文案/投影 → 驱动各视图 setter。
|
||||
# 高内聚边界："核心状态 → 呈现文案"的全部翻译集中于此；视图保持零核心依赖；
|
||||
# 静态无状态——呈现不持久化任何核心句柄。
|
||||
# E1 封装收口（2026-09-13）：核心状态读取统一经 战斗结算.presentation_snapshot() 成文快照面——
|
||||
# 禁再链式穿透 settlement.enemy_system.hero / settlement.enemy_system.enemies / settlement.status_effects.query_active 一类路径（战斗结算 协作对象已私有化，
|
||||
# 敌人含死亡残位的投影由快照 enemies[] 承载，含 alive/pending_*/effects 字段——2026-09-16 敌人技能池批批 2 定稿）。
|
||||
# 核心状态读取统一经 战斗结算.presentation_snapshot() 成文快照面——
|
||||
# 禁链式穿透 settlement.enemy_system.hero / settlement.enemy_system.enemies / settlement.status_effects.query_active 一类路径（战斗结算 协作对象已私有化，
|
||||
# 敌人含死亡残位的投影由快照 enemies[] 承载，含 alive/pending_*/effects 字段）。
|
||||
# 更新触发注记（battle.md Data Requirements）：旗/拔/移动成功反馈零事件外发（排雷玩法 发射面封闭）——
|
||||
# 经 ActionOutcome 返回值命令式驱动；AP/RAP 无推送信号——组合根每次调用返回后重查；
|
||||
# 增益状态 纯被动容器零信号——状态栏刷新绑 战斗结算 结算编排完成时点。
|
||||
# Date: 2026-09-12（战斗屏改造批；基础 = 2026-09-11 HUD 装配器；2026-09-13 快照面改造）
|
||||
# Date: 2026-09-12（战斗屏改造批；基础 = 2026-09-11 HUD 装配器）
|
||||
class_name HudPresenter
|
||||
extends RefCounted
|
||||
|
||||
|
||||
+19
-30
@@ -1,45 +1,34 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# Validation Question: 线性第一关（战×2→道具→战×2→恢复→Boss）能否承载"数值提升→通关期望改善"的元进度验证
|
||||
# 实现 GDD：design/ux/battle.md（战斗屏 A/B/C/D 四区 + 全屏 States + 遥测；E 区随可选类删除下线 2026-09-15）。
|
||||
# Date: 2026-09-12（battle.md 战斗屏改造批；基础 = 2026-09-11 HUD框架-lite 组合根；code-review 修复批重构）
|
||||
# 2026-09-13（封装审查修复批）：核心状态读取收口至 战斗结算/runner 成文只读面（presentation_snapshot /
|
||||
# current_board / current_battle 等——禁链式穿透 settlement.enemy_system.hero 一类路径）；调试模式编排抽离
|
||||
# debug_session.gd（规范 1.1 审视线 + 调试语义单一实现）。
|
||||
# 实现 GDD：design/ux/battle.md（战斗屏 A/B/C/D 四区 + 全屏 States + 遥测；E 区已随可选类删除下线）。
|
||||
# Date: 2026-09-12（battle.md 战斗屏改造批；基础 = 2026-09-11 HUD框架-lite 组合根）
|
||||
# 组合根（composition root）：唯一的模式流转与 core↔view 接线处。
|
||||
# 职责边界：① 构建三屏场景并接线信号（屏壳场景 menu_screen/camp_screen/adventure_screen——迭代 27 T1
|
||||
# 场景拆分波，视图构建仍归 ui_assembler.gd——规范 1.1，本类只接线；模态层仍归本类程序化装配）
|
||||
# 职责边界：① 构建三屏场景并接线信号（屏壳场景 menu_screen/camp_screen/adventure_screen，视图构建仍归
|
||||
# ui_assembler.gd——规范 1.1，本类只接线；模态层仍归本类程序化装配）
|
||||
# ② 模式管理（正式冒险 AdventureRunner——唯一试玩入口；调试两层编排归 debug_session.gd；单场原语仅探针使用）
|
||||
# ③ 核心写调用只在此处发生（minesweeper.settle_batch / 刷新编排入口 / runner 推进；
|
||||
# E4 收口：加成值零表写——面板百分比经 runner.set_hero_override / debug_session 生效值 Callable
|
||||
# 加成值零表写——面板百分比经 runner.set_hero_override / debug_session 生效值 Callable
|
||||
# 以 encounter 参数入战斗，db.hero 运行期只读）
|
||||
# ④ 全屏 States 状态机（挖掘/结算/终局）与一次性提示去重。
|
||||
# 2026-09-15 格面资源批：道具窗口与库存面板随可选类道具删除下线——E 区移除，窗口接线/选择序列删除。
|
||||
# GP+商店房实施批（2026-09-21）：商店覆盖层挂接与信号接线（装配器零信号连接纪律——句柄返回、
|
||||
# 本类连接）+ runner.wallet_changed 转发试玩日志（wallet 行族）+ A 区顶栏金币余额。
|
||||
# 场景结构：三屏 .tscn 屏壳 + 全部模态程序化装配于本类；树序 = [菜单屏, 冒险屏, 模态层...]——屏内两容器
|
||||
# 无同时可见态，全部模态在屏壳之上。
|
||||
# 局生命周期：run_scope.gd 节点持全部局态（adventure/runner/settlement/局态旗/账本）——_begin_session
|
||||
# 创建，会话更替/终局整节点 queue_free()。
|
||||
# autoload：SaveManager/MetaProgression/RngService/ConfigDB 为 autoload（类名加 Core 后缀、autoload 占
|
||||
# 净名），存档读盘挂 autoload _ready。
|
||||
# 核心状态读取只经成文只读面（presentation_snapshot / current_board / current_battle 等）——禁
|
||||
# settlement.enemy_system.hero 一类链式穿透。
|
||||
# 渲染与文案归 views/，核心状态→文案装配归 hud_presenter.gd 与 battle_narrator.gd，节点构建归
|
||||
# ui_assembler.gd，模态层级归 modal_stack.gd，批量模拟编排归 tune_sim_controller.gd，调试模式编排归
|
||||
# debug_session.gd——本类不拼呈现字符串。
|
||||
# T3 拆件批（2026-10-02，规范 1.1 单一职责）：结算行排播泵迁 row_pacer.gd（本类只入队/排空/读队列，
|
||||
# 探针/测试委托面 _row_queue/pace_delay_for/_flush_row_queue 原位保留）；秘宝两步交互迁
|
||||
# treasure_interact_controller.gd（本类只接线与转发意图，无目标使用显式化——哨兵坐标不出控制器）；
|
||||
# （GP 影子账已随迭代 27 T3 退役——summary gp_final 键取代）。模态开合全量走
|
||||
# _open_modal/_close_modal 单口，输入锁=modal_stack.has_open_excluding(debug_overlay) 排除式
|
||||
# 开态查询+三例外（迭代 18 卡⑦——浮窗开态不计入锁）；battle 收尾反馈与
|
||||
# 结算视觉 setter 收敛 hud_presenter 单通道（时序敏感演出触发留本类并注释）；settlement 相位读取改经
|
||||
# presentation_snapshot 成文面、变异表读取直读本根 db（settlement.db 即同一实例）——禁
|
||||
# settlement.action_economy / settlement.db 链式穿透。
|
||||
# 结算行排播归 row_pacer.gd（本类保留探针/测试委托面 _row_queue/pace_delay_for/_flush_row_queue）；
|
||||
# 秘宝两步交互归 treasure_interact_controller.gd（本类只接线与转发意图——哨兵坐标不出控制器）。
|
||||
# 模态开合全量走 _open_modal/_close_modal 单口，输入锁 = modal_stack.has_open_excluding(debug_overlay)
|
||||
# 排除式开态查询+三例外（浮窗开态不计入锁）；battle 收尾反馈与结算视觉 setter 走 hud_presenter 单通道
|
||||
# （时序敏感演出触发留本类并注释）；settlement 相位读取经 presentation_snapshot 成文面、变异表读取直读
|
||||
# 本根 db（settlement.db 即同一实例）——禁 settlement.action_economy / settlement.db 链式穿透。
|
||||
# ADR-0001 纪律：呈现层永不直接订阅 排雷玩法/行动经济——只订 战斗结算/runner 转发信号；相位读取仅用于
|
||||
# 驱动视图状态；信号连接只在组合根（row_pacer/treasure_interact_controller 零连接，只收注入）。
|
||||
# 迭代 27 T1（场景拆分+局生命周期物化波——审计 P0-1/P0-2）：
|
||||
# · 三屏场景化——menu_screen/camp_screen/adventure_screen .tscn 屏壳（视图代码原样构建，
|
||||
# 装配器/视图类零 .tscn 化），本类保留全部接线句柄（ADR-0001 组合根职责），_build_ui 解体为
|
||||
# 「三屏实例化 + 模态装配 + 接线」；树序 = [菜单屏, 冒险屏, 模态层...]——屏内两容器无同时可见态，
|
||||
# 全部模态仍在屏壳之上（视觉共存对逐对验算零漂移——实现报告留痕）。
|
||||
# · 会话物化——run_scope.gd 节点持全部局态（adventure/runner/settlement/局态旗/账本），
|
||||
# _begin_session 创建、会话更替/终局整节点 queue_free()，旧手工复位清单
|
||||
# （_reset_run_scope 三项 + _on_battle_end_continue 置空四件）消亡。
|
||||
# · SaveManager/MetaProgression 升格 autoload（裁点①甲——RngService 先例：类名加 Core 后缀、
|
||||
# autoload 占净名），存档读盘挂 autoload _ready（时序与旧 main._ready 读盘等价）。
|
||||
extends Control
|
||||
|
||||
# autoload 节点路径单点（迭代 27 T6 P2-2 降格实现：审计处方「编译期全局名」与本仓 --script
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# 实现 GDD：design/ux/battle.md（§Events Fired 遥测义务——ux 行族）。
|
||||
# Date: 2026-09-12（战斗屏改造批增 ux 遥测；基础 = 2026-09-12 日志器首版）
|
||||
# Date: 2026-09-12（战斗屏 ux 遥测）
|
||||
# 试玩日志器（呈现层组件——订阅核心信号持久化 JSONL，供数值分析；卡死诊断转储）。
|
||||
# 职责边界：核心层只发 settlement_snapshot 信号（战斗结算）/既有信号（battle_finished/node_entered/
|
||||
# level_finished/step_row）；本组件负责订阅、缓冲与写文件——核心零日志感知（零 UI 依赖不变）。
|
||||
# 文件 = user://logs/playtest_<seed>_<时间戳>.jsonl（每行一次结算/终局/节点的全量状态 JSON）。
|
||||
# ux 行族（呈现层观测，不改 core）：ux_round_input_ratio（原始输入动作数∶AP 消耗）、
|
||||
# ux_round_exit{path_tag}（快照 round_facts.path——呈现层只订 战斗结算 的 ADR 纪律下唯一合法来源）、
|
||||
# ux_refresh_attempt / ux_reject / ux_hint_shown（组合根显式上报；ux_window_choice 随道具窗口删除下线 2026-09-15）。
|
||||
# ux_refresh_attempt / ux_reject / ux_hint_shown（组合根显式上报；无 ux_window_choice——道具窗口已下线）。
|
||||
# 诊断转储 = 全量核心状态 + 最近结算/操作环形缓冲 → user://logs/diag_<时间戳>.json（卡死时点按钮）。
|
||||
class_name PlaytestLogger
|
||||
extends RefCounted
|
||||
|
||||
@@ -1,11 +1,10 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# 结算行排播泵（迭代 8 卡⑦；T3 拆件批 2026-10-02 自 main.gd 整体迁出——规范 1.1 单一职责）：
|
||||
# 结算行排播泵（规范 1.1 单一职责拆件）：
|
||||
# 演出层排播：逻辑先行零回压，行按段分组阶梯延迟进明细带。
|
||||
# 硬契约：核心层零 await 不破——本队列只做信号的"后置消费"，结算顺序/结果/时序逻辑零改动（§3 契约 1）；
|
||||
# 减动效开=延迟归零走同帧直落快路（行呈现不跳过——§3 契约 5）；模态开启前强制排空（明细回看/停点
|
||||
# 覆盖层所见明细带恒完整——排空入口在组合根 _open_modal）。
|
||||
# 装配纪律：视图句柄与呈现刷新回调由组合根注入（ADR-0001——本类零信号连接，仅做信号后置消费）；
|
||||
# 行消费与卡⑦前逐位一致（_consume_row 原文迁入，语义零改动）。
|
||||
# 装配纪律：视图句柄与呈现刷新回调由组合根注入（ADR-0001——本类零信号连接，仅做信号后置消费）。
|
||||
extends Node
|
||||
|
||||
const PACE_SEGMENT_GAP := 0.3 # 段间阶梯延迟（代拍板：白名单 0.2–0.4s 内取值，追认清单呈报）
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# Date: 2026-09-29（迭代 8 卡④ 最小设置面——设置与本地化.md P1 两项兑现：音量入口+减动效开关）
|
||||
# 系统级设置独立存储（设置与本地化.md——2026-09-19 用户拍板：一安装一份、删游戏才消失，
|
||||
# Date: 2026-09-29（最小设置面：音量入口+减动效开关——设置与本地化.md P1）
|
||||
# 系统级设置独立存储（设置与本地化.md：一安装一份、删游戏才消失，
|
||||
# 不进存档与生涯数据两分）。三件最小面：音量（master bus）/全屏/减动效。
|
||||
# 生效侧分工：入口与持久化归本类；音量对声音的生效口径归 音频.md（master bus 单点）；
|
||||
# 减动效对动画的分档兑现归 battle.md §Transitions（UiKit.motion_scale 既有承载，结算逐行
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# 秘宝两步交互控制器（迭代 7 T4；T3 拆件批 2026-10-02 自 main.gd 迁出——规范 1.1 单一职责）：
|
||||
# 秘宝两步交互控制器（规范 1.1 单一职责拆件）：
|
||||
# C 区槽位选中/取消（toggle）→ 棋盘点格使用目标拾取的两步交互状态机 + 库存/叠加层只读投影装配。
|
||||
# 数据源 = runner 级库存只读面（query_inventory/query_overlays）+ 表行投影（display_name/target/effect_kinds）；
|
||||
# 写调用唯一经 战斗结算.use_treasure（core 侧四步编排——拒绝零消耗 toast 可辨认）。
|
||||
# 装配纪律：settlement/runner 随关卡逐关更替——经组合根现值回调注入（仿 identity_resolver 只读回调
|
||||
# 先例）；呈现句柄（信息面板/toast/棋盘叠加层）由组合根注入；ADR-0001——信号连接不在此发生，
|
||||
# info_panel.treasure_slot_clicked 由组合根接至 on_slot_clicked。
|
||||
# 无目标使用显式化（T3 收口）：AP 类（target=none）本无坐标可给——原调用面伪造 Vector2i(-9,-9)
|
||||
# 哨兵坐标；现调用面一律 attempt_use(handle)（cell 缺省=null=显式「无目标」），core 契约的
|
||||
# 无目标使用显式化：AP 类（target=none）无坐标可给——
|
||||
# 调用面一律 attempt_use(handle)（cell 缺省=null=显式「无目标」），core 契约的
|
||||
# Vector2i 形参收口于本类常量（treasure_items.validate_use 对 ap 行忽略目标值，哨兵不出本类）。
|
||||
extends RefCounted
|
||||
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||||
# Date: 2026-09-12（code-review 修复批——自 main.gd 拆出，规范 1.1/1.2 模拟编排独立成类）
|
||||
# Date: 2026-09-12（自 main.gd 拆出——规范 1.1/1.2 模拟编排独立成类）
|
||||
# 调整板批量模拟控制器：逐次驱动 关卡自动策略（与 headless 扫描同口径）+ 进度/报告 setter 注入面板。
|
||||
# 职责边界：零核心写——表基线复位由组合根在移交前完成（_apply_hero_override(0,0)），
|
||||
# 加成施加 = 自动策略内部 runner.set_hero_override 单路径；报告文案装配归 HudPresenter。
|
||||
# 组合根只转发 simulate_requested 信号。await 依赖面板所在场景树（进度逐帧刷新）。
|
||||
# 反向依赖解除（2026-10-02 修复批 T6）：presentation → smoke 的 preload 编译期依赖拆除——
|
||||
# 依赖方向：presentation 不 preload smoke——
|
||||
# 驱动实例由调用方构造注入（_driver，须供 run_level(...) 与 smoke/level_autoplay 同款签名）；
|
||||
# 构造参数缺省 null = 内部自建旧行为（运行时 load 兜底，同种子同口径零漂移）——main 侧接线归主控后续卡。
|
||||
# 构造参数缺省 null = 内部运行时 load 兜底（同种子同口径零漂移）。
|
||||
extends RefCounted
|
||||
|
||||
const SEED_BASE := 4200 # 模拟种子基（与历史实现同源——同种子可回放）
|
||||
|
||||
@@ -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 更新触发注记）。
|
||||
|
||||
Reference in new issue
Block a user