@zhin.js/adapter-discord 1.1.14 → 1.1.16

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # @zhin.js/adapter-discord
 
+## 1.1.16
+
+### Patch Changes
+
+- 53bc6a0: 适配器配置标签、端点命令和工具反馈支持中英文；复用当前操作语言，保持协议值、用户内容、身份、权限与发送链路不变。Sandbox 展示使用项目语言，QQ 绑定与交互状态保留完整会话身份。
+- 9cade30: 修复国际化调用链遗漏：Agent 审批、管理命令和错误反馈采用可信语言及实际命令前缀；游戏快捷帮助、工具反馈、平台默认卡片和后台通知贯通语言。协议即时回复复用受运行代约束的个人语言查询，业务验证支持不改变审批身份的双语展示元数据。
+
+  AI 正文、进度与耗尽摘要统一优先遵从用户明确语言要求，再跟随实际输入；个人／项目语言仅作兜底，固定界面文案继续使用配置语言，不增加翻译调用。
+
+  GitHub 工作区为 Git clone/pull/fetch/ls-remote 显式分隔选项与位置参数，保留仓库和分支校验；顺序写入 Bot 名称和邮箱，避免竞争同一配置文件锁。
+
+- dcd4982: Upgrade runtime dependencies to clear security advisories: `undici` (6.29.1 / 8.12.2+), `axios` 1.20.0, and `@modelcontextprotocol/sdk` 1.32.0+ (bringing patched `hono`, `body-parser`, `proxy-addr`, `follow-redirects` and `ip-address` through the lockfile).
+- 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/permission@1.1.9
+  - @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/permission@1.1.8
+  - @zhin.js/skill@1.1.9
+
 ## 1.1.14
 
 ### Patch Changes

package/agents/discord/messages.js

@@ -0,0 +1,48 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    "reactionAdded": {
+        "zh-CN": "已添加反应 {p0}",
+        "en": "Reaction added: {p0}"
+    },
+    "notTextChannel": {
+        "zh-CN": "Channel {p0} 不是文本频道",
+        "en": "Channel {p0} is not a text channel"
+    },
+    "embedSent": {
+        "zh-CN": "Embed 已发送",
+        "en": "Embed sent"
+    },
+    "invalidFields": {
+        "zh-CN": "fields 格式错误，应为 JSON 数组",
+        "en": "fields must be a JSON array"
+    },
+    "operationFailed": {
+        "zh-CN": "操作失败",
+        "en": "Operation failed"
+    },
+    "memberRoleAdded": {
+        "zh-CN": "已给用户 {p0} 添加角色",
+        "en": "Role added to user {p0}"
+    },
+    "threadCreated": {
+        "zh-CN": "帖子 \"{p0}\" 已创建",
+        "en": "Thread \"{p0}\" created"
+    },
+    "threadsUnsupported": {
+        "zh-CN": "Channel {p0} 不支持创建帖子",
+        "en": "Channel {p0} does not support creating threads"
+    },
+    "forumCreated": {
+        "zh-CN": "论坛帖 \"{p0}\" 已创建",
+        "en": "Forum post \"{p0}\" created"
+    },
+    "notForumChannel": {
+        "zh-CN": "Channel {p0} 不是论坛频道",
+        "en": "Channel {p0} is not a forum channel"
+    },
+    "memberRoleRemoved": {
+        "zh-CN": "已移除用户 {p0} 的角色",
+        "en": "Role removed from user {p0}"
+    }
+});

package/agents/discord/messages.ts

@@ -0,0 +1,48 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  "reactionAdded": {
+    "zh-CN": "已添加反应 {p0}",
+    "en": "Reaction added: {p0}"
+  },
+  "notTextChannel": {
+    "zh-CN": "Channel {p0} 不是文本频道",
+    "en": "Channel {p0} is not a text channel"
+  },
+  "embedSent": {
+    "zh-CN": "Embed 已发送",
+    "en": "Embed sent"
+  },
+  "invalidFields": {
+    "zh-CN": "fields 格式错误，应为 JSON 数组",
+    "en": "fields must be a JSON array"
+  },
+  "operationFailed": {
+    "zh-CN": "操作失败",
+    "en": "Operation failed"
+  },
+  "memberRoleAdded": {
+    "zh-CN": "已给用户 {p0} 添加角色",
+    "en": "Role added to user {p0}"
+  },
+  "threadCreated": {
+    "zh-CN": "帖子 \"{p0}\" 已创建",
+    "en": "Thread \"{p0}\" created"
+  },
+  "threadsUnsupported": {
+    "zh-CN": "Channel {p0} 不支持创建帖子",
+    "en": "Channel {p0} does not support creating threads"
+  },
+  "forumCreated": {
+    "zh-CN": "论坛帖 \"{p0}\" 已创建",
+    "en": "Forum post \"{p0}\" created"
+  },
+  "notForumChannel": {
+    "zh-CN": "Channel {p0} 不是论坛频道",
+    "en": "Channel {p0} is not a forum channel"
+  },
+  "memberRoleRemoved": {
+    "zh-CN": "已移除用户 {p0} 的角色",
+    "en": "Role removed from user {p0}"
+  }
+});

package/agents/discord/skills/discord/SKILL.md

@@ -1,21 +1,19 @@
 ---
 name: discord
-platforms: [discord]
-description: Discord 角色、线程、论坛帖子、反应和 Embed 操作能力。
-keywords: [discord, role, thread, forum, reaction, embed]
-tags: [adapter, community]
+platforms:
+  - discord
+description: Discord 消息反应与 Embed。
+keywords:
+  - discord
+  - reaction
+  - embed
+tags:
+  - adapter
+  - community
 tools:
-  - add_role
-  - remove_role
-  - list_roles
-  - create_thread
   - react
   - send_embed
-  - forum_post
 ---
-
 # Discord
 
-按“先查询、后修改”执行：授予或移除角色前先用 `list_roles` 找到角色 ID；创建线程或论坛帖子时使用当前频道上下文；发送结构化内容时使用 `send_embed`；表情回应使用 `react`。
-
-当前 Agent Tool 不提供踢人、封禁、禁言、改昵称或成员列表操作，不要声称已经执行这些动作。
+用 react 回应消息，用 send_embed 发送结构化内容；使用真实消息和频道 ID。

package/agents/discord/skills/discord/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';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -15,10 +16,10 @@ export default defineAgentTool({
         const client = requireDiscordGatewayClient(context.$client);
         const channel = await client.channels.fetch(channel_id);
         if (!channel?.isTextBased() || !channel.messages) {
-            throw new Error(`Channel ${channel_id} 不是文本频道`);
+            throw new Error(t(context.locale, 'notTextChannel', { p0: channel_id }));
         }
         const message = await channel.messages.fetch(message_id);
         await message.react(emoji);
-        return { success: true, message: `已添加反应 ${emoji}` };
+        return { success: true, message: t(context.locale, 'reactionAdded', { p0: emoji }) };
     },
 });

package/agents/discord/skills/discord/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';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -15,10 +16,10 @@ export default defineAgentTool<{ channel_id: string; message_id: string; emoji:
     const client = requireDiscordGatewayClient(context.$client);
     const channel = await client.channels.fetch(channel_id);
     if (!channel?.isTextBased() || !channel.messages) {
-      throw new Error(`Channel ${channel_id} 不是文本频道`);
+      throw new Error(t(context.locale, 'notTextChannel', { p0: channel_id }));
     }
     const message = await channel.messages.fetch(message_id);
     await message.react(emoji);
-    return { success: true, message: `已添加反应 ${emoji}` };
+    return { success: true, message: t(context.locale, 'reactionAdded', { p0: emoji }) };
   },
 });

package/agents/discord/skills/discord/tools/send_embed/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 { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -30,14 +31,14 @@ export default defineAgentTool({
                 embedData.fields = JSON.parse(fields);
             }
             catch {
-                return { success: false, message: 'fields 格式错误，应为 JSON 数组' };
+                return { success: false, message: t(context.locale, 'invalidFields') };
             }
         }
         const channel = await client.channels.fetch(channel_id);
         if (!channel?.isTextBased() || !channel.send) {
-            throw new Error(`Channel ${channel_id} 不是文本频道`);
+            throw new Error(t(context.locale, 'notTextChannel', { p0: channel_id }));
         }
         const msg = await channel.send({ embeds: [embedData] });
-        return { success: true, message_id: msg.id, message: 'Embed 已发送' };
+        return { success: true, message_id: msg.id, message: t(context.locale, 'embedSent') };
     },
 });

package/agents/discord/skills/discord/tools/send_embed/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -25,14 +26,14 @@ export default defineAgentTool<{ channel_id: string; title?: string; description
       try {
         embedData.fields = JSON.parse(fields);
       } catch {
-        return { success: false, message: 'fields 格式错误，应为 JSON 数组' };
+        return { success: false, message: t(context.locale, 'invalidFields') };
       }
     }
     const channel = await client.channels.fetch(channel_id);
     if (!channel?.isTextBased() || !channel.send) {
-      throw new Error(`Channel ${channel_id} 不是文本频道`);
+      throw new Error(t(context.locale, 'notTextChannel', { p0: channel_id }));
     }
     const msg = await channel.send({ embeds: [embedData] } as never);
-    return { success: true, message_id: msg.id, message: 'Embed 已发送' };
+    return { success: true, message_id: msg.id, message: t(context.locale, 'embedSent') };
   },
 });

package/agents/discord/skills/discord-guild/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: discord-guild
+platforms:
+  - discord
+scopes:
+  - channel
+description: Discord 服务器角色、频道线程与论坛帖子。
+keywords:
+  - discord
+  - role
+  - thread
+  - forum
+tools:
+  - add_role
+  - remove_role
+  - list_roles
+  - create_thread
+  - forum_post
+---
+# discord-guild
+
+角色修改前用 list_roles 确认角色 ID；线程和帖子使用当前频道上下文。遵守权限和审批。没有踢人、封禁、禁言、改昵称或成员列表工具，不要声称已执行这些动作。

package/agents/discord/skills/{discord → discord-guild}/tools/add_role/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 { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -11,6 +12,7 @@ export default defineAgentTool({
         role_id: z.string().describe('角色 ID'),
     }),
     adapter: 'discord',
+    scopes: ["channel"],
     tags: ['discord'],
     permissions: [platformPermission('discord', 'manage_roles')],
     async execute({ guild_id, user_id, role_id }, context) {
@@ -19,6 +21,6 @@ export default defineAgentTool({
         const member = await guild.members.fetch(user_id);
         await member.roles.add(role_id);
         const success = true;
-        return { success, message: success ? `已给用户 ${user_id} 添加角色` : '操作失败' };
+        return { success, message: success ? t(context.locale, 'memberRoleAdded', { p0: user_id }) : t(context.locale, 'operationFailed') };
     },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/add_role/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -11,6 +12,7 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
     role_id: z.string().describe('角色 ID'),
   }),
   adapter: 'discord',
+  scopes: ["channel"],
   tags: ['discord'],
   permissions: [platformPermission('discord', 'manage_roles')],
   async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
@@ -21,6 +23,6 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
     };
     await member.roles.add(role_id);
     const success = true;
-    return { success, message: success ? `已给用户 ${user_id} 添加角色` : '操作失败' };
+    return { success, message: success ? t(context.locale, 'memberRoleAdded', { p0: user_id }) : t(context.locale, 'operationFailed') };
   },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/create_thread/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 { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -12,18 +13,19 @@ export default defineAgentTool({
         auto_archive_duration: z.number().optional().describe('自动归档时间（分钟：60/1440/4320/10080）'),
     }),
     adapter: 'discord',
+    scopes: ["channel"],
     tags: ['discord'],
     permissions: [platformPermission('discord', 'manage_channels')],
     async execute({ channel_id, name, message_id, auto_archive_duration }, context) {
         const client = requireDiscordGatewayClient(context.$client);
         const channel = await client.channels.fetch(channel_id);
         if (!channel?.threads)
-            throw new Error(`Channel ${channel_id} 不支持创建帖子`);
+            throw new Error(t(context.locale, 'threadsUnsupported', { p0: channel_id }));
         const thread = await channel.threads.create({
             name,
             autoArchiveDuration: auto_archive_duration || 1440,
             ...(message_id ? { startMessage: message_id } : {}),
         });
-        return { success: true, thread_id: thread.id, message: `帖子 "${name}" 已创建` };
+        return { success: true, thread_id: thread.id, message: t(context.locale, 'threadCreated', { p0: name }) };
     },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/create_thread/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -12,17 +13,18 @@ export default defineAgentTool<{ channel_id: string; name: string; message_id?:
     auto_archive_duration: z.number().optional().describe('自动归档时间（分钟：60/1440/4320/10080）'),
   }),
   adapter: 'discord',
+  scopes: ["channel"],
   tags: ['discord'],
   permissions: [platformPermission('discord', 'manage_channels')],
   async execute({ channel_id, name, message_id, auto_archive_duration  }: { channel_id: string; name: string; message_id?: string; auto_archive_duration?: number }, context) {
     const client = requireDiscordGatewayClient(context.$client);
     const channel = await client.channels.fetch(channel_id);
-    if (!channel?.threads) throw new Error(`Channel ${channel_id} 不支持创建帖子`);
+    if (!channel?.threads) throw new Error(t(context.locale, 'threadsUnsupported', { p0: channel_id }));
     const thread = await channel.threads.create({
       name,
       autoArchiveDuration: auto_archive_duration || 1440,
       ...(message_id ? { startMessage: message_id } : {}),
     });
-    return { success: true, thread_id: thread.id, message: `帖子 "${name}" 已创建` };
+    return { success: true, thread_id: thread.id, message: t(context.locale, 'threadCreated', { p0: name }) };
   },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/forum_post/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 { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -12,13 +13,14 @@ export default defineAgentTool({
         tags: z.string().optional().describe('标签名，逗号分隔（可选）'),
     }),
     adapter: 'discord',
+    scopes: ["channel"],
     tags: ['discord'],
     async execute({ channel_id, name, content, tags }, context) {
         const client = requireDiscordGatewayClient(context.$client);
         const tagList = tags ? tags.split(',').map((t) => t.trim()) : undefined;
         const channel = await client.channels.fetch(channel_id);
         if (!channel?.threads || channel.type !== ChannelType.GuildForum) {
-            throw new Error(`Channel ${channel_id} 不是论坛频道`);
+            throw new Error(t(context.locale, 'notForumChannel', { p0: channel_id }));
         }
         const tagIds = tagList?.length
             ? channel.availableTags?.filter((tag) => tagList.includes(tag.name)).map((tag) => tag.id)
@@ -28,6 +30,6 @@ export default defineAgentTool({
             message: { content },
             ...(tagIds?.length ? { appliedTags: tagIds } : {}),
         });
-        return { success: true, thread_id: thread.id, message: `论坛帖 "${name}" 已创建` };
+        return { success: true, thread_id: thread.id, message: t(context.locale, 'forumCreated', { p0: name }) };
     },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/forum_post/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -12,13 +13,14 @@ export default defineAgentTool<{ channel_id: string; name: string; content: stri
     tags: z.string().optional().describe('标签名，逗号分隔（可选）'),
   }),
   adapter: 'discord',
+  scopes: ["channel"],
   tags: ['discord'],
   async execute({ channel_id, name, content, tags  }: { channel_id: string; name: string; content: string; tags?: string }, context) {
     const client = requireDiscordGatewayClient(context.$client);
     const tagList = tags ? tags.split(',').map((t: string) => t.trim()) : undefined;
     const channel = await client.channels.fetch(channel_id);
     if (!channel?.threads || channel.type !== ChannelType.GuildForum) {
-      throw new Error(`Channel ${channel_id} 不是论坛频道`);
+      throw new Error(t(context.locale, 'notForumChannel', { p0: channel_id }));
     }
     const tagIds = tagList?.length
       ? channel.availableTags?.filter((tag) => tagList.includes(tag.name)).map((tag) => tag.id)
@@ -28,6 +30,6 @@ export default defineAgentTool<{ channel_id: string; name: string; content: stri
       message: { content },
       ...(tagIds?.length ? { appliedTags: tagIds } : {}),
     });
-    return { success: true, thread_id: thread.id, message: `论坛帖 "${name}" 已创建` };
+    return { success: true, thread_id: thread.id, message: t(context.locale, 'forumCreated', { p0: name }) };
   },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/list_roles/index.js

@@ -9,6 +9,7 @@ export default defineAgentTool({
         guild_id: z.string().describe('服务器 ID'),
     }),
     adapter: 'discord',
+    scopes: ["channel"],
     tags: ['discord'],
     permissions: [platformPermission('discord', 'manage_roles')],
     async execute({ guild_id }, context) {

package/agents/discord/skills/{discord → discord-guild}/tools/list_roles/index.ts

@@ -9,6 +9,7 @@ export default defineAgentTool<{ guild_id: string }>({
     guild_id: z.string().describe('服务器 ID'),
   }),
   adapter: 'discord',
+  scopes: ["channel"],
   tags: ['discord'],
   permissions: [platformPermission('discord', 'manage_roles')],
   async execute({ guild_id  }: { guild_id: string }, context) {

package/agents/discord/skills/{discord → discord-guild}/tools/remove_role/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 { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -11,6 +12,7 @@ export default defineAgentTool({
         role_id: z.string().describe('角色 ID'),
     }),
     adapter: 'discord',
+    scopes: ["channel"],
     tags: ['discord'],
     permissions: [platformPermission('discord', 'manage_roles')],
     async execute({ guild_id, user_id, role_id }, context) {
@@ -19,6 +21,6 @@ export default defineAgentTool({
         const member = await guild.members.fetch(user_id);
         await member.roles.remove(role_id);
         const success = true;
-        return { success, message: success ? `已移除用户 ${user_id} 的角色` : '操作失败' };
+        return { success, message: success ? t(context.locale, 'memberRoleRemoved', { p0: user_id }) : t(context.locale, 'operationFailed') };
     },
 });

package/agents/discord/skills/{discord → discord-guild}/tools/remove_role/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
@@ -11,6 +12,7 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
     role_id: z.string().describe('角色 ID'),
   }),
   adapter: 'discord',
+  scopes: ["channel"],
   tags: ['discord'],
   permissions: [platformPermission('discord', 'manage_roles')],
   async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
@@ -21,6 +23,6 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
     };
     await member.roles.remove(role_id);
     const success = true;
-    return { success, message: success ? `已移除用户 ${user_id} 的角色` : '操作失败' };
+    return { success, message: success ? t(context.locale, 'memberRoleRemoved', { p0: user_id }) : t(context.locale, 'operationFailed') };
   },
 });

package/lib/webhook.d.ts

@@ -2,12 +2,14 @@
  * Discord interactions HTTP: signature → parse → admit.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type Locale } from 'zhin.js/i18n';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { type DiscordInboundMessage, type DiscordButtonInbound, type ResolvedDiscordInteractionsConfig } from './protocol.js';
 export interface DiscordInteractionsHandler {
     readonly config: ResolvedDiscordInteractionsConfig;
     readonly isOpen: boolean;
     admit(msg: DiscordInboundMessage): void;
+    resolveLocale?(senderId: string): Promise<Locale | undefined>;
     admitButton(interaction: DiscordButtonInbound): void;
     admitPlatform(event: Record<string, unknown>): void;
 }

package/lib/webhook.js

@@ -1,6 +1,10 @@
+import { createMessages } from 'zhin.js/i18n';
 import { getLogger } from '@zhin.js/logger';
 import { interactionToInboundMessage, verifyDiscordInteractionSignature, } from './protocol.js';
 const logger = getLogger('discord');
+const messages = createMessages({
+    processing: { 'zh-CN': '处理命令: {command}', en: 'Processing command: {command}' },
+});
 const INTERACTION_TYPE_PING = 1;
 const INTERACTION_TYPE_APPLICATION_COMMAND = 2;
 const INTERACTION_RESPONSE_PONG = 1;
@@ -52,15 +56,17 @@ export async function handleDiscordInteractionRequest(request, response, handler
             }
         }
         if (interaction.type === INTERACTION_TYPE_APPLICATION_COMMAND) {
+            const message = interactionToInboundMessage(interaction);
             if (handler.isOpen) {
-                handler.admit(interactionToInboundMessage(interaction));
+                handler.admit(message);
             }
+            const locale = await handler.resolveLocale?.(message.authorId);
             // 即时响应（type 4）：defer(type 5) 需要 followup PATCH，未实现会让用户端一直转圈
             const commandName = String(interaction.data?.name ?? '');
             writeJson(response, 200, {
                 type: INTERACTION_RESPONSE_CHANNEL_MESSAGE_WITH_SOURCE,
                 data: {
-                    content: `处理命令: ${commandName}`,
+                    content: messages(locale, 'processing', { command: commandName }),
                     flags: INTERACTION_FLAG_EPHEMERAL,
                 },
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-discord",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "Zhin.js Discord adapter for Plugin Runtime (Gateway WebSocket)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,24 +34,24 @@
     "discord.js": "^14.27.0",
     "@discordjs/ws": "1.2.3",
     "@discordjs/collection": "2.1.1",
-    "undici": "6.28.0",
-    "@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",
+    "undici": "6.29.1",
+    "@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/permission": "1.1.7",
-    "@zhin.js/skill": "1.1.8",
-    "@zhin.js/tool": "1.1.8"
+    "@zhin.js/permission": "1.1.9",
+    "@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": "^1.1.14"
+    "@zhin.js/adapter": "^1.1.23",
+    "@zhin.js/command": "^1.1.11",
+    "@zhin.js/core": "^1.1.51",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -69,8 +69,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

@@ -76,7 +76,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（Discord user snowflake；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（Discord user snowflake；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (Discord user snowflake; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -87,7 +92,12 @@
         ],
         "description": "Trusted Discord user snowflake"
       },
-      "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",
@@ -102,7 +112,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（Discord user snowflake）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（Discord user snowflake）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (Discord user snowflake), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -113,7 +128,12 @@
               ],
               "description": "Trusted Discord user snowflake"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "token": {
             "type": "string",
@@ -204,19 +224,34 @@
             "required": [
               "port"
             ],
-            "description": "Gateway测试实例REST专用故障代理：discord.com:443固定loopback TCP，保留SNI/证书校验，独立于Gateway代理"
+            "description": "Gateway测试实例REST专用故障代理：discord.com:443固定loopback TCP，保留SNI/证书校验，独立于Gateway代理",
+            "x-i18n": {
+              "en": {
+                "description": "REST-only fault proxy for Gateway tests: pin discord.com:443 TCP to loopback while preserving SNI and certificate validation, independently of the Gateway proxy."
+              }
+            }
           }
         },
         "required": [
           "id",
           "token"
         ]
+      },
+      "x-i18n": {
+        "en": {
+          "description": "Multiple accounts: each entry defines an endpoint. id and token are required; other fields override instance 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."
+        }
+      }
     },
     "gatewayFaultProxyUrl": {
       "type": "string",

package/src/webhook.ts

@@ -2,6 +2,7 @@
  * Discord interactions HTTP: signature → parse → admit.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import { createMessages, type Locale } from 'zhin.js/i18n';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import {
@@ -13,6 +14,9 @@ import {
 } from './protocol.js';
 
 const logger = getLogger('discord');
+const messages = createMessages({
+  processing: { 'zh-CN': '处理命令: {command}', en: 'Processing command: {command}' },
+});
 
 const INTERACTION_TYPE_PING = 1;
 const INTERACTION_TYPE_APPLICATION_COMMAND = 2;
@@ -25,6 +29,7 @@ export interface DiscordInteractionsHandler {
   readonly config: ResolvedDiscordInteractionsConfig;
   readonly isOpen: boolean;
   admit(msg: DiscordInboundMessage): void;
+  resolveLocale?(senderId: string): Promise<Locale | undefined>;
   admitButton(interaction: DiscordButtonInbound): void;
   admitPlatform(event: Record<string, unknown>): void;
 }
@@ -82,9 +87,11 @@ export async function handleDiscordInteractionRequest(
       }
     }
     if (interaction.type === INTERACTION_TYPE_APPLICATION_COMMAND) {
+      const message = interactionToInboundMessage(interaction);
       if (handler.isOpen) {
-        handler.admit(interactionToInboundMessage(interaction));
+        handler.admit(message);
       }
+      const locale = await handler.resolveLocale?.(message.authorId);
       // 即时响应（type 4）：defer(type 5) 需要 followup PATCH，未实现会让用户端一直转圈
       const commandName = String(
         (interaction.data as { name?: unknown } | undefined)?.name ?? '',
@@ -92,7 +99,7 @@ export async function handleDiscordInteractionRequest(
       writeJson(response, 200, {
         type: INTERACTION_RESPONSE_CHANNEL_MESSAGE_WITH_SOURCE,
         data: {
-          content: `处理命令: ${commandName}`,
+          content: messages(locale, 'processing', { command: commandName }),
           flags: INTERACTION_FLAG_EPHEMERAL,
         },
       });