昵称系统 (NicknameAPI)

NicknameAPI 由 astrbot_plugin_nickname 插件提供，用于获取用户设置的自定义昵称。

async def get_nickname(self, user_id: str) -> Optional[str]

获取单个用户的自定义昵称。

• 参数:
  • user_id (str): 用户的唯一ID。
• 返回: str 或 None - 如果用户设置了自定义昵称，则返回该昵称字符串；否则返回 None。

async def get_nicknames_batch(self, user_ids: List[str]) -> Dict[str, str]

批量获取多个用户的自定义昵称，适用于排行榜等场景以提高效率。

• 参数:
  • user_ids (List[str]): 一个包含多个用户ID的列表。
• 返回: Dict[str, str] - 一个字典，键是用户ID，值是对应的自定义昵称。只包含在列表中找到了昵称的用户。