OK

CHANGELOG.md

@@ -1,5 +1,11 @@
 ## 更新记录
 
+### version: 1.2.3：
+
+查询个人奇遇的指令名称调整为 **查询**
+
+新增角色基本信息查询功能 **角色 名称 [服务器]**
+
 ### version: 1.2.2：
 
 调整角色名片查询功能。

core/jx3_data.py

@@ -1488,3 +1488,42 @@ class JX3Service:
         return return_data
     
         
+    async def jueshe(self,name: str, server: str) -> Dict[str, Any]:
+        """角色"""
+        return_data = self._init_return_data()
+
+        # 1. 构造请求参数
+        params = {"server": server, "name": name, "token": self.token}
+
+        # 2. 调用基础请求
+        data: Optional[Dict[str, Any]] = await self._base_request(
+            "jx3_jueshexinxi", "GET", params=params
+        )
+        if not data:
+            return_data["msg"] = "获取接口信息失败"
+            return return_data
+    
+        # 3. 处理返回数据
+        try:
+            # 格式化字符串，利用字典的 get 方法提供默认值
+            result_msg = (
+                f"大区：{data.get('zoneName', '无')}\n"
+                f"服务器：{data.get('serverName', '无')}\n"
+                f"名称：{data.get('roleName', '无')}\n"
+                f"ID：{data.get('roleId', '无')}\n"
+                f"门派：{data.get('forceName', '无')}\n"
+                f"体型：{data.get('bodyName', '无')}\n"
+                f"帮会：{data.get('tongName', '无')}\n"
+                f"阵营：{data.get('campName', '无')}\n"
+            )
+
+            return_data["data"] = result_msg
+            return_data["code"] = 200
+        except Exception as e:
+            logger.error(f"数据处理时出错: {e}")
+            return_data["msg"] = "处理接口返回信息时出错"
+            return return_data
+        
+        return_data["code"] = 200
+
+        return return_data

core/message.py

@@ -351,6 +351,9 @@ class MessageBuilder:
         """剑三 八卦 类型"""
         return await self.plain_msg(event, lambda: self.jx3api.bagua(name))
     
+    async def jx3_jueshe(self, event: AstrMessageEvent,name: str, server: str = ""):
+        """剑三 角色 名称 服务器"""
+        return await self.plain_msg(event, lambda: self.jx3api.jueshe(name, self.serverdefault(server)))
     
     async def bilei_add(self, event: AstrMessageEvent,name: str, text: str):
         """避雷添加 名称 备注"""

data/api_config.json

@@ -331,5 +331,15 @@
             "name": "",
             "token": ""
         }
+    },
+    "jx3_jueshexinxi":{
+        "url":"https://www.jx3api.com/data/role/detailed",
+        "method":"GET",
+        "description":"获取角色信息",
+        "params":{
+            "server": "",
+            "name": "",
+            "token": ""
+        }
     }
 }

main.py

@@ -16,7 +16,7 @@ from .core.fun_basic import load_as_base64
 @register("astrbot_plugin_jx3", 
           "fxdyz", 
           "通过调用剑网三API接口获取游戏数据，处理发送。", 
-          "1.2.2",
+          "1.2.3",
           "https://github.com/qsc20001102/astrbot_plugin_jx3api"
 )
 class Jx3ApiPlugin(Star):
@@ -211,12 +211,13 @@ class Jx3ApiPlugin(Star):
             "的卢": self.jx3cmd.jx3_dilujilu,
             "招募": self.jx3cmd.jx3_tuanduizhaomu,
             "战绩": self.jx3cmd.jx3_zhanji,
-            "奇遇": self.jx3cmd.jx3_qiyu,
+            "查询": self.jx3cmd.jx3_qiyu,
             "拍卖": self.jx3cmd.jx3_zhengyingpaimai,
             "扶摇九天": self.jx3cmd.jx3_fuyaojjiutian,
             "刷马": self.jx3cmd.jx3_shuma,
             "骗子": self.jx3cmd.jx3_pianzhi,
             "八卦": self.jx3cmd.jx3_bagua,
+            "角色": self.jx3cmd.jx3_jueshe,
             "开服推送": self.jx3cmd.jx3_kaifhujiank,
             "新闻推送": self.jx3cmd.jx3_xinwenzhixun,
             "刷马推送": self.jx3cmd.jx3_shuamamsg,

metadata.yaml

@@ -1,6 +1,6 @@
 name: astrbot_plugin_jx3 
 display_name: 剑网三游戏数据查询工具 
 desc: 通过接口调用剑网三API接口获取游戏数据，处理发送。
-version: v1.2.2 
+version: v1.2.3 
 author: 飞翔大野猪 
 repo: https://github.com/qsc20001102/astrbot_plugin_jx3 

templates/helps.html

@@ -163,13 +163,13 @@ body {
 <div class="command"><div class="cmd-name">的卢记录</div><div class="cmd-usage">的卢 [服务器]</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">副本招募</div><div class="cmd-usage">招募 副本名称 [服务器]</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">角色战绩</div><div class="cmd-usage">战绩 角色名 [服务器]</div><div class="cmd-desc">33</div></div>
-<div class="command"><div class="cmd-name">角色奇遇</div><div class="cmd-usage">奇遇 角色名 [服务器]</div><div class="cmd-desc"></div></div>
+<div class="command"><div class="cmd-name">角色奇遇</div><div class="cmd-usage">查询 角色名 [服务器]</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">阵营拍卖</div><div class="cmd-usage">拍卖 物品名称 [服务器]</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">扶摇九天</div><div class="cmd-usage">扶摇九天 [服务器]</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">刷马</div><div class="cmd-usage">刷马 [服务器]</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">骗子查询</div><div class="cmd-usage">骗子 QQ号</div><div class="cmd-desc"></div></div>
 <div class="command"><div class="cmd-name">八卦记录</div><div class="cmd-usage">八卦 类型</div><div class="cmd-desc">818 616 避雷</div></div>
-
+<div class="command"><div class="cmd-name">角色信息</div><div class="cmd-usage">角色 名称 [服务器]</div><div class="cmd-desc">查询角色基础信息</div></div>
 </div>
 </div>