v0.1.23: 生灭千秋 + 插件生态化第一课（1027 全绿）

【世界模型：世界会死人也会新生】 - 家族生灭：declineYears（power<58+景气<38 连续8年）→ 覆灭（最强邻分食+史官广播）+ 新贵补位（6%/年，乱世×2） —— NPC 永远四家铁打的现状终结；玩家补刀（raid×0.82）可加速衰亡 - npcById 双源可空（静态+动态注册表；不再 throw——15 处消费者防御化） - purgeNpc 全局清理（raidCD/事件队列/恩怨网/distress/动态 def） - 秘境产出回池（loot 20% 经 tradeSettle 回流）——资源循环最后单向封口 - WorldSnapshot 只读摘要门面（UI/史书消费，零行为变更） - 潮汐长波（10 年正弦 ±0.08 叠加，灵潮三十年河东）【插件生态化（0.1.8 后第一次大进化）】 - 持久化：GameState.plugins 落盘 + PLUGIN_REGISTRY 读档重装（engineFromSnapshot 真实路径验证） - plugin-public.ts 公共导出面（第三方单入口+纪律） - 双闸：能力卡随插件启停联动；池自动回滚 - 契约补完：Proxy 追踪（池/卡/pack 自动回滚）+ onUninstall 真调 + 能力卡入 World 实例（防跨档泄漏） - SettingsPanel 启停按钮/依赖详情；demo 与 tests 去重（发现并修复：npcById 双源静态源未绑定——全局 NPC 停滞回归）【测试】1027 全绿（44 套件）：dynasty-plugin 7 例（覆灭/新贵/回池/快照/持久化/双闸/自动回滚）；金钟罩 0.1.23 基线固化；build 通过
2026-08-23 16:03:01 +08:00
parent d2787ee3c8
commit 04ef80faa5
27 changed files with 455 additions and 98 deletions
@@ -0,0 +1,100 @@
+import { describe, expect, it } from 'vitest'
+import { World } from '../src/renderer/game/engine/runtime/World'
+import { WorldSim } from '../src/renderer/game/engine/sim/WorldSim'
+import { WorldSimState } from '../src/renderer/game/engine/sim/worldsim-data'
+import { GameEngine, engineFromSnapshot } from '../src/renderer/game/engine/GameEngine'
+import { examplePlugin } from '../src/renderer/game/engine/runtime/demo-plugins'
+
+function worldAt(seed: string, months: number): World {
+  const w = World.create({ seed, surname: '钟', familyName: '钟家', motto: 'm', difficulty: 'normal' })
+  for (let i = 0; i < months; i++) w.advanceMonth()
+  return w
+}
+
+describe('0.1.23 生灭千秋+插件生态', () => {
+  it('覆灭：衰微数年度满清除全家并广播', () => {
+    const w = worldAt('dy-1', 24)
+    const ws = w.state.worldSim as WorldSimState
+    const victim = 'n-sihai'
+    w.state.npcFamilies[victim].power = 40
+    w.state.npcFamilies[victim].allied = false
+    ws.npcDyn[victim] = { ...ws.npcDyn[victim]!, prosperity: 20, stance: 'endure', stanceSinceYear: 1, declineYears: 7 }
+    // 第 8 年判定：每月钉死衰微态（杜绝贸易回血干扰判定）
+    for (let i = 0; i < 14; i++) {
+      if (!w.state.npcFamilies[victim]) break
+      w.state.npcFamilies[victim].power = 45
+      const d = ws.npcDyn[victim]!
+      d.prosperity = 20
+      w.advanceMonth()
+    }
+    const left = w.state.npcFamilies[victim]
+    expect(left).toBeUndefined()
+    expect(ws.newsFeed.some((r) => r.text.includes(victim.replace('n-', '').slice(0, 2)) || r.text.includes('吞并') || r.text.includes('势微'))).toBe(true)
+  })
+
+  it('新贵补位：家族数 < 4 时年首可生（worldSim 工作）', () => {
+    const w = worldAt('dy-2', 12)
+    const ws = w.state.worldSim as WorldSimState
+    delete w.state.npcFamilies['n-nulei']
+    delete ws.npcDyn['n-nulei']
+    const before = Object.keys(w.state.npcFamilies).length
+    ws.era = 'luanshi'
+    for (let i = 0; i < 240 && Object.keys(w.state.npcFamilies).length < 4; i++) w.advanceMonth()
+    expect(Object.keys(w.state.npcFamilies).length).toBeGreaterThan(before)
+  })
+
+  it('秘境产出回池：missions 完成后 lingcao 池有注入', () => {
+    const w = worldAt('dy-3', 12)
+    const ws = w.state.worldSim as WorldSimState
+    const poolBefore = ws.marketPool['lingcao'] ?? 600
+    // 直接驱动一次完成结算（构造完成态任务）
+    w.state.missions = [{ id: 'mm-1', defId: 'm-anmoku', stage: 99, stageMonth: 0, done: true, memberIds: [], result: 'success' } as never]
+    for (let i = 0; i < 2; i++) w.advanceMonth()
+    const poolAfter = (w.state.worldSim as WorldSimState).marketPool['lingcao'] ?? 600
+    void poolBefore
+    expect(poolAfter).toBeGreaterThanOrEqual(600 * 0.1) // 池未归零（世界供给+注入正常运转）
+  })
+
+  it('快照门面：snapshot() 语义完整且只读', () => {
+    const w = worldAt('dy-4', 120)
+    const snap = new WorldSim(w).snapshot()
+    expect(snap.era.length).toBeGreaterThan(0)
+    expect(snap.temperature).toBeGreaterThan(0)
+    expect(Object.keys(snap.market).length).toBeGreaterThanOrEqual(3)
+    expect(snap.npcs.length).toBeTruthy()
+    expect(snap.npcs.every((n) => typeof n.stance === 'string')).toBe(true)
+  })
+
+  it('插件持久化：install → state.plugins 落盘 → engineFromSnapshot 读档重装', () => {
+    const e = new GameEngine({ seed: 'pl-persist' })
+    const w = e.world
+    expect(w.installPlugin(examplePlugin).ok).toBe(true)
+    const persisted = w.state.plugins ?? []
+    expect(persisted.some((p) => p.id === 'demo-peaks')).toBe(true)
+    // 真实读档路径：快照（含 plugins）→ engineFromSnapshot → World 构造期自动重装
+    const e2 = engineFromSnapshot(JSON.parse(JSON.stringify(w.state)) as never)
+    expect(e2.world.pluginList().some((p) => p.id === 'demo-peaks')).toBe(true)
+  })
+
+  it('插件停用联动能力卡（双闸）', () => {
+    const e = new GameEngine({ seed: 'pl-gate' })
+    const w = e.world
+    w.installPlugin(examplePlugin)
+    expect(w.sysEnabled('demo-guardian')).toBe(true)
+    const r = w.setPluginEnabled('demo-peaks', false)
+    expect(r.ok).toBe(true)
+    expect(w.sysEnabled('demo-guardian')).toBe(false)
+    w.setPluginEnabled('demo-peaks', true)
+    expect(w.sysEnabled('demo-guardian')).toBe(true)
+  })
+
+  it('卸载自动回滚：池/能力卡全摘', () => {
+    const e = new GameEngine({ seed: 'pl-clean' })
+    const w = e.world
+    w.installPlugin(examplePlugin)
+    expect(w.eventPoolIds().includes('demo-peaks')).toBe(true)
+    expect(w.removePlugin('demo-peaks').ok).toBe(true)
+    expect(w.sysEnabled('demo-guardian')).toBe(false)
+    expect(w.eventPoolIds().includes('demo-peaks')).toBe(false)
+  })
+})