@zhin.js/adapter-milky 0.0.22 → 0.0.24

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zhin.js/adapter-milky",
3
- "version": "0.0.22",
3
+ "version": "0.0.24",
4
4
  "description": "Zhin.js adapter for Milky protocol",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",
@@ -44,13 +44,13 @@
44
44
  "@types/node": "^25.6.0",
45
45
  "@types/ws": "^8.18.1",
46
46
  "typescript": "^6.0.3",
47
- "@zhin.js/cli": "1.0.68",
47
+ "@zhin.js/cli": "1.0.70",
48
48
  "@zhin.js/client": "1.0.18",
49
- "zhin.js": "1.0.72"
49
+ "zhin.js": "1.0.74"
50
50
  },
51
51
  "peerDependencies": {
52
- "@zhin.js/http": "1.0.65",
53
- "zhin.js": "1.0.72"
52
+ "@zhin.js/http": "1.0.67",
53
+ "zhin.js": "1.0.74"
54
54
  },
55
55
  "peerDependenciesMeta": {
56
56
  "@zhin.js/http": {
@@ -2,11 +2,17 @@
2
2
  name: milky
3
3
  platforms:
4
4
  - milky
5
- description: Milky 协议群管理:踢人、禁言、全员禁言、设管理员、改昵称/群名、查成员/群信息。
5
+ description: >-
6
+ Milky 协议群管理能力。当用户在 Milky 协议的 QQ 群中请求踢人、禁言、设管理员、
7
+ 改名片/群名或查成员/群信息时使用。即使用户没有提到 Milky,只要 Bot 平台是
8
+ Milky 协议且涉及群管理操作,就应触发。仅有昵称时必须先查成员列表获取 user_id。
6
9
  keywords:
7
10
  - milky
8
11
  - adapter:milky
9
12
  - 群管理
13
+ - 禁言
14
+ - 踢人
15
+ - 管理员
10
16
  - list_members
11
17
  tags:
12
18
  - group
@@ -23,21 +29,37 @@ tools:
23
29
  - milky_get_group_info
24
30
  ---
25
31
 
26
- ## 工具概览
32
+ # Milky 群管理技能
27
33
 
28
- | 工具 | 说明 | 权限 |
29
- |------|------|------|
30
- | `milky_kick_member` | 踢出成员 | group_admin |
31
- | `milky_mute_member` | 禁言成员(duration=0 解除) | group_admin |
32
- | `milky_mute_all` | 全员禁言/解除 | group_admin |
33
- | `milky_set_admin` | 设置/取消管理员 | group_owner |
34
- | `milky_set_nickname` | 修改群昵称/名片 | group_admin |
35
- | `milky_set_group_name` | 修改群名称 | group_admin |
36
- | `milky_list_members` | 获取群成员列表 | user |
37
- | `milky_get_group_info` | 获取群信息 | user |
34
+ Milky QQ 生态中的一种协议实现,提供标准群管理工具集。
38
35
 
39
- ## 执行规则
36
+ ## 核心原则
40
37
 
41
- 1. 仅有昵称时先 `milky_list_members` 获取用户 QQ 号
42
- 2. 禁言 duration 单位为秒,默认 600(10 分钟),设为 0 解除
43
- 3. 管理员设置需要群主权限
38
+ ### 先查后操作
39
+
40
+ 只有昵称时,先 `milky_list_members` 获取 QQ 号再操作。
41
+
42
+ **Example:**
43
+ ```
44
+ 用户: 禁言那个叫"阿强"的
45
+ 步骤1: milky_list_members → 找到 user_id = 654321
46
+ 步骤2: milky_mute_member(user_id=654321, duration=600)
47
+ ```
48
+
49
+ ## 工具详解
50
+
51
+ | 工具 | 用途 | 权限 | 关键参数 |
52
+ |------|------|------|----------|
53
+ | `milky_kick_member` | 踢出成员 | admin | `user_id` |
54
+ | `milky_mute_member` | 禁言/解禁 | admin | `user_id`, `duration`(秒,**0=解禁**) |
55
+ | `milky_mute_all` | 全员禁言/解除 | admin | `enable` |
56
+ | `milky_set_admin` | 设/取消管理员 | owner | `user_id`, `enable` |
57
+ | `milky_set_nickname` | 改群名片 | admin | `user_id`, `nickname` |
58
+ | `milky_set_group_name` | 改群名 | admin | `name` |
59
+ | `milky_list_members` | 成员列表 | user | — |
60
+ | `milky_get_group_info` | 群信息 | user | — |
61
+
62
+ ## 易错点
63
+
64
+ 1. **禁言 duration=0 是解禁**,不是永久禁言。
65
+ 2. **管理员设置需要群主权限**(owner),管理员无法设置其他管理员。