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 通过
This commit is contained in:
2026-08-23 16:03:01 +08:00
parent d2787ee3c8
commit 04ef80faa5
27 changed files with 455 additions and 98 deletions
+21 -4
View File
@@ -36,8 +36,25 @@ export const NPCS: NpcFamilyDef[] = [
}
]
export function npcById(id: string): NpcFamilyDef {
const n = NPCS.find((x) => x.id === id)
if (!n) throw new Error(`npc not found: ${id}`)
return n
/** 运行时动态 NPC 注册表(0.1.23 新贵/覆灭;插件化入口) */
const DYNAMIC_NPCS = new Map<string, NpcFamilyDef>()
export function registerNpcDef(def: NpcFamilyDef): void {
DYNAMIC_NPCS.set(def.id, def)
}
export function unregisterNpcDef(id: string): void {
DYNAMIC_NPCS.delete(id)
}
/** 双源查询:静态 NPCS → 运行时动态表(新贵);缺失返回 undefined(调用方防御)。
* 注意:此函数拒绝 import registry(循环依赖),静态源直连 NPCS;数据包 npcs 覆写暂不走此路。 */
export function npcById(id: string): NpcFamilyDef | undefined {
const stat = NPCS.find((x) => x.id === id)
if (stat) return stat
return DYNAMIC_NPCS.get(id)
}
export function getNpcDefs(): NpcFamilyDef[] {
return [...NPCS, ...DYNAMIC_NPCS.values()]
}