docs: 四文档同步 0.1.28《稳石》

AGENTS:金钟罩注释 0.1.24→0.1.28(指纹补盲清单:worldGen 摘要/sagaAnnals/distress/declineYears)
README:测试数 69/2008 + 版本沿革 0.1.28 + 守护机制补「审计三轮」
PROJECT_MEMORY:时间线 0.1.28 + 教训 6e「承诺-实现间隙」+ 技术债更新(缓做项定案)
MOD_GUIDE:版本 0.1.28 + 兑现注记(预检生产链/卸载真回滚/worldNum 接线/缺失提示/bundle 再导入闭环)
This commit is contained in:
2026-08-23 18:29:13 +08:00
parent da4fb9f635
commit 6cbd604e24
4 changed files with 17 additions and 11 deletions
+1 -1
View File
@@ -61,7 +61,7 @@ src/main/ Electron 主进程(app:// 协议 + IPC 存
- **插件架构**0.1.8 起,路径已迁 engine/runtime|kernel):`kernel/plugin.ts` 协议、`runtime/pluginManager.ts` 安装管线(依赖校验/异常回滚/追踪型上下文——注销时钩子全摘)、`plugin-bootstrap.ts` 三核心插件(core-systems/core-data/core-events protected)。事件多池 `world.eventPools`**findEvent 必须带 world 参数查池**。能力卡 12 张经 `viaCap` 注册;tournament/tribulation/apprentice/season 四卡各自内部检查 `w.sysEnabled`(无独立钩子)。
- **MOD 红线(0.1.26 规范)**MOD 只含 JSON 零脚本(`docs/MOD_GUIDE.md`);**禁止新增 rng 消耗**(全局随机序列);不改核心时序(扩展走五口:事件池/模板/词库/灾因/配方);`modPreflight`+`validateMod` 先行(id 冲突用 `findEvent` 权威检测);MOD 只影响**新开档**世界(老档世界变形成档记录);MOD 状态随 `state.plugins` 持久化(对应 `worldGen.npcs` 落档保证读档永稳)。
- **门面**`runtime/ApiFacade.ts` GameFacadeact 24 项/query 6 类/subscribe 退订协议/about);**UI 面板事实走 world 直调**(act 为测试/自动化通道),`actDirect` 与 ACT_CATALOG 语义对齐(0.1.20 补齐全 24 项);store 的 `facade` 必须在 openState/startNewGame 赋值。
- **金钟罩(双基线)**`tests/clock.test.ts``GOLDEN`(直调冻结世界)+ `GOLDEN_RESOLVED`(自动 resolve 长跑"现实"世界),各 3 seed × 三档月数(560/1200/2160)共 18 值。当前为 **0.1.24 基线**0.1.25/0.1.26 世界生成默认池不变、灾因默认表不变 → 基线零漂,见注释)。指纹 `tests/fingerprint.helper.ts` 含全世界轴(era/stance/prosperity/relationsWithOthers/calamity/pendingEvent/eventQueue/worldAnnals/worldGen 摘要)。**有意变更时序/数值时**:指纹一并重算并在注释注明原因。
- **金钟罩(双基线)**`tests/clock.test.ts``GOLDEN`(直调冻结世界)+ `GOLDEN_RESOLVED`(自动 resolve 长跑"现实"世界),各 3 seed × 三档月数(560/1200/2160)共 18 值。当前为 **0.1.28 基线**第三轮审计指纹补盲后固化;0.1.25/0.1.26 曾零漂,0.1.27/0.1.28 受控变更重算)。指纹 `tests/fingerprint.helper.ts` 含全世界轴(era/stance/prosperity/relationsWithOthers/calamity/pendingEvent/eventQueue/worldAnnals/**worldGen 摘要/sagaAnnals/distress/declineYears 汇总**——0.1.27 生灭/世鉴路径真实锁定)。**有意变更时序/数值时**:指纹一并重算并在注释注明原因。
## 世界自演进模型(0.1.14 sim/ 层,改数值勿动流程)