✨ feat(auth): 添加群组和机器人唤醒命令支持，优化权限检查逻辑 (#2113)

* ✨ feat(auth): 添加群组和机器人唤醒命令支持，优化权限检查逻辑
✨ feat(llm): 增加额外请求头配置，改进API适配器请求头处理

* 🚨 auto fix by pre-commit hooks

* ```
fix(auth): 优化bot权限验证逻辑并改进错误提示

- 将bot存在性检查与状态检查分离，提供更精确的错误信息
- 修复当bot为None时的状态访问问题
- 移除不必要的注释，保持代码简洁
- 优化日志记录的位置和条件判断
```

---------

Co-authored-by: ATTomatoo <1126160939@qq.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

zhenxun/services/llm/adapters/base.py

@@ -202,7 +202,23 @@ class BaseAdapter(ABC):
             )
         return f"{model.api_base.rstrip('/')}{endpoint}"
 
-    def get_base_headers(self, api_key: str) -> dict[str, str]:
+    def _get_provider_extra_headers(self, model: "LLMModel | None") -> dict[str, str]:
+        if not model:
+            return {}
+        raw_headers = getattr(model.provider_config, "extra_headers", None)
+        if not isinstance(raw_headers, dict):
+            return {}
+        headers: dict[str, str] = {}
+        for key, value in raw_headers.items():
+            key_text = str(key).strip()
+            if not key_text or value is None:
+                continue
+            headers[key_text] = str(value)
+        return headers
+
+    def get_base_headers(
+        self, api_key: str, model: "LLMModel | None" = None
+    ) -> dict[str, str]:
         """获取基础请求头"""
         from zhenxun.utils.user_agent import get_user_agent
 
@@ -213,6 +229,7 @@ class BaseAdapter(ABC):
                 "Authorization": f"Bearer {api_key}",
             }
         )
+        headers.update(self._get_provider_extra_headers(model))
         return headers
 
     def validate_response(self, response_json: dict[str, Any]) -> None:
@@ -422,7 +439,7 @@ class OpenAICompatAdapter(BaseAdapter):
     ) -> RequestData:
         """准备简单文本生成请求 - OpenAI兼容API的通用实现"""
         url = self.get_api_url(model, self.get_chat_endpoint(model))
-        headers = self.get_base_headers(api_key)
+        headers = self.get_base_headers(api_key, model)
 
         messages = []
         if history:
@@ -449,7 +466,7 @@ class OpenAICompatAdapter(BaseAdapter):
     ) -> RequestData:
         """准备高级请求 - OpenAI兼容格式"""
         url = self.get_api_url(model, self.get_chat_endpoint(model))
-        headers = self.get_base_headers(api_key)
+        headers = self.get_base_headers(api_key, model)
         if model.api_type == "openrouter":
             headers.update(
                 {
@@ -523,7 +540,7 @@ class OpenAICompatAdapter(BaseAdapter):
     ) -> RequestData:
         """准备嵌入请求 - OpenAI兼容格式"""
         url = self.get_api_url(model, self.get_embedding_endpoint(model))
-        headers = self.get_base_headers(api_key)
+        headers = self.get_base_headers(api_key, model)
 
         body = {
             "model": model.model_name,