v0.0.3: cut game-version bump cost to one command + a delta checklist

.gitattributes

@@ -0,0 +1,7 @@
+# Tool-generated artifacts: keep them committed (runtime/deploy needs them),
+# but collapse them in diffs/PR review and language stats.
+data/**/generated/** linguist-generated -diff
+data/**/overlay/** linguist-generated
+# Hand-curated overlay entries must stay reviewable.
+data/**/overlay/special_mods.json -linguist-generated diff
+examples/demo-bd-test/builds/*/meta.json linguist-generated -diff

.gitignore

@@ -5,6 +5,8 @@
 /target-gate/
 /target-master/
 /target-dualrun/
+# vendor-delta 报告的 codeload tarball 缓存（pipeline/diff-vendor-calcs.sh）
+/.cache/
 
 # 本机相关的 cargo 配置（网络卷开发时 target-dir 重定向到本地盘）
 /.cargo/config.toml

Cargo.toml

@@ -21,7 +21,7 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "0.0.2"
+version = "0.0.3"
 edition = "2024"
 
 [workspace.dependencies]

apps/pobr-cli/src/lib.rs

@@ -584,6 +584,10 @@ fn explain_tag(tag: &ModTag) -> TagExplain {
             kind: "SkillTypes".to_string(),
             detail: format!("限技能类型 {st:?}"),
         },
+        ModTag::SkillTypesNeg(st) => TagExplain {
+            kind: "SkillTypesNeg".to_string(),
+            detail: format!("排除技能类型 {st:?}"),
+        },
         ModTag::SkillName { names } => TagExplain {
             kind: "SkillName".to_string(),
             detail: format!("仅当主技能是 `{}` 时生效", names.join("` / `")),

apps/pobr-desktop/src/lib.rs

@@ -31,6 +31,7 @@ pub fn example_build() -> Build {
         base: ItemBaseId::from("Iron Ring"),
         rarity: ItemRarity::Rare,
         quality: 0,
+        corrupted: false,
         implicit_texts: vec![],
         modifier_texts: vec![
             "+25 to maximum Life".to_string(),

apps/pobr-wasm/src/build_api/analysis.rs

@@ -248,6 +248,7 @@ fn apply_variant(
                 gem_level: gem.level,
                 quality: gem.quality,
                 stat_set_index: None,
+                name_spec: None,
             });
             if let Some(effect) = data.gem_effects.get(&gem.skill_id) {
                 group.gem_ids.push(effect.gem_id.clone());

apps/pobr-wasm/src/build_api/request.rs

@@ -192,6 +192,7 @@ fn socket_group_from_input(input: &SocketGroupInput, data: &BuildData) -> Socket
             gem_level: gem.level,
             quality: gem.quality,
             stat_set_index: None,
+            name_spec: None,
         });
         if let Some(gem_id) = gem_id {
             group.gem_ids.push(gem_id);

apps/pobr-wasm/tests/contract_golden.rs

@@ -1135,21 +1135,30 @@ fn memory_backend_matches_dir_backend() {
     let request = serde_json::json!({ "pob_code": demo_code() }).to_string();
     let from_dir = pobr_wasm::calculate_build_json(&request).expect("dir backend");
 
-    // 把版本目录整体读入内存表，走 stage/init 路径重建。
+    // 把版本目录整体读入内存表，走 stage/init 路径重建。版本无关策展层
+    // `data/overlay-common/`（P1-3）位于版本目录的兄弟路径，内存后端按
+    // `overlay-common/<rel>` 键解析（见 `pobr-gamedata::paths::overlay_common_path`），
+    // 生产 wasm 流程（web sync-data）同样打包该目录——staging 必须一并灌入，
+    // 否则内存后端静默丢失全部 curated special_mods。
     let root = repo_data_root().join(pobr_data::GOLDEN_PARITY_DATA_VERSION);
-    for entry in walk_files(&root) {
-        // GameData 只读 JSON；跳过杂项文件（.DS_Store 等）。
-        if entry.extension().and_then(|e| e.to_str()) != Some("json") {
-            continue;
+    let common_root = repo_data_root().join("overlay-common");
+    let stage_tree = |tree_root: &std::path::Path, key_prefix: &str| {
+        for entry in walk_files(tree_root) {
+            // GameData 只读 JSON；跳过杂项文件（.DS_Store 等）。
+            if entry.extension().and_then(|e| e.to_str()) != Some("json") {
+                continue;
+            }
+            let rel = entry
+                .strip_prefix(tree_root)
+                .unwrap()
+                .to_string_lossy()
+                .replace('\\', "/");
+            let content = std::fs::read_to_string(&entry).expect("read data file");
+            pobr_wasm::stage_data_file(&format!("{key_prefix}{rel}"), &content);
         }
-        let rel = entry
-            .strip_prefix(&root)
-            .unwrap()
-            .to_string_lossy()
-            .replace('\\', "/");
-        let content = std::fs::read_to_string(&entry).expect("read data file");
-        pobr_wasm::stage_data_file(&rel, &content);
-    }
+    };
+    stage_tree(&root, "");
+    stage_tree(&common_root, "overlay-common/");
     pobr_wasm::init_staged_data().expect("init memory backend");
     let from_memory = pobr_wasm::calculate_build_json(&request).expect("memory backend");
     assert_eq!(

apps/pobr-wasm/tests/tier_lines.rs

@@ -46,11 +46,16 @@ fn current_data_annotates_explicit_tiers() {
 }
 
 /// 优雅降级：无 tier 池字段（group/spawn_weights）的数据包不标 tier。
-/// 显式钉 4.5.0.3.4——它早于 tier 数据通道，缺池字段；golden 版（4.5.4.3 起）
-/// 已含池数据会标 tier，故此降级用例不能再借 `GOLDEN_PARITY_DATA_VERSION`。
+/// 显式钉 4.5.0.3.4——这是「早于 tier 数据通道的旧格式包」的 fixture 钉（非数据
+/// 内容计数钉，不进 test_pins 快照）；golden 版（4.5.4.3 起）已含池数据会标
+/// tier，故此降级用例不能借 `GOLDEN_PARITY_DATA_VERSION`。旧包被清理时跳过。
 #[test]
 fn golden_data_without_pool_fields_omits_tiers() {
     let dir = repo_data_root().join("4.5.0.3.4");
+    if !dir.is_dir() {
+        eprintln!("SKIP: 旧格式 fixture 数据包 4.5.0.3.4 不在仓库（已清理）");
+        return;
+    }
     let lines = classify(dir.to_str().unwrap());
     assert!(
         lines.iter().all(|l| l.get("tier").is_none()),

apps/pobr-wasm/tests/unsupported_specials.rs

@@ -1,6 +1,11 @@
 //! 药剂/护符使用效果类词条经 special 表解析为正确机制语义，不再进未支持报表：
-//! 免疫 → *Immune flag、Guard → GuardAbsorbRate/Limit（承受层真实吸收）、
-//! 瞬时回魔/魔力溢出/附身 → 结构化 mod 登记（vendor 对照与来源见 overlay source_note）。
+//! 免疫 → *Immune flag、瞬时回魔/魔力溢出/附身 → 结构化 mod 登记（vendor 对照
+//! 与来源见 overlay source_note）。
+//!
+//! 例外：`Also grants N Guard` 曾被策展条目 also_grants_guard 建模为承受层吸收，
+//! 但 vendor ModParser 根本不解析它——对 PoB2 golden 是幻影 Guard 池（存量 #7
+//! 摘除，ritualist EHP 1.10x→1.00x）。与 PoB2 对齐后它回到「未建模 → 响亮进
+//! unsupported 报表、不影响 hit pool」的口径。
 
 use pobr_gamedata::repo_data_root;
 use serde_json::{Value, json};
@@ -53,27 +58,33 @@ fn charm_flask_use_effect_lines_are_recognized() {
         "Recover 295 Mana when Used",
         "Mana Recovery from Flasks can Overflow maximum Mana during Effect",
         "Possessed by Spirit Of The Stag for 19 seconds on use",
-        "Also grants 481 Guard",
     ] {
         assert!(
             !unsupported.iter().any(|u| u.contains(line)),
             "`{line}` 仍在未支持列表: {unsupported:?}"
         );
     }
+    // guard 行未建模（vendor 同样不解析）——必须响亮上报而非静默丢弃。
+    assert!(
+        unsupported
+            .iter()
+            .any(|u| u.contains("Also grants 481 Guard")),
+        "`Also grants 481 Guard` 应进未支持列表（#7 摘除幻影建模后与 PoB2 口径一致）: {unsupported:?}"
+    );
 }
 
 #[test]
-fn guard_line_extends_hit_pool() {
+fn guard_line_does_not_extend_hit_pool() {
     let dir = repo_data_root().join(pobr_gamedata::data_version());
     pobr_wasm::init_data_from_dir(dir.to_str().unwrap()).expect("init data");
 
     let without = calculate(false);
     let with = calculate(true);
-    // Guard 是生命/ES 前的全额吸收池（agent-docs/active-defences.md §2）：
-    // 物理 max hit 应至少提高 Guard 池大小（481）。
+    // #7 摘除 also_grants_guard 幻影建模后，guard 行不得再扩大 hit pool
+    // （vendor 不解析该行；此前的 +481 是 PoBR 单方面多建模的幻影池）。
     let delta = stat(&with, "PhysicalMaxHit") - stat(&without, "PhysicalMaxHit");
     assert!(
-        delta >= 481.0,
-        "Guard 481 应扩大物理 max hit（实际增量 {delta}）"
+        delta.abs() < 1.0,
+        "guard 行不应改变物理 max hit（实际增量 {delta}）"
     );
 }

crates/pobr-build/examples/dump_components.rs

@@ -42,6 +42,36 @@ fn main() {
         out.action_rate,
         out.hit_chance
     );
+    // POBR_DUMP_DEFENCE=1：附加防御/EHP 池分解（与 oracle mainOutput 的
+    // <Type>TotalHitPool / LifeRecoverable / MaximumHitTaken 族对照）。
+    if std::env::var("POBR_DUMP_DEFENCE").is_ok() {
+        println!(
+            "  life={:.2} life_unres={:.2} life_recoverable={:.2} es={:.2} es_cap={:.2} ward={:.2} mana={:.2} mana_unres={:.2}",
+            out.life,
+            out.life_unreserved,
+            out.life_recoverable,
+            out.energy_shield,
+            out.energy_shield_recovery_cap,
+            out.ward,
+            out.mana,
+            out.mana_unreserved,
+        );
+        for (i, m) in out.minions.iter().enumerate() {
+            println!(
+                "  minion[{i}]: level={} life={:.2} armour={:.2} evasion={:.2} es={:.2}",
+                m.level, m.life, m.armour, m.evasion, m.energy_shield,
+            );
+        }
+        println!(
+            "  maxhit: phys={:.1} fire={:.1} cold={:.1} light={:.1} chaos={:.1} total_ehp={:.1}",
+            out.physical_max_hit_pob2,
+            out.fire_max_hit_pob2,
+            out.cold_max_hit_pob2,
+            out.lightning_max_hit_pob2,
+            out.chaos_max_hit_pob2,
+            out.total_ehp_pob2,
+        );
+    }
     let mut sum = 0.0;
     for c in &out.damage_components {
         let avg = c.avg();