qqbotsdk-py 0.2.1__tar.gz → 2.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- qqbotsdk_py-2.0.0/PKG-INFO +54 -0
- qqbotsdk_py-2.0.0/README.md +42 -0
- qqbotsdk_py-2.0.0/pyproject.toml +22 -0
- qqbotsdk_py-2.0.0/pyproject.toml.orig +23 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/agent.md +54 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/bot.py +37 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/agent.md +29 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/blacklist.py +33 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/join_request.py +31 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/manage.py +70 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/messages.py +72 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/mute.py +27 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/group/strategy.py +79 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/interaction.py +15 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/media.py +139 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/menu.py +27 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/panel.py +79 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/api/user.py +89 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/__init__.py +83 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/agent.md +61 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/api.py +524 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/bot.py +259 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/context.py +242 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/dispatch.py +213 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/app/keyboard.py +380 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/agent.md +32 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/bot.py +67 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/event/__init__.py +115 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/event/agent.md +48 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/event/c2c.py +204 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/event/group.py +338 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/event/interaction.py +164 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/agent.md +35 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/blacklist.py +70 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/join_request.py +117 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/member.py +135 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/messages.py +126 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/mute.py +115 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/group/strategy.py +181 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/interaction.py +12 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/media.py +124 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/menu.py +94 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/panel.py +221 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/user/agent.md +32 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/user/messages.py +135 -0
- qqbotsdk_py-2.0.0/src/qqbotsdk/model/user/stream_messages.py +75 -0
- qqbotsdk_py-0.2.1/LICENSE +0 -21
- qqbotsdk_py-0.2.1/PKG-INFO +0 -136
- qqbotsdk_py-0.2.1/README.md +0 -107
- qqbotsdk_py-0.2.1/pyproject.toml +0 -116
- qqbotsdk_py-0.2.1/pyproject.toml.orig +0 -98
- qqbotsdk_py-0.2.1/src/qqbotsdk/__init__.py +0 -41
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/__init__.py +0 -39
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/audio.py +0 -45
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/channel.py +0 -175
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/core.py +0 -112
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/forum.py +0 -59
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/group.py +0 -265
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/guild.py +0 -369
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/panel.py +0 -137
- qqbotsdk_py-0.2.1/src/qqbotsdk/api/v2.py +0 -437
- qqbotsdk_py-0.2.1/src/qqbotsdk/bot.py +0 -144
- qqbotsdk_py-0.2.1/src/qqbotsdk/config.py +0 -59
- qqbotsdk_py-0.2.1/src/qqbotsdk/connecter.py +0 -345
- qqbotsdk_py-0.2.1/src/qqbotsdk/crypto.py +0 -41
- qqbotsdk_py-0.2.1/src/qqbotsdk/emitter.py +0 -173
- qqbotsdk_py-0.2.1/src/qqbotsdk/events.py +0 -55
- qqbotsdk_py-0.2.1/src/qqbotsdk/model.py +0 -103
- qqbotsdk_py-0.2.1/src/qqbotsdk/payloads.py +0 -431
- qqbotsdk_py-0.2.1/src/qqbotsdk/protocol.py +0 -24
- qqbotsdk_py-0.2.1/src/qqbotsdk/queue.py +0 -22
- qqbotsdk_py-0.2.1/src/qqbotsdk/session.py +0 -19
- qqbotsdk_py-0.2.1/src/qqbotsdk/token.py +0 -80
- qqbotsdk_py-0.2.1/src/qqbotsdk/webhook_protocol.py +0 -33
- qqbotsdk_py-0.2.1/src/qqbotsdk/ws_protocol.py +0 -125
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
Metadata-Version: 2.3
|
|
2
|
+
Name: qqbotsdk-py
|
|
3
|
+
Version: 2.0.0
|
|
4
|
+
Summary: QQ 官方机器人 SDK:群聊 / 单聊 / 素材 / 互动
|
|
5
|
+
Author: snowy-yang
|
|
6
|
+
Author-email: snowy-yang <102860110+snowy-yang@users.noreply.github.com>
|
|
7
|
+
Requires-Dist: qqbotsdk-base-py>=2.0.0
|
|
8
|
+
Requires-Dist: qqbotsdk-guild-py>=2.0.0 ; extra == 'guild'
|
|
9
|
+
Requires-Python: >=3.12
|
|
10
|
+
Provides-Extra: guild
|
|
11
|
+
Description-Content-Type: text/markdown
|
|
12
|
+
|
|
13
|
+
# qqbotsdk-py
|
|
14
|
+
|
|
15
|
+
QQ 官方机器人 SDK 核心包:群聊 / 单聊 / 素材 / 互动 / 菜单 / 面板,以及上层框架 `qqbotsdk.app`。
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
pip install qqbotsdk-py
|
|
19
|
+
pip install "qqbotsdk-py[guild]" # 额外安装频道域子包
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## 上层框架(推荐入口)
|
|
23
|
+
|
|
24
|
+
```python
|
|
25
|
+
from qqbotsdk.app import Bot, Context
|
|
26
|
+
|
|
27
|
+
bot = Bot()
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
@bot.on_message()
|
|
31
|
+
async def on_message(ctx: Context) -> None:
|
|
32
|
+
await ctx.reply(f"收到:{ctx.event.content}")
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
bot.run()
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
事件监听、分发、中间件、注入与快捷回复都在这一层,详见仓库根 `README.md`。
|
|
39
|
+
|
|
40
|
+
## API 层(薄映射)
|
|
41
|
+
|
|
42
|
+
`api/` 与 `model/` 是一对一的协议映射,一个接口一个函数,路径参数外置:
|
|
43
|
+
|
|
44
|
+
```python
|
|
45
|
+
from qqbotsdk.api.group.messages import send_group_messages
|
|
46
|
+
from qqbotsdk.model.group.messages import SendGroupMessagesRequest
|
|
47
|
+
|
|
48
|
+
await send_group_messages(
|
|
49
|
+
group_openid,
|
|
50
|
+
SendGroupMessagesRequest(msg_type=0, content="hi"),
|
|
51
|
+
)
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
错误统一为 `qqbotsdk.errors` 里的三级异常;429 自动重试;删除类接口返回空结果不抛异常。
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# qqbotsdk-py
|
|
2
|
+
|
|
3
|
+
QQ 官方机器人 SDK 核心包:群聊 / 单聊 / 素材 / 互动 / 菜单 / 面板,以及上层框架 `qqbotsdk.app`。
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
pip install qqbotsdk-py
|
|
7
|
+
pip install "qqbotsdk-py[guild]" # 额外安装频道域子包
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## 上层框架(推荐入口)
|
|
11
|
+
|
|
12
|
+
```python
|
|
13
|
+
from qqbotsdk.app import Bot, Context
|
|
14
|
+
|
|
15
|
+
bot = Bot()
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
@bot.on_message()
|
|
19
|
+
async def on_message(ctx: Context) -> None:
|
|
20
|
+
await ctx.reply(f"收到:{ctx.event.content}")
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
bot.run()
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
事件监听、分发、中间件、注入与快捷回复都在这一层,详见仓库根 `README.md`。
|
|
27
|
+
|
|
28
|
+
## API 层(薄映射)
|
|
29
|
+
|
|
30
|
+
`api/` 与 `model/` 是一对一的协议映射,一个接口一个函数,路径参数外置:
|
|
31
|
+
|
|
32
|
+
```python
|
|
33
|
+
from qqbotsdk.api.group.messages import send_group_messages
|
|
34
|
+
from qqbotsdk.model.group.messages import SendGroupMessagesRequest
|
|
35
|
+
|
|
36
|
+
await send_group_messages(
|
|
37
|
+
group_openid,
|
|
38
|
+
SendGroupMessagesRequest(msg_type=0, content="hi"),
|
|
39
|
+
)
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
错误统一为 `qqbotsdk.errors` 里的三级异常;429 自动重试;删除类接口返回空结果不抛异常。
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "qqbotsdk-py"
|
|
3
|
+
version = "2.0.0"
|
|
4
|
+
description = "QQ 官方机器人 SDK:群聊 / 单聊 / 素材 / 互动"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.12"
|
|
7
|
+
dependencies = ["qqbotsdk-base-py>=2.0.0"]
|
|
8
|
+
|
|
9
|
+
[[project.authors]]
|
|
10
|
+
name = "snowy-yang"
|
|
11
|
+
email = "102860110+snowy-yang@users.noreply.github.com"
|
|
12
|
+
|
|
13
|
+
[project.optional-dependencies]
|
|
14
|
+
guild = ["qqbotsdk-guild-py>=2.0.0"]
|
|
15
|
+
|
|
16
|
+
[build-system]
|
|
17
|
+
requires = ["uv_build>=0.13.5,<0.14.0"]
|
|
18
|
+
build-backend = "uv_build"
|
|
19
|
+
|
|
20
|
+
[tool.uv.build-backend]
|
|
21
|
+
module-name = "qqbotsdk"
|
|
22
|
+
namespace = true
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "qqbotsdk-py"
|
|
3
|
+
version = "2.0.0"
|
|
4
|
+
description = "QQ 官方机器人 SDK:群聊 / 单聊 / 素材 / 互动"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
authors = [
|
|
7
|
+
{ name = "snowy-yang", email = "102860110+snowy-yang@users.noreply.github.com" },
|
|
8
|
+
]
|
|
9
|
+
requires-python = ">=3.12"
|
|
10
|
+
dependencies = [
|
|
11
|
+
"qqbotsdk-base-py>=2.0.0",
|
|
12
|
+
]
|
|
13
|
+
|
|
14
|
+
[project.optional-dependencies]
|
|
15
|
+
guild = ["qqbotsdk-guild-py>=2.0.0"]
|
|
16
|
+
|
|
17
|
+
[build-system]
|
|
18
|
+
requires = ["uv_build>=0.13.5,<0.14.0"]
|
|
19
|
+
build-backend = "uv_build"
|
|
20
|
+
|
|
21
|
+
[tool.uv.build-backend]
|
|
22
|
+
module-name = "qqbotsdk"
|
|
23
|
+
namespace = true
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# agent.md — qqbotsdk/api(顶层接口映射)
|
|
2
|
+
|
|
3
|
+
适用范围:`packages/qqbotsdk/src/qqbotsdk/api/*.py`(`bot.py`、`interaction.py`、`media.py`、`menu.py`、`panel.py`、`user.py`)。
|
|
4
|
+
群聊接口见 `group/agent.md`。
|
|
5
|
+
|
|
6
|
+
凭证获取不在这里:统一用 `qqbotsdk.api.auth.get_access_token()`(`api/app.py` 的重复实现已删除)。
|
|
7
|
+
|
|
8
|
+
## MUST(必须做)
|
|
9
|
+
|
|
10
|
+
- MUST 用固定骨架写每个接口(路径参数在前、`payload` 在后、无响应体返回 `None`):
|
|
11
|
+
|
|
12
|
+
```python
|
|
13
|
+
async def update_panel(
|
|
14
|
+
panel_id: str,
|
|
15
|
+
payload: UpdatePanelRequest,
|
|
16
|
+
) -> UpdatePanelResponse:
|
|
17
|
+
async with session.put(
|
|
18
|
+
f"/v2/panels/{panel_id}",
|
|
19
|
+
json=payload.model_dump(exclude_none=True),
|
|
20
|
+
) as resp:
|
|
21
|
+
result = await resp.json()
|
|
22
|
+
|
|
23
|
+
return UpdatePanelResponse.model_validate(result)
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
- MUST 让查询参数走 `params=payload.model_dump(exclude_none=True)`,请求体走 `json=payload.model_dump(exclude_none=True)`。
|
|
27
|
+
- MUST 即使返回 `None` 也要 `await resp.json()`(或 `resp.read()`),确保连接被释放。
|
|
28
|
+
- MUST 用 `from qqbotsdk.api.core import session` 拿会话;鉴权、超时、base_url 都由它负责。
|
|
29
|
+
- MUST 让函数名与模型名一一对应:`get_panels` ↔ `GetPanelsRequest/GetPanelsResponse`。
|
|
30
|
+
|
|
31
|
+
## SHOULD(应当做)
|
|
32
|
+
|
|
33
|
+
- SHOULD 一个文件一个业务域,按官方文档分组;新增域时新建文件,而不是堆进已有文件。
|
|
34
|
+
- SHOULD 让 HTTP 方法贴合文档(`PUT` 用于整体替换、`PATCH` 用于局部更新),不要凭习惯改。
|
|
35
|
+
|
|
36
|
+
## MUST NOT(禁止做)
|
|
37
|
+
|
|
38
|
+
- MUST NOT 手写 `Authorization` 等鉴权头,也不要自建 `aiohttp.ClientSession`。
|
|
39
|
+
- MUST NOT 在接口函数里 `try/except` 吞异常、做重试、做 `sleep`、打印日志——错误让调用方处理。
|
|
40
|
+
- MUST NOT 做多接口编排(上传→发送→撤回这类流程由调用方组合)。
|
|
41
|
+
- MUST NOT 把路径参数塞进请求模型(如 `group_openid` 不进 `SendGroupMessagesRequest`)。
|
|
42
|
+
|
|
43
|
+
## 允许的例外
|
|
44
|
+
|
|
45
|
+
- `media.py`:素材上传需要在本地做格式/大小校验、MD5/SHA1 摘要与直传 COS,属既定例外;改动时保持「校验前移到 prepare、三步拆分(prepare/send/complete)」的结构。
|
|
46
|
+
- `media.send_media_image()` 走预签名绝对 URL,**不应**带鉴权头(`api/core.py` 已按域名过滤,别绕过它直接建会话)。
|
|
47
|
+
|
|
48
|
+
## 自检
|
|
49
|
+
|
|
50
|
+
```powershell
|
|
51
|
+
cd D:\QQBotSDK
|
|
52
|
+
.venv\Scripts\ruff.exe check packages\qqbotsdk\src\qqbotsdk\api
|
|
53
|
+
.venv\Scripts\pyright.exe
|
|
54
|
+
```
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.bot import (
|
|
3
|
+
GenerateUrlLinkRequest,
|
|
4
|
+
GenerateUrlLinkResponse,
|
|
5
|
+
GetGatewayResponse,
|
|
6
|
+
GetMeResponse,
|
|
7
|
+
)
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
async def get_gateway() -> GetGatewayResponse:
|
|
11
|
+
async with session.get(
|
|
12
|
+
"/gateway",
|
|
13
|
+
) as resp:
|
|
14
|
+
result = await resp.json()
|
|
15
|
+
|
|
16
|
+
return GetGatewayResponse.model_validate(result)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
async def get_me() -> GetMeResponse:
|
|
20
|
+
async with session.get(
|
|
21
|
+
"/users/@me",
|
|
22
|
+
) as resp:
|
|
23
|
+
result = await resp.json()
|
|
24
|
+
|
|
25
|
+
return GetMeResponse.model_validate(result)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
async def generate_url_link(
|
|
29
|
+
payload: GenerateUrlLinkRequest,
|
|
30
|
+
) -> GenerateUrlLinkResponse:
|
|
31
|
+
async with session.post(
|
|
32
|
+
"/v2/generate_url_link",
|
|
33
|
+
json=payload.model_dump(exclude_none=True),
|
|
34
|
+
) as resp:
|
|
35
|
+
result = await resp.json()
|
|
36
|
+
|
|
37
|
+
return GenerateUrlLinkResponse.model_validate(result)
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# agent.md — qqbotsdk/api/group(群聊与群管理接口)
|
|
2
|
+
|
|
3
|
+
适用范围:`packages/qqbotsdk/src/qqbotsdk/api/group/**`(`manage.py`、`messages.py`、`mute.py`、`blacklist.py`、`join_request.py`、`strategy.py`)。
|
|
4
|
+
|
|
5
|
+
## MUST(必须做)
|
|
6
|
+
|
|
7
|
+
- MUST 使用群域路径前缀 `/v2/groups/{group_openid}/...`,`group_openid` 一律作为第一个位置参数。
|
|
8
|
+
- MUST 严格照文档区分 `group_openid`(群)与 `member_openid`(群内成员):前者是路径前缀,后者只在需要时作路径参数。
|
|
9
|
+
- MUST 遵循顶层 `api/agent.md` 的骨架(`session` + `model_dump(exclude_none=True)` + `model_validate`)。
|
|
10
|
+
- MUST 对无响应体的接口(禁言设置、解除禁言、审批入群、删除策略等)返回 `None`,但仍要读取响应。
|
|
11
|
+
|
|
12
|
+
## SHOULD(应当做)
|
|
13
|
+
|
|
14
|
+
- SHOULD 按官方分组落文件:群信息/成员/机器人状态 → `manage.py`;群消息与富媒体 → `messages.py`;禁言 → `mute.py`;黑名单 → `blacklist.py`;入群审批 → `join_request.py`;自动审批策略 → `strategy.py`。
|
|
15
|
+
- SHOULD 让接口名体现群体语义:`get_group_members`、`remove_group_members`、`review_group_join_request`。
|
|
16
|
+
|
|
17
|
+
## MUST NOT(禁止做)
|
|
18
|
+
|
|
19
|
+
- MUST NOT 复用单聊路径 `/v2/users/{user_openid}/...` 的写法(两者 openid 不通用,单聊见 `../agent.md`)。
|
|
20
|
+
- MUST NOT 把 `/v2/groups/join_approval_strategy` 这类「不需要群 ID」的接口硬塞 `group_openid` 参数。
|
|
21
|
+
- MUST NOT 在群域接口里顺手改单聊或频道逻辑。
|
|
22
|
+
|
|
23
|
+
## 自检
|
|
24
|
+
|
|
25
|
+
```powershell
|
|
26
|
+
cd D:\QQBotSDK
|
|
27
|
+
.venv\Scripts\ruff.exe check packages\qqbotsdk\src\qqbotsdk\api\group
|
|
28
|
+
.venv\Scripts\pyright.exe
|
|
29
|
+
```
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.group.blacklist import (
|
|
3
|
+
GetGroupBlacklistRequest,
|
|
4
|
+
GetGroupBlacklistResponse,
|
|
5
|
+
UpdateGroupBlacklistRequest,
|
|
6
|
+
UpdateGroupBlacklistResponse,
|
|
7
|
+
)
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
async def get_group_blacklist(
|
|
11
|
+
group_openid: str,
|
|
12
|
+
payload: GetGroupBlacklistRequest,
|
|
13
|
+
) -> GetGroupBlacklistResponse:
|
|
14
|
+
async with session.get(
|
|
15
|
+
f"/v2/groups/{group_openid}/member_blacklist",
|
|
16
|
+
params=payload.model_dump(exclude_none=True),
|
|
17
|
+
) as resp:
|
|
18
|
+
result = await resp.json()
|
|
19
|
+
|
|
20
|
+
return GetGroupBlacklistResponse.model_validate(result)
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
async def update_group_blacklist(
|
|
24
|
+
group_openid: str,
|
|
25
|
+
payload: UpdateGroupBlacklistRequest,
|
|
26
|
+
) -> UpdateGroupBlacklistResponse:
|
|
27
|
+
async with session.post(
|
|
28
|
+
f"/v2/groups/{group_openid}/member_blacklist",
|
|
29
|
+
json=payload.model_dump(exclude_none=True),
|
|
30
|
+
) as resp:
|
|
31
|
+
result = await resp.json()
|
|
32
|
+
|
|
33
|
+
return UpdateGroupBlacklistResponse.model_validate(result)
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.group.join_request import (
|
|
3
|
+
GetGroupJoinRequestsRequest,
|
|
4
|
+
GetGroupJoinRequestsResponse,
|
|
5
|
+
ReviewGroupJoinRequest,
|
|
6
|
+
)
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
async def get_group_join_requests(
|
|
10
|
+
group_openid: str,
|
|
11
|
+
payload: GetGroupJoinRequestsRequest,
|
|
12
|
+
) -> GetGroupJoinRequestsResponse:
|
|
13
|
+
async with session.get(
|
|
14
|
+
f"/v2/groups/{group_openid}/join_request_list",
|
|
15
|
+
params=payload.model_dump(exclude_none=True),
|
|
16
|
+
) as resp:
|
|
17
|
+
result = await resp.json()
|
|
18
|
+
|
|
19
|
+
return GetGroupJoinRequestsResponse.model_validate(result)
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
async def review_group_join_request(
|
|
23
|
+
group_openid: str,
|
|
24
|
+
member_openid: str,
|
|
25
|
+
payload: ReviewGroupJoinRequest,
|
|
26
|
+
) -> None:
|
|
27
|
+
async with session.post(
|
|
28
|
+
f"/v2/groups/{group_openid}/approval_join_request/{member_openid}",
|
|
29
|
+
json=payload.model_dump(exclude_none=True),
|
|
30
|
+
) as resp:
|
|
31
|
+
await resp.json()
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.group.member import (
|
|
3
|
+
GetGroupBotStateResponse,
|
|
4
|
+
GetGroupInfoResponse,
|
|
5
|
+
GetGroupMemberResponse,
|
|
6
|
+
GetGroupMembersRequest,
|
|
7
|
+
GetGroupMembersResponse,
|
|
8
|
+
RemoveGroupMembersRequest,
|
|
9
|
+
RemoveGroupMembersResponse,
|
|
10
|
+
)
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
async def get_group_info(
|
|
14
|
+
group_openid: str,
|
|
15
|
+
) -> GetGroupInfoResponse:
|
|
16
|
+
async with session.get(
|
|
17
|
+
f"/v2/groups/{group_openid}/info",
|
|
18
|
+
) as resp:
|
|
19
|
+
result = await resp.json()
|
|
20
|
+
|
|
21
|
+
return GetGroupInfoResponse.model_validate(result)
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
async def get_group_members(
|
|
25
|
+
group_openid: str,
|
|
26
|
+
payload: GetGroupMembersRequest,
|
|
27
|
+
) -> GetGroupMembersResponse:
|
|
28
|
+
async with session.get(
|
|
29
|
+
f"/v2/groups/{group_openid}/members",
|
|
30
|
+
params=payload.model_dump(exclude_none=True),
|
|
31
|
+
) as resp:
|
|
32
|
+
result = await resp.json()
|
|
33
|
+
|
|
34
|
+
return GetGroupMembersResponse.model_validate(result)
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
async def get_group_member(
|
|
38
|
+
group_openid: str,
|
|
39
|
+
member_openid: str,
|
|
40
|
+
) -> GetGroupMemberResponse:
|
|
41
|
+
async with session.get(
|
|
42
|
+
f"/v2/groups/{group_openid}/members/{member_openid}",
|
|
43
|
+
) as resp:
|
|
44
|
+
result = await resp.json()
|
|
45
|
+
|
|
46
|
+
return GetGroupMemberResponse.model_validate(result)
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
async def get_group_bot_state(
|
|
50
|
+
group_openid: str,
|
|
51
|
+
) -> GetGroupBotStateResponse:
|
|
52
|
+
async with session.get(
|
|
53
|
+
f"/v2/groups/{group_openid}/bot_state",
|
|
54
|
+
) as resp:
|
|
55
|
+
result = await resp.json()
|
|
56
|
+
|
|
57
|
+
return GetGroupBotStateResponse.model_validate(result)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
async def remove_group_members(
|
|
61
|
+
group_openid: str,
|
|
62
|
+
payload: RemoveGroupMembersRequest,
|
|
63
|
+
) -> RemoveGroupMembersResponse:
|
|
64
|
+
async with session.post(
|
|
65
|
+
f"/v2/groups/{group_openid}/batch_remove_members",
|
|
66
|
+
json=payload.model_dump(exclude_none=True),
|
|
67
|
+
) as resp:
|
|
68
|
+
result = await resp.json()
|
|
69
|
+
|
|
70
|
+
return RemoveGroupMembersResponse.model_validate(result)
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.group.messages import (
|
|
3
|
+
PrepareGroupUploadResponse,
|
|
4
|
+
SendGroupMessagesRequest,
|
|
5
|
+
SendGroupMessagesResponse,
|
|
6
|
+
UploadGroupFileRequest,
|
|
7
|
+
UploadGroupFileResponse,
|
|
8
|
+
)
|
|
9
|
+
from qqbotsdk.model.sub.upload import (
|
|
10
|
+
UploadPartFinishRequest,
|
|
11
|
+
UploadPrepareRequest,
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
async def send_group_messages(
|
|
16
|
+
group_openid: str,
|
|
17
|
+
payload: SendGroupMessagesRequest,
|
|
18
|
+
) -> SendGroupMessagesResponse:
|
|
19
|
+
async with session.post(
|
|
20
|
+
f"/v2/groups/{group_openid}/messages",
|
|
21
|
+
json=payload.model_dump(exclude_none=True),
|
|
22
|
+
) as resp:
|
|
23
|
+
result = await resp.json()
|
|
24
|
+
|
|
25
|
+
return SendGroupMessagesResponse.model_validate(result)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
async def recall_group_messages(
|
|
29
|
+
group_openid: str,
|
|
30
|
+
message_id: str,
|
|
31
|
+
) -> None:
|
|
32
|
+
async with session.delete(
|
|
33
|
+
f"/v2/groups/{group_openid}/messages/{message_id}",
|
|
34
|
+
) as resp:
|
|
35
|
+
await resp.json()
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
async def upload_group_file(
|
|
39
|
+
group_openid: str,
|
|
40
|
+
payload: UploadGroupFileRequest,
|
|
41
|
+
) -> UploadGroupFileResponse:
|
|
42
|
+
async with session.post(
|
|
43
|
+
f"/v2/groups/{group_openid}/files",
|
|
44
|
+
json=payload.model_dump(exclude_none=True),
|
|
45
|
+
) as resp:
|
|
46
|
+
result = await resp.json()
|
|
47
|
+
|
|
48
|
+
return UploadGroupFileResponse.model_validate(result)
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
async def prepare_group_upload(
|
|
52
|
+
group_openid: str,
|
|
53
|
+
payload: UploadPrepareRequest,
|
|
54
|
+
) -> PrepareGroupUploadResponse:
|
|
55
|
+
async with session.post(
|
|
56
|
+
f"/v2/groups/{group_openid}/upload_prepare",
|
|
57
|
+
json=payload.model_dump(exclude_none=True),
|
|
58
|
+
) as resp:
|
|
59
|
+
result = await resp.json()
|
|
60
|
+
|
|
61
|
+
return PrepareGroupUploadResponse.model_validate(result)
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
async def finish_group_upload_part(
|
|
65
|
+
group_openid: str,
|
|
66
|
+
payload: UploadPartFinishRequest,
|
|
67
|
+
) -> None:
|
|
68
|
+
async with session.post(
|
|
69
|
+
f"/v2/groups/{group_openid}/upload_part_finish",
|
|
70
|
+
json=payload.model_dump(exclude_none=True),
|
|
71
|
+
) as resp:
|
|
72
|
+
await resp.json()
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.group.mute import (
|
|
3
|
+
GetGroupMuteStateResponse,
|
|
4
|
+
SetGroupMuteStateRequest,
|
|
5
|
+
)
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
async def get_group_mute_state(
|
|
9
|
+
group_openid: str,
|
|
10
|
+
) -> GetGroupMuteStateResponse:
|
|
11
|
+
async with session.get(
|
|
12
|
+
f"/v2/groups/{group_openid}/restrict_chat_setting",
|
|
13
|
+
) as resp:
|
|
14
|
+
result = await resp.json()
|
|
15
|
+
|
|
16
|
+
return GetGroupMuteStateResponse.model_validate(result)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
async def set_group_mute_state(
|
|
20
|
+
group_openid: str,
|
|
21
|
+
payload: SetGroupMuteStateRequest,
|
|
22
|
+
) -> None:
|
|
23
|
+
async with session.post(
|
|
24
|
+
f"/v2/groups/{group_openid}/restrict_chat_setting",
|
|
25
|
+
json=payload.model_dump(exclude_none=True),
|
|
26
|
+
) as resp:
|
|
27
|
+
await resp.json()
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.group.strategy import (
|
|
3
|
+
CreateJoinApprovalStrategyRequest,
|
|
4
|
+
CreateJoinApprovalStrategyResponse,
|
|
5
|
+
GetJoinApprovalStrategiesRequest,
|
|
6
|
+
GetJoinApprovalStrategiesResponse,
|
|
7
|
+
UpdateJoinApprovalStrategyRequest,
|
|
8
|
+
UpdateJoinApprovalStrategyResponse,
|
|
9
|
+
UpdateWhitelistUsersRequest,
|
|
10
|
+
UpdateWhitelistUsersResponse,
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
async def get_join_approval_strategies(
|
|
15
|
+
payload: GetJoinApprovalStrategiesRequest,
|
|
16
|
+
) -> GetJoinApprovalStrategiesResponse:
|
|
17
|
+
async with session.get(
|
|
18
|
+
"/v2/groups/join_approval_strategy",
|
|
19
|
+
params=payload.model_dump(exclude_none=True),
|
|
20
|
+
) as resp:
|
|
21
|
+
result = await resp.json()
|
|
22
|
+
|
|
23
|
+
return GetJoinApprovalStrategiesResponse.model_validate(result)
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
async def create_join_approval_strategy(
|
|
27
|
+
payload: CreateJoinApprovalStrategyRequest,
|
|
28
|
+
) -> CreateJoinApprovalStrategyResponse:
|
|
29
|
+
async with session.post(
|
|
30
|
+
"/v2/groups/join_approval_strategy",
|
|
31
|
+
json=payload.model_dump(exclude_none=True),
|
|
32
|
+
) as resp:
|
|
33
|
+
result = await resp.json()
|
|
34
|
+
|
|
35
|
+
return CreateJoinApprovalStrategyResponse.model_validate(result)
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
async def update_join_approval_strategy(
|
|
39
|
+
strategy_id: str,
|
|
40
|
+
payload: UpdateJoinApprovalStrategyRequest,
|
|
41
|
+
) -> UpdateJoinApprovalStrategyResponse:
|
|
42
|
+
async with session.patch(
|
|
43
|
+
f"/v2/groups/join_approval_strategy/{strategy_id}",
|
|
44
|
+
json=payload.model_dump(exclude_none=True),
|
|
45
|
+
) as resp:
|
|
46
|
+
result = await resp.json()
|
|
47
|
+
|
|
48
|
+
return UpdateJoinApprovalStrategyResponse.model_validate(result)
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
async def delete_join_approval_strategy(
|
|
52
|
+
strategy_id: str,
|
|
53
|
+
) -> None:
|
|
54
|
+
async with session.delete(
|
|
55
|
+
f"/v2/groups/join_approval_strategy/{strategy_id}",
|
|
56
|
+
) as resp:
|
|
57
|
+
await resp.json()
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
async def execute_join_approval_strategy(
|
|
61
|
+
strategy_id: str,
|
|
62
|
+
) -> None:
|
|
63
|
+
async with session.post(
|
|
64
|
+
f"/v2/groups/join_approval_strategy/{strategy_id}/execute",
|
|
65
|
+
) as resp:
|
|
66
|
+
await resp.json()
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
async def update_join_approval_strategy_whitelist(
|
|
70
|
+
strategy_id: str,
|
|
71
|
+
payload: UpdateWhitelistUsersRequest,
|
|
72
|
+
) -> UpdateWhitelistUsersResponse:
|
|
73
|
+
async with session.post(
|
|
74
|
+
f"/v2/groups/join_approval_strategy/{strategy_id}/whitelist_users",
|
|
75
|
+
json=payload.model_dump(exclude_none=True),
|
|
76
|
+
) as resp:
|
|
77
|
+
result = await resp.json()
|
|
78
|
+
|
|
79
|
+
return UpdateWhitelistUsersResponse.model_validate(result)
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from qqbotsdk.api.core import session
|
|
2
|
+
from qqbotsdk.model.interaction import (
|
|
3
|
+
ConfirmInteractionsRequest,
|
|
4
|
+
)
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
async def confirm_interactions(
|
|
8
|
+
interaction_id: str,
|
|
9
|
+
payload: ConfirmInteractionsRequest,
|
|
10
|
+
) -> None:
|
|
11
|
+
async with session.put(
|
|
12
|
+
f"/interactions/{interaction_id}",
|
|
13
|
+
json=payload.model_dump(exclude_none=True),
|
|
14
|
+
) as resp:
|
|
15
|
+
await resp.json()
|