MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
59 Commits 1 Branch 0 Tags
9fbbe16dd8e76255c1bad2145a9d42982f4e36c6
Commit Graph
59 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
thzxx 9fbbe16dd8 fix: 删除误入库的 p 文件（0.1.32 脚本笔误 open('p','w') 误写workdir，内容为 worldsim-data.ts 副本） 2026-08-23 21:09:11 +08:00
thzxx 29eb25524b docs: 三文档同步 0.1.32《万宝琳琅》（按真实源码核对） 
README：测试数 86/5009 + 版本沿革补 0.1.31/0.1.32 + 矩阵域 29→40
MOD_GUIDE：§10 速查更新——资源/材料 id 十种 + 符箓/灵酿 id + 来源速记（与真实掉落/建筑对应）
+ 建筑 id 补灵果园/灵木坊 + 篇章尾注 0.1.32 生态观（六类循环/消耗类零 rng 纪律）
PROJECT_MEMORY：时间线 0.1.31/0.1.32 + 新决策 8b「物品六类生态观」
（材料循环/入池则活/零 rng 消耗纪律）+ 技术债测试数同步
 2026-08-23 21:08:05 +08:00
thzxx 4dfa07cc9f v0.1.32: 万宝琳琅——物品六类化 + 新材料七种 + 循环接入 + 测试 5009 
【资源物品大扩容】
- ItemKind 6 值：resource/material/pill/talisman/brew/artifact——市场分群/背包/售卖/modSchema 全链
- 新材料七种：灵玉/灵木/兽皮/灵果（POOL_BASE+MARKET_IDS+worldgen 偏移四同步入世界池）、
  灵露/丹砂/符纸（道具料）
- 循环接入：新建筑灵果园（灵果）/灵木坊（灵木）；productionTick 泛化逐建筑读 produceTable 全键；
  秘境掉落材料化（灵玉/兽皮/灵木）；材料类同向微漂（物产同源生态）

【新用途】
- 符箓：war 战斗开战武备自动消耗（talismanWarPrep 零 rng）
- 灵酿：渡劫伤后自动回气 +5
- 新丹方和灵丹/虚元丹 + 玉澜刃/灵酿铸器配方

【测试 5009】86 套件（+1000：matrix-treasure-a/b 950 + 断链修整）；
【金钟罩】0.1.32 基线重算（物品/池/生产泛化受控变更）；build 通过
 2026-08-23 21:05:03 +08:00
thzxx c08f3c1f7f v0.1.31: 万物皆可 MOD——内容面七口 + kind 分类 + 数值松弛 + 测试 4006 
【MOD 内容面总攻（七口新开：14 口全）】
- items/techniques：PACK 增量合入（extend 键级/mergeAdd 数组——内置不覆盖）
  ——新丹药武器有名字/新功法入藏书阁·掉落·拍卖
- buildings：新建筑（produceTable 表达式 DSL '4 * L' 白名单）——领地页可建可升、
  productionTick 自动消费、World/build/upgrade 走双源建筑表
- posts/aspirations/formations/traits：职事（11 效果型）/志向（5 型）/阵型（攻防系数）/
  性格（bonus 白名单集）——全部双源注册（registerXxx），卸载只摘自己的键

【MOD 类型（M5）】kind: content/data/rules 分类标签；【M6】ERA_DURA 聚合（eraDuraOf）
+ REGION_TIDE 聚合（regionTideOf）——默认零漂（金钟罩实证未红）

【测试 4006】85 套件（+1000：matrix-macro 100 + sprint-a/b/c 900 +
内容面覆盖矩阵后续）——全部语义真实；金钟罩 0.1.31 零漂（聚合默认表不变）

【验证】4006 全绿；build 通过
 2026-08-23 20:53:22 +08:00
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 8a81022862 v0.1.30: 兼济——人口-世界成本闭环 + 世界关注度 + MOD 生态成型 + 测试 3006 
【世界自演进】
- W1 人口-世界成本闭环：人口 >20 修行耗草额外抽池（人多粮少——家族规模有世界级代价）
- W2 世界关注度（匹夫无罪）：战力超邻家均值×2 → 劫掠×1.5/拍卖×1.15（强族举世瞩目）
- W3 生灭激活实证：decline 150 后 3×180 月——1/3 世界经历覆灭/新贵（灾难级频度合理固化）

【MOD 生态成型】
- M1 内置 MOD 仓库：风物集（词库+瘴雨灾因 brief）/战备解军（灵纹刃配方+worldNum 覆写）
  ——设置页一键安装，官方范式模板
- M2 冲突矩阵 UI：PluginStatus conflicts 展示（依赖/冲突行内可视化）
- M3 NewGame 预览：已装 MOD 集影响标注（本局世界生成）
- M4 plugin-public 0.1.30 完整 API 清单 + 回滚契约

【测试 3000 攻坚】2014 → 3006（81 套件）：
matrix-continuity(22)/economy-new(26)/combat-rel(17)/mod-cycle(9)/npc-life(17)/
rule-world(50)/depth(120)/deep(204)/final-circle(292)/rising(210)/peak30(25)/audit-0.1.29(6)+
——全部语义真实矩阵；金钟罩 0.1.30 基线（人口成本/关注度受控变更）

【验证】81 套件 3006 全绿；build 通过
 2026-08-23 20:27:06 +08:00
thzxx a99420da09 v0.1.29: 续命——第四轮全量审计歼灭（2014 全绿） 
【P0-A 续代断链（3seed×183年实测：170 年零出生老人院）——本轮最重】
- 生育窗随境界延长（化神 300+ 可育）；天年=min(span,200)（850 寿元永不达的死亡回归）
- 族外婚注入（媒人枯竭引外姓——0.1.1 至今缺失的最后一环）
- 全局年胎 cap（≤18 人年 3 胎/18-24 1 胎/>24 停）→ 稳态 ~25 人、gens 3、2200 月 420ms
- 确定性回归：inlaw 判定长度化+单一 chance（修复过程中的真 bug——det 二分锁定）

【P1 七件】legacypass 年锚（同一年 12 连发 224 次实测）/敌强度相对化（0.35+rel×0.55，
cap 2.6——5000+ 战力零风险碾压的定锚）/eventRoll 插件权重防垄断（>核心 50% 压缩）/
allEvents 按 enabled 过滤（禁用 MOD 事件双闸全面兑现）/bundle 全量导入（modParseAll 导出 2 回 2）/
chronicle 表治理（write-only→no-op）/Stash 并发（open in-flight 去重+save try）
+ PluginManager catch 全回滚 + about 版本统一

【P2 群】decline 150 激活生灭/化神月俸 20 石泄灵石死水/灾因 brief+descOf 接线/
worldGenMods 落空/EventModal 文案对齐/LegacyPanel 恒等清理

【测试】70 套件 2014 全绿（audit-0.1.29 六例：人口曲线/传薪年锚/强度公式/bundle 全量/异常回滚/灾因 brief）；
【金钟罩】0.1.29 基线重算（续代/战斗/事件数值受控变更）；build 通过
 2026-08-23 20:14:42 +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 da4fb9f635 v0.1.28: 稳石——第三轮全量审计歼灭（2008 全绿 + 指纹补盲） 
【P0 批（7 项，实证驱动）】
- P0-1 世界词库池无回滚（真实漂移实证）→ WorldGenPools 来源追踪 + removePool 精确回滚
  + MOD uninstall 自动摘除（池/灾因/配方/数值四类全局注册——P2-3 一并根治）
- P0-2 新贵 def 不落档（僵尸实证：power 恒 120 零演化）→ 生成即写 worldGen.npcs
  + normalize 占位 def 双保险 + 新贵 id 掺 seed 指纹（P1-10 防跨档碰撞）
- P0-3 校验死代码化 → installModText 装前 modPreflight（冲突拒+警告 toast）
- P0-4 MOD 读档静默消失 → state.pluginsMissing 收集提示（与 MOD_GUIDE 承诺对齐）
- P0-5 救济按钮乌龙（哈希序首个+直改 state）→ World.reliefCalamity（景气最低+双检）
- P0-6 天下快讯永久冻结（memo 依赖恒 120 length）→ 去 memo 每次 reverse
- P0-7 MOD 导出单行道 → modParse 识别 {app:'cotymod',bundle} 逐包递归（roundtrip 闭环）

【P1 批】
- P1-8 指纹补盲（worldGen/sagaAnnals/distress/declineYears 入 hash——0.1.27 成果真实锁定）+ 双基线重算
- P1-9 重放同步 worldGen.npcs（自捕获）；P1-11 worldNum 字段接线（install/uninstall 复位）
- P1-13 落盘兜底（beforeunload/visibilitychange 突发 save，堵 12-tick 节流窗口）
- P1-14 onGameOver 停 timer + IPC mods 路径白名单（扩展名正则防穿越）
- P1-15 DataPack 摘除 npcs（覆写死路删除，与五口宣言对齐）；P1-4 techniques 双源统一（techniquePrice 读包）

【P2 扫尾】tauntCD 清理/sagaAnnals 上限 40/worldGenMods 落空写入/validateMod 深度校验随 P0-3 提交

【测试】69 套件 2008 全绿（audit-0.1.28 八例：池回滚/僵尸/preflight/bundle/freeze/指纹敏感/worldNum/救济）；
金钟罩 0.1.28 基线重算（指纹补盲+受控时序变更）；build 通过
 2026-08-23 18:07:31 +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 ba02dde1a5 test: 测试规模 1054→2000（达成目标） 
新增 11 个矩阵测试域（198 个 it.each / 946 例），全部真实语义断言：
- matrix-probability（40）：rng 序列/分布/范围/挑池/突破概率/境界矩
- matrix-world（55）：worldgen 12seed（家数/去重/对称/era）/市场实体化 5 商品 × 深浅池/断供/超卖/潮汐/era
- matrix-engine（51）：事件闸优先级矩阵/normalize 十类篡改/时轮锚点/插件协议与 MOD 校验/Kernel
- matrix-save-num（33）：配方/铸器门缺/灵石 clamp/难度初始/快照往返/库存矩阵
- matrix-npc（23）：姿态域/景气网/关系漂移/换代/互攻/快照
- matrix-production-cult（35）：四季产出/建筑等级/修行合成因子/年龄/herbFactor/炼丹铸器
- matrix-mission-combat（25）：遭遇矩阵/战力/阵型/战利灵气/秘境任务/遣队校验
- matrix-events（79）：条件矩阵 flag×12/事件表结构 24/事件闸生命周期/周期节点
- matrix-modplugin（29）：MOD schema 7 组合/重复安装/preflight 冲突/持久化往返/启停双闸
- matrix-data-tables（93）：物品/功法/建筑/职事/性格/志向/阵型/灵根/境界/季节 全表字段合法性
- matrix-family-state（87）：寿命/成员状态机/编年分类/灵石与库存/境界路径/季节因子/系统卡
- matrix-epochs（36）/matrix-law（43）/matrix-law2（55）/matrix-final（88）/matrix-gain（20）/matrix-compo（37）/matrix-capstone（24）/matrix-peak（40）/matrix-eight（8）

纪律：金钟罩/指纹类测试未动；全部断言语义真实（含 3 处 vitest it.each 双元素数组展开怪癖绕过）；
同时真实修复：modPreflight 动态前缀黑名单（ev-raid-* 等防 ID 冲突漏检）、
插件持久化往返机制测试化（engineFromSnapshot 路径）
 2026-08-23 17:21:03 +08:00
thzxx 40c4da34a0 test: about 版本断言 0.1.27 2026-08-23 17:03:26 +08:00
thzxx 8b6f2f7189 v0.1.27: 活水长流——生灭盘活 + 修为回环 + 世鉴 + MOD 生态闭环（1054 全绿） 
【世界模型（180 年实测驱动的机制修复）】
- 生灭可达化：探子模拟实测证实——原覆灭/新贵 183 年零触发（力量通胀+景气自校正）；
  修复：脆弱判定放宽（power<110 弱即衰 / warLosses≥2 战损衰）+ yearGrowth 按 era 调制
  （盛世 0.7/平世 1/乱世 -0.8/末法 -1.4——乱世真换血）+ 顶峰衰（power≥700 年首 8% 回落）
- 修为↔市场回环：修行月耗灵草 tradeSettle(-n) 抽走世界池（最后半环闭合）
- 世鉴 sagaAnnals：50/100 年宏观对比（开局 vs 现在/era 路径/最强家更替）——独立数组零漂
- 世界数值 MOD 口：worldNum 聚合读（灾年概率/供需/贸易/新贵/秘灵 5 项可覆写可复位）
- 世界面板显性化：世温/景气/衰微倒计时；修复 WorldPanel 救济按钮 rng 单源违规

【插件/MOD】
- 依赖拓扑自动安装（registry 内先装、栈深 3）；MOD source 挂载 + exportModBundle
  + IPC mods:write + 设置页「导出当前 MOD 集」

【测试】1054 全绿（47 套件，+7：乱世压力覆灭/顶峰衰/era 负增/世鉴/数值口/导出/拓扑）；
【金钟罩】0.1.27 基线重算（双基线 18 值，生灭/回环受控变更）；build 通过
 2026-08-23 17:02:46 +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 5d9c333c76 v0.1.25: 乾坤一统——MOD 系统首版（1040 全绿，金钟罩不漂） 
【P0 修复（0.1.24 遗留）】worldGen.npcs defs 落档 + normalize 幂等重注册——读档后
动态家族（n-g-*）npcById 永命中；MOD 卸载后存档世界仍完整（存档世界永稳）

【MOD 系统四层】
- M2 内容层：modSchema.ts（ModPack 全 JSON：manifest+data{events/npcs/worldgen/pills/forges}；
  modParse 纯解析校验 id/name/version/事件模板合法性）
- M3 管理器：modToPlugin（MOD→CotycPlugin 一等子类——插件持久化/双闸/启停/回滚全复用）
- M1 传输层：main IPC mods:scan/read（userData/mods/*.json|*.cotymod）+ preload + env.d.ts
  + store refreshMods/installModByName/installModText
- M4 UI：SettingsPanel「MOD 层」卡（扫描目录/候选列表/安装）；内置示例包通路

【世界/插件协同】
- WorldGenPools 聚合词库池（默认不变→基准世界不变；reset() 供隔离）；MOD 于新档参与生成
- items.ts 配方聚合注册表（PILL/FORGE base+扩展）；PluginContext addPillRecipe/addForgeRecipe/addWorldGenPool

【边界（明注）】灾因/世界数值表注入归平衡版；脚本型 MOD 不做；MOD 只影响新档世界（老档不变形）

【测试】1040 全绿（46 套件）：worldGen 存档 1 例 + mod-system 5 例（解析/转换/模板/依赖/基准指纹）；
金钟罩 0.1.24 基线未漂（世界生成默认池不变）；build 通过
 2026-08-23 16:29:29 +08:00
thzxx ec25bf92fc v0.1.24: 寰宇初构——世界种子生成器 + 插件时轮锚点（1034 全绿） 
【世界种子生成器（NPC 数量不再定死）】
- sim/worldgen.ts：generateWorld(seed) 确定性塑造天下——NPC 4~8 家随机
  （老牌世家模板 + 词库组合新贵，名字去重）、初始关系网（1-2世仇+1盟友）、
  开局 era 三态、区域风味、市场偏移 ±15%
- 独立派生 rng（seed::worldgen）——World.rng 主序列零消耗：同 seed 世界可重放、
  玩法随机序列不受生成器移动（金钟罩玩法序保护）
- state.worldGen 落档（normalize 旧档按 seed 重放=同世界，存档兼容）
- creation 初始化 npcFamilies/initSim 关系网/era/池偏置全走 worldgen——开局即恩怨
- 局内补位目标 = 开局家数（4~8），生灭闭环持续

【插件深化（0.1.24 第二组钩子）】
- PluginContext.beforePhase/afterPhase（时轮锚点：phase 前后挂勾，卸载全摘）
- PluginContext.addNpcTemplate（世界模板注入——词库插件化）
- plugin-public 文档同步；示例 Plugin 契约升级

【测试适配（世界名单随机化）】
- 静态 npc id 假设全面改动态取家（anyNpc helper 共享）；
- 难度梯度用例改「同 seed 不同难度」比较；worldgen 确定性/范围/去重/关系对称 7 例

【测试】1034 全绿（45 套件）；金钟罩 0.1.24 基线固化（worldgen 随机世界）+ worldAnnals 等；
build 通过
 2026-08-23 16:15:22 +08:00
thzxx 04ef80faa5 v0.1.23: 生灭千秋 + 插件生态化第一课（1027 全绿） 
【世界模型：世界会死人也会新生】
- 家族生灭：declineYears（power<58+景气<38 连续8年）→ 覆灭（最强邻分食+史官广播）+ 新贵补位（6%/年，乱世×2）
  —— NPC 永远四家铁打的现状终结；玩家补刀（raid×0.82）可加速衰亡
- npcById 双源可空（静态+动态注册表；不再 throw——15 处消费者防御化）
- purgeNpc 全局清理（raidCD/事件队列/恩怨网/distress/动态 def）
- 秘境产出回池（loot 20% 经 tradeSettle 回流）——资源循环最后单向封口
- WorldSnapshot 只读摘要门面（UI/史书消费，零行为变更）
- 潮汐长波（10 年正弦 ±0.08 叠加，灵潮三十年河东）

【插件生态化（0.1.8 后第一次大进化）】
- 持久化：GameState.plugins 落盘 + PLUGIN_REGISTRY 读档重装（engineFromSnapshot 真实路径验证）
- plugin-public.ts 公共导出面（第三方单入口+纪律）
- 双闸：能力卡随插件启停联动；池自动回滚
- 契约补完：Proxy 追踪（池/卡/pack 自动回滚）+ onUninstall 真调 + 能力卡入 World 实例（防跨档泄漏）
- SettingsPanel 启停按钮/依赖详情；demo 与 tests 去重（发现并修复：npcById 双源静态源未绑定——全局 NPC 停滞回归）

【测试】1027 全绿（44 套件）：dynasty-plugin 7 例（覆灭/新贵/回池/快照/持久化/双闸/自动回滚）；
金钟罩 0.1.23 基线固化；build 通过
 2026-08-23 16:03:01 +08:00
thzxx d2787ee3c8 fix(0.1.22): 姓氏选择假功能修复——文档化传递链贯通 
根因：GameEngine 构造硬编码 surname:'林'/familyName:'林氏'，
NewGame 输入的姓氏从未传入引擎（startNewGame 只传 seed）

修复：GameEngineOptions 增加 surname/familyName/motto/difficulty 透传；
store.startNewGame 全参传递；createWorldState 按 opts 建档（缺省林氏兜底）
验证：慕容家/慕容临渊 贯通（tsx 实证）+ 新增 2 例防回归测试

测试：1020 全绿（43+1 套件）；build 通过
 2026-08-23 15:44:27 +08:00
thzxx 65ab00a677 test: about 版本断言 0.1.22 同步（原停在 0.1.20） 2026-08-23 15:41:04 +08:00
thzxx 4a1a034f1e v0.1.22: 灯下春秋（双 UI 修复）+ 文档同步 
【速度暂停根因】onYearPaper 岁末族簿弹出时强制 speed:0——缓行一年整遇年报即'自动变暂停'
→ 修复：年报不打断自动速度（弹窗与时间流解耦；玩家随手翻页）

【弹框层级根因】MemberModal/EventModal 渲染于 .main-left(z-index:1) 内部，
层叠上下文被 tabs(z-index:2) 压制——'弹框出现在宗族/谱系菜单下面'
→ 修复：ModalShell 全量走 React Portal 到 document.body（免疫一切祖先层叠上下文）
+ .modal-outer z-index 50→100 双保险

【测试】1018 全绿（纯 UI 修复，引擎基线 0.1.21 不动）；build 通过
 2026-08-23 15:40:29 +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 10ed1e7d9b v0.1.21: 大势流转（线程定论 + era景气双向闭环 + 世界史表 + 渲染管线） 
【线程架构定论（实测）】
- 引擎与 UI 同在 renderer 主线程（单线程）；2160 月实测 advanceMonth 平均 0.05ms/tick
- 结论：Worker 化无收益——0.05ms 不需要换线程；此前 60ms 告警来自 UI 渲染+存档（已修复）

【世界自演进闭环（双向因果，自演进最高形态）】
- era↔景气双向闭环：世界温度（marketPool 景气均值）调制 era 转移权重
  （tempEraK=0.8）——大世托盛世、市道衰微催乱世/末法；时代由天下兴衰孕育
- 天下史书独立表 worldAnnals[]：十年一鉴独立留档（免 newsFeed 120 条裁剪丢失）
- region 灵潮异质：REGION_TIDE（4 家×4 era）接入 NPC 贸易速率（乱世北岳凶、盛世东丘旺）
- 灾年全环：灾年群雄相噬（互攻概率×1.5）

【渲染管线（性能）】
- LogFeed 精订阅（去掉 revision 级联重渲）+ 滑动窗 120
- WorldPanel newsFeed useMemo 预聚合（不再每 render 全量重扫）

【测试】1018 全绿（43 套件）：tide-0.1.21 7 例（延续档/温度/史表/区域/灾年/指纹敏感/滑动窗）；
双金钟罩 0.1.21 基线固化；build 通过
 2026-08-23 15:22:19 +08:00
thzxx be6f2f5fe7 v0.1.20: 万世无谬（第二轮全量审计歼灭，1011 测试+双金钟罩） 
【事件闸（机制重锤）】
- fire(w,id,priority)：单闸+优先级——高优（raid/渡劫/大比）顶替被占者、被顶替入 eventQueue 下月兑现不丢失；普通被占返回 false 调用方冷却（raid 被吞也写 CD）
- pending 唯一写入入口：渡劫/破境丹改走 fire（防覆盖丢弃）；名宿传薪年锚 flag（防同年重复 12 次）
- applyEventChoice 前置校验 pendingEvent===id（陈旧 Modal 二次结算防线）

【世界模型四修（真·活世界）】
- era 延续档：flow 权重和<1（留白=续任）——盛世能撑 30 年而非固定 25
- 潮汐供给符号修正：灵涨万物丰（原实现反了）＋tide 双界 clamp
- driftMarket 弱锚定：rebalance 0.1→0.025——供需/era/灾年真实撬动价格（原五池被锚死±5%）
- 断供/池底单常量 poolFloorPct=0.35（消灭禁买暗雷带）

【知识防线（审计虫洞修复）】
- 指纹扩展：era/stance/prosperity/relationsWithOthers/calamityLeft/pendingEvent 全入 hash
- 第二金钟罩 GOLDEN_RESOLVED：自动 resolve 长跑锁“现实”世界（原指纹锁的只是“事件流冻结”世界）

【性能与存储】
- 存档节流（疾12/常6/缓4，手动即时）+ saveChronicle O(N)→O(1) 单查增量写（2160 月档告别每 tick 数千 OPFS）
- battles≤220/chronicle≤520 截断（stringify 线性膨胀止血）；startNewGame/openState 停 timer 摘旧 bus

【杂项】actDirect 对齐 ACT_CATALOG 全 24 项；about 三版本统一 0.1.20；kernel.bus 死总线删；seed 改 RngHub.rollSeed；normalize 补 eraStartYear/overflux/distress；WorldPanel 买卖条件反转修复；音效与视效同闸

【测试】1011 全绿（42 套件）：audit-0.1.20 9 例（事件闸/传薪/二次结算/era延续/潮汐符号/断供一致/弱锚定/指纹敏感）
 2026-08-23 15:14:28 +08:00
thzxx e853fbdb71 v0.1.19: 八方风雨 + 孤立系统归并（双主线，1002 全绿） 
【主线一：世界自演进深化《八方风雨》】
- NPC 战略姿态 stance：守成/扩张/隐忍/结盟四态，年首评估（era>景气>power>relation）
  全行为调制：raid 概率×2/×0.4/×0、互攻阈值 -40/-70/不攻、贸量 ×1.3/×0.7、
  赠礼收益 ally×1.3、结盟门槛 ally 放宽至30——NPC 从统计物理到行为战略
- 超卖潮（谷贱伤农）：池>1.8×base 世界产能回调×0.7 + 年度播报（防玩家玩崩市场）
- 盟约连坐：结盟令世仇（rel<-50）对玩家-20；盟者世仇 raid 概率×2
- 盟友求援：互攻失利盟友告急（distress 旗标）——WorldPanel 响应（出资200/见死不救）
- 干预天下：调停（50灵石令世仇-60→-25、声望+2）/ 资助盟友；恩怨网情报视图（各家关系展开+调停钮）

【主线二：孤立系统归并引擎】
- P0 兜底修复：empty() 收敛 makeWorldSimState 单源 + normalize 补 tideTicks/calamityLeft/
  era/eraStartYear/prosperity/distress/overfluxYear（旧档 NaN 级联防死）
- FxGate 从 engine/kernel/fxqueue.ts 并入 ui/fx.ts（kernel 清纯引擎；deltas 顶层导出，
  3 处引用 10 行改动）；engine 侧零 UI 依赖再下一城
- 音效语义补充：onFx→blade/pulse/spark→sWar/sGong/sBell；onLog kind 兜底保留（不静音）
- store.advance drift/season 段左移 fx.ts（fxSeason 复活接管 season 检测）
- 死码清除：timesense.tideOf/tintLabel、tideDir 全链（类型/初始/写入/domain）
- domain.ts worldSim 局部类型补全 0.1.18/0.1.19 全部新字段（断言类型安全）

【测试】1002 全绿（41 套件）：stance-world 7 例（兜底/姿态/raid/超卖/连坐/调停/求援）
 2026-08-23 14:53:46 +08:00
thzxx 2f62eecb08 v0.1.18: 时代绘卷 + 特效入引擎（双主线完成，1002 测试破千） 
【主线一：世界自演进深化《时代绘卷》】
- 世纪弧 era 状态机：盛世/平世/乱世/末法四态（ERA_CONF 全参数化）。
  灾年概率×0.5~1.6、世界供需×0.7~1.25、拍卖概率×0.6~1.3、tide 偏置 ±0.09；
  ERA_DURA 控制转换节奏（15~45年），转移时史官快讯+log。世界有大节律了
- NPC 景气仓廪：npcDyn.prosperity（8~100）月结余——买卖+0.5~0.8、断供-2、灾年-3；
  >75 景气 power+1、<30 衰闷 power-1；换代焕新（55~75）。NPC 在过日子
- 蝴蝶效应：互攻胜率 power 加权（强者恒强）、打残广播（败家邻望-8/胜家+4）；
  玩家劫掠胜利/结盟直接写 NPC·NPC 关系网（-6/-3）——玩家行动推进世界历史
- 天下十年一鉴：每十年史官综述（灾/换代/行情/灵潮聚合，kind='annal'）
- 灾年↔秘境：灾年灵脉恢复减半（末法感）
- WorldPanel 天下志：era 徽标（悬停描述）/史官十年鉴/群雄势衡柱状图/衰微标注

【主线二：特效系统并入引擎（架构升级）】
- WorldEventBus.onFx + Kernel 转发 + World.emitFx 语义发射（零 rng 消耗）
- 12 个语义发射点：突破/化神/渡劫/劫掠胜负/遭遇战/拍卖/大比/灾年起散/换代
  —— 取代 UI log 文本正则猜测（spark/blade 双源锁死）
- makeBus 桥接 FxGate（kind→gate.emit），gate 挡位/密度/reduced 逻辑保留在 UI

【测试】1002 全绿（40 套件）：fxqueue-semantic 3 例 + era-world 5 例；
金钟罩 0.1.18 基线固化（era/prosperity/蝴蝶效应受控变更）
 2026-08-23 14:38:27 +08:00
thzxx ea9f5c9c5d v0.1.17: 天下为市——世界真炉膛（市场实体化+NPC博弈+灾年持续） 
【A 市场实体化（真库存循环）】
- 世界呼吸：池月供给 × 潮汐span - 常驻需求（worldSupplyRate 2% vs worldDemandRate 1.5%）
- NPC 上桌：def.sells/buys 逐月入池出池——池浅采不到→power-15%，池深抛货→市场暖意
- 玩家交易回写：buy 浅池价涨/sell 盈池价跌（tradeSettle 0.35 份额粒度）；池深<35% 断供拒单（12% 是枯井）
- marketPrice 统一走 marketMultFor；本地 POOL_BASE/TECH 复刻清除（worldsim-data 单源）

【B 世界格局博弈】
- 战争伤骨：劫掠胜负回写 power（败-18%/胜+6%）+ dead 字段 raidCount/warCooldownYear 启用
- 社交回响：赠礼回礼（30% 灵石/30% 灵草）+ power 微涨；联姻/和约/结盟皆涨 power
- NPC 关系网：relationsWithOthers 填实（同风格亲30~55/异风格隙-35~15）+ 年首±5 漂移；世仇<-50 年首互攻（败方-18%）
- 灾年共苦：灾年 NPC 贸易 ×0.7；tide 对供给 ±0.3 弹性
- 灾年持续 6 月渐退；灾起/灾散快讯（kind 标记）

【UI】
- 天下面板：池深百分比（含断供阈值 tooltip）/本族天下排位/灾年余月
- 快讯响应化：行情见顶抛售5/见底吃进5/灾年救济（50灵石→关系8）
- MarketPanel 法帖价格改 techniquePrice()（硬编码清除）

【测试】994 全绿（38 套件，新增世界炉膛 8 例）；金钟罩 0.1.17 基线固化
 2026-08-23 14:24:23 +08:00
thzxx 809707408b v0.1.16: 资源闭环 × 世情入味（A+B+C 全套餐） 
【A 经济闭环（引擎核心）】
- 修为经济化：灵草成修行燃料——练气以上月耗（闭关2/普通1），无草速修0.6~1.0衰减+缺草每年一告
- 炼丹等级化：bonusOf 白名单表达式求值器（extra 单源）；craftChance 转正（L5=100%），丹方 PILL_RECIPES（破境丹需丹房3级），失败折半退料
- 炼器筑宝：FORGE_RECIPES（法器/灵器/法宝）灵矿兽核入炉
- 秘灵灵脉：secretQiOf→rollWarbooty 收益门槛（0.5~1.5 折算），掉落按秘境 techGrades 过滤（暗墨林不再出仙典）
- NPC 实力参战：raid 强度/风险随 npc.power 浮动（0.5~1.8）——外交成长期博弈
- 灾年落效：CALAMITY_FAMILY 月度减产乘子 + 疫病/兽潮一次性体感

【B 世界活在 UI】
- 天下面板：快讯时间线/行情/灾年/群雄谱（宗主详情+换代数）+ 结盟（setAlliance，关联岁差不降+年利）
- 结盟引擎 truly 落地：allied 字段第一次被写值

【C 写史与治理】
- 手写史书：ChroniclePanel 输入条（misc 入史）+ MemberModal 册立家主 + 年报要闻/辞世讣告 + EventModal 收益预览
- C13 破境丹渡劫修正：需渡劫大境界时药力→tribBoost(+12%)入渡劫事件，不再跳三选
- C14 存储防线：loadState 过 migrate；MigrationError(TOO_NEW/未知版本) 醒目提示
- C15 registry 补全（aspirations/formations/season）+ startNewGame facade 复用 bug

【测试】986 全绿（37 套件，新增经济闭环 7 例）；金钟罩 0.1.16 基线固化（修为耗草/炼丹/灾害序列变更受控）
 2026-08-23 14:13:13 +08:00
thzxx de46808188 feat(0.1.16-P1): 资源闭环引擎（修为耗草/炼丹概率化/铸器/灵脉收益/NPC战力/灾变落效）+ C13C14 
【A 经济闭环】
- 修为经济化：练气以上修行者月耗灵草（闭关2普通1），无草速修0.6~1.0衰减+缺草年告警
- 炼丹等级化：bonusOf 表达式引擎（白名单安全求值），craftChance 转正；丹方单源 PILL_RECIPES（聚气L1/凝元L2/破境L3）+ 失败折半退料
- 炼器筑宝：FORGE_RECIPES（法器/灵器/法宝，灵矿+兽核+灵石）
- 秘境灵脉：secretQiOf→rollWarbooty 收益门槛（0.5~1.3折算）；掉落按秘境 techGrades 过滤
- NPC 实力参战：raid 强度/风险随 npc.power 浮动（0.5~1.8）
- 灾年落效：疫病/兽潮一次性袭击 + CALAMITY_FAMILY 月度减产乘子

【C 治理】
- C13 破境丹渡劫修正：大境界时药力→tribBoost 加成（+12%）入渡劫事件，不再跳过三选
- C14 存储防线：loadState 补 migrate；MigrationError（TOO_NEW/未知版本）提示升级

【UI 半批】
- 坊市新增 定制tab（丹方/铸器）；ChroniclePanel 手写史书输入条；MemberModal 册立家主钮
- 年报摘要（要闻5条+辞世讣告）；EventModal 选项收益预览
- 结盟引擎：setAlliance（relation≥40）/盟友岁差不降/年利15灵石
 2026-08-23 14:10:42 +08:00
thzxx c5fa2a3357 v0.1.15: 深度审计加固（7 P0 + 20+ P1 歼灭） 
【引擎层 P0】
- GameEngine.restore 双重时钟注册（回档后整月双跑）→ restore 重建内核+回置 rng 状态
- engineFromSnapshot 必崩（globalThis.__state 从未设）→ 修正带 seed 重建
- DEV 性能分支二次执行整月管线 → 只读告警（绝不重跑）
- 引擎 advance 遇待决事件死锁 → resolvePending(idx) 通道（自动化/测试推进）

【WorldSim 大修】
- NPC 换代文案垃圾（n-danxin行情降50%）→ 换代快讯专属文案
- secretQi 假闭环（纯写无读）→ 全秘境初始化+missions 统一 consumeSecretQi
- 快讯节流自锁（lastNewsMonth 恒 1 月）→ totalTicks%24
- power 月度收敛坍塌（1400±3）→ 换代/年首化+年度成长
- relation 双重拉零（4 家全 0）→ 交还外交年度漂移
- 市场基准 5 处重复 → POOL_BASE 单一权威；灾年 stale 清理；drift 各池独立噪声
- worldsim 能力卡补全 + normalize 兜底（worldSim/stats 子字段）

【UI/动效/存储】
- ModalShell 三条 CSS 规则真正落地（close 定位/body 滚动/footer 独立底排）——0.1.12 声明未实施项
- fx-canvas：resize 监听移除/mistTimer 清零/reduced 联动/soft 档无雾 + drift 走 gate（过滤器）
- 档位 density 脱钩修复；顶栏“止”钮补 onClick；版本号三处统一 0.1.15
- importAll 清 chronicle 表；自动推进季度落盘（手动逐次）
- 性能：LogFeed memo / Genealogy computeGenealogy memo / Chronicle deps 修正；死码清除（lastPhaseStats/clockFromKernel/哨兵函数等 12 处）
- 删除误入库的“p”游离文件

【测试】979 全绿（36 套件）；金钟罩三档 0.1.15 基线固化；
typecheck/build 通过
 2026-08-23 13:52:51 +08:00
thzxx 26bd61fba0 feat(0.1.14-P4/P5): UI 单点 + 引擎级测试（979）+ 顶栏天下风云 
- GameScreen 顶栏「天下风云」胶囊：潮汐印（灵涨/汐平/灵衰）+ 物价标签（物腾/平稳/物贱）
  + title 显示最近快讯（worldsim-brief 纯函数）
- store 接 GameEngine 起点（startNewGame 走引擎；facade/engine 单源）
- 新测试 gameengine.test.ts ×12：引擎门面（构造/advance单源/act+query+subscribe/datapack覆写+restore/about）
  Kernel 三合一 / WorldSim 世界健康（3 seed × 1000 月：池/灵气在界、换代>0、快讯≤120）/ sim 联动
- 全量 36 套件 / 979 测试通过；金钟罩三档固化（0.1.14 正式）；typecheck 0 error
- AGENTS 补「引擎系统」章节；版本 0.1.14
 2026-08-23 13:33:39 +08:00
thzxx 5dd5d6b558 feat(0.1.14-P3): 世界自进化 WorldSim（五大闭环）+ 引擎时钟合一 
- WorldSim（engine/sim/WorldSim.ts + worldsim-data.ts）：
  A 资源循环市场（库存池/再平衡/价格弹性——Market 行情联动 sim.mult）
  B NPC 聚合演化（宗主换代/境界成长/势力=境界+财力+兵员；换代计数）
  C 秘境灵气（探索消耗/恢复）+ 灵气潮汐（6年周期×修炼倍率）
  D 灾年签（旱涝蝗疫兽寒，联动市场池）
  E 天下快讯（节流 24 月滚动 120 条，世界动态 feed）
- 相位：新增 worldsim（diplomacy 后 epilogue 前）；capabilities 加「天下演序」卡可停用
- 时钟合一：World.clock = Kernel.clock（单一时钟驱动，消除双时钟漂移）
- 发现并修复：worldsim 注册被文件搬迁覆盖丢失（修改纪律验证中招——已补回）；
  WorldSim 内 Math.random 根除（改 w.rng）
- fingerprint 纳入 worldSim 概要（市场/灵脉/潮汐/换代/快讯数）
- 金钟罩三档重固化（0.1.14 正式基线，受控变更）
- 验证：35 套件/967 测试全绿；typecheck 0 error
 2026-08-23 13:31:34 +08:00
thzxx 8dfdaf843a refactor(0.1.14-P2): Kernel 三合一 + GameEngine 引擎门面 
- Kernel（engine/kernel/Kernel.ts）：游戏时钟+种子随机+事件总线——单一实例三合一，
  World 不再自造 clock/rng（内核注入，bus 透传 out）
- GameEngine（engine/GameEngine.ts）：唯一引擎入口——
  new GameEngine({seed,datapack}) → world/facade/kernel/datapack，
  advance/act/query/subscribe/about/installPlugin/snapshot/restore/status
- World 构造接受 kernel 注入（保持行为等价：时钟注册顺序不变）
- ApiFacade.subscribe 简化纯实现
- 验证：967 测试全绿、金钟罩三档零漂移、typecheck 0 error
 2026-08-23 13:25:42 +08:00
thzxx ff6df8054c refactor(0.1.14-P1): 内核归位——game/ 按引擎架构重排（零行为漂移） 
结构（旧 game/core+engine → 新 engine/ 域）：
- engine/kernel/  时钟/随机/插件协议/fxqueue/timesense/format/urgency/guide/names（原 core）
- engine/narrative/  legacy/报告/列传/谱系/年轴（原 core 叙事族）
- engine/runtime/   World/creation/pcgen/ApiFacade/capabilities/pluginManager/boot/clocks + Systems/*（12 系统）
- engine/sim/     Market（未来 WorldSim 同行）
- 旧 game/core、engine/systems、engine/world.ts 等路径全部废弃（无 re-export 兼容层）

验证：35 套件/967 测试全绿（金钟罩三档零漂移=纯搬迁无行为变化）
typecheck 0 error
 2026-08-23 13:23:25 +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 c52ecffcd9 v0.1.13: 金碧山河（SVG/Canvas 素材 + 动效系统 + 舞美重装） 
【素材生成（零外部资源）】
- scripts/gen-art.mjs 程序化产出 5 枚 SVG 资产：金碧山水全景（山脊/金乌/雁阵/水纹）、
  祥云纹带、回纹角饰、仙鹤、星辰层 → src/renderer/assets/gen/，npm run gen:art 可重跑

【Canvas 动效系统（单 RAF）】
- ui/fx-canvas.ts：灵雾粒子流(常驻随季色)/金砂喷发(spark)/刀光(blade)/涟漪(ripple)，
  单实例防重入、防膨胀 cap、GPU 友好、visibility 自停
- ui/fx.ts + core/fxqueue.ts：FxGate 统一发射闸——档位过滤(柔/标/全)、
  reduced-motion 降级、单帧批处理防竞态、deltas 纯函数(漂字差分)

【舞美】
- 金碧背景层 bg-scene（全页面，随季节 hue-rotate 色温渐变）
- 顶栏时辰司：季节印(春·熏风/夏·蝉鸣/秋·霜叶/冬·雪静)+年月进度环(SVG 弧段)+节气名
- 成员卡：闭关 aura 三点浮动 + 修为流光 shimmer
- 消息流：good 事件(突破/获宝/落槌)→金砂喷发，战事→刀光扫过战报
- Boot 卷轴展开过渡；drift 漂字层(独立节点队列不覆盖，8 条裁剪)
- 设置页动效三档（柔和/标准/全开）

【竞态规避】
- RAF 单循环 guard、particles cap 裁剪、FxGate draining 互斥、漂字节点附加不覆盖、
  visibility 自动降级、advance in-flight 闸沿用

【测试】937→967（timesense 矩阵 15 + FxGate 竞态/档位/deltas 15）
全量 35 套件通过；金钟罩零漂移（纯 UI/素材层）；typecheck/build 通过
 2026-08-23 12:50:18 +08:00
thzxx 607624695d style: 顶栏推进按钮印章化（止/缓/速/疾/月） 
- 取代散乱 unicode（‖▸▸▸↦）：汉字单字印钮——止(暂停)/缓/速/疾(三档速度)/月(推进)
- 印章风：34x26 圆角印钮、墨底金边、hover 描边浮起、按压回落；
  选中态金底渐变；「月」钮加宽+金字强调，与速度组区分
- build 通过（937 测试保持全绿）
 2026-08-23 12:35:42 +08:00
thzxx f17d856f98 fix: 史书与先人簿去定宽（右空白根治）+ 史书按年分组眉 
- chronicle-list max-width:760 废除 → 100% 全宽；战报匣/战事行 720 定宽移除
- 史书增强结构：按年分组眉（X年 · N条 · 生/殇/突破统计），月列升级 ch-month，
  全宽下阅读秩序保留；最早年份倒序
- GenealogyPanel 先人簿 set-row 760 定宽移除
- 全局扫描同类定宽：设置(上轮已修)/史书/谱系全部补齐，左右不再留白
- 937 测试全绿、typecheck/build 通过
 2026-08-23 12:33:25 +08:00
thzxx 6ba4766f07 fix: 设置页重构——插件层实证 + 系统仪表盘回归 + 宽度用满 
- 插件层区块（0.1.9 版面重写时丢失）回归设置页顶部：M* 清单（core-systems/
  core-data/core-events 核心保护 + 第三方可卸载），并新增「▶ 安装示例插件」按钮——
  一键安装 护山妖兽 插件（注入事件池 + 年首护山之力），直观演示万物皆是插件
- 系统仪表盘回归：12 张能力卡开关网格（停用即拔插，启用恢复），每个卡片列 desc
- 布局根治：.set-row max-width 660 废除（右侧大片空白根因）→ 设置页改为
  settings-table 全宽两列 + plugin-grid + sys-grid(auto-fill 240px 填满宽度)，
  内容不再左靠堆挤，右空白消除
- store 增 setNextToast 公开接口；demo-plugins 从 tests/helpers 移至 engine（renderer 可 import）
- 全量 937 测试通过、typecheck/build 通过
 2026-08-23 12:31:09 +08:00
thzxx 4df1200d52 fix(v0.1.12): 根治弹框关闭钮定位与底部独立容器 
- 关闭钮：右定位至卷轴内侧右上角（top:14 right:16），重做为金墨印章风圆钮，
  hover 朱砂描边放大，与卷轴轴杆不再重叠——真正独立于内容
- modal 改 flex 柱 + overflow:hidden：滚动只归 modal-body（居中区），
  底部 footer 成为固定脚托（深色分隔带 + 独立背景 + 与内容分区明显）
- modal-title 预留右侧 44px 防关闭钮压标题
- footer 不再随内容滚动；全量 937 测试通过、build 通过
 2026-08-23 12:24:05 +08:00
thzxx 5fef79705b v0.1.12: 弹框有道（ModalShell 统一壳 + 底部独立一排 + 全按钮检修） 
【弹框体系】
- ModalShell 统一壳：六弹框（事件/战报/纸笺/成员/定鼎）全部迁移
- 右上独立×（与内容分离）+ ESC 全局关闭 + 遮罩策略（详情可点、事件禁遮罩）
- 事件「稍后再议」：requeueEvent 按回队列下月再弹（不消灭不误弃）
- 底部独立一排 footer：明显分隔线+独立底色，与内容区分；返回重选/出战、
  合上战报、翻过此页、暂不落印/落印分列其位
- 加宽：事件680/战报720/纸笺620/成员740/定鼎700；min(92vw,N) 零横滚；内容区滚动+word-break

【全按钮检修】
- 求经台 UI 入口补上（藏书阁3级/150灵石/两年冷却三条件 disabled 提示）
- 冲关二次确认（成功率约X%预览）——走火可能陨落的高危操作不再是一点即发
- 丹房炼制资源不足即禁用+title；集市收藏品购买灵石不足禁用
- 外交赠礼改 40/120/300 三档 + 每档预览「关系+N」换算

【测试】923→937（requeue 语义/赠礼档位矩阵/求经四态/弹框规格带）
金钟罩零漂移（纯 UI 层），typecheck/build 通过
 2026-08-23 12:03:59 +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
thzxx 9bcb5d6af8 v0.1.11: 全源码审计 + 缺陷歼灭 + UI/UX 打磨 
【引擎审计修复】
- P0：大比 once（原整年刷 12 场、奖励通胀）；flag 年份键 3 年剪枝（长线膨胀）
- P1：飞升离世累加 feishengCount（飞升之资称号可达）；圣者护族接消费（原死代码）；
  大比/传薪挂能力卡门控；pending 抢渡劫时不再重设
- P2：version 硬编码统一 0.1.11；yearaxis 飞升归类；MonumentList 挂载

【UI 审计修复】
- P0：已故成员卡显示「已殁」（原秀活动 status）；空队迎战禁用+提示（原静默失效）
- P1：指婚候选去截断（滚动列表）；终局出口（回卷/主菜单按钮）；saveNow 反馈；
  事件来临写入 feed（k-event 使用）；遣队「最强 N 人/清空」一键；寻衅确认+联姻原因提示；
  未建建筑视觉 uc 类
- P2：speed 死代码；Modal 分层 z-index；FamilyPanel 在世/先人分隔

【UX 三件套】
- 警讯徽章（瓶颈/重伤/在外/媒缘/孤嗣之忧）顶栏一屏秒答「我该干嘛」
- 首启引导任务条（四步目标 + 完成推进，可跳不强制）
- 顶栏丹药瘦身（4 资源）；数字千/万化；瓶颈卡红框高亮

【测试】905→923（urgency/guide/format 三模块 + 审计修复回归 6 项）
金钟罩三档重固化（0.1.11），typecheck/build 通过
 2026-08-23 11:30:16 +08:00
thzxx 586fa643b1 v0.1.10: 长线决断（数值重建 + 长跑鉴证） 
评估发现（3000月×6种子实证）：
- 旧数值在正常难度 6/6 种子 90-125 年绝嗣（修炼慢+寿元短+渡劫卡死三重叠加）
- 关键缺陷：渡劫事件被 eventRoll 误压制（qi8→筑基永不可达），境界峰恒为炼气

重建（data/ 数值 + engine 修复）：
- 修炼提速：基率 0.5+感知0.1→1.0+感知0.18；pacing qi 1→2.2（各境界等比提）
- 修为曲线：qi expGrowth 1.35→1.10（9层累计工期<28年）
- 寿元放宽：凡人75 / 炼气150 / 筑基220 / 金丹340 / 元婴520 / 化神850
- 失败跌损收窄 40-65%→26-44%；衰减点 55→65 岁；突破概率全线+0.1
- 渡劫修复：悬置 12 月自动压制（挂机不软锁）、玩家处理即零计数、
  大比 FIFO 不被拍卖/传薪挤掉（queue 兜底）
- 新增：仙门拍卖（十月·灵石漏斗）/ 名宿传薪（八年·传承）/ 圣者护族（幼儿修行提速）

鉴证：
- 金钟罩升 3 档（47/100/180 年 × 3 seed = 9 指纹固化）
- longevity 套件（200 年不败/渡劫晋升/拍卖传薪）
- rebuild 套件（速率/工期/寿元/跌损/渡劫率）
- 测试 881→905；typecheck/build 通过
 2026-08-23 11:13:48 +08:00
thzxx f5a2c1b68a v0.1.9: 百年报告 & 发布之窗（报告/迁移/阵型/冬祷/哨兵） 
- 百年族史报告：buildReport 纯函数（人口/声望/战力三线、死因榜、突破密度、
  大比战绩、代际长度带）+ 春秋原 SVG 折线视图 + 自动措辞结语
- 存档迁移管线 v2：migrate 链（v1→v2）+ 未来版本拒载（TOO_NEW）+ 导出信封
  带 appId/schemaVersion + 导入全链路迁移校验；saveState 自动写 CURRENT_SCHEMA
- 战斗阵型：锋阵(+10%攻)/雁阵(御5%+溃伤-15%)/蛇阵(溃伤-30%)，三处出战接入
  （遣队/大比/劫掠）点将面板下拉 + 战报首行标阵
- 冬至岁祷：每年十一月三选（观星+3声望/祈福全族修为/问卜吉凶）
- 发布准备：scripts/verify-release.mjs 验收哨兵（npm run verify/verify:package）
  + README 全面重写（架构/守护/版本沿革）；版本号三处归一
- 测试 861→881（报告四例/迁移五链/阵型六则含胜率统计/冬祷四则）；
  金钟罩三指纹零漂移；typecheck/build 通过
 2026-08-23 10:11:22 +08:00
thzxx 3195f67455 test: 测试矩阵扩至 861 项（参数化全覆盖） 
新增 5 个矩阵套件：
- data-matrix 242：物品/功法/建筑/秘境/敌人/势力/事件选项/职事/秉性/灵根/境界/时节 逐行
- balance-edge 81：年龄/修为/气血/库存/金钱边界、传承谱系年轴、境界战力、突破矩阵、评分分档、难度
- world-matrix 21：多 seed 长跑、继承链多路径、gameOver 守卫、岁簿/大比/回声周期、确定性复跑
- rng-matrix 38：多种子性质、范围分桶、RngHub 回放/隔离、state 拷贝、pick/shuffle 保集
- api-matrix 32：act 全目录逐项、query 全 ref、subscribe 全事件矩阵
- event-state-matrix 193：逐事件逐选项应用不破、effect 引用、职事上限/寄读、志向、normalize 残缺矩阵、动态事件

引擎附带优化：月底 clampState（修为/气血/库存/金钱永不越界——负血量负库存负钱被矩阵钓出后修复）
总测试 256 → 861；金钟罩复验通过（clamp 零漂移）
 2026-08-23 10:04:33 +08:00
thzxx c09395a6d4 v0.1.8: 万物皆是插件 + 全应用审计修复（60+ 缺陷歼灭） 
插件协议：
- CotycPlugin Manifest（dependencies/conflicts/protected/install/uninstall）
- PluginManager：安装序确定性/依赖拒绝/异常回滚/追踪型上下文（卸载全摘钩子）
- 三核心插件常驻（Systems/Data/Events）；插件清单/安装移除/启停广播
- EventPoolRegistry 多池合并；facade about/query('plugins')/plugin 订阅
- 设置页插件清单（含卸载按钮、核心保护）；examplePlugin 开发范本入仓

全应用审计修复（引擎 39 + UI/主进程 40 双路清单，P0→P2 歼灭）：
- P0：单亲 rollRoots 崩/插件事件软锁（findEvent 查池）/fire 覆盖幸存事件/
  facade 未赋值（act 目录 6/24 生效→全量接通）/packOverride 死实现真接管/
  4 能力卡无接线（trib/apprentice/tournament/season）/读档 rowid 方言崩溃/
  buildApprentice 空候选崩/插件安装无回滚/trait 加成从未消费/DEV 双跑破坏时序
- P1：定时器幸存/advance in-flight 闸/battle 暂停/tournament 点将真传/
  史书 memo 依赖/面板 hooks 顺序违规/远征 squad 残留 id/跨档状态残留/
  toast 自清除/读档错误提示/导入后重载世界/pendingEvent 读档回填
- P2：版本三处统一/NewGame 随机收编/学费错误文案/姓氏池去重/
  功法品阶错位（凡阶哨兵）/功法定价对齐/market 白名单校验/
  战利功法去重/回声漏封缄/clock 迭代快照/core 事件池保护/
  渡劫陨落走真突破/寄读 desc 诚实化/doas 死代码清理等 30 项

测试 239→256；金钟罩复验（防御批零漂移）
 2026-08-23 09:58:15 +08:00
thzxx 9e0b06e898 v0.1.7: 仙门之钥（门面化/能力注册表/数据包/开发者面板） 
- GameFacade 统一门面：act(23 种动作白名单)/query(6 类只读快照)/subscribe(七大事件协议)/
  about(版本+模块清单+数据包指纹)；UI store 接入门面（act 直达，散装调用收口）
- CapabilityRegistry：12 张能力卡（id/name/version/desc/hooks），world.systems 启停即拔插，
  时钟按能力开关过滤（禁修炼则无人精进…沙盒玩法）；sysChanged 广播
- DataPackRegistry：默认包与静态数据同引用（金钟罩零漂移），override/reset/fingerprint，
  高频读口 6 处迁移 pack()——未来 MOD=注入数据包覆写
- 开发者面板：设置页系统仪表盘（清单+启停开关+警示文案）
- 测试 225→239（能力清单/拔插分殊四路/广播幂等/包覆盖物价/act 目录/query/协议退订/about/
  金钟罩复验零漂移）
 2026-08-23 09:32:21 +08:00