fxdyz

README.md

@@ -123,6 +123,7 @@ JX3API Token 可从 [JX3API](https://www.jx3api.com/) 获取。推栏 Ticket 通
 - 缺少必填参数、数字转换失败或执行异常时，入口层统一回复 `参数错误或执行失败`。
 - 未绑定区服时按指令表提供标准参数。绑定后可以省略 `server` 参数；显式填写完整参数时仍优先使用本次输入的区服。在区服参数位置填写 `全区` 时，会忽略会话绑定并向接口传入空区服以查询全区数据。
 - 标准区服名和 WebUI 中配置的别名都可用于查询。对于区服后的可选参数，分发器通过当前有效区服目录和别名判断首个参数是显式区服还是后续参数。
+- 心法类指令会在入口层把标准心法名或 WebUI 配置的心法别名统一解析为标准名称；当前适用于试炼排行、阵眼、配装、技能、奇穴、小药和宏。门派筛选参数不参与心法别名解析。
 
 ### 会话区服绑定
 
@@ -154,7 +155,7 @@ JX3API Token 可从 [JX3API](https://www.jx3api.com/) 获取。推栏 Ticket 通
 | `关隘` | 查询关隘首领状态；图片 | Token |
 | `赤兔`、`本周赤兔` | 查询当日或本周赤兔记录；文本 | Token |
 | `阵营奉献 [阵营]` | 查询阵营奉献事件，固定最多 50 条；图片 | Token |
-| `烟花 服务器 [角色]` | 查询指定服务器的烟花记录；已绑定会话可省略服务器；图片 | Token |
+| `烟花 服务器 角色 [条数]` | 查询指定服务器的烟花记录；条数默认为 50，须为正整数，填写时放在角色名称后；已绑定会话可省略服务器；图片 | Token |
 | `刷马 服务器` | 查询刷马聊天情报；文本 | Token |
 | `马场 服务器` | 查询未过期马场记录；文本 | Token |
 
@@ -162,7 +163,7 @@ JX3API Token 可从 [JX3API](https://www.jx3api.com/) 获取。推栏 Ticket 通
 
 | 指令 | 说明与输出 | 凭据 |
 | --- | --- | --- |
-| `战绩 服务器 角色 [模式]` | 角色名剑战绩，模式默认 `33`；图片 | Token + Ticket |
+| `战绩 服务器 角色 [模式]` | 角色名剑战绩，模式可选 `22`、`33`、`55`，默认 `33`；图片 | Token + Ticket |
 | `名剑排行 [模式] [数量]` | 名剑大会排行，默认 `33`、50 条；图片 | Token + Ticket |
 | `名剑统计 [模式]` | 名剑门派统计，模式默认 `33`；图片 | Token + Ticket |
 | `帮会排行 服务器` | 回复序号选择神兵宝甲或爱心帮会榜单，最多保留前 50 条；图片 | Token |
@@ -348,8 +349,9 @@ flowchart LR
 1. `parse_message()` 检查前缀并使用 `str.split()` 切分消息。
 2. 第一段作为指令，其余段作为位置参数。
 3. `command_map` 将中文触发词映射到 `MessageBuilder` 方法。
-4. `_call_with_auto_args()` 通过 `inspect.signature()` 读取参数签名，按注解转换 `int` 和 `float`。
-5. 找不到指令时忽略消息；找到指令后停止事件继续传播并调用处理器。
+4. `_prepare_server_args()` 和 `_prepare_kungfu_args()` 根据处理器参数名统一补齐区服绑定并解析区服、心法别名。
+5. `_call_with_auto_args()` 通过 `inspect.signature()` 读取参数签名，按注解转换 `int` 和 `float`。
+6. 找不到指令时忽略消息；找到指令后停止事件继续传播并调用处理器。
 
 分发器不会检查多余参数，多出的参数会被忽略。缺少必填参数会抛出异常并返回统一错误提示。
 
@@ -474,7 +476,7 @@ astrbot_plugin_jx3/
 │   ├── session_control.py   # 全部会话、白名单与黑名单访问策略
 │   ├── webui.py             # 插件管理页路由、数据聚合与请求处理
 │   ├── server_binding.py    # 会话区服绑定、别名与区服目录
-│   ├── kungfu_alias.py      # 本地心法目录初始化、校验与 WebUI 写入
+│   ├── kungfu_alias.py      # 本地心法目录初始化、全局别名解析、校验与 WebUI 写入
 │   ├── bilei_data.py        # 避雷数据增删改查
 │   ├── sqlite.py            # aiosqlite 通用封装
 │   ├── fun_basic.py         # 图标、时间和货币格式化工具
@@ -520,7 +522,7 @@ git diff --check
 
 ## 当前版本状态
 
-以下内容是对 v3.4.3 当前源码的静态核对结果，部署和二次开发前应注意：
+以下内容是对 v3.4.4 当前源码的静态核对结果，部署和二次开发前应注意：
 
 1. 查询图片使用浅色高对比主题和放大的内容区域；渲染清晰度、JPEG/PNG 格式及 JPEG 质量由 `image_render_quality` 配置组控制，提高清晰度或使用 PNG 会增加图片体积与渲染耗时。
 2. `帮会排行`、`阵营排行`、`其他排行` 使用固定的“数字序号 → 榜单名称”首轮菜单，次轮查询统一截取接口返回的前 50 条；取得有效选择后会先停止超时计时器，避免渲染期间重复输出。