v0.1.0: 仙途家族志 · Chronicle of the Immortal Clan

家族模拟器首版：修仙/经营/战斗/外交/叙事全套系统
- Electron + React + TS + MetonaSqlark(aria+OPFS)
- 水墨中国风 UI
- 引擎种子随机、确定性可回放
- 19 项单元测试、端到端冒烟验证

README.md

@@ -0,0 +1,43 @@
+# 仙途家族志 · Chronicle of the Immortal Clan
+
+修仙 × 家族 × 经营 × 战斗的家族模拟器 0.1.0。
+
+## 玩法
+
+一座庄园、一家修士、四邻势力，随年月流转：族人修炼突破、建筑产出、探秘寻宝、婚丧嫁娶；
+仇家犯境则结阵应战；史书自动记下百年兴衰 —— 玩家扮演「家族意志」，延续香火于仙途。
+
+## 开发
+
+```bash
+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 数据库就绪检查）：
+
+```bash
+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 引擎的多标签页锁不构成影响
+- 战斗为自动结算战报，不做手动回合操作
+- 目前仅中文本地化