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
+7 -6
View File
@@ -1,6 +1,6 @@
# MOD 规范与范式标准 · Chronicle of the Immortal Clan
> 版本 **0.1.27·《活水长流》** · MOD_SCHEMA_VERSION = 1
> 版本 **0.1.28·《稳石》** · MOD_SCHEMA_VERSION = 1
> 每个 MOD 是一个**外部内容包**(纯 JSON,零脚本);安装后成为插件一等子类,
> 享有插件的全部设施:持久化(随档)、启用/停用、依赖/冲突检查、卸载自动回滚。
@@ -134,15 +134,16 @@ EventDef 全字段**纯数据**(与内置事件同构):
## 8. 已验证的安装流程(行为承诺)
- 安装:`World.installPlugin(modToPlugin(pack))` → 事件进池/模板注册/词库聚合/灾因入表/配方注册;
- `modPreflight` 先行:id 冲突拒绝 + 范式警告;`validateMod` 深度校验(category/weight/境界/非负);
- 启用/停用/卸载:插件双闸与自动回滚照常(卸载即全摘);
- 存档:MOD 状态随 `state.plugins` 持久化,读档自动重装(版本不符跳过并提示)。
- 安装:`World.installPlugin(modToPlugin(pack))` → 事件进池/模板注册/词库聚合/灾因入表/配方注册/worldNum 覆写
- **预检已接生产(0.1.28)**:游戏内安装必走 `modPreflight`(事件 id 冲突拒绝装;范式警告 toast`validateMod` 深度校验(category/weight/境界/非负/空串/NaN 防护);
- 启用/停用/卸载:插件双闸与自动回滚照常(**0.1.28 起卸载真正全摘**——词库池/灾因/配方/worldNum 按来源精确回滚,共享词条保留);
- 存档:MOD 状态随 `state.plugins` 持久化,读档自动重装(版本不符跳过);**缺失插件记 `state.pluginsMissing` 并提示**("文件可能需重新放入 mods 目录");
- 世界数值:`worldNum`(§2 数据包内)已接线——安装覆写/卸载复位。
## 9. 打包与分发
- 单文件 `.cotymod`= JSON)直接分发;放入 `userData/mods/` 后游戏内「设置 → MOD 层 → 扫描目录 → 安装」。
- **游戏内导出**(0.1.27):「MOD 层 → 导出当前 MOD 集」把当前启用的全部 MOD 合并为 `mod-bundle-export.cotymod`(含各包明细)——分享/备份走同一载入通道
- **游戏内导出**0.1.270.1.28 闭环):「MOD 层 → 导出当前 MOD 集」把当前启用的全部 MOD 合并为 `mod-bundle-export.cotymod`(含各包明细);导出包可直接再导入(`modParse` 识别 `{app:'cotymod',bundle}` 逐包递归)——分享/备份同通道无断点
- 注意:**MOD 只影响新开档**的世界生成;已开档不受影响(世界种已落档)。
---