@zhin.js/adapter-qq 1.0.75 → 1.0.76
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.
- package/CHANGELOG.md +10 -0
- package/package.json +8 -8
- package/skills/qq/SKILL.md +59 -27
package/CHANGELOG.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhin.js/adapter-qq",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.76",
|
|
4
4
|
"description": "Zhin.js adapter for QQ Official Bot",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./lib/index.js",
|
|
@@ -41,16 +41,16 @@
|
|
|
41
41
|
"@types/react-dom": "^19.2.1",
|
|
42
42
|
"lucide-react": "^1.11.0",
|
|
43
43
|
"typescript": "^6.0.3",
|
|
44
|
-
"@zhin.js/cli": "1.0.
|
|
45
|
-
"@zhin.js/console": "2.0.
|
|
46
|
-
"zhin.js": "1.0.
|
|
44
|
+
"@zhin.js/cli": "1.0.69",
|
|
45
|
+
"@zhin.js/console": "2.0.16",
|
|
46
|
+
"zhin.js": "1.0.73"
|
|
47
47
|
},
|
|
48
48
|
"peerDependencies": {
|
|
49
49
|
"@zhin.js/client": "1.0.18",
|
|
50
|
-
"@zhin.js/console": "2.0.
|
|
51
|
-
"@zhin.js/http": "1.0.
|
|
52
|
-
"
|
|
53
|
-
"zhin.js": "1.
|
|
50
|
+
"@zhin.js/console": "2.0.16",
|
|
51
|
+
"@zhin.js/http": "1.0.66",
|
|
52
|
+
"zhin.js": "1.0.73",
|
|
53
|
+
"@zhin.js/logger": "0.1.55"
|
|
54
54
|
},
|
|
55
55
|
"peerDependenciesMeta": {
|
|
56
56
|
"@zhin.js/client": {
|
package/skills/qq/SKILL.md
CHANGED
|
@@ -2,21 +2,26 @@
|
|
|
2
2
|
name: qq
|
|
3
3
|
platforms:
|
|
4
4
|
- qq
|
|
5
|
-
description:
|
|
5
|
+
description: >-
|
|
6
|
+
QQ 官方机器人管理能力。当用户在 QQ 官方机器人（非 OneBot/NapCat）中请求群管（踢人、
|
|
7
|
+
禁言、全员禁言）、频道/子频道管理、角色管理（创建/添加/移除角色）、
|
|
8
|
+
或查询成员详情时使用。即使用户没有明确提到 QQ 官方机器人，只要 Bot 平台是 qq
|
|
9
|
+
（官方 API）且涉及上述操作，就应触发。仅有昵称时先 list_members 查 user_id。
|
|
6
10
|
keywords:
|
|
7
11
|
- qq
|
|
8
12
|
- QQ
|
|
9
13
|
- adapter:qq
|
|
10
14
|
- 群管理
|
|
11
15
|
- 频道
|
|
16
|
+
- 子频道
|
|
12
17
|
- 角色
|
|
18
|
+
- 官方机器人
|
|
13
19
|
- list_members
|
|
14
20
|
tags:
|
|
15
21
|
- group
|
|
16
22
|
- management
|
|
17
23
|
- im
|
|
18
24
|
tools:
|
|
19
|
-
# 平台特有工具
|
|
20
25
|
- qq_list_guilds
|
|
21
26
|
- qq_list_channels
|
|
22
27
|
- qq_list_roles
|
|
@@ -25,7 +30,6 @@ tools:
|
|
|
25
30
|
- qq_remove_role
|
|
26
31
|
- qq_channel_info
|
|
27
32
|
- qq_member_detail
|
|
28
|
-
# 通用群管工具
|
|
29
33
|
- qq_kick_member
|
|
30
34
|
- qq_mute_member
|
|
31
35
|
- qq_mute_all
|
|
@@ -33,33 +37,61 @@ tools:
|
|
|
33
37
|
- qq_get_group_info
|
|
34
38
|
---
|
|
35
39
|
|
|
36
|
-
|
|
40
|
+
# QQ 官方机器人管理技能
|
|
37
41
|
|
|
38
|
-
|
|
42
|
+
QQ 官方机器人 API 同时支持「群聊」和「频道」两种场景，频道有 Guild/Channel 二级结构。
|
|
39
43
|
|
|
40
|
-
|
|
44
|
+
## 核心原则
|
|
45
|
+
|
|
46
|
+
### 群 vs 频道
|
|
47
|
+
|
|
48
|
+
QQ 官方机器人有两个独立的体系：
|
|
49
|
+
- **群聊**（Group）：传统 QQ 群，用 `group_id` 标识
|
|
50
|
+
- **频道**（Guild + Channel）：类似 Discord，Guild 是大频道，Channel 是子频道
|
|
51
|
+
|
|
52
|
+
操作前确认用户说的是「群」还是「频道」。
|
|
53
|
+
|
|
54
|
+
### 频道导航链
|
|
55
|
+
|
|
56
|
+
频道操作需要逐级获取 ID：
|
|
57
|
+
```
|
|
58
|
+
qq_list_guilds → 获取 guild_id
|
|
59
|
+
qq_list_channels(guild_id) → 获取 channel_id
|
|
60
|
+
qq_channel_info(channel_id) → 子频道详情
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## 工具分类
|
|
64
|
+
|
|
65
|
+
### 群聊管理
|
|
66
|
+
|
|
67
|
+
| 工具 | 用途 | 说明 |
|
|
68
|
+
|------|------|------|
|
|
69
|
+
| `qq_kick_member` | 踢出成员 | — |
|
|
70
|
+
| `qq_mute_member` | 禁言 | — |
|
|
71
|
+
| `qq_mute_all` | 全员禁言/解除 | — |
|
|
72
|
+
| `qq_list_members` | 成员列表 | — |
|
|
73
|
+
| `qq_get_group_info` | 群信息 | — |
|
|
74
|
+
|
|
75
|
+
### 频道管理
|
|
76
|
+
|
|
77
|
+
| 工具 | 用途 | 说明 |
|
|
41
78
|
|------|------|------|
|
|
42
|
-
| `qq_list_guilds` |
|
|
43
|
-
| `qq_list_channels` |
|
|
44
|
-
| `
|
|
45
|
-
| `
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
|
50
|
-
|
|
51
|
-
### 通用群管
|
|
52
|
-
|
|
53
|
-
| 工具 | 说明 | 权限 |
|
|
79
|
+
| `qq_list_guilds` | 频道列表 | 获取所有 Guild |
|
|
80
|
+
| `qq_list_channels` | 子频道列表 | 获取 Guild 下的 Channel |
|
|
81
|
+
| `qq_channel_info` | 子频道详情 | — |
|
|
82
|
+
| `qq_member_detail` | 成员详情 | — |
|
|
83
|
+
|
|
84
|
+
### 角色管理
|
|
85
|
+
|
|
86
|
+
| 工具 | 用途 | 说明 |
|
|
54
87
|
|------|------|------|
|
|
55
|
-
| `
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
| `
|
|
59
|
-
| `qq_get_group_info` | 获取群信息 | user |
|
|
88
|
+
| `qq_create_role` | 创建角色 | — |
|
|
89
|
+
| `qq_add_role` | 授予角色 | 需 role_id |
|
|
90
|
+
| `qq_remove_role` | 移除角色 | 需 role_id |
|
|
91
|
+
| `qq_list_roles` | 角色列表 | 获取所有角色及 ID |
|
|
60
92
|
|
|
61
|
-
##
|
|
93
|
+
## 易错点
|
|
62
94
|
|
|
63
|
-
1.
|
|
64
|
-
2.
|
|
65
|
-
3.
|
|
95
|
+
1. **频道操作需要 guild_id + channel_id 二级 ID**，不能只用一个。先 `list_guilds` 再 `list_channels`。
|
|
96
|
+
2. **角色操作需要 role_id**，先 `qq_list_roles` 查询。
|
|
97
|
+
3. **此适配器是 QQ 官方 API**，功能受限于官方开放的接口，不如 NapCat/ICQQ 灵活。
|