@zhin.js/adapter-telegram 1.0.60 → 1.0.61
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/telegram/SKILL.md +61 -33
package/CHANGELOG.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhin.js/adapter-telegram",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.61",
|
|
4
4
|
"description": "Zhin.js adapter for Telegram",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./lib/index.js",
|
|
@@ -40,16 +40,16 @@
|
|
|
40
40
|
"@types/react-dom": "^19.2.1",
|
|
41
41
|
"lucide-react": "^1.11.0",
|
|
42
42
|
"typescript": "^6.0.3",
|
|
43
|
-
"@zhin.js/cli": "1.0.
|
|
44
|
-
"@zhin.js/console": "2.0.
|
|
45
|
-
"zhin.js": "1.0.
|
|
43
|
+
"@zhin.js/cli": "1.0.69",
|
|
44
|
+
"@zhin.js/console": "2.0.16",
|
|
45
|
+
"zhin.js": "1.0.73"
|
|
46
46
|
},
|
|
47
47
|
"peerDependencies": {
|
|
48
48
|
"@zhin.js/client": "1.0.18",
|
|
49
|
-
"@zhin.js/console": "2.0.
|
|
50
|
-
"@zhin.js/http": "1.0.
|
|
51
|
-
"@zhin.js/logger": "0.1.
|
|
52
|
-
"zhin.js": "1.0.
|
|
49
|
+
"@zhin.js/console": "2.0.16",
|
|
50
|
+
"@zhin.js/http": "1.0.66",
|
|
51
|
+
"@zhin.js/logger": "0.1.55",
|
|
52
|
+
"zhin.js": "1.0.73"
|
|
53
53
|
},
|
|
54
54
|
"peerDependenciesMeta": {
|
|
55
55
|
"@zhin.js/client": {
|
package/skills/telegram/SKILL.md
CHANGED
|
@@ -2,7 +2,11 @@
|
|
|
2
2
|
name: telegram
|
|
3
3
|
platforms:
|
|
4
4
|
- telegram
|
|
5
|
-
description:
|
|
5
|
+
description: >-
|
|
6
|
+
Telegram 群组全功能管理。当用户在 Telegram 群中请求群管（踢人、封禁、解封、禁言、
|
|
7
|
+
设管理员、改群名/描述）、消息管理（置顶/取消置顶）、社交互动（投票、表情反应、贴纸）、
|
|
8
|
+
或群权限设置时使用。即使用户没有提到 Telegram，只要上下文是 Telegram 群组场景
|
|
9
|
+
且涉及上述操作，就应触发。仅有用户名时必须先查成员列表获取 user_id。
|
|
6
10
|
keywords:
|
|
7
11
|
- telegram
|
|
8
12
|
- tg
|
|
@@ -13,13 +17,14 @@ keywords:
|
|
|
13
17
|
- 反应
|
|
14
18
|
- 贴纸
|
|
15
19
|
- 权限
|
|
20
|
+
- 封禁
|
|
21
|
+
- 禁言
|
|
16
22
|
- list_members
|
|
17
23
|
tags:
|
|
18
24
|
- group
|
|
19
25
|
- management
|
|
20
26
|
- im
|
|
21
27
|
tools:
|
|
22
|
-
# 平台特有工具
|
|
23
28
|
- telegram_pin_message
|
|
24
29
|
- telegram_unpin_message
|
|
25
30
|
- telegram_list_admins
|
|
@@ -30,7 +35,6 @@ tools:
|
|
|
30
35
|
- telegram_send_sticker
|
|
31
36
|
- telegram_set_permissions
|
|
32
37
|
- telegram_set_description
|
|
33
|
-
# 通用群管工具
|
|
34
38
|
- telegram_kick_member
|
|
35
39
|
- telegram_unban_member
|
|
36
40
|
- telegram_mute_member
|
|
@@ -39,37 +43,61 @@ tools:
|
|
|
39
43
|
- telegram_get_group_info
|
|
40
44
|
---
|
|
41
45
|
|
|
42
|
-
|
|
46
|
+
# Telegram 群组管理技能
|
|
43
47
|
|
|
44
|
-
|
|
48
|
+
Telegram 的群组管理模型与 QQ 不同：没有「群名片」概念，有封禁（ban）/解封（unban）机制，权限体系更细粒度。
|
|
45
49
|
|
|
46
|
-
|
|
50
|
+
## 核心原则
|
|
51
|
+
|
|
52
|
+
### 先查后操作
|
|
53
|
+
|
|
54
|
+
Telegram 的 user_id 是纯数字，用户通常只知道用户名（@xxx）。操作具体成员前，用 `telegram_list_admins` 或从消息上下文获取 user_id。
|
|
55
|
+
|
|
56
|
+
### Telegram 权限模型
|
|
57
|
+
|
|
58
|
+
Telegram 的权限不是简单的 owner/admin/member 三级，而是细粒度的权限集合。通过 `telegram_set_permissions` 可以控制：发消息、发媒体、发投票、添加成员、置顶消息等。
|
|
59
|
+
|
|
60
|
+
## 工具分类
|
|
61
|
+
|
|
62
|
+
### 群管基础
|
|
63
|
+
|
|
64
|
+
| 工具 | 用途 | 说明 |
|
|
47
65
|
|------|------|------|
|
|
48
|
-
| `
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
54
|
-
| `
|
|
55
|
-
| `
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
|
|
59
|
-
###
|
|
60
|
-
|
|
61
|
-
| 工具 |
|
|
66
|
+
| `telegram_kick_member` | 踢出成员 | 踢出后用户仍可重新加入 |
|
|
67
|
+
| `telegram_unban_member` | 解除封禁 | 被 ban 的用户无法加入群组 |
|
|
68
|
+
| `telegram_mute_member` | 禁言 | duration 单位秒，**0=永久限制** |
|
|
69
|
+
| `telegram_set_admin` | 设/取消管理员 | — |
|
|
70
|
+
| `telegram_set_group_name` | 改群名 | — |
|
|
71
|
+
| `telegram_set_description` | 设群描述 | — |
|
|
72
|
+
| `telegram_set_permissions` | 设群权限 | 影响所有普通成员，管理员不受限 |
|
|
73
|
+
| `telegram_get_group_info` | 群信息 | — |
|
|
74
|
+
| `telegram_list_admins` | 管理员列表 | — |
|
|
75
|
+
| `telegram_member_count` | 成员数量 | — |
|
|
76
|
+
|
|
77
|
+
### 消息与社交
|
|
78
|
+
|
|
79
|
+
| 工具 | 用途 | 说明 |
|
|
62
80
|
|------|------|------|
|
|
63
|
-
| `
|
|
64
|
-
| `
|
|
65
|
-
| `
|
|
66
|
-
| `
|
|
67
|
-
| `
|
|
68
|
-
| `
|
|
69
|
-
|
|
70
|
-
##
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
81
|
+
| `telegram_pin_message` | 置顶消息 | 需管理员权限 |
|
|
82
|
+
| `telegram_unpin_message` | 取消置顶 | — |
|
|
83
|
+
| `telegram_create_invite` | 创建邀请链接 | 需管理员权限 |
|
|
84
|
+
| `telegram_send_poll` | 发起投票 | 支持匿名 + 多选 |
|
|
85
|
+
| `telegram_react` | 表情反应 | 对消息贴 emoji |
|
|
86
|
+
| `telegram_send_sticker` | 发贴纸 | — |
|
|
87
|
+
|
|
88
|
+
## 与 QQ 群管的关键差异
|
|
89
|
+
|
|
90
|
+
| 概念 | QQ（OneBot11） | Telegram |
|
|
91
|
+
|------|---------------|----------|
|
|
92
|
+
| 禁言 duration=0 | **解禁** | **永久限制** |
|
|
93
|
+
| 踢出 | 踢出 = 移除 | 踢出 ≠ 封禁，可重新加入 |
|
|
94
|
+
| 封禁 | 无独立概念 | `ban` 阻止加入 |
|
|
95
|
+
| 群名片 | 支持 | 不支持 |
|
|
96
|
+
| 群权限 | admin/member 二分 | 细粒度权限集 |
|
|
97
|
+
|
|
98
|
+
## 易错点
|
|
99
|
+
|
|
100
|
+
1. **禁言 duration=0 在 Telegram 是永久限制**，与 QQ 的「解禁」含义相反。
|
|
101
|
+
2. **踢人不等于封禁**：`kick_member` 移除但不阻止重新加入；要永久禁止需要 ban。
|
|
102
|
+
3. **投票支持匿名和多选**：用户说「发个投票」时确认是否需要匿名/多选。
|
|
103
|
+
4. **权限设置影响全体普通成员**，不是针对个人。管理员不受影响。
|