MetonaTeam/ChronicleOfTheImmortalClan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
73 Commits 1 Branch 0 Tags
9b0f36c70ada819f24991be48dbe70782fd5a1a7
Commit Graph
73 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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
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 106db18017 v0.1.5: 人物志（志向/渡劫/列传/契合/回声） 
- 志向系统：七向（求道/镇族/承宗/商略/兵略/耕读/云游）成年礼自动定志，
  量化加成入修炼/战力/坊市/灵田/添丁/声望，云游减修但际遇更频
- 大境界渡劫：炼气→筑基起，晋升改走劫难事件三选——硬渡/请护法(100灵石)/
  压制来年；护法失败或受牵连；渡劫成败与心性、气血挂勾，高阶有小陨落率
- 灵根本命契合：功法元素×主灵根，契合者修炼+6%/战力+4%，详情页「本命」徽章
- 人物列传：自动列传生成器（生平/修行脉络/历险/姻缘/子嗣/大比/墓志铭），
  成员详情小传分页 + 春秋原列传长卷
- 四邻回声：每两年一桩——友好赠礼/敌视暗桩/中立传闻三态动态事件
- 修复：回声事件 npcId 解析错误、事件优先级（惯例>传闻）
- 测试 176→197（志向加成/契合/渡劫三轨/压制通道/列传结构/回声三态）
 2026-08-23 09:08:16 +08:00
thzxx 98b60076f0 v0.1.4: 百年定局（终局/大比/寄读/春秋原） 
- 望气定鼎：stats 追踪四维（人兴/道兴/威名/香火）+ 十二称号分档 + 铭文诗
  春秋原页预演称号，落印定局（青册留档，不阻继续游历）
- 太虚大比：每五年征召，点将三关（初试/拔擢/问鼎）复用战斗结算，
  名次四档红利（声望/灵石/全场好感），史书战报自动落笔
- 宗门寄读：随机宗门收徒（适龄少年），寄读 2-4 年期间每季寄资源，
  期满三选：归来精进（可触发突破+随机机运）或续读深造；低概率择师不回
- 求经台：藏书阁≥3 解锁，两年一访得稀有功法
- 春秋原复盘页：气数四维图/岁末族簿汇编/生卒与突破年表/大比年表
- 修复：大比征召曾因月份条件错过整年；抢在百年庆典前的优先级倒置
- 测试 161→176（评分边界/称号分档/大比三轨/寄读全链/求经冷却）
 2026-08-23 09:00:17 +08:00
thzxx 09cbad6449 test: 测试矩阵扩至 161 项（深度审计 + 5 处缺陷修复） 
新增测试矩阵（12 文件 / 161 cases）：
- rng 12 / data 18 / pcgen+cultivation 20 / economy 12 / combat+missions 24
- marriage+diplomacy 13 / events 12 / world+lifecycle 8（含镜像一致）/ save 4+5 / audit 8

审计带出并修复的真实缺陷：
1. Rng.pick 空数组未报错（防空白数组进而崩溃难查）
2. combatPowerOf 未应用功法悟道品阶战力加成（0.1.2 设计缺口）
3. 重伤者即使不代表伤状态仍按满速修炼（health 进修炼公式）
4. 寡妇/鳏夫无法再婚：候选列表放着人执行层却拒婚（spouseId 死旧契约）
5. isWidowed 参数契约陷阱：传 id 静默 false（升级接受 Character|Id 双签名）
 2026-08-23 08:47:21 +08:00
thzxx f38669fa4a v0.1.3: 深度审计修复（兼容/血缘/联姻/远征/数值） 
- 旧档兼容：<0.1.1 存档缺 finance/yearStats/yearlyReports 字段加载归一化（防运行期崩溃）
- 血缘防护：同母异父兄妹也禁止婚配（指婚/媒人/联姻三路齐封）
- 联姻修正：一家一姻亲（allied 锁），再娶再嫁不再无限刷；男儿娶亲也子孙来归
- 和约语义：议和强推关系至 +30（真停战），不再打完一场还是仇雠
- 远征收队：任务完成/召回自动释放队员闲居；重伤者当月离队疗伤、不足定员提前撤队（修复人员永久困远征/卡状态）
- 数值：婴儿夭折率 2%→0.8%；劫掠队强度 0.9→0.78；事件负资源钳制不为负灵石
- UI：丹药按钮显示持有并禁点；点将模式支持取消重选；设置页移除摆设项
- 新增 audit 套件：8 项（含 600 月长跑耐力）总测试 38→46 全绿
 2026-08-23 08:34:13 +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
thzxx adb22f0558 v0.1.0: 仙途家族志 · Chronicle of the Immortal Clan 
家族模拟器首版：修仙/经营/战斗/外交/叙事全套系统
- Electron + React + TS + MetonaSqlark(aria+OPFS)
- 水墨中国风 UI
- 引擎种子随机、确定性可回放
- 19 项单元测试、端到端冒烟验证
 2026-08-23 00:04:16 +08:00