fxdyz

README.md

@@ -21,7 +21,7 @@
 - 支持按 AstrBot 会话分别开启总开关和具体 JX3API 实时事件订阅。
 - 复用 `aiohttp.ClientSession`，统一处理 GET、POST、JSON、图片和分页请求。
 - JX3BOX 的 Node、Next2、CMS 请求统一封装，交易行基础物品数据支持本地快照缓存和过期兜底。
-- JX3API 查询使用内存与 SQLite 两级 JSON 缓存，HTML 查询图片使用本地文件缓存；缓存时间、接口内存条数及图片缓存总容量均可在 WebUI 配置。
+- JX3API 查询使用内存与 SQLite 两级 JSON 缓存，HTML 查询图片使用本地文件缓存；缓存时间、接口内存容量、SQLite 接口缓存条数及图片缓存总容量均可在 WebUI 配置。
 - 内置 97 个中文触发指令和 51 个页面片段，通过公共布局与样式在本地组装为完整 HTML，并附带通用、沙盘、门派/心法和奇遇图标资源。
 
 ## 数据来源
@@ -72,7 +72,7 @@ pip install -r data/plugins/astrbot_plugin_jx3/requirements.txt
 | `aiohttp` | 异步 HTTP 请求与连接复用 |
 | `aiofiles` | 异步读取 HTML 模板 |
 | `aiosqlite` | 异步访问本地 SQLite 数据库 |
-| `matplotlib` | 当前依赖清单保留的绘图依赖；v3.4.6 业务代码未直接导入 |
+| `matplotlib` | 当前依赖清单保留的绘图依赖；v3.4.7 业务代码未直接导入 |
 
 ## 插件配置
 
@@ -305,20 +305,22 @@ AstrBot 插件详情页中的“剑网三插件管理”通过 Plugin Pages 桥
 | 页签 | 当前功能 |
 | --- | --- |
 | 会话控制 | 默认页签；在全部会话、白名单和黑名单之间切换，并维护会话 ID 与备注。空白名单不放行任何会话，空黑名单放行全部会话，策略同时作用于查询指令与事件推送 |
-| 事件推送 | 查看所有会话的推送总开关及已订阅事件编号 |
+| 事件推送 | 新增、编辑和删除会话推送配置；设置总开关并勾选具体事件，支持全选和清空选择，关闭总开关保留订阅选择 |
 | 区服绑定 | 使用自定义会话 ID 新增绑定；区服只能从标准区服下拉框选择，已有会话 ID 不可编辑 |
 | 区服别名 | 查看标准区服并行内维护别名；可使用随插件分发的 JSON 种子恢复默认 |
 | 心法别名 | 查看标准心法并维护最多 5 个别名；配装 ID 不在页面显示，可恢复默认 |
 | 缓存管理 | 分别配置接口数据和最终图片缓存时间、容量限制，查看占用并清理单项或全部缓存 |
 | 避雷迁移 | 把升级前保留在“历史公共数据”区的避雷记录迁移到指定会话 |
 
+事件推送配置保存后立即用于后续事件分发，仍受会话访问模式和绑定区服限制。新增时可以选择已有会话或输入完整的 AstrBot 会话 ID，重复新增会提示编辑已有配置；编辑时会话 ID 只读。空事件选择表示不接收任何事件；删除仅移除该会话的推送配置，保留区服绑定、访问名单和其他会话数据。免费事件与令牌事件分组展示，令牌事件仍需配置 `jx3api_wss_token`。
+
 页面顶部通过 JX3API `POST /token/stats` 展示当前 Token 的等级、已用次数、剩余次数和有效状态，成功结果在进程内保留 30 秒。普通打开或刷新 WebUI 时，区服目录、别名和绑定直接读取当前内存/SQLite 数据，不会请求区服状态接口；只有点击“刷新区服列表”时才会强制请求 `/server/status/check` 并更新当前区服目录。插件初始化时会执行一次 `server_list()` 建立用于参数消歧的有效区服目录：缓存有效时读取接口缓存，缓存不存在或已过期时才请求上游。
 
 缓存管理的接口默认时间为 300 秒，图片默认时间为 600 秒；每个 JX3API 接口和每个图片指令都可以单独覆盖，填写 `0` 表示关闭，恢复默认则重新继承全局时间。图片指令优先查询最终图片缓存，命中后不会再调用上游接口或重新渲染；图文结果会连同正文一起复用。单独清除接口会同时删除该路径所有参数组合的内存与 SQLite 缓存，单独清除图片会删除该指令生成的缓存文件，两种操作均不改变已配置时间。
 
 如果需要某条图片指令立即使用最新上游数据，应同时清除（或临时关闭）对应的接口缓存和图片缓存。只把接口缓存设为 `0` 时，已有最终图片仍可能直接命中；只把图片缓存设为 `0` 时，页面会重新渲染，但仍可能使用尚未过期的接口数据。
 
-接口内存热缓存默认最多 256 条，超出后按最近最少使用顺序淘汰；SQLite 中的接口缓存不受这项内存条数限制。图片二进制保存在 AstrBot 插件数据目录，默认总容量为 512 MB，超出后按最近最少使用顺序清理。随机名片、随机语录、吃喝选择和随机贴吧等接口默认不缓存，避雷查看和避雷查询也默认不缓存最终图片；这些项目仍可在 WebUI 中显式覆盖。
+接口内存缓存默认最多占用 16 MB，按 JSON 的 UTF-8 字节数统计并按最近最少使用顺序淘汰，WebUI 同时展示当前占用和缓存条数。SQLite 接口缓存独立按条数限制，默认最多 256 条；旧版接口条数配置会自动继承为 SQLite 上限。内存命中也会更新 SQLite 的访问时间，修改上限和插件启动时立即清理超额记录。SQLite 条数限制不是磁盘字节容量；删除记录后释放的页可供后续写入复用，数据库文件不一定立即缩小。图片二进制保存在 AstrBot 插件数据目录，默认总容量为 512 MB，超出后按最近最少使用顺序清理。每 60 秒自动清理过期接口和图片缓存，无需打开 WebUI；接口请求失败时不再返回过期数据。随机名片、随机语录、吃喝选择和随机贴吧等接口默认不缓存，避雷查看和避雷查询也默认不缓存最终图片；这些项目仍可在 WebUI 中显式覆盖。
 
 ## 业务流程
 
@@ -366,7 +368,7 @@ flowchart LR
 - `kungfu`：保存 JX3BOX 配装 ID、标准心法名及最多 5 个别名。
 - `trade_item_cache`：JX3BOX 交易行基础物品数据缓存及更新时间。
 - `cache_settings`：接口与图片指令的默认时间和单项覆盖配置。
-- `cache_limits`：接口内存条数和图片缓存总容量配置。
+- `cache_limits`：接口内存缓存总容量、SQLite 接口缓存最大条数及图片缓存总容量配置。
 - `api_response_cache`：JX3API 原始 JSON、创建时间、过期时间和最近访问时间。
 - `image_render_cache`：本地渲染图片文件的索引、大小、过期时间、最近访问时间及图文消息正文。
 
@@ -479,7 +481,7 @@ AstrBot 的渲染接口接收完整 HTML 字符串，因此插件不会依赖渲
 
 `trade_item_cache` 只保存 JX3BOX 交易行物品分组快照，当前键为 `trade_item_groups`。缓存有效期为 30 天；缓存过期后优先全量刷新，上游请求失败时继续使用可解析的旧缓存兜底。升级时会从旧 `achievement_cache` 迁移交易行缓存并删除旧表，历史资历菜单和点数缓存不会继续保留。
 
-`api_response_cache` 仅保存通过 JX3API 查询入口成功取得的原始 JSON；Token 和 Ticket 不写入缓存键或正文，凭据摘要只用于避免更换账号后误用旧缓存。同一缓存键的并发请求通过异步锁合并。读取顺序为“内存热缓存 → SQLite → 上游接口”；两级缓存使用同一项 TTL，不存在单独的内存保留时间。内存超过 WebUI 配置的条数时只淘汰内存副本，后续仍可从 SQLite 读取。缓存过期后优先刷新，上游失败时允许使用七天内仍可解析的旧数据兜底。
+`api_response_cache` 仅保存通过 JX3API 查询入口成功取得的原始 JSON；Token 和 Ticket 不写入缓存键或正文，凭据摘要只用于避免更换账号后误用旧缓存。同一缓存键的并发请求通过异步锁合并。读取顺序为“内存热缓存 → SQLite → 上游接口”；两级缓存使用同一项 TTL，内存按总字节数限制，SQLite 按记录条数限制。缓存过期后重新请求上游，权限拒绝、业务错误和网络失败均返回失败结果，不再使用旧数据兜底；强制刷新失败也会清除该请求原有的接口缓存。每 60 秒根据当前有效 TTL 自动清理过期接口记录，启动时同步淘汰历史超额记录；插件停用和初始化失败时回收清理任务。
 
 图片缓存不会把二进制写入 SQLite。图片消息处理器会在请求业务数据前，使用当前指令名、完整有效参数、二轮选择项、必要的会话范围、静态资源签名和截图参数生成 SHA-256 键；命中时直接把本地路径交给消息事件发送。未命中时才请求数据并渲染，再把 AstrBot 临时渲染结果复制到 `cache/images/`；SQLite 的 `image_render_cache` 只保存文件索引、大小、时间、最近访问记录和图文消息正文。超过 WebUI 配置的容量（默认 512 MB）后按最近最少使用顺序清理。
 
@@ -561,7 +563,7 @@ git diff --check
 
 ## 当前版本状态
 
-以下内容是对 v3.4.6 当前源码的静态核对结果，部署和二次开发前应注意：
+以下内容是对 v3.4.7 当前源码的静态核对结果，部署和二次开发前应注意：
 
 1. 查询图片使用浅色高对比主题和放大的内容区域；渲染清晰度、JPEG/PNG 格式及 JPEG 质量由 `image_render_quality` 配置组控制，提高清晰度或使用 PNG 会增加图片体积与渲染耗时。
 2. 所有 HTML 渲染图片底部都会显示数据时间；最终图片缓存命中后保留原时间并跳过接口请求和重新渲染。要让下一次查询同时获取最新上游数据并重新生成图片，需要一并清除或关闭对应接口缓存和图片缓存。