feat：添加取名工具

src/plugins/person_info/person_info.py

@@ -51,6 +51,8 @@ person_info_default = {
     "konw_time": 0,
     "msg_interval": 2000,
     "msg_interval_list": [],
+    "user_cardname": None,  # 添加群名片
+    "user_avatar": None,  # 添加头像信息（例如URL或标识符）
 }  # 个人信息的各项与默认值在此定义，以下处理会自动创建/补全每一项
 
 
@@ -186,7 +188,7 @@ class PersonInfoManager:
         logger.warning(f"无法从文本中提取有效的JSON字典: {text}")
         return {"nickname": "", "reason": ""}
 
-    async def qv_person_name(self, person_id: str, user_nickname: str, user_cardname: str, user_avatar: str):
+    async def qv_person_name(self, person_id: str, user_nickname: str, user_cardname: str, user_avatar: str, request: str = ""):
         """给某个用户取名"""
         if not person_id:
             logger.debug("取名失败：person_id不能为空")
@@ -211,6 +213,8 @@ class PersonInfoManager:
             if old_name:
                 qv_name_prompt += f"你之前叫他{old_name}，是因为{old_reason}，"
 
+            qv_name_prompt += f"\n其他取名的要求是：{request}"
+            
             qv_name_prompt += "\n请根据以上用户信息，想想你叫他什么比较好，请最好使用用户的qq昵称，可以稍作修改"
             if existing_names:
                 qv_name_prompt += f"\n请注意，以下名称已被使用，不要使用以下昵称：{existing_names}。\n"
@@ -511,5 +515,41 @@ class PersonInfoManager:
 
         return person_id
 
+    async def get_person_info_by_name(self, person_name: str) -> dict | None:
+        """根据 person_name 查找用户并返回基本信息 (如果找到)"""
+        if not person_name:
+            logger.debug("get_person_info_by_name 获取失败：person_name 不能为空")
+            return None
+
+        # 优先从内存缓存查找 person_id
+        found_person_id = None
+        for pid, name in self.person_name_list.items():
+            if name == person_name:
+                found_person_id = pid
+                break # 找到第一个匹配就停止
+
+        if not found_person_id:
+            # 如果内存没有，尝试数据库查询（可能内存未及时更新或启动时未加载）
+            document = db.person_info.find_one({"person_name": person_name})
+            if document:
+                found_person_id = document.get("person_id")
+            else:
+                logger.debug(f"数据库中也未找到名为 '{person_name}' 的用户")
+                return None # 数据库也找不到
+
+        # 根据找到的 person_id 获取所需信息
+        if found_person_id:
+            required_fields = ["person_id", "platform", "user_id", "nickname", "user_cardname", "user_avatar"]
+            person_data = await self.get_values(found_person_id, required_fields)
+            if person_data: # 确保 get_values 成功返回
+                return person_data
+            else:
+                logger.warning(f"找到了 person_id '{found_person_id}' 但获取详细信息失败")
+                return None
+        else:
+             # 这理论上不应该发生，因为上面已经处理了找不到的情况
+             logger.error(f"逻辑错误：未能为 '{person_name}' 确定 person_id")
+             return None
+
 
 person_info_manager = PersonInfoManager()