MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
41 Commits 1 Branch 0 Tags
ec25bf92fcc899e60a78ec10a778bbc596763247
Commit Graph
14 Commits
Author SHA1 Message Date
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 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 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