DKChan
5f9d8e7b77
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例） - 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为 现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行） - 纯注释改动零行为变更，按用户令免测试免冒烟
88 lines
5.5 KiB
GDScript
88 lines
5.5 KiB
GDScript
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||
# Validation Question: 玩家能否在营地用钥石换永久强化、且强化在下一局开局生效——存档变厚成为玩家可感的现实
|
||
#（元进度 GDD 验收标准）
|
||
# Date: 2026-09-21（设计权威 design/gdd/systems/冒险循环/元进度.md）
|
||
# 数据配置 MetaTable schema（元进度行族）。
|
||
# 行族三轴（数据契约对齐 ConfigDB.meta_* 访问器——消费面一律走访问器，禁直读行集）：
|
||
# boss_keystone = Boss 钥石两档行（level_index 连续从 1；first_kill ≥ repeat_kill——首杀全量、
|
||
# 重复杀固定小额恒定不递减，两档数值归 元进度.md）。
|
||
# conversion = 区间平移换算率行（attr 与三属性轴词表一致恰三；per_level_shift_pct ∈ [0,100]——
|
||
# registry 键 meta_progression_conversion_table；护甲行强条目：验收读数必须按解锁后参数重测）。
|
||
# attune_refresh_upgrade = Y 刷新升级行族（每冒险开局给 Y 次、冒险周期池、
|
||
# 用完即无；level 连续从 1，等级 L → refresh_charges=Y 表值，钥石直购 keystone_cost；数值全 provisional）。
|
||
# 〔无 forge_products 属性锻造行族——生命唯一入口=树脊柱、攻/AC 唯一入口=锻造工坊路线。〕
|
||
# 〔无 workshop_items 道具工坊行族——解锁=混合制：钥石购买价
|
||
# unlock_keystone_cost + 条件谓词 unlock_requires 全挂 treasure_items.tres 行内（单一事实源）。〕
|
||
# 行值全部 provisional（读数归 元进度.md）。
|
||
class_name MetaTable
|
||
extends Resource
|
||
|
||
@export var boss_keystone: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
||
@export var conversion: Array[Dictionary] = [] # Array[Dictionary] 键 attr
|
||
@export var attune_refresh_upgrade: Array[Dictionary] = [] # Array[Dictionary] 键 level——Y 刷新升级行族（迭代 11 第①批 T4）
|
||
|
||
const FORGE_ATTRS := ["max_hp", "atk", "armor_class"] # 三属性轴词表（conversion 行键域——原 forge 词表名沿用作轴名）
|
||
|
||
|
||
func validate() -> Array:
|
||
var errs: Array[Dictionary] = []
|
||
# 行族空护栏（三族皆为 ConfigDB 消费面——缺族即致命）
|
||
for family in ["boss_keystone", "conversion", "attune_refresh_upgrade"]:
|
||
if get(family).is_empty():
|
||
errs.append({"category": "empty_table", "message": "MetaTable 行族为空: %s" % family})
|
||
# 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 行族已退役（迭代 22 T2——解锁混合制换代，条件谓词挂 treasure_items 行内；
|
||
# 校验段随批删除——秘宝解锁条件校验单点=TreasureItemTable.validate）
|
||
# 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})
|
||
# attune_refresh_upgrade：level 唯一 + 连续从 1 + charges/cost 域（迭代 11 第①批 T4）
|
||
var seen_al := {}
|
||
for row in attune_refresh_upgrade:
|
||
var al: int = int(row.get("level", -1))
|
||
if seen_al.has(al):
|
||
errs.append({"category": "dup_key", "message": "attune_refresh_upgrade level 重复: %d" % al})
|
||
seen_al[al] = true
|
||
var ach: int = int(row.get("refresh_charges", -1))
|
||
if ach < 1 or ach > 9:
|
||
errs.append({"category": "domain", "message": "attune_refresh_upgrade L%d refresh_charges 越域 [1,9]: %d" % [al, ach]})
|
||
var acost: int = int(row.get("keystone_cost", -1))
|
||
if acost < 1 or acost > 999:
|
||
errs.append({"category": "domain", "message": "attune_refresh_upgrade L%d keystone_cost 越域 [1,999]: %d" % [al, acost]})
|
||
for i in attune_refresh_upgrade.size():
|
||
var al_at: int = int(attune_refresh_upgrade[i].get("level", 0))
|
||
if al_at != i + 1:
|
||
errs.append({"category": "structural", "message": "attune_refresh_upgrade level 不连续（须从 1 连续递增）: 位 %d = %d" % [i + 1, al_at]})
|
||
break
|
||
return errs
|