@zhin.js/adapter-dingtalk 1.1.15 → 1.1.17

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @zhin.js/adapter-dingtalk
 
+## 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/dingtalk/messages.js

@@ -0,0 +1,32 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    "createFailed": {
+        "zh-CN": "创建失败",
+        "en": "Creation failed"
+    },
+    "chatCreated": {
+        "zh-CN": "群聊创建成功: {p0}",
+        "en": "Group chat created: {p0}"
+    },
+    "sendFailed": {
+        "zh-CN": "发送失败",
+        "en": "Delivery failed"
+    },
+    "workNoticeSent": {
+        "zh-CN": "工作通知已发送",
+        "en": "Work notification sent"
+    },
+    "addFailed": {
+        "zh-CN": "添加失败",
+        "en": "Could not add members"
+    },
+    "membersAdded": {
+        "zh-CN": "成员添加成功",
+        "en": "Members added"
+    },
+    "chatUpdated": {
+        "zh-CN": "群聊设置已更新",
+        "en": "Group chat settings updated"
+    }
+});

package/agents/dingtalk/messages.ts

@@ -0,0 +1,32 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  "createFailed": {
+    "zh-CN": "创建失败",
+    "en": "Creation failed"
+  },
+  "chatCreated": {
+    "zh-CN": "群聊创建成功: {p0}",
+    "en": "Group chat created: {p0}"
+  },
+  "sendFailed": {
+    "zh-CN": "发送失败",
+    "en": "Delivery failed"
+  },
+  "workNoticeSent": {
+    "zh-CN": "工作通知已发送",
+    "en": "Work notification sent"
+  },
+  "addFailed": {
+    "zh-CN": "添加失败",
+    "en": "Could not add members"
+  },
+  "membersAdded": {
+    "zh-CN": "成员添加成功",
+    "en": "Members added"
+  },
+  "chatUpdated": {
+    "zh-CN": "群聊设置已更新",
+    "en": "Group chat settings updated"
+  }
+});

package/agents/dingtalk/skills/dingtalk/tools/create_chat/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({ name, owner, members }, context) {
         const endpoint = context.$client;
         const chatId = await endpoint.createChat(name, owner, members.split(','));
-        return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
+        return { success: !!chatId, chat_id: chatId, message: chatId ? t(context.locale, 'chatCreated', { p0: chatId }) : t(context.locale, 'createFailed') };
     },
 });

package/agents/dingtalk/skills/dingtalk/tools/create_chat/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,7 +16,7 @@ export default defineAgentTool<{ name: string; owner: string; members: string }>
   async execute({ name, owner, members    }: { name: string; owner: string; members: string }, context) {
     const endpoint = context.$client;
     const chatId = await endpoint.createChat(name, owner, members.split(','));
-    return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
+    return { success: !!chatId, chat_id: chatId, message: chatId ? t(context.locale, 'chatCreated', { p0: chatId }) : t(context.locale, 'createFailed') };
   },
 });
 

package/agents/dingtalk/skills/dingtalk/tools/send_work_notice/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({
         const endpoint = context.$client;
         const msgContent = { msgtype: 'text', text: { content } };
         const success = await endpoint.sendWorkNotice(user_ids.split(','), msgContent);
-        return { success, message: success ? '工作通知已发送' : '发送失败' };
+        return { success, message: success ? t(context.locale, 'workNoticeSent') : t(context.locale, 'sendFailed') };
     },
 });

package/agents/dingtalk/skills/dingtalk/tools/send_work_notice/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ user_ids: string; content: string }>({
@@ -12,7 +13,7 @@ export default defineAgentTool<{ user_ids: string; content: string }>({
     const endpoint = context.$client;
     const msgContent = { msgtype: 'text', text: { content } };
     const success = await endpoint.sendWorkNotice(user_ids.split(','), msgContent);
-    return { success, message: success ? '工作通知已发送' : '发送失败' };
+    return { success, message: success ? t(context.locale, 'workNoticeSent') : t(context.locale, 'sendFailed') };
   },
 });
 

package/agents/dingtalk/skills/dingtalk-group-admin/tools/add_chat_members/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, user_ids }, context) {
         const endpoint = context.$client;
         const success = await endpoint.updateChat(chat_id, { add_useridlist: user_ids.split(',') });
-        return { success, message: success ? '成员添加成功' : '添加失败' };
+        return { success, message: success ? t(context.locale, 'membersAdded') : t(context.locale, 'addFailed') };
     },
 });

package/agents/dingtalk/skills/dingtalk-group-admin/tools/add_chat_members/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,7 +16,7 @@ export default defineAgentTool<{ chat_id: string; user_ids: string }>({
   async execute({ chat_id, user_ids    }: { chat_id: string; user_ids: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.updateChat(chat_id, { add_useridlist: user_ids.split(',') });
-    return { success, message: success ? '成员添加成功' : '添加失败' };
+    return { success, message: success ? t(context.locale, 'membersAdded') : t(context.locale, 'addFailed') };
   },
 });
 

package/agents/dingtalk/skills/dingtalk-group-admin/tools/update_chat/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({
@@ -25,6 +26,6 @@ export default defineAgentTool({
         if (remove_members)
             options.del_useridlist = remove_members.split(',').map((s) => s.trim());
         await endpoint.updateChat(chat_id, options);
-        return { success: true, message: '群聊设置已更新' };
+        return { success: true, message: t(context.locale, 'chatUpdated') };
     },
 });

package/agents/dingtalk/skills/dingtalk-group-admin/tools/update_chat/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool<{ chat_id: string; name?: string; owner?: string; add_members?: string; remove_members?: string }>({
@@ -20,7 +21,7 @@ export default defineAgentTool<{ chat_id: string; name?: string; owner?: string;
     if (add_members) options.add_useridlist = add_members.split(',').map((s: string) => s.trim());
     if (remove_members) options.del_useridlist = remove_members.split(',').map((s: string) => s.trim());
     await endpoint.updateChat(chat_id, options);
-    return { success: true, message: '群聊设置已更新' };
+    return { success: true, message: t(context.locale, 'chatUpdated') };
   },
 });
 

package/commands/dingtalk/endpoint/definition.js

@@ -10,9 +10,9 @@ export const dingtalkEndpointCommands = createEndpointCommands({
     adapterKey: 'dingtalk',
     adapterDisplayName: 'DingTalk',
     fields: [
-        { key: 'appKey', required: true, env: true, description: '钉钉 AppKey' },
-        { key: 'appSecret', required: true, env: true, description: '钉钉 AppSecret' },
-        { key: 'robotCode', required: true, env: true, description: '机器人 Code（出站 senderStaffId）' },
+        { key: 'appKey', required: true, env: true, description: '钉钉 AppKey', descriptionI18n: { en: "DingTalk app key" } },
+        { key: 'appSecret', required: true, env: true, description: '钉钉 AppSecret', descriptionI18n: { en: "DingTalk app secret" } },
+        { key: 'robotCode', required: true, env: true, description: '机器人 Code（出站 senderStaffId）', descriptionI18n: { en: "Robot code (outbound senderStaffId)" } },
     ],
     running: (use) => use(dingtalkRuntimeStateToken).endpoints.values(),
     describeEntry: (entry) => `appKey: ${String(entry.appKey)}`,

package/commands/dingtalk/endpoint/definition.ts

@@ -10,9 +10,9 @@ export const dingtalkEndpointCommands = createEndpointCommands({
   adapterKey: 'dingtalk',
   adapterDisplayName: 'DingTalk',
   fields: [
-    { key: 'appKey', required: true, env: true, description: '钉钉 AppKey' },
-    { key: 'appSecret', required: true, env: true, description: '钉钉 AppSecret' },
-    { key: 'robotCode', required: true, env: true, description: '机器人 Code（出站 senderStaffId）' },
+    { key: 'appKey', required: true, env: true, description: '钉钉 AppKey', descriptionI18n: { en: "DingTalk app key" } },
+    { key: 'appSecret', required: true, env: true, description: '钉钉 AppSecret', descriptionI18n: { en: "DingTalk app secret" } },
+    { key: 'robotCode', required: true, env: true, description: '机器人 Code（出站 senderStaffId）', descriptionI18n: { en: "Robot code (outbound senderStaffId)" } },
   ],
   running: (use) => use(dingtalkRuntimeStateToken).endpoints.values(),
   describeEntry: (entry) => `appKey: ${String(entry.appKey)}`,

package/lib/cards.d.ts

@@ -1,3 +1,4 @@
+import type { Locale } from 'zhin.js/i18n';
 import { type ConversationRef } from '@zhin.js/im-contract';
 import type { DingTalkMessage, ResolvedDingTalkConfig } from './protocol.js';
 export interface DingTalkCardCallback {
@@ -24,7 +25,7 @@ export declare class DingTalkCards {
     #private;
     remember(conversation: ConversationRef, event: DingTalkMessage): void;
     clear(): void;
-    prepare(config: ResolvedDingTalkConfig, conversation: ConversationRef, payload: unknown): {
+    prepare(config: ResolvedDingTalkConfig, conversation: ConversationRef, payload: unknown, locale?: Locale): {
         id: `${string}-${string}-${string}-${string}-${string}`;
         record: CardRecord;
         epoch: number;

package/lib/cards.js

@@ -1,3 +1,4 @@
+import { messages as t } from './i18n.js';
 import { randomUUID } from 'node:crypto';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /** Endpoint-owned, bounded correlation. Cards from old generations deliberately cannot dispatch. */
@@ -12,7 +13,7 @@ export class DingTalkCards {
             this.#contexts.delete(this.#contexts.keys().next().value);
     }
     clear() { this.#epoch++; this.#records.clear(); this.#contexts.clear(); }
-    prepare(config, conversation, payload) {
+    prepare(config, conversation, payload, locale) {
         const segments = Array.isArray(payload) ? payload : [payload];
         const keyboard = segments.filter(item => item && typeof item === 'object' && item.type === 'keyboard');
         if (!keyboard.length)
@@ -42,7 +43,7 @@ export class DingTalkCards {
                 return String(item.data?.text ?? item.data?.content ?? '');
             throw new EndpointDeliveryError('invalid_payload', 'DingTalk interactive cards accept text/markdown and keyboard only', 'not_sent');
         }).join('');
-        const cardParamMap = { title: '消息', text };
+        const cardParamMap = { title: t(locale, 'message'), text };
         for (let i = 0; i < count; i++) {
             cardParamMap[`button${i}_label`] = buttons[i]?.label ?? '';
             cardParamMap[`button${i}_payload`] = buttons[i]?.payload ?? '';

package/lib/endpoint.d.ts

@@ -70,7 +70,7 @@ export declare class DingTalkEndpoint extends Endpoint<DingTalkClient> {
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    send({ conversation, payload, locale }: EndpointSendRequest): Promise<string>;
     admitCard(event: DingTalkCardCallback, id: string): Promise<void>;
     /** Test / internal: admit a parsed event when open (non-webhook path). */
     admit(event: DingTalkEvent | DingTalkMessage): Promise<void>;

package/lib/endpoint.js

@@ -105,9 +105,9 @@ export class DingTalkEndpoint extends Endpoint {
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
-    async send({ conversation, payload }) {
+    async send({ conversation, payload, locale }) {
         try {
-            const card = this.#cards.prepare(this.config, conversation, payload);
+            const card = this.#cards.prepare(this.config, conversation, payload, locale);
             if (card) {
                 let stage = 'token';
                 let httpStatus;
@@ -151,7 +151,7 @@ export class DingTalkEndpoint extends Endpoint {
                     throw error;
                 }
             }
-            const content = formatOutboundBody(payload);
+            const content = formatOutboundBody(payload, locale);
             const session = this.#sessionWebhooks.get(conversation.id);
             const sessionWebhook = session && session.expiresAt > Date.now() ? session.url : undefined;
             if (session && !sessionWebhook)

package/lib/i18n.d.ts

@@ -0,0 +1 @@
+export declare const messages: (locale: import("zhin.js").Locale | undefined, key: "openLink" | "link" | "message", values?: import("zhin.js").MessageValues) => string;

package/lib/i18n.js

@@ -0,0 +1,6 @@
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    openLink: { 'zh-CN': '打开链接', en: 'Open link' },
+    link: { 'zh-CN': '链接', en: 'Link' },
+    message: { 'zh-CN': '消息', en: 'Message' }
+});

package/lib/protocol.d.ts

@@ -1,7 +1,4 @@
-/**
- * DingTalk protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
- * Canonicalization is owned by gateway/core before endpoint.send.
- */
+import type { Locale } from 'zhin.js/i18n';
 import type { IncomingMessage } from 'node:http';
 import { type ConversationRef } from '@zhin.js/im-contract';
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
@@ -131,7 +128,7 @@ export declare function verifySignature(appSecret: string, timestamp: string, si
  * 钉钉机器人图片使用官方 Markdown HTTP(S) 图片链接，保留同载荷文本和图片顺序。
  * 本地媒体上传、原生引用、音频/视频/文件未接线，在请求前明确拒绝。
  */
-export declare function formatOutboundBody(payload: unknown): DingTalkSendBody;
+export declare function formatOutboundBody(payload: unknown, locale?: Locale): DingTalkSendBody;
 export declare function headerValue(headers: IncomingMessage['headers'], name: string): string;
 export declare function readTextBody(request: IncomingMessage, options?: {
     readonly limit?: number;

package/lib/protocol.js

@@ -1,3 +1,4 @@
+import { messages as t } from './i18n.js';
 /**
  * DingTalk protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -143,7 +144,7 @@ export function verifySignature(appSecret, timestamp, sign) {
  * 钉钉机器人图片使用官方 Markdown HTTP(S) 图片链接，保留同载荷文本和图片顺序。
  * 本地媒体上传、原生引用、音频/视频/文件未接线，在请求前明确拒绝。
  */
-export function formatOutboundBody(payload) {
+export function formatOutboundBody(payload, locale) {
     if (typeof payload === 'string') {
         return { msgtype: 'text', text: { content: payload } };
     }
@@ -199,7 +200,7 @@ export function formatOutboundBody(payload) {
                     throw new EndpointDeliveryError('invalid_payload', 'DingTalk share requires an HTTP(S) URL', 'not_sent');
                 if (media)
                     throw new EndpointDeliveryError('invalid_payload', 'DingTalk accepts one link card per message', 'not_sent');
-                media = { msgtype: 'link', link: { title: String(data.title ?? '链接'), text: String(data.description ?? data.content ?? ''), messageUrl: url.toString(), ...(typeof data.image === 'string' ? { picUrl: data.image } : {}) } };
+                media = { msgtype: 'link', link: { title: String(data.title ?? t(locale, 'link')), text: String(data.description ?? data.content ?? ''), messageUrl: url.toString(), ...(typeof data.image === 'string' ? { picUrl: data.image } : {}) } };
                 break;
             }
             case 'keyboard':
@@ -216,7 +217,7 @@ export function formatOutboundBody(payload) {
                     }
                     if (!['https:', 'http:'].includes(url.protocol))
                         throw new EndpointDeliveryError('invalid_payload', 'DingTalk image requires an HTTP(S) URL', 'not_sent');
-                    markdownTitle ??= '消息';
+                    markdownTitle ??= t(locale, 'message');
                     textParts.push(`\n![](${ref.value.replace(/[()\s]/g, character => encodeURIComponent(character))})\n`);
                     break;
                 }
@@ -227,7 +228,7 @@ export function formatOutboundBody(payload) {
             case 'file':
                 throw new EndpointDeliveryError('unsupported_operation', 'DingTalk audio/video/file delivery is not implemented', 'not_sent');
             case 'markdown':
-                markdownTitle ??= String(data.title || '消息');
+                markdownTitle ??= String(data.title || t(locale, 'message'));
                 textParts.push(String(data.content ?? data.text ?? ''));
                 break;
             case 'link':
@@ -235,7 +236,7 @@ export function formatOutboundBody(payload) {
                     media = {
                         msgtype: 'link',
                         link: {
-                            title: String(data.title || '链接'),
+                            title: String(data.title || t(locale, 'link')),
                             text: String(data.text ?? data.content ?? ''),
                             messageUrl: typeof data.url === 'string' ? data.url : undefined,
                             picUrl: typeof data.picUrl === 'string' ? data.picUrl : undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-dingtalk",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "Zhin.js DingTalk (钉钉) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,24 +33,24 @@
   },
   "dependencies": {
     "ws": "^8.18.3",
-    "@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/host-http": "^1.1.9",
-    "@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/host-http": "^1.1.11",
+    "@zhin.js/permission": "^1.1.9",
+    "zhin.js": "^1.1.17"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -69,7 +69,7 @@
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
     "@types/ws": "^8.18.1",
-    "zhin.js": "1.1.15"
+    "zhin.js": "1.1.17"
   },
   "files": [
     "adapters",

package/schema.json

@@ -12,7 +12,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（DingTalk userid；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（DingTalk userid；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (DingTalk userid; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -23,7 +28,12 @@
         ],
         "description": "Trusted DingTalk userid"
       },
-      "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",
@@ -38,7 +48,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（DingTalk userid）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（DingTalk userid）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (DingTalk userid), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -49,7 +64,12 @@
               ],
               "description": "Trusted DingTalk userid"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "appKey": {
             "type": "string",
@@ -116,7 +136,12 @@
               "port",
               "serverName"
             ],
-            "description": "故障验收专用：TCP固定127.0.0.1，保留真实WSS TLS身份"
+            "description": "故障验收专用：TCP固定127.0.0.1，保留真实WSS TLS身份",
+            "x-i18n": {
+              "en": {
+                "description": "Fault-injection tests only: pin TCP to 127.0.0.1 while preserving the actual WSS TLS identity."
+              }
+            }
           }
         },
         "required": [
@@ -124,12 +149,22 @@
           "appKey",
           "appSecret"
         ]
+      },
+      "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."
+        }
+      }
     },
     "mode": {
       "type": "string",

package/src/cards.ts

@@ -1,3 +1,5 @@
+import type { Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 import { randomUUID } from 'node:crypto';
 import { EndpointDeliveryError, type ConversationRef } from '@zhin.js/im-contract';
 import type { DingTalkMessage, ResolvedDingTalkConfig } from './protocol.js';
@@ -14,7 +16,7 @@ export class DingTalkCards {
     while (this.#contexts.size > 1024) this.#contexts.delete(this.#contexts.keys().next().value!);
   }
   clear(): void { this.#epoch++; this.#records.clear(); this.#contexts.clear(); }
-  prepare(config: ResolvedDingTalkConfig, conversation: ConversationRef, payload: unknown) {
+  prepare(config: ResolvedDingTalkConfig, conversation: ConversationRef, payload: unknown, locale?: Locale) {
     const segments = Array.isArray(payload) ? payload : [payload];
     const keyboard = segments.filter(item => item && typeof item === 'object' && item.type === 'keyboard');
     if (!keyboard.length) return undefined;
@@ -35,7 +37,7 @@ export class DingTalkCards {
       if (item?.type === 'text' || item?.type === 'markdown') return String(item.data?.text ?? item.data?.content ?? '');
       throw new EndpointDeliveryError('invalid_payload', 'DingTalk interactive cards accept text/markdown and keyboard only', 'not_sent');
     }).join('');
-    const cardParamMap: Record<string, string> = { title: '消息', text };
+    const cardParamMap: Record<string, string> = { title: t(locale, 'message'), text };
     for (let i = 0; i < count; i++) { cardParamMap[`button${i}_label`] = buttons[i]?.label ?? ''; cardParamMap[`button${i}_payload`] = buttons[i]?.payload ?? ''; cardParamMap[`button${i}_visible`] = buttons[i] ? 'true' : 'false'; }
     const id = randomUUID();
     const record: CardRecord = { conversation, spaceType, spaceId, staffId: context.senderStaffId, senderId: context.senderId, corpId: context.senderCorpId, payloads: new Set(buttons.map((button: any) => button.payload)), expiresAt: Date.now() + 3_600_000 };

package/src/endpoint.ts

@@ -169,9 +169,9 @@ export class DingTalkEndpoint extends Endpoint<DingTalkClient> {
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
+  async send({ conversation, payload, locale }: EndpointSendRequest): Promise<string> {
     try {
-      const card = this.#cards.prepare(this.config, conversation, payload);
+      const card = this.#cards.prepare(this.config, conversation, payload, locale);
       if (card) {
         let stage = 'token';
         let httpStatus: number | undefined;
@@ -202,7 +202,7 @@ export class DingTalkEndpoint extends Endpoint<DingTalkClient> {
           throw error;
         }
       }
-      const content = formatOutboundBody(payload);
+      const content = formatOutboundBody(payload, locale);
       const session = this.#sessionWebhooks.get(conversation.id);
       const sessionWebhook = session && session.expiresAt > Date.now() ? session.url : undefined;
       if (session && !sessionWebhook) this.#sessionWebhooks.delete(conversation.id);

package/src/i18n.ts

@@ -0,0 +1,7 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  openLink: { 'zh-CN': '打开链接', en: 'Open link' },
+  link: { 'zh-CN': '链接', en: 'Link' },
+  message: { 'zh-CN': '消息', en: 'Message' }
+});

package/src/protocol.ts

@@ -1,3 +1,5 @@
+import { messages as t } from './i18n.js';
+import type { Locale } from 'zhin.js/i18n';
 /**
  * DingTalk protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -250,7 +252,7 @@ export function verifySignature(
  * 钉钉机器人图片使用官方 Markdown HTTP(S) 图片链接，保留同载荷文本和图片顺序。
  * 本地媒体上传、原生引用、音频/视频/文件未接线，在请求前明确拒绝。
  */
-export function formatOutboundBody(payload: unknown): DingTalkSendBody {
+export function formatOutboundBody(payload: unknown, locale?: Locale): DingTalkSendBody {
   if (typeof payload === 'string') {
     return { msgtype: 'text', text: { content: payload } };
   }
@@ -303,7 +305,7 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
         try { url = new URL(String(data.url ?? '')); } catch { throw new EndpointDeliveryError('invalid_payload', 'DingTalk share requires an HTTP(S) URL', 'not_sent'); }
         if (!['https:', 'http:'].includes(url.protocol)) throw new EndpointDeliveryError('invalid_payload', 'DingTalk share requires an HTTP(S) URL', 'not_sent');
         if (media) throw new EndpointDeliveryError('invalid_payload', 'DingTalk accepts one link card per message', 'not_sent');
-        media = { msgtype: 'link', link: { title: String(data.title ?? '链接'), text: String(data.description ?? data.content ?? ''), messageUrl: url.toString(), ...(typeof data.image === 'string' ? { picUrl: data.image } : {}) } };
+        media = { msgtype: 'link', link: { title: String(data.title ?? t(locale, 'link')), text: String(data.description ?? data.content ?? ''), messageUrl: url.toString(), ...(typeof data.image === 'string' ? { picUrl: data.image } : {}) } };
         break;
       }
       case 'keyboard':
@@ -314,7 +316,7 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
           let url: URL;
           try { url = new URL(ref.value); } catch { throw new EndpointDeliveryError('invalid_payload', 'DingTalk image requires an HTTP(S) URL', 'not_sent'); }
           if (!['https:', 'http:'].includes(url.protocol)) throw new EndpointDeliveryError('invalid_payload', 'DingTalk image requires an HTTP(S) URL', 'not_sent');
-          markdownTitle ??= '消息';
+          markdownTitle ??= t(locale, 'message');
           textParts.push(`\n![](${ref.value.replace(/[()\s]/g, character => encodeURIComponent(character))})\n`);
           break;
         }
@@ -325,7 +327,7 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
       case 'file':
         throw new EndpointDeliveryError('unsupported_operation', 'DingTalk audio/video/file delivery is not implemented', 'not_sent');
       case 'markdown':
-        markdownTitle ??= String(data.title || '消息');
+        markdownTitle ??= String(data.title || t(locale, 'message'));
         textParts.push(String(data.content ?? data.text ?? ''));
         break;
       case 'link':
@@ -333,7 +335,7 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
           media = {
             msgtype: 'link',
             link: {
-              title: String(data.title || '链接'),
+              title: String(data.title || t(locale, 'link')),
               text: String(data.text ?? data.content ?? ''),
               messageUrl: typeof data.url === 'string' ? data.url : undefined,
               picUrl: typeof data.picUrl === 'string' ? data.picUrl : undefined,