MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
46 Commits 1 Branch 0 Tags
40c4da34a0a523866ed363b520f488fdfb52dcf0
Commit Graph
17 Commits
Author SHA1 Message Date
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 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 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 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 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 a7ee125866 v0.1.6: 时轮与造化（GameClock/RngHub/时节/年轴/保护） 
- 统一时轮 GameClock：七 phase 注册制（production/aging/cultivation/missions/
  events/diplomacy/epilogue） + 年首三钩子（婚配→岁贡→族簿）；advanceMonth 化作薄壳；
  新增系统只注册不改本体；alive 守卫、随机序、族簿时序均与重构前逐一等价
- 金钟罩：3 枚 seed × 560 月指纹常驻（重构前后已验证同哈希；时节属有意变更后重固化）
- 统一随机 RngHub：开局播种（crypto UV）、音效白噪独立流、引擎 rng 带 nextCount 审计；
  全工程拔除逻辑侧 Math.random
- 时节系统：春夏秋冬乘子（春田+10%/夏修+5%/秋市+5%/冬闭+8%）入生产与修炼
- 崩溃保护：advance 异常自动存『出险前』档 + 停速提示回档
- 性能预算：dev-only 单 tick>60ms 报最慢 phase
- 横轴年表：十年一格大事/生殇聚合 + 春秋原年轴视图
- 测试 197→225（时钟/收集器/四季/年轴/效果全矩阵/死局链/残留防御）
 2026-08-23 09:20:52 +08:00
thzxx fefbe1f1d7 v0.1.2: 宗族气韵（职事/悟道/谱系/碑录/庆典/飞升/音效） 
- 职事任命：长老(+修炼)/供奉(+战力)/执事(+坊市)/掌教(+闭关) 每人加成叠加，上限管理
- 功法悟道：修习积悟性点，小成/大成逐级+战力，大境界突破传道于直系晚辈
- 宗族谱系页：世代分带 + 夫妻同卷 + 子孙连枝，点节点开详情，先人簿可查
- 功德碑：宗主辞世即勒石，宗祠页碑录永存
- 百年庆典 + 飞升之路事件链（留世坐镇/仙风入体 或 云游飞升/宗族蒙荫）
- 合成音效（WebAudio）：鼓点/钟鸣/纸韵/磬响，设置页开关
- 单测 29→38；typecheck/build 通过；GUI 冒烟受限于 WSLg 掉线（SMOKE-TIMEOUT 优雅退出）
 2026-08-23 08:28:49 +08:00
thzxx 6b15a97d0c v0.1.1: 养成闭环 + 管理自主 + 存档安全 
- 指婚/续弦：成员详情可主动找人结亲（血亲自动排除、鳏寡可再醮）
- 装备 UI：法宝从府库装备/替换，战力实时反馈
- 御敌点将：劫掠事件可自选迎战阵容（默认 Top4 可改）
- 宗祠祭祖：每两年一次，灵石150 → 声望+6/全族修为小升
- 回档时间轴：每季快照列表，一键回卷（回卷前自动保当前档）
- 战报匣子：史书页全文战报留存可翻阅
- 年度族簿纸笺：每年初弹收支/人丁/战力简报
- 媒人提示条 + 寻衅一年冷却 + 出生率与劫掠频率微调
- 单测 19→29（storage mock roundtrip/回档/指婚血亲/祭祖/寻衅/装备/账本）
 2026-08-23 08:16:40 +08:00
thzxx 4bacbd432e docs: 仓库级 AGENTS.md（命令/环境坑/架构/方言陷阱） 2026-08-23 00:05:42 +08:00