thzxx
a7ee125866
- 统一时轮 GameClock：七 phase 注册制（production/aging/cultivation/missions/ events/diplomacy/epilogue） + 年首三钩子（婚配→岁贡→族簿）；advanceMonth 化作薄壳； 新增系统只注册不改本体；alive 守卫、随机序、族簿时序均与重构前逐一等价 - 金钟罩：3 枚 seed × 560 月指纹常驻（重构前后已验证同哈希；时节属有意变更后重固化） - 统一随机 RngHub：开局播种（crypto UV）、音效白噪独立流、引擎 rng 带 nextCount 审计； 全工程拔除逻辑侧 Math.random - 时节系统：春夏秋冬乘子（春田+10%/夏修+5%/秋市+5%/冬闭+8%）入生产与修炼 - 崩溃保护：advance 异常自动存『出险前』档 + 停速提示回档 - 性能预算：dev-only 单 tick>60ms 报最慢 phase - 横轴年表：十年一格大事/生殇聚合 + 春秋原年轴视图 - 测试 197→225（时钟/收集器/四季/年轴/效果全矩阵/死局链/残留防御）
仙途家族志 · 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 引擎的多标签页锁不构成影响
- 战斗为自动结算战报，不做手动回合操作
- 目前仅中文本地化