@zhin.js/adapter-telegram 1.1.15 → 1.1.17

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 1.1.17
+
+### Patch Changes
+
+- Updated dependencies [f67883e]
+- Updated dependencies [e23cabc]
+- Updated dependencies [4d728c0]
+- Updated dependencies [eb8feeb]
+- Updated dependencies [24a2b71]
+- Updated dependencies [d0e1fac]
+- Updated dependencies [1ca669a]
+- Updated dependencies [3771f7a]
+- Updated dependencies [4f96ad5]
+  - @zhin.js/core@1.1.52
+  - @zhin.js/adapter@1.1.24
+  - @zhin.js/tool@1.1.11
+  - @zhin.js/host-http@1.1.11
+  - @zhin.js/im-contract@1.1.8
+
+## 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

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/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';
@@ -14,6 +15,6 @@ export default defineAgentTool({
     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';
@@ -14,6 +15,6 @@ export default defineAgentTool<{ chat_id: string }>({
   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/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({
@@ -12,6 +13,6 @@ export default defineAgentTool({
     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';
 
@@ -12,6 +13,6 @@ export default defineAgentTool<{ chat_id: string }>({
   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';
@@ -15,6 +16,6 @@ export default defineAgentTool({
     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';
@@ -15,6 +16,6 @@ export default defineAgentTool<{ chat_id: string; message_id: string }>({
   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({
@@ -13,6 +14,6 @@ export default defineAgentTool({
     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';
 
@@ -13,6 +14,6 @@ export default defineAgentTool<{ chat_id: string; description: string }>({
   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';
@@ -15,6 +16,6 @@ export default defineAgentTool({
     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';
@@ -15,6 +16,6 @@ export default defineAgentTool<{ chat_id: string; message_id?: string }>({
   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/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';
@@ -28,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-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';
@@ -27,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.15",
+  "version": "1.1.17",
   "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.22",
-    "@zhin.js/agent-feature": "1.1.9",
-    "@zhin.js/core": "1.1.50",
-    "@zhin.js/feature-kit": "1.1.8",
-    "@zhin.js/host-http": "1.1.9",
-    "@zhin.js/im-contract": "1.1.6",
+    "@zhin.js/adapter": "1.1.24",
+    "@zhin.js/agent-feature": "1.1.10",
+    "@zhin.js/core": "1.1.52",
+    "@zhin.js/feature-kit": "1.1.9",
+    "@zhin.js/host-http": "1.1.11",
+    "@zhin.js/im-contract": "1.1.8",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/skill": "1.1.9",
-    "@zhin.js/tool": "1.1.9"
+    "@zhin.js/skill": "1.1.10",
+    "@zhin.js/tool": "1.1.11"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.22",
-    "@zhin.js/command": "^1.1.10",
-    "@zhin.js/core": "^1.1.50",
-    "@zhin.js/permission": "^1.1.8",
-    "zhin.js": "^1.1.15"
+    "@zhin.js/adapter": "^1.1.24",
+    "@zhin.js/command": "^1.1.11",
+    "@zhin.js/core": "^1.1.52",
+    "@zhin.js/permission": "^1.1.9",
+    "zhin.js": "^1.1.17"
   },
   "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.9",
-    "zhin.js": "1.1.15"
+    "@zhin.js/host-http": "1.1.11",
+    "zhin.js": "1.1.17"
   },
   "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": [