MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

0.1.40 文档同步: README金钟罩基线+版本沿革+0.1.40条目 / PROJECT_MEMORY技术债清理+测试数7058

Browse Source
This commit is contained in:
thzxx
2026-09-13 15:00:45 +08:00
parent 54face8275
commit beeda036f6
2 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+3 -2
View File
@@ -42,7 +42,7 @@ 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.39 基线**。有意变更时序需受控更新并注明。 - **双金钟罩**：`tests/clock.test.ts` 的 `GOLDEN`（直调冻结世界）+ `GOLDEN_RESOLVED`（自动 resolve 长跑“现实”世界），各 3 固定 seed × 560/1200/2160 月（47/100/180 年）= 18 指纹；指纹含全世界轴（era/stance/prosperity/关系网/事件闸）；**0.1.40 基线**。有意变更时序需受控更新并注明。
- **事件闸**：pending 唯一入口 `fire(w,id,priority)`——高优（raid/渡劫/大比）可顶替被占者，被顶替者入队下月兑现；`applyEventChoice` 前置校验防陈旧 Modal 二次结算。 - **事件闸**：pending 唯一入口 `fire(w,id,priority)`——高优（raid/渡劫/大比）可顶替被占者，被顶替者入队下月兑现；`applyEventChoice` 前置校验防陈旧 Modal 二次结算。
- **插件化**：万物皆是插件（系统/数据包/事件池），三核心插件 protected 常驻；示例见 tests/helpers/examplePlugin.ts。 - **插件化**：万物皆是插件（系统/数据包/事件池），三核心插件 protected 常驻；示例见 tests/helpers/examplePlugin.ts。
- **可回放**：种子随机（sfc32，引擎域零 Math.random）+ 快照回放保真（restore 重建内核+回置 rng）。 - **可回放**：种子随机（sfc32，引擎域零 Math.random）+ 快照回放保真（restore 重建内核+回置 rng）。
@@ -55,7 +55,7 @@ src/main/ Electron 主进程（app:// 协议 + IPC 存
- 图标资源 resources/icon.png|ico —— electron-builder 自动使用 - 图标资源 resources/icon.png|ico —— electron-builder 自动使用
- 注意：WSL/Linux 交叉打 win 包可行但未签名，正规发布请用 Windows 侧重跑 - 注意：WSL/Linux 交叉打 win 包可行但未签名，正规发布请用 Windows 侧重跑
## 版本沿革（0.1.0 → 0.1.39） ## 版本沿革（0.1.0 → 0.1.40）
| 版本 | 主题 | | 版本 | 主题 |
|---|---| |---|---|
@@ -88,5 +88,6 @@ src/main/ Electron 主进程（app:// 协议 + IPC 存
| 0.1.37 | 天人感应（因果系统 karma + 飞升试炼三阶段 + 世界奇观种子派生 + 测试 7030） | | 0.1.37 | 天人感应（因果系统 karma + 飞升试炼三阶段 + 世界奇观种子派生 + 测试 7030） |
| 0.1.38 | 存档根治·石碑重刻（OPFS 探测+自动降级 IndexedDB + 回读校验 + 诊断面板 + driver.open 锁死修复） | | 0.1.38 | 存档根治·石碑重刻（OPFS 探测+自动降级 IndexedDB + 回读校验 + 诊断面板 + driver.open 锁死修复） |
| 0.1.39 | 淬体·洗髓（missionIds 根治 + chronicle 智能裁剪 + worldsim 双闸守卫 + purgeNpc 僵尸定义清理 + MemberCard memo 化 + 飞升视觉强化 + 测试 7058） | | 0.1.39 | 淬体·洗髓（missionIds 根治 + chronicle 智能裁剪 + worldsim 双闸守卫 + purgeNpc 僵尸定义清理 + MemberCard memo 化 + 飞升视觉强化 + 测试 7058） |
| 0.1.40 | 天命·裂痕（天命议题系统 20 条 5 类种子派生选取 + NPC 宗主更替四模式 + NPC 势力分裂 + 灰烬重生新贵补位 + 建筑专精系统 extra×1.5 + UI memo 化 4 处 + 天下大事记叙事层 saga.ts + WorldPanel/LegacyPanel 大事记展示） |
详见：`docs/PROJECT_MEMORY.md`（设计哲学与每个迭代的"为什么"）。 详见：`docs/PROJECT_MEMORY.md`（设计哲学与每个迭代的"为什么"）。
docs/PROJECT_MEMORY.md
+3 -3
View File
@@ -147,7 +147,7 @@
2. GameFacade act 通道与面板直调并存（**仲裁结论**：直调是事实通道、act 为测试/自动化通道——actDirect 已补齐 24 项等价映射）。 2. GameFacade act 通道与面板直调并存（**仲裁结论**：直调是事实通道、act 为测试/自动化通道——actDirect 已补齐 24 项等价映射）。
3. `guide.ts`（引导任务）只做 UI 条，钩子目标点不完（"提示"非"强制"）。 3. `guide.ts`（引导任务）只做 UI 条，钩子目标点不完（"提示"非"强制"）。
4. `family.flag` 长线键已有 3 年剪枝、但 `state.missions/missionIds` 只增不减（未剪枝）。 4. `family.flag` 长线键已有 3 年剪枝、但 `state.missions/missionIds` 只增不减（未剪枝）。
5. NPC 四家是固定成分（无"覆灭/新贵补位"——0.1.19 留作 0.1.22+ 候选）；附庸/吞并仅 UI"衰"标记。 5. ~~NPC 四家是固定成分（无"覆灭/新贵补位"——0.1.19 留作 0.1.22+ 候选）~~ **已解决**（0.1.23 覆灭/新贵补位 + 0.1.40 宗主更替四模式/势力分裂/灰烬重生）。附庸/吞并仅 UI"衰"标记。
6. `worldsim` 的能力卡开关无独立钩子（viaCap 恒真已注册，实际不可关）——如需可关需重构。 6. `worldsim` 的能力卡开关无独立钩子（viaCap 恒真已注册，实际不可关）——如需可关需重构。
## 七、已知技术债补充（0.1.26） ## 七、已知技术债补充（0.1.26）
@@ -155,7 +155,7 @@
7. MOD 目录形态仅支持单文件（目录/分包/依赖多个 .cotymod 自动解析留待）。 7. MOD 目录形态仅支持单文件（目录/分包/依赖多个 .cotymod 自动解析留待）。
8. CALAMITY 与 WORLDSTIM 数值表的大规模注入（多 MOD 叠加平衡）未做。 8. CALAMITY 与 WORLDSTIM 数值表的大规模注入（多 MOD 叠加平衡）未做。
9. NPC"中期势力轮替"曲线（newborn 频度/覆灭线）仍单参数，可寻参数化。 9. NPC"中期势力轮替"曲线（newborn 频度/覆灭线）仍单参数，可寻参数化。
10. **测试规模 7011**（102 套件矩阵域），后续新增机制优先在对应矩阵域追加参（seed×组合），避免重开大文件。 10. **测试规模 7058**（108 套件矩阵域），后续新增机制优先在对应矩阵域追加参（seed×组合），避免重开大文件。
11. **缓做项（0.1.28 审计定案）**：declineYears 盛世误触/闪烁——重平衡归 0.1.29 独立调参（避免二次基线漂移）；CALAMITY_FAMILY 独立口收益低（灾因口已覆盖）；ERA_DURA/REGION_TIDE 松弛版数值口 0.1.29+（必须走"默认优先+聚合"模式）。 11. **缓做项（0.1.28 审计定案）**：declineYears 盛世误触/闪烁——重平衡归 0.1.29 独立调参（避免二次基线漂移）；CALAMITY_FAMILY 独立口收益低（灾因口已覆盖）；ERA_DURA/REGION_TIDE 松弛版数值口 0.1.29+（必须走"默认优先+聚合"模式）。
## 八、如何开始修改（给下一个智能体的路径） ## 八、如何开始修改（给下一个智能体的路径）
@@ -166,7 +166,7 @@
改结构：注册进 clocks/plugins；世界循环参数唯一权威 = worldsim-data.ts 改结构：注册进 clocks/plugins；世界循环参数唯一权威 = worldsim-data.ts
→ 5. 改 UI：先改 store（revision）再改组件；纯逻辑放 game/engine 可测 → 5. 改 UI：先改 store（revision）再改组件；纯逻辑放 game/engine 可测
→ 6. 加测试：双金钟罩不动，新增用例挂 tests/xxx-0.1.x.test.ts（按主题命名） → 6. 加测试：双金钟罩不动，新增用例挂 tests/xxx-0.1.x.test.ts（按主题命名）
→ 7. 提交前：npm test（102 套件 7011+）+ typecheck + （GUI 冒烟需 WSLg 在线）+ 更新三份文档 + MOD_GUIDE（触 MOD 时） → 7. 提交前：npm test（108 套件 7058+）+ typecheck + （GUI 冒烟需 WSLg 在线）+ 更新三份文档 + MOD_GUIDE（触 MOD 时）
``` ```
**一句话原则**：先复现、再小改、后金钟罩。改坏确定性比改错玩法更危险；改数值去 worldsim-data，改流程去 clocks，改事件去 fire()。 **一句话原则**：先复现、再小改、后金钟罩。改坏确定性比改错玩法更危险；改数值去 worldsim-data，改流程去 clocks，改事件去 fire()。