fxdyz

CHANGELOG.md

@@ -1,5 +1,27 @@
 ## 更新记录
 
+### version: 3.4.6（2026-09-06）：
+
+本地避雷记录新增按 AstrBot 会话隔离的数据范围。新增、查看、查询、修改和删除均使用当前消息的 `unified_msg_origin`，修改与删除同时校验会话 ID 和记录 ID，其他会话即使知道记录 ID 也无法访问或操作。
+
+插件升级时会自动迁移旧版 `bilei` 表，原有记录完整保留在不可由普通会话访问的“历史公共数据”区；新安装直接创建包含会话 ID 的表结构，并为会话内查询建立联合索引。
+
+插件 WebUI 新增“避雷迁移”页签，集中展示历史公共数据区中的旧记录。管理员可为每条记录选择已有会话或直接输入目标会话 ID；迁移采用带历史区条件的原子更新，完成后记录立即离开待迁移列表并仅归属于目标会话。
+
+功能帮助图片将“插件与推送”调整为第一个功能分区，其余分区序号依次后移，避雷功能仍保留在最后。
+
+功能帮助底部的会话区服说明移动到顶部，并补充方括号参数可省略且使用默认值的规则；所有“服务器”和“区服”参数统一移除方括号，其他可选参数标记保持不变。
+
+优化烟花、跨服名剑和武林争霸的可选参数：烟花条数为非正整数或无法解析时自动回退 50；跨服名剑改用 `22`、`33`、`55` 并映射接口值 `0`、`1`、`2`；武林争霸改用 `浩气盟`、`恶人谷` 并映射接口值 `1`、`2`。三项无效输入均使用默认值，不再返回参数范围错误。
+
+调整指令前缀容错：开启前缀检查但前缀内容为空或只有空格时，自动按未开启前缀处理并记录警告，普通指令仍可直接触发；仅在前缀内容非空时强制匹配。
+
+新增查询双层缓存：JX3API 原始 JSON 采用内存与 SQLite 两级缓存，缓存键排除 Token、Ticket 等敏感值并使用凭据摘要隔离；同参数并发请求会合并为一次上游调用，请求失败时可使用七天内的过期数据兜底。HTML 渲染图片保存到插件数据目录；普通图片指令会先按指令、完整参数、选择项、会话数据范围、资源和渲染配置查询最终图片，命中后直接发送，不再请求上游接口或重复渲染。图文结果会连同正文一起缓存，同键并发执行也只会产生一次请求和渲染。
+
+插件 WebUI 新增“缓存管理”页签，可分别设置接口数据和各图片指令的默认缓存秒数，也可逐项覆盖、恢复默认或单独清除；设置为 `0` 即关闭对应缓存。单独清除接口时会同步删除该路径的内存与 SQLite 缓存，单独清除图片时会删除该指令生成的缓存文件，均不改变已配置的缓存时间。页面同时展示缓存条数、占用空间，并支持分别清空全部接口和图片缓存。接口内存缓存条数与图片缓存总容量均可在页面调整，默认分别为 256 条和 512 MB，保存后立即按最少使用优先策略清理超额缓存；随机内容接口以及会话避雷图片采用 0 秒安全默认值，仍可显式覆盖。
+
+所有 HTML 渲染图片统一在页面底部显示“数据时间”。JX3API 数据优先显示接口缓存最初写入时间，非接口页面显示本次数据生成时间；命中最终图片缓存时保留原图片时间，便于直接判断当前图片所展示数据的新鲜程度。旧版最终图片缓存键同步升级，避免继续复用不含时间栏的历史图片。
+
 ### version: 3.4.5（2026-09-05）：
 
 新增 `跨服名剑 服务器 [模式]` 指令，接入 JX3API 跨服名剑榜；竞技模式支持 `0=2v2`、`1=3v3`、`2=5v5`，默认为 `1`。榜单按接口数组顺序生成排名，使用统一数据表格模板展示队伍名称、积分、胜场、败场和总场数，并同步更新功能帮助与 README。