 thzxx
|
0965eaead4
|
docs: MOD_GUIDE 重写为零源码依赖的开发教程（464 行新手友好版）
- 零源码承诺：全文字段字典/取值/默认值自足，无需读类型文件
- 五分钟上手（含路径/可复制最小 MOD/装上看效果三步）
- 七个能力教程（事件/模板/词库/灾因/丹方/铸器/世界数值）：
每章字段表+条件表+效果表（Cond/MemberEffect 全集，从源码萃取）
+ 完整示例 + 常见坑（幂权重克制/新家衰微/灾名唯一/卸后世界不变）
- §10 速查表：内置 id 大全（资源/丹药/武器/功法/建筑/天下家/秘境）
- §11 排错 FAQ 七问（含存档误放 mods 目录的常见混淆）
- §12 依赖冲突/合包导出/读档重装纪律（改 MOD 必升 version）
- §13 官方范例拆解；文档全部示例经 parse/preflight/validate/install 实测校验
|
2026-08-23 20:34:00 +08:00 |
|
|
thzxx
|
716a91bd96
|
docs: 四文档同步 0.1.30《兼济》
README：测试数 81/3006 + 版本沿革补 0.1.29/0.1.30 + 审计轮次改「四轮」
PROJECT_MEMORY：时间线 0.1.29/0.1.30 + 新平衡观决策第 8 条（续代是玩法命脉/规模即代价）
MOD_GUIDE：版本 0.1.30 + §8.5 官方范例（风物集/战备解军观摩指南）+ 预览影响标注
AGENTS：0.1.30 小节与测试 3006（上轮已写，核对无漂）
|
2026-08-23 20:29:06 +08:00 |
|
|
thzxx
|
6cbd604e24
|
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 再导入闭环）
|
2026-08-23 18:29:13 +08:00 |
|
|
thzxx
|
d8d34fcb74
|
docs: MOD_GUIDE 同步 0.1.27
- 版本头 0.1.26→0.1.27；数据口五→六（新增 §5.5 世界数值 worldNum 白名单覆写）
- 安全红线补第 6 条（worldNum 只动白名单键）
- 依赖语义补充（注册库内自动先装）；§9 分发补「游戏内导出 MOD 集」
- 范式一句话更新（六口入炉）
|
2026-08-23 17:25:41 +08:00 |
|
|
thzxx
|
c8c38ea3b3
|
docs: 三文档同步 0.1.27 + 测试 2000
AGENTS：测试数 68 套件 2000 例（++修正）
README：版本沿革补 0.1.27 + 测试规模节
PROJECT_MEMORY：0.1.27 时间线（实测驱动）+ 教训 6d（实测优先于直觉）+ 技术债第 10 条矩阵域追加参纪律
|
2026-08-23 17:23:16 +08:00 |
|
|
thzxx
|
d941df5c3d
|
docs: 三文档同步至 0.1.26
AGENTS.md：金钟罩注释修正（0.1.21→0.1.24 基线，25/26 零漂注明）+ MOD 红线小节
+ 架构树补 worldgen/modSchema/modManager + 世界模型补（灾因聚合/家族生灭/世界种子）
+ 测试数 47/1047
README.md：版本沿革补 0.1.22-0.1.26（灯下春秋/生灭千秋/寰宇初构/乾坤一统/墨规清辉）
+ MOD_GUIDE 链接
PROJECT_MEMORY.md：时间线补 5 个迭代「为什么」+ 新决策（世界种子独立 rng/MOD=插件一等子类/
落档则永稳纪律）+ 坑教训两条（生成必落档/聚合默认零漂）+ 技术债补 3 条 + 修改路径更新
|
2026-08-23 16:44:27 +08:00 |
|
|
thzxx
|
ba9766e152
|
v0.1.26: 墨规清辉——MOD 规范范式 + 灾因注册表 + 页面提亮（1047 全绿）
【MOD 规范与范式（核心命题）】
- docs/MOD_GUIDE.md：完整作者守则——命名/id 规约/semver/schema:1/五数据口
（事件/模板/词库/灾因/配方）/依赖冲突/安全红线（无脚本·禁碰 rng·不动核心时序）/
打包分发（.cotymod 单文件）/行为承诺
- validateMod 深度校验：category/weight/境界/负成本/非空/options.eff 形状
- modPreflight 权威冲突检测：findEvent（池+动态分支 raid/渡劫/大比/传薪全量）
- MOD_SCHEMA_VERSION=1 + schema 声明与升级提示；PluginStatus.author 展示
【灾因归一化（平衡版落地）】
- calamities 由 as const 死表→聚合注册表（calamityNames/calamityFamilyOf/calamityEffectOf+addCalamity）
- WorldSim 灾签/生产/Market 全链路走聚合读口——MOD 灾因（剑灾/灵潮湍变）进入世界循环
- 默认表不变→基准世界指纹零漂（clock.test 全绿实证）
【页面可读性（有点暗）】
- .dim #6d6150→#a99c80（3.4:1→7+:1）、.dim2 #96896e→#c3b595、.help-text 提亮、
.feed-item 显色 #efe4c9 + 灰金系 8 处提亮（styles.css 12+/11- 纯色值）
- tests/contrast-readability.test.ts：WCAG 对比度审计（≥4.5:1）+ 历史暗色迁移断言
【测试】1047 全绿（47 套件）：mod-system 9（+validate/灾因/冲突/预检）、contrast 3；
【金钟罩】0.1.25 基线零漂；build 通过
|
2026-08-23 16:37:11 +08:00 |
|
|
thzxx
|
8f9c3c9a72
|
docs: 三文档完整更新至 0.1.21
AGENTS.md：架构章节重写（0.1.14 大重构路径）+ 引擎红线（时轮/随机/事件闸/特效出口/插件/门面/双金钟罩）
+ 世界自演进模型 + sqlark陷阱 + 数值基调（0.1.16 修为经济化/0.1.17 市场实体化）+ 修改纪律
README.md：快速开始（1018 用例）+ 0.1.14+ 架构一览 + 守护机制（双金钟罩/事件闸/插件/回放）
+ 版本沿革 0.1.12-0.1.21
PROJECT_MEMORY.md：版本时间线补齐（0.1.12-0.1.21 每迭代的为什么）+ 关键架构决策
（事件闸定稿/WorldSim 四层递进/引擎表现双通道/normalize即迁移/线程定论）
+ 踩坑教训（era 无延续档/潮汐符号反向/事件闸竞态/每tick存档/金钟罩盲区）
+ 诚实技术债清单 + 修改路径
|
2026-08-23 15:26:48 +08:00 |
|
|
thzxx
|
2528226a9f
|
docs: 修改纪律（防覆盖）写入 AGENTS + 项目记忆
- AGENTS.md 新增「修改纪律」章：改动前 git status、替换三步断言、禁止 git checkout 整文件回滚、
小步快跑先绿再进、高危文件白名单 diff 核对、迭代收尾 status/log 留痕
- PROJECT_MEMORY 补第 6 记：修改覆盖事故教训（爸爸点名：自己改代码把改过的覆盖了）
- 明确：上一轮 c52ecff 全量提交无丢失；本纪律立即生效
|
2026-08-23 13:08:10 +08:00 |
|
|
thzxx
|
12ab1e712a
|
docs: 沉淀项目记忆（AGENTS 数值红线 + PROJECT_MEMORY 档案 + README 沿革）
- AGENTS.md：新增「数值基调（0.1.10 重建后，勿当 bug 调回去）」红线段——
pacing 因子唯一生效、月率公式、寿元梯度、渡劫三选、事件优先级、flag 剪枝
- docs/PROJECT_MEMORY.md：项目叙事记忆新档案——设计哲学/版本为什么/架构决策/
踩坑六记/平衡哲学/已知技术债/开始修改路径
- README：版本沿革补 0.1.10/0.1.11，测试规模 923+
|
2026-08-23 11:36:28 +08:00 |
|