feat: W2 经济核心+数据管线+灰盒 — Balance Bible v1.0 八表逐值落地，EconomyState/sim 14 门/灰盒主场景/单测（GDScript 待本机引擎验证）

data/schema/balance_tuning.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "balance_tuning.schema.json",
+  "title": "balance_tuning 表 schema v0（全局调参数，Balance Bible v1.0 §1/§3.2/§4/§8）",
+  "description": "架构 §2.1 已列名；容纳七张内容表无归属行的全局参数：三乘区软上限/点击基础值（[B§1/§2.2]）、离线衰减表 + 72h 封顶（[B§8]）、冤煞层 22 层公式参数（[B§3.2]）、宿慧公式/跳过机制/敕封触发/重开曲线（[B§4]）。kind=number 时 num 有效；kind=text 时 text 有效（另一列填 0/空串）。新增参数 = 加行（稳定 ID）。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "balance_tuning" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 5
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "kind", "num", "text", "desc_cn"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^tune_[a-z0-9_]+$", "description": "稳定字符串 ID（永不重编号）" },
+          "kind": { "type": "string", "enum": ["number", "text"] },
+          "num": { "type": "number", "minimum": 0, "description": "kind=number 时的值；kind=text 时填 0" },
+          "text": { "type": "string", "description": "kind=text 时的值（如重开曲线 1:0.6:0.4:0.3）；kind=number 时为空串" },
+          "desc_cn": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/schema/boss_battles.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "boss_battles.schema.json",
+  "title": "boss_battles 表 schema v0（十场殿王战参数，数值抄录自 Balance Bible v1.0 §5）",
+  "description": "架构 §3.2 CSV 规范落盘。HP = hp_factor × 进入时产出/s × hall_factor（[B§5]：强度跟随产出，任何水平 ~30s 的仗；hp_factor=15 为 [B§11 差异#4] 修复值，GDD 旧值 50 已废止）。军列 DPS = 产出/s × army_dps_factor。点击伤害 = 点击价值 × 点击区倍率 × 连击（combo_step/层，combo_cap 封顶）。INTRO 开场伤害 = min(超度值×intro_dmg_souls_factor, HP×intro_dmg_cap_ratio)。通过奖励 = 阴德爆发 HP×reward_hp_ratio。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id", "hall_id"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "boss_battles" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 14
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 10,
+      "maxItems": 10,
+      "items": {
+        "type": "object",
+        "required": [
+          "id", "hall_id", "hall_factor", "hp_factor", "army_dps_factor",
+          "intro_sec", "intro_dmg_souls_factor", "intro_dmg_cap_ratio",
+          "active_sec", "combo_window_sec", "combo_step", "combo_cap",
+          "retry_cooldown_sec", "reward_hp_ratio"
+        ],
+        "properties": {
+          "id": { "type": "string", "pattern": "^boss_hall_[0-9]{2}$" },
+          "hall_id": {
+            "type": "string",
+            "pattern": "^hall_[0-9]{2}_[a-z]+$",
+            "description": "halls.csv 行 ID（每殿恰一场）"
+          },
+          "hall_factor": {
+            "type": "number",
+            "minimum": 1,
+            "maximum": 3,
+            "description": "殿系数（[B§5] H1-H10 = 1.0/1.1/1.2/1.3/1.4/1.6/1.8/2.0/2.1/2.2）"
+          },
+          "hp_factor": {
+            "const": 15,
+            "description": "HP 系数（[B§5]：15×产出/s×殿系数；[B§11] 由 GDD 50 修正）"
+          },
+          "army_dps_factor": { "type": "number", "minimum": 0, "description": "军列 DPS = 产出/s × 本值（[B§5] 1.0）" },
+          "intro_sec": { "type": "integer", "minimum": 0, "description": "INTRO 冲锋过场秒数（3s）" },
+          "intro_dmg_souls_factor": { "type": "number", "minimum": 0, "description": "开场伤害 = 超度值 × 本值（0.5）" },
+          "intro_dmg_cap_ratio": { "type": "number", "minimum": 0, "maximum": 1, "description": "开场伤害封顶 = HP × 本值（0.2）" },
+          "active_sec": { "type": "integer", "minimum": 1, "description": "ACTIVE 主动阶段秒数（30s）" },
+          "combo_window_sec": { "type": "number", "minimum": 0, "description": "连击窗口（0.6s）" },
+          "combo_step": { "type": "number", "minimum": 0, "description": "连击每层加成（+2%）" },
+          "combo_cap": { "type": "number", "minimum": 0, "maximum": 1, "description": "连击封顶（+60%）" },
+          "retry_cooldown_sec": { "type": "integer", "minimum": 0, "description": "失败后再战冷却（60s；H7 前败即等推 → up_gate_boss_retry）" },
+          "reward_hp_ratio": { "type": "number", "minimum": 0, "maximum": 1, "description": "通过奖励阴德爆发 = HP × 本值（0.2）" }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/schema/events.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "events.schema.json",
+  "title": "events 表 schema v0（4 事件，数值抄录自 Balance Bible v1.0 §7）",
+  "description": "架构 §3.2 CSV 规范落盘。事件倍率走独立瞬时区，不进全局乘区（[B§0.3/§7]）。参数列语义（按 type 取用）：p_mult=output_mult 全产出倍率 / click_output_mult 产出倍率部分；p_clicks=click_challenge 需点击次数 / click_output_mult 点击倍率 / choice 冤气增益下限；p_window_sec=click_challenge 窗口秒 / choice 冤气增益上限（随殿序 lerp）；p_penalty+p_penalty_dur_sec=click_challenge 失败惩罚；opt_a_*/opt_b_*=choice 二选一（merit_burst_sec=阴德爆发秒数 / wrath_gain=冤气增益）。出现前提 = up_gate_events（过 H2，[B§2.3]）。冤魂申诉超时默认 opt_a（超度）。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "events" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 17
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 4,
+      "maxItems": 4,
+      "items": {
+        "type": "object",
+        "required": [
+          "id", "name_cn", "name_en", "trigger_min_min", "trigger_max_min",
+          "duration_sec", "type", "p_mult", "p_clicks", "p_window_sec",
+          "p_penalty", "p_penalty_dur_sec", "opt_a_type", "opt_a_param",
+          "opt_b_type", "opt_b_param", "flavor_cn"
+        ],
+        "properties": {
+          "id": { "type": "string", "pattern": "^ev_[0-9]{2}_[a-z]+$" },
+          "name_cn": { "type": "string", "minLength": 1 },
+          "name_en": { "type": "string", "minLength": 1, "description": "临时译名，待文策渊 glossary" },
+          "trigger_min_min": { "type": "integer", "minimum": 1, "description": "触发间隔下限（分钟）" },
+          "trigger_max_min": { "type": "integer", "minimum": 1, "description": "触发间隔上限（分钟，含）" },
+          "duration_sec": { "type": "integer", "minimum": 1, "description": "持续秒数（冤魂申诉为非阻塞决策窗）" },
+          "type": {
+            "type": "string",
+            "enum": ["output_mult", "click_challenge", "choice", "click_output_mult"]
+          },
+          "p_mult": { "type": "number", "minimum": 0 },
+          "p_clicks": { "type": "integer", "minimum": 0 },
+          "p_window_sec": { "type": "number", "minimum": 0 },
+          "p_penalty": { "type": "number", "minimum": 0, "maximum": 1, "description": "click_challenge 失败惩罚倍率（0.5 = -50%）" },
+          "p_penalty_dur_sec": { "type": "integer", "minimum": 0 },
+          "opt_a_type": { "type": "string", "enum": ["none", "merit_burst_sec", "wrath_gain"] },
+          "opt_a_param": { "type": "number", "minimum": 0 },
+          "opt_b_type": { "type": "string", "enum": ["none", "merit_burst_sec", "wrath_gain"] },
+          "opt_b_param": { "type": "number", "minimum": 0 },
+          "flavor_cn": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/schema/generators.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "generators.schema.json",
-  "title": "generators 表 schema v0（十二班底发生器，数值抄录自 GDD §3.1）",
-  "description": "架构 §3.2 CSV 规范落盘。数值列禁千分位；引用列填目标 ID 或 none；ID 一旦分配永不重编号。v0 仅做单表校验：unlock_hall/unlock_gate 引用的 halls.csv / upgrades.csv 目标表 W2 落盘，届时激活跨表引用完整性校验。",
+  "title": "generators 表 schema v0（十二班底发生器，数值抄录自 Balance Bible v1.0 §1）",
+  "description": "架构 §3.2 CSV 规范落盘。数值列禁千分位；引用列填目标 ID 或 none；ID 一旦分配永不重编号。速率 = 8 的纯幂阶梯（gen1=0.1；gen_n=8^(n-2)，[B§1]/[B§11 差异#1] 修复 GDD 6.25× 异常档）；成本 gen1→gen2 为 8×（点击养成档，设计意图），gen2 起恒 10×。v0 仅做单表校验：unlock_hall/unlock_gate 引用的 halls.csv / upgrades.csv 目标表已落盘（W2），跨表引用完整性由 DataRegistry 载入时检查。",
   "x-supported-keywords": [
     "type", "properties", "required", "items", "enum", "pattern",
     "minimum", "maximum", "minLength", "minItems", "maxItems",
@@ -68,7 +68,7 @@
           "unlock_gate": {
             "type": "string",
             "pattern": "^(none|up_gate_[a-z0-9_]+)$",
-            "description": "路引闸门 ID（upgrades.csv 行 ID）或 none；gen_12 的敕封前置（宿慧≥60 且转世≥2）属 upgrades.csv 行内规则，W2 建模"
+            "description": "路引闸门 ID（upgrades.csv 行 ID）或 none；gen_12 的敕封前置 = up_gate_tianzi 需转世≥2（[B§4.4]，W2 已建模为 upgrades.csv 行内条件）"
           },
           "sprite_row": {
             "type": "string",

data/schema/hall_palettes.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "hall_palettes.schema.json",
+  "title": "hall_palettes 表 schema v0（per-hall 色板行，架构 §5.3 + Balance Bible v1.0 §6 色板列）",
+  "description": "架构 §3.2 CSV 规范落盘。一行 = 一殿：水墨四色（墨/骨白/朱砂/靛）+ 该殿色温 accent + 流向向量 + LUT 索引 + 四色面积纪律百分比。hex 为工程起始值，W5 look-dev 冻结评审按截图直方图校准（架构 §10.1 评审清单 #1）。lut_generator.tres 消费本表。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id", "hall_id", "lut_index"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "hall_palettes" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 15
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 10,
+      "maxItems": 10,
+      "items": {
+        "type": "object",
+        "required": [
+          "id", "hall_id", "name_cn", "ink_hex", "bone_hex", "cinnabar_hex",
+          "indigo_hex", "accent_hex", "accent_name_cn", "flow", "lut_index",
+          "ink_pct", "bone_pct", "cinnabar_max_pct", "indigo_max_pct"
+        ],
+        "properties": {
+          "id": { "type": "string", "pattern": "^pal_hall_[0-9]{2}$" },
+          "hall_id": {
+            "type": "string",
+            "pattern": "^hall_[0-9]{2}_[a-z]+$",
+            "description": "halls.csv 行 ID（每殿恰一行）"
+          },
+          "name_cn": { "type": "string", "minLength": 1, "description": "色板行名（[B§6]：冷靛/冰青/暗红/锈橙/玄黑/铅灰/烬红/墨绿/黛紫/骨白+金）" },
+          "ink_hex": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$", "description": "墨（默认 #1A1A1A，架构 §7.3 管线规格）" },
+          "bone_hex": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$", "description": "骨白（纸底）" },
+          "cinnabar_hex": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$", "description": "朱砂（强调，面积 ≤8%）" },
+          "indigo_hex": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$", "description": "靛（次强调，面积 ≤7%；阴德方印编码用）" },
+          "accent_hex": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$", "description": "该殿色温 accent（工程起始值，W5 校准）" },
+          "accent_name_cn": { "type": "string", "minLength": 1 },
+          "flow": {
+            "type": "string",
+            "enum": ["seep_down", "bleed_left"],
+            "description": "纸纹流向向量：自上而下渗 vs 向左横溢洇（架构 §5.3；工程起始值，W5 校准）"
+          },
+          "lut_index": { "type": "integer", "minimum": 1, "maximum": 10, "description": "LUT 索引（assets/luts/hall_XX.png）" },
+          "ink_pct": { "type": "integer", "minimum": 0, "maximum": 100, "description": "墨面积目标%（[B] 65）" },
+          "bone_pct": { "type": "integer", "minimum": 0, "maximum": 100, "description": "骨白面积目标%（[B] 25）" },
+          "cinnabar_max_pct": { "type": "integer", "minimum": 0, "maximum": 100, "description": "朱砂面积硬顶（[B] ≤8）" },
+          "indigo_max_pct": { "type": "integer", "minimum": 0, "maximum": 100, "description": "靛面积硬顶（[B] ≤7）" }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/schema/halls.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "halls.schema.json",
+  "title": "halls 表 schema v0（十殿 band 数据行，数值抄录自 Balance Bible v1.0 §6）",
+  "description": "架构 §3.2 CSV 规范落盘。每殿 = 一个横向 band（2-3 屏宽 @1920，四层组装）。殿门 = 单计数器闸门（本轮累计阴德 merit_run ≥ gate_merit，[B§0.1]）；is_prestige_gate=true 的行是轮回转世触发门（仅 H10）。unlock_gen/unlock_gate = 过殿后解锁批。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "halls" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 12
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 10,
+      "maxItems": 10,
+      "items": {
+        "type": "object",
+        "required": [
+          "id", "no", "king_cn", "king_en", "motif_cn", "motif_en",
+          "target_min", "gate_merit", "unlock_gen", "unlock_gate",
+          "palette_id", "is_prestige_gate"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^hall_[0-9]{2}_[a-z]+$",
+            "description": "稳定字符串 ID（W1 已分配）；永不重编号（年更=加行）"
+          },
+          "no": { "type": "integer", "minimum": 1, "maximum": 10 },
+          "king_cn": { "type": "string", "minLength": 1 },
+          "king_en": { "type": "string", "minLength": 1, "description": "临时译名，待文策渊 glossary" },
+          "motif_cn": { "type": "string", "minLength": 1, "description": "刑典母题（剪影+文字暗示路线，GDD §0.3 IP 红线）" },
+          "motif_en": { "type": "string", "minLength": 1 },
+          "target_min": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "到达目标时长（分钟，[B§6] pacing 表：25→180min）；模拟器门 #3/#5/#14 对照"
+          },
+          "gate_merit": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "殿门条件：本轮累计阴德（单计数器；[B§6] 2K→1.5B）"
+          },
+          "unlock_gen": {
+            "type": "string",
+            "pattern": "^(none|gen_[0-9]{2}_[a-z0-9]+)$",
+            "description": "过殿解锁的班底 ID；H10 = none（prestige 门）"
+          },
+          "unlock_gate": {
+            "type": "string",
+            "pattern": "^(none|up_gate_[a-z0-9_]+)$",
+            "description": "过殿出现的路引闸门 ID（upgrades.csv）；H10 = none"
+          },
+          "palette_id": {
+            "type": "string",
+            "pattern": "^pal_hall_[0-9]{2}$",
+            "description": "hall_palettes.csv 行 ID（per-hall 色板 + 流向向量）"
+          },
+          "is_prestige_gate": {
+            "type": "boolean",
+            "description": "true = 轮回转世触发门（[B§4.1]：仅 H10 转轮王）"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/schema/meta_upgrades.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "meta_upgrades.schema.json",
+  "title": "meta_upgrades 表 schema v0（12 条宿慧商店，数值抄录自 Balance Bible v1.0 §2.5）",
+  "description": "架构 §3.2 CSV 规范落盘。货币 = 宿慧（跨轮回永久，永不离场——身份资产层）。max_rank>1 可重复购买（每阶独立计费）。condition=gen12_unlocked 表示效果仅 gen12 解锁后生效（meta_12）。effect_type 语义：start_levels=新轮回开局 target_gen 自带 param 级；suihui_gain_pct=宿慧获取 +param；skip_interval=跳过机制间隔改为 param 级；offline_pct=离线效率 +param；boss_click_pct=殿王战点击伤害 +param；wrath_penalty_set=冤气削减设为 param（替代默认 0.3）；global_pct=全局 +param/阶；event_freq_pct=事件频率 +param；souls_mult=超度计数 ×param；bulk_unlock=开局批量×10；conditional_global_pct=条件全局 +param。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "meta_upgrades" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 10
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 12,
+      "maxItems": 12,
+      "items": {
+        "type": "object",
+        "required": [
+          "id", "name_cn", "name_en", "effect_type", "target_id",
+          "effect_param", "cost_suihui", "max_rank", "condition", "desc_cn"
+        ],
+        "properties": {
+          "id": { "type": "string", "pattern": "^meta_[0-9]{2}$" },
+          "name_cn": { "type": "string", "minLength": 1 },
+          "name_en": { "type": "string", "minLength": 1, "description": "临时译名，待文策渊 glossary" },
+          "effect_type": {
+            "type": "string",
+            "enum": [
+              "start_levels", "suihui_gain_pct", "skip_interval", "offline_pct",
+              "boss_click_pct", "wrath_penalty_set", "global_pct", "event_freq_pct",
+              "souls_mult", "bulk_unlock", "conditional_global_pct"
+            ]
+          },
+          "target_id": {
+            "type": "string",
+            "pattern": "^(|gen_[0-9]{2}_[a-z0-9]+)$",
+            "description": "start_levels/conditional_global_pct 的目标班底 ID；其余为空串"
+          },
+          "effect_param": { "type": "number", "minimum": 0 },
+          "cost_suihui": { "type": "integer", "minimum": 1, "description": "宿慧成本（[B§2.5] 钉值 3-25）" },
+          "max_rank": { "type": "integer", "minimum": 1, "description": "可购买阶数上限（m03=3、m08=2，其余 1）" },
+          "condition": {
+            "type": "string",
+            "enum": ["none", "gen12_unlocked"],
+            "description": "效果生效条件"
+          },
+          "desc_cn": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/schema/upgrades.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "upgrades.schema.json",
+  "title": "upgrades 表 schema v0（108 条升级，数值抄录自 Balance Bible v1.0 §2）",
+  "description": "架构 §3.2 CSV 规范落盘。配比 [B§2]：效率 72（12 班底×6 级，+100%/级加法，成本 C0×r^(10+4n) 取整）+ 点击 12（L1-4 ×2；L5-12 +1% 产出/s）+ 路引 18（10 入职文书 + 8 系统闸门，纯解锁零效果）+ 离线 6（×1.15/级）。与 meta_upgrades.csv 合计 120。ID 稳定永不重编号；display_en 为临时译名待文策渊 glossary。requires=enthrone_ready 表示敕封动作就绪（转世≥2 且宿慧≥60）后才可购（仅 up_gate_tianzi，provenance P-12；W2 初版误置 enthroned 会造成死锁，已修）。",
+  "x-supported-keywords": [
+    "type", "properties", "required", "items", "enum", "pattern",
+    "minimum", "maximum", "minLength", "minItems", "maxItems",
+    "additionalProperties", "const"
+  ],
+  "x-unique": ["id"],
+  "type": "object",
+  "required": ["sheet", "schema_version", "columns", "rows"],
+  "properties": {
+    "sheet": { "const": "upgrades" },
+    "schema_version": { "const": 0 },
+    "columns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 11
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 108,
+      "items": {
+        "type": "object",
+        "required": [
+          "id", "name_cn", "name_en", "type", "target_gen", "unlock_hall",
+          "effect_type", "effect_param", "requires", "cost", "desc_cn"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^up_[a-z0-9_]+$",
+            "description": "稳定字符串 ID：up_eff_<gen_id>_<1-6> / up_click_<1-12> / up_offline_<1-6> / up_gate_<name>（入职文书 ID 与 generators.unlock_gate 引用一致，W1 已分配）"
+          },
+          "name_cn": { "type": "string", "minLength": 1 },
+          "name_en": { "type": "string", "minLength": 1, "description": "临时译名，待文策渊 glossary" },
+          "type": {
+            "type": "string",
+            "enum": ["efficiency", "click", "gate_hire", "gate_system", "offline"],
+            "description": "efficiency=班底效率；click=点击；gate_hire=班底入职文书（target_gen 解锁）；gate_system=系统闸门；offline=离线效率"
+          },
+          "target_gen": {
+            "type": "string",
+            "pattern": "^(none|gen_[0-9]{2}_[a-z0-9]+)$",
+            "description": "efficiency/gate_hire 指向的班底 ID（generators.csv）；其余 none"
+          },
+          "unlock_hall": {
+            "type": "string",
+            "pattern": "^(none|hall_[0-9]{2}_[a-z]+)$",
+            "description": "出现条件：通过哪殿后可见/可购；efficiency 随所属班底殿门，offline 随 H4（离线收益系统闸门），click 无门"
+          },
+          "effect_type": {
+            "type": "string",
+            "enum": ["gen_output_add", "click_mult", "click_output_pct", "offline_mult", "unlock"],
+            "description": "gen_output_add=班底产出加法(+param)；click_mult=点击价值×param；click_output_pct=点击附加产出/s 的 param 比例；offline_mult=离线效率×param；unlock=纯解锁（param=0）"
+          },
+          "effect_param": {
+            "type": "number",
+            "minimum": 0,
+            "description": "效果参数（见 effect_type）；efficiency=1（+100%），click_mult=2，click_output_pct=0.01，offline_mult=1.15，unlock=0"
+          },
+          "requires": {
+            "type": "string",
+            "enum": ["none", "enthrone_ready", "enthroned"],
+            "description": "购买前置条件：none=无；enthrone_ready=转世≥2 且宿慧≥60（敕封动作就绪，仅 up_gate_tianzi，provenance P-12）；enthroned=需已受敕（预留枚举，现无行使用）"
+          },
+          "cost": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "阴德成本（禁千分位）。效率 = round(C0×r^(10+4n))；入职文书 = round(C0×2/3)（g03=800 钉值复现）；系统闸门 = 殿门阈值÷2（工程外推， provenance P-5）；点击/离线 = [B§2.2/§2.4] 钉值"
+          },
+          "desc_cn": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}