## 更新记录

### version: 3.4.3（2026-09-05）：

重构功能帮助图片：由不规则卡片区块改为统一的“功能分区 + 指令列表 + 说明”三列结构，每条指令行预留默认空白的说明区域，并整体放大分区、功能名、指令及辅助文字；按照当前 `command_map` 校正 18 个分区和 92 个真实触发词，角色记录指令由“聊天”更新为“发言”，同时补入“小药”“骗子”并移除未注册的“副本”指令。

新增基于 WebUI 与 SQLite 的“会话控制”：默认使用“全部会话”模式，也可切换为白名单或黑名单，并维护任意 AstrBot 会话 ID 及备注。访问策略同时作用于插件指令与实时事件推送；空白名单不放行任何会话，空黑名单放行全部会话。

整理 WebUI 后端结构：新增独立的 `core/webui.py` 服务，统一负责管理页路由注册、Dashboard 数据聚合、请求校验和保存、删除、恢复接口；`main.py` 仅保留服务构造与注册调用，现有 Web API 路径和前端调用协议不变。

插件 WebUI 的区服别名和心法别名页新增“恢复默认”操作；采用页面内可见的二次点击确认，不依赖嵌入页面可能无法显示的浏览器原生确认框。确认后分别读取随插件分发的 `data/server_aliases.json` 和 `data/kungfu.json`，在事务中完整重写对应数据库表并刷新页面数据。

移除 WebUI 顶部统计区域；“会话控制”移动为第一个默认页签，并新增醒目的当前生效模式状态。模式卡片明确区分当前模式与尚未保存的选择，切换按钮同步显示目标模式。“会话绑定”更名为“区服绑定”并保留在“事件推送”之后。

重构 WebUI 区服绑定交互：顶部入口改为“添加绑定”，会话 ID 可自定义但绑定区服只能从标准区服下拉框选择；列表编辑时会话 ID 保持只读，仅在对应绑定区服列内切换下拉框进行保存，解除绑定改为点击后直接删除对应记录。Web API 同步拒绝别名及任意文本作为绑定区服。

### version: 3.4.2（2026-09-04）：

图片模板整体调整为浅色背景、深色高对比文本和更大的字号，缩小内容与金色边框之间的留白并扩大主体区域；同步检查并调整多个独立页面的字号、间距及表格布局，提高长图阅读体验。

插件配置页新增“图片渲染质量”分组，可选择 `1.0`、`1.3`、`1.8` 三档渲染清晰度以及 JPEG/PNG 输出格式，并可设置 JPEG 质量；默认使用 `1.3` 倍设备像素比和 JPEG 质量 `100`。

将 17 个独立排行榜指令合并为 `帮会排行`、`阵营排行`、`其他排行` 三个两轮会话入口；首轮按分类展示固定序号菜单，第二轮复用排行榜图片流程输出所选榜单，并统一只保留接口数据的前 50 条。

修复两轮会话已经取得有效选择后等待计时器仍继续运行，导致耗时查询或图片渲染期间触发超时分支并重复输出第二张图片的问题。

修复 aiocqhttp 已成功发送图片但返回 `retcode=1200` 超时回执时，插件继续补发“猪脑过载”错误提示的问题；该回执现在只记录警告。

优化插件 WebUI 的别名管理：区服页展示全部标准区服并移除删除操作，心法页隐藏不可修改的配装 ID；标准区服名和标准心法名均保持只读，点击“编辑”后直接在对应别名单元格内修改并保存。

### version: 3.4.1（2026-09-04）：

带区服参数的查询新增 `全区` 保留值；即使当前会话已绑定区服，也会向接口传入空区服以查询全区数据。

资历分布由 JX3BOX 重构为 JX3API `/tuilan/achievement` 实时查询，使用固定的总览及 18 个大类菜单；模板直接读取角色信息、`data.total`、`pieces`、`seniority` 与 `score/totalScore`，并分别兼容总览的“大类 → 小类 → 统计”和指定分类的“小类 → 统计”返回结构。

重构通用两轮会话处理器：首轮函数直接返回 `{"1": "总览", "2": "杂闻"}` 形式的裸键值对，由处理器生成序号文本；用户选择或 10 秒超时后，将所选项裁剪成单项字典交给次轮函数。资历和宏查询均已接入，宏结果统一复用富媒体消息链发送文本及 HTML 渲染附图。

移除 JX3BOX 资历菜单、点数和角色成就拼装逻辑及其本地缓存；旧 `achievement_cache` 仅迁移交易行物品分组后删除，交易行缓存独立保存到 `trade_item_cache`。

提高插件指令监听优先级；确认消息属于本插件指令后立即停止后续事件传播，避免重复触发其他插件或默认 LLM 回复。

补齐 JX3API 当前 39 种 WebSocket 事件处理，付费事件不再回退输出原始 JSON；新增缺失的扶摇预告、烟花报时、阵营祭天预告及帮会野外宣战事件，并按官方字段生成可读中文消息。

统一查询图片和插件 WebUI 的表格样式：表头、内容及图标文字组合水平和垂直居中，移除固定列宽并按内容自动分配；合并跨页面可复用的表格、卡片、状态和布局规则，清理重复或失效的页面 CSS。

### version: 3.4.0：

移除插件级默认区服，新增按 AstrBot 会话保存的区服绑定。已绑定会话可省略查询指令中的区服参数，完整填写区服时仍优先查询指定区服。

新增区服别名配置，一个标准区服可以对应多个别名；别名可用于会话绑定和查询指令。

新增 `data/server_aliases.json` 区服别名种子，插件启动时幂等写入本地数据库，已有区服别名配置不会被覆盖。

事件正文含服务器时按每个目标会话的绑定区服分别过滤；未绑定会话继续接收全部服务器的已订阅事件。

新增 AstrBot 插件 WebUI 管理页，可管理会话区服绑定和区服别名，并查看所有会话的事件总开关及订阅事件。

新增心法别名 WebUI，可维护 JX3BOX 配装 ID、标准心法名及最多 5 个别名。

移除随包 SQLite `data/plugin_data.db`，原有 32 条心法数据改为 JSON 种子并在启动时幂等写入本地 `local_data.db`，心法查询和配置统一使用本地数据库。

### version: 3.3.1：

沙盘功能改用 JX3API `/sand/records` 据点数据接口，并使用随插件分发的沙盘底图、阵营领地图层和据点图标在本地渲染完整图片。

移除仅用于旧剑侠茶馆沙盘图片接口的 `AIJX3Service`，沙盘命令现在支持缺省使用插件配置的默认服务器。

### version: 3.3.0：

移除开服、新闻、刷马、赤兔四类定时轮询推送及 APScheduler 依赖。

新增 JX3API WebSocket 实时事件通道，支持心跳保活、断线重连和按事件编号分发。

新增按 AstrBot 会话保存的事件订阅表，总开关与每个事件开关独立存储；免费事件 2001 至 2006 可直接订阅。

### version: 3.2.3：

API区服接口功能调整，做对应调整

### version: 3.2.2：

调整部分功能指令的描述

### version: 3.2.1：

统一封装 JX3BOX Node、Next2 和 CMS 三类接口请求，集中处理基础地址、GET/POST、请求参数、返回字段提取与异常日志。

修复资历菜单和点数缓存的刷新链路，缓存过期后分别请求 `/api/node/achievement/menus` 与 `/api/node/achievement/points`，上游失败时继续使用旧缓存。

刷马与赤兔后台推送改用 JX3BOX Next2 马场消息接口，并向后台任务管理器注入 `JX3BOXService`。

配装查询开始实际传递类型筛选参数。

新增项目级 `.gitignore`，忽略 Python 缓存、虚拟环境、日志、临时文件及整个 `tests/` 目录。

同步更新 README、插件注册信息和元数据版本号。

### version: 3.1：

增加副本记录查询功能。

重构 46 个 HTML 图片模板：公共文档骨架、设计变量、基础样式和组件样式统一维护，页面仅保留内容与独有布局；渲染前在本地组合为完整 HTML 字符串。

进一步组件化列表和卡片页面：表格、排行、技能/奇穴、奇遇网格、区服状态、器物详情等改为复用公共 CSS；页面专属 CSS 从 46 个减少至 13 个。模板通过元数据声明组件，加载器从单一组件样式表中选择性注入所需样式，并支持无同名 CSS 的标准页面及共享资源缓存。

重新整理功能帮助页，按 17 个分类展示 69 项功能和 105 条指令，并按固定图片画布优化三列排版。

### version: 3.0：

大部分功能重写，还有部分未写完。

### version: 2.7：

重构 **交易行 物品名称 [服务器]** 指令，改为免令牌图片查询。

新增 JX3BOX 交易行物品库缓存，用户输入物品名后先在本地模糊匹配物品 ID，再批量请求交易行价格接口。

交易行结果图改为列表展示，包含物品图标与名称、砖金银铜图标化价格、数量和数据时间。

价格接口未返回的物品不再展示，全部无价格数据时返回明确提示。

### version: 2.6：

新增 **资历 角色名称 [服务器]** 指令，支持两轮对话选择资历总览或分类总览，并以图片形式展示角色资历点数完成进度。

新增资历菜单与点数基础数据缓存，减少长期稳定接口的重复请求。

调整功能帮助页分类，指令分组改为日常、官方、角色、职业、休闲、阵营、副本、活动、交易、杂项、排行、推送和避雷。

调整指令触发词：**诛恶事件** 改为 **诛恶**，**排行** 改为 **名剑排行**。

### version: 2.5：

增加部分新指令，调整功能页面

### version: 2.4：

增加大量新指令

### version: 2.3：

宏查询接口调整，恢复使用

### version: 2.2：

接口地址调整,增加部分功能

### version: 2.1：

接口地址调整

### version: 2.0：

接口地址调整

### version: 1.2.4：

角色信息查询数据展示优化

角色名片查询功能优化

### version: 1.2.3：

查询个人奇遇的指令名称调整为 **查询**

新增角色基本信息查询功能 **角色 名称 [服务器]**

### version: 1.2.2：

调整角色名片查询功能。

### version: 1.2.1：

调整角色名片查询功能。

### version: 1.2.0：

部分HTML渲染图片功能优化，增加本地图片加载功能。

### version: 1.1.1：

图片渲染参数优化。

### version: 1.1.0：

部分代码功能重写。

### version: 1.0.0：

大部分重要功能已经实现