py-wecom-toolkit 3.0.2__tar.gz → 3.0.3__tar.gz

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: py-wecom-toolkit
-Version: 3.0.2
+Version: 3.0.3
 Summary: 企业微信 Python 扩展包 - 支持 Webhook 与 Server 端 API
 Project-URL: Homepage, https://gitee.com/guolei19850528/py_wecom_toolkit
 Project-URL: Documentation, https://gitee.com/guolei19850528/py_wecom_toolkit#readme
@@ -72,7 +72,7 @@ py-wecom-toolkit/
 │       ├── __init__.py         # 包入口，导出所有公共类
 │       ├── webhook/            # Webhook 消息发送模块（原“群机器人”）
 │       │   ├── __init__.py
-│       │   ├── client.py       # WebhookClient / AsyncWebhookClient
+│       │   ├── client.py       # WeComWebhookClient / AsyncWeComWebhookClient
 │       │   ├── exceptions.py   # Webhook 异常定义
 │       │   ├── models.py       # pydantic v2 消息模型（8种消息类型）
 │       │   └── types.py        # 类型别名
@@ -152,7 +152,7 @@ pip install py-wecom-toolkit[dev]
 - 支持全部 8 种 Webhook 消息类型: text, markdown, markdown_v2, image, news, file, voice, template_card
 - 基于 pydantic v2 的消息模型验证
 - 基于 httpx 的异步 HTTP 客户端
-- 同步与异步客户端双模式支持 (`WebhookClient` / `AsyncWebhookClient`)
+- 同步与异步客户端双模式支持 (`WeComWebhookClient` / `AsyncWeComWebhookClient`)
 - 消息发送支持 @ 成员列表合并与去重
 - 文件上传接口 (base64 编码 + md5 校验)
 
@@ -171,10 +171,10 @@ pip install py-wecom-toolkit[dev]
 
 ```python
 import asyncio
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 async def main():
-    client = WebhookClient(key="你的webhook_key")
+    client = WeComWebhookClient(key="你的webhook_key")
 
     # 发送文本消息
     await client.send_text("Hello, World!")
@@ -214,10 +214,10 @@ asyncio.run(main())
 ### Webhook 消息发送 (同步)
 
 ```python
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 # 创建同步客户端，支持上下文管理器自动管理连接池
-with WebhookClient(key="你的webhook_key") as client:
+with WeComWebhookClient(key="你的webhook_key") as client:
 
     # 发送文本消息
     resp = client.send_text("Hello, World!")
@@ -337,15 +337,15 @@ asyncio.run(main())
 
 ```python
 import httpx
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 # 使用自定义 httpx 客户端
 async with httpx.AsyncClient(timeout=30.0) as http_client:
-    client = WebhookClient(key="xxx", client=http_client)
+    client = WeComWebhookClient(key="xxx", client=http_client)
     await client.send_text("使用自定义客户端")
 
 # 使用上下文管理器
-async with WebhookClient(key="xxx") as client:
+async with WeComWebhookClient(key="xxx") as client:
     await client.send_text("自动管理连接池")
 
 # 使用 diskcache 缓存 access_token
@@ -369,7 +369,7 @@ client = WeComServerClient(
 
 ## API 参考
 
-### WebhookClient / AsyncWebhookClient
+### WeComWebhookClient / AsyncWeComWebhookClient
 
 | 方法 | 说明 |
 |------|------|

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/README.md

@@ -20,7 +20,7 @@ py-wecom-toolkit/
 │       ├── __init__.py         # 包入口，导出所有公共类
 │       ├── webhook/            # Webhook 消息发送模块（原“群机器人”）
 │       │   ├── __init__.py
-│       │   ├── client.py       # WebhookClient / AsyncWebhookClient
+│       │   ├── client.py       # WeComWebhookClient / AsyncWeComWebhookClient
 │       │   ├── exceptions.py   # Webhook 异常定义
 │       │   ├── models.py       # pydantic v2 消息模型（8种消息类型）
 │       │   └── types.py        # 类型别名
@@ -100,7 +100,7 @@ pip install py-wecom-toolkit[dev]
 - 支持全部 8 种 Webhook 消息类型: text, markdown, markdown_v2, image, news, file, voice, template_card
 - 基于 pydantic v2 的消息模型验证
 - 基于 httpx 的异步 HTTP 客户端
-- 同步与异步客户端双模式支持 (`WebhookClient` / `AsyncWebhookClient`)
+- 同步与异步客户端双模式支持 (`WeComWebhookClient` / `AsyncWeComWebhookClient`)
 - 消息发送支持 @ 成员列表合并与去重
 - 文件上传接口 (base64 编码 + md5 校验)
 
@@ -119,10 +119,10 @@ pip install py-wecom-toolkit[dev]
 
 ```python
 import asyncio
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 async def main():
-    client = WebhookClient(key="你的webhook_key")
+    client = WeComWebhookClient(key="你的webhook_key")
 
     # 发送文本消息
     await client.send_text("Hello, World!")
@@ -162,10 +162,10 @@ asyncio.run(main())
 ### Webhook 消息发送 (同步)
 
 ```python
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 # 创建同步客户端，支持上下文管理器自动管理连接池
-with WebhookClient(key="你的webhook_key") as client:
+with WeComWebhookClient(key="你的webhook_key") as client:
 
     # 发送文本消息
     resp = client.send_text("Hello, World!")
@@ -285,15 +285,15 @@ asyncio.run(main())
 
 ```python
 import httpx
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 # 使用自定义 httpx 客户端
 async with httpx.AsyncClient(timeout=30.0) as http_client:
-    client = WebhookClient(key="xxx", client=http_client)
+    client = WeComWebhookClient(key="xxx", client=http_client)
     await client.send_text("使用自定义客户端")
 
 # 使用上下文管理器
-async with WebhookClient(key="xxx") as client:
+async with WeComWebhookClient(key="xxx") as client:
     await client.send_text("自动管理连接池")
 
 # 使用 diskcache 缓存 access_token
@@ -317,7 +317,7 @@ client = WeComServerClient(
 
 ## API 参考
 
-### WebhookClient / AsyncWebhookClient
+### WeComWebhookClient / AsyncWeComWebhookClient
 
 | 方法 | 说明 |
 |------|------|

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/async_basic.py

@@ -1,13 +1,13 @@
 #!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
-"""异步基础方法演示 - 展示 AsyncWebhookClient 的基本用法."""
+"""异步基础方法演示 - 展示 AsyncWeComWebhookClient 的基本用法."""
 
 from __future__ import annotations
 
 import asyncio
 from datetime import datetime
 
-from py_wecom_toolkit import AsyncWebhookClient
+from py_wecom_toolkit import AsyncWeComWebhookClient
 
 from config import get_webhook_key
 
@@ -24,13 +24,13 @@ async def main() -> None:
 
     # 方式一: 异步上下文管理器 (推荐)
     print("=== 方式一: 异步上下文管理器 ===")
-    async with AsyncWebhookClient(key=key) as client:
+    async with AsyncWeComWebhookClient(key=key) as client:
         response = await client.send_text(_wrap(f"[异步基础测试] 上下文管理器 - {current_time}", current_time))
         print(f"结果: errcode={response.errcode}, errmsg={response.errmsg}")
 
     # 方式二: 手动管理连接
     print("\n=== 方式二: 手动管理连接 ===")
-    client = AsyncWebhookClient(key=key)
+    client = AsyncWeComWebhookClient(key=key)
     try:
         response = await client.send_text(_wrap(f"[异步基础测试] 手动连接 - {current_time}", current_time))
         print(f"结果: errcode={response.errcode}, errmsg={response.errmsg}")
@@ -39,7 +39,7 @@ async def main() -> None:
 
     # 方式三: 自定义配置
     print("\n=== 方式三: 自定义配置 ===")
-    client = AsyncWebhookClient(
+    client = AsyncWeComWebhookClient(
         key=key,
         timeout=30.0,                    # 自定义超时
         mentioned_list=["@all"],         # 默认 @所有人
@@ -52,7 +52,7 @@ async def main() -> None:
 
     # 方式四: 使用原始 dict 发送
     print("\n=== 方式四: 原始 dict 发送 ===")
-    async with AsyncWebhookClient(key=key) as client:
+    async with AsyncWeComWebhookClient(key=key) as client:
         response = await client.send({
             "msgtype": "text",
             "text": {"content": _wrap(f"[异步基础测试] 原始dict - {current_time}", current_time)},

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/async_file.py

@@ -8,7 +8,7 @@ import asyncio
 from datetime import datetime
 from pathlib import Path
 
-from py_wecom_toolkit import AsyncWebhookClient
+from py_wecom_toolkit import AsyncWeComWebhookClient
 
 from config import get_webhook_key
 
@@ -18,7 +18,7 @@ async def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    async with AsyncWebhookClient(key=key) as client:
+    async with AsyncWeComWebhookClient(key=key) as client:
         # 创建测试文件
         test_file = Path(__file__).parent / "async_test_upload.txt"
         test_file.write_text(f"这是异步测试文件\n创建时间: {current_time}")

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/async_text.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import asyncio
 from datetime import datetime
 
-from py_wecom_toolkit import AsyncWebhookClient
+from py_wecom_toolkit import AsyncWeComWebhookClient
 
 from config import get_webhook_key
 
@@ -22,7 +22,7 @@ async def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    async with AsyncWebhookClient(key=key) as client:
+    async with AsyncWeComWebhookClient(key=key) as client:
         # 1. 纯文本消息
         print("1. 发送纯文本消息")
         resp = await client.send_text(_wrap(f"[异步文本测试] 纯文本消息 - {current_time}", current_time))

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/basic.py

@@ -1,13 +1,13 @@
 #!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
-"""基础方法演示 - 展示 WebhookClient 的基本用法."""
+"""基础方法演示 - 展示 WeComWebhookClient 的基本用法."""
 
 from __future__ import annotations
 
 import asyncio
 from datetime import datetime
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -24,13 +24,13 @@ async def main() -> None:
 
     # 方式一: 上下文管理器 (推荐)
     print("=== 方式一: 上下文管理器 ===")
-    async with WebhookClient(key=key) as client:
+    async with WeComWebhookClient(key=key) as client:
         response = await client.send_text(_wrap(f"[基础测试] 上下文管理器 - {current_time}", current_time))
         print(f"结果: errcode={response.errcode}, errmsg={response.errmsg}")
 
     # 方式二: 手动管理连接
     print("\n=== 方式二: 手动管理连接 ===")
-    client = WebhookClient(key=key)
+    client = WeComWebhookClient(key=key)
     try:
         response = await client.send_text(_wrap(f"[基础测试] 手动连接 - {current_time}", current_time))
         print(f"结果: errcode={response.errcode}, errmsg={response.errmsg}")
@@ -39,7 +39,7 @@ async def main() -> None:
 
     # 方式三: 自定义配置
     print("\n=== 方式三: 自定义配置 ===")
-    client = WebhookClient(
+    client = WeComWebhookClient(
         key=key,
         timeout=30.0,                    # 自定义超时
         mentioned_list=["@all"],         # 默认 @所有人
@@ -52,7 +52,7 @@ async def main() -> None:
 
     # 方式四: 使用原始 dict 发送
     print("\n=== 方式四: 原始 dict 发送 ===")
-    async with WebhookClient(key=key) as client:
+    async with WeComWebhookClient(key=key) as client:
         response = await client.send({
             "msgtype": "text",
             "text": {"content": _wrap(f"[基础测试] 原始dict - {current_time}", current_time)},

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/file.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 from datetime import datetime
 from pathlib import Path
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -22,7 +22,7 @@ def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    with WebhookClient(key=key) as client:
+    with WeComWebhookClient(key=key) as client:
         # 创建测试文件
         test_file = Path(__file__).parent / "test_upload.txt"
         test_file.write_text(f"这是一个测试文件\n创建时间: {current_time}")

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/image.py

@@ -8,7 +8,7 @@ import base64
 from datetime import datetime
 from pathlib import Path
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -23,7 +23,7 @@ def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    with WebhookClient(key=key) as client:
+    with WeComWebhookClient(key=key) as client:
         # 1. 从文件发送图片
         print("1. 发送本地图片文件")
 

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/markdown.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import asyncio
 from datetime import datetime
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -22,7 +22,7 @@ async def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    async with WebhookClient(key=key) as client:
+    async with WeComWebhookClient(key=key) as client:
         # 1. 标题
         print("1. 发送标题")
         resp = await client.send_markdown(_wrap(

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/markdown_v2.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import asyncio
 from datetime import datetime
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -22,7 +22,7 @@ async def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    async with WebhookClient(key=key) as client:
+    async with WeComWebhookClient(key=key) as client:
         # 1. 标题
         print("1. 发送标题")
         resp = await client.send_markdown_v2(_wrap(

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/news.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import time
 from datetime import datetime
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -24,7 +24,7 @@ def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    with WebhookClient(key=key) as client:
+    with WeComWebhookClient(key=key) as client:
         # 1. 单条图文
         print("1. 发送单条图文")
         resp = client.send_news([

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/template_card.py

@@ -6,7 +6,7 @@ from __future__ import annotations
 
 from datetime import datetime
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -21,7 +21,7 @@ def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    with WebhookClient(key=key) as client:
+    with WeComWebhookClient(key=key) as client:
         # 1. 文本通知卡片
         print("1. 发送文本通知卡片")
         text_notice_card = {

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/text.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import asyncio
 from datetime import datetime
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -22,7 +22,7 @@ async def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    async with WebhookClient(key=key) as client:
+    async with WeComWebhookClient(key=key) as client:
         # 1. 纯文本消息
         print("1. 发送纯文本消息")
         resp = await client.send_text(_wrap(f"[文本消息] 这是一条纯文本消息 - {current_time}", current_time))

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/examples/webhook/voice.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 from datetime import datetime
 from pathlib import Path
 
-from py_wecom_toolkit import WebhookClient
+from py_wecom_toolkit import WeComWebhookClient
 
 from config import get_webhook_key
 
@@ -22,7 +22,7 @@ def main() -> None:
     key = get_webhook_key()
     current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
-    with WebhookClient(key=key) as client:
+    with WeComWebhookClient(key=key) as client:
         # 注意: 语音文件需要是 AMR 格式, 不超过 2MB, 时长不超过 60s
         # 这里使用示例路径, 请替换为实际的 AMR 文件
         voice_file = Path(__file__).parent / "test_voice.amr"

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "py-wecom-toolkit"
-version = "3.0.2"
+version = "3.0.3"
 description = "企业微信 Python 扩展包 - 支持 Webhook 与 Server 端 API"
 readme = "README.md"
 license = { file = "LICENSE" }

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/src/py_wecom_toolkit/__init__.py

@@ -11,12 +11,12 @@ from .server.models import (
     MediaUploadResponse,
     MessageSendRequest,
     MessageSendResponse,
-    ServerResponse,
+    WeComServerResponse,
 )
 from .server.token import AccessTokenManager
-from .webhook.client import AsyncWebhookClient, WebhookClient
+from .webhook.client import AsyncWeComWebhookClient, WeComWebhookClient
 from .webhook.models import (
-    WebhookResponse,
+    WeComWebhookResponse,
     UploadResponse,
     MessageType,
     TextMessage,
@@ -29,17 +29,17 @@ from .webhook.models import (
     TemplateCardMessage,
 )
 from .webhook.exceptions import (
-    WebhookError,
-    WebhookAPIError,
-    WebhookRateLimitError,
+    WeComWebhookError,
+    WeComWebhookAPIError,
+    WeComWebhookRateLimitError,
 )
 
-__version__ = "3.0.2"
+__version__ = "3.0.3"
 
 __all__ = [
-    "WebhookClient",
-    "AsyncWebhookClient",
-    "WebhookResponse",
+    "WeComWebhookClient",
+    "AsyncWeComWebhookClient",
+    "WeComWebhookResponse",
     "UploadResponse",
     "MessageType",
     "TextMessage",
@@ -50,15 +50,15 @@ __all__ = [
     "FileMessage",
     "VoiceMessage",
     "TemplateCardMessage",
-    "WebhookError",
-    "WebhookAPIError",
-    "WebhookRateLimitError",
+    "WeComWebhookError",
+    "WeComWebhookAPIError",
+    "WeComWebhookRateLimitError",
     "WeComServerClient",
     "AsyncWeComServerClient",
     "MessageSendMixin",
     "MediaMixin",
     "AccessTokenManager",
-    "ServerResponse",
+    "WeComServerResponse",
     "AccessTokenResponse",
     "IPListResponse",
     "MediaUploadResponse",

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/src/py_wecom_toolkit/server/__init__.py

@@ -9,7 +9,7 @@
 from .client import AsyncWeComServerClient, WeComServerClient
 from .token import AccessTokenManager
 from .models import (
-    ServerResponse,
+    WeComServerResponse,
     AccessTokenResponse,
     IPListResponse,
     MediaUploadResponse,
@@ -24,7 +24,7 @@ __all__ = [
     "AccessTokenManager",
     "MessageSendMixin",
     "MediaMixin",
-    "ServerResponse",
+    "WeComServerResponse",
     "AccessTokenResponse",
     "IPListResponse",
     "MediaUploadResponse",

{py_wecom_toolkit-3.0.2 → py_wecom_toolkit-3.0.3}/src/py_wecom_toolkit/server/client.py

@@ -18,8 +18,8 @@ from typing import Any
 import httpx
 
 from .cache import MemoryCache, TokenCache
-from .exceptions import ServerAPIError, ServerConfigError, ServerNetworkError
-from .models import IPListResponse, ServerResponse
+from .exceptions import WeComServerAPIError, WeComServerConfigError, WeComServerNetworkError
+from .models import IPListResponse, WeComServerResponse
 from .message import MessageSendMixin
 from .media import MediaMixin
 from .token import AccessTokenManager
@@ -44,9 +44,9 @@ class _BaseServerClient(MessageSendMixin, MediaMixin):
         base_url: str = BASE_URL,
     ) -> None:
         if not corpid:
-            raise ServerConfigError("corpid 不能为空")
+            raise WeComServerConfigError("corpid 不能为空")
         if not corpsecret and not access_token:
-            raise ServerConfigError("corpsecret 和 access_token 至少需提供一个")
+            raise WeComServerConfigError("corpsecret 和 access_token 至少需提供一个")
         self._corpid = corpid
         self._corpsecret = corpsecret
         self._timeout = timeout
@@ -86,11 +86,11 @@ class _BaseServerClient(MessageSendMixin, MediaMixin):
         return await self._token_manager.async_get_token()
 
     def _check_response(
-        self, data: dict[str, Any], model: type[ServerResponse]
-    ) -> ServerResponse:
+        self, data: dict[str, Any], model: type[WeComServerResponse]
+    ) -> WeComServerResponse:
         resp = model(**data)
         if not resp.ok:
-            raise ServerAPIError(resp.errcode, resp.errmsg)
+            raise WeComServerAPIError(resp.errcode, resp.errmsg)
         return resp
 
     # ------------------------------------------------------------------
@@ -241,7 +241,7 @@ class WeComServerClient(_BaseServerClient):
             response = self._client.get(url, params=params)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"GET 请求失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"GET 请求失败: {exc}", exc) from exc
         return response.json()
 
     def _get_bytes(self, url: str, params: dict[str, Any]) -> bytes:
@@ -249,7 +249,7 @@ class WeComServerClient(_BaseServerClient):
             response = self._client.get(url, params=params)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"GET 下载失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"GET 下载失败: {exc}", exc) from exc
         return response.content
 
     def _post_json(
@@ -259,7 +259,7 @@ class WeComServerClient(_BaseServerClient):
             response = self._client.post(url, params=params, json=json)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"POST 请求失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"POST 请求失败: {exc}", exc) from exc
         return response.json()
 
     def _post_files(
@@ -269,7 +269,7 @@ class WeComServerClient(_BaseServerClient):
             response = self._client.post(url, params=params, files=files)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"文件上传失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"文件上传失败: {exc}", exc) from exc
         return response.json()
 
 
@@ -325,27 +325,27 @@ class AsyncWeComServerClient(_BaseServerClient):
         await self._client.aclose()
 
     def _get(self, url: str, params: dict[str, Any]) -> dict[str, Any]:
-        raise ServerConfigError("异步客户端请使用 async_get")
+        raise WeComServerConfigError("异步客户端请使用 async_get")
 
     def _get_bytes(self, url: str, params: dict[str, Any]) -> bytes:
-        raise ServerConfigError("异步客户端请使用 async_get_bytes")
+        raise WeComServerConfigError("异步客户端请使用 async_get_bytes")
 
     def _post_json(
         self, url: str, params: dict[str, Any], json: dict[str, Any]
     ) -> dict[str, Any]:
-        raise ServerConfigError("异步客户端请使用 async_post_json")
+        raise WeComServerConfigError("异步客户端请使用 async_post_json")
 
     def _post_files(
         self, url: str, params: dict[str, Any], files: dict[str, Any]
     ) -> dict[str, Any]:
-        raise ServerConfigError("异步客户端请使用 async_post_files")
+        raise WeComServerConfigError("异步客户端请使用 async_post_files")
 
     async def async_get(self, url: str, params: dict[str, Any]) -> dict[str, Any]:
         try:
             response = await self._client.get(url, params=params)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"GET 请求失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"GET 请求失败: {exc}", exc) from exc
         return response.json()
 
     async def async_get_bytes(self, url: str, params: dict[str, Any]) -> bytes:
@@ -353,7 +353,7 @@ class AsyncWeComServerClient(_BaseServerClient):
             response = await self._client.get(url, params=params)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"GET 下载失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"GET 下载失败: {exc}", exc) from exc
         return response.content
 
     async def async_post_json(
@@ -363,7 +363,7 @@ class AsyncWeComServerClient(_BaseServerClient):
             response = await self._client.post(url, params=params, json=json)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"POST 请求失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"POST 请求失败: {exc}", exc) from exc
         return response.json()
 
     async def async_post_files(
@@ -373,5 +373,5 @@ class AsyncWeComServerClient(_BaseServerClient):
             response = await self._client.post(url, params=params, files=files)
             response.raise_for_status()
         except httpx.HTTPError as exc:
-            raise ServerNetworkError(f"文件上传失败: {exc}", exc) from exc
+            raise WeComServerNetworkError(f"文件上传失败: {exc}", exc) from exc
         return response.json()