MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
87 Commits 1 Branch 0 Tags
5030eb04d2f416b92cfb8c42918f6e0a8da67440
Commit Graph
87 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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 2984d05647 docs: 四文档同步 0.1.36——CSP 红线纪律 
AGENTS:版本头 0.1.36(三问题处置/arith 根因)/测试 7011/新增 CSP 红线(严禁 Function()/eval——一律 arith)/
打包版≠开发版(CSP 分野)环境坑 + dev:web 浏览器通道说明(Tabbit 劫持端口用 WSL IP 绕过)
README:测试数 102/7011 + 版本沿革 0.1.36 行
MOD_GUIDE:版本头/尾注 0.1.36 + produceExpr 改用 arith 求值说明(表达式无脚本化能力)
MEMORY:时间线 0.1.36 + 测试数 + 新增 8e 决策(CSP 血案全纪录/军规/真实错误文字教训)
 2026-08-24 22:38:37 +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 9323963dd4 feat: dev:web 纯浏览器开发通道(绕开 Electron 窗口/Tabbit localhost 劫持) 
【背景】npm run dev 构建链全绿正常;但用户环境 Tabbit 浏览器后台 node 劫持 localhost 端口段
(5173/5179 全 502)——非我们 dev 故障
【方案】vite.web.config.ts:root=src/renderer+react 插件+port 5179+host 0.0.0.0;
package.json scripts.dev:web=vite --config vite.web.config.ts
【用法】WSL:npm run dev:web → Windows 浏览器:http://<WSL_IP>:5179(设备 localhost 不可用场景)
window.api(导出/导入/MOD 扫描)不存在时自动跳过——其余全功能等价(存档走浏览器 OPFS)
【验证】Windows 侧 curl http://192.168.1.225:5179/ = 200
 2026-08-24 22:07:48 +08:00
thzxx e36937ade2 test: 删除无效 ui-render 测试(node 环境 zustand 订阅不触发——非真实崩溃信号,避免误报) 2026-08-24 21:59:31 +08:00
thzxx 73fa9eb7f2 test: 存储真链集成测试(MetonaSqlark memory 方言——非 mock)——save/load/export/slot 管理 6 种子全链 
此前所有存量测试用 SaveDbDriver mock——真实 SQL 方言链从未被 vitest 覆盖(唯一 GUI 冒烟因环境不可用);
本测试直接注入 MeSqlark memory 后端:saveState→list→loadState→resume advance→exportAll→slot 管理面/remove;
为 0.1.36 三问题(推进崩溃/存档丢失)提供真实存储链防线;+1 套件
 2026-08-24 21:59:00 +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 293d04fc20 docs: MOD_GUIDE 全新重写(953 行)——从零完整教程,所有字段取自真实接口 
【结构】目录+零 B 君校验表+五分钟上手(含路径/文件名/最小包)+十五口全景表(卸载行为)+十五口示意壳
【字段全以真实 TS 接口为据】EventDef/Cond 18 键/EffectDef 17 键/MemberEffect 10by×8target 两表;
NpcFamilyDef 全字段+境界-寿元表;worldgen 四池;灾因 family/effect 双通道;丹方/铸器含红牌+内置量级参照;
worldNum 四组全键表(0.1.34 warFatigue/断供/新秘境全套);内容面七口(六类生态+四流派效果+建筑 DSL 五键+
职事 5 效果/志向 6 效果——修正旧文 combat/stamina 错值+性格 danger 映射);patch 层 5 条规则;
§10 速查表 9 组全 id(丹药 5/兵器 6/功法 23/建筑 14/天下家/秘境含 wonder);FAQ 9 问;官方范例实样 JSON
【新章节】零 B 君(安装即校验安全区间表)+2.1/2.2/2.3(顶层字段表/十五口全景/示意壳)+9.5.x 小节编码
 2026-08-23 22:57:49 +08:00
thzxx c9fca1b0b1 docs: MOD_GUIDE 全面重排——完整示例+排版表格化+0.1.31-0.1.35 增量缝合 
重构自 0.1.32 全量底稿(551 行完整示例/字段表/排版保留),精确打补丁:
§0 红线 5 口→15 口全图;§2 新增 2.1 data 全景表(世界侧/内容面/配方/patch 四组);
§7/§8 红牌(产出必先立名——含内置丹方参照);§9 worldNum 补 warFatigue/断供四键+池底-拒单分离说明;
§9.5 功法重排(四流派效果表+量级参照+元素时节共鸣+平衡提醒);
新增 §9.6 patch 层(规则/mult-add/日志/卸载复原/worldNum 区别);
§10 速查表全表格化:丹药 5/兵器 6(战力列)/功法 23 全列(流派效果)/建筑 14(产物列)/秘境含 m-wonder 注;
§13 官方示例实样 JSON(风物集/战备解军)+灵纹刃立名修正注;FAQ 补 Q8/Q9;尾注四版;更新戳 0.1.35
 2026-08-23 22:51:17 +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 1b1dfe8ac8 test: matrix-tech 断言随 0.1.35 平衡修正（t-zidian 0.1/t-shiling 新员） 2026-08-23 22:31:13 +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 ae3fcabc20 docs: MEMORY 补 0.1.34——8c2 世界生成红牌军规(B0 教训)+时间线 0.1.34+测试数 6000 2026-08-23 22:12:18 +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 b7c5f1eca0 docs: 四文档同步 0.1.33 补全——金钟罩基线注释/生态闭环纪律/符箓坊建筑/动效纪律 
AGENTS：金钟罩 0.1.32→0.1.33 基线注释（符箓战力/灾年入产/tribBoost 清零时序内变更）+ 新增生态闭环纪律段
MOD_GUIDE：建筑 id 表补 fuzhifang（消耗式产符）
MEMORY：新增 8c 决策（闭环三问/动效空态纪律/测试编写教训）
README：确认 0.1.33 沿革已在
 2026-08-23 21:47:38 +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 fa477fb3ef docs: AGENTS 同步 0.1.32（金钟罩注释修正 + p 文件教训入修改纪律 + 物品六类生态纪律） 2026-08-23 21:10:04 +08:00
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