MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
88 Commits 1 Branch 0 Tags
c0efc6343452503b34babc27374d89ebc744fe18
Commit Graph
64 Commits
Author SHA1 Message Date
thzxx c0efc63434 review: 移除未使用导入(useEffect/StorageBackendType) 2026-09-13 08:07:27 +08:00
thzxx 5030eb04d2 0.1.38 存档根治·石碑重刻：OPFS降级+错误上浮+回读校验+持久化请求+诊断面板+driver.open锁死修复+exportSave补open 2026-09-13 08:02:04 +08:00
thzxx 8f1f8d48ce chore: 版本号升级到 0.1.37（package.json/AGENTS.md/MOD_GUIDE.md/ApiFacade/storeHelper/SettingsPanel/slots/测试断言） 2026-09-10 23:46:51 +08:00
thzxx 87cd71ad21 0.1.37 天人感应·因果织锦：功德系统+飞升试炼+世界奇观+MOD扩展口 2026-09-10 23:37:57 +08:00
thzxx 41cffdfdb6 v0.1.36b: 真根因修复——CSP unsafe-eval 拦截 Function() 字符串求值（推进崩溃+定制白屏同根） 
【根因】Electron 打包 renderer CSP 禁 unsafe-eval;buildings.bonusOf / exprToTable / modManager.booleanExprTable
三处用 Function()+正则白名单字符串求值——任何调用点抛 EvalError:
·推进崩溃=每月月率 bonusOf('juling','expBonus') 等(MarketPanel craft 表头同源)
·定制白屏=craft 页渲染行内 bonusOf('danfang','craftChance') → React 崩 → 只剩背景
【修复】全新 arith.ts 纯解析器(令牌化+递归下降:数字/L/四则/括号/幂/负号——白名单天然,字母函数名一律 NaN),
三处替换零 Function/eval;非法输入 NaN 不抛(调用方 Number.isFinite 跳过)
【测试】arith 4 例(四则/幂右结合/负号/除零/非法输入防注入)+全量 7011 绿
【版本】0.1.36(同版本内提交——不另立迭代)
 2026-08-24 22:20:25 +08:00
thzxx 9571c58c07 version: 0.1.35→0.1.36——补齐版本流程(0.1.36a 修复已存在,版本未升是我的疏漏) 
package.json/ApiFacade/SettingsPanel/storeHelper/slots(GAME_VERSION)/facade-registry/gameengine 断言 6 处同步;
AGENTS 版本头同步(三问题处置状态诚实口径):弹框双排名已修,推进/白屏根因待真实环境错文;
build 绿 7007 测试绿
 2026-08-24 22:11:45 +08:00
thzxx f5e49ef9bd v0.1.36a: 三问题修复——成员弹框双排名/界面白屏防线/推进异常取证+出险保障 
【Bug2 双排名】MemberModal 顶部与 ModalShell 壳顶重复渲染 (title+category 各两排)
→ children 内嵌 title/cat 移除(壳已承载),改 mm-brief 一行(寿数/根骨)
【Bug3 定制白屏】App 无错误边界 → 全树崩溃只剩背景
→ AppErrorBoundary 一级防线(显示错误信息+重新加载按钮,不再白屏)
【Bug1 推进崩溃】advance 异常 toast 原文只写“已保存”——实为 Stash 静默吞错+双保险缺失
→ ①toast 显示根错前 120 字(玩家可见——此前只有 console) ②出险保存双保险:
Stash 失败时 localStorage 应急副本+明示“存储也失败”提示手动存档 ③speed timer 内 advance().catch 隔离
【验证】tsc 0 错/build 绿/7000 测试绿
 2026-08-24 21:53:04 +08:00
thzxx 088fda2df0 docs: MOD_GUIDE 依 0.1.35 真实代码重写（362 行）+ bug 修复 
【bug 修复】官方示例包 zhanbei-xv 的灵纹刃产出物缺 ITEMS 定义（0.1.33 幽灵物品纪律违反——装包即产出不可见武器）→ 补 weapon-lingwoon 定义(图标/价 700/战力 0.35);删 wordgen 死占位字段
【MOD_GUIDE 重写】与真实 modSchema/插件/内置包逐口对齐:
§2 补 patch/kind/四效果键;§9.5 功法补四流派效果(含平衡提醒/validate 校验区间);
新增 §9.6 patch 层(0.5~2/mult add 二选一/卸载复原/缺键 warn);
§10 速查表全量更新:丹药 5(和灵/虚元)/兵器 6(玉澜刃/灵纹刃)/功法 23 本全列(含流派备注)/建筑 14(符箓坊消耗式)/秘境含 m-wonder-*;
§13 官方范例修正(真实字段——原谓词错配);FAQ 补 Q8 patch;尾注 0.1.33/34/35 三注;
【验证】builtin-mods/mod/economy 回归绿;tsc 0 错
 2026-08-23 22:41:44 +08:00
thzxx b963e954c7 v0.1.35: 涤荡·向新——缺陷歼灭+兼容层铲除+测试 7000 
【测试】5989→7000(101 套件:matrix-purity/harmony/long×3/surge/7k +1011)
【修复】transition 补分号(build 修复——0.1.35a 正则吞尾分号导致 CSS 解析错)
【版本】0.1.35(build 通过)
【文档】AGENTS(存档防线改写——迁移链铲除)/README(沿革+矩阵域)/MEMORY(8d 未发布不兼容铁律+时间线)/MOD_GUIDE(无迁移注)
 2026-08-23 22:38:05 +08:00
thzxx 9b0f36c70a v0.1.35b: 兼容层铲除——迁移链/版本戳/死表死代码/normalize 兼容批/死字段 
【A+I】migrate.ts 迁移链(CURRENT_SCHEMA/MIGRATIONS/migrateIfNeeded/MigrationError)整链铲除→validateLoadedState 结构校验(seed/family/members 断言);信封统一 payload 单格式(去双格式兜底);APP_ID 保留
【F】schemaVersion 字段全删(domain/creation/save 8 处);SaveMeta.version 记游戏版本字符串
【C】chronicle 死表+saveChronicle 死方法(首行 return+unreachable legacy 僵尸)全删
【D/E】GameEngine __state globalThis 泄漏口+seed 三元(恒不可达)删除;engineFromSnapshot/noAutoCreate 保留(测试便利——非兼容机器)
【B/H】normalizeGameState 兼容批删:老档字段补(28行)/worldGen 重放(18行)/P0-2 占位 def(9行)/worldSim 字段批删;保留 npcs 重注册/headId 修复/d distress 防护;initSim 补 0.1.34 四键(唯一初始源)
【G】domain 收紧 5 兼容 optional(techniqueRank/Progress/tribBoost/worldGen 必填)+pcgen 必写
【测试】删 9 个兼容验证体(audit 0.1.0-era/全残缺矩阵/空 worldSim 兜底);5989 全绿——金钟罩零漂(新档结构全字段,删除不涉世界数值)
 2026-08-23 22:35:17 +08:00
thzxx b420fa0c67 v0.1.35a: 缺陷歼灭——wonder 崩链/boss 卡队/patch 泄漏/拒单门/衰减/数值平衡 17 条 
【高】wonder 全链修复(sendMission/settle/missionById wonders 回退+ExpeditionPanel 合并列表);
boss 战败 releaseSquad(整队不再永困 expedition);patchUndo 按插件归属 Map+rollbackPatch(跨 MOD/跨世界不再泄漏)
【中】buyItem 拒单线>池底(0.35>0.25——断供真断供);warFatigue 年首×0.9 衰减(长局不永久冷降);
MOD 功法注入 trackedTech 卸载摘除;patch 缺失键 warn;guard>1 钳制 Math.max(0,1-guard);
transition 12 处逗号简写→每属性独立时长(0.1.33 动画实际恢复);t-shanling/t-zidian 越级下调;土系恒应(×1.02)
【低】断供计数封顶12/播报 month 修正/era 权重下界 0.05/新贵 id 碰撞 7 位/新字段 normalize 补/
go() 停时器/saveNow 并发锁
【金钟罩】0.1.35 基线重算(warFatigue衰减/池底分离/功法平衡受控变更) 61 例绿
 2026-08-23 22:30:02 +08:00
thzxx bb82947bb6 v0.1.34: 万象归元——功法流派/世界自演化/插件MOD 进化 + 测试 6000 
【版本】0.1.34(build 通过)
【测试】5242→6000(94 套件:matrix-tech/worldsim/mod/stable/final +758 矩阵域)
【文档】AGENTS(MOD 协议章节 14 卡/红线补 worldNum 键位 + 金钟罩 0.1.34 基线注释)/README(沿革+矩阵域)/MEMORY(8c2 世界状态红牌纪律 + B0 军规)/MOD_GUIDE(4 效果字段+patch 层注解)
 2026-08-23 22:12:07 +08:00
thzxx a7fe166e85 v0.1.34b: 插件新卡+MOD 功法效果口/patch 层/冲突日志 
【插件】SYSTEM_DEFS + worldview 观察卡/tech 功法卡(14);PluginContext + addTechniqueDef(全字段入 PACK 数组, grade≤3 自动池) + onWorldSimTick 观察回调(零 rng 零时序——proxy 追踪注销);
【MOD】ModPackData.techniques 补 4 流派效果字段;新增 patch 层(target 数值 mult 0.5~2/add——install 应用 uninstall 复原,validate 规则进预检);同 id 功法冲突 warn 日志
【门面】Runtime 未动;卸载回滚栈 patchUndo
 2026-08-23 22:09:38 +08:00
thzxx 3fb64f6e78 v0.1.34a(修正): 新秘境改种子派生伪随机——零 rng 消耗(修复跨世界/跨跑分叉) 
B0 原用 World.rng.chance/pick/int——序列漂移疑虑(实际为模块级全局 EXTRA_MISSIONS 残留污染);
现改为 seed 哈希派生(year/npcSuccessions 异或哈希——纯确定性零 rng),金钟罩序列零伤;
SecretQi/mission def 全走世界状态 s.wonders(每档独立),确定性复跑矩阵恢复绿;
金钟罩 0.1.34 基线固化(功法流派/时节共鸣/warFatigue/换代/断供受控变更——值变序列受控重算 62 例绿)
 2026-08-23 22:05:53 +08:00
thzxx a491b9c54a v0.1.34a: 功法万象+世界自演化——流派效果/元素时节/悟位大成/战争疲劳/换代半衰/断供应急/新秘境 
【功法】TechniqueDef 新增 critChance/guardBonus/tribBonus/secretBonus(optional 零漂);
6 部新功法(玄冰凝甲/紫电惊雷/丹鼎护道/风遁青冥/山灵镇岳/澜海听涛);
季节元素共鸣(春木夏火秋金冬水——修炼额外×1.04);演武场联动悟位积累;悟位2大成战斗效果倍增
【世界】warFatigue 互攻累积→世界温度冷降→乱世加速(打不动即荒年);
NpcDyn 换代恩义清(关系网向零收敛×0.5);断供应急(连续3月池深<70%→广播+价×1.5);
新秘境灵机(年首几率·乱世×2·模板化生成 addMission 扩展口);addMission 公共口(secrets.ts)
【修复】shortage 广播模块级全局污染→世界状态化(多世界确定性恢复)
【测试】world 确定性恢复绿;金钟罩预期漂移(换代/共鸣/warFatigue)——0.1.34 基线待重算
 2026-08-23 22:00:55 +08:00
thzxx 7839c7b55a v0.1.33: 闭环·流光——物品生态闭环+引擎止血+UI动效打磨+测试 5230 
【版本】0.1.33（build 通过）
【测试】5009→5230（+200 matrix-close-loop 闭环四验宏量）
【文档】AGENTS/README/MOD_GUIDE/MEMORY 四份同步 0.1.33（闭环注/四同步纪律/测试数）
 2026-08-23 21:39:23 +08:00
thzxx 2369f342dd v0.1.33c: UI/动效打磨——过渡动画/停帧节能/季节对齐/反馈闭环 
【动效】Modal 淡入+升起缓动(modalFadeIn/modalRise);LogFeed 入场动画(feedIn);
fx std 档放行刀光(战场核心反馈);任务凯旋补 spark/战殁补 ripple
【节能】DriftLayer 2.6s 转 onAnimationEnd 删除节点(消除空转 setInterval×slice 定期 setState);
fx-canvas 粒子空态停帧(空 rAF 取消+spawnBurst 唤醒)——低端机待机零开销
【季节】fx-canvas 季节色改读 data-season(游戏月驱动,不再用系统月——夏季粒子不再飘冬季色)
【性能】transition all 12 处→具体属性(background-color/color/transform/opacity);
backdrop-filter 保留(视觉主)
【UI 修复】MemberModal 装备栏空守卫(未知名器)+职事按钮 disabled={maxed} 统一;
议和按钮灵石不足 disabled+title(不再静默);事件弹窗 RES_NAME 补新材料/增筑显示中文名;
回卷按钮无存点 disabled+title;速度按钮 sel/gel 类名统一;MarketPanel 删死变量 stock;
debug 后门 __SMOKE__/DEV 门控(生产干净,冒烟仍可用——main 注入 __SMOKE__)
【测试】fx-timesense std 刀光断言更新 5030 全绿
 2026-08-23 21:38:02 +08:00
thzxx 3e4ed4d882 v0.1.33b: 引擎止血——白屏/经济/治理 15 项 
【白屏】equip() 校验物品存在；MemberModal 空守卫（B1 属 UI 同阶段）
【经济】tribBoost 渡劫成/败/陨落三分支尾部清零(+12% 破境丹不再永久白送);
assistAlly 先校验 NPC 再扣款;giftNpc/makePeace 加 npc 守卫
【治理】about 版本透传(删硬编码 0.1.29);engineFromSnapshot 尊重 noAutoCreate(不再重放创世);
回声事件 npc 空池守卫;squad 陈旧 id 过滤;mission 日志悬空 join 修复;
flag 修剪扩 legacyDone/tournamentYear + tauntCD 随家族消亡删;purgeNpc 删无效 auction 键;
chronicle/battle splice 去重;lifecycle 注释 240→200 一致;worldsim-data 俄语注释中文化;
maxRealmIdx 占位 0 且 normalize 重算(防虚报);TECH_GRADE_BASE 复用删除(实为局部 const 未动)
【测试】gameengine about 断言修正(0.1.32 透传) 5030 全绿
 2026-08-23 21:34:29 +08:00
thzxx bce50b6e2b v0.1.33a: 物品闭环——符箓生效/幽灵物归位/灾年接入 
【符箓闭环】talismanWarPrep 返回类型,开战消耗 1 张;风符全队×1.12/山符×1.15+受创减半(零 rng)
【符箓坊】建筑耗符纸×2+灵木×2/级,月造风符1枚;坊3级另出山符(消耗式零 rng)
【幽灵物品归位】and灵丹/虚元丹/玉澜刃补 ITEMS 定义(含 icon/价格/战力)+craftPill/forgeArtifact union 扩键+ARTIFACT_POWER 补玉澜刃 0.4
【灾年生效】farmFactor/mineFactor 从算而未用→真正乘入灵田/药园/矿场/灵果/木坊产量(旱灾×0.7等)
【金钟罩】0.1.33 基线重算(符箓/灾年/新丹受控变更),RAW+RES 共 18 值
【测试】+3(economy-loop-0.1.33 闭环矩阵) 全绿
 2026-08-23 21:31:19 +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 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 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 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 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 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 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 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 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