npm - @zhin.js/adapter-telegram - Versions diffs - 1.0.45 → 1.0.48 - Mend

@zhin.js/adapter-telegram 1.0.45 → 1.0.48

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.

Files changed (15) hide show

package/lib/index.js CHANGED Viewed

@@ -1,13 +1,13 @@
 /**
  * Telegram 适配器入口：类型扩展、导出、注册
  */
-import { usePlugin } from "zhin.js";
+import { usePlugin, createGroupManagementTools } from "zhin.js";
 import { TelegramAdapter } from "./adapter.js";
 export * from "./types.js";
 export { TelegramBot } from "./bot.js";
 export { TelegramAdapter } from "./adapter.js";
 const plugin = usePlugin();
-const { provide } = plugin;
+const { provide, useContext } = plugin;
 provide({
     name: "telegram",
     description: "Telegram Bot Adapter",
@@ -20,4 +20,262 @@ provide({
         await adapter.stop();
     },
 });
+useContext('tool', 'telegram', (toolService, telegram) => {
+    const groupTools = createGroupManagementTools(telegram, 'telegram');
+    const disposers = groupTools.map(t => toolService.addTool(t, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_pin_message',
+        description: '置顶 Telegram 群组消息',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                message_id: { type: 'string', description: '消息 ID' },
+            },
+            required: ['bot', 'chat_id', 'message_id'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const success = await bot.pinMessage(Number(args.chat_id), Number(args.message_id));
+            return { success, message: success ? '消息已置顶' : '操作失败' };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_unpin_message',
+        description: '取消置顶 Telegram 群组消息',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                message_id: { type: 'string', description: '消息 ID（可选，不提供则取消所有置顶）' },
+            },
+            required: ['bot', 'chat_id'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const success = await bot.unpinMessage(Number(args.chat_id), args.message_id ? Number(args.message_id) : undefined);
+            return { success, message: success ? '已取消置顶' : '操作失败' };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_list_admins',
+        description: '获取 Telegram 群组管理员列表',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+            },
+            required: ['bot', 'chat_id'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const admins = await bot.getChatAdmins(Number(args.chat_id));
+            return {
+                admins: admins.map((a) => ({
+                    user_id: a.user.id,
+                    username: a.user.username,
+                    first_name: a.user.first_name,
+                    status: a.status,
+                })),
+                count: admins.length,
+            };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_member_count',
+        description: '获取 Telegram 群组成员数量',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+            },
+            required: ['bot', 'chat_id'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const count = await bot.getChatMemberCount(Number(args.chat_id));
+            return { count, message: `群组共有 ${count} 名成员` };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_create_invite',
+        description: '创建 Telegram 群组邀请链接',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+            },
+            required: ['bot', 'chat_id'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const link = await bot.createInviteLink(Number(args.chat_id));
+            return { invite_link: link, message: `邀请链接: ${link}` };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_send_poll',
+        description: '在 Telegram 群组中发起投票',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                question: { type: 'string', description: '投票问题' },
+                options: { type: 'string', description: '选项 JSON 数组，如 ["A","B","C"]' },
+                is_anonymous: { type: 'boolean', description: '是否匿名投票，默认 true' },
+                allows_multiple: { type: 'boolean', description: '是否允许多选，默认 false' },
+            },
+            required: ['bot', 'chat_id', 'question', 'options'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            let optList;
+            try {
+                optList = JSON.parse(args.options);
+            }
+            catch {
+                return { success: false, message: 'options 格式错误，应为 JSON 数组' };
+            }
+            if (!Array.isArray(optList) || optList.length < 2) {
+                return { success: false, message: '至少需要 2 个选项' };
+            }
+            const result = await bot.sendPoll(Number(args.chat_id), args.question, optList, args.is_anonymous ?? true, args.allows_multiple ?? false);
+            return { success: true, message_id: result.message_id, message: '投票已发送' };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_react',
+        description: '对 Telegram 消息添加表情反应',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                message_id: { type: 'string', description: '消息 ID' },
+                reaction: { type: 'string', description: '反应表情（如 👍、❤️、🔥）' },
+            },
+            required: ['bot', 'chat_id', 'message_id', 'reaction'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const success = await bot.setMessageReaction(Number(args.chat_id), Number(args.message_id), args.reaction);
+            return { success, message: success ? `已添加反应 ${args.reaction}` : '操作失败' };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_send_sticker',
+        description: '发送 Telegram 贴纸',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                sticker: { type: 'string', description: '贴纸 file_id 或 URL' },
+            },
+            required: ['bot', 'chat_id', 'sticker'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const result = await bot.sendStickerMessage(Number(args.chat_id), args.sticker);
+            return { success: true, message_id: result.message_id, message: '贴纸已发送' };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_set_permissions',
+        description: '设置 Telegram 群组的默认成员权限',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                can_send_messages: { type: 'boolean', description: '是否可以发消息' },
+                can_send_photos: { type: 'boolean', description: '是否可以发图片' },
+                can_send_videos: { type: 'boolean', description: '是否可以发视频' },
+                can_send_polls: { type: 'boolean', description: '是否可以发投票' },
+                can_send_other_messages: { type: 'boolean', description: '是否可以发贴纸/GIF等' },
+                can_add_web_page_previews: { type: 'boolean', description: '是否可以添加网页预览' },
+                can_change_info: { type: 'boolean', description: '是否可以改群信息' },
+                can_invite_users: { type: 'boolean', description: '是否可以邀请用户' },
+                can_pin_messages: { type: 'boolean', description: '是否可以置顶消息' },
+            },
+            required: ['bot', 'chat_id'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const { bot: botId, chat_id, ...perms } = args;
+            const bot = telegram.bots.get(botId);
+            if (!bot)
+                throw new Error(`Bot ${botId} 不存在`);
+            const permissions = {};
+            for (const [k, v] of Object.entries(perms)) {
+                if (typeof v === 'boolean')
+                    permissions[k] = v;
+            }
+            const success = await bot.setChatPermissionsAll(Number(chat_id), permissions);
+            return { success, message: success ? '群权限已更新' : '操作失败' };
+        },
+    }, 'telegram'));
+    disposers.push(toolService.addTool({
+        name: 'telegram_set_description',
+        description: '设置 Telegram 群组描述',
+        parameters: {
+            type: 'object',
+            properties: {
+                bot: { type: 'string', description: 'Bot 名称' },
+                chat_id: { type: 'string', description: '聊天 ID' },
+                description: { type: 'string', description: '群描述文字' },
+            },
+            required: ['bot', 'chat_id', 'description'],
+        },
+        platforms: ['telegram'],
+        tags: ['telegram'],
+        execute: async (args) => {
+            const bot = telegram.bots.get(args.bot);
+            if (!bot)
+                throw new Error(`Bot ${args.bot} 不存在`);
+            const success = await bot.setChatDescription(Number(args.chat_id), args.description);
+            return { success, message: success ? '群描述已更新' : '操作失败' };
+        },
+    }, 'telegram'));
+    return () => disposers.forEach(d => d());
+});
 //# sourceMappingURL=index.js.map

package/lib/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAA6B,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQ/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;AAE3B,OAAO,CAAC;IACN,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,sBAAsB;IACnC,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAwB,EAAE,EAAE;QAC1C,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACqB,CAAC,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-telegram",
-  "version": "1.0.45",
+  "version": "1.0.48",
   "description": "Zhin.js adapter for Telegram",
   "type": "module",
   "main": "./lib/index.js",
@@ -36,12 +36,12 @@
   },
   "devDependencies": {
     "@types/node": "^22.9.0",
-    "typescript": "^5.3.0",
-    "zhin.js": "1.0.58"
+    "typescript": "^5.9.3",
+    "zhin.js": "1.0.61"
   },
   "peerDependencies": {
-    "zhin.js": "1.0.58",
-    "@zhin.js/logger": "0.1.42"
+    "@zhin.js/logger": "0.1.45",
+    "zhin.js": "1.0.61"
   },
   "files": [
     "src",

package/skills/telegram/SKILL.md CHANGED Viewed

@@ -1,18 +1,75 @@
 ---
 name: telegram
-description: Telegram 群组管理：踢人、禁言、封禁、设管理员、改群名、查成员等。仅用户名时请先 list_members 获取 user_id 再操作。
+platforms:
+  - telegram
+description: Telegram 群组管理：群管（踢人、解封、禁言、设管理员、改群名/描述）、置顶、投票、表情反应、贴纸、群权限设置、邀请链接、管理员列表。仅有用户名时请先 list_members 获取 user_id。
 keywords:
   - telegram
   - tg
   - adapter:telegram
   - 群管理
+  - 置顶
+  - 投票
+  - 反应
+  - 贴纸
+  - 权限
   - list_members
 tags:
   - group
   - management
-tools: []
+  - im
+tools:
+  # 平台特有工具
+  - telegram_pin_message
+  - telegram_unpin_message
+  - telegram_list_admins
+  - telegram_member_count
+  - telegram_create_invite
+  - telegram_send_poll
+  - telegram_react
+  - telegram_send_sticker
+  - telegram_set_permissions
+  - telegram_set_description
+  # 通用群管工具
+  - telegram_kick_member
+  - telegram_unban_member
+  - telegram_mute_member
+  - telegram_set_admin
+  - telegram_set_group_name
+  - telegram_get_group_info
 ---
+## 工具概览
+### 平台特有
+| 工具 | 说明 | 权限 |
+|------|------|------|
+| `telegram_pin_message` | 置顶消息 | group_admin |
+| `telegram_unpin_message` | 取消置顶 | group_admin |
+| `telegram_list_admins` | 获取管理员列表 | user |
+| `telegram_member_count` | 获取群组成员数量 | user |
+| `telegram_create_invite` | 创建邀请链接 | group_admin |
+| `telegram_send_poll` | 发起投票 | user |
+| `telegram_react` | 对消息添加表情反应 | user |
+| `telegram_send_sticker` | 发送贴纸 | user |
+| `telegram_set_permissions` | 设置群权限 | group_admin |
+| `telegram_set_description` | 设置群描述 | group_admin |
+### 通用群管
+| 工具 | 说明 | 权限 |
+|------|------|------|
+| `telegram_kick_member` | 踢出成员 | group_admin |
+| `telegram_unban_member` | 解除封禁 | group_admin |
+| `telegram_mute_member` | 禁言成员 | group_admin |
+| `telegram_set_admin` | 设置/取消管理员 | group_admin |
+| `telegram_set_group_name` | 修改群名称 | group_admin |
+| `telegram_get_group_info` | 获取群信息 | user |
 ## 执行规则
-- 使用 `telegram_*` 工具；先 list_members 获取 user_id。
+1. 仅有用户名时先 `telegram_list_admins` 或通过消息上下文获取 user_id
+2. 禁言 duration 单位为秒，0 表示永久限制
+3. 投票支持匿名和多选模式
+4. 权限设置影响所有普通成员，管理员不受限