chore: 版本号升级到 0.1.37（package.json/AGENTS.md/MOD_GUIDE.md/ApiFacade/storeHelper/SettingsPanel/slots/测试断言）

docs/MOD_GUIDE.md

@@ -131,6 +131,7 @@ macOS:   ~/Library/Application Support/Electron/mods/
 | 内容面 | `aspirations` | §9.5 | 志向（修为/战斗/市贸/产田/生育/声望） | 摘除 |
 | 内容面 | `formations` | §9.5 | 阵型（攻击/防御/撤退伤） | 摘除 |
 | 内容面 | `traits` | §9.5 | 性格（修为/突破/战力/魅力/售价加成） | 摘除 |
+| 内容面 | `wonders` | §9.7 | 世界奇观类型（零 rng 种子派生选取——自定义奇观加入年首判定池） | 摘除 |
 | 微调 | `patch` | §9.6 | 对**已存在**表项改数值（mult 或 add）——不改结构只改数 | 按插件归属复原 |
 
 ### 2.3 一个"五脏俱全"的示意壳（啃编排用）
@@ -158,6 +159,7 @@ macOS:   ~/Library/Application Support/Electron/mods/
     "aspirations":   [ /* §9.5 */ ],
     "formations":    [ /* §9.5 */ ],
     "traits":        [ /* §9.5 */ ],
+    "wonders":       [ /* §9.7 */ ],
     "patch":         [ /* §9.6 */ ]
   }
 }
@@ -943,11 +945,48 @@ macOS:   ~/Library/Application Support/Electron/mods/
 
 ---
 
-**一句话总结**：MOD = 一个有 `data` 字段的 JSON。事件管"剧情"、模板管"新家族"、词库管"名字概率"、灾因管"灾年种类"、丹方铸器管"炼丹造兵"、worldNum 管"世界脾性"、内容面七口管"新物品/功法/建筑/职事/志向/阵型/性格"、patch 管"已有表项微调"。装/卸/导出全在设置页，读档重装全自动。去写吧——这个世界等你的素材。
+### 9.7 世界奇观类型扩展（wonders） · 0.1.37 新增
+
+0.1.37 引入**世界奇观**——年首种子派生判定（零 rng 消耗），4 种内置奇观：灵气涌潮 / 古遗迹现身 / 天降祥瑞 / 灵脉枯竭。
+
+MOD 可以注册**自定义奇观类型**，加入年首种子派生选取池：
+
+```jsonc
+"wonders": [
+  {
+    "kind": "star_fall",        // 唯一 id（不可与内置 tide_surge/ancient_ruin/heaven_bless/qi_wane 冲突）
+    "name": "星陨天落",          // 中文名称
+    "desc": "天外陨星坠落——灵气激荡，宝材出世。",  // 描述文本
+    "duration": 12,              // 持续月数（0 = 一次性）
+    "effect": "tide_up",         // 持续效果：tide_up=灵气增益 / tide_down=灵气衰减 / none=无
+    "oneshot": "loot"            // 一次性效果：bless=灾年消弭+声望+5 / loot=随机资源获取 / none=无
+  }
+]
+```
+
+**字段说明**：
+
+| 字段 | 必填 | 取值 | 说明 |
+|------|------|------|------|
+| `kind` | ✓ | 唯一字符串 | 奇观类型 id（与内置+已注册不冲突） |
+| `name` | ✗ | 字符串 | 中文名（缺省"异变"） |
+| `desc` | ✗ | 字符串 | 描述（缺省"天地异变，灵机暗涌。"） |
+| `duration` | ✗ | 0~60 | 持续月数（缺省 0=一次性） |
+| `effect` | ✗ | `tide_up`/`tide_down`/`none` | 持续月度效果（缺省 `none`） |
+| `oneshot` | ✗ | `bless`/`loot`/`none` | 出现时一次性效果（缺省 `none`） |
+
+> **零 rng 保证**：奇观判定使用种子哈希派生（`seed ^ year ^ npcSuccessions`），不消耗 `rng.next()` 序列——金钟罩确定性不受影响。
+> **因果事件**：事件选项 `eff.karma` 可正可负——MOD 事件天然支持因果变动（无需额外口）。
+> **worldNum 白名单**：`wonderChance`（0.08）/ `karmaDecayRate`（0.1）/ `karmaHighThreshold`（30）/ `karmaLowThreshold`（-20）可经 `data.worldNum` 覆写。
+
+---
+
+**一句话总结**：MOD = 一个有 `data` 字段的 JSON。事件管"剧情"、模板管"新家族"、词库管"名字概率"、灾因管"灾年种类"、丹方铸器管"炼丹造兵"、worldNum 管"世界脾性"、内容面八口管"新物品/功法/建筑/职事/志向/阵型/性格/奇观"、patch 管"已有表项微调"。装/卸/导出全在设置页，读档重装全自动。去写吧——这个世界等你的素材。
 
 > 0.1.32 玩注：资源循环已是六类生态（资源/材料/丹药/符箓/灵酿/兵器），新物产入池即参与世界呼吸与 NPC 贸易——写材料口别怕世界吃不进去。
 > 0.1.33 闭环注：符箓开战即耗（风符×1.12/山符×1.15+减伤——零 rng 结算），灵酿渡劫伤后自动回气；丹方/铸器产出物 ALL 必须先在物品表立名（否则幽灵物品不可见不可卖）。
 > 0.1.34 功法注：四流派效果 crit/guard/trib/secret 全 optional——缺省零行为，金钟罩安全；元素时节共鸣 4 季同频（土系恒应）。
 > 0.1.35 涤荡注：无存档迁移（游戏未发布——旧档随版本演进失效属预期）；`patch` 层按插件归属回滚；validate 覆盖 §12 全部规则。
+> 0.1.37 因果奇观注：奇观零 rng（种子派生选取池含 MOD 扩展）；`eff.karma` 天然支持；`wonderChance`/`karmaDecayRate`/`karmaHighThreshold`/`karmaLowThreshold` 可经 worldNum 覆写；飞升事件 `ev-ascension-*` 前缀保护防劫持。
 
-<sub>⚔️ 本文档随游戏版本更新（0.1.36）。字段若有新增，此处先行。</sub>
+<sub>⚔️ 本文档随游戏版本更新（0.1.37）。字段若有新增，此处先行。</sub>