@zhin.js/adapter-lark 1.1.15 → 1.1.17

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @zhin.js/adapter-lark
 
+## 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 绑定与交互状态保留完整会话身份。
+- 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/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/lark/messages.js

@@ -0,0 +1,57 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    fileUploadFailed: { 'zh-CN': '文件上传失败，未返回文件标识', en: 'File upload failed; no file key was returned.' },
+    "createFailed": {
+        "zh-CN": "创建失败",
+        "en": "Creation failed"
+    },
+    "chatCreated": {
+        "zh-CN": "群聊创建成功: {p0}",
+        "en": "Group chat created: {p0}"
+    },
+    "fileUploaded": {
+        "zh-CN": "文件已上传，file_key: {p0}",
+        "en": "File uploaded, file_key: {p0}"
+    },
+    "addFailed": {
+        "zh-CN": "添加失败",
+        "en": "Could not add members"
+    },
+    "membersAdded": {
+        "zh-CN": "成员添加成功",
+        "en": "Members added"
+    },
+    "dissolveFailed": {
+        "zh-CN": "解散失败",
+        "en": "Could not dissolve the group chat"
+    },
+    "chatDissolved": {
+        "zh-CN": "群聊已解散",
+        "en": "Group chat dissolved"
+    },
+    "removeFailed": {
+        "zh-CN": "移除失败",
+        "en": "Removal failed"
+    },
+    "managersRemoved": {
+        "zh-CN": "管理员移除成功",
+        "en": "Administrators removed"
+    },
+    "setFailed": {
+        "zh-CN": "设置失败",
+        "en": "Update failed"
+    },
+    "managersSet": {
+        "zh-CN": "管理员设置成功",
+        "en": "Administrators set"
+    },
+    "updateFailed": {
+        "zh-CN": "更新失败",
+        "en": "Update failed"
+    },
+    "chatInfoUpdated": {
+        "zh-CN": "群信息更新成功",
+        "en": "Group information updated"
+    }
+});

package/agents/lark/messages.ts

@@ -0,0 +1,57 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  fileUploadFailed: { 'zh-CN': '文件上传失败，未返回文件标识', en: 'File upload failed; no file key was returned.' },
+  "createFailed": {
+    "zh-CN": "创建失败",
+    "en": "Creation failed"
+  },
+  "chatCreated": {
+    "zh-CN": "群聊创建成功: {p0}",
+    "en": "Group chat created: {p0}"
+  },
+  "fileUploaded": {
+    "zh-CN": "文件已上传，file_key: {p0}",
+    "en": "File uploaded, file_key: {p0}"
+  },
+  "addFailed": {
+    "zh-CN": "添加失败",
+    "en": "Could not add members"
+  },
+  "membersAdded": {
+    "zh-CN": "成员添加成功",
+    "en": "Members added"
+  },
+  "dissolveFailed": {
+    "zh-CN": "解散失败",
+    "en": "Could not dissolve the group chat"
+  },
+  "chatDissolved": {
+    "zh-CN": "群聊已解散",
+    "en": "Group chat dissolved"
+  },
+  "removeFailed": {
+    "zh-CN": "移除失败",
+    "en": "Removal failed"
+  },
+  "managersRemoved": {
+    "zh-CN": "管理员移除成功",
+    "en": "Administrators removed"
+  },
+  "setFailed": {
+    "zh-CN": "设置失败",
+    "en": "Update failed"
+  },
+  "managersSet": {
+    "zh-CN": "管理员设置成功",
+    "en": "Administrators set"
+  },
+  "updateFailed": {
+    "zh-CN": "更新失败",
+    "en": "Update failed"
+  },
+  "chatInfoUpdated": {
+    "zh-CN": "群信息更新成功",
+    "en": "Group information updated"
+  }
+});

package/agents/lark/skills/lark/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';
 export default defineAgentTool({
@@ -13,6 +14,6 @@ export default defineAgentTool({
     async execute({ name, members, owner }, context) {
         const endpoint = context.$client;
         const chatId = await endpoint.createChat(name, members.split(','), owner);
-        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/lark/skills/lark/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';
 export default defineAgentTool<{ name: string; members: string; owner?: string }>({
@@ -12,7 +13,7 @@ export default defineAgentTool<{ name: string; members: string; owner?: string }
   async execute({ name, members, owner   }: { name: string; members: string; owner?: string }, context) {
     const endpoint = context.$client;
     const chatId = await endpoint.createChat(name, members.split(','), owner);
-    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/lark/skills/lark/tools/upload_file/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,8 @@ export default defineAgentTool({
     async execute({ file_path, file_type }, context) {
         const endpoint = context.$client;
         const result = await endpoint.uploadFile(file_path, file_type);
-        return { success: true, file_key: result, message: `文件已上传，file_key: ${result}` };
+        if (result === null)
+            return { success: false, file_key: null, message: t(context.locale, 'fileUploadFailed') };
+        return { success: true, file_key: result, message: t(context.locale, 'fileUploaded', { p0: result }) };
     },
 });

package/agents/lark/skills/lark/tools/upload_file/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -18,6 +19,7 @@ export default defineAgentTool<{
   }, context) {
     const endpoint = context.$client;
     const result = await endpoint.uploadFile(file_path, file_type);
-    return { success: true, file_key: result, message: `文件已上传，file_key: ${result}` };
+    if (result === null) return { success: false, file_key: null, message: t(context.locale, 'fileUploadFailed') };
+    return { success: true, file_key: result, message: t(context.locale, 'fileUploaded', { p0: result }) };
   },
 });

package/agents/lark/skills/lark-group-admin/tools/add_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.addChatMembers(chat_id, user_ids.split(','));
-        return { success, message: success ? '成员添加成功' : '添加失败' };
+        return { success, message: success ? t(context.locale, 'membersAdded') : t(context.locale, 'addFailed') };
     },
 });

package/agents/lark/skills/lark-group-admin/tools/add_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,6 +16,6 @@ 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.addChatMembers(chat_id, user_ids.split(','));
-    return { success, message: success ? '成员添加成功' : '添加失败' };
+    return { success, message: success ? t(context.locale, 'membersAdded') : t(context.locale, 'addFailed') };
   },
 });

package/agents/lark/skills/lark-group-admin/tools/dissolve_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({
@@ -12,6 +13,6 @@ export default defineAgentTool({
     async execute({ chat_id }, context) {
         const endpoint = context.$client;
         const success = await endpoint.dissolveChat(chat_id);
-        return { success, message: success ? '群聊已解散' : '解散失败' };
+        return { success, message: success ? t(context.locale, 'chatDissolved') : t(context.locale, 'dissolveFailed') };
     },
 });

package/agents/lark/skills/lark-group-admin/tools/dissolve_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 }>({
@@ -11,7 +12,7 @@ export default defineAgentTool<{ chat_id: string }>({
   async execute({ chat_id   }: { chat_id: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.dissolveChat(chat_id);
-    return { success, message: success ? '群聊已解散' : '解散失败' };
+    return { success, message: success ? t(context.locale, 'chatDissolved') : t(context.locale, 'dissolveFailed') };
   },
 });
 

package/agents/lark/skills/lark-group-admin/tools/remove_managers/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.removeChatManagers(chat_id, user_ids.split(','));
-        return { success, message: success ? '管理员移除成功' : '移除失败' };
+        return { success, message: success ? t(context.locale, 'managersRemoved') : t(context.locale, 'removeFailed') };
     },
 });

package/agents/lark/skills/lark-group-admin/tools/remove_managers/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; user_ids: string }>({
   async execute({ chat_id, user_ids   }: { chat_id: string; user_ids: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.removeChatManagers(chat_id, user_ids.split(','));
-    return { success, message: success ? '管理员移除成功' : '移除失败' };
+    return { success, message: success ? t(context.locale, 'managersRemoved') : t(context.locale, 'removeFailed') };
   },
 });

package/agents/lark/skills/lark-group-admin/tools/set_managers/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.setChatManagers(chat_id, user_ids.split(','));
-        return { success, message: success ? '管理员设置成功' : '设置失败' };
+        return { success, message: success ? t(context.locale, 'managersSet') : t(context.locale, 'setFailed') };
     },
 });

package/agents/lark/skills/lark-group-admin/tools/set_managers/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; user_ids: string }>({
   async execute({ chat_id, user_ids   }: { chat_id: string; user_ids: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.setChatManagers(chat_id, user_ids.split(','));
-    return { success, message: success ? '管理员设置成功' : '设置失败' };
+    return { success, message: success ? t(context.locale, 'managersSet') : t(context.locale, 'setFailed') };
   },
 });

package/agents/lark/skills/lark-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';
 import { platformPermission } from '@zhin.js/permission';
@@ -16,6 +17,6 @@ export default defineAgentTool({
     async execute({ chat_id, name, description }, context) {
         const endpoint = context.$client;
         const success = await endpoint.updateChatInfo(chat_id, { name, description });
-        return { success, message: success ? '群信息更新成功' : '更新失败' };
+        return { success, message: success ? t(context.locale, 'chatInfoUpdated') : t(context.locale, 'updateFailed') };
     },
 });

package/agents/lark/skills/lark-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';
 import { platformPermission } from '@zhin.js/permission';
@@ -16,6 +17,6 @@ export default defineAgentTool<{ chat_id: string; name?: string; description?: s
   async execute({ chat_id, name, description   }: { chat_id: string; name?: string; description?: string }, context) {
     const endpoint = context.$client;
     const success = await endpoint.updateChatInfo(chat_id, { name, description });
-    return { success, message: success ? '群信息更新成功' : '更新失败' };
+    return { success, message: success ? t(context.locale, 'chatInfoUpdated') : t(context.locale, 'updateFailed') };
   },
 });

package/commands/lark/endpoint/definition.js

@@ -10,10 +10,10 @@ export const larkEndpointCommands = createEndpointCommands({
     adapterKey: 'lark',
     adapterDisplayName: 'Lark',
     fields: [
-        { key: 'appId', required: true, env: true, description: '飞书 App ID' },
-        { key: 'appSecret', required: true, env: true, description: '飞书 App Secret' },
-        { key: 'encryptKey', env: true, description: '事件加密 key' },
-        { key: 'verificationToken', env: true, description: '事件验证 token' },
+        { key: 'appId', required: true, env: true, description: '飞书 App ID', descriptionI18n: { en: "Lark app ID" } },
+        { key: 'appSecret', required: true, env: true, description: '飞书 App Secret', descriptionI18n: { en: "Lark app secret" } },
+        { key: 'encryptKey', env: true, description: '事件加密 key', descriptionI18n: { en: "Event encryption key" } },
+        { key: 'verificationToken', env: true, description: '事件验证 token', descriptionI18n: { en: "Event verification token" } },
     ],
     running: (use) => use(larkRuntimeStateToken).endpoints.values(),
     describeEntry: (entry) => `appId: ${String(entry.appId)}`,

package/commands/lark/endpoint/definition.ts

@@ -10,10 +10,10 @@ export const larkEndpointCommands = createEndpointCommands({
   adapterKey: 'lark',
   adapterDisplayName: 'Lark',
   fields: [
-    { key: 'appId', required: true, env: true, description: '飞书 App ID' },
-    { key: 'appSecret', required: true, env: true, description: '飞书 App Secret' },
-    { key: 'encryptKey', env: true, description: '事件加密 key' },
-    { key: 'verificationToken', env: true, description: '事件验证 token' },
+    { key: 'appId', required: true, env: true, description: '飞书 App ID', descriptionI18n: { en: "Lark app ID" } },
+    { key: 'appSecret', required: true, env: true, description: '飞书 App Secret', descriptionI18n: { en: "Lark app secret" } },
+    { key: 'encryptKey', env: true, description: '事件加密 key', descriptionI18n: { en: "Event encryption key" } },
+    { key: 'verificationToken', env: true, description: '事件验证 token', descriptionI18n: { en: "Event verification token" } },
   ],
   running: (use) => use(larkRuntimeStateToken).endpoints.values(),
   describeEntry: (entry) => `appId: ${String(entry.appId)}`,

package/lib/cards.d.ts

@@ -1,6 +1,7 @@
+import type { Locale } from 'zhin.js/i18n';
 import type { LarkSendBody, LarkWireSegment } from './protocol.js';
 /** Feishu JSON card v1: ordered native rich text, link and button components. */
-export declare function formatLarkCard(items: Array<string | LarkWireSegment>): LarkSendBody;
+export declare function formatLarkCard(items: Array<string | LarkWireSegment>, locale?: Locale): LarkSendBody;
 export interface LarkCardAction {
     readonly token?: string;
     readonly context?: {

package/lib/cards.js

@@ -1,6 +1,7 @@
+import { messages as t } from './i18n.js';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /** Feishu JSON card v1: ordered native rich text, link and button components. */
-export function formatLarkCard(items) {
+export function formatLarkCard(items, locale) {
     const elements = [];
     let replyTo;
     for (const item of items) {
@@ -33,7 +34,7 @@ export function formatLarkCard(items) {
                 elements.push({ tag: 'div', text: { tag: 'plain_text', content: String(data.title ?? url) } });
                 if (data.description)
                     elements.push({ tag: 'div', text: { tag: 'plain_text', content: String(data.description) } });
-                elements.push({ tag: 'action', actions: [{ tag: 'button', text: { tag: 'plain_text', content: '打开链接' }, url }] });
+                elements.push({ tag: 'action', actions: [{ tag: 'button', text: { tag: 'plain_text', content: t(locale, 'openLink') }, url }] });
                 break;
             }
             case 'keyboard': {

package/lib/endpoint.d.ts

@@ -79,7 +79,7 @@ export declare class LarkEndpoint extends Endpoint<LarkClient> {
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    send({ conversation, payload, locale }: EndpointSendRequest): Promise<string>;
     recallMessage(messageId: string): Promise<void>;
     /** Upload must succeed before issuing a message; dropped media is never confirmed. */
     uploadImage(media: Parameters<typeof resolveMediaBinary>[0]): Promise<string>;

package/lib/endpoint.js

@@ -189,10 +189,10 @@ export class LarkEndpoint extends Endpoint {
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
-    async send({ conversation, payload }) {
+    async send({ conversation, payload, locale }) {
         try {
             const materialized = await this.#materializeOutboundMedia(payload);
-            const content = formatOutboundBody(materialized);
+            const content = formatOutboundBody(materialized, locale);
             const data = await this.#request(content.replyTo
                 ? `/im/v1/messages/${encodeURIComponent(content.replyTo)}/reply`
                 : '/im/v1/messages', {

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,3 +1,4 @@
+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`. */
@@ -115,7 +116,7 @@ export declare function verifyToken(token: string, expected: string): boolean;
  * Wire-encode an already-rendered outbound payload into Lark im/v1 message body.
  * Segment canonicalization is intentionally not done here.
  */
-export declare function formatOutboundBody(payload: unknown): LarkSendBody;
+export declare function formatOutboundBody(payload: unknown, locale?: Locale): LarkSendBody;
 export declare function headerValue(headers: IncomingMessage['headers'], name: string): string;
 export declare function readTextBody(request: IncomingMessage, options?: {
     readonly limit?: number;

package/lib/protocol.js

@@ -155,7 +155,7 @@ export function verifyToken(token, expected) {
  * Wire-encode an already-rendered outbound payload into Lark im/v1 message body.
  * Segment canonicalization is intentionally not done here.
  */
-export function formatOutboundBody(payload) {
+export function formatOutboundBody(payload, locale) {
     if (typeof payload === 'string') {
         return {
             msg_type: 'text',
@@ -168,7 +168,7 @@ export function formatOutboundBody(payload) {
             ? [payload]
             : [];
     if (items.some(item => typeof item !== 'string' && ['markdown', 'share', 'keyboard'].includes(item.type)))
-        return formatLarkCard(items);
+        return formatLarkCard(items, locale);
     const hasMarkdown = items.some((item) => typeof item !== 'string' && item.type === 'markdown');
     if (items.length === 0) {
         const text = payload == null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-lark",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "Zhin.js Lark/Feishu adapter (HTTP webhook and WebSocket long connection)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,26 +33,26 @@
     "directory": "plugins/adapters/lark"
   },
   "dependencies": {
-    "undici": "6.28.0",
+    "undici": "6.29.1",
     "@larksuiteoapi/node-sdk": "^1.67.0",
-    "@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/permission": "^1.1.9",
+    "@zhin.js/host-http": "^1.1.11",
+    "zhin.js": "^1.1.17"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -70,7 +70,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.15"
+    "zhin.js": "1.1.17"
   },
   "files": [
     "adapters",

package/schema.json

@@ -19,7 +19,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（Lark/Feishu open_id or user_id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（Lark/Feishu open_id or user_id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (Lark/Feishu open_id or user_id; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -30,7 +35,12 @@
         ],
         "description": "Trusted Lark/Feishu open_id or 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",
@@ -45,7 +55,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（Lark/Feishu open_id or user_id）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（Lark/Feishu open_id or user_id）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (Lark/Feishu open_id or user_id), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -56,7 +71,12 @@
               ],
               "description": "Trusted Lark/Feishu open_id or user_id"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "appId": {
             "type": "string",
@@ -117,7 +137,12 @@
               "port",
               "serverName"
             ],
-            "description": "WSS故障验收：仅TCP固定loopback，保留TLS身份"
+            "description": "WSS故障验收：仅TCP固定loopback，保留TLS身份",
+            "x-i18n": {
+              "en": {
+                "description": "WSS fault-injection tests: pin only TCP to loopback while preserving TLS identity."
+              }
+            }
           },
           "webApiProxy": {
             "type": "object",
@@ -132,7 +157,12 @@
                 "maximum": 65535
               }
             },
-            "description": "默认关闭；仅飞书出站API的loopback TLS故障代理，保留官方Host/SNI和证书校验，与streamProxy独立"
+            "description": "默认关闭；仅飞书出站API的loopback TLS故障代理，保留官方Host/SNI和证书校验，与streamProxy独立",
+            "x-i18n": {
+              "en": {
+                "description": "Disabled by default. Loopback TLS fault proxy for Feishu outbound APIs only; preserves the official Host, SNI and certificate validation. Independent of streamProxy."
+              }
+            }
           }
         },
         "required": [
@@ -140,12 +170,22 @@
           "appId",
           "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",
@@ -168,7 +208,12 @@
           "maximum": 65535
         }
       },
-      "description": "默认关闭；仅飞书出站API的loopback TLS故障代理，保留官方Host/SNI和证书校验，与streamProxy独立"
+      "description": "默认关闭；仅飞书出站API的loopback TLS故障代理，保留官方Host/SNI和证书校验，与streamProxy独立",
+      "x-i18n": {
+        "en": {
+          "description": "Disabled by default. Loopback TLS fault proxy for Feishu outbound APIs only; preserves the official Host, SNI and certificate validation. Independent of streamProxy."
+        }
+      }
     }
   },
   "required": [

package/src/cards.ts

@@ -1,8 +1,10 @@
+import type { Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 import type { LarkSendBody, LarkWireSegment } from './protocol.js';
 
 /** Feishu JSON card v1: ordered native rich text, link and button components. */
-export function formatLarkCard(items: Array<string | LarkWireSegment>): LarkSendBody {
+export function formatLarkCard(items: Array<string | LarkWireSegment>, locale?: Locale): LarkSendBody {
   const elements: unknown[] = [];
   let replyTo: string | undefined;
   for (const item of items) {
@@ -22,7 +24,7 @@ export function formatLarkCard(items: Array<string | LarkWireSegment>): LarkSend
         if (!/^https?:\/\//.test(url)) throw unsupported();
         elements.push({ tag: 'div', text: { tag: 'plain_text', content: String(data.title ?? url) } });
         if (data.description) elements.push({ tag: 'div', text: { tag: 'plain_text', content: String(data.description) } });
-        elements.push({ tag: 'action', actions: [{ tag: 'button', text: { tag: 'plain_text', content: '打开链接' }, url }] }); break;
+        elements.push({ tag: 'action', actions: [{ tag: 'button', text: { tag: 'plain_text', content: t(locale, 'openLink') }, url }] }); break;
       }
       case 'keyboard': {
         const rows = data.rows as Array<Array<{ id?: string; label?: string; payload?: string; url?: string }>> | undefined;

package/src/endpoint.ts

@@ -258,10 +258,10 @@ export class LarkEndpoint extends Endpoint<LarkClient> {
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
+  async send({ conversation, payload, locale }: EndpointSendRequest): Promise<string> {
     try {
       const materialized = await this.#materializeOutboundMedia(payload);
-      const content = formatOutboundBody(materialized);
+      const content = formatOutboundBody(materialized, locale);
       const data = await this.#request(content.replyTo
         ? `/im/v1/messages/${encodeURIComponent(content.replyTo)}/reply`
         : '/im/v1/messages', {

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,4 @@
+import type { Locale } from 'zhin.js/i18n';
 import { validateLarkWebApiProxy } from './web-api-proxy.js';
 /**
  * Lark/Feishu protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
@@ -272,7 +273,7 @@ export function verifyToken(token: string, expected: string): boolean {
  * Wire-encode an already-rendered outbound payload into Lark im/v1 message body.
  * Segment canonicalization is intentionally not done here.
  */
-export function formatOutboundBody(payload: unknown): LarkSendBody {
+export function formatOutboundBody(payload: unknown, locale?: Locale): LarkSendBody {
   if (typeof payload === 'string') {
     return {
       msg_type: 'text',
@@ -285,7 +286,7 @@ export function formatOutboundBody(payload: unknown): LarkSendBody {
     : payload && typeof payload === 'object' && 'type' in (payload as object)
       ? [payload as LarkWireSegment]
       : [];
-  if (items.some(item => typeof item !== 'string' && ['markdown', 'share', 'keyboard'].includes(item.type))) return formatLarkCard(items);
+  if (items.some(item => typeof item !== 'string' && ['markdown', 'share', 'keyboard'].includes(item.type))) return formatLarkCard(items, locale);
   const hasMarkdown = items.some((item) => typeof item !== 'string' && item.type === 'markdown');
 
   if (items.length === 0) {