0.1.39 文档全量同步：README/PROJECT_MEMORY/MOD_GUIDE/AGENTS 版本号+测试数+金钟罩基线+版本沿革
This commit is contained in:
@@ -109,6 +109,6 @@ src/main/ Electron 主进程（app:// 协议 + IPC 存
|
||||
5. **高危文件白名单**（world.ts / events.ts / store.ts / styles.css / cultivation.ts / **WorldSim.ts / worldsim-data.ts**）改动后必须 `git diff --stat` 核对改动面与预期一致。
|
||||
6. 每次迭代收尾：`git status` 应干净 + `git log --oneline` 确认每步都有提交记录；凡 "git stash/checkout/rm" 类命令，执行前后都 `git status` 留痕。
|
||||
|
||||
- 提交前：`npm test`（当前 89 套件 5230 例全绿）+ `npm run typecheck` 必须绿（改存储/SQL 后再跑一次冒烟）。
|
||||
- 提交前：`npm test`（当前 108 套件 7058 例全绿）+ `npm run typecheck` 必须绿（改存储/SQL 后再跑一次冒烟）。
|
||||
- 平衡数值集中在 `game/data/` 与 `engine/sim/worldsim-data.ts`（世界循环参数唯一权威），调平衡不改引擎流程。
|
||||
- 发布产物 `release/`、`out/` 均已 gitignore，勿入库。
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
npm install # 依赖（含 git.metona.cn 私有 registry，token 在用户级 ~/.npmrc）
|
||||
npm install-scripts approve electron esbuild # npm12 首装时必须（Electron 二进制）
|
||||
npm run dev # 开发模式（热更新）
|
||||
npm test # 引擎测试（89 套件 / 5230 用例，纯 Node 无 GUI）
|
||||
npm test # 引擎测试（108 套件 / 7058 用例，纯 Node 无 GUI）
|
||||
npm run build # 产物到 out/
|
||||
npm run package # 打包（Windows 需在 Windows 侧执行）
|
||||
```
|
||||
@@ -42,12 +42,12 @@ src/main/ Electron 主进程（app:// 协议 + IPC 存
|
||||
|
||||
## 守护机制
|
||||
|
||||
- **双金钟罩**：`tests/clock.test.ts` 的 `GOLDEN`（直调冻结世界）+ `GOLDEN_RESOLVED`（自动 resolve 长跑"现实"世界），各 3 固定 seed × 560/1200/2160 月（47/100/180 年）= 18 指纹；指纹含全世界轴（era/stance/prosperity/关系网/事件闸）；**0.1.21 基线**。有意变更时序需受控更新并注明。
|
||||
- **双金钟罩**：`tests/clock.test.ts` 的 `GOLDEN`（直调冻结世界）+ `GOLDEN_RESOLVED`（自动 resolve 长跑“现实”世界），各 3 固定 seed × 560/1200/2160 月（47/100/180 年）= 18 指纹；指纹含全世界轴（era/stance/prosperity/关系网/事件闸）；**0.1.39 基线**。有意变更时序需受控更新并注明。
|
||||
- **事件闸**：pending 唯一入口 `fire(w,id,priority)`——高优（raid/渡劫/大比）可顶替被占者，被顶替者入队下月兑现；`applyEventChoice` 前置校验防陈旧 Modal 二次结算。
|
||||
- **插件化**：万物皆是插件（系统/数据包/事件池），三核心插件 protected 常驻；示例见 tests/helpers/examplePlugin.ts。
|
||||
- **可回放**：种子随机（sfc32，引擎域零 Math.random）+ 快照回放保真（restore 重建内核+回置 rng）。
|
||||
- **审计四轮**：0.1.15（引擎 P0 歼灭）/ 0.1.20（事件闸·市场黑洞·双金钟罩）/ 0.1.28（稳石：词库回滚·新贵落档·校验接生产·bundle 闭环·指纹补盲）/ **0.1.29（续命：续代断链·敌强度相对化·权重防洪）**。
|
||||
- **测试规模**：**89 套件 / 5230 例**（41 个矩阵域：随机序列/世界生成/市场实体化/事件闸/数据表全量/插件 MOD 组合/省级矩阵等——语义真实，无刷水）。
|
||||
- **审计五轮**：0.1.15（引擎 P0 歼灭）/ 0.1.20（事件闸·市场黑洞·双金钟罩）/ 0.1.28（稳石：词库回滚·新贵落档·校验接生产·bundle 闭环·指纹补盲）/ 0.1.29（续命：续代断链·敌强度相对化·权重防洪）/ **0.1.35（荡涤：17 缺陷歼灭·兼容层铲除·validateLoadedState 替代迁移）**。
|
||||
- **测试规模**：**108 套件 / 7058 例**（矩阵域：随机序列/世界生成/市场实体化/事件闸/数据表全量/插件 MOD 组合/省级矩阵等——语义真实，无刷水）。
|
||||
|
||||
## 打包产物
|
||||
|
||||
@@ -55,7 +55,7 @@ src/main/ Electron 主进程（app:// 协议 + IPC 存
|
||||
- 图标资源 resources/icon.png|ico —— electron-builder 自动使用
|
||||
- 注意：WSL/Linux 交叉打 win 包可行但未签名，正规发布请用 Windows 侧重跑
|
||||
|
||||
## 版本沿革（0.1.0 → 0.1.21）
|
||||
## 版本沿革（0.1.0 → 0.1.39）
|
||||
|
||||
| 版本 | 主题 |
|
||||
|---|---|
|
||||
@@ -82,5 +82,11 @@ src/main/ Electron 主进程（app:// 协议 + IPC 存
|
||||
| 0.1.31 | 万物皆可 MOD（内容面七口：物品/功法/建筑（表达式 DSL）/职事/志向/阵型/性格 + kind 分类 + ERA_DURA/REGION_TIDE 聚合 + 测试 4006） |
|
||||
| 0.1.32 | 万宝琳琅（物品六类化 + 新材料七种入市 + 符箓武备/灵酿回气 + 生产泛化 + 测试 5009） |
|
||||
| 0.1.33 | 闭环·流光（物品生态闭环（符箓生效/僵尸物品归位/灾年入产）+ 引擎止血 15 项 + UI 动效打磨 + 测试 5230） |
|
||||
| 0.1.34 | 万象归元（功法流派化×元素时节共鸣 + 世界自演化二层 + 插件卡 12→14 + MOD 功法效果口+patch 数值层 + 测试 6000） |
|
||||
| 0.1.35 | 荡涤·向新（17 缺陷歼灭 + 兼容层整体铲除 + validateLoadedState 替代迁移 + 测试 7000） |
|
||||
| 0.1.36 | CSP 根因（arith.ts 纯解析器全量替换 Function() + ErrorBoundary 防白屏 + dev:web 浏览器通道） |
|
||||
| 0.1.37 | 天人感应（因果系统 karma + 飞升试炼三阶段 + 世界奇观种子派生 + 测试 7030） |
|
||||
| 0.1.38 | 存档根治·石碑重刻（OPFS 探测+自动降级 IndexedDB + 回读校验 + 诊断面板 + driver.open 锁死修复） |
|
||||
| 0.1.39 | 淬体·洗髓（missionIds 根治 + chronicle 智能裁剪 + worldsim 双闸守卫 + purgeNpc 僵尸定义清理 + MemberCard memo 化 + 飞升视觉强化 + 测试 7058） |
|
||||
|
||||
详见：`docs/PROJECT_MEMORY.md`（设计哲学与每个迭代的"为什么"）。
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
# MOD 开发教程 · Chronicle of the Immortal Clan
|
||||
|
||||
> 版本 **0.1.36·《CSP 根因》** · MOD_SCHEMA_VERSION = 1 · 全口纯 JSON（零脚本）
|
||||
> 版本 **0.1.39·《淬体·洗髓》** · MOD_SCHEMA_VERSION = 1 · 全口纯 JSON（零脚本）
|
||||
> **本教程即全部所需**：你不需要读任何源码或类型文件——所有 MOD 能用的字段、取值、默认值、坑点、示例都写在下面。
|
||||
> 照例动手即可：最快 5 分钟做出你的第一个 MOD。
|
||||
|
||||
@@ -989,4 +989,4 @@ MOD 可以注册**自定义奇观类型**，加入年首种子派生选取池：
|
||||
> 0.1.35 涤荡注：无存档迁移（游戏未发布——旧档随版本演进失效属预期）；`patch` 层按插件归属回滚；validate 覆盖 §12 全部规则。
|
||||
> 0.1.37 因果奇观注：奇观零 rng（种子派生选取池含 MOD 扩展）；`eff.karma` 天然支持；`wonderChance`/`karmaDecayRate`/`karmaHighThreshold`/`karmaLowThreshold` 可经 worldNum 覆写；飞升事件 `ev-ascension-*` 前缀保护防劫持。
|
||||
|
||||
<sub>⚔️ 本文档随游戏版本更新（0.1.37）。字段若有新增，此处先行。</sub>
|
||||
<sub>⚔️ 本文档随游戏版本更新（0.1.39）。字段若有新增，此处先行。</sub>
|
||||
|
||||
@@ -50,6 +50,9 @@
|
||||
| 0.1.34 | 万象归元 | 功法流派化（crit/guard/trib/secret 四效果 ×6 新功 ×元素时节共鸣）+ 世界自演化二层（warFatigue 温度冷降/换代恩义半衰/断供应急×1.5/新秘境种子派生）；插件卡 12→14（worldsim 观察/tech 功法）；MOD 功法效果口+patch 数值层（0.5~2 mult 校验/卸载复原）；**测试 5230→6000** |
|
||||
| 0.1.35 | 荡涤·向新 | 全量审计 17 缺陷歼灭（wonder 全链/boss 释放/patch 归属/拒单门/衰减/transition）；**兼容层整体铲除**：migrate 迁移链 55 行+版本戳 8 处+chronicle 死表+__state/seed 三元+normalize 兼容批 55 行（未发布不向下兼容——validateLoadedState 结构校验替代）+domain 5 兼容 optional 收紧；**测试 6000→7000** |
|
||||
| 0.1.36 | CSP 根因 | 三问题处置：成员弹框双排名（壳/内容双渲染已修）；**推进崩溃+定制白屏同一根因——打包 renderer CSP 禁 unsafe-eval，bonusOf/produceExpr/MOD 表达式三处 Function() 求值全被拦**→ 新建 arith.ts 纯解析器（令牌化+递归下降）全量替换（零 eval）；toast 根错可见+出险双保险；ErrorBoundary 防白屏；dev:web 浏览器通道；存储真链测试（MetonaSqlark memory 方言）；**测试 7007→7011** |
|
||||
| 0.1.37 | 天人感应 | 因果系统（karma 衰减/灾年概率调制/NPC 姿态调制/渡劫调制）+ 飞升试炼三阶段（心魔→天劫→飞升抉择）+ 世界奇观（种子派生零 rng——4 种内置奇观）+ 0.1.37 金钟罩基线重算；**测试 7011→7030** |
|
||||
| 0.1.38 | 存档根治·石碑重刻 | OPFS 可用性探测 + 自动降级 IndexedDB + 错误上浮可见 + 回读校验 + 持久化请求 + 诊断面板 + driver.open 永久锁死修复 + exportSave open 补全 |
|
||||
| 0.1.39 | 淬体·洗髓 | missionIds 只增不减根治（releaseSquad 显式 splice）+ chronicle 智能裁剪保留 important 里程碑 + worldsim tick 入口双闸守卫 + purgeNpc 清理 worldGen.npcs/relations 僵尸定义 + MemberCard memo 化脱离 store 订阅 + 飞升叙事视觉强化（金色辉光标题/仙韵边框/金边选项）；**测试 7058** |
|
||||
|
||||
## 三、关键架构决策（及为什么）
|
||||
|
||||
|
||||
Reference in New Issue
Block a user