thzxx
c09395a6d4
插件协议：
- CotycPlugin Manifest（dependencies/conflicts/protected/install/uninstall）
- PluginManager：安装序确定性/依赖拒绝/异常回滚/追踪型上下文（卸载全摘钩子）
- 三核心插件常驻（Systems/Data/Events）；插件清单/安装移除/启停广播
- EventPoolRegistry 多池合并；facade about/query('plugins')/plugin 订阅
- 设置页插件清单（含卸载按钮、核心保护）；examplePlugin 开发范本入仓
全应用审计修复（引擎 39 + UI/主进程 40 双路清单，P0→P2 歼灭）：
- P0：单亲 rollRoots 崩/插件事件软锁（findEvent 查池）/fire 覆盖幸存事件/
facade 未赋值（act 目录 6/24 生效→全量接通）/packOverride 死实现真接管/
4 能力卡无接线（trib/apprentice/tournament/season）/读档 rowid 方言崩溃/
buildApprentice 空候选崩/插件安装无回滚/trait 加成从未消费/DEV 双跑破坏时序
- P1：定时器幸存/advance in-flight 闸/battle 暂停/tournament 点将真传/
史书 memo 依赖/面板 hooks 顺序违规/远征 squad 残留 id/跨档状态残留/
toast 自清除/读档错误提示/导入后重载世界/pendingEvent 读档回填
- P2：版本三处统一/NewGame 随机收编/学费错误文案/姓氏池去重/
功法品阶错位（凡阶哨兵）/功法定价对齐/market 白名单校验/
战利功法去重/回声漏封缄/clock 迭代快照/core 事件池保护/
渡劫陨落走真突破/寄读 desc 诚实化/doas 死代码清理等 30 项
测试 239→256；金钟罩复验（防御批零漂移）
仙途家族志 · Chronicle of the Immortal Clan
修仙 × 家族 × 经营 × 战斗的家族模拟器 0.1.0。
玩法
一座庄园、一家修士、四邻势力，随年月流转：族人修炼突破、建筑产出、探秘寻宝、婚丧嫁娶； 仇家犯境则结阵应战；史书自动记下百年兴衰 —— 玩家扮演「家族意志」，延续香火于仙途。
开发
npm install # 依赖（含私有 registry：git.metona.cn）
npm run dev # 开发模式（热更新）
npm test # 引擎单元测试（vitest）
npm run typecheck # 类型检查
npm run build # 构建 out/
npm run package # 打包桌面安装包（electron-builder）
冒烟（主进程渲染 + OPFS 数据库就绪检查）：
npm run build && SMOKE_TEST=1 npx electron out/main/index.js --no-sandbox
技术栈
- Electron + electron-vite + React + TypeScript
- 数据库：@metona-team/metona-sqlark 0.7.4（aria 引擎 + OPFS），渲染进程内持久化
- 引擎：纯 TypeScript（无 UI 依赖），种子随机数（sfc32），确定性可回放
- 存储：每个存档槽一个 SQLark 库（快照滚动 12 份 + 编年史表），JSON 导出导入
存档位置
OPFS 数据位于 Electron userData 目录下数据库文件（aria 引擎 WAL/SSTable）。 备份与迁移请用游戏内「设置 → 导出/导入」。
已知限制（0.1.0）
- 单机单窗口；MetonaSqlark aria 引擎的多标签页锁不构成影响
- 战斗为自动结算战报，不做手动回合操作
- 目前仅中文本地化