DKChan
63a08d1e01
T1 数据面:AuxItemTable schema(七字段+retired/deferred 两 additive 标记+真视窄域/board_wide 双承重护栏)+六行 tres(三有效+罗盘 retired 留痕+显影尘/全图卷 deferred)+ConfigDB 加载/访问器+RewardTable 十型扩值(aux_item)+三投放行 5/4/1+aux_none 负占位行(雷格极性字典兜底零兑付)+双表悬空校验(reward_dangling_aux,负占位豁免)+F2 投放维度覆盖(豁免面 plan/info/counter 登记)+两 fatal 夹具(expect=1 复制真表注入违规)+run_all manifest+2 T2 core 骨架:AuxItems 类(api 8 入口+probe 探针;零随机零特判;Used 不可逆;真视恒可用/预读点击级零信息拒绝;3x3 边缘窗口∩板)+action_economy.grant_ap 第 9 API(当轮加量,区别 queue_ap_delta 排队) T3 授予路由+生命周期:_grant_routed aux 分支(正=入库存发「获得」行;负=零兑付 effect 型「道具随雷沉没」行)+use_aux 四步受理(相位 gate→validate→逐 kind 空间先 AP 后→consume;结算明细无道具行)+叠加层三清(装板点/战斗结束)+LevelRunner 关卡域库存持有注入+关卡末 reset+aux_cleared 快照计数扩签 冒烟锚随词表扩值更新:九型→十型封闭/字典 18→22 行;负向字典扫描三处稳健化(aux 不入五型轴+break 改 percent_map 三型齐备+rng 每板新实例——原第一板 break 掩盖 set_master_seed _counter 守卫违例) 闸:冒烟 577/0(净增 1)+单测 11 套全过(含两新夹具)+四探针 PASS
110 lines
6.4 KiB
GDScript
110 lines
6.4 KiB
GDScript
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||
# Validation Question: 挖掘期撞上推理断头时，玩家能否从掉落池捡到魔法道具、在关键时刻花掉买回情报或行动点（P0）
|
||
# Date: 2026-09-29（迭代 7 T1 数据面——魔法道具内容批；设计权威 design/gdd/systems/排雷循环/魔法道具.md v0.4+
|
||
# + registry aux_items 六行 mvp_content；2026-09-29 用户拍板：①乙 探宝罗盘退役留痕 ④甲 显影尘/地穴全图卷失义件
|
||
# 六行全建零投放「已解锁·能力封存中」）
|
||
# 数据配置 AuxItemTable schema（魔法道具 回填 owner）。
|
||
# 行 = Dictionary，键 item_id（Rule 4 豁免：定义表——registry aux_items Rule 4 豁免先例）。
|
||
# 七字段（registry fields 全量）：item_id 主键 / display_name / dimension_tags ⊆ 五维 非空 /
|
||
# effect_kinds ⊆ {mine_reveal, reward_preview, ap_grant}（活性校验见下）/ target ∈ {none, area_3x3, board_wide} /
|
||
# magnitude [0,999]（仅 ap_grant 行消费，加载校验 ≥1）/ use_phase ∈ {active_dig}。
|
||
# additive 两标记（迭代 7 T1——拍板①④的表内表达，非 registry fields 预登记字段的扩列随批登记）：
|
||
# retired = 退役留痕行（loot_compass——未开格类型微光常显覆盖预读价值，2026-09-29 用户拍板退役；
|
||
# 行名保留=meta.tres workshop_items 六件词表恰全校验兼容，存档 item_unlocks 旧键无害；
|
||
# 免活性校验、不入投放校验、不入 F2 覆盖面、奖励节点/掉落池排除）
|
||
# deferred = 效果失义待重定行（probe_dust/catacomb_scroll——原显影半边随雾格移除失义，效果与目标
|
||
# 随魔法道具整体重设计归 Alpha（2026-09-20 用户拍板）；免 effect_kinds 非空校验、不入投放与 F2）
|
||
# 承重护栏（魔法道具 GDD §结构冻结，schema 校验强制不靠运行时拦截）：
|
||
# 真视窄域——effect_kinds 含 mine_reveal 的活行 target 必须 area_3x3（真视一次最多 3×3，禁全图看雷）；
|
||
# board_wide 仅恢复推理原料类——target=board_wide 的活行 effect_kinds 不得含 mine_reveal（现行无此类活行，
|
||
# 显影载体待 Alpha 重定后落位）。
|
||
class_name AuxItemTable
|
||
extends Resource
|
||
|
||
@export var rows: Array = [] # Array[Dictionary] 键 item_id
|
||
|
||
const DIMENSIONS := ["info", "risk", "action", "plan", "counter"]
|
||
const EFFECT_KINDS := ["mine_reveal", "reward_preview", "ap_grant"]
|
||
const TARGETS := ["none", "area_3x3", "board_wide"]
|
||
const USE_PHASES := ["active_dig"]
|
||
|
||
|
||
func validate() -> Array:
|
||
var errs: Array = []
|
||
if rows.is_empty():
|
||
# 空表合法态（2026-09-17 用户拍板——切片期无道具内容；F2 覆盖检查仅对非空清单执行）
|
||
return errs
|
||
var seen := {}
|
||
for row in rows:
|
||
var iid: String = row.get("item_id", "")
|
||
if iid == "":
|
||
errs.append({"category": "domain", "message": "item_id 空"})
|
||
continue
|
||
if seen.has(iid):
|
||
errs.append({"category": "dup_key", "message": "item_id 重复: %s" % iid})
|
||
continue
|
||
seen[iid] = true
|
||
if String(row.get("display_name", "")) == "":
|
||
errs.append({"category": "domain", "message": "%s display_name 空" % iid})
|
||
var retired: bool = bool(row.get("retired", false))
|
||
var deferred: bool = bool(row.get("deferred", false))
|
||
# dimension_tags：五维词表 + 非空（退役/失义行仍须登记维度——语义面保留）
|
||
var tags: Array = row.get("dimension_tags", [])
|
||
if tags.is_empty():
|
||
errs.append({"category": "domain", "message": "%s dimension_tags 空" % iid})
|
||
for tag in tags:
|
||
if not DIMENSIONS.has(String(tag)):
|
||
errs.append({"category": "enum", "message": "%s dimension_tag 出域 %s: %s" % [iid, str(DIMENSIONS), str(tag)]})
|
||
var kinds: Array = row.get("effect_kinds", [])
|
||
var target: String = String(row.get("target", "none"))
|
||
if not TARGETS.has(target):
|
||
errs.append({"category": "enum", "message": "%s target 出域 %s: %s" % [iid, str(TARGETS), target]})
|
||
var phase: String = String(row.get("use_phase", "active_dig"))
|
||
if not USE_PHASES.has(phase):
|
||
errs.append({"category": "enum", "message": "%s use_phase 出域 %s: %s" % [iid, str(USE_PHASES), phase]})
|
||
if retired or deferred:
|
||
# 退役/失义行：免 effect_kinds 非空与承重护栏校验（登记面保留，不入投放与 F2）
|
||
continue
|
||
# ---- 活行校验 ----
|
||
if kinds.is_empty():
|
||
errs.append({"category": "domain", "message": "%s effect_kinds 空（活行；失义件应标 deferred）" % iid})
|
||
var kind_seen := {}
|
||
for k in kinds:
|
||
var kind: String = String(k)
|
||
if not EFFECT_KINDS.has(kind):
|
||
errs.append({"category": "enum", "message": "%s effect_kind 出域 %s: %s" % [iid, str(EFFECT_KINDS), kind]})
|
||
if kind_seen.has(kind):
|
||
errs.append({"category": "dup_key", "message": "%s effect_kind 重复: %s" % [iid, kind]})
|
||
kind_seen[kind] = true
|
||
# 承重护栏①真视窄域：mine_reveal 活行 target 必须 area_3x3（一次最多 3×3，禁全图看雷）
|
||
if kind_seen.has("mine_reveal") and target != "area_3x3":
|
||
errs.append({"category": "load_bearing", "message": "%s 真视窄域护栏：mine_reveal 行 target 必须 area_3x3，实得 %s（魔法道具 GDD 结构冻结）" % [iid, target]})
|
||
# 承重护栏②board_wide 仅恢复推理类：全图域行禁替推理效果
|
||
if target == "board_wide" and kind_seen.has("mine_reveal"):
|
||
errs.append({"category": "load_bearing", "message": "%s board_wide 行 effect_kinds 不得含 mine_reveal（全图域仅恢复推理原料类——Alpha 重定后落位）" % iid})
|
||
# magnitude：仅 ap_grant 行消费（≥1）；非 ap_grant 活行恒 0
|
||
var mag: int = int(row.get("magnitude", 0))
|
||
if mag < 0 or mag > 999:
|
||
errs.append({"category": "domain", "message": "%s magnitude 越域 [0,999]: %d" % [iid, mag]})
|
||
if kind_seen.has("ap_grant") and mag < 1:
|
||
errs.append({"category": "cross_field", "message": "%s ap_grant 行 magnitude 应 ≥1，实得 %d" % [iid, mag]})
|
||
if not kind_seen.has("ap_grant") and mag != 0:
|
||
errs.append({"category": "cross_field", "message": "%s 非 ap_grant 活行 magnitude 应 0，实得 %d" % [iid, mag]})
|
||
return errs
|
||
|
||
|
||
# 活行词表（非 retired 非 deferred）——投放校验/奖励节点池/F2 覆盖面的唯一取数口径
|
||
func active_rows() -> Array:
|
||
var out: Array = []
|
||
for row in rows:
|
||
if not bool(row.get("retired", false)) and not bool(row.get("deferred", false)):
|
||
out.append(row)
|
||
return out
|
||
|
||
|
||
func row_by_id(item_id: String) -> Dictionary:
|
||
for row in rows:
|
||
if String(row.get("item_id", "")) == item_id:
|
||
return row
|
||
return {}
|