DKChan
9a72394652
按 code-conventions §1.4.1 第三轮定稿执行：core 22+schemas 18+presentation 根 14+views 28，全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述，保留职责摘要+真实使用约束（防事故禁令/单一入口/信号契约每信号一行）。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行（波一 core+schemas、波二 presentation+views，并发≤2）。验收=tools/verify_comment_only_change.py 逐字节校验（82 文件头注区外逐行一致=零行为变更）+audit_file_headers 全绿；纯注释批免冒烟（先例 5843270）
141 lines
8.7 KiB
GDScript
141 lines
8.7 KiB
GDScript
## VERTICAL SLICE - NOT FOR PRODUCTION
|
||
## 敌人表 schema：逐 (level_index, node_depth, enemy_id) 行集的类型化读取（行集可多行混编；垂直切片验证：完整战斗逐行归因）。
|
||
## 行序即契约：同坐标多行必须文件内相邻——resolver 返回序/生成序/叙述取首行全依赖文件行序。
|
||
## 行集实例总数 ≤4 是开战骰后守卫（加载期不可判，闸在单位容器 spawn）；技能池构成纪律需跨表视野，校验在 ConfigDB 跨表通道。
|
||
class_name EnemyTable
|
||
extends Resource
|
||
|
||
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
||
|
||
# 护甲类型封闭枚举（攻击类型 × 护甲克制批——克制矩阵本体在 SettlementTable；
|
||
# 2026-09-15 命名统一批：位置键 {none, a, b} → 语义键 {light, ward, heavy} = 轻甲 / 魔法护甲 / 重甲）
|
||
const ARMOR_TYPES := ["light", "ward", "heavy"]
|
||
|
||
# 攻击类型封闭枚举（迭代 24 N3 2026-10-13——敌方攻击类型轴开列，承接锻造工坊迁移面⑥；
|
||
# 克制矩阵点数制键前缀 = 本枚举：normal → light 0 / ward +1 / heavy −1；pierce/magic 为差异化
|
||
# 预留档，差异化填值属新设计另立项。可省略 + 缺省 normal 向后兼容）
|
||
const ATTACK_TYPES := ["normal", "pierce", "magic"]
|
||
|
||
# 实例化数量域（2026-10-02 修复批 T2 魔法数结构化——数量域 [1,3] 双落点收口单点：
|
||
# 本表 validate 与 单位容器 spawn 守卫共用；遭遇骰结果与行值 unit_count/unit_count_max 同域。
|
||
# 2026-10-07 行集多行批：MAX 语义 = **单种数**（单行实例数上限），行集实例总数 ≤4 另由
|
||
# spawn 期守卫承担——骰后值加载期不可判，双闸分工见 敌人系统 v0.15 行集构成纪律③）
|
||
const UNIT_COUNT_MIN := 1
|
||
const UNIT_COUNT_MAX := 3
|
||
|
||
# 行集实例总数上限（2026-10-07 行集多行批 P1 甲——行集构成纪律③：各行开战骰后数量求和 ≤4；
|
||
# 「总数」= 实例数非行数〔Q9 二裁〕，行数不设上限。骰后值加载期不可判——守卫在 单位容器 spawn，
|
||
# 常量单点在本表与数量域同位收口）
|
||
const ROWSET_INSTANCE_MAX := 4
|
||
|
||
|
||
func validate() -> Array:
|
||
var errs: Array[Dictionary] = []
|
||
if rows.is_empty():
|
||
errs.append({"category": "empty_table", "message": "EnemyTable 为空"})
|
||
return errs
|
||
var seen := {}
|
||
var last_rk := ""
|
||
var closed_rk := {}
|
||
var anchor_ok := {}
|
||
for row in rows:
|
||
var L: int = int(row.get("level_index", 0))
|
||
var D: int = int(row.get("node_depth", -1))
|
||
var eid: String = row.get("enemy_id", "")
|
||
var key := "%d_%d_%s" % [L, D, eid]
|
||
if seen.has(key):
|
||
errs.append({"category": "dup_key", "message": "EnemyTable 键重复: %s" % key})
|
||
seen[key] = true
|
||
if L < 1 or D < 0:
|
||
errs.append({"category": "domain", "message": "进度键越域 (%d,%d)" % [L, D]})
|
||
if eid == "":
|
||
errs.append({"category": "domain", "message": "enemy_id 空"})
|
||
if String(row.get("display_name", "")) == "":
|
||
errs.append({"category": "domain", "message": "%s display_name 空" % eid})
|
||
var uc: int = int(row.get("unit_count", 0))
|
||
if uc < UNIT_COUNT_MIN or uc > UNIT_COUNT_MAX:
|
||
errs.append({"category": "domain", "message": "%s unit_count 越域 [%d,%d]" % [eid, UNIT_COUNT_MIN, UNIT_COUNT_MAX]})
|
||
# unit_count_max（可省略——遭遇随机化批，难度曲线与Boss GDD Core Rule 8）：区间 [unit_count, max]，缺省 = 定值
|
||
if row.has("unit_count_max"):
|
||
var ucm: int = int(row.get("unit_count_max", uc))
|
||
if ucm < uc or ucm > UNIT_COUNT_MAX:
|
||
errs.append({"category": "cross_field", "message": "%s unit_count_max(%d) 越域 [unit_count(%d),%d]" % [eid, ucm, uc, UNIT_COUNT_MAX]})
|
||
var hp: int = int(row.get("hp", 0))
|
||
if hp < 1 or hp > 999:
|
||
errs.append({"category": "domain", "message": "%s hp 越域 [1,999]" % eid})
|
||
var atk: int = int(row.get("atk", -1))
|
||
if atk < 0 or atk > 999:
|
||
errs.append({"category": "domain", "message": "%s atk 越域 [0,999]" % eid})
|
||
# atk_min/atk_max（可省略配对——2026-09-14 敌方攻击区间批）：遭遇骰同流 spawn 期整战持久 roll；
|
||
# 中点锚 = 行动经济 条款①同款期望当量纪律（调区间必同步调 atk）
|
||
var has_amin: bool = row.has("atk_min")
|
||
var has_amax: bool = row.has("atk_max")
|
||
if has_amin != has_amax:
|
||
errs.append({"category": "cross_field", "message": "%s atk_min/atk_max 必须成对出现" % eid})
|
||
elif has_amin:
|
||
var amin: int = int(row.get("atk_min", 0))
|
||
var amax: int = int(row.get("atk_max", 0))
|
||
if amin < 0 or amax > 999 or amin > amax:
|
||
errs.append({"category": "domain", "message": "%s atk 区间越域 [0,999] 且 min≤max: %d..%d" % [eid, amin, amax]})
|
||
if atk != int((amin + amax) / 2.0):
|
||
errs.append({"category": "cross_field", "message": "%s atk(%d) ≠ 区间中点(%d)——中点恒等期望当量锚" % [eid, atk, (amin + amax) / 2]})
|
||
# 池模板（敌人技能池批——单表结构校验；跨表构成纪律在 ConfigDB）：
|
||
# 非空池 + 条目 {skill_id 非空, weight > 0} + 池内 skill_id 不重复。
|
||
# 普攻冷却恒 0（SkillTable schema 锁死）→ 可摇集合恒非空，"空池不可能"由此结构保证。
|
||
var pool: Array[Variant] = row.get("pool", [])
|
||
if pool.is_empty():
|
||
errs.append({"category": "domain", "message": "%s pool 空池（禁——技能池行必带池模板）" % eid})
|
||
var pool_ids := {}
|
||
for entry_v in pool:
|
||
if not (entry_v is Dictionary):
|
||
errs.append({"category": "domain", "message": "%s pool 条目非字典: %s" % [eid, str(entry_v)]})
|
||
continue
|
||
var entry: Dictionary[Variant, Variant] = entry_v
|
||
var sid: String = String(entry.get("skill_id", ""))
|
||
if sid == "":
|
||
errs.append({"category": "domain", "message": "%s pool 条目 skill_id 空" % eid})
|
||
elif pool_ids.has(sid):
|
||
errs.append({"category": "dup_key", "message": "%s pool 内 skill_id 重复: %s" % [eid, sid]})
|
||
pool_ids[sid] = true
|
||
var w: int = int(entry.get("weight", 0))
|
||
if w <= 0 or w > 9999:
|
||
errs.append({"category": "domain", "message": "%s pool 权重越域 (0,9999]: %d" % [eid, w]})
|
||
# unlock_hp_pct（可省略——迭代14④ Boss 半血解锁技：缺省无字段=无门槛；域 [1,99] percent。
|
||
# 投放纪律=仅 Boss 行〔enemy 表无 boss 编码位，硬闸须跨表查节点类型——不做硬闸，文档纪律登记〕）
|
||
if entry.has("unlock_hp_pct"):
|
||
var uhp: int = int(entry.get("unlock_hp_pct", 0))
|
||
if uhp < 1 or uhp > 99:
|
||
errs.append({"category": "domain", "message": "%s pool unlock_hp_pct 越域 [1,99]: %d" % [eid, uhp]})
|
||
# armor_type（可省略——缺省 light 向后兼容）
|
||
var at: String = String(row.get("armor_type", "light"))
|
||
if not ARMOR_TYPES.has(at):
|
||
errs.append({"category": "enum", "message": "%s armor_type 未知枚举: %s（域 {light, ward, heavy}）" % [eid, at]})
|
||
# attack_type（迭代 24 N3——可省略，缺省 normal 向后兼容；写法沿用 armor_type 同款）
|
||
var att: String = String(row.get("attack_type", "normal"))
|
||
if not ATTACK_TYPES.has(att):
|
||
errs.append({"category": "enum", "message": "%s attack_type 未知枚举: %s（域 {normal, pierce, magic}）" % [eid, att]})
|
||
# armor_class（可省略——缺省 0 向后兼容；2026-09-16 护甲等级掷点批：防守方掷点判定阈值基数）
|
||
var ac: int = int(row.get("armor_class", 0))
|
||
if ac < 0 or ac > 999:
|
||
errs.append({"category": "domain", "message": "%s armor_class 越域 [0,999]: %d" % [eid, ac]})
|
||
# 行集构成纪律②（2026-10-07 行集多行批——行序即契约，敌人系统 v0.15）：同坐标多行必须
|
||
# 文件内相邻。迭代中记录上一行坐标；当前坐标曾出现过但 ≠ 上一行坐标 = 同坐标行被隔断，报错。
|
||
# 原纪律「每行集恰一敌种」同批退役——同坐标多敌种混编合法；同坐标同敌种第二行仍由
|
||
# dup_key 拦截（键含 enemy_id）。错误类别沿用 rowset_rule（定位面不变）。
|
||
var rk := "%d_%d" % [L, D]
|
||
if rk != last_rk:
|
||
if closed_rk.has(rk):
|
||
errs.append({"category": "rowset_rule", "message": "(%d,%d) 行集行序违例：同坐标多行必须文件内相邻（行序即契约——resolver 返回序/生成序/叙述取首行全依赖文件行序）" % [L, D]})
|
||
closed_rk[rk] = true
|
||
last_rk = rk
|
||
anchor_ok[L] = anchor_ok.get(L, false) or D == 0
|
||
for L in anchor_ok.keys():
|
||
if not anchor_ok[L]:
|
||
errs.append({"category": "anchor", "message": "EnemyTable level %d 缺 depth-0 锚行" % L})
|
||
return errs
|
||
|
||
|
||
# 进度键解析单点收口（2026-10-07 行集多行批 P2 甲——原 floor 语义 resolve_rowset 退役，全仓统走
|
||
# ConfigDbResolver.resolve_enemy_rowset ceil 版行集数组：2026-09-18 用户拍板 ceil 保证偏难，
|
||
# 双算法并存至本批销号〔状态记录 312 待裁项〕；原冒烟四调用点随批迁移，坐标全精确命中零行为差）。
|