@zhin.js/adapter-kook 1.1.15 → 1.1.16

package/CHANGELOG.md

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

package/agents/kook/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({
+    "unknownAction": {
+        "zh-CN": "未知操作: {p0}",
+        "en": "Unknown action: {p0}"
+    },
+    "operationFailed": {
+        "zh-CN": "操作失败",
+        "en": "Operation failed"
+    },
+    "unblacklisted": {
+        "zh-CN": "已将 {p0} 从黑名单移除",
+        "en": "Removed {p0} from the blacklist"
+    },
+    "blacklisted": {
+        "zh-CN": "已将 {p0} 加入黑名单",
+        "en": "Added {p0} to the blacklist"
+    },
+    "roleCreated": {
+        "zh-CN": "已创建角色 \"{p0}\"",
+        "en": "Role \"{p0}\" created"
+    },
+    "roleDeleteFailed": {
+        "zh-CN": "删除角色失败",
+        "en": "Could not delete the role"
+    },
+    "roleDeleted": {
+        "zh-CN": "已删除角色 {p0}",
+        "en": "Role {p0} deleted"
+    },
+    "roleGrantFailed": {
+        "zh-CN": "授予角色失败",
+        "en": "Could not grant the role"
+    },
+    "roleGranted": {
+        "zh-CN": "已授予用户 {p0} 角色 {p1}",
+        "en": "Granted role {p1} to user {p0}"
+    },
+    "roleRevokeFailed": {
+        "zh-CN": "撤销角色失败",
+        "en": "Could not revoke the role"
+    },
+    "roleRevoked": {
+        "zh-CN": "已撤销用户 {p0} 的角色 {p1}",
+        "en": "Revoked role {p1} from user {p0}"
+    }
+});

package/agents/kook/messages.ts

@@ -0,0 +1,48 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  "unknownAction": {
+    "zh-CN": "未知操作: {p0}",
+    "en": "Unknown action: {p0}"
+  },
+  "operationFailed": {
+    "zh-CN": "操作失败",
+    "en": "Operation failed"
+  },
+  "unblacklisted": {
+    "zh-CN": "已将 {p0} 从黑名单移除",
+    "en": "Removed {p0} from the blacklist"
+  },
+  "blacklisted": {
+    "zh-CN": "已将 {p0} 加入黑名单",
+    "en": "Added {p0} to the blacklist"
+  },
+  "roleCreated": {
+    "zh-CN": "已创建角色 \"{p0}\"",
+    "en": "Role \"{p0}\" created"
+  },
+  "roleDeleteFailed": {
+    "zh-CN": "删除角色失败",
+    "en": "Could not delete the role"
+  },
+  "roleDeleted": {
+    "zh-CN": "已删除角色 {p0}",
+    "en": "Role {p0} deleted"
+  },
+  "roleGrantFailed": {
+    "zh-CN": "授予角色失败",
+    "en": "Could not grant the role"
+  },
+  "roleGranted": {
+    "zh-CN": "已授予用户 {p0} 角色 {p1}",
+    "en": "Granted role {p1} to user {p0}"
+  },
+  "roleRevokeFailed": {
+    "zh-CN": "撤销角色失败",
+    "en": "Could not revoke the role"
+  },
+  "roleRevoked": {
+    "zh-CN": "已撤销用户 {p0} 的角色 {p1}",
+    "en": "Revoked role {p1} from user {p0}"
+  }
+});

package/agents/kook/skills/kook/tools/blacklist/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';
@@ -19,14 +20,14 @@ export default defineAgentTool({
         switch (action) {
             case 'add': {
                 const success = await member.addToBlackList(remark);
-                return { success, message: success ? `已将 ${user_id} 加入黑名单` : '操作失败' };
+                return { success, message: success ? t(context.locale, 'blacklisted', { p0: user_id }) : t(context.locale, 'operationFailed') };
             }
             case 'remove': {
                 const success = await member.removeFromBlackList();
-                return { success, message: success ? `已将 ${user_id} 从黑名单移除` : '操作失败' };
+                return { success, message: success ? t(context.locale, 'unblacklisted', { p0: user_id }) : t(context.locale, 'operationFailed') };
             }
             default:
-                return { success: false, message: `未知操作: ${action}` };
+                return { success: false, message: t(context.locale, 'unknownAction', { p0: action }) };
         }
     },
 });

package/agents/kook/skills/kook/tools/blacklist/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';
@@ -19,14 +20,14 @@ export default defineAgentTool<{ guild_id: string; action: 'add' | 'remove'; use
     switch (action) {
       case 'add': {
         const success = await member.addToBlackList(remark);
-        return { success, message: success ? `已将 ${user_id} 加入黑名单` : '操作失败' };
+        return { success, message: success ? t(context.locale, 'blacklisted', { p0: user_id }) : t(context.locale, 'operationFailed') };
       }
       case 'remove': {
         const success = await member.removeFromBlackList();
-        return { success, message: success ? `已将 ${user_id} 从黑名单移除` : '操作失败' };
+        return { success, message: success ? t(context.locale, 'unblacklisted', { p0: user_id }) : t(context.locale, 'operationFailed') };
       }
       default:
-        return { success: false, message: `未知操作: ${action}` };
+        return { success: false, message: t(context.locale, 'unknownAction', { p0: action }) };
     }
   },
 });

package/agents/kook/skills/kook/tools/create_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 { platformPermission } from '@zhin.js/permission';
@@ -17,7 +18,7 @@ export default defineAgentTool({
         const role = await client.pickGuild(guild_id).createRole(name);
         return {
             success: true,
-            message: `已创建角色 "${name}"`,
+            message: t(context.locale, 'roleCreated', { p0: name }),
             role: { id: role.role_id, name: role.name },
         };
     },

package/agents/kook/skills/kook/tools/create_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 { platformPermission } from '@zhin.js/permission';
@@ -17,7 +18,7 @@ export default defineAgentTool<{ guild_id: string; name: string }>({
     const role = await client.pickGuild(guild_id).createRole(name);
     return {
       success: true,
-      message: `已创建角色 "${name}"`,
+      message: t(context.locale, 'roleCreated', { p0: name }),
       role: { id: role.role_id, name: role.name },
     };
   },

package/agents/kook/skills/kook/tools/delete_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 { platformPermission } from '@zhin.js/permission';
@@ -15,6 +16,6 @@ export default defineAgentTool({
     async execute({ guild_id, role_id }, context) {
         const client = context.$client;
         const success = await client.pickGuild(guild_id).deleteRole(role_id);
-        return { success, message: success ? `已删除角色 ${role_id}` : '删除角色失败' };
+        return { success, message: success ? t(context.locale, 'roleDeleted', { p0: role_id }) : t(context.locale, 'roleDeleteFailed') };
     },
 });

package/agents/kook/skills/kook/tools/delete_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 { platformPermission } from '@zhin.js/permission';
@@ -15,6 +16,6 @@ export default defineAgentTool<{ guild_id: string; role_id: string }>({
   async execute({ guild_id, role_id  }: { guild_id: string; role_id: string }, context) {
     const client = context.$client;
     const success = await client.pickGuild(guild_id).deleteRole(role_id);
-    return { success, message: success ? `已删除角色 ${role_id}` : '删除角色失败' };
+    return { success, message: success ? t(context.locale, 'roleDeleted', { p0: role_id }) : t(context.locale, 'roleDeleteFailed') };
   },
 });

package/agents/kook/skills/kook/tools/grant_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 { platformPermission } from '@zhin.js/permission';
@@ -16,6 +17,6 @@ export default defineAgentTool({
     async execute({ guild_id, user_id, role_id }, context) {
         const client = context.$client;
         const success = await client.pickGuildMember(guild_id, user_id).grant(role_id);
-        return { success, message: success ? `已授予用户 ${user_id} 角色 ${role_id}` : '授予角色失败' };
+        return { success, message: success ? t(context.locale, 'roleGranted', { p0: user_id, p1: role_id }) : t(context.locale, 'roleGrantFailed') };
     },
 });

package/agents/kook/skills/kook/tools/grant_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 { platformPermission } from '@zhin.js/permission';
@@ -16,6 +17,6 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
   async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
     const client = context.$client;
     const success = await client.pickGuildMember(guild_id, user_id).grant(role_id);
-    return { success, message: success ? `已授予用户 ${user_id} 角色 ${role_id}` : '授予角色失败' };
+    return { success, message: success ? t(context.locale, 'roleGranted', { p0: user_id, p1: role_id }) : t(context.locale, 'roleGrantFailed') };
   },
 });

package/agents/kook/skills/kook/tools/revoke_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 { platformPermission } from '@zhin.js/permission';
@@ -16,6 +17,6 @@ export default defineAgentTool({
     async execute({ guild_id, user_id, role_id }, context) {
         const client = context.$client;
         const success = await client.pickGuildMember(guild_id, user_id).revoke(role_id);
-        return { success, message: success ? `已撤销用户 ${user_id} 的角色 ${role_id}` : '撤销角色失败' };
+        return { success, message: success ? t(context.locale, 'roleRevoked', { p0: user_id, p1: role_id }) : t(context.locale, 'roleRevokeFailed') };
     },
 });

package/agents/kook/skills/kook/tools/revoke_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 { platformPermission } from '@zhin.js/permission';
@@ -16,6 +17,6 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
   async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
     const client = context.$client;
     const success = await client.pickGuildMember(guild_id, user_id).revoke(role_id);
-    return { success, message: success ? `已撤销用户 ${user_id} 的角色 ${role_id}` : '撤销角色失败' };
+    return { success, message: success ? t(context.locale, 'roleRevoked', { p0: user_id, p1: role_id }) : t(context.locale, 'roleRevokeFailed') };
   },
 });

package/commands/kook/endpoint/definition.js

@@ -11,8 +11,8 @@ export const kookEndpointCommands = createEndpointCommands({
     adapterDisplayName: 'KOOK',
     fields: [
         { key: 'token', required: true, env: true, description: 'KOOK bot token' },
-        { key: 'encrypt_key', env: true, description: 'webhook 加密密钥（connection: webhook）' },
-        { key: 'verify_token', env: true, description: 'webhook 验证 token（connection: webhook）' },
+        { key: 'encrypt_key', env: true, description: 'webhook 加密密钥（connection: webhook）', descriptionI18n: { en: "Webhook encryption secret (connection: webhook)" } },
+        { key: 'verify_token', env: true, description: 'webhook 验证 token（connection: webhook）', descriptionI18n: { en: "Webhook verification token (connection: webhook)" } },
     ],
     running: (use) => use(kookRuntimeStateToken).endpoints.values(),
     describeEntry: (entry) => `token: ${String(entry.token)}`,

package/commands/kook/endpoint/definition.ts

@@ -11,8 +11,8 @@ export const kookEndpointCommands = createEndpointCommands({
   adapterDisplayName: 'KOOK',
   fields: [
     { key: 'token', required: true, env: true, description: 'KOOK bot token' },
-    { key: 'encrypt_key', env: true, description: 'webhook 加密密钥（connection: webhook）' },
-    { key: 'verify_token', env: true, description: 'webhook 验证 token（connection: webhook）' },
+    { key: 'encrypt_key', env: true, description: 'webhook 加密密钥（connection: webhook）', descriptionI18n: { en: "Webhook encryption secret (connection: webhook)" } },
+    { key: 'verify_token', env: true, description: 'webhook 验证 token（connection: webhook）', descriptionI18n: { en: "Webhook verification token (connection: webhook)" } },
   ],
   running: (use) => use(kookRuntimeStateToken).endpoints.values(),
   describeEntry: (entry) => `token: ${String(entry.token)}`,

package/lib/endpoint.d.ts

@@ -20,7 +20,7 @@ export declare class KookWebsocketEndpoint extends Endpoint<KookClientTransport>
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    send(request: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a normalized message when open. */
     admit(msg: KookInboundMessage): void;
     recallMessage(messageId: string, conversation?: ConversationRef): Promise<void>;
@@ -46,7 +46,7 @@ export declare class KookWebhookEndpoint extends Endpoint<KookClientTransport> {
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    send(request: EndpointSendRequest): Promise<string>;
     admitEvent(event: KookWebhookEventData): Promise<void>;
     /** Test / internal: admit a message when open. */
     admit(msg: KookInboundMessage): void;

package/lib/endpoint.js

@@ -100,8 +100,9 @@ export class KookWebsocketEndpoint extends Endpoint {
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
-    async send({ conversation, payload }) {
-        const messageId = await sendKookOutbound(this.#requireClient(), { conversation, payload });
+    async send(request) {
+        const { conversation } = request;
+        const messageId = await sendKookOutbound(this.#requireClient(), request);
         rememberKookConversation(this.#sentConversations, messageId, conversation);
         this.#logger.debug(formatCompact({
             op: 'kook_send',
@@ -255,8 +256,9 @@ export class KookWebhookEndpoint extends Endpoint {
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
-    async send({ conversation, payload }) {
-        const messageId = await sendKookOutbound(this.#requireClient(), { conversation, payload });
+    async send(request) {
+        const { conversation } = request;
+        const messageId = await sendKookOutbound(this.#requireClient(), request);
         rememberKookConversation(this.#sentConversations, messageId, conversation);
         this.#logger.debug(formatCompact({
             op: 'kook_send',

package/lib/i18n.d.ts

@@ -0,0 +1 @@
+export declare const outboundMessages: (locale: import("zhin.js").Locale | undefined, key: "openLink" | "image" | "video" | "audio" | "file" | "unnamed", values?: import("zhin.js").MessageValues) => string;

package/lib/i18n.js

@@ -0,0 +1,9 @@
+import { createMessages } from 'zhin.js/i18n';
+export const outboundMessages = createMessages({
+    openLink: { 'zh-CN': '打开链接', en: 'Open link' },
+    image: { 'zh-CN': '图片', en: 'Image' },
+    video: { 'zh-CN': '视频', en: 'Video' },
+    audio: { 'zh-CN': '音频', en: 'Audio' },
+    file: { 'zh-CN': '文件: {name}', en: 'File: {name}' },
+    unnamed: { 'zh-CN': '未命名', en: 'Unnamed' },
+});

package/lib/outbound.d.ts

@@ -2,6 +2,6 @@ import { type MessageRef } from '@zhin.js/im-contract';
 import type { EndpointSendRequest } from 'zhin.js/adapter';
 import type { KookClientTransport } from './ws.js';
 /** Native cards preserve mixed text/images; SDK's ordinary segments stop at first media. */
-export declare function sendKookOutbound(client: KookClientTransport, { conversation, payload }: EndpointSendRequest): Promise<string>;
+export declare function sendKookOutbound(client: KookClientTransport, { conversation, payload, locale }: EndpointSendRequest): Promise<string>;
 /** Deletion requires the canonical conversation: KOOK has separate channel/private APIs. */
 export declare function recallKookMessage(client: KookClientTransport, message: MessageRef): Promise<void>;

package/lib/outbound.js

@@ -1,8 +1,9 @@
 import { readFile } from 'node:fs/promises';
 import { EndpointDeliveryError, isMediaRef } from '@zhin.js/im-contract';
 import { formatOutboundKmarkdown } from './protocol.js';
+import { outboundMessages as t } from './i18n.js';
 /** Native cards preserve mixed text/images; SDK's ordinary segments stop at first media. */
-export async function sendKookOutbound(client, { conversation, payload }) {
+export async function sendKookOutbound(client, { conversation, payload, locale }) {
     try {
         const items = Array.isArray(payload) ? payload : payload && typeof payload === 'object' ? [payload] : [payload];
         let quote;
@@ -52,7 +53,7 @@ export async function sendKookOutbound(client, { conversation, payload }) {
                 for (const value of [data.description, data.content])
                     if (typeof value === 'string' && value)
                         modules.push({ type: 'section', mode: 'left', text: { type: 'plain-text', content: value } });
-                modules.push({ type: 'action-group', elements: [{ type: 'button', theme: 'secondary', click: 'link', value: url.href, text: { type: 'plain-text', content: '打开链接' } }] });
+                modules.push({ type: 'action-group', elements: [{ type: 'button', theme: 'secondary', click: 'link', value: url.href, text: { type: 'plain-text', content: t(locale, 'openLink') } }] });
             }
             else if (item && typeof item === 'object' && item.type === 'image') {
                 hasImage = true;
@@ -87,12 +88,12 @@ export async function sendKookOutbound(client, { conversation, payload }) {
                     && isMediaRef(item.data?.media) && !['url', 'file'].includes(item.data.media.kind)) {
                     throw new EndpointDeliveryError('unsupported_media', 'KOOK binary uploads currently support images only', 'rejected');
                 }
-                const text = formatOutboundKmarkdown([item]);
+                const text = formatOutboundKmarkdown([item], locale);
                 if (text)
                     modules.push({ type: 'section', mode: 'left', text: { type: 'kmarkdown', content: text } });
             }
         }
-        const body = hasImage || hasCard ? { __isCard: true, type: 'card', theme: 'secondary', size: 'lg', modules } : formatOutboundKmarkdown(payload);
+        const body = hasImage || hasCard ? { __isCard: true, type: 'card', theme: 'secondary', size: 'lg', modules } : formatOutboundKmarkdown(payload, locale);
         const result = conversation.kind === 'private'
             ? await client.sendPrivateMsg(conversation.id, body, quote)
             : await client.sendChannelMsg(conversation.id, body, quote);

package/lib/protocol.d.ts

@@ -1,6 +1,7 @@
 /** KOOK protocol helpers. Canonicalization is owned by Core. */
 import type { IncomingMessage } from 'node:http';
 import { type ConversationRef } from '@zhin.js/im-contract';
+import type { Locale } from 'zhin.js/i18n';
 export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | 'mark' | 'off';
 export declare enum KookPermission {
     Normal = 1,
@@ -126,7 +127,7 @@ export declare function isKookBotMentioned(msg: KookInboundMessage, selfId?: str
  * Wire-encode an already-rendered outbound payload into KOOK KMarkdown.
  * Segment canonicalization is intentionally not done here.
  */
-export declare function formatOutboundKmarkdown(payload: unknown): string;
+export declare function formatOutboundKmarkdown(payload: unknown, locale?: Locale): string;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function readTextBody(request: IncomingMessage, options?: {
     readonly limit?: number;

package/lib/protocol.js

@@ -3,6 +3,7 @@ import { createDecipheriv, timingSafeEqual } from 'node:crypto';
 import { inflateSync } from 'node:zlib';
 import { EndpointDeliveryError, isMediaRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
+import { outboundMessages as t } from './i18n.js';
 const logger = getLogger('kook');
 export var KookPermission;
 (function (KookPermission) {
@@ -118,7 +119,7 @@ function resolveOutboundMediaUrl(seg) {
  * Wire-encode an already-rendered outbound payload into KOOK KMarkdown.
  * Segment canonicalization is intentionally not done here.
  */
-export function formatOutboundKmarkdown(payload) {
+export function formatOutboundKmarkdown(payload, locale) {
     if (typeof payload === 'string')
         return payload;
     const segments = Array.isArray(payload)
@@ -152,7 +153,7 @@ export function formatOutboundKmarkdown(payload) {
             }
             case 'image': {
                 const url = resolveOutboundMediaUrl(item);
-                return url ? `![${String(data.alt || '图片')}](${url})` : '';
+                return url ? `![${String(data.alt || t(locale, 'image'))}](${url})` : '';
             }
             case 'face':
                 return `(emj)${String(data.name || 'emoji')}(emj)[${String(data.id ?? '')}]`;
@@ -160,15 +161,15 @@ export function formatOutboundKmarkdown(payload) {
                 return `[${String(data.text || data.url || '')}](${String(data.url || '')})`;
             case 'video': {
                 const url = resolveOutboundMediaUrl(item);
-                return url ? `[视频](${url})` : '';
+                return url ? `[${t(locale, 'video')}](${url})` : '';
             }
             case 'audio': {
                 const url = resolveOutboundMediaUrl(item);
-                return url ? `[音频](${url})` : '';
+                return url ? `[${t(locale, 'audio')}](${url})` : '';
             }
             case 'file': {
                 const url = resolveOutboundMediaUrl(item);
-                return url ? `[文件: ${String(data.name || '未命名')}](${url})` : '';
+                return url ? `[${t(locale, 'file', { name: String(data.name || t(locale, 'unnamed')) })}](${url})` : '';
             }
             case 'bold':
                 return `**${String(data.text ?? '')}**`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "1.1.15",
+  "version": "1.1.16",
   "description": "Zhin.js KOOK adapter for Plugin Runtime (WebSocket gateway or Webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,23 +33,23 @@
   },
   "dependencies": {
     "kook-client": "^1.0.5",
-    "@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.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.8",
-    "@zhin.js/skill": "1.1.9",
-    "@zhin.js/tool": "1.1.9"
+    "@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.22",
-    "@zhin.js/command": "^1.1.10",
-    "@zhin.js/core": "^1.1.50",
-    "zhin.js": "^1.1.15"
+    "@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": {
@@ -67,8 +67,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.10",
+    "zhin.js": "1.1.16"
   },
   "files": [
     "adapters",

package/schema.json

@@ -55,7 +55,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（KOOK user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（KOOK user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (KOOK user id; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -66,7 +71,12 @@
         ],
         "description": "Trusted KOOK 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",
@@ -81,7 +91,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（KOOK user id）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（KOOK user id）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (KOOK user id), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -92,7 +107,12 @@
               ],
               "description": "Trusted KOOK user id"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "token": {
             "type": "string",
@@ -171,7 +191,12 @@
               "port",
               "serverName"
             ],
-            "description": "WSS故障验收固定loopback，保持真实TLS身份"
+            "description": "WSS故障验收固定loopback，保持真实TLS身份",
+            "x-i18n": {
+              "en": {
+                "description": "Pin WSS fault-injection tests to loopback while preserving the actual TLS identity."
+              }
+            }
           },
           "apiProxy": {
             "type": "object",
@@ -193,12 +218,22 @@
           "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."
+        }
+      }
     }
   },
   "required": [

package/src/endpoint.ts

@@ -151,8 +151,9 @@ export class KookWebsocketEndpoint extends Endpoint<KookClientTransport> {
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
-    const messageId = await sendKookOutbound(this.#requireClient(), { conversation, payload });
+  async send(request: EndpointSendRequest): Promise<string> {
+    const { conversation } = request;
+    const messageId = await sendKookOutbound(this.#requireClient(), request);
     rememberKookConversation(this.#sentConversations, messageId, conversation);
     this.#logger.debug(formatCompact({
       op: 'kook_send',
@@ -321,8 +322,9 @@ export class KookWebhookEndpoint extends Endpoint<KookClientTransport> {
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
-    const messageId = await sendKookOutbound(this.#requireClient(), { conversation, payload });
+  async send(request: EndpointSendRequest): Promise<string> {
+    const { conversation } = request;
+    const messageId = await sendKookOutbound(this.#requireClient(), request);
     rememberKookConversation(this.#sentConversations, messageId, conversation);
     this.#logger.debug(formatCompact({
       op: 'kook_send',

package/src/i18n.ts

@@ -0,0 +1,10 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const outboundMessages = createMessages({
+  openLink: { 'zh-CN': '打开链接', en: 'Open link' },
+  image: { 'zh-CN': '图片', en: 'Image' },
+  video: { 'zh-CN': '视频', en: 'Video' },
+  audio: { 'zh-CN': '音频', en: 'Audio' },
+  file: { 'zh-CN': '文件: {name}', en: 'File: {name}' },
+  unnamed: { 'zh-CN': '未命名', en: 'Unnamed' },
+});

package/src/outbound.ts

@@ -3,9 +3,10 @@ import { EndpointDeliveryError, isMediaRef, type MessageRef } from '@zhin.js/im-
 import type { EndpointSendRequest } from 'zhin.js/adapter';
 import { formatOutboundKmarkdown } from './protocol.js';
 import type { KookClientTransport } from './ws.js';
+import { outboundMessages as t } from './i18n.js';
 
 /** Native cards preserve mixed text/images; SDK's ordinary segments stop at first media. */
-export async function sendKookOutbound(client: KookClientTransport, { conversation, payload }: EndpointSendRequest): Promise<string> {
+export async function sendKookOutbound(client: KookClientTransport, { conversation, payload, locale }: EndpointSendRequest): Promise<string> {
   try {
     const items = Array.isArray(payload) ? payload : payload && typeof payload === 'object' ? [payload] : [payload];
     let quote: { message_id: string } | undefined;
@@ -40,7 +41,7 @@ export async function sendKookOutbound(client: KookClientTransport, { conversati
         if (['image', 'audio', 'artist', 'duration', 'platform', 'config'].some(key => data[key] !== undefined)) throw new EndpointDeliveryError('unsupported_operation', 'KOOK share media/app metadata is not implemented', 'not_sent');
         modules.push({ type: 'section', mode: 'left', text: { type: 'plain-text', content: data.title } });
         for (const value of [data.description, data.content]) if (typeof value === 'string' && value) modules.push({ type: 'section', mode: 'left', text: { type: 'plain-text', content: value } });
-        modules.push({ type: 'action-group', elements: [{ type: 'button', theme: 'secondary', click: 'link', value: url.href, text: { type: 'plain-text', content: '打开链接' } }] });
+        modules.push({ type: 'action-group', elements: [{ type: 'button', theme: 'secondary', click: 'link', value: url.href, text: { type: 'plain-text', content: t(locale, 'openLink') } }] });
       } else if (item && typeof item === 'object' && item.type === 'image') {
         hasImage = true;
         const media = item.data?.media;
@@ -66,11 +67,11 @@ export async function sendKookOutbound(client: KookClientTransport, { conversati
           && isMediaRef(item.data?.media) && !['url', 'file'].includes(item.data.media.kind)) {
           throw new EndpointDeliveryError('unsupported_media', 'KOOK binary uploads currently support images only', 'rejected');
         }
-        const text = formatOutboundKmarkdown([item]);
+        const text = formatOutboundKmarkdown([item], locale);
         if (text) modules.push({ type: 'section', mode: 'left', text: { type: 'kmarkdown', content: text } });
       }
     }
-    const body = hasImage || hasCard ? { __isCard: true, type: 'card', theme: 'secondary', size: 'lg', modules } : formatOutboundKmarkdown(payload);
+    const body = hasImage || hasCard ? { __isCard: true, type: 'card', theme: 'secondary', size: 'lg', modules } : formatOutboundKmarkdown(payload, locale);
     const result = conversation.kind === 'private'
       ? await client.sendPrivateMsg(conversation.id, body, quote)
       : await client.sendChannelMsg(conversation.id, body, quote);

package/src/protocol.ts

@@ -5,6 +5,8 @@ import { inflateSync } from 'node:zlib';
 import type { IncomingMessage } from 'node:http';
 import { EndpointDeliveryError, isMediaRef, type ConversationRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
+import type { Locale } from 'zhin.js/i18n';
+import { outboundMessages as t } from './i18n.js';
 
 const logger = getLogger('kook');
 
@@ -248,7 +250,7 @@ function resolveOutboundMediaUrl(seg: KookWireSegment): string | undefined {
  * Wire-encode an already-rendered outbound payload into KOOK KMarkdown.
  * Segment canonicalization is intentionally not done here.
  */
-export function formatOutboundKmarkdown(payload: unknown): string {
+export function formatOutboundKmarkdown(payload: unknown, locale?: Locale): string {
   if (typeof payload === 'string') return payload;
 
   const segments: Array<string | KookWireSegment> = Array.isArray(payload)
@@ -283,7 +285,7 @@ export function formatOutboundKmarkdown(payload: unknown): string {
         }
         case 'image': {
           const url = resolveOutboundMediaUrl(item);
-          return url ? `![${String(data.alt || '图片')}](${url})` : '';
+          return url ? `![${String(data.alt || t(locale, 'image'))}](${url})` : '';
         }
         case 'face':
           return `(emj)${String(data.name || 'emoji')}(emj)[${String(data.id ?? '')}]`;
@@ -291,15 +293,15 @@ export function formatOutboundKmarkdown(payload: unknown): string {
           return `[${String(data.text || data.url || '')}](${String(data.url || '')})`;
         case 'video': {
           const url = resolveOutboundMediaUrl(item);
-          return url ? `[视频](${url})` : '';
+          return url ? `[${t(locale, 'video')}](${url})` : '';
         }
         case 'audio': {
           const url = resolveOutboundMediaUrl(item);
-          return url ? `[音频](${url})` : '';
+          return url ? `[${t(locale, 'audio')}](${url})` : '';
         }
         case 'file': {
           const url = resolveOutboundMediaUrl(item);
-          return url ? `[文件: ${String(data.name || '未命名')}](${url})` : '';
+          return url ? `[${t(locale, 'file', { name: String(data.name || t(locale, 'unnamed')) })}](${url})` : '';
         }
         case 'bold':
           return `**${String(data.text ?? '')}**`;