qqbotsdk-py 0.1.0__tar.gz

qqbotsdk_py-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 snowy-yang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qqbotsdk_py-0.1.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: qqbotsdk-py
+Version: 0.1.0
+Summary: QQ 官方机器人 Python SDK（WebSocket / Webhook）
+Keywords: qq,qqbot,bot,sdk,websocket,webhook,机器人
+Author: snowy-yang
+Author-email: snowy-yang <102860110+snowy-yang@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: aiohttp>=3.14.3
+Requires-Dist: cryptography>=50.0.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: python-dotenv>=1.2.3
+Requires-Dist: ujson>=6.0.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/snowy-yang/qqbotsdk
+Project-URL: Repository, https://github.com/snowy-yang/qqbotsdk
+Project-URL: Changelog, https://github.com/snowy-yang/qqbotsdk/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# qqbotsdk
+
+QQ 官方机器人 Python SDK（Python 3.12+ / asyncio / aiohttp），支持 WebSocket 与 Webhook 两种接入方式。
+
+**📖 在线文档：<https://qqbotsdk.4i.hk/>**
+
+[使用指南](docs/GUIDE.md) · [API 参考](docs/API.md) · [架构](docs/ARCHITECTURE.md) · [示例](examples/) · [更新日志](CHANGELOG.md)
+
+## 架构
+
+```mermaid
+flowchart TB
+    subgraph 接入层
+        WS["WebsocketConnecter（ws 长连接 / 重连 / 心跳看门狗）"]
+        WH["WebhookConnecter（http 回调 / 验签 / 去重）"]
+    end
+    subgraph 协议层
+        WSP["WebsocketProtocol（握手 / 会话 / 序列号）"]
+        WHP["WebhookProtocol（op=13 验证应答）"]
+    end
+    subgraph 分发层
+        Q[("EventQueue<br/>业务事件 op=0")]
+        EE["EventEmitter（路由 / 参数注入 / 异常隔离）"]
+    end
+    subgraph 业务层
+        API["BotApi（REST + ApiError）"]
+        USER["用户 handler @ee.on(...)"]
+    end
+    QQ["QQ 开放平台"]
+
+    WS -. "逐帧 on_frame" .-> WSP
+    WH -. "op=13 逐帧 on_frame" .-> WHP
+    WS -->|"业务事件"| Q
+    WH -->|"业务事件"| Q
+    Q --> EE
+    EE --> USER
+    USER --> API
+    API --> QQ
+    WS --> QQ
+```
+
+组件在 `run_loop` 中显式装配，依赖关系与设计决策详见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
+
+## 特性
+
+- 断线自动重连（指数退避 + 心跳看门狗），重连时自动 RESUME 续传
+- Webhook 接入自带 Ed25519 验签、op=13 验证应答与事件去重
+- 事件订阅由项目根目录的 `intents.toml` 按大类开关
+- Markdown 与内嵌按钮一等支持，`respond_interaction()` 回应按钮回调
+- 组件显式装配（无全局单例），全 SDK 共享一个 HTTP 连接池
+
+## 配置
+
+`.env`（`APPID`/`APPSECRET` 必填，缺失启动即报错）：
+
+```ini
+APPID=你的AppID
+APPSECRET=你的AppSecret
+BASE_URL=https://api.bot.qq.com   # 可选
+TIMEOUT=5000                      # 可选，毫秒
+CONNECTER=websocket               # websocket 或 webhook
+
+# 仅 webhook 接入时
+WEBHOOK_HOST=0.0.0.0
+WEBHOOK_PORT=8080
+WEBHOOK_PATH=/qqbot/webhook
+```
+
+## 使用
+
+```python
+from qqbotsdk import EventEmitter, main
+from qqbotsdk.payloads import GroupAtMessage
+from qqbotsdk.api import BotApi
+
+ee = EventEmitter()
+
+# handler 形参按标注注入 payload 与 BotApi 等组件
+@ee.on("GROUP_AT_MESSAGE_CREATE")
+async def on_group_message(msg: GroupAtMessage, api: BotApi):
+    # 被动回复带 msg_id；多次回复递增 msg_seq；失败抛 ApiError
+    await api.post_group_message(
+        msg.group_openid,
+        content=f"你说：{msg.content}",
+        msg_id=msg.id,
+    )
+
+if __name__ == "__main__":
+    main(ee)
+```
+
+运行：
+
+```bash
+uv run python main.py
+```
+
+Webhook 接入：`.env` 中 `CONNECTER` 改为 `webhook`，再把回调地址配置到 QQ 开放平台（仅支持 80/443/8080/8443 端口，需公网 HTTPS）。
+
+完整示例见 [examples/](examples/)，更多写法见[使用指南](docs/GUIDE.md)。
+
+## 开发
+
+```bash
+uv run pytest    # 单元测试
+uv run ruff check src tests examples && uv run pyright
+```
+
+推送与 Pull Request 由 GitHub Actions 自动执行同样的检查（[.github/workflows/ci.yml](.github/workflows/ci.yml)）。
+
+文档站点基于 [docsify](https://docsify.js.org/)，文档变更时自动发布（[.github/workflows/deploy-docs.yml](.github/workflows/deploy-docs.yml)）；本地预览：
+
+```bash
+npx docsify-cli serve
+```
+
+## 待完善
+
+- 更多 OpenAPI 封装（按需在 `api.py` 的 `BotApi` 上加薄封装即可）

qqbotsdk_py-0.1.0/README.md

@@ -0,0 +1,119 @@
+# qqbotsdk
+
+QQ 官方机器人 Python SDK（Python 3.12+ / asyncio / aiohttp），支持 WebSocket 与 Webhook 两种接入方式。
+
+**📖 在线文档：<https://qqbotsdk.4i.hk/>**
+
+[使用指南](docs/GUIDE.md) · [API 参考](docs/API.md) · [架构](docs/ARCHITECTURE.md) · [示例](examples/) · [更新日志](CHANGELOG.md)
+
+## 架构
+
+```mermaid
+flowchart TB
+    subgraph 接入层
+        WS["WebsocketConnecter（ws 长连接 / 重连 / 心跳看门狗）"]
+        WH["WebhookConnecter（http 回调 / 验签 / 去重）"]
+    end
+    subgraph 协议层
+        WSP["WebsocketProtocol（握手 / 会话 / 序列号）"]
+        WHP["WebhookProtocol（op=13 验证应答）"]
+    end
+    subgraph 分发层
+        Q[("EventQueue<br/>业务事件 op=0")]
+        EE["EventEmitter（路由 / 参数注入 / 异常隔离）"]
+    end
+    subgraph 业务层
+        API["BotApi（REST + ApiError）"]
+        USER["用户 handler @ee.on(...)"]
+    end
+    QQ["QQ 开放平台"]
+
+    WS -. "逐帧 on_frame" .-> WSP
+    WH -. "op=13 逐帧 on_frame" .-> WHP
+    WS -->|"业务事件"| Q
+    WH -->|"业务事件"| Q
+    Q --> EE
+    EE --> USER
+    USER --> API
+    API --> QQ
+    WS --> QQ
+```
+
+组件在 `run_loop` 中显式装配，依赖关系与设计决策详见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
+
+## 特性
+
+- 断线自动重连（指数退避 + 心跳看门狗），重连时自动 RESUME 续传
+- Webhook 接入自带 Ed25519 验签、op=13 验证应答与事件去重
+- 事件订阅由项目根目录的 `intents.toml` 按大类开关
+- Markdown 与内嵌按钮一等支持，`respond_interaction()` 回应按钮回调
+- 组件显式装配（无全局单例），全 SDK 共享一个 HTTP 连接池
+
+## 配置
+
+`.env`（`APPID`/`APPSECRET` 必填，缺失启动即报错）：
+
+```ini
+APPID=你的AppID
+APPSECRET=你的AppSecret
+BASE_URL=https://api.bot.qq.com   # 可选
+TIMEOUT=5000                      # 可选，毫秒
+CONNECTER=websocket               # websocket 或 webhook
+
+# 仅 webhook 接入时
+WEBHOOK_HOST=0.0.0.0
+WEBHOOK_PORT=8080
+WEBHOOK_PATH=/qqbot/webhook
+```
+
+## 使用
+
+```python
+from qqbotsdk import EventEmitter, main
+from qqbotsdk.payloads import GroupAtMessage
+from qqbotsdk.api import BotApi
+
+ee = EventEmitter()
+
+# handler 形参按标注注入 payload 与 BotApi 等组件
+@ee.on("GROUP_AT_MESSAGE_CREATE")
+async def on_group_message(msg: GroupAtMessage, api: BotApi):
+    # 被动回复带 msg_id；多次回复递增 msg_seq；失败抛 ApiError
+    await api.post_group_message(
+        msg.group_openid,
+        content=f"你说：{msg.content}",
+        msg_id=msg.id,
+    )
+
+if __name__ == "__main__":
+    main(ee)
+```
+
+运行：
+
+```bash
+uv run python main.py
+```
+
+Webhook 接入：`.env` 中 `CONNECTER` 改为 `webhook`，再把回调地址配置到 QQ 开放平台（仅支持 80/443/8080/8443 端口，需公网 HTTPS）。
+
+完整示例见 [examples/](examples/)，更多写法见[使用指南](docs/GUIDE.md)。
+
+## 开发
+
+```bash
+uv run pytest    # 单元测试
+uv run ruff check src tests examples && uv run pyright
+```
+
+推送与 Pull Request 由 GitHub Actions 自动执行同样的检查（[.github/workflows/ci.yml](.github/workflows/ci.yml)）。
+
+文档站点基于 [docsify](https://docsify.js.org/)，文档变更时自动发布（[.github/workflows/deploy-docs.yml](.github/workflows/deploy-docs.yml)）；本地预览：
+
+```bash
+npx docsify-cli serve
+```
+
+## 待完善
+
+- 更多 OpenAPI 封装（按需在 `api.py` 的 `BotApi` 上加薄封装即可）

qqbotsdk_py-0.1.0/pyproject.toml

@@ -0,0 +1,118 @@
+[project]
+name = "qqbotsdk-py"
+version = "0.1.0"
+description = "QQ 官方机器人 Python SDK（WebSocket / Webhook）"
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+keywords = [
+    "qq",
+    "qqbot",
+    "bot",
+    "sdk",
+    "websocket",
+    "webhook",
+    "机器人",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: Chinese (Simplified)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "aiohttp>=3.14.3",
+    "cryptography>=50.0.1",
+    "loguru>=0.7.3",
+    "python-dotenv>=1.2.3",
+    "ujson>=6.0.0",
+]
+
+[[project.authors]]
+name = "snowy-yang"
+email = "102860110+snowy-yang@users.noreply.github.com"
+
+[project.urls]
+Homepage = "https://github.com/snowy-yang/qqbotsdk"
+Repository = "https://github.com/snowy-yang/qqbotsdk"
+Changelog = "https://github.com/snowy-yang/qqbotsdk/blob/main/CHANGELOG.md"
+
+[project.scripts]
+qqbotsdk = "qqbotsdk:main"
+
+[build-system]
+requires = ["uv_build>=0.12.7,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "qqbotsdk"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+indent-width = 4
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "N",
+    "W",
+    "UP",
+    "B",
+    "C4",
+    "SIM",
+]
+ignore = [
+    "E501",
+    "B008",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["qqbotsdk"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["S"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.pyright]
+typeCheckingMode = "standard"
+pythonVersion = "3.12"
+include = ["src"]
+exclude = [
+    "**/__pycache__",
+    "**/.*",
+    "**/node_modules",
+    ".venv",
+]
+reportMissingImports = true
+reportMissingTypeStubs = false
+reportUnknownParameterType = false
+reportUnknownVariableType = false
+reportUnknownMemberType = false
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.411",
+    "pytest>=8.3.0",
+    "pytest-asyncio>=0.24.0",
+    "ruff>=0.16.5",
+]

qqbotsdk_py-0.1.0/pyproject.toml.orig

@@ -0,0 +1,100 @@
+[project]
+name = "qqbotsdk-py"
+version = "0.1.0"
+description = "QQ 官方机器人 Python SDK（WebSocket / Webhook）"
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+authors = [
+    { name = "snowy-yang", email = "102860110+snowy-yang@users.noreply.github.com" },
+]
+keywords = ["qq", "qqbot", "bot", "sdk", "websocket", "webhook", "机器人"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: Chinese (Simplified)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "aiohttp>=3.14.3",
+    "cryptography>=50.0.1",
+    "loguru>=0.7.3",
+    "python-dotenv>=1.2.3",
+    "ujson>=6.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/snowy-yang/qqbotsdk"
+Repository = "https://github.com/snowy-yang/qqbotsdk"
+Changelog = "https://github.com/snowy-yang/qqbotsdk/blob/main/CHANGELOG.md"
+
+[project.scripts]
+qqbotsdk = "qqbotsdk:main"
+
+[build-system]
+requires = ["uv_build>=0.12.7,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "qqbotsdk"
+
+[dependency-groups]
+dev = ["pyright>=1.1.411", "pytest>=8.3.0", "pytest-asyncio>=0.24.0", "ruff>=0.16.5"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+indent-width = 4
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "F",   # Pyflakes
+    "I",   # isort
+    "N",   # pep8-naming
+    "W",   # pycodestyle warnings
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "SIM", # flake8-simplify
+]
+ignore = [
+    "E501", # line too long
+    "B008", # do not perform function calls in argument defaults
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.isort]
+known-first-party = ["qqbotsdk"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["S"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.pyright]
+typeCheckingMode = "standard"
+pythonVersion = "3.12"
+include = ["src"]
+exclude = ["**/__pycache__", "**/.*", "**/node_modules", ".venv"]
+reportMissingImports = true
+reportMissingTypeStubs = false
+reportUnknownParameterType = false
+reportUnknownVariableType = false
+reportUnknownMemberType = false

qqbotsdk_py-0.1.0/src/qqbotsdk/__init__.py

@@ -0,0 +1,83 @@
+"""qqbotsdk：QQ 官方机器人 SDK 入口。
+
+用法：构造 `EventEmitter()` 注册 handler，交给 `main(ee)`
+启动；连接方式由 .env 的 CONNECTER 决定（websocket / webhook）。
+架构详情见 docs/ARCHITECTURE.md。
+"""
+
+import asyncio
+
+from aiohttp import ClientSession
+from dotenv import load_dotenv
+from loguru import logger
+
+from .api import BotApi
+from .config import Config
+from .connecter import Connecter as Connecter
+from .connecter import WebhookConnecter, WebsocketConnecter
+from .emitter import EventEmitter as EventEmitter
+from .protocol import BaseProtocol as BaseProtocol
+from .queue import EventQueue as EventQueue
+from .session import Session
+from .token import AccessToken
+from .webhook_protocol import WebhookProtocol
+from .ws_protocol import WebsocketProtocol
+
+load_dotenv()
+
+
+async def run_loop(emitter: EventEmitter | None = None) -> None:
+    """启动 SDK。可传入外部构造的 EventEmitter 以注册 handler；不传时自建。
+
+    全部组件在此显式装配，并按类型登记到 emitter.services 供 handler
+    参数注入；共享的 HTTP 连接池随 run_loop 结束释放。
+    """
+    if emitter is None:
+        emitter = EventEmitter()
+
+    config = Config.load()
+    http = ClientSession(timeout=config.timeout)
+    session = Session()
+    token = AccessToken(config, http)
+    api = BotApi(config, http, token)
+    emitter.services.update(
+        {
+            EventEmitter: emitter,
+            EventQueue: emitter.queue,
+            Config: config,
+            Session: session,
+            ClientSession: http,
+            AccessToken: token,
+            BotApi: api,
+        }
+    )
+
+    # 各接入方式配自己的协议处理器：协议帧由适配器就近处理，只有业务事件
+    # （op=0）入队交给 emitter 分发（见 protocol.py / connecter.py）
+    match config.connecter:
+        case "websocket":
+            protocol = WebsocketProtocol(config, session, token)
+            connecter = WebsocketConnecter(
+                config, http, token, session, emitter.queue, protocol
+            )
+        case "webhook":
+            protocol = WebhookProtocol(config)
+            connecter = WebhookConnecter(config, emitter.queue, protocol)
+        case unknown:
+            raise ValueError(f"未知的 CONNECTER: {unknown}")
+
+    logger.info(f"qqbotsdk 启动，连接方式: {config.connecter}")
+    try:
+        await asyncio.gather(emitter.dispatch(), connecter.run())
+    finally:
+        # 在飞的后台 handler 先于连接池收尾，避免用到已关闭的 ClientSession
+        await emitter.close()
+        # 全 SDK 共享一个连接池，统一在此释放
+        await http.close()
+
+
+def main(emitter: EventEmitter | None = None) -> None:
+    try:
+        asyncio.run(run_loop(emitter))
+    except KeyboardInterrupt:
+        logger.info("qqbotsdk 已退出")

qqbotsdk_py-0.1.0/src/qqbotsdk/api/__init__.py

@@ -0,0 +1,39 @@
+"""OpenAPI 客户端：BotApi 按域组合——v2 群/单聊、频道消息、频道管理、
+指令面板（斜线指令）与全局菜单、群管理、音频、论坛。
+
+各域模块是方法集（继承 BaseApi 共享请求内核：鉴权头注入、429 自动
+重试、401 刷新 token 重试、统一 ApiError），方法名与拆分前完全一致。
+"""
+
+from .audio import AudioApi
+from .channel import ChannelApi
+from .core import ApiError
+from .core import BaseApi as BaseApi
+from .forum import ForumApi
+from .group import GroupApi
+from .guild import GuildApi
+from .panel import PanelApi
+from .v2 import V2Api, button, keyboard
+
+
+class BotApi(V2Api, ChannelApi, GuildApi, PanelApi, GroupApi, AudioApi, ForumApi):
+    """通用 REST 封装；具体业务接口见各域方法集。
+
+    BaseApi（请求内核）经域方法集继承自然落在 MRO 末尾，
+    构造签名 (config, http, token) 由它提供。
+    """
+
+
+__all__ = [
+    "ApiError",
+    "AudioApi",
+    "BotApi",
+    "ChannelApi",
+    "ForumApi",
+    "GroupApi",
+    "GuildApi",
+    "PanelApi",
+    "V2Api",
+    "button",
+    "keyboard",
+]

qqbotsdk_py-0.1.0/src/qqbotsdk/api/audio.py

@@ -0,0 +1,45 @@
+"""音频方法集（仅音频类机器人）：子频道播放控制与上/下麦。
+
+需联系平台开通权限后调用；控制与上/下麦均触发 AUDIO_ACTION 事件。
+"""
+
+from typing import Any
+
+from .core import BaseApi
+
+# 播放状态（AudioControl.status）
+AUDIO_STATUS_START = 0
+AUDIO_STATUS_PAUSE = 1
+AUDIO_STATUS_RESUME = 2
+AUDIO_STATUS_STOP = 3
+
+
+class AudioApi(BaseApi):
+    """音频方法集；请求内核（鉴权/重试/错误）由 BaseApi 提供。"""
+
+    async def control_channel_audio(
+        self,
+        channel_id: str,
+        audio_url: str | None = None,
+        text: str | None = None,
+        status: int = AUDIO_STATUS_START,
+    ) -> dict:
+        """控制子频道音频播放（POST /channels/{channel_id}/audio）。
+
+        status 为 START/PAUSE/RESUME/STOP（AUDIO_STATUS_* 常量）；
+        audio_url 与状态文本 text 仅 START 时传。
+        """
+        body: dict[str, Any] = {"status": status}
+        if audio_url is not None:
+            body["audio_url"] = audio_url
+        if text is not None:
+            body["text"] = text
+        return await self.post(f"/channels/{channel_id}/audio", json=body)
+
+    async def put_channel_mic(self, channel_id: str) -> dict:
+        """机器人上麦（PUT /channels/{channel_id}/mic）。"""
+        return await self.put(f"/channels/{channel_id}/mic")
+
+    async def delete_channel_mic(self, channel_id: str) -> dict:
+        """机器人下麦（DELETE /channels/{channel_id}/mic）。"""
+        return await self.delete(f"/channels/{channel_id}/mic")