@zhin.js/adapter-telegram 1.1.14 → 1.1.16

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 1.1.16
+
+### Patch Changes
+
+- 53bc6a0: 适配器配置标签、端点命令和工具反馈支持中英文；复用当前操作语言，保持协议值、用户内容、身份、权限与发送链路不变。Sandbox 展示使用项目语言，QQ 绑定与交互状态保留完整会话身份。
+- Updated dependencies [334e92d]
+- Updated dependencies [f3b7c9f]
+- Updated dependencies [658a5fb]
+- Updated dependencies [144a17b]
+- Updated dependencies [18296cf]
+- Updated dependencies [08e64de]
+- Updated dependencies [9cade30]
+- Updated dependencies [53bc6a0]
+- Updated dependencies [7595136]
+- Updated dependencies [66b6404]
+- Updated dependencies [adb4af2]
+- Updated dependencies [69f9ef6]
+- Updated dependencies [17d1301]
+  - @zhin.js/adapter@1.1.23
+  - @zhin.js/host-http@1.1.10
+  - @zhin.js/core@1.1.51
+  - @zhin.js/tool@1.1.10
+  - @zhin.js/skill@1.1.10
+  - @zhin.js/im-contract@1.1.7
+  - @zhin.js/agent-feature@1.1.10
+  - @zhin.js/feature-kit@1.1.9
+
+## 1.1.15
+
+### Patch Changes
+
+- 7d68df6: 精简 Agent 内置固定提示词与消息说明，保留工具、审批和结构化回复能力。适配器 Skill 按会话场景拆分，群／频道管理仅向对应场景披露；提示段与模型消息段支持场景声明，沿用当前回合权限和 generation 投影。
+- Updated dependencies [f98025b]
+- Updated dependencies [66ec1a5]
+- Updated dependencies [7d68df6]
+- Updated dependencies [bf0fa9f]
+- Updated dependencies [3326db3]
+- Updated dependencies [e91235e]
+- Updated dependencies [6da2bad]
+- Updated dependencies [3781f1c]
+  - @zhin.js/core@1.1.50
+  - @zhin.js/adapter@1.1.22
+  - @zhin.js/im-contract@1.1.6
+  - @zhin.js/tool@1.1.9
+  - @zhin.js/host-http@1.1.9
+  - @zhin.js/agent-feature@1.1.9
+  - @zhin.js/feature-kit@1.1.8
+  - @zhin.js/skill@1.1.9
+
 ## 1.1.14
 
 ### Patch Changes

package/agents/telegram/messages.js

@@ -0,0 +1,52 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    "inviteLink": {
+        "zh-CN": "邀请链接: {p0}",
+        "en": "Invite link: {p0}"
+    },
+    "memberCount": {
+        "zh-CN": "群组共有 {p0} 名成员",
+        "en": "The group has {p0} members"
+    },
+    "operationFailed": {
+        "zh-CN": "操作失败",
+        "en": "Operation failed"
+    },
+    "pinDone": {
+        "zh-CN": "消息已置顶",
+        "en": "Message pinned"
+    },
+    "descriptionUpdated": {
+        "zh-CN": "群描述已更新",
+        "en": "Group description updated"
+    },
+    "messageUnpinned": {
+        "zh-CN": "已取消置顶",
+        "en": "Message unpinned"
+    },
+    "permissionsUpdated": {
+        "zh-CN": "群权限已更新",
+        "en": "Group permissions updated"
+    },
+    "reactionAdded": {
+        "zh-CN": "已添加反应 {p0}",
+        "en": "Reaction added: {p0}"
+    },
+    "pollSent": {
+        "zh-CN": "投票已发送",
+        "en": "Poll sent"
+    },
+    "pollOptionCount": {
+        "zh-CN": "至少需要 2 个选项",
+        "en": "At least two options are required"
+    },
+    "invalidPollOptions": {
+        "zh-CN": "options 格式错误，应为 JSON 数组",
+        "en": "options must be a JSON array"
+    },
+    "stickerSent": {
+        "zh-CN": "贴纸已发送",
+        "en": "Sticker sent"
+    }
+});

package/agents/telegram/messages.ts

@@ -0,0 +1,52 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  "inviteLink": {
+    "zh-CN": "邀请链接: {p0}",
+    "en": "Invite link: {p0}"
+  },
+  "memberCount": {
+    "zh-CN": "群组共有 {p0} 名成员",
+    "en": "The group has {p0} members"
+  },
+  "operationFailed": {
+    "zh-CN": "操作失败",
+    "en": "Operation failed"
+  },
+  "pinDone": {
+    "zh-CN": "消息已置顶",
+    "en": "Message pinned"
+  },
+  "descriptionUpdated": {
+    "zh-CN": "群描述已更新",
+    "en": "Group description updated"
+  },
+  "messageUnpinned": {
+    "zh-CN": "已取消置顶",
+    "en": "Message unpinned"
+  },
+  "permissionsUpdated": {
+    "zh-CN": "群权限已更新",
+    "en": "Group permissions updated"
+  },
+  "reactionAdded": {
+    "zh-CN": "已添加反应 {p0}",
+    "en": "Reaction added: {p0}"
+  },
+  "pollSent": {
+    "zh-CN": "投票已发送",
+    "en": "Poll sent"
+  },
+  "pollOptionCount": {
+    "zh-CN": "至少需要 2 个选项",
+    "en": "At least two options are required"
+  },
+  "invalidPollOptions": {
+    "zh-CN": "options 格式错误，应为 JSON 数组",
+    "en": "options must be a JSON array"
+  },
+  "stickerSent": {
+    "zh-CN": "贴纸已发送",
+    "en": "Sticker sent"
+  }
+});

package/agents/telegram/skills/telegram-chat-admin/SKILL.md

@@ -2,23 +2,23 @@
 name: telegram-chat-admin
 platforms:
   - telegram
-description: Telegram 管理员查询、成员数、邀请、置顶和群权限设置能力。
+description: Telegram 群组或频道管理员查询、成员数、邀请、置顶和描述管理。
 keywords:
-  - "telegram"
-  - "admin"
-  - "invite"
-  - "pin"
-  - "permissions"
+  - telegram
+  - admin
+  - invite
+  - pin
 tools:
-  - "pin_message"
-  - "unpin_message"
-  - "list_admins"
-  - "member_count"
-  - "create_invite"
-  - "set_permissions"
-  - "set_description"
+  - pin_message
+  - unpin_message
+  - list_admins
+  - member_count
+  - create_invite
+  - set_description
+scopes:
+  - group
+  - channel
 ---
+# Telegram 群组与频道
 
-# telegram-chat-admin
-
-先读取管理员与成员状态，再执行邀请、置顶或权限变更。群设置写操作遵守审批策略。
+先读取管理员与成员状态，再执行邀请、置顶或描述变更；遵守各 Tool 的审批。群默认成员权限使用 telegram-group-permissions。

package/agents/telegram/skills/telegram-chat-admin/tools/create_invite/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -8,11 +9,12 @@ export default defineAgentTool({
         chat_id: z.string().describe('聊天 ID'),
     }),
     adapter: 'telegram',
+    scopes: ["group", "channel"],
     tags: ['telegram'],
     permissions: [platformPermission('telegram', 'chat_administrator')],
     async execute({ chat_id }, context) {
         const endpoint = context.$client;
         const link = await endpoint.createInviteLink(Number(chat_id));
-        return { invite_link: link, message: `邀请链接: ${link}` };
+        return { invite_link: link, message: t(context.locale, 'inviteLink', { p0: link }) };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/create_invite/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -8,11 +9,12 @@ export default defineAgentTool<{ chat_id: string }>({
     chat_id: z.string().describe('聊天 ID'),
   }),
   adapter: 'telegram',
+  scopes: ["group","channel"],
   tags: ['telegram'],
   permissions: [platformPermission('telegram', 'chat_administrator')],
   async execute({ chat_id  }: { chat_id: string }, context) {
     const endpoint = context.$client;
     const link = await endpoint.createInviteLink(Number(chat_id));
-    return { invite_link: link, message: `邀请链接: ${link}` };
+    return { invite_link: link, message: t(context.locale, 'inviteLink', { p0: link }) };
   },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/list_admins/index.js

@@ -7,6 +7,7 @@ export default defineAgentTool({
         chat_id: z.string().describe('聊天 ID'),
     }),
     adapter: 'telegram',
+    scopes: ["group", "channel"],
     tags: ['telegram'],
     async execute({ chat_id }, context) {
         const endpoint = context.$client;

package/agents/telegram/skills/telegram-chat-admin/tools/list_admins/index.ts

@@ -7,6 +7,7 @@ export default defineAgentTool<{ chat_id: string }>({
     chat_id: z.string().describe('聊天 ID'),
   }),
   adapter: 'telegram',
+  scopes: ["group","channel"],
   tags: ['telegram'],
   async execute({ chat_id  }: { chat_id: string }, context) {
     const endpoint = context.$client;

package/agents/telegram/skills/telegram-chat-admin/tools/member_count/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -7,10 +8,11 @@ export default defineAgentTool({
         chat_id: z.string().describe('聊天 ID'),
     }),
     adapter: 'telegram',
+    scopes: ["group", "channel"],
     tags: ['telegram'],
     async execute({ chat_id }, context) {
         const endpoint = context.$client;
         const count = await endpoint.getChatMemberCount(Number(chat_id));
-        return { count, message: `群组共有 ${count} 名成员` };
+        return { count, message: t(context.locale, 'memberCount', { p0: count }) };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/member_count/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -7,10 +8,11 @@ export default defineAgentTool<{ chat_id: string }>({
     chat_id: z.string().describe('聊天 ID'),
   }),
   adapter: 'telegram',
+  scopes: ["group","channel"],
   tags: ['telegram'],
   async execute({ chat_id  }: { chat_id: string }, context) {
     const endpoint = context.$client;
     const count = await endpoint.getChatMemberCount(Number(chat_id));
-    return { count, message: `群组共有 ${count} 名成员` };
+    return { count, message: t(context.locale, 'memberCount', { p0: count }) };
   },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/pin_message/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -9,11 +10,12 @@ export default defineAgentTool({
         message_id: z.string().describe('消息 ID'),
     }),
     adapter: 'telegram',
+    scopes: ["group", "channel"],
     tags: ['telegram'],
     permissions: [platformPermission('telegram', 'pin_messages')],
     async execute({ chat_id, message_id }, context) {
         const endpoint = context.$client;
         const success = await endpoint.pinMessage(Number(chat_id), Number(message_id));
-        return { success, message: success ? '消息已置顶' : '操作失败' };
+        return { success, message: success ? t(context.locale, 'pinDone') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/pin_message/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -9,11 +10,12 @@ export default defineAgentTool<{ chat_id: string; message_id: string }>({
     message_id: z.string().describe('消息 ID'),
   }),
   adapter: 'telegram',
+  scopes: ["group","channel"],
   tags: ['telegram'],
   permissions: [platformPermission('telegram', 'pin_messages')],
   async execute({ chat_id, message_id  }: { chat_id: string; message_id: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.pinMessage(Number(chat_id), Number(message_id));
-    return { success, message: success ? '消息已置顶' : '操作失败' };
+    return { success, message: success ? t(context.locale, 'pinDone') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/set_description/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -8,10 +9,11 @@ export default defineAgentTool({
         description: z.string().describe('群描述文字'),
     }),
     adapter: 'telegram',
+    scopes: ["group", "channel"],
     tags: ['telegram'],
     async execute({ chat_id, description }, context) {
         const endpoint = context.$client;
         const success = await endpoint.setChatDescription(Number(chat_id), description);
-        return { success, message: success ? '群描述已更新' : '操作失败' };
+        return { success, message: success ? t(context.locale, 'descriptionUpdated') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/set_description/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -8,10 +9,11 @@ export default defineAgentTool<{ chat_id: string; description: string }>({
     description: z.string().describe('群描述文字'),
   }),
   adapter: 'telegram',
+  scopes: ["group","channel"],
   tags: ['telegram'],
   async execute({ chat_id, description  }: { chat_id: string; description: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.setChatDescription(Number(chat_id), description);
-    return { success, message: success ? '群描述已更新' : '操作失败' };
+    return { success, message: success ? t(context.locale, 'descriptionUpdated') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/unpin_message/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -9,11 +10,12 @@ export default defineAgentTool({
         message_id: z.string().optional().describe('消息 ID（可选，不提供则取消所有置顶）'),
     }),
     adapter: 'telegram',
+    scopes: ["group", "channel"],
     tags: ['telegram'],
     permissions: [platformPermission('telegram', 'pin_messages')],
     async execute({ chat_id, message_id }, context) {
         const endpoint = context.$client;
         const success = await endpoint.unpinMessage(Number(chat_id), message_id ? Number(message_id) : undefined);
-        return { success, message: success ? '已取消置顶' : '操作失败' };
+        return { success, message: success ? t(context.locale, 'messageUnpinned') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/unpin_message/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -9,11 +10,12 @@ export default defineAgentTool<{ chat_id: string; message_id?: string }>({
     message_id: z.string().optional().describe('消息 ID（可选，不提供则取消所有置顶）'),
   }),
   adapter: 'telegram',
+  scopes: ["group","channel"],
   tags: ['telegram'],
   permissions: [platformPermission('telegram', 'pin_messages')],
   async execute({ chat_id, message_id  }: { chat_id: string; message_id?: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.unpinMessage(Number(chat_id), message_id ? Number(message_id) : undefined);
-    return { success, message: success ? '已取消置顶' : '操作失败' };
+    return { success, message: success ? t(context.locale, 'messageUnpinned') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-group-permissions/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: telegram-group-permissions
+platforms:
+  - telegram
+scopes:
+  - group
+description: Telegram 群默认成员权限设置。
+keywords:
+  - telegram
+  - permissions
+tools:
+  - set_permissions
+---
+# telegram-group-permissions
+
+先确认群和当前管理员权限，再修改默认成员权限；遵守审批。

package/agents/telegram/skills/{telegram-chat-admin → telegram-group-permissions}/tools/set_permissions/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -17,6 +18,7 @@ export default defineAgentTool({
         can_pin_messages: z.boolean().optional().describe('是否可以置顶消息'),
     }),
     adapter: 'telegram',
+    scopes: ["group"],
     tags: ['telegram'],
     permissions: [platformPermission('telegram', 'manage_chat')],
     async execute({ chat_id, ...perms }, context) {
@@ -27,6 +29,6 @@ export default defineAgentTool({
                 permissions[k] = v;
         }
         const success = await endpoint.setChatPermissionsAll(Number(chat_id), permissions);
-        return { success, message: success ? '群权限已更新' : '操作失败' };
+        return { success, message: success ? t(context.locale, 'permissionsUpdated') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/{telegram-chat-admin → telegram-group-permissions}/tools/set_permissions/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { platformPermission } from '@zhin.js/permission';
@@ -17,6 +18,7 @@ export default defineAgentTool<{ chat_id: string; can_send_messages?: boolean; c
     can_pin_messages: z.boolean().optional().describe('是否可以置顶消息'),
   }),
   adapter: 'telegram',
+  scopes: ["group"],
   tags: ['telegram'],
   permissions: [platformPermission('telegram', 'manage_chat')],
   async execute({ chat_id, ...perms  }: { chat_id: string; can_send_messages?: boolean; can_send_photos?: boolean; can_send_videos?: boolean; can_send_polls?: boolean; can_send_other_messages?: boolean; can_add_web_page_previews?: boolean; can_change_info?: boolean; can_invite_users?: boolean; can_pin_messages?: boolean }, context) {
@@ -26,6 +28,6 @@ export default defineAgentTool<{ chat_id: string; can_send_messages?: boolean; c
       if (typeof v === 'boolean') permissions[k] = v;
     }
     const success = await endpoint.setChatPermissionsAll(Number(chat_id), permissions);
-    return { success, message: success ? '群权限已更新' : '操作失败' };
+    return { success, message: success ? t(context.locale, 'permissionsUpdated') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-messages/tools/react/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -13,6 +14,6 @@ export default defineAgentTool({
     async execute({ chat_id, message_id, reaction }, context) {
         const endpoint = context.$client;
         const success = await endpoint.setMessageReaction(Number(chat_id), Number(message_id), reaction);
-        return { success, message: success ? `已添加反应 ${reaction}` : '操作失败' };
+        return { success, message: success ? t(context.locale, 'reactionAdded', { p0: reaction }) : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-messages/tools/react/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -13,6 +14,6 @@ export default defineAgentTool<{ chat_id: string; message_id: string; reaction:
   async execute({ chat_id, message_id, reaction  }: { chat_id: string; message_id: string; reaction: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.setMessageReaction(Number(chat_id), Number(message_id), reaction);
-    return { success, message: success ? `已添加反应 ${reaction}` : '操作失败' };
+    return { success, message: success ? t(context.locale, 'reactionAdded', { p0: reaction }) : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-messages/tools/send_poll/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -19,12 +20,12 @@ export default defineAgentTool({
             optList = JSON.parse(options);
         }
         catch {
-            return { success: false, message: 'options 格式错误，应为 JSON 数组' };
+            return { success: false, message: t(context.locale, 'invalidPollOptions') };
         }
         if (!Array.isArray(optList) || optList.length < 2) {
-            return { success: false, message: '至少需要 2 个选项' };
+            return { success: false, message: t(context.locale, 'pollOptionCount') };
         }
         const result = await endpoint.sendPoll(Number(chat_id), question, optList, is_anonymous ?? true, allows_multiple ?? false);
-        return { success: true, message_id: result.message_id, message: '投票已发送' };
+        return { success: true, message_id: result.message_id, message: t(context.locale, 'pollSent') };
     },
 });

package/agents/telegram/skills/telegram-messages/tools/send_poll/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -18,15 +19,15 @@ export default defineAgentTool<{ chat_id: string; question: string; options: str
     try {
       optList = JSON.parse(options);
     } catch {
-      return { success: false, message: 'options 格式错误，应为 JSON 数组' };
+      return { success: false, message: t(context.locale, 'invalidPollOptions') };
     }
     if (!Array.isArray(optList) || optList.length < 2) {
-      return { success: false, message: '至少需要 2 个选项' };
+      return { success: false, message: t(context.locale, 'pollOptionCount') };
     }
     const result = await endpoint.sendPoll(
       Number(chat_id), question, optList,
       is_anonymous ?? true, allows_multiple ?? false,
     );
-    return { success: true, message_id: result.message_id, message: '投票已发送' };
+    return { success: true, message_id: result.message_id, message: t(context.locale, 'pollSent') };
   },
 });

package/agents/telegram/skills/telegram-messages/tools/send_sticker/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -12,6 +13,6 @@ export default defineAgentTool({
     async execute({ chat_id, sticker }, context) {
         const endpoint = context.$client;
         const result = await endpoint.sendStickerMessage(Number(chat_id), sticker);
-        return { success: true, message_id: result.message_id, message: '贴纸已发送' };
+        return { success: true, message_id: result.message_id, message: t(context.locale, 'stickerSent') };
     },
 });

package/agents/telegram/skills/telegram-messages/tools/send_sticker/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -12,6 +13,6 @@ export default defineAgentTool<{ chat_id: string; sticker: string }>({
   async execute({ chat_id, sticker  }: { chat_id: string; sticker: string }, context) {
     const endpoint = context.$client;
     const result = await endpoint.sendStickerMessage(Number(chat_id), sticker);
-    return { success: true, message_id: result.message_id, message: '贴纸已发送' };
+    return { success: true, message_id: result.message_id, message: t(context.locale, 'stickerSent') };
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-telegram",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "Zhin.js Telegram Bot API adapter for Plugin Runtime (long-poll getUpdates)",
   "type": "module",
   "main": "./lib/index.js",
@@ -31,23 +31,23 @@
     "directory": "plugins/adapters/telegram"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.21",
-    "@zhin.js/agent-feature": "1.1.8",
-    "@zhin.js/core": "1.1.49",
-    "@zhin.js/feature-kit": "1.1.7",
-    "@zhin.js/host-http": "1.1.8",
-    "@zhin.js/im-contract": "1.1.5",
+    "@zhin.js/adapter": "1.1.23",
+    "@zhin.js/agent-feature": "1.1.10",
+    "@zhin.js/core": "1.1.51",
+    "@zhin.js/feature-kit": "1.1.9",
+    "@zhin.js/host-http": "1.1.10",
+    "@zhin.js/im-contract": "1.1.7",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/skill": "1.1.8",
-    "@zhin.js/tool": "1.1.8"
+    "@zhin.js/skill": "1.1.10",
+    "@zhin.js/tool": "1.1.10"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.21",
-    "@zhin.js/command": "^1.1.9",
-    "@zhin.js/core": "^1.1.49",
-    "@zhin.js/permission": "^1.1.7",
-    "zhin.js": "^1.1.14"
+    "@zhin.js/adapter": "^1.1.23",
+    "@zhin.js/command": "^1.1.11",
+    "@zhin.js/core": "^1.1.51",
+    "@zhin.js/permission": "^1.1.9",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -65,8 +65,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.8",
-    "zhin.js": "1.1.14"
+    "@zhin.js/host-http": "1.1.10",
+    "zhin.js": "1.1.16"
   },
   "files": [
     "adapters",

package/schema.json

@@ -45,7 +45,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（Telegram user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（Telegram user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (Telegram user id; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -56,7 +61,12 @@
         ],
         "description": "Trusted Telegram user id"
       },
-      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加",
+      "x-i18n": {
+        "en": {
+          "description": "Framework trusted users, below master authority. endpoints[i].trusted can add users."
+        }
+      }
     },
     "endpoints": {
       "type": "array",
@@ -71,7 +81,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（Telegram user id）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（Telegram user id）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (Telegram user id), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -82,7 +97,12 @@
               ],
               "description": "Trusted Telegram user id"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "token": {
             "type": "string",
@@ -127,12 +147,22 @@
           "id",
           "token"
         ]
+      },
+      "x-i18n": {
+        "en": {
+          "description": "Multiple accounts: mount multiple endpoints in one plugin instance. Each entry uses the top-level fields; id is required and other fields override defaults."
+        }
       }
     },
     "commandPrefix": {
       "type": "string",
       "default": "",
-      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Command prefix. The default empty string allows unprefixed commands; '/' requires a leading slash. Each endpoints[i] can override it."
+        }
+      }
     }
   },
   "required": [