Skip to content

2.1.6 — 断掉药水事件的旧文件回落 stat(P0-A + P0-B)

Choose a tag to compare

@ykcgly ykcgly released this 10 Nov 15:29
· 4 commits to main since this release

背景:实服 spark 报告里「被低估」的一条链

对 v2.1.5 实际服务器报告(h8WoC9Nxr4.sparkprofile,Leaf 1.21.11、2 人在线、61 分钟有效窗口)的复核显示:BY PLUGIN 里 TangranTech 自身 Java 帧仅 0.05%,watchdogTick 已完全从调用树消失(前两轮优化确认生效);但 HOT CALL PATHS 榜首的 WinNTFileSystem.getBooleanAttributes0(Windows 文件 stat,被归入 <jvm-internal>,不记在插件账上)有一条完整调用链来自糖然:

Player.turtleHelmetTick > LivingEntity.addEffect
 > CraftEventFactory.callEntityPotionEffectChangeEvent
 > YanhuoListener.onPotionEffect > selectedYanhuo
 > AddonPaths.readJson > readJsonFile > File.exists
 > WinNTFileSystem.getBooleanAttributes0

海龟头盔、潮涌核心、信标以及无限时长药水(水火异火被动自己就会挂)每刻都会刷新药水效果;Store.DOC_CACHE 挡住了 SQLite,却挡不住「库里没档 → 无条件回落查旧文件」的那次 stat,形成自激。当前没有卡顿,但这条链随在线人数 / 药水频率线性放大。

修复

P0-A · 药水事件先过滤、再读档(YanhuoSelectionScript.onPotionEffect)

把 getNewEffect() 与 INSTANT_HEALTH 判断提到 selectedYanhuo() 之前,不匹配直接 return。该监听器只对瞬间治疗有副作用,顺序前移行为等价;99.9% 的高频药水刷新不再触发读档。

P0-B · 旧 JSON 回落探测负缓存(AddonPaths.readJson,玩家数据唯一路由点)

新增 LEGACY_FILE_ABSENT:记住「库里没有、且磁盘上也没有同名旧 JSON」的 (ns, key),命中即跳过 readJsonFile → File.exists()。异火、储物空间、丹方权限、境界、任务等全部事件 / 周期路径一并受益,不必逐个模块改。

正确性约束(这次改动最容易踩坏的地方)

  • 只在 SQLite 可用时启用:库不可用时整体降级为文件后端,一次 exists() 都不能省,否则刚写下的文件会被「无文件」结论挡住。
  • 30s TTL + 4096 容量上限:管理员手动补放旧档、外部工具写入后自动生效;过期条目不会随玩家上下线长期堆积。用 System.nanoTime() 差值比较,溢出安全。
  • 4 处显式失效:writeJson(写库失败要落真实文件,不失效会导致「写后立即读 30 秒读不到」)、deleteDoc、/tr import 前后(异步导入期间可能又产生新结论)、Store.shutdown(关库后降级文件后端)。
  • 缓存键用 docParts 产出的 (ns, key),不用绝对路径:无路径形状歧义、零路径规范化开销;addons/** 资源文件保持原路径不受影响。
  • Store.importLegacy 走自己的文件读取,首次启动自动导入与单条惰性迁移语义完全未变。

自查过 6 条路径:库可用+磁盘有旧档(照常迁移入库)/库可用+磁盘无档(首次 stat 后缓存 30s)/库不可用(原行为)/save 失败落文件(撤缓存后立即可读)/删档/导入,均无回归。Store.available() 仅两个字段读,新增调用零成本。

验证方法

替换 jar 后完整重启,挂 30 分钟 /spark:

  1. getBooleanAttributes0 的糖然链应消失,YanhuoListener.onPotionEffect 从调用树掉落;
  2. 反向验证:给一个没选异火的新号手动放一份旧 JSON 到玩家数据目录,30 秒内应被读到并入库(确认 TTL 与惰性迁移没被负缓存堵死);
  3. /tr import --apply 后游戏内立即可见导入数据;
  4. 厚土异火免疫瞬间治疗仍生效(P0-A 等价性)。

升级说明

  • 无配置、无存档格式变更,plugins/TangranTech/data/tangran.db 结构不变;直接替换 jar 并完整重启即可。
  • 本版不含 P1(异火事件统一走 watchdog 缓存、初章祭坛右键的 BlockStorage 扫描优化),按实测结果再定。
  • 前提仍是本插件独占 tangran.db;若用外部工具直接改库,改动需重启后可见。