From 629b905056ae7034a8134666f55c319c8c44b15a Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 21 Sep 2026 04:32:29 +0800 Subject: [PATCH 1/4] =?UTF-8?q?feat(content):=20=E5=85=83=E8=BF=9B?= =?UTF-8?q?=E5=BA=A6=E5=AE=9E=E7=8E=B0=E6=89=B9=20T0+T1=E2=80=94=E2=80=94w?= =?UTF-8?q?orktree=20=E5=9F=BA=E7=BA=BF=EF=BC=88=E5=86=92=E7=83=9F437?= =?UTF-8?q?=E4=B8=89=E9=97=B8=E7=BB=BF+MC=20L1=20normal=2035%=E5=AD=98?= =?UTF-8?q?=E6=A1=A3=20qa=EF=BC=89+=20MetaTable=20=E5=9B=9B=E8=A1=8C?= =?UTF-8?q?=E6=97=8F=E5=BB=BA=E8=A1=A8=EF=BC=88schema/tres/ConfigDB?= =?UTF-8?q?=E6=8E=A5=E7=BA=BF/=E5=86=92=E7=83=9F4=E6=96=AD=E8=A8=80?= =?UTF-8?q?=EF=BC=8C441=E7=BB=BF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 前置门偏差登记：规划书假设 B1/B2 已合并落 master，实测 B1 在并行 worktree 进行中（未提交）、 B2 worktree 刚建未开工——基线为 pre-B1/B2 master，T7 须在 B1/B2 合并后复验白板回归。 --- production/qa/mc-baseline-meta-20260921.txt | 11 ++ .../core/config_db.gd | 44 +++++++ .../data/schemas/meta_table.gd | 110 ++++++++++++++++++ .../data/schemas/meta_table.gd.uid | 1 + .../data/tables/meta.tres | 80 +++++++++++++ .../smoke/smoke_all.gd | 22 ++++ 6 files changed, 268 insertions(+) create mode 100644 production/qa/mc-baseline-meta-20260921.txt create mode 100644 prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd create mode 100644 prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd.uid create mode 100644 prototypes/dungeon-sweeper-vertical-slice/data/tables/meta.tres diff --git a/production/qa/mc-baseline-meta-20260921.txt b/production/qa/mc-baseline-meta-20260921.txt new file mode 100644 index 00000000..2934d8d9 --- /dev/null +++ b/production/qa/mc-baseline-meta-20260921.txt @@ -0,0 +1,11 @@ +Godot Engine v4.7.2.stable.official.ed1daf0bf - https://godotengine.org + +模拟日志: user://logs/playtest_4200_20260921T042329.jsonl +=== 关卡期望扫描：level 1 · N=20/格 · 种子 4200+20 · 策略=normal · 种子模式=shared === +策略 atk%/hp% 通关率 整关承伤均/p90 通关剩余HP均(胜) 进BossHP均 平均轮数 踩雷/战 普通承伤/场% 跳战率 Boss承伤% 踩雷/局 刷新/局 +基线 atk +0% hp +0% 35% 16.4 / 22.0 4.3 14.0 15.2 0.03 14.6 7% 44.9 0.15 0.00 6.boss×12 4.battle×1 +（F4 带：承伤 ≤20%/普通场 · ≤50%/Boss 场，占生效 max_hp · F5 带：基线通关率 L1 [35,55]% / L2 [25,45]%——2026-09-20 用户拍板分带 · 跳战率 = 普通战斗 round-1 即胜（首轮全灭）占比 · 承伤含败者至死 · 败北节点 0-3=战斗节点序 4=Boss · 踩雷/战=每战斗负向兑付触发期望（格面资源批口径） · 完美档 = 技能轴上界测量（零盲挖/全标旗/卡死刷新——口径见 auto_player.gd）· 耗时 21.2 秒） +WARNING: 49 ObjectDB instances were leaked at exit (run with `--verbose` for details). + at: cleanup (core/object/object.cpp:2536) +ERROR: 26 resources still in use at exit (run with --verbose for details). + at: clear (core/io/resource.cpp:822) diff --git a/prototypes/dungeon-sweeper-vertical-slice/core/config_db.gd b/prototypes/dungeon-sweeper-vertical-slice/core/config_db.gd index 98f00e4e..e4736d46 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/core/config_db.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/core/config_db.gd @@ -21,6 +21,7 @@ const TABLE_MANIFEST := { "level": "level.tres", "difficulty": "difficulty.tres", "shop": "shop.tres", # GP+商店房实施批 2026-09-21（表与 schema 落籍归并行数据面——本批只接线加载与消费） + "meta": "meta.tres", # 元进度实现批 2026-09-21（MetaTable 四行族——schema 与表同批落籍） } var action_economy: ActionEconomyTable @@ -37,6 +38,8 @@ var difficulty: DifficultyTable # GP+商店房实施批（2026-09-21）：ShopTable 暂持无类型注记——schema class_name 落籍归并行数据面， # 落籍后可收紧为 `var shop: ShopTable`（消费面一律走下方 shop_* 访问器，禁直读行集） var shop = null +# 元进度实现批（2026-09-21）：MetaTable 类型化持用（schema 与表同批落籍，无 shop 先例的落籍间隙问题） +var meta: MetaTable var is_ready := false var _diagnostics: Array = [] # {severity, category, message} @@ -119,6 +122,7 @@ func load_tables(root: String, collect_only: bool) -> bool: level = loaded.get("level") difficulty = loaded.get("difficulty") shop = loaded.get("shop") + meta = loaded.get("meta") is_ready = not has_errors return not has_errors @@ -375,6 +379,46 @@ func _shop_rows(family: String) -> Array: return arr if arr is Array else [] +# ---- 元进度实现批（2026-09-21）：MetaTable 消费面（行集解析单点——MetaProgression/呈现层禁自扫表）---- +# 行族四轴（数据契约，行集归 meta.tres，数值全 provisional 归元进度设计批配读数）： +# forge_products {attr, display_name, flat_value, base_price, price_ratio_pct} · +# boss_keystone {level_index, first_kill, repeat_kill} · +# workshop_items {item_id, display_name, clear_threshold} · +# conversion {attr, per_level_shift_pct}。 + +func meta_forge_row(attr: String) -> Dictionary: + for row in _meta_rows("forge_products"): + if String(row.get("attr", "")) == attr: + return row + return {} + + +func meta_boss_keystone_row(level_index: int) -> Dictionary: + for row in _meta_rows("boss_keystone"): + if int(row.get("level_index", -1)) == level_index: + return row + return {} + + +func meta_workshop_items() -> Array: + return _meta_rows("workshop_items") + + +func meta_conversion_row(attr: String) -> Dictionary: + for row in _meta_rows("conversion"): + if String(row.get("attr", "")) == attr: + return row + return {} + + +# 行族数组读取（MetaTable 属性名 = 行族名；表缺失/属性缺失 = 空集非错误态） +func _meta_rows(family: String) -> Array: + if meta == null: + return [] + var arr = meta.get(family) + return arr if arr is Array else [] + + # 技能行单点读取（敌人技能池批——单位容器执行上报 / 战斗结算兑现的消费面） func skill_row(skill_id: String) -> Dictionary: return skill.row_by_id(skill_id) diff --git a/prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd b/prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd new file mode 100644 index 00000000..af5a8401 --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd @@ -0,0 +1,110 @@ +# VERTICAL SLICE - NOT FOR PRODUCTION +# Validation Question: 玩家能否在营地用钥石换永久强化、且强化在下一局开局生效——存档变厚成为玩家可感的现实 +#（元进度 GDD 验收标准，本批 = 其实现批） +# Date: 2026-09-21（元进度实现批——设计权威 design/gdd/systems/冒险循环/元进度.md 定稿 v1.2） +# 数据配置 MetaTable schema（元进度/永久强化 行族四轴）。 +# 行族四轴（数据契约对齐 ConfigDB.meta_* 访问器——消费面一律走访问器，禁直读行集）： +# forge_products = 属性锻造商品行（键 attr：{max_hp, atk, armor_class} 恰三唯一——注入契约三字段必齐； +# 投值语言锁定 flat 整数；几何定价 tier 级价格 = 迭代 p = floor(p × price_ratio_pct/100)，tier 0 = base_price）。 +# boss_keystone = Boss 钥石两档行（level_index 连续从 1；first_kill ≥ repeat_kill——首杀全量、 +# 重复杀固定小额恒定不递减，两档数值归元进度设计批配读数）。 +# workshop_items = 道具工坊行（item_id = registry aux_items 六件词表封闭恰全；首版解锁渠道 = 总通关次数 +# 达标 clear_threshold——2026-09-20 排期裁决；局内效果整体归 Alpha 魔法道具重设计批，本表只有解锁状态面）。 +# conversion = 区间平移换算率行（attr 与 forge 词表一致恰三；per_level_shift_pct ∈ [0,100]—— +# registry 键 meta_progression_conversion_table；护甲行强条目：验收读数必须按解锁后参数重测）。 +# 行值全部 provisional 归 元进度设计批配读数（用户拍板骨架先行，先例 = GP+商店房批）。 +class_name MetaTable +extends Resource + +@export var forge_products: Array = [] # Array[Dictionary] 键 attr +@export var boss_keystone: Array = [] # Array[Dictionary] 键 level_index +@export var workshop_items: Array = [] # Array[Dictionary] 键 item_id +@export var conversion: Array = [] # Array[Dictionary] 键 attr + +const FORGE_ATTRS := ["max_hp", "atk", "armor_class"] +const WORKSHOP_ITEM_IDS := ["probe_dust", "sapper_order", "loot_compass", "nest_pendulum", "catacomb_scroll", "blast_kit"] + + +func validate() -> Array: + var errs: Array = [] + # 行族空护栏（四族皆为 ConfigDB 消费面——缺族即致命） + for family in ["forge_products", "boss_keystone", "workshop_items", "conversion"]: + if get(family).is_empty(): + errs.append({"category": "empty_table", "message": "MetaTable 行族为空: %s" % family}) + # forge_products：attr 词表封闭 + 唯一 + 覆盖恰三（注入契约三字段必齐）+ flat/价格域 + 公比域 [100,400] + var seen_attr := {} + for row in forge_products: + var attr: String = row.get("attr", "") + if not FORGE_ATTRS.has(attr): + errs.append({"category": "enum", "message": "forge_products attr 出域 {max_hp, atk, armor_class}: %s" % attr}) + if seen_attr.has(attr): + errs.append({"category": "dup_key", "message": "forge_products attr 重复: %s" % attr}) + seen_attr[attr] = true + if String(row.get("display_name", "")) == "": + errs.append({"category": "domain", "message": "forge_products %s display_name 空" % attr}) + var flat: int = int(row.get("flat_value", 0)) + if flat < 1 or flat > 999: + errs.append({"category": "domain", "message": "forge_products %s flat_value 越域 [1,999]: %d" % [attr, flat]}) + var base: int = int(row.get("base_price", 0)) + if base < 1 or base > 999: + errs.append({"category": "domain", "message": "forge_products %s base_price 越域 [1,999]: %d" % [attr, base]}) + var ratio: int = int(row.get("price_ratio_pct", -1)) + if ratio < 100 or ratio > 400: + errs.append({"category": "domain", "message": "forge_products %s price_ratio_pct 越域 [100,400]: %d" % [attr, ratio]}) + if not forge_products.is_empty(): + for attr_key in FORGE_ATTRS: + if not seen_attr.has(attr_key): + errs.append({"category": "coverage", "message": "forge_products 缺属性键: %s（注入契约三字段必齐——恰三）" % attr_key}) + # boss_keystone：level_index 唯一 + 连续从 1 + 两档域 + first ≥ repeat（首杀全量、重复小额恒定） + var seen_li := {} + for row in boss_keystone: + var li: int = int(row.get("level_index", 0)) + if seen_li.has(li): + errs.append({"category": "dup_key", "message": "boss_keystone level_index 重复: %d" % li}) + seen_li[li] = true + var first: int = int(row.get("first_kill", -1)) + var rep: int = int(row.get("repeat_kill", -1)) + if first < 1 or first > 999 or rep < 0 or rep > 999: + errs.append({"category": "domain", "message": "boss_keystone L%d 两档金额越域 first [1,999] / repeat [0,999]: %d/%d" % [li, first, rep]}) + if first < rep: + errs.append({"category": "cross_field", "message": "boss_keystone L%d 违反 first_kill(%d) ≥ repeat_kill(%d)——首杀全量、重复杀小额" % [li, first, rep]}) + for i in boss_keystone.size(): + var li_at: int = int(boss_keystone[i].get("level_index", 0)) + if li_at != i + 1: + errs.append({"category": "structural", "message": "boss_keystone level_index 不连续（须从 1 连续递增）: 位 %d = %d" % [i + 1, li_at]}) + break + # workshop_items：item_id 词表封闭 + 唯一 + 覆盖恰六（registry aux_items 词表）+ 阈值域 [1,99] + var seen_item := {} + for row in workshop_items: + var iid: String = row.get("item_id", "") + if not WORKSHOP_ITEM_IDS.has(iid): + errs.append({"category": "enum", "message": "workshop_items item_id 出域 aux_items 六件词表: %s" % iid}) + if seen_item.has(iid): + errs.append({"category": "dup_key", "message": "workshop_items item_id 重复: %s" % iid}) + seen_item[iid] = true + if String(row.get("display_name", "")) == "": + errs.append({"category": "domain", "message": "workshop_items %s display_name 空" % iid}) + var th: int = int(row.get("clear_threshold", -1)) + if th < 1 or th > 99: + errs.append({"category": "domain", "message": "workshop_items %s clear_threshold 越域 [1,99]: %d" % [iid, th]}) + if not workshop_items.is_empty(): + for iid_key in WORKSHOP_ITEM_IDS: + if not seen_item.has(iid_key): + errs.append({"category": "coverage", "message": "workshop_items 缺道具键: %s（六件词表恰全）" % iid_key}) + # conversion：attr 词表与 forge 一致 + 唯一 + 覆盖恰三 + 平移量域 [0,100] + var seen_conv := {} + for row in conversion: + var cattr: String = row.get("attr", "") + if not FORGE_ATTRS.has(cattr): + errs.append({"category": "enum", "message": "conversion attr 出域 {max_hp, atk, armor_class}: %s" % cattr}) + if seen_conv.has(cattr): + errs.append({"category": "dup_key", "message": "conversion attr 重复: %s" % cattr}) + seen_conv[cattr] = true + var shift: int = int(row.get("per_level_shift_pct", -1)) + if shift < 0 or shift > 100: + errs.append({"category": "domain", "message": "conversion %s per_level_shift_pct 越域 [0,100]: %d" % [cattr, shift]}) + if not conversion.is_empty(): + for conv_key in FORGE_ATTRS: + if not seen_conv.has(conv_key): + errs.append({"category": "coverage", "message": "conversion 缺属性行: %s（三行与 forge 词表一致）" % conv_key}) + return errs diff --git a/prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd.uid b/prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd.uid new file mode 100644 index 00000000..ded0f08b --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/data/schemas/meta_table.gd.uid @@ -0,0 +1 @@ +uid://b2nl5v8gb6cw diff --git a/prototypes/dungeon-sweeper-vertical-slice/data/tables/meta.tres b/prototypes/dungeon-sweeper-vertical-slice/data/tables/meta.tres new file mode 100644 index 00000000..ccd52393 --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/data/tables/meta.tres @@ -0,0 +1,80 @@ +[gd_resource type="Resource" script_class="MetaTable" load_steps=2 format=3] + +[ext_resource type="Script" path="res://data/schemas/meta_table.gd" id="1"] + +[resource] +script = ExtResource("1") +forge_products = [{ +"attr": "max_hp", +"display_name": "生命锻造", +"flat_value": 3, +"base_price": 10, +"price_ratio_pct": 150 +}, { +"attr": "atk", +"display_name": "攻击锻造", +"flat_value": 1, +"base_price": 10, +"price_ratio_pct": 150 +}, { +"attr": "armor_class", +"display_name": "护甲锻造", +"flat_value": 1, +"base_price": 10, +"price_ratio_pct": 150 +}] +boss_keystone = [{ +"level_index": 1, +"first_kill": 5, +"repeat_kill": 1 +}, { +"level_index": 2, +"first_kill": 8, +"repeat_kill": 2 +}, { +"level_index": 3, +"first_kill": 12, +"repeat_kill": 3 +}] +workshop_items = [{ +"item_id": "probe_dust", +"display_name": "显影尘", +"clear_threshold": 1 +}, { +"item_id": "sapper_order", +"display_name": "工兵令", +"clear_threshold": 1 +}, { +"item_id": "loot_compass", +"display_name": "探宝罗盘", +"clear_threshold": 2 +}, { +"item_id": "nest_pendulum", +"display_name": "探巢摆钟", +"clear_threshold": 2 +}, { +"item_id": "catacomb_scroll", +"display_name": "地穴全图卷", +"clear_threshold": 3 +}, { +"item_id": "blast_kit", +"display_name": "爆破工兵包", +"clear_threshold": 3 +}] +conversion = [{ +"attr": "max_hp", +"per_level_shift_pct": 0 +}, { +"attr": "atk", +"per_level_shift_pct": 0 +}, { +"attr": "armor_class", +"per_level_shift_pct": 0 +}] + +; 元进度实现批（2026-09-21，设计权威 design/gdd/systems/冒险循环/元进度.md 定稿 v1.2）： +; 数值全 provisional 归元进度设计批配读数（骨架先行——元进度实现批 2026-09-21，先例 = GP+商店房批）。 +; forge flat 档与 GP 商店同族（血+3/攻+1/甲+1），base 10 / ratio 150 三行同；boss 两档 L1 5/1 · L2 8/2 · L3 12/3 +; （首杀全量、重复杀固定小额恒定不递减）；工坊六件阈值 1/1/2/2/3/3 按总通关次数（首版只挂通关次数渠道， +; 钥石直购价随定价批后补）；conversion 全 0 = 未标定占位（标定归设计批，护甲行强条目：验收读数必须按 +; 解锁后参数重测）。 diff --git a/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd b/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd index b1162fe7..2cda8779 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd @@ -98,6 +98,7 @@ func _run_core_smoke(db, rng) -> void: _smoke_shop_room() _smoke_shop_graph() _smoke_nine_types_gp_stream() + _smoke_meta() # ---- 战斗屏棋盘布局·格边长公式回归（2026-09-19 真人试玩 bug⑥：L2 12×12 板下缘被裁约 1/6 格高—— @@ -2820,6 +2821,27 @@ func _smoke_nine_types_gp_stream() -> void: check(rng.counter("gp_drop") == 0, "derive_at 纯函数不推计数器（gp_drop 流计数器恒 0）") +# ---- 元进度·MetaTable 表结构（元进度实现批 T1——行值全 provisional 归元进度设计批配读数； +# 注入契约三字段必齐 = forge/conversion 覆盖恰三，Boss 两档 first ≥ repeat）---- +func _smoke_meta() -> void: + print("--- 元进度·MetaTable 表结构 ---") + var meta_tbl = _db.meta + check(meta_tbl != null and meta_tbl.validate().is_empty(), + "MetaTable 非空 + validate 零错（四行族词表封闭/唯一/连续/域界/first≥repeat/ratio 全过）") + check(meta_tbl.forge_products.size() == 3 and meta_tbl.boss_keystone.size() == 3 + and meta_tbl.workshop_items.size() == 6 and meta_tbl.conversion.size() == 3, + "MetaTable 四行族规模 3/3/6/3（forge/Boss/换算恰三 · 工坊恰六）") + var attrs_ok := true + for a in ["max_hp", "atk", "armor_class"]: + attrs_ok = attrs_ok and not _db.meta_forge_row(a).is_empty() and not _db.meta_conversion_row(a).is_empty() + check(attrs_ok, "forge/conversion attr 词表封闭恰全（注入契约三字段齐——meta_* 访问器可达）") + var boss_ok := true + for li in [1, 2, 3]: + var brow: Dictionary = _db.meta_boss_keystone_row(li) + boss_ok = boss_ok and not brow.is_empty() and int(brow.get("first_kill", 0)) >= int(brow.get("repeat_kill", -1)) + check(boss_ok, "boss_keystone L1–L3 行连续可达且 first_kill ≥ repeat_kill 全行（首杀全量/重复小额）") + + # ---- 战斗日志视图·行格式化呈现层同步闸（2026-09-20 真人试玩卡断 bug 回归：八型批伏击退役拆除 # 伤害行 attach 字段后本视图拆行分支漏网未同步——敌方首笔攻击行带 baseline 无 attach， # _format_row Invalid access 使结算段中途夭折、界面卡死。行协议变更必须同步呈现层〔战斗结算 §行协议〕， From 2e419a17a345b2d79c4c85b32fda6086ed0c26a8 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 21 Sep 2026 15:03:50 +0800 Subject: [PATCH 2/4] =?UTF-8?q?feat(content):=20=E5=85=83=E8=BF=9B?= =?UTF-8?q?=E5=BA=A6=E5=AE=9E=E7=8E=B0=E6=89=B9=20T2=E2=80=93T4=E2=80=94?= =?UTF-8?q?=E2=80=94MetaProgression=20=E8=B4=A6=E6=9C=AC=E6=9C=8D=E5=8A=A1?= =?UTF-8?q?+SaveManager=20=E4=B8=A4=E6=A1=A3=E5=85=A5=E8=B4=A6=E7=AC=AC?= =?UTF-8?q?=E4=BA=8C=E5=8F=82+=E6=B3=A8=E5=85=A5=E9=80=9A=E9=81=93?= =?UTF-8?q?=EF=BC=88adventure/level=20runner=20base=5Foverride=EF=BC=89+?= =?UTF-8?q?=E8=90=A5=E5=9C=B0=E8=A6=86=E7=9B=96=E5=B1=82/=E5=85=A5?= =?UTF-8?q?=E5=8F=A3/=E9=A1=B6=E6=A0=8F/=E7=BB=93=E7=AE=97=E6=98=8E?= =?UTF-8?q?=E7=BB=86=EF=BC=88=E5=86=92=E7=83=9F=20522=20=E7=BB=BF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../core/adventure_runner.gd | 27 ++- .../core/level_runner.gd | 20 +- .../core/meta_progression.gd | 138 ++++++++++++ .../core/meta_progression.gd.uid | 1 + .../core/save_manager.gd | 14 +- .../presentation/battle_narrator.gd | 17 ++ .../presentation/hud_presenter.gd | 6 +- .../presentation/main.gd | 100 +++++++-- .../presentation/ui_assembler.gd | 14 +- .../presentation/views/camp_overlay_view.gd | 197 ++++++++++++++++++ .../views/camp_overlay_view.gd.uid | 1 + 11 files changed, 501 insertions(+), 34 deletions(-) create mode 100644 prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd create mode 100644 prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd.uid create mode 100644 prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd create mode 100644 prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd.uid diff --git a/prototypes/dungeon-sweeper-vertical-slice/core/adventure_runner.gd b/prototypes/dungeon-sweeper-vertical-slice/core/adventure_runner.gd index f24f72d3..7884339a 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/core/adventure_runner.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/core/adventure_runner.gd @@ -55,6 +55,7 @@ var summary := {} # 最近一次结算的冒险摘要（ var _runner: LevelRunner # 当前关卡行进器（每关新建——关卡域状态天然隔离） var _pending_next_level := false # 大奖励已兑付、等 continue_to_next_level 确认 var _override := [0, 0] # TunePanel 百分比通道 [atk_pct, hp_pct]（每关新 runner 都要应用） +var _base_override := {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat 注入（元进度实现批——冒险开始参数面 params.hero_override 存入，共享给 LevelRunner；全零 = 白板） func _init(db_ref, rng_ref) -> void: @@ -65,8 +66,10 @@ func _init(db_ref, rng_ref) -> void: # ---- 冒险生命周期 ---- # 冒险开始（主种子注入恰一次——全冒险唯一 rng.new_adventure 调用点；重开 = 全新一轮： -# 账本/加算区/已购档/钥石/摘要全重置，生命置满基础上限，从第 1 关起步） -func start_adventure(seed_val: int) -> bool: +# 账本/加算区/已购档/钥石/摘要全重置，生命置满基础上限，从第 1 关起步）。 +# params.hero_override = 永久强化 flat 注入（元进度实现批——缺省 {} = 全零白板，与 B1 空参数路径逐位一致； +# -1/缺键 = 表值兜底口径，规范化为 0 flat） +func start_adventure(seed_val: int, params: Dictionary = {}) -> bool: if state != "idle": push_error("[冒险结构] start_adventure 拒绝——state=%s（重开须待上一局结算完毕）" % state) return false @@ -80,11 +83,20 @@ func start_adventure(seed_val: int) -> bool: levels_total = db.level.rows.size() level_index = 1 _pending_next_level = false - ledger["hero_hp"] = int(db.hero.max_hp) # 生命账本置满（基础上限读英雄表——加算区刚归零） + _base_override = _normalize_override(params.get("hero_override", {})) + ledger["hero_hp"] = int(db.hero.max_hp) + int(_base_override["max_hp"]) # 生命账本置满（表值+永久强化 flat——加算区刚归零） state = "running" return _start_current_level() +# 注入参数规范化：三字段缺键/-1 = 表值兜底（→ 0 flat）；负值一律 clamp 0（白板 = 全零合法态） +func _normalize_override(raw: Dictionary) -> Dictionary: + var out := {"atk": 0, "max_hp": 0, "armor_class": 0} + for k in out.keys(): + out[k] = maxi(0, int(raw.get(k, 0))) + return out + + # TunePanel 百分比通道（测试面板覆盖——每关新 runner 都要应用；正式侧归元进度） func set_hero_override(atk_pct: int, hp_pct: int) -> void: _override = [atk_pct, hp_pct] @@ -139,9 +151,10 @@ func _start_current_level() -> bool: _runner.wallet_changed.connect(_forward_wallet_changed) _runner.level_finished.connect(_on_level_finished) _runner.set_hero_override(int(_override[0]), int(_override[1])) - # 接口①开始关卡：生命经共享账本交接（账本当前值即开局生命——冒险开始置满 / 大奖励回满已写好） + # 接口①开始关卡：生命经共享账本交接（账本当前值即开局生命——冒险开始置满 / 大奖励回满已写好）； + # _base_override 共享引用随载荷传入（永久强化 flat——LevelRunner.effective_* 叠加序第二项） var ok: bool = _runner.start_level_external(level_index, ledger, bonus, purchased, - Callable(self, "apply_rest")) + Callable(self, "apply_rest"), _base_override) if ok: level_started.emit(level_index, String(_runner.level_row.get("display_name", ""))) return ok @@ -164,14 +177,14 @@ func _on_level_finished(payload: Dictionary) -> void: # 大奖励（非末关通关恰一次）：上限提升写加算区 → 血回满 = 新上限 → 钥石入账（顺序即契约） var hp_bonus: int = int(db.adventure.level_clear_hp_bonus) bonus["max_hp"] = int(bonus.get("max_hp", 0)) + hp_bonus - ledger["hero_hp"] = int(db.hero.max_hp) + int(bonus["max_hp"]) + ledger["hero_hp"] = int(db.hero.max_hp) + int(_base_override["max_hp"]) + int(bonus["max_hp"]) keystone += int(db.adventure.keystone_per_level) # 置位先于 emit（信号同步派发——处理器内立即确认时 _pending_next_level 必须已就位） _pending_next_level = true big_reward_paid.emit({ "from_level": level_index, "hp_bonus": hp_bonus, - "new_max_hp": int(db.hero.max_hp) + int(bonus["max_hp"]), + "new_max_hp": int(db.hero.max_hp) + int(_base_override["max_hp"]) + int(bonus["max_hp"]), "keystone_gained": int(db.adventure.keystone_per_level), "keystone_total": keystone, }) diff --git a/prototypes/dungeon-sweeper-vertical-slice/core/level_runner.gd b/prototypes/dungeon-sweeper-vertical-slice/core/level_runner.gd index 59217cb2..fded57b6 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/core/level_runner.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/core/level_runner.gd @@ -58,6 +58,7 @@ var gp: int: # GP 冒险钱包（局内货币— get: return int(_ledger["gp"]) set(v): _ledger["gp"] = v var bonus := {"atk": 0, "max_hp": 0, "armor_class": 0} # 统一冒险加算区（冒险开始全 0）——商店购买与关卡大奖励写同一本账（冒险模式 = AdventureRunner 共享字典；大奖励接线归 AdventureRunner._on_level_finished） +var base_override := {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat 注入（元进度实现批——冒险模式 = AdventureRunner 共享字典经 start_level_external 注入；单关测试模式 = 私有全零） var _shop_purchased := {} # product_id → 已购档数（现价重算输入；冒险开始清零） # 协作对象私有（E1/E3 封装收口 2026-09-13）：settlement 读取经 current_battle() 成文出口 var _settlement = null # 当前战斗编排器（关卡结束置 null） @@ -84,21 +85,21 @@ func set_hero_override(atk_pct: int, hp_pct: int) -> void: hero_hp_pct = hp_pct -# 叠加次序（GP+商店房实施批）：基础表值 + 加算区（商店/大奖励 flat 先加）→ TunePanel 百分比后乘 -# （调整板 = 测试工具按现状保持——百分比恒乘在加算生效值上） +# 叠加次序（元进度实现批钉死）：表值 → 永久强化 flat（base_override）→ 加算区 flat（bonus）先加 +# → TunePanel 百分比后乘（调整板 = 测试工具恒乘最后——代拍板 6，与 GP 批既有次序兼容） func effective_atk() -> int: - var base: int = int(db.hero.atk) + int(bonus.get("atk", 0)) + var base: int = int(db.hero.atk) + int(base_override.get("atk", 0)) + int(bonus.get("atk", 0)) return maxi(1, int(round(float(base) * (100.0 + float(hero_atk_pct)) / 100.0))) func effective_max_hp() -> int: - var base: int = int(db.hero.max_hp) + int(bonus.get("max_hp", 0)) + var base: int = int(db.hero.max_hp) + int(base_override.get("max_hp", 0)) + int(bonus.get("max_hp", 0)) return maxi(1, int(round(float(base) * (100.0 + float(hero_hp_pct)) / 100.0))) -# 护甲等级生效值（加算区 armor_class 轴——无 TunePanel 百分比通道，纯 flat） +# 护甲等级生效值（永久强化 flat + 加算区 armor_class 轴——无 TunePanel 百分比通道，纯 flat） func effective_ac() -> int: - return maxi(0, int(db.hero.armor_class) + int(bonus.get("armor_class", 0))) + return maxi(0, int(db.hero.armor_class) + int(base_override.get("armor_class", 0)) + int(bonus.get("armor_class", 0))) # 覆盖复位（关卡结束归零——表值不可变，仅清百分比；调用方兼容保留） @@ -128,6 +129,7 @@ func start_level(level_index: int, seed_val: int) -> bool: _graph_mode = false gp = 0 # 冒险钱包清零开局（GP+商店房实施批——局内货币生命周期起点） bonus = {"atk": 0, "max_hp": 0, "armor_class": 0} # 加算区冒险开始全 0 + base_override = {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat 单关测试模式恒全零（白板——单关入口零元进度） _shop_purchased = {} # 已购档数清零（跨冒险不延续——递增定价按冒险内累计） for node in nodes(): if node.has("next"): @@ -146,11 +148,12 @@ func start_level(level_index: int, seed_val: int) -> bool: # 冒险结构接口①：开始关卡（载荷 = 关卡序号 + 当前生命 + 生效上限——生命经共享账本交接； # 种子域归冒险结构：本路径不重播种；账本归冒险结构：本路径不重置 gp/bonus/_shop_purchased， -# 也不重置 hero_hp——账本当前值即开局生命，AdventureRunner 已在 ledger 写好） +# 也不重置 hero_hp——账本当前值即开局生命，AdventureRunner 已在 ledger 写好）。 +# base_override = 永久强化 flat 共享引用（元进度实现批——缺省 {} 全零白板，与 B1 空参数路径逐位一致）。 # 流程与 start_level 同款（_find_level_row → 状态初始化 → _graph_mode 探测 → _enter_node(entry)）， # 差异仅在账本/加算区/已购档/恢复执行体的注入与零重置。 func start_level_external(level_index: int, ledger: Dictionary, bonus_ref: Dictionary, - purchased_ref: Dictionary, rest_handler: Callable) -> bool: + purchased_ref: Dictionary, rest_handler: Callable, base_override_ref: Dictionary = {}) -> bool: var row := _find_level_row(level_index) if row.is_empty(): push_error("[关卡节点地图] level_index %d 在 LevelTable 无行" % level_index) @@ -158,6 +161,7 @@ func start_level_external(level_index: int, ledger: Dictionary, bonus_ref: Dicti _external = true _ledger = ledger bonus = bonus_ref + base_override = base_override_ref _shop_purchased = purchased_ref _rest_handler = rest_handler level_row = row diff --git a/prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd b/prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd new file mode 100644 index 00000000..363581b8 --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd @@ -0,0 +1,138 @@ +# VERTICAL SLICE - NOT FOR PRODUCTION +# Validation Question: 钥石能否在营地换成永久强化并在下一局开局生效——冒险收束入账（大奖励 + Boss +# 首杀/重复杀两档）、营地消费、注入计算的跨局账本能否在零 UI 下独立成立（元进度 GDD 验收标准） +# Date: 2026-09-21（元进度实现批——设计权威 design/gdd/systems/冒险循环/元进度.md 定稿 v1.2） +# 元进度账本服务（Core 层零 UI、纯被动服务——同 StatusContainer 先例：零信号零外发，读存档算账）。 +# 职责三件：① 属性锻造定价与购买（几何递增——tier 级价格 = 迭代 floor(p × ratio/100)，tier 0 = +# base_price，floor 单一取整对齐 round_direction 纪律）；② 道具工坊解锁（首版只挂总通关次数渠道—— +# Σ level_clear_counts 达标，代拍板 2；六件局内效果归 Alpha 魔法道具重设计批，本类只有解锁状态）； +# ③ 冒险收束入账（Boss 两档 = 表值 first_kill/repeat_kill，首杀标记读存档判first；调 SaveManager +# apply_adventure_summary 入账并附 boss_drops 副本——复盘可归因，验收 5）。 +# 注入面：hero_override() = 三档 forge flat（全零 = 白板合法态；override 不写表——表运行期只读， +# 消费方 AdventureRunner/LevelRunner 经冒险开始参数面显式传参）。 +# 纪律：数值零字面量——价格/档位/阈值/两档金额只读 db.meta_* 访问器；存档只经 SaveManager 访问器， +# 禁读内部结构；行集解析禁自扫表（一律走 ConfigDB 访问器）。 +class_name MetaProgression +extends RefCounted + +var db +var save + + +func _init(db_ref, save_ref) -> void: + db = db_ref + save = save_ref + + +func keystone_balance() -> int: + return save.keystone_balance() + + +# ---- 属性锻造（钥石直购、可重复升级——几何递增定价）---- + +func forge_level(attr: String) -> int: + return save.forge_level(attr) + + +# 每级强化 flat 值 × 当前级（注入面的算料——投值语言锁定 flat 整数） +func forge_flat(attr: String) -> int: + return forge_level(attr) * int(db.meta_forge_row(attr).get("flat_value", 0)) + + +# 下一级价格：tier = 当前级，迭代 floor(p × ratio/100) 恰 tier 次（tier 0 = base_price） +func forge_price(attr: String) -> int: + var row: Dictionary = db.meta_forge_row(attr) + if row.is_empty(): + return 0 + var p := int(row.get("base_price", 0)) + var ratio := int(row.get("price_ratio_pct", 100)) + for _i in forge_level(attr): + p = int(floor(float(p) * float(ratio) / 100.0)) + return p + + +# 购买：余额不足 / attr 出域 false 零副作用；成功 = 消费 + 升级 + 写盘 +func buy_forge(attr: String) -> bool: + if db.meta_forge_row(attr).is_empty(): + return false + if not save.spend_keystone(forge_price(attr)): + return false + if not save.set_forge_level(attr, forge_level(attr) + 1): + return false + return save.write_to_disk() + + +# ---- 道具工坊（首版全走通关次数渠道——钥石直购价随定价批后补，最终双渠道并存）---- + +# 总通关次数 = Σ level_clear_counts（工坊解锁判定量——代拍板 2） +func _total_clears() -> int: + var total := 0 + for i in db.level.rows.size(): + total += save.clear_count(i + 1) + return total + + +# 工坊六行只读投影（呈现层数据源）：{item_id, display_name, threshold, unlocked, progress} +func workshop_status() -> Array: + var total := _total_clears() + var out: Array = [] + for row in db.meta_workshop_items(): + var iid := String(row.get("item_id", "")) + out.append({ + "item_id": iid, + "display_name": String(row.get("display_name", "")), + "threshold": int(row.get("clear_threshold", 0)), + "unlocked": save.item_unlocked(iid), + "progress": total, + }) + return out + + +# 达标未解锁 → unlock_item + 写盘；返回新解锁 item_id 列（冒险收束后与营地打开时各调一次） +func refresh_workshop_unlocks() -> Array: + var new_unlocks: Array = [] + var total := _total_clears() + for row in db.meta_workshop_items(): + var iid := String(row.get("item_id", "")) + if save.item_unlocked(iid): + continue + if total >= int(row.get("clear_threshold", 99)): + save.unlock_item(iid) + new_unlocks.append(iid) + if not new_unlocks.is_empty(): + save.write_to_disk() + return new_unlocks + + +# ---- Boss 两档与收束入账（结算屏文案数据源）---- +# 明细 {big_reward, boss_drops: [{level, first, amount}], total, new_unlocks}； +# 入账与标记经 save.apply_adventure_summary（boss_drops 副本随摘要入 recent_summaries）。 +func settle_adventure(summary: Dictionary) -> Dictionary: + var drops: Array = [] + for li in range(1, int(summary.get("levels_cleared", 0)) + 1): + var first: bool = not save.boss_first_kill_marked(li) + var row: Dictionary = db.meta_boss_keystone_row(li) + var amount: int = int(row.get("first_kill", 0)) if first else int(row.get("repeat_kill", 0)) + drops.append({"level": li, "first": first, "amount": amount}) + save.apply_adventure_summary(summary, drops) + var new_unlocks := refresh_workshop_unlocks() + save.write_to_disk() + var total := int(summary.get("keystone_total", 0)) + for d in drops: + total += int(d["amount"]) + return { + "big_reward": int(summary.get("keystone_total", 0)), + "boss_drops": drops, + "total": total, + "new_unlocks": new_unlocks, + } + + +# ---- 跨局注入（冒险开始参数面——字段清单随柜台扩展，现 = 属性锻造三档）---- +# 全零 = 白板合法态（无解锁不得改变任何局内规则）；override 禁写表（表运行期只读）。 +func hero_override() -> Dictionary: + return { + "atk": forge_flat("atk"), + "max_hp": forge_flat("max_hp"), + "armor_class": forge_flat("armor_class"), + } diff --git a/prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd.uid b/prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd.uid new file mode 100644 index 00000000..0dbb76a0 --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/core/meta_progression.gd.uid @@ -0,0 +1 @@ +uid://b22wboiq6n3ra diff --git a/prototypes/dungeon-sweeper-vertical-slice/core/save_manager.gd b/prototypes/dungeon-sweeper-vertical-slice/core/save_manager.gd index 59775b4e..f246dfd6 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/core/save_manager.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/core/save_manager.gd @@ -171,17 +171,23 @@ func recent_summaries() -> Array: # 域更新原语（正式冒险收束唯一入账口——组合根经本函数入账，禁直改内部结构）： -# 钥石入账 + 逐通关关次 clear_count +1 与 Boss 首杀标记 + 摘要头部插入（cap 10，最新在前）。 -# 本批不含 Boss 金额（首杀全量/重复杀小额归元进度批——届时增第二参 boss_drops，默认 [] 零行为兼容）。 -func apply_adventure_summary(summary: Dictionary) -> void: +# 钥石入账（summary.keystone_total + boss_drops 逐笔 amount）+ 逐通关关次 clear_count +1 与 +# Boss 首杀标记 + 摘要头部插入（cap 10，最新在前，元素附 boss_drops 副本——复盘可归因）。 +# boss_drops 归元进度批消费（两档金额读 meta 表——MetaProgression.settle_adventure 组装； +# 缺省 [] 零行为兼容——调用方不带两档时入账面与批前逐位一致）。 +func apply_adventure_summary(summary: Dictionary, boss_drops: Array = []) -> void: add_keystone(int(summary.get("keystone_total", 0))) + for drop in boss_drops: + add_keystone(int(drop.get("amount", 0))) var cleared := int(summary.get("levels_cleared", 0)) for li in range(1, cleared + 1): var key := str(li) _data["meta"]["level_clear_counts"][key] = int(_data["meta"]["level_clear_counts"].get(key, 0)) + 1 _data["meta"]["boss_first_kill"][key] = true + var entry: Dictionary = summary.duplicate(true) + entry["boss_drops"] = boss_drops.duplicate(true) var arr: Array = _data["meta"]["recent_summaries"] - arr.push_front(summary.duplicate(true)) + arr.push_front(entry) while arr.size() > SUMMARY_CAP: arr.pop_back() diff --git a/prototypes/dungeon-sweeper-vertical-slice/presentation/battle_narrator.gd b/prototypes/dungeon-sweeper-vertical-slice/presentation/battle_narrator.gd index c5ee3dc2..d39b75d6 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/presentation/battle_narrator.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/presentation/battle_narrator.gd @@ -102,3 +102,20 @@ static func adventure_summary_text(summary: Dictionary) -> String: return "%s\n通关 %d 关 · 止步第 %d 层 · 钥石合计 %d · 主种子 %d" % [ verdict, int(summary.get("levels_cleared", 0)), int(summary.get("stopped_at", 0)), int(summary.get("keystone_total", 0)), int(summary.get("master_seed", 0))] + + +# 钥石入账明细文案（元进度实现批——settle_adventure 明细的结算屏追加段：大奖励 / 逐关 Boss +# 首杀或重复两档 / 新解锁道具；name_lookup = item_id → 显示名投影，由组合根自 meta 表喂入） +static func keystone_settle_text(detail: Dictionary, name_lookup: Dictionary = {}) -> String: + var parts: Array = ["大奖励 +%d" % int(detail.get("big_reward", 0))] + for d in detail.get("boss_drops", []): + parts.append("第 %d 关 Boss %s +%d" % [int(d.get("level", 0)), + "首杀" if bool(d.get("first", false)) else "重复杀", int(d.get("amount", 0))]) + var line := "钥石入账：" + " · ".join(parts) + var unlocks: Array = detail.get("new_unlocks", []) + if not unlocks.is_empty(): + var names: Array = [] + for iid in unlocks: + names.append(String(name_lookup.get(String(iid), String(iid)))) + line += "\n工坊新解锁：" + "、".join(names) + return line + "\n本局入账合计 +%d 钥石" % int(detail.get("total", 0)) diff --git a/prototypes/dungeon-sweeper-vertical-slice/presentation/hud_presenter.gd b/prototypes/dungeon-sweeper-vertical-slice/presentation/hud_presenter.gd index 4e10c09a..b8c104cc 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/presentation/hud_presenter.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/presentation/hud_presenter.gd @@ -16,10 +16,14 @@ extends RefCounted # 每次结算行/轮次/节点变化/动作返回后调用（组合根全量重查装配） static func refresh(stage: BattleStageView, info: HeroInfoPanelView, ap_bar: ApBarView, - settlement, runner, level_active: bool, db, refresh_remaining: int, gp_label: Label = null) -> void: + settlement, runner, level_active: bool, db, refresh_remaining: int, gp_label: Label = null, + keystone_label: Label = null, keystone_balance: int = 0) -> void: # GP 余额常驻（GP+商店房实施批 2026-09-21——A 区顶栏邻接位；runner 缺位 = 非冒险态按 0 读数） if gp_label != null: gp_label.text = "金币 %d" % (int(runner.gp) if runner != null else 0) + # 钥石余额常驻（元进度实现批 2026-09-21——A 区顶栏邻接位；数据源 MetaProgression 账本，购买/收束后随全量重查刷新） + if keystone_label != null: + keystone_label.text = "钥石 %d" % keystone_balance if settlement == null: _refresh_out_of_battle(stage, info, runner, level_active, db) return diff --git a/prototypes/dungeon-sweeper-vertical-slice/presentation/main.gd b/prototypes/dungeon-sweeper-vertical-slice/presentation/main.gd index 2df53ddd..de67f9f7 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/presentation/main.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/presentation/main.gd @@ -27,12 +27,14 @@ const ModalStack := preload("res://presentation/modal_stack.gd") const TuneSimController := preload("res://presentation/tune_sim_controller.gd") const DebugSessionScript := preload("res://presentation/debug_session.gd") const SaveManagerScript := preload("res://core/save_manager.gd") # 存档承载（preload 避开全局类缓存时序——与 DebugSessionScript 同款） +const MetaProgressionScript := preload("res://core/meta_progression.gd") # 元进度账本服务（元进度实现批——同 preload 纪律） var db var settlement = null # 当前战斗编排器（关卡与调试模式统一读它） var runner = null # 关卡节点地图 图版推进器（完整关卡模式；冒险模式 = 每关重取 adventure.runner()） var adventure = null # 冒险结构编排器（冒险结构实现批——三关连探；转发信号照 runner 接线原样对接） var save_manager = null # 存档序列化承载（存档序列化批——启动读盘/冒险收束写盘；只经访问器与 apply 原语，禁读内部结构） +var meta = null # 元进度账本服务（元进度实现批——余额/定价/购买/工坊解锁/Boss两档入账/注入计算；零信号纯被动） var _adventure_mode := false # 冒险模式标记（inter 层确认分派与终局分派） var logger = null # 试玩日志器（JSONL 持久化 + 卡死诊断转储——呈现层组件） var _level_active := false @@ -56,11 +58,13 @@ var board_view: BoardView # 探针兼容别名（= board_zone.bo var ap_bar: ApBarView # 探针兼容别名（= board_zone.ap_bar） var settlement_fx: SettlementFxView # 结算演出覆盖层（跨区弹道/光带——A–D 之上、模态之下） var gp_label: Label # A 区顶栏 GP 余额常驻位（GP+商店房实施批——文案装配归 HudPresenter） +var keystone_label: Label # A 区顶栏钥石余额常驻位（元进度实现批——文案装配归 HudPresenter） # 模态 overlay（z 序 = 登记序；pattern 6 层级纪律） var legend_overlay: LegendOverlay var review_overlay: SettlementReviewOverlay var node_overlay: NodeOverlay var shop_overlay: ShopOverlay # 商店覆盖层（GP+商店房实施批——商店房节点兑付呈现） +var camp_overlay: CampOverlay # 营地覆盖层（元进度实现批——主菜单营地入口兑付呈现） var tune_panel: TunePanel var _modals = null # 模态层级状态机（modal_stack.gd——缺陷⑤纪律载体） @@ -82,6 +86,8 @@ func _ready() -> void: # （fatal 只留给数值表——fail-fast 边界在表加载，不在档）；高版本拒读态后续写盘被类内拒绝。 save_manager = SaveManagerScript.new() save_manager.load_from_disk() + # 元进度账本（元进度实现批）：存档就绪后建——余额/定价/购买/入账/注入全经此单点 + meta = MetaProgressionScript.new(db, save_manager) _debug = DebugSessionScript.new(db, get_node("/root/RngService"), Callable(self, "_debug_hero_override"), Callable(self, "_seed_value")) _debug.battle_created.connect(_on_debug_battle_created) @@ -98,6 +104,7 @@ func _build_ui() -> void: var battle_ui: Dictionary = UiAssembler.build_battle_ui(root, db) strip_view = battle_ui.strip_view gp_label = battle_ui.gp_label + keystone_label = battle_ui.keystone_label stage = battle_ui.stage log_view = battle_ui.log_view info_panel = battle_ui.info_panel @@ -128,6 +135,7 @@ func _build_ui() -> void: node_overlay = overlays.node_overlay _end_overlay = overlays.end_overlay shop_overlay = overlays.shop_overlay + camp_overlay = overlays.camp_overlay tune_panel = overlays.tune_panel route_overlay = RouteOverlay.new() add_child(route_overlay) @@ -140,13 +148,15 @@ func _build_ui() -> void: route_overlay.abandon_requested.connect(_on_abandon_requested) # 放弃入口（2026-09-21 用户拍板——台账 119） shop_overlay.buy_requested.connect(_on_shop_buy) shop_overlay.leave_pressed.connect(_on_shop_leave) + camp_overlay.buy_requested.connect(_on_camp_buy) + camp_overlay.closed.connect(_on_camp_closed) _end_overlay.review_pressed.connect(_on_end_review) _end_overlay.continue_pressed.connect(_on_battle_end_continue) tune_panel.closed.connect(_close_tune_panel) tune_panel.apply_requested.connect(_on_tune_apply) tune_panel.simulate_requested.connect(_on_tune_simulate) _modals = ModalStack.new() - for m: Control in [legend_overlay, review_overlay, node_overlay, route_overlay, _end_overlay, shop_overlay, tune_panel]: + for m: Control in [legend_overlay, review_overlay, node_overlay, route_overlay, _end_overlay, shop_overlay, camp_overlay, tune_panel]: _register_modal(m) _tune_sim = TuneSimController.new(db, tune_panel, int(db.hero.max_hp)) @@ -158,6 +168,7 @@ func _build_ui() -> void: start.lv3btn.pressed.connect(_start_full_level.bind(3)) start.tunebtn.pressed.connect(_show_tune_panel) start.dbgbtn.pressed.connect(_start_debug_levels) + start.campbtn.pressed.connect(_open_camp) var inter: Dictionary = UiAssembler.build_inter_overlay(self) _inter_overlay = inter.overlay @@ -258,7 +269,8 @@ func _start_adventure() -> void: var seed_val := _seed_value() logger.start_session(seed_val) adventure.set_hero_override(tune_panel.atk_pct(), tune_panel.hp_pct()) - if not adventure.start_adventure(seed_val): + # 永久强化注入（元进度实现批）：冒险开始参数面——meta 现算 override 显式传参（全零 = 白板） + if not adventure.start_adventure(seed_val, {"hero_override": meta.hero_override() if meta != null else {}}): _fatal_screen("冒险启动失败——见输出日志") return @@ -342,7 +354,7 @@ func _on_big_reward(reward: Dictionary) -> void: _refresh_presentations() -# 冒险结算（completed/failed/abandoned）：复用 BattleEndOverlay——摘要五件事进文案 +# 冒险结算（completed/failed/abandoned）：复用 BattleEndOverlay——摘要五件事 + 钥石入账明细进文案 func _on_adventure_finished(summary: Dictionary) -> void: _level_active = false var result: String = String(summary.get("result", "")) @@ -351,18 +363,19 @@ func _on_adventure_finished(summary: Dictionary) -> void: _sync_settlement_visuals() # → 全关 info_panel.set_status_cleared_feedback() # 状态槽全清可见反馈（增益状态×4④） stage.gray_all_enemies() # 死亡兜底：站桩灰化残位（禁瞬消语义的战斗收尾面） + # 存档入账（元进度实现批）：settle = Boss 两档入账 + 工坊解锁 + 摘要入档 + 写盘（唯一写档点不变—— + # 单关测试入口与调试两层不经过本处理器，天然不写档不污染生涯数据）。 + var detail: Dictionary = {} + if meta != null: + detail = meta.settle_adventure(summary) + var text := Narrator.adventure_summary_text(summary) + if not detail.is_empty(): + text += "\n" + Narrator.keystone_settle_text(detail, _item_name_lookup()) if result == "completed": - _end_overlay.open_victory(Narrator.adventure_summary_text(summary), - "返回冒险", board_view.get_global_rect()) + _end_overlay.open_victory(text, "返回冒险", board_view.get_global_rect()) else: - _end_overlay.open_defeat(Narrator.adventure_summary_text(summary), - "返回", board_view.get_global_rect()) + _end_overlay.open_defeat(text, "返回", board_view.get_global_rect()) logger.log_level_end(summary) # 试玩时间线：冒险终局（摘要随载荷） - # 存档入账（存档序列化批）：正式冒险收束唯一写档点——域更新原语 + 原子写盘。 - # 单关测试入口与调试两层不经过本处理器，天然不写档（契约：测试模式不污染生涯数据）。 - if save_manager != null: - save_manager.apply_adventure_summary(summary) - save_manager.write_to_disk() if runner != null: runner.restore_hero_base() strip_view.refresh(runner) @@ -370,6 +383,15 @@ func _on_adventure_finished(summary: Dictionary) -> void: _refresh_presentations() +# 工坊 item_id → 显示名投影（keystone_settle_text 文案数据源——装配归本根，拼句归 Narrator） +func _item_name_lookup() -> Dictionary: + var lookup := {} + if meta != null: + for row in db.meta_workshop_items(): + lookup[String(row.get("item_id", ""))] = String(row.get("display_name", "")) + return lookup + + func _on_battle_end_continue() -> void: # 终局出口：返回开始界面（冒险摘要留档试玩日志；钥石已在收束时入存档——存档序列化批） _close_modal(_end_overlay) @@ -622,6 +644,57 @@ func _on_abandon_requested() -> void: board_zone.toast.show_toast("战斗进行中——无法放弃", "warn") +# ---- 营地覆盖层与钥石账本（元进度实现批——写调用唯一归组合根）---- + +# 打开营地（主菜单入口——开合与开始层互斥仿 TunePanel 先例：开始覆盖层非模态且树序在后， +# 规范 2.3 遮挡纪律；打开时先刷工坊解锁——达标未解锁就地入账） +func _open_camp() -> void: + if meta == null: + return + meta.refresh_workshop_unlocks() + _start_overlay.visible = false + camp_overlay.open_camp(_camp_data()) + _refresh_presentations() + + +func _on_camp_closed() -> void: + camp_overlay.visible = false + _start_overlay.visible = true + _refresh_presentations() # 关闭后刷新顶栏（工坊解锁可能变了余额侧读数面） + + +# 营地快照投影（纯读——锻造三行/工坊六行/余额/最近冒险；拼句归 CampOverlay，账面归 MetaProgression） +func _camp_data() -> Dictionary: + var forge_rows: Array = [] + if meta != null: + for attr in MetaTable.FORGE_ATTRS: + var row: Dictionary = db.meta_forge_row(attr) + forge_rows.append({ + "attr": attr, + "display_name": String(row.get("display_name", "")), + "level": meta.forge_level(attr), + "flat": int(row.get("flat_value", 0)), + "price": meta.forge_price(attr), + }) + return { + "balance": meta.keystone_balance() if meta != null else 0, + "forge": forge_rows, + "workshop": meta.workshop_status() if meta != null else [], + "recent": save_manager.recent_summaries() if save_manager != null else [], + } + + +func _on_camp_buy(attr: String) -> void: + if meta == null: + return + if not meta.buy_forge(attr): + # 余额不足（按钮禁用为常态防线——兜底拒绝可见，pattern 1） + board_zone.toast.show_toast("钥石不足——买不起这件强化", "warn") + return + camp_overlay.refresh_camp(_camp_data()) + _refresh_presentations() + + # ---- 商店覆盖层与 GP 钱包（GP+商店房实施批——写调用唯一归组合根）---- func _on_shop_buy(product_id: String) -> void: @@ -728,7 +801,8 @@ func _handle_outcome_feedback(outcome: Dictionary) -> void: func _refresh_presentations() -> void: # 每个核心信号/写调用返回后的全量重查装配（更新触发注记——无推送信号，命令式重查） var refresh_remaining: int = maxi(0, int(db.action_economy.refresh_cap_per_round) - _refresh_used_round) - HudPresenter.refresh(stage, info_panel, ap_bar, settlement, runner, _level_active, db, refresh_remaining, gp_label) + HudPresenter.refresh(stage, info_panel, ap_bar, settlement, runner, _level_active, db, refresh_remaining, + gp_label, keystone_label, meta.keystone_balance() if meta != null else 0) _sync_settlement_visuals() diff --git a/prototypes/dungeon-sweeper-vertical-slice/presentation/ui_assembler.gd b/prototypes/dungeon-sweeper-vertical-slice/presentation/ui_assembler.gd index 287581b0..7a827e03 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/presentation/ui_assembler.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/presentation/ui_assembler.gd @@ -31,6 +31,9 @@ static func build_battle_ui(root: Control, db) -> Dictionary: var gp_label := UiKit.label("金币 0", 15, true) gp_label.add_theme_color_override("font_color", UiKit.GOLD_DEEP) strip_row.add_child(gp_label) + var keystone_label := UiKit.label("钥石 0", 15, true) # 元进度实现批——A 区顶栏钥石余额常驻（文案装配归 HudPresenter，此处只建节点） + keystone_label.add_theme_color_override("font_color", UiKit.GOLD) + strip_row.add_child(keystone_label) # B 区：战斗画面（全宽 × 252px——常驻双舞台，布局决策 D1） var stage := BattleStageView.new(db) @@ -56,6 +59,7 @@ static func build_battle_ui(root: Control, db) -> Dictionary: return { "strip_view": strip_view, "gp_label": gp_label, + "keystone_label": keystone_label, "stage": stage, "log_view": stage.log_view, "info_panel": info_panel, @@ -85,6 +89,10 @@ static func build_overlays(host: Control, db, base_atk: int, base_hp: int) -> Di var shop_overlay := ShopOverlay.new() host.add_child(shop_overlay) + # 营地覆盖层（元进度实现批 2026-09-21——主菜单营地入口兑付呈现；开合仿 TunePanel 与开始层互斥） + var camp_overlay := CampOverlay.new() + host.add_child(camp_overlay) + var tune_panel := TunePanel.new(db, base_atk, base_hp) tune_panel.visible = false # 显式初始化——原版依赖"被不透明开始层遮蔽"的树序巧合（缺陷⑤家族）；模态锁输入以 visible 为准 host.add_child(tune_panel) @@ -95,6 +103,7 @@ static func build_overlays(host: Control, db, base_atk: int, base_hp: int) -> Di "node_overlay": node_overlay, "end_overlay": end_overlay, "shop_overlay": shop_overlay, + "camp_overlay": camp_overlay, "tune_panel": tune_panel, } @@ -131,6 +140,8 @@ static func build_start_overlay(host: Control, db = null) -> Dictionary: box.add_child(tunebtn) var dbgbtn := UiKit.button("调试 · 连续关卡两层（HP 关内延续）") box.add_child(dbgbtn) + var campbtn := UiKit.button("营地 · 永久强化（钥石换永久属性——跨局成长账本）") # 元进度实现批——主菜单营地入口（双入口框架的主菜单一侧） + box.add_child(campbtn) # 玩法帮助文案（表值驱动——2026-09-16 AP 压速批遗留硬编码 8 随手修正；护甲等级掷点批同步"减伤"→"护甲强化"） var help_text := "玩法：每轮 %d AP——挖开（1AP）/插旗（1AP）/移动（免费）/连锁（免费）。\n每个非封锁格都藏一种格面资源（增伤/护甲强化/回血/爆裂/削弱）。开安全格、标中雷 = 正向兑付；\n开雷格、标错安全格 = 负向兑付——全部在轮末结算逐行兑现；吃掷点的基础攻击按护甲等级判定，无 miss、最低保底 1 点。\n停手：剩余 AP 转存 RAP；弃图刷新：RAP−%d 当场换图继续挖（每轮剩 %d 次）。\n敌人全灭胜、主角倒下负。悬停可看三态光标与可挖域微光。" % [ @@ -140,7 +151,8 @@ static func build_start_overlay(host: Control, db = null) -> Dictionary: box.add_child(help) return {"overlay": overlay, "box": box, "seed_edit": seed_edit, - "lvbtn": lvbtn, "lv2btn": lv2btn, "lv3btn": lv3btn, "tunebtn": tunebtn, "dbgbtn": dbgbtn} + "lvbtn": lvbtn, "lv2btn": lv2btn, "lv3btn": lv3btn, "tunebtn": tunebtn, "dbgbtn": dbgbtn, + "campbtn": campbtn} # 调试两层模式的层间过渡覆盖层（历史入口专用）。返回 {overlay, label, next_btn}——接线归组合根 diff --git a/prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd b/prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd new file mode 100644 index 00000000..fcc4167a --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd @@ -0,0 +1,197 @@ +# VERTICAL SLICE - NOT FOR PRODUCTION +# Date: 2026-09-21（元进度实现批——营地覆盖层呈现） +# 营地覆盖层（模态）：标题「营地 · 永久强化」+ 钥石余额 / 柜台一「属性锻造」（三行可购——显示名 · +# 当前 Lv · 每级 +flat · 下级价格 · 购买按钮余额不足禁用）/ 柜台二「道具工坊」（六行——显示名 · +# 解锁条件 · 进度 · 状态；局内效果排 Alpha 魔法道具重设计批——代拍板 3，注记一行）/ 柜台三 +# 「奖励格图鉴」（占位锁定行——内容排 Alpha 地图战斗资源差异化批——代拍板 4）/「最近冒险」列表 +# （recent_summaries 投影：结果/通关数/钥石合计/种子）/ 关闭按钮。 +# 挂接方式：仿 ShopOverlay（dim + CenterContainer + box）；开合与开始层互斥仿 TunePanel 先例 +# （开始覆盖层非模态且树序在后——打开本层前由组合根隐藏开始层，规范 2.3 遮挡纪律）。 +# 高内聚边界：纯视图 setter 面——账本快照经组合根喂入（MetaProgression 只读投影），购买/关闭 +# 意图经信号外发——零核心写调用、零 MetaProgression 持有。视觉 = ui_kit 程序占位 +#（代拍板 8——视觉终稿以表现层样张过审为前置，归 HUD 协作批）。 +class_name CampOverlay +extends Control + +signal buy_requested(attr: String) +signal closed + +const ATTR_LABELS := {"atk": "攻击", "max_hp": "生命上限", "armor_class": "护甲"} # 档位文案轴（数据契约 attr 词表，与 ShopOverlay 同款） + +var _balance_label: Label +var _forge_holder: VBoxContainer +var _workshop_holder: VBoxContainer +var _forge_rows: Array = [] # [{attr, level_l, price_l, btn}]——refresh_camp 就地重刷（零重建回流） +var _workshop_rows: Array = [] # [{item_id, progress_l, status_l}] +var _recent_list: Label # 最近冒险（逐行拼接 label——只读账面，随 open_camp 重建） + + +func _init() -> void: + var dim := ColorRect.new() + dim.color = Color(0, 0, 0, 0.72) + dim.set_anchors_preset(Control.PRESET_FULL_RECT) + add_child(dim) + var center := CenterContainer.new() + center.set_anchors_preset(Control.PRESET_FULL_RECT) + dim.add_child(center) + var box := VBoxContainer.new() + box.add_theme_constant_override("separation", 6) + center.add_child(box) + var title := UiKit.label("营地 · 永久强化", 24, true) + title.add_theme_color_override("font_color", UiKit.WARM) + title.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER + box.add_child(title) + _balance_label = UiKit.label("钥石 0", 18, true) + _balance_label.add_theme_color_override("font_color", UiKit.GOLD) + _balance_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER + box.add_child(_balance_label) + box.add_child(HSeparator.new()) + + box.add_child(_counter_header("属性锻造（钥石直购 · 每级 flat 整数 · 价格几何递增）")) + _forge_holder = VBoxContainer.new() + _forge_holder.add_theme_constant_override("separation", 4) + box.add_child(_forge_holder) + + box.add_child(_counter_header("道具工坊（累计通关次数解锁 · 局内效果排 Alpha 魔法道具重设计批）")) + _workshop_holder = VBoxContainer.new() + _workshop_holder.add_theme_constant_override("separation", 4) + box.add_child(_workshop_holder) + + box.add_child(_counter_header("奖励格图鉴")) + var lock_l := UiKit.label("　—— 柜台结构位预留：内容排 Alpha（地图战斗资源差异化批）", 13, false) + lock_l.add_theme_color_override("font_color", UiKit.WARM_FAINT) + box.add_child(lock_l) + box.add_child(HSeparator.new()) + + box.add_child(_counter_header("最近冒险")) + var scroll := ScrollContainer.new() + scroll.custom_minimum_size = Vector2(560, 96) + scroll.horizontal_scroll_mode = ScrollContainer.SCROLL_MODE_DISABLED + box.add_child(scroll) + _recent_list = UiKit.label("", 13, false) + _recent_list.add_theme_color_override("font_color", UiKit.WARM_SOFT) + _recent_list.custom_minimum_size = Vector2(544, 0) + _recent_list.autowrap_mode = TextServer.AUTOWRAP_OFF + scroll.add_child(_recent_list) + + var close_btn := UiKit.button("关闭营地（回开始界面）") + close_btn.pressed.connect(func(): closed.emit()) + box.add_child(close_btn) + visible = false + + +func _counter_header(text: String) -> Label: + var l := UiKit.label(text, 15, true) + l.add_theme_color_override("font_color", UiKit.WARM_SOFT) + return l + + +# ---- 柜台行构建（open_camp 重建；行结构仿 ShopOverlay 商品卡）---- + +# 打开营地（全量重建三柜台行 + 最近冒险——数据 = 组合根 _camp_data() 投影） +func open_camp(data: Dictionary) -> void: + _rebuild_forge(data) + _rebuild_workshop(data) + _rebuild_recent(data) + refresh_camp(data) + visible = true + + +# 状态重刷（购买后调用——余额/价格/禁用态/工坊状态就地改文案，零重建） +func refresh_camp(data: Dictionary) -> void: + var balance := int(data.get("balance", 0)) + _balance_label.text = "钥石 %d" % balance + var forge_by_attr := {} + for row in data.get("forge", []): + forge_by_attr[String(row.get("attr", ""))] = row + for card in _forge_rows: + var row: Dictionary = forge_by_attr.get(String(card.attr), {}) + if row.is_empty(): + continue + card.level_l.text = "Lv %d" % int(row.get("level", 0)) + card.price_l.text = "下级价格 %d 钥石" % int(row.get("price", 0)) + card.btn.disabled = balance < int(row.get("price", 0)) # 余额不足禁用置灰 + var ws_by_id := {} + for row in data.get("workshop", []): + ws_by_id[String(row.get("item_id", ""))] = row + for card in _workshop_rows: + var row: Dictionary = ws_by_id.get(String(card.item_id), {}) + if row.is_empty(): + continue + var th := int(row.get("threshold", 0)) + var prog := int(row.get("progress", 0)) + var unlocked := bool(row.get("unlocked", false)) + card.progress_l.text = "累计通关 %d / %d 次" % [prog, th] + card.status_l.text = "已解锁" if unlocked else "未解锁" + card.status_l.add_theme_color_override("font_color", UiKit.GOLD if unlocked else UiKit.WARM_FAINT) + + +func _rebuild_forge(data: Dictionary) -> void: + _forge_rows.clear() + for child in _forge_holder.get_children(): + child.queue_free() + for row in data.get("forge", []): + _forge_rows.append(_build_forge_row(_forge_holder, row)) + + +func _build_forge_row(holder: VBoxContainer, row: Dictionary) -> Dictionary: + var card := PanelContainer.new() + card.add_theme_stylebox_override("panel", UiKit.panel_flat(UiKit.BG_OVERLAY, UiKit.GOLD_DIM, 4, 1, Vector4(12, 4, 12, 4))) + var line := HBoxContainer.new() + line.add_theme_constant_override("separation", 12) + card.add_child(line) + var attr := String(row.get("attr", "")) + var name_l := UiKit.label("%s（每级 %+d flat）" % [String(row.get("display_name", "")), int(row.get("flat", 0))], 14, true) + name_l.custom_minimum_size = Vector2(210, 0) + line.add_child(name_l) + var level_l := UiKit.label("", 14, false) + level_l.custom_minimum_size = Vector2(64, 0) + line.add_child(level_l) + var price_l := UiKit.label("", 14, false) + price_l.add_theme_color_override("font_color", UiKit.WARM_SOFT) + price_l.custom_minimum_size = Vector2(150, 0) + line.add_child(price_l) + var btn := UiKit.button("锻造 +1 级") + btn.pressed.connect(func(): buy_requested.emit(attr)) + line.add_child(btn) + holder.add_child(card) + return {"attr": attr, "level_l": level_l, "price_l": price_l, "btn": btn} + + +func _rebuild_workshop(data: Dictionary) -> void: + _workshop_rows.clear() + for child in _workshop_holder.get_children(): + child.queue_free() + for row in data.get("workshop", []): + var card := PanelContainer.new() + card.add_theme_stylebox_override("panel", UiKit.panel_flat(UiKit.BG_OVERLAY, UiKit.WARM_FAINT, 4, 1, Vector4(12, 4, 12, 4))) + var line := HBoxContainer.new() + line.add_theme_constant_override("separation", 12) + card.add_child(line) + var name_l := UiKit.label(String(row.get("display_name", "")), 14, true) + name_l.custom_minimum_size = Vector2(210, 0) + line.add_child(name_l) + var progress_l := UiKit.label("", 13, false) + progress_l.add_theme_color_override("font_color", UiKit.WARM_SOFT) + progress_l.custom_minimum_size = Vector2(150, 0) + line.add_child(progress_l) + var status_l := UiKit.label("", 13, true) + line.add_child(status_l) + _workshop_holder.add_child(card) + _workshop_rows.append({"item_id": String(row.get("item_id", "")), "progress_l": progress_l, "status_l": status_l}) + + +func _rebuild_recent(data: Dictionary) -> void: + var lines: Array = [] + var recent: Array = data.get("recent", []) + if recent.is_empty(): + lines.append("　（暂无冒险记录——完成或结束一次冒险后入账）") + for s in recent: + var verdict := "失败" + if String(s.get("result", "")) == "completed": + verdict = "完成" + elif String(s.get("result", "")) == "abandoned": + verdict = "放弃" + lines.append("%s · 通关 %d 关 · 钥石 +%d · 种子 %d" % [verdict, + int(s.get("levels_cleared", 0)), int(s.get("keystone_total", 0)), int(s.get("master_seed", 0))]) + _recent_list.text = "\n".join(lines) diff --git a/prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd.uid b/prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd.uid new file mode 100644 index 00000000..eaa6d5de --- /dev/null +++ b/prototypes/dungeon-sweeper-vertical-slice/presentation/views/camp_overlay_view.gd.uid @@ -0,0 +1 @@ +uid://dvg2wmjh87p8a From 816d0b9279399862f6fba99784e8b248966e456b Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 21 Sep 2026 15:17:38 +0800 Subject: [PATCH 3/4] =?UTF-8?q?test(smoke):=20=E5=85=83=E8=BF=9B=E5=BA=A6?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0=E6=89=B9=20T5=E2=80=94=E2=80=94=5Fsmoke=5Fme?= =?UTF-8?q?ta=20=E4=B8=89=E6=AE=B5=E6=89=A9=E8=87=B3=2027=20=E6=96=AD?= =?UTF-8?q?=E8=A8=80=EF=BC=88549=20=E7=BB=BF=EF=BC=89+=20ui=5Fprobe/ui=5Fc?= =?UTF-8?q?lick=5Fprobe=20=E8=90=A5=E5=9C=B0=E6=AE=B5=EF=BC=88=E9=9A=94?= =?UTF-8?q?=E7=A6=BB=E5=AD=98=E6=A1=A3=E6=8D=A2=E6=B3=A8=E4=BF=9D=E7=A1=AE?= =?UTF-8?q?=E5=AE=9A=E6=80=A7=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../smoke/smoke_all.gd | 171 ++++++++++++++++++ .../smoke/ui_click_probe.gd | 59 +++++- .../smoke/ui_probe.gd | 52 +++++- 3 files changed, 280 insertions(+), 2 deletions(-) diff --git a/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd b/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd index b2e80e7c..dd52ec98 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/smoke/smoke_all.gd @@ -3084,6 +3084,177 @@ func _smoke_meta() -> void: var brow: Dictionary = _db.meta_boss_keystone_row(li) boss_ok = boss_ok and not brow.is_empty() and int(brow.get("first_kill", 0)) >= int(brow.get("repeat_kill", -1)) check(boss_ok, "boss_keystone L1–L3 行连续可达且 first_kill ≥ repeat_kill 全行（首杀全量/重复小额）") + _meta_pricing_and_buy() + _meta_settle_and_workshop() + _meta_injection() + + +# 冒烟隔离存档名册（段首清陈旧 + 段尾清理——契约：测试不污染 user://save.json 真实档） +const _META_SMOKE_PATHS := ["user://smoke_meta_buy.json", "user://smoke_meta_dry.json", + "user://smoke_meta_settle.json", "user://smoke_meta_workshop.json", + "user://smoke_meta_cap.json", "user://smoke_meta_white.json"] + + +func _meta_smoke_cleanup() -> void: + for p in _META_SMOKE_PATHS: + for suffix in ["", ".tmp", ".corrupt.bak"]: + if FileAccess.file_exists(p + suffix): + DirAccess.remove_absolute(p + suffix) + + +func _meta_new_save(path: String): + var sv = load("res://core/save_manager.gd").new(path) + sv.load_from_disk() + return sv + + +# ---- 元进度 ②几何定价 ③购买（余额充足持久 / 不足拒绝 / attr 出域拒绝）---- +func _meta_pricing_and_buy() -> void: + print("--- 元进度·几何定价与购买（隔离档 smoke_meta_buy/dry）---") + _meta_smoke_cleanup() + var sv = _meta_new_save(_META_SMOKE_PATHS[0]) + var mp = load("res://core/meta_progression.gd").new(_db, sv) + # ② 几何定价：tier 0/1/2 价格 == 迭代 floor(p × ratio/100) 复算值（tier 0 = base_price）且严格递增 + for attr in MetaTable.FORGE_ATTRS: + var row: Dictionary = _db.meta_forge_row(attr) + var base := int(row.get("base_price", 0)) + var ratio := int(row.get("price_ratio_pct", 100)) + var all_ok := true + var prev := 0 + for tier in 3: + sv.set_forge_level(attr, tier) + var expect := base + for _i in tier: + expect = int(floor(float(expect) * float(ratio) / 100.0)) + all_ok = all_ok and mp.forge_price(attr) == expect and (tier == 0 or expect > prev) + prev = expect + check(all_ok, "%s 几何定价 tier 0/1/2 = 迭代 floor 复算且严格递增（base %d × ratio %d%%）" % [attr, base, ratio]) + sv.set_forge_level("atk", 0) + # ③ 购买成功：级+1、余额−价；buy 内含写盘——reload 后持久 + sv.add_keystone(1000) + var bal0: int = sv.keystone_balance() + var lvl0: int = sv.forge_level("atk") + var price0: int = mp.forge_price("atk") + check(mp.buy_forge("atk") and sv.forge_level("atk") == lvl0 + 1 and sv.keystone_balance() == bal0 - price0, + "购买成功（Lv %d→%d、余额 %d−%d）" % [lvl0, lvl0 + 1, bal0, price0]) + var sv_r = _meta_new_save(_META_SMOKE_PATHS[0]) + check(sv_r.forge_level("atk") == lvl0 + 1 and sv_r.keystone_balance() == bal0 - price0, "购买持久（reload 后级与余额不变）") + # ③ 余额不足 / attr 出域：false 零副作用 + var sv_dry = _meta_new_save(_META_SMOKE_PATHS[1]) + var mp_dry = load("res://core/meta_progression.gd").new(_db, sv_dry) + check(not mp_dry.buy_forge("atk") and sv_dry.keystone_balance() == 0 and sv_dry.forge_level("atk") == 0, + "余额不足 false 零副作用（0 余额购买拒绝）") + check(not mp_dry.buy_forge("luck") and sv_dry.keystone_balance() == 0, "attr 出域 false 零副作用（luck 不在词表）") + + +# ---- 元进度 ④注入可见 + 白板成立（验收 4/2/3——程序面；MC 逐位回归归 T7 全量验证）---- +func _meta_injection() -> void: + print("--- 元进度·注入可见与白板（隔离档 smoke_meta_white/dry）---") + var sv = _meta_new_save(_META_SMOKE_PATHS[1]) + var mp = load("res://core/meta_progression.gd").new(_db, sv) + sv.add_keystone(mp.forge_price("atk")) + check(mp.buy_forge("atk") and int(mp.hero_override().get("atk", -1)) == int(_db.meta_forge_row("atk").get("flat_value", 0)), + "买 atk 1 级 → hero_override().atk == 行 flat（验收4）") + var adr = load("res://core/adventure_runner.gd").new(_db, _fresh_rng(920251)) + check(adr.start_adventure(920251, {"hero_override": mp.hero_override()}), "注入参数冒险启动（start_adventure params 通道）") + var r = adr.runner() + var ov: Dictionary = mp.hero_override() + check(int(r.effective_atk()) == int(_db.hero.atk) + int(ov.get("atk", 0)), + "首战 hero_atk = 表值 + 永久强化 flat（begin_battle 同表达式——下一局能用到强化）") + check(int(r.effective_max_hp()) == int(_db.hero.max_hp) + int(ov.get("max_hp", 0)) + and int(adr.ledger["hero_hp"]) == int(_db.hero.max_hp) + int(ov.get("max_hp", 0)), + "首战 hero_max_hp 与开局生命账本 = 表值 + 注入档") + # 白板：同种子下 空参数 = 零强化参数 = 纯表值（逐位一致——注入通道默认值漏改在此转红） + var adr_w = load("res://core/adventure_runner.gd").new(_db, _fresh_rng(920251)) + check(adr_w.start_adventure(920251), "白板冒险启动（无 params 实参——B1 空参数路径）") + var sv_white = _meta_new_save(_META_SMOKE_PATHS[5]) + var adr_z = load("res://core/adventure_runner.gd").new(_db, _fresh_rng(920251)) + check(adr_z.start_adventure(920251, {"hero_override": load("res://core/meta_progression.gd").new(_db, sv_white).hero_override()}), + "零强化参数冒险启动（新档 hero_override 全零）") + var rw = adr_w.runner() + var rz = adr_z.runner() + check(int(rw.effective_atk()) == int(_db.hero.atk) and int(rw.effective_max_hp()) == int(_db.hero.max_hp) + and int(rz.effective_atk()) == int(rw.effective_atk()) and int(rz.effective_max_hp()) == int(rw.effective_max_hp()) + and int(rz.effective_ac()) == int(rw.effective_ac()), + "白板成立：空参数 = 零强化参数 = 纯表值（atk/max_hp/ac 三轴逐位一致——验收 2/3）") + check(int(rw.effective_ac()) == int(_db.hero.armor_class) and int(r.effective_ac()) == int(_db.hero.armor_class), + "ac 轴：白板恒表值、未换强化时注入零位移") + _meta_smoke_cleanup() + + +# ---- 元进度 ⑥Boss 两档 ⑦钥石不丢 ⑧工坊解锁 ⑩摘要副本与 cap（合成摘要驱动——settle 纯账面零跑局）---- +func _meta_settle_and_workshop() -> void: + print("--- 元进度·收束入账与工坊（隔离档 smoke_meta_settle/workshop/cap）---") + var sv = _meta_new_save(_META_SMOKE_PATHS[2]) + var mp = load("res://core/meta_progression.gd").new(_db, sv) + var row1: Dictionary = _db.meta_boss_keystone_row(1) + var row2: Dictionary = _db.meta_boss_keystone_row(2) + # ⑥ 新档首通 L1：first = true、金额 = first_kill；total = big_reward + Σ drops；余额 = 累计入账 + var d1: Dictionary = mp.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 1, + "stopped_at": 2, "keystone_total": 3, "master_seed": 11}) + var drop1: Dictionary = d1["boss_drops"][0] + check(bool(drop1.get("first", false)) and int(drop1.get("amount", 0)) == int(row1.get("first_kill", -1)) + and int(drop1.get("level", 0)) == 1, "新档首通 L1：boss_drops[0] {first:true, amount=first_kill}（验收5）") + check(int(d1.get("total", 0)) == 3 + int(row1.get("first_kill", 0)), "明细 total = big_reward + Σ drops") + check(sv.keystone_balance() == 3 + int(row1.get("first_kill", 0)), "余额 = 累计入账（大奖励 + Boss 两档）") + # ⑥ 同档再通 → 重复杀档且恒定不递减（第三轮同额） + var d2: Dictionary = mp.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 1, + "stopped_at": 2, "keystone_total": 3, "master_seed": 12}) + var drop2: Dictionary = d2["boss_drops"][0] + check(not bool(drop2.get("first", false)) and int(drop2.get("amount", 0)) == int(row1.get("repeat_kill", -1)), + "再通 L1：{first:false, amount=repeat_kill}（首杀标记置位后转小额）") + var d3: Dictionary = mp.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 1, + "stopped_at": 2, "keystone_total": 3, "master_seed": 13}) + check(not bool(d3["boss_drops"][0].get("first", true)) and int(d3["boss_drops"][0].get("amount", 0)) == int(row1.get("repeat_kill", -1)), + "重复杀第三轮恒定不递减（验收5——无衰减曲线）") + # 混合归因：通关两关 → L1 重复 + L2 首杀 + var d4: Dictionary = mp.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 2, + "stopped_at": 0, "keystone_total": 4, "master_seed": 14}) + check(not bool(d4["boss_drops"][0].get("first", true)) and bool(d4["boss_drops"][1].get("first", false)) + and int(d4["boss_drops"][1].get("amount", 0)) == int(row2.get("first_kill", -1)), + "两关通关逐关归因：L1 重复档 + L2 首杀档（first_kill 金额）") + # ⑦ 败北零通关摘要：余额只增不减（零入账）、clear_counts 不变 + var bal_before: int = sv.keystone_balance() + var cc1_before: int = sv.clear_count(1) + var dz: Dictionary = mp.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 0, + "stopped_at": 1, "keystone_total": 0, "master_seed": 15}) + check(dz["boss_drops"].is_empty() and sv.keystone_balance() == bal_before and sv.clear_count(1) == cc1_before, + "败北零通关摘要：零入账零标记（钥石只增不减——验收1；败北局 clear_counts 不变）") + # ⑧ 工坊解锁：settle 内已随 refresh——总通关次数达阈值件数 == unlocked 数；重复 refresh 幂等 + var total_clears: int = sv.clear_count(1) + sv.clear_count(2) + sv.clear_count(3) + var expect_n := 0 + for row in _db.meta_workshop_items(): + if total_clears >= int(row.get("clear_threshold", 99)): + expect_n += 1 + var got_n := 0 + for st_row in mp.workshop_status(): + got_n += 1 if bool(st_row.get("unlocked", false)) else 0 + check(got_n == expect_n and mp.refresh_workshop_unlocks().is_empty(), + "工坊解锁数 = 总通关 %d 次达阈值件数（%d 件）且重复 refresh 幂等" % [total_clears, expect_n]) + var sv_r = _meta_new_save(_META_SMOKE_PATHS[2]) + var r_n := 0 + for st_row in load("res://core/meta_progression.gd").new(_db, sv_r).workshop_status(): + r_n += 1 if bool(st_row.get("unlocked", false)) else 0 + check(r_n == expect_n, "工坊解锁持久（reload 后一致）") + # ⑧ 干净档：通关 1 次 → 恰两件阈值 1 道具新解锁（new_unlocks 明细） + var sv_w = _meta_new_save(_META_SMOKE_PATHS[3]) + var mp_w = load("res://core/meta_progression.gd").new(_db, sv_w) + var u1: Dictionary = mp_w.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 1, + "stopped_at": 2, "keystone_total": 0, "master_seed": 16}) + check(u1["new_unlocks"].size() == 2 and sv_w.item_unlocked("probe_dust") and sv_w.item_unlocked("sapper_order") + and not sv_w.item_unlocked("loot_compass"), "通关 1 次 → 恰两件阈值 1 道具解锁（new_unlocks 明细正确）") + # ⑩ recent_summaries：元素含 boss_drops 副本、最新在前、cap 10 + var rs: Array = sv.recent_summaries() + check(rs.size() >= 5 and String(rs[0].get("result", "")) != "" and rs[0].has("boss_drops") + and int(rs[0].get("master_seed", -1)) == 15, "摘要最新在前 + 元素含 boss_drops 副本（复盘可归因——验收5）") + var sv_c = _meta_new_save(_META_SMOKE_PATHS[4]) + var mp_c = load("res://core/meta_progression.gd").new(_db, sv_c) + for i in 12: + mp_c.settle_adventure({"result": "failed", "cleared": false, "levels_cleared": 0, + "stopped_at": 1, "keystone_total": 0, "master_seed": i}) + check(sv_c.recent_summaries().size() == 10 and int(sv_c.recent_summaries()[0].get("master_seed", -1)) == 11, + "摘要 cap 10 且最新在前（12 连 settle 截断后 seed 11 居首）") + _meta_smoke_cleanup() # ---- 战斗日志视图·行格式化呈现层同步闸（2026-09-20 真人试玩卡断 bug 回归：八型批伏击退役拆除 diff --git a/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_click_probe.gd b/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_click_probe.gd index 06d866e9..f0646c99 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_click_probe.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_click_probe.gd @@ -37,7 +37,53 @@ func _ready() -> void: add_child(main) await get_tree().process_frame var t_ui_ready := Time.get_ticks_msec() - t0 - # 满配直达 Boss（基线在节点 2-4 就会败北——探针目标是 Boss 战的结算路径） + # ---- 营地购买合成点击路径（元进度实现批——campbtn/购买/关闭全走真实按钮信号路径； + # 隔离存档换注 main.meta 保确定性（禁碰真实档 user://save.json）；陈旧档段首清理）---- + for p0 in ["user://smoke_click_probe_camp.json", "user://smoke_click_probe_camp.json.tmp", + "user://smoke_click_probe_reset.json", "user://smoke_click_probe_reset.json.tmp"]: + if FileAccess.file_exists(p0): + DirAccess.remove_absolute(p0) + var iso_c = load("res://core/save_manager.gd").new("user://smoke_click_probe_camp.json") + iso_c.load_from_disk() + main.meta = load("res://core/meta_progression.gd").new(main.db, iso_c) + var campbtn: Button = _find_button_by_prefix(main._start_overlay, "营地") + if campbtn == null: + _problems.append("营地入口按钮缺失（开始层 campbtn）") + else: + campbtn.pressed.emit() # 真实按钮信号路径 → 组合根 _open_camp + await get_tree().process_frame + if not main.camp_overlay.visible: + _problems.append("营地层未打开（点击路径）") + elif main.camp_overlay._forge_rows.is_empty(): + _problems.append("锻造柜台行缺失（点击路径）") + else: + var buy_btn: Button = main.camp_overlay._forge_rows[0].btn + if not buy_btn.disabled: + _problems.append("零余额锻造购买按钮未禁用（禁用态失守）") + iso_c.add_keystone(9999) + main.camp_overlay.refresh_camp(main._camp_data()) + await get_tree().process_frame + if buy_btn.disabled: + _problems.append("余额充足后购买按钮仍禁用（禁用态未随刷新）") + var bal_before: int = iso_c.keystone_balance() + var buy_attr: String = String(main.camp_overlay._forge_rows[0].attr) + var price: int = main.meta.forge_price(buy_attr) + buy_btn.pressed.emit() # 合成购买点击 → _on_camp_buy → meta.buy_forge（写调用唯一归组合根） + await get_tree().process_frame + if int(iso_c.keystone_balance()) != bal_before - price: + _problems.append("营地购买未出账（%d→%d 应 −%d）" % [bal_before, iso_c.keystone_balance(), price]) + var iso_chk = load("res://core/save_manager.gd").new("user://smoke_click_probe_camp.json") + iso_chk.load_from_disk() + if int(iso_chk.forge_level(buy_attr)) != 1: + _problems.append("营地购买未持久（reload 后级 != 1）") + main._on_camp_closed() + await get_tree().process_frame + if main.camp_overlay.visible or not main._start_overlay.visible: + _problems.append("营地关闭后未恢复开始层") + # 换回全新零档（营地购买态不泄入后续冒险段——确定性；档案残留下次段首清理兜底） + var iso_reset = load("res://core/save_manager.gd").new("user://smoke_click_probe_reset.json") + iso_reset.load_from_disk() + main.meta = load("res://core/meta_progression.gd").new(main.db, iso_reset) main.tune_panel.set_sliders(200, 100) var t1 := Time.get_ticks_msec() main._start_full_level() @@ -272,3 +318,14 @@ func _dump_state() -> void: str(diag.battle_result), str(diag.settling)]) print(" board_installed=%s facts_path='%s' refresh_used=%s flags=%s" % [ str(diag.minesweeper_board_installed), str(diag.facts_path), str(diag.refresh_used_round), str(_flags_placed)]) + + +# 开始层按钮按文案前缀寻址（campbtn 句柄未存组合根成员——树遍历只读；与 ui_probe 同款助手） +func _find_button_by_prefix(root: Node, prefix: String) -> Button: + if root is Button and String(root.text).begins_with(prefix): + return root + for child in root.get_children(): + var found := _find_button_by_prefix(child, prefix) + if found != null: + return found + return null diff --git a/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_probe.gd b/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_probe.gd index 8d81b54f..26fd3603 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_probe.gd +++ b/prototypes/dungeon-sweeper-vertical-slice/smoke/ui_probe.gd @@ -13,15 +13,54 @@ func _ready() -> void: var main = load("res://presentation/main.tscn").instantiate() add_child(main) await get_tree().process_frame + var problems: Array = [] # ---- 放弃入口（2026-09-21 用户拍板——台账 119）：默认隐藏（单关测试直入口无冒险可放弃）---- if main.route_overlay.abandon_btn == null or main.route_overlay.abandon_btn.visible: print("[ui_probe] FAIL — 放弃按钮默认应隐藏（单关测试直入口关）") get_tree().quit(1) return + # ---- 营地覆盖层（元进度实现批——主菜单入口/开合/余额文案/购买禁用态； + # 隔离存档换注 main.meta 保确定性（禁碰真实档 user://save.json——SaveManager 路径注入纪律）---- + var iso = load("res://core/save_manager.gd").new("user://smoke_ui_probe_camp.json") + iso.load_from_disk() + main.meta = load("res://core/meta_progression.gd").new(main.db, iso) + var campbtn: Button = _find_button_by_prefix(main._start_overlay, "营地") + if campbtn == null: + problems.append("营地入口按钮缺失（开始层 campbtn）") + else: + campbtn.pressed.emit() # 合成信号路径（真实按钮 → 组合根 _open_camp） + await get_tree().process_frame + if not main.camp_overlay.visible: + problems.append("营地层未打开（campbtn 路径）") + elif main._start_overlay.visible: + problems.append("营地层打开时开始层未隐藏（规范 2.3 遮挡纪律）") + else: + if not String(main.camp_overlay._balance_label.text).begins_with("钥石"): + problems.append("营地余额文案缺失（%s）" % main.camp_overlay._balance_label.text) + if main.camp_overlay._forge_rows.size() != 3: + problems.append("锻造柜台行数错误（%d ≠ 3）" % main.camp_overlay._forge_rows.size()) + else: + var zero_disabled := true + for card in main.camp_overlay._forge_rows: + zero_disabled = zero_disabled and bool(card.btn.disabled) # 零余额全禁用 + if not zero_disabled: + problems.append("零余额下锻造购买按钮未全禁用（余额不足禁用态失守）") + if main.camp_overlay._workshop_rows.size() != 6: + problems.append("工坊柜台行数错误（%d ≠ 6）" % main.camp_overlay._workshop_rows.size()) + main._on_camp_closed() + await get_tree().process_frame + if main.camp_overlay.visible or not main._start_overlay.visible: + problems.append("营地关闭后未恢复开始层（开合往返失守）") + # 换回全新零档（营地段购买态不泄入后续冒险段——确定性；先删后建防陈旧档泄入） + for p in ["user://smoke_ui_probe_camp.json", "user://smoke_ui_probe_camp.json.tmp"]: + if FileAccess.file_exists(p): + DirAccess.remove_absolute(p) + var iso_zero = load("res://core/save_manager.gd").new("user://smoke_ui_probe_camp.json") + iso_zero.load_from_disk() + main.meta = load("res://core/meta_progression.gd").new(main.db, iso_zero) main._start_full_level() await get_tree().process_frame await get_tree().process_frame - var problems: Array = [] # ---- 放弃入口·冒险模式可见 + 战斗中按下被拒（真实按钮路径——入口挂选路停点，战斗中拒绝为防御分支）---- if main.route_overlay.abandon_btn == null or not main.route_overlay.abandon_btn.visible: problems.append("冒险模式放弃按钮未开放（选路停点入口在案）") @@ -154,3 +193,14 @@ func _ready() -> void: push_error("[ui_probe] FAIL — " + p) print("[ui_probe] FAIL — " + "; ".join(problems)) get_tree().quit(1) + + +# 开始层按钮按文案前缀寻址（campbtn 句柄未存组合根成员——树遍历只读；text 前缀匹配首枚按钮） +func _find_button_by_prefix(root: Node, prefix: String) -> Button: + if root is Button and String(root.text).begins_with(prefix): + return root + for child in root.get_children(): + var found := _find_button_by_prefix(child, prefix) + if found != null: + return found + return null From 1312853e98aed519eb9857f5f641afbda1d5ed8e Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 21 Sep 2026 15:26:40 +0800 Subject: [PATCH 4/4] =?UTF-8?q?docs(design):=20=E5=85=83=E8=BF=9B=E5=BA=A6?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0=E6=89=B9=20T6=E2=80=94=E2=80=94=E5=85=83?= =?UTF-8?q?=E8=BF=9B=E5=BA=A6=20v1.3=20=E5=AE=9E=E7=8E=B0=E6=89=B9?= =?UTF-8?q?=E7=99=BB=E8=AE=B0+registry=20=E4=BA=94=E5=A4=84=EF=BC=88meta?= =?UTF-8?q?=5Ftable=20=E6=96=B0=E6=9D=A1/=E6=8D=A2=E7=AE=97=E8=A1=A8?= =?UTF-8?q?=E5=B7=B2=E5=BB=BA/=E6=B3=A8=E5=85=A5=E6=B6=88=E8=B4=B9?= =?UTF-8?q?=E9=9D=A2/aux=20=E8=A7=A3=E9=94=81=E9=9D=A2/save=20=E5=9F=9F?= =?UTF-8?q?=E6=B3=A8=E8=AE=B0=EF=BC=89+06=20=E5=9B=9B=E6=9D=A1=E7=9B=AE?= =?UTF-8?q?=E5=A4=84=E7=BD=AE=EF=BC=881=20=E5=88=A0=203=20=E6=94=B6?= =?UTF-8?q?=E7=AA=84=EF=BC=89+03/05/02/roadmap/README=20=E9=9A=8F=E6=89=B9?= =?UTF-8?q?+=E6=8E=A2=E9=92=88=E8=90=A5=E5=9C=B0=E6=AE=B5=E6=94=B6?= =?UTF-8?q?=E7=BC=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/02-系统清单.md | 3 ++- design/gdd/03-内容规模.md | 8 ++++++- design/gdd/05-不做清单.md | 2 +- design/gdd/06-待办清单.md | 14 +++---------- design/gdd/systems/冒险循环/元进度.md | 1 + design/registry/entities.yaml | 21 +++++++++++++++---- production/roadmap.md | 2 +- .../dungeon-sweeper-vertical-slice/README.md | 10 +++++++++ 8 files changed, 42 insertions(+), 19 deletions(-) diff --git a/design/gdd/02-系统清单.md b/design/gdd/02-系统清单.md index 9942003a..7ea90eff 100644 --- a/design/gdd/02-系统清单.md +++ b/design/gdd/02-系统清单.md @@ -44,7 +44,7 @@ | `关卡节点地图.md` | 单关内的节点图选路与推进 | 已定稿 | | `冒险结构.md` | 整局冒险的关卡序列、失败与大奖励 | 已定稿·自旧体系迁移 | | `难度曲线与Boss.md` | 难度曲线、期望值带与 Boss 设计 | 已定稿·自旧体系迁移 | -| `元进度.md` | 跨局成长（旧体系未单独成文） | 范围草案·待设计 | +| `元进度.md` | 跨局成长（旧体系未单独成文） | 已定稿·已实现（2026-09-21 实现批，数值 provisional 归设计批标定） | ### 表现与支撑（`systems/表现与支撑/`） @@ -101,3 +101,4 @@ | v0.5 | 2026-09-16 | 待拍板收编批：新建顶层文档 `06-待拍板清单.md`，把 systems/ 各系统文档「待拍板」章节的条目与三份文档的散落未定项统一收编；各系统文档「待拍板」节改为指路存根，其后新增条目直接登记清单 | | v0.6 | 2026-09-16 | 06 清单改版（用户拍板）：「待拍板」术语全仓改「待办」，顶层文档更名 `06-待办清单.md`；本表 06 行同步，各系统文档存根节随批由「待拍板」改名「待办」（各文版本历史不另记存根改名） | | v0.7 | 2026-09-17 | 关卡节点地图定稿批：`关卡节点地图.md` 状态行改**已定稿**（v1.0——分支节点图形态重开〔用户拍板重开 05 清单路径分支后置裁定〕、四类节点封闭枚举、全节点确认选路、遭遇构成编排面三条、节点奖励=功能道具正式渠道；概要行"节点链"改"节点图"；配套 05 清单移除路径分支条目、06 清单三悬案收口 + 两条新增、registry level_table 与术语回填） | +| v0.8 | 2026-09-21 | 元进度实现批：`元进度.md` 状态列「范围草案·待设计」→「已定稿·已实现」（2026-09-21 实现批落地，数值 provisional 归设计批标定） | diff --git a/design/gdd/03-内容规模.md b/design/gdd/03-内容规模.md index 1e86c3b2..3e1437cd 100644 --- a/design/gdd/03-内容规模.md +++ b/design/gdd/03-内容规模.md @@ -52,6 +52,12 @@ MVP 不加新状态；扩容走 status_effects.tres 加行 + registry 登记。 数值全部 provisional（骨架先行、数值后置）——商店房节点的机制归[关卡节点地图](systems/冒险循环/关卡节点地图.md)，GP 钱包账本归[冒险结构](systems/冒险循环/冒险结构.md)，调参归[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)曲线调参批。扩商品或改价格结构走 shop.tres 加行 + registry 登记。 +## 元进度 + +**一套元进度配置**（`data/tables/meta.tres`，现行行数读表为准）：属性锻造商品三行（生命上限 / 基础攻击 / 护甲等级的 flat 档与几何定价参数）、Boss 钥石两档三行（首杀 / 重复杀）、道具工坊阈值六行、区间平移换算率三行（数值占位 0 = 未标定合法态）。 + +数值全部 provisional（骨架先行、数值后置）——机制归[元进度](systems/冒险循环/元进度.md)，数值标定随元进度设计批配读数。扩柜台或改定价结构走 meta.tres 加行 + registry 登记。 + ## 暂不做 / 后续再说 垂直切片阶段明确砍掉或推迟的内容，写在这里防止回潮： @@ -61,7 +67,6 @@ MVP 不加新状态；扩容走 status_effects.tres 加行 + registry 登记。 - 地形变异扩展内容——首批四类型已落地，反制道具与全局作用域排 Alpha（2026-09-20 用户拍板） - 道具/增益之间的组合协同（遗物式联动） - 战后自动回复——回复只有道具与恢复点两个来源 -- 元进度与跨局成长 - 新敌种、新棋盘档位、更高密度、同深度多敌种混搭 - 魔法道具清单之外的新件、状态表之外的新状态 @@ -79,3 +84,4 @@ MVP 不加新状态；扩容走 status_effects.tres 加行 + registry 登记。 | v0.6 | 2026-09-20 | **第三关内容批（灰矮人矿城——与切片代码 / registry / 难度曲线与Boss / 棋盘生成 / 地形变异 同批）**：层名表加第三层（测试直入口已落地、正式序列推进待收尾——正式三关序列推进仍登记 Alpha 验收条件）；棋盘尺寸条款由两档改按关配置（第三关 13×13 / Boss 14×14 随批铺行）；棋盘节地形变异句随批补第三关一对（落石/矿尘）；暂不做「更多关卡」行更新为已按扩展批流程落地。行值读 `data/tables/level.tres` / `board_gen.tres` / `variation.tres`（registry 为准） | | v0.7 | 2026-09-20 | **GP+商店房批（与切片代码 / registry / 关卡节点地图 / 冒险结构 / 战斗结算 / 地图战斗资源 / 难度曲线与Boss 同批）**：格面资源池"八型 × 正负两向（十六格）"→"九型 × 正负两向（十八格）"（+gp 金币）；新增「商店」小节一行——shop.tres 读表纪律（商品三行 / 掉落参数 / 价格参数，全部 provisional 归曲线调参批）；一句话定位句补"一套商店配置" | | v0.8 | 2026-09-21 | **冒险结构实现批（与切片代码 / registry / 冒险结构 同批）**：层名表 L2/L3 状态行改「正式序列已生效」——首页「开始冒险」三关连探落地（AdventureRunner 编排；测试直入口保留）；「更多关卡」行同步；正文零历史叙述纪律下仅状态口径更新，结构框架零改动 | +| v0.9 | 2026-09-21 | **元进度实现批（与切片代码 / registry / 元进度 / 02 / 05 同批）**：「暂不做」节移除「元进度与跨局成长」行——跨局成长首批落地（营地三柜台 / 钥石账本 / 跨局注入，数值 provisional 归元进度设计批标定）；新增「一套元进度配置」小节（meta.tres 四行族读表纪律，数值 provisional 归设计批） | diff --git a/design/gdd/05-不做清单.md b/design/gdd/05-不做清单.md index 9ee129c3..3b6e43a4 100644 --- a/design/gdd/05-不做清单.md +++ b/design/gdd/05-不做清单.md @@ -19,7 +19,7 @@ - **多波战斗**：Peglin 对比报告（2026-09-12）裁下的后置项。单场多波是战斗编排级的改动，波间状态保留规则也要重新定义，排 Alpha 期评估。 - **遗物 / 构筑协同**：同批裁下。先做协同设计再谈加密度，没有协同的纯堆量只会稀释每件道具的存在感。 - **战后回复**：同批裁下。要做得绑定敌方攻击力下调，单独加回复会直接破坏现有数值预期。 -- **元进度（钥石解锁 / 跨局成长）**：排 Alpha。先把单局循环做扎实，跨局成长是之后的事。 +- **元进度（钥石解锁 / 跨局成长）**：排 Alpha，首批已落地（2026-09-21 元进度实现批——营地三柜台 / 钥石账本 / 跨局注入，数值 provisional 归设计批标定）。铺量与标定仍是之后的事。 - **反雪球机制**：MVP 不做。等 Alpha 拿到真实测试数据，再决定要不要治滚雪球、怎么治。 - **正式音频、教学引导、战斗动画演出、设置与本地化**：MVP 内的打磨项，一律排后。先验证核心循环，再谈好听好看。 - **连刷 / 换图资金跨战斗携带**：现行规则是每场战斗清零，防滚雪球。是否解禁连刷策略，等实测数据说话。 diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index d622850d..a62d5a03 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -261,7 +261,7 @@ **归属**：随[元进度](systems/冒险循环/元进度.md)定稿 -**状态**：待办（2026-09-18 注记：接口启用形态已裁决——区间平移换算率启用、换算率表首版三行定稿，本条剩余面 = 首版三行的折算数值随模拟读数标定，护甲行强条目须按解锁后参数重测） +**状态**：待办（2026-09-21 元进度实现批收窄）——**表结构已建**（`data/tables/meta.tres` conversion 行族三行，数值占位 0 = 未标定合法态）；剩余面 = 折算数值随设计批模拟读数标定 + 护甲行强条目须按解锁后参数重测 #### 三方向各自的解锁清单与定价 @@ -270,15 +270,7 @@ **归属**：元进度设计批 -**状态**：部分收口（2026-09-18 元进度定稿批，用户拍板）——落地形态定稿：**营地三柜台**（属性锻造：生命上限 / 基础攻击 / 护甲等级，钥石直购可重复升级；道具工坊：六件辅助道具，首版全走关卡通关次数达标渠道、钥石直购价随定价批后补、最终双渠道并存；奖励格图鉴：结构位现定、格子内容排 Alpha 随地图战斗资源差异化批）；定价曲线原则 = **几何递增**（起步价与公比数字待设计批配读数）。清单明细铺量与定价数字继续待办（本条剩余面） - -#### 解锁注入的实现口径 - -**现状**：冒险结构预留的「冒险开始参数面」如何承载各方向解锁，随设计批与对方联合修订。来源：元进度 待设计问题清单第 5 条 - -**归属**：元进度与[冒险结构](systems/冒险循环/冒险结构.md)联合修订 - -**状态**：部分收口（2026-09-18 元进度定稿批，用户拍板）——**口径已定**：沿用「冒险开始参数面」+ registry `hero_override_parameter_passing` 通道，开始冒险时算好 override 逐字段显式传（-1 = 表值兜底不变）；字段清单随柜台扩——属性三档为数值覆盖，道具池 / 遭遇权重 / 奖励格解锁为集合操作（参数面登记**追加 / 替换**两种语义）。参数面的正式侧联合修订执行仍随批（本条剩余面）；口径成文于[元进度](systems/冒险循环/元进度.md) v1.0 +**状态**：部分收口（2026-09-21 元进度实现批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、base 10 公比 150；Boss 两档 L1 5/1·L2 8/2·L3 12/3；工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；剩余面 = 定价数字与 Boss 两档、换算率数值随设计批配读数标定 #### 解锁界面与钥石呈现的交互形态 @@ -286,7 +278,7 @@ **归属**：元进度与[HUD 框架](systems/表现与支撑/HUD框架.md)协作批共同定 -**状态**：部分收口（2026-09-18 元进度定稿批，用户拍板）——**双入口框架已定**：主菜单营地独立入口（消费钥石、管理永久强化）+ 局内暂停层只读查看（余额与已解锁）；钥石余额 HUD 常驻。交互与视觉实现随 HUD 框架协作批、以表现层样张过审为前置（本条剩余面）；口径成文于[元进度](systems/冒险循环/元进度.md) v1.0 +**状态**：部分收口（2026-09-21 元进度实现批再收窄）——**功能界面已落地**（主菜单营地入口 + CampOverlay 三柜台 + A 区顶栏钥石余额常驻 + 结算屏入账明细，ui_kit 程序占位视觉）；剩余面 = 视觉终稿（以表现层样张过审为前置）与局内暂停层只读入口（现行无暂停层，随 HUD 批） ## 表现与支撑 diff --git a/design/gdd/systems/冒险循环/元进度.md b/design/gdd/systems/冒险循环/元进度.md index 08460f84..5654eb95 100644 --- a/design/gdd/systems/冒险循环/元进度.md +++ b/design/gdd/systems/冒险循环/元进度.md @@ -157,3 +157,4 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)整体 | v1.0 | 2026-09-18 | **元进度定稿批（用户拍板六件收口）**：定名「永久强化」（系统族名元进度保留，「天赋树」退役、「营地」为界面壳）；营地三柜台（属性锻造三档含护甲等级 / 道具工坊六件首版通关次数渠道 / 奖励格图鉴结构位）；Boss 重复获取 = 首杀全量 + 重复杀固定小额；定价几何递增原则；区间平移换算率启用（换算率表首版三行、护甲行强条目、数值读 data/tables）；注入 = 冒险开始参数面 + 覆盖值通道（override 集合操作：追加 / 替换）；解锁界面双入口框架。本文自范围草案升定稿 | | v1.1 | 2026-09-18 | **数值语言拍板批（与 01-核心循环 数值语言条款 / 难度曲线与Boss / registry / 06-待办清单 / 切片代码同批）**：营地三柜台节新增投值语言锁定条款——属性投值语言锁定 flat 整数加减，数值投值仍归设计批 | | v1.2 | 2026-09-20 | GP+商店房批注记（知会性质——与冒险结构 v0.5 同批）：钥石节新增与 GP 的分工一行——钥石 = 跨局持久解锁、GP（「金币」）= 冒险内一次性属性提升、局内清零不入存档，双币生命周期切分成文、永不互兑。机制零改动 | +| v1.3 | 2026-09-21 | **元进度实现批（与切片代码 / registry / 02 / 03 / 05 / 06 同批）**：本批 = 本文的实现批——MetaTable 四行族建表（`data/tables/meta.tres`，数值全 provisional 归设计批配读数）；MetaProgression 账本服务（余额/几何定价/购买/工坊解锁/Boss 两档入账/注入计算，Core 层零 UI 零信号）；注入通道落地（start_adventure params.hero_override → LevelRunner base_override，叠加序 = 表值+永久强化 flat+加算区 flat × 测试面板 pct）；呈现面（营地覆盖层三柜台+主菜单入口+A 区顶栏钥石余额+结算屏入账明细，ui_kit 程序占位——视觉终稿归 HUD 协作批）。正文零改动（实现面不回流正文——正文零历史叙述纪律） | diff --git a/design/registry/entities.yaml b/design/registry/entities.yaml index daae91c7..ad10a76d 100644 --- a/design/registry/entities.yaml +++ b/design/registry/entities.yaml @@ -76,7 +76,7 @@ entities: path: user://save.json（单档 MVP——多存档槽位 P2 保留） format: JSON 单档（人可读可调试；字典键一律 String） version: SAVE_FORMAT_VERSION=1（registry schema_version 同源；高版本拒读 + 禁写盘 + 内存默认新档运行；低版本读档时链式迁移 register_migration，任一步失败按损坏兜底） - domains: meta 域六件——keystone_balance（内容 owner=元进度）/ forge_levels 三档 max_hp·atk·armor_class（元进度）/ item_unlocks（元进度·道具工坊消费）/ level_clear_counts（元进度）/ boss_first_kill（元进度）/ recent_summaries cap 10 冒险摘要五件事副本（内容 owner=冒险结构） + domains: meta 域六件——keystone_balance（内容 owner=元进度）/ forge_levels 三档 max_hp·atk·armor_class（元进度）/ item_unlocks（元进度·道具工坊消费）/ level_clear_counts（元进度）/ boss_first_kill（元进度）/ recent_summaries cap 10 冒险摘要五件事副本（内容 owner=冒险结构；元素附 boss_drops 副本——Boss 两档金额入账随元进度实现批 2026-09-21 接通，apply_adventure_summary 第二参） write_timing: 启动读盘；正式冒险收束（adventure_finished → apply_adventure_summary）写盘；营地每笔钥石变更后即时写（元进度实现批接线）；单关测试入口与调试两层不写档 atomic_write: tmp + rename 原子写（写一半断电不留烂档——钥石不丢判据承载） corruption_policy: 坏档改名 .corrupt.bak（已存在覆盖）+ 默认新档继续 + 警告留痕（不静默丢档不 crash） @@ -491,7 +491,7 @@ entities: owner: design/gdd/systems/排雷循环/魔法道具.md attributes: table: AuxItemTable（数据配置 承载【数据配置×① 修订批登记】，键 = item_id；魔法道具 回填 owner，2026-09-14 定稿登记；定义表非进度成长表——Rule 4 豁免；生效前提 = 地图战斗资源×①…⑤/数据配置×①② 修订批兑现） - slice_scope: 垂直切片期无道具内容（2026-09-17 用户拍板——空清单合法态）：AuxItemTable 不随切片建表、六行不入掉落池（掉落频率归战斗奖励侧），F2 维度覆盖谓词挂起至表非空；本条设计登记与机制桥接（战斗结算 query_reward_identity 未开格恒可查）保留，内容随 魔法道具内容批（排垂直切片收尾后）回填 + slice_scope: 垂直切片期无道具内容（2026-09-17 用户拍板——空清单合法态）：AuxItemTable 不随切片建表、六行不入掉落池（掉落频率归战斗奖励侧），F2 维度覆盖谓词挂起至表非空；本条设计登记与机制桥接（战斗结算 query_reward_identity 未开格恒可查）保留，内容随 魔法道具内容批（排垂直切片收尾后）回填。**解锁状态面例外**（元进度实现批 2026-09-21 注记）：工坊六件的通关次数解锁渠道已落地（meta.tres workshop_items 行族 + SaveManager item_unlocks 域），局内效果仍归 Alpha 魔法道具整体重设计批——名称沿用本条词表 fields: item_id: String 主键唯一——地图战斗资源 RewardTable.effect_id（aux 行）与 VariationTable.counter_item_ids 的引用键 display_name: String 非空（HUD框架 呈现数据源，本地化归 设置与本地化——敌人系统/增益状态/地图战斗资源 同库惯例） @@ -596,7 +596,7 @@ entities: attributes: kind: 主角战斗入参覆盖值通道（begin_battle 显式参数传递——切片 E4 封装收口批实现，registry 登记缺口由 冒险结构 定稿批补登） contract: begin_battle 增 hero_hp / hero_atk / hero_max_hp 显式入参 → 敌人系统.spawn 增 atk_override / max_hp_override 参数；-1 = 表值兜底（不覆盖）；hero 表运行期不可变（数据配置 单一事实源机制化——表写通道全删） - consumers: HP 账本（冒险结构——跨战斗 HP 持久性 + 大奖励上限提升的传入面）/ 元进度加成（元进度 远期预留）/ 切片 TunePanel（调试通道） + consumers: HP 账本（冒险结构——跨战斗 HP 持久性 + 大奖励上限提升的传入面）/ 元进度加成（元进度实现批 2026-09-21 接通——MetaProgression.hero_override() 现算 flat 三档，AdventureRunner.start_adventure params.hero_override 显式传入 → LevelRunner base_override 共享；叠加序 = 表值 + 永久强化 flat + 加算区 flat × TunePanel pct）/ 切片 TunePanel（调试通道） adr_status: ADR-0009 候选——正式侧 战斗结算/敌人系统 GDD 修订随 ADR-0009 批；冒险结构 GDD 规则 3/4 为 冒险结构 半边（HP 账本供值）的正式定义源 referenced_by: [战斗结算, 敌人系统, 冒险结构, 元进度] @@ -604,7 +604,7 @@ entities: type: schema_data owner: design/gdd/systems/冒险循环/元进度.md attributes: - table: 永久强化换算率表（数据配置 承载；键结构 元进度定稿批 2026-09-18 登记，数值行读 `data/tables/` 随元进度设计批投值——本条只登记结构，零数值） + table: 永久强化换算率表（数据配置 承载；键结构 元进度定稿批 2026-09-18 登记，数值行读 `data/tables/` 随元进度设计批投值——本条只登记结构，零数值。**已建表**：meta.tres conversion 行族三行落地，数值占位 0 = 未标定合法态，provisional 待设计批标定（护甲行强条目在案）——元进度实现批 2026-09-21 注记） kind: 区间平移换算率（2026-09-18 用户拍板启用）——永久强化对难度的影响不直接改难度判据，按统一换算率折算为通关率带平移量后套用（完美档 gate 与 normal 目标带判读口径不变，带随解锁等级平移） key: (conversion_row_id)——一行一柜台商品类型 first_version_rows: 首版登记三个属性维度（表内即三行条目；用户拍板 2026-09-18，"维度"为拍板用语、"行"为表内同义术语）：生命上限强化 / 基础攻击强化 / 护甲等级强化——后续商品上架（道具工坊钥石价、奖励格图鉴）逐条补登记，每次上架伴随一行换算登记（逐行归因纪律） @@ -612,6 +612,19 @@ entities: value_semantics: 每行折算值 = 每级强化对应的通关率带平移量（pp）；营地定价从对应行换算率推（几何递增曲线，起步价与公比随设计批） related_save_domains: 钥石余额 / 永久强化等级表 / 关卡通关次数表 / Boss 首杀标记位（域级契约登记方式随 存档序列化「存档契约条目的登记方式」联合裁决） referenced_by: [元进度, 难度曲线与Boss, 数据配置, 存档序列化, 地图战斗资源] + + - name: meta_table + type: table + owner: design/gdd/systems/冒险循环/元进度.md + attributes: + table: MetaTable（数据配置 承载——元进度实现批 2026-09-21 建表落籍；schema data/schemas/meta_table.gd + data/tables/meta.tres） + kind: 元进度/永久强化数值行单点（定价 / Boss 两档 / 工坊阈值 / 换算率四行族——消费面一律走 ConfigDB.meta_* 访问器，禁直读行集） + row_families: forge_products {attr ∈ {max_hp, atk, armor_class} 恰三, display_name, flat_value, base_price, price_ratio_pct ∈ [100,400]} · boss_keystone {level_index 连续从 1, first_kill ≥ repeat_kill} · workshop_items {item_id ∈ registry aux_items 六件词表恰全, display_name, clear_threshold ∈ [1,99]} · conversion {attr 与 forge 词表一致恰三, per_level_shift_pct ∈ [0,100]} + provisional: 数值全 provisional 归元进度设计批配读数（骨架先行先例 = GP+商店房批）——现行落表值：flat 血+3/攻+1/甲+1、base 10 ratio 150 三行同；Boss 两档 L1 5/1 · L2 8/2 · L3 12/3；工坊阈值 1/1/2/2/3/3（按总通关次数）；换算率全 0 占位 + impl: core/meta_progression.gd（MetaProgression 账本服务——余额/几何定价〔tier 级价格 = 迭代 floor(p × ratio/100)〕/购买/工坊解锁〔总通关次数渠道〕/settle_adventure Boss 两档入账/hero_override 注入计算；Core 层零 UI 零信号） + workshop_unlock_rule: 首版只挂总通关次数渠道（Σ level_clear_counts 达阈值——2026-09-21 实现批代拍板 2，GDD 未细分）；钥石直购价随定价批后补 + referenced_by: [元进度, 存档序列化, 数据配置] + # 2026-09-09 奖励道具经济 full 评审修订批（owner=奖励道具经济 代用户修订，NEEDS REVISION 14 blocking 同日核销）： # 新增 reward_config 条目（RewardConfigTable 单行全局——T_fog_min/K_dmg/N_draft/P_min 的 Rule 1 载体）； # reward_table 增 display_name（九字段）+ 默认根行集登记 + direction_precheck（刀供给）+ 跨字段护栏两条 diff --git a/production/roadmap.md b/production/roadmap.md index 85496279..8851fb3e 100644 --- a/production/roadmap.md +++ b/production/roadmap.md @@ -19,7 +19,7 @@ | 2026-09-18 | 加法核数值语言拍板落地（台账 75）+ 80 遍模拟试玩基线（台账 76）；无伤通关根因批（行动点压速 8→6）；英雄双轴批（甲/攻类型可配置）；伤害道具批五型→七型；战斗数值盘问会话四收口；关卡节点地图 v1.0 定稿（分支节点图拍板）；元进度定名永久强化+营地三柜台 | | 2026-09-19 | 验收读数重测批落地（4708940）；掷点流种子偏置根因修复 A+B 案（R3 混淆派生 + MC unique 模式）；插旗不可逆批（台账 87，冒烟 331）；普通画像 v2 基础定式拍板（普通=基础定式/完美=上界仪）；技能池新效应词汇批（妨害技+必中附加分量，smoke 306）；清图支配性对账重跑（c8e5afd）；迭代闭环仪表盘落地（台账 78）；worktree 铁律立规 | | 2026-09-20 | 第三关内容批（灰矮人矿城行集 + 测试直入口，smoke 375 全绿）；GP+商店房实施批（九型格面+随机掉落+Boss前商店房+统一加算区，smoke 437 全绿）；八型批呈现层漏网修复（真人试玩卡断——行协议呈现层同步闸 11 断言）；第一层定名「地精洞窟」 | -| 2026-09-21 | **冒险结构实现批：切片从三个单关 demo 升级为一局完整三关冒险**（AdventureRunner+LevelRunner 账本外置+AdventureTable 建表；三关正式序列生效；smoke 482 全绿）；存档序列化批（SaveManager 落地：单档 JSON 存档读写/版本迁移/损坏兜底 + 元进度四件与冒险摘要入档，smoke 518 全绿）；放弃入口界面呈现批（用户拍板「放弃接口也要有」——选路停点挂放弃按钮，台账 119）——元进度批（钥石消费）挂点就位 | +| 2026-09-21 | **冒险结构实现批：切片从三个单关 demo 升级为一局完整三关冒险**（AdventureRunner+LevelRunner 账本外置+AdventureTable 建表；三关正式序列生效；smoke 482 全绿）；存档序列化批（SaveManager 落地：单档 JSON 存档读写/版本迁移/损坏兜底 + 元进度四件与冒险摘要入档，smoke 518 全绿）；放弃入口界面呈现批（用户拍板「放弃接口也要有」——选路停点挂放弃按钮，台账 119）；元进度实现批（MetaTable 四行族+MetaProgression 账本+跨局注入+营地覆盖层与结算明细，smoke 549 全绿——跨局循环闭合，数值 provisional 归设计批标定） | ## 路线图（主线路线与门） diff --git a/prototypes/dungeon-sweeper-vertical-slice/README.md b/prototypes/dungeon-sweeper-vertical-slice/README.md index 8409475a..7e28610a 100644 --- a/prototypes/dungeon-sweeper-vertical-slice/README.md +++ b/prototypes/dungeon-sweeper-vertical-slice/README.md @@ -530,3 +530,13 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/s **冒险级语义**（设计权威 = 冒险结构.md v0.6）：主种子恰一次注入（冒险内不重播种，同种子同操作序列逐位可复现）；生命账本跨关同账（战后回写、恢复点按比例封顶、大奖励回满）；GP 钱包跨关延续、冒险收束清零；统一冒险加算区（商店购买与大奖励同账）；非末关通关发大奖励（上限提升 +10 读 adventure.tres、血回满、钥石 +10），末关不发上限提升、钥石照记；任意战斗倒下 = 冒险失败；结算屏出冒险摘要五件事（打穿没有/通关几关/止步第几关/钥石合计/主种子）。 **验证**：冒烟 437→482 项 0 失败三闸全过（冒险表 +4 / API 闸 +8 / 冒险验收 +33：表覆盖义务、满配通关、种子复现、大奖励恰 2 次与覆盖值传播、败北线两种子扫描、重复宣布拒绝、GP 跨关延续、加算区同账、恢复数学、放弃两态）；MC 回归零行为变更（run_level 旧路径同种子逐位一致）。 + +## 2026-09-21 元进度实现批（跨局循环闭合——MetaTable + MetaProgression + 营地 + 跨局注入） + +**跨局成长首批落地**（设计权威 = 元进度.md v1.2）：「存档在变厚」成为玩家可感的现实——冒险收束入账（大奖励渠道 + Boss 首杀/重复杀两档，明细在结算屏可归因）、营地消费、余额 HUD 常驻、永久强化在下一局开局注入。 + +**玩法面**：首页新增「营地 · 永久强化」入口（三柜台：属性锻造三档 flat 直购可重复升级、几何递增定价；道具工坊六件按累计通关次数解锁——局内效果排 Alpha 魔法道具重设计批；奖励格图鉴占位锁定）；A 区顶栏钥石余额常驻；冒险结算屏追加钥石入账明细（大奖励 / 逐关 Boss 首杀或重复 / 工坊新解锁）。买强化 → 下一局开局即生效（表值 + 永久强化 flat + 冒险加算区，再乘调整板百分比）。 + +**技术面**：`data/tables/meta.tres` 四行族（forge_products / boss_keystone / workshop_items / conversion）+ `core/meta_progression.gd` 账本服务（Core 层零 UI 零信号）；SaveManager.apply_adventure_summary 增第二参 boss_drops（缺省 [] 零行为兼容，摘要元素附副本）；AdventureRunner.start_adventure 增 params.hero_override（缺省全零 = 白板）→ LevelRunner base_override。**数值全 provisional 归元进度设计批配读数**（骨架先行先例 = GP+商店房批）。 + +**验证**：冒烟 522→549 项 0 失败三闸全过（表结构 +4 / 定价与购买 +7 / 注入与白板 +8 / 入账工坊摘要 +8）；四探针全 PASS（ui_probe 营地开合/禁用态、click_probe 营地购买合成点击全路径——隔离存档换注保确定性，禁碰真实档）；白板成立 = 空参数 = 零强化参数 = 纯表值三轴逐位一致。