@zhin.js/adapter-kook 5.0.0 → 5.0.2

package/lib/src/kook-side-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-side-events.js","sourceRoot":"","sources":["../../src/kook-side-events.ts"],"names":[],"mappings":"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"}

package/lib/src/outbound-keyboard.js

@@ -0,0 +1,66 @@
+/**
+ * core keyboard 段 → KOOK 卡片消息（action-group + button）
+ */
+import { KeyboardSegment, isKeyboardSegment } from 'zhin.js';
+function asKeyboardElement(el) {
+    if (el instanceof KeyboardSegment) {
+        return { type: "keyboard", data: el.data };
+    }
+    if (isKeyboardSegment(el))
+        return el;
+    return null;
+}
+function textFromElements(elements) {
+    return elements
+        .filter((el) => el.type === "text" && typeof el.data.text === "string")
+        .map((el) => el.data.text)
+        .join("\n")
+        .trim();
+}
+/** core keyboard 布局 → KOOK card[]（可直接传给 sendChannelMsg / sendPrivateMsg） */
+export function coreKeyboardToKookCard(data, prefixElements = []) {
+    const modules = [];
+    const prefixText = textFromElements(prefixElements);
+    if (prefixText) {
+        modules.push({
+            type: "section",
+            text: { type: "plain-text", content: prefixText },
+        });
+    }
+    for (const row of data.rows ?? []) {
+        modules.push({
+            type: "action-group",
+            elements: row.map((btn) => ({
+                type: "button",
+                theme: btn.disabled ? "secondary" : "primary",
+                value: btn.payload,
+                click: "return-val",
+                text: { type: "plain-text", content: btn.label },
+            })),
+        });
+    }
+    return [{
+            type: "card",
+            theme: "secondary",
+            size: "sm",
+            modules,
+        }];
+}
+export function findKeyboardSegment(elements) {
+    let keyboard;
+    const rest = [];
+    for (const el of elements) {
+        const kb = asKeyboardElement(el);
+        if (kb) {
+            if (keyboard)
+                return null;
+            keyboard = kb;
+            continue;
+        }
+        rest.push(el);
+    }
+    if (!keyboard)
+        return null;
+    return { keyboard, rest };
+}
+//# sourceMappingURL=outbound-keyboard.js.map

package/lib/src/outbound-keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-keyboard.js","sourceRoot":"","sources":["../../src/outbound-keyboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAiD,MAAM,SAAS,CAAC;AAE5G,SAAS,iBAAiB,CACxB,EAAkB;IAElB,IAAI,EAAE,YAAY,eAAe,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,iBAAiB,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA0B;IAClD,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;SACtE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAc,CAAC;SACnC,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB,CACpC,IAAyB,EACzB,iBAAmC,EAAE;IAErC,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1B,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;gBAC7C,KAAK,EAAE,GAAG,CAAC,OAAO;gBAClB,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE;aACjD,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC;YACN,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,IAAI;YACV,OAAO;SACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA0B;IAE1B,IAAI,QAAsE,CAAC;IAC3E,MAAM,IAAI,GAAqB,EAAE,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC1B,QAAQ,GAAG,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/lib/{outbound-media.js → src/outbound-media.js}

@@ -1,4 +1,7 @@
-import { asMessageElements, extractBase64Buffer, isMediaSegmentType, isRemoteUrl, resolveLocalMediaPath, } from "zhin.js";
+/**
+ * KOOK 出站 media：base64 / 本地文件须先走 /v3/asset/create 上传，再嵌入 KMarkdown。
+ */
+import { asMessageElements, extractBase64Buffer, isMediaSegmentType, isRemoteUrl, resolveLocalMediaPath } from 'zhin.js';
 function isMessageSegment(seg) {
     return typeof seg.type === "string";
 }

package/lib/src/outbound-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media.js","sourceRoot":"","sources":["../../src/outbound-media.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,qBAAqB,EAA8D,MAAM,SAAS,CAAC;AAMrL,SAAS,gBAAgB,CAAC,GAAmB;IAC3C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,GAAmB,EAAE,WAAmB;IAC/D,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAA6B,CAAC;IACxD,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC;IACvB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACxB,OAAO,IAAI,CAAC,MAAM,CAAC;IACnB,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAoB,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,QAA2B,EAC3B,GAAmB;IAEnB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAE9C,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;IACjD,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAA2B,EAC3B,OAAoB;IAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/{outbound-sendable.js → src/outbound-sendable.js}

@@ -3,6 +3,7 @@
  * 图片/音视频须用 segment 发送对应 msg_type，不能写成 Markdown ![alt](url)。
  */
 import { segment } from "kook-client";
+import { coreKeyboardToKookCard, findKeyboardSegment } from "./outbound-keyboard.js";
 function mediaUrl(data) {
     return String(data.url ?? data.file ?? "");
 }
@@ -10,6 +11,14 @@ function mediaUrl(data) {
  * 单张图片（可带 reply）→ kook image 消息段（type=2）
  */
 export function convertToKookSendable(elements, formatText) {
+    const keyboardBundle = findKeyboardSegment(elements);
+    if (keyboardBundle) {
+        const { keyboard, rest } = keyboardBundle;
+        const nonReplyRest = rest.filter((el) => el.type !== "reply");
+        if (nonReplyRest.every((el) => el.type === "text" || el.type === "reply")) {
+            return coreKeyboardToKookCard(keyboard.data, nonReplyRest.filter((el) => el.type === "text"));
+        }
+    }
     const replies = [];
     const images = [];
     const videos = [];

package/lib/src/outbound-sendable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-sendable.js","sourceRoot":"","sources":["../../src/outbound-sendable.ts"],"names":[],"mappings":"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"}

package/lib/{platform-permit.js → src/platform-permit.js}

@@ -1,3 +1,6 @@
+/**
+ * KOOK platform permit — guild / channel 差异化门禁
+ */
 import { registerPlatformPermitChecker } from 'zhin.js';
 import { KookPermission } from './types.js';
 const ADAPTER = 'kook';
@@ -5,8 +8,8 @@ export function platformPermit(perm) {
     return `platform(${ADAPTER},${perm})`;
 }
 const FACTORY_PERM_MAP = {
-    group_admin: 'guild_admin',
-    group_owner: 'guild_owner',
+    scene_admin: 'guild_admin',
+    scene_owner: 'guild_owner',
 };
 export function kookGroupPermitResolver(logicalPerm) {
     return platformPermit(FACTORY_PERM_MAP[logicalPerm] ?? logicalPerm);

package/lib/src/platform-permit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-permit.js","sourceRoot":"","sources":["../../src/platform-permit.ts"],"names":[],"mappings":"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"}

package/lib/src/segment-mapper.js

@@ -0,0 +1,2 @@
+export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';
+//# sourceMappingURL=segment-mapper.js.map

package/lib/src/segment-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-mapper.js","sourceRoot":"","sources":["../../src/segment-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

package/lib/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,uDAAU,CAAA;IACV,qDAAS,CAAA;IACT,qDAAS,CAAA;IACT,mEAAgB,CAAA;AAClB,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "Zhin.js adapter for KOOK (开黑啦)",
   "type": "module",
   "main": "./lib/index.js",
@@ -38,25 +38,32 @@
   "devDependencies": {
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "lucide-react": "^1.21.0",
+    "lucide-react": "^1.22.0",
     "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.91",
-    "@zhin.js/client": "2.0.3",
-    "@zhin.js/contract": "1.0.1",
-    "@zhin.js/host-api": "2.0.3",
-    "@zhin.js/host-router": "2.0.1",
-    "@zhin.js/logger": "1.0.72",
-    "zhin.js": "4.1.0"
+    "zod": "^4.4.3",
+    "@zhin.js/cli": "1.0.93",
+    "@zhin.js/client": "2.0.5",
+    "@zhin.js/contract": "1.0.3",
+    "@zhin.js/host-api": "2.0.5",
+    "@zhin.js/host-router": "2.0.3",
+    "@zhin.js/logger": "1.0.74",
+    "zhin.js": "4.1.2",
+    "@zhin.js/agent": "1.0.3"
   },
   "peerDependencies": {
-    "@zhin.js/host-api": "2.0.3",
-    "@zhin.js/contract": "1.0.1",
-    "@zhin.js/client": "2.0.3",
-    "@zhin.js/logger": "1.0.72",
-    "@zhin.js/host-router": "2.0.1",
-    "zhin.js": "4.1.0"
+    "zod": "^4.0.0",
+    "@zhin.js/client": "2.0.5",
+    "@zhin.js/host-api": "2.0.5",
+    "@zhin.js/contract": "1.0.3",
+    "@zhin.js/host-router": "2.0.3",
+    "@zhin.js/logger": "1.0.74",
+    "zhin.js": "4.1.2",
+    "@zhin.js/agent": "1.0.3"
   },
   "peerDependenciesMeta": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
     "@zhin.js/client": {
       "optional": true
     },
@@ -65,6 +72,9 @@
     },
     "@zhin.js/host-api": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "files": [
@@ -72,7 +82,7 @@
     "lib",
     "client",
     "dist",
-    "skills",
+    "agent",
     "plugin.yml",
     "README.md",
     "node",

package/src/adapter.ts

@@ -1,10 +1,9 @@
 /**
  * KOOK 适配器
  */
-import { formatCompact, Adapter, Plugin } from 'zhin.js';
+import { formatCompact, Adapter, Plugin, type OutboundRichSegmentPolicy } from 'zhin.js';
 import { KookEndpoint } from "./endpoint.js";
 import type { KookEndpointConfig } from "./types.js";
-import type { OutboundRichSegmentPolicy } from "zhin.js";
 
 export class KookAdapter extends Adapter<KookEndpoint> {
   static override readonly capabilities = ['inbound', 'outbound'] as const;
@@ -13,6 +12,7 @@ export class KookAdapter extends Adapter<KookEndpoint> {
     html: 'image',
     markdown: 'origin',
   };
+  static override interactivePolicy = 'native' as const;
 
   constructor(plugin: Plugin) {
     super(plugin, "kook", []);
@@ -22,9 +22,9 @@ export class KookAdapter extends Adapter<KookEndpoint> {
     return new KookEndpoint(this, config);
   }
 
-  // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+  // ── ISceneManagement 标准群管方法 ──────────────────────────────────
 
-  async kickMember(endpointId: string, sceneId: string, userId: string) {
+  async removeMember(endpointId: string, sceneId: string, userId: string) {
     const endpoint = this.endpoints.get(endpointId);
     if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
     return endpoint.kickUser(sceneId, userId);
@@ -69,7 +69,7 @@ export class KookAdapter extends Adapter<KookEndpoint> {
 
   async stop(): Promise<void> {
     await super.stop();
-    this.plugin.logger.info(formatCompact( { op: "stop" }));
+    this.plugin.logger.debug(formatCompact( { op: "stop" }));
   }
 }
 

package/src/endpoint.ts

@@ -20,9 +20,10 @@ import {
   SendContent,
   MessageElement,
   segment,
+  expandInteractiveSegmentsInContent,
   MessageType,} from 'zhin.js';
-import type { KookEndpointConfig, KookSenderInfo, KookRawMessage } from "./types.js";
-import { KookPermission } from "./types.js";
+import { KookPermission, type KookEndpointConfig, type KookSenderInfo, type KookRawMessage } from './types.js';
+
 import type { KookAdapter } from "./adapter.js";
 import { InboundMessageDeduper } from "./kook-inbound.js";
 import { normalizeKookSenderForPermit } from "./platform-permit.js";
@@ -30,6 +31,8 @@ import {
   enrichKookGatewayForPlugins,
   formatKookNotice,
   formatKookNoticeLog,
+  formatKookButtonClickMessage,
+  isKookButtonClickEvent,
   isKookNoticeGatewayEvent,
   resolveKookSideEventDedupeKey,
   type KookGatewayEvent,
@@ -54,6 +57,7 @@ import {
 import { materializeOutboundMedia } from "./outbound-media.js";
 import { uploadKookAsset } from "./kook-asset-upload.js";
 import { convertToKookSendable } from "./outbound-sendable.js";
+import { fromCanonicalSegments, toCanonicalSegments } from './segment-mapper.js';
 
 export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig, KookRawMessage> {
   $connected: boolean = false;
@@ -110,6 +114,17 @@ export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig,
       const enriched = enrichKookGatewayForPlugins(raw);
       EventEmitter.prototype.emit.call(this.adapter, "kook.gateway", enriched);
 
+      if (isKookButtonClickEvent(raw)) {
+        const dedupeKey = resolveKookSideEventDedupeKey(raw, "gateway");
+        if (!this.inboundDeduper.shouldProcess(dedupeKey)) return;
+        const message = formatKookButtonClickMessage(raw, this.$id);
+        this.adapter.emit("message.receive", message);
+        this.pluginLogger.debug(
+          `KOOK 按钮点击 ${message.$channel.type}(${message.$channel.id}): ${message.$raw}`,
+        );
+        return;
+      }
+
       if (!isKookNoticeGatewayEvent(raw)) return;
 
       const dedupeKey = resolveKookSideEventDedupeKey(raw, "notice");
@@ -221,7 +236,7 @@ export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig,
         ...(guildId ? { guild_id: guildId } : {}),
       },
       
-      $content: this.parseMessageContent(msg.message),
+      $content: toCanonicalSegments(this.parseMessageContent(msg.message)),
       $raw: msg.raw_message,
       $timestamp: msg.timestamp,
       
@@ -493,73 +508,17 @@ export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig,
 
   private parseMarkdown(content: string): MessageElement[] {
     const elements: MessageElement[] = [];
-    
-    // KMarkdown 图片格式: ![alt](url)
-    const imageRegex = /!\[([^\]]*)\]\(([^)]+)\)/g;
-    // KMarkdown @提及格式: (met)userId(met) 或 @用户名
-    const mentionRegex = /\(met\)(\d+)\(met\)|@([^\s]+)/g;
-    // KMarkdown 表情格式: (emj)表情名(emj)[表情ID]
-    const emojiRegex = /\(emj\)([^(]+)\(emj\)\[([^\]]+)\]/g;
-    // KMarkdown 频道格式: (chn)channelId(chn)
-    const channelRegex = /\(chn\)(\d+)\(chn\)/g;
-
     let lastIndex = 0;
-    const matches: Array<{ index: number; length: number; element: MessageElement }> = [];
-
-    // 解析图片
-    let match: RegExpExecArray | null;
-    while ((match = imageRegex.exec(content)) !== null) {
-      matches.push({
-        index: match.index,
-        length: match[0].length,
-        element: { type: "image", data: { url: match[2], alt: match[1] } }
-      });
-    }
-
-    // 解析 @提及
-    while ((match = mentionRegex.exec(content)) !== null) {
-      const userId = match[1] || match[2];
-      matches.push({
-        index: match.index,
-        length: match[0].length,
-        element: this.buildAtElement(userId),
-      });
-    }
-
-    // 解析表情
-    while ((match = emojiRegex.exec(content)) !== null) {
-      matches.push({
-        index: match.index,
-        length: match[0].length,
-        element: { type: "face", data: { id: match[2], name: match[1] } }
-      });
-    }
-
-    // 解析频道引用
-    while ((match = channelRegex.exec(content)) !== null) {
-      matches.push({
-        index: match.index,
-        length: match[0].length,
-        element: { type: "text", data: { text: `#频道:${match[1]}` } }
-      });
-    }
-
-    // 按位置排序
-    matches.sort((a, b) => a.index - b.index);
-
-    // 组装消息段
-    for (const match of matches) {
-      // 添加之前的文本
-      if (match.index > lastIndex) {
-        const text = content.slice(lastIndex, match.index);
+    for (const token of this.scanKMarkdownTokens(content)) {
+      if (token.index > lastIndex) {
+        const text = content.slice(lastIndex, token.index);
         if (text) {
           elements.push({ type: "text", data: { text } });
         }
       }
 
-      // 添加特殊元素
-      elements.push(match.element);
-      lastIndex = match.index + match.length;
+      elements.push(token.element);
+      lastIndex = token.index + token.length;
     }
 
     // 添加剩余文本
@@ -646,7 +605,76 @@ export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig,
    * 检查文本是否包含 KMarkdown 特殊语法
    */
   private hasKMarkdownSyntax(text: string): boolean {
-    return /!\[.*?\]\(.*?\)|\(met\)|\(emj\)|\(chn\)|@\S+/.test(text);
+    return text.includes('![')
+      || text.includes('(met)')
+      || text.includes('(emj)')
+      || text.includes('(chn)')
+      || text.includes('@');
+  }
+
+  private scanKMarkdownTokens(content: string): Array<{ index: number; length: number; element: MessageElement }> {
+    const tokens: Array<{ index: number; length: number; element: MessageElement }> = [];
+    let i = 0;
+    while (i < content.length) {
+      const token = this.readKMarkdownToken(content, i);
+      if (token) {
+        tokens.push(token);
+        i = token.index + token.length;
+      } else {
+        i++;
+      }
+    }
+    return tokens;
+  }
+
+  private readKMarkdownToken(content: string, index: number): { index: number; length: number; element: MessageElement } | null {
+    if (content.startsWith('![', index)) {
+      const labelEnd = content.indexOf(']', index + 2);
+      if (labelEnd >= 0 && content[labelEnd + 1] === '(') {
+        const urlEnd = content.indexOf(')', labelEnd + 2);
+        if (urlEnd >= 0) {
+          return {
+            index,
+            length: urlEnd + 1 - index,
+            element: { type: "image", data: { url: content.slice(labelEnd + 2, urlEnd), alt: content.slice(index + 2, labelEnd) } },
+          };
+        }
+      }
+    }
+    if (content.startsWith('(met)', index)) {
+      const idStart = index + '(met)'.length;
+      const idEnd = content.indexOf('(met)', idStart);
+      if (idEnd > idStart) {
+        return { index, length: idEnd + '(met)'.length - index, element: this.buildAtElement(content.slice(idStart, idEnd)) };
+      }
+    }
+    if (content[index] === '@') {
+      let end = index + 1;
+      while (end < content.length && !/\s/.test(content[end]!)) end++;
+      if (end > index + 1) {
+        return { index, length: end - index, element: this.buildAtElement(content.slice(index + 1, end)) };
+      }
+    }
+    if (content.startsWith('(emj)', index)) {
+      const nameStart = index + '(emj)'.length;
+      const nameEnd = content.indexOf('(emj)[', nameStart);
+      const idEnd = nameEnd >= 0 ? content.indexOf(']', nameEnd + 6) : -1;
+      if (nameEnd > nameStart && idEnd > nameEnd) {
+        return {
+          index,
+          length: idEnd + 1 - index,
+          element: { type: "face", data: { id: content.slice(nameEnd + 6, idEnd), name: content.slice(nameStart, nameEnd) } },
+        };
+      }
+    }
+    if (content.startsWith('(chn)', index)) {
+      const idStart = index + '(chn)'.length;
+      const idEnd = content.indexOf('(chn)', idStart);
+      if (idEnd > idStart) {
+        return { index, length: idEnd + '(chn)'.length - index, element: { type: "text", data: { text: `#频道:${content.slice(idStart, idEnd)}` } } };
+      }
+    }
+    return null;
   }
 
   /**
@@ -707,7 +735,10 @@ export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig,
     try {
       const { id, type, content } = options;
 
-      const elements = await materializeOutboundMedia(this, content);
+      const expanded = expandInteractiveSegmentsInContent(content);
+      const canonical = toCanonicalSegments(Array.isArray(expanded) ? expanded : [expanded]);
+      const wire = fromCanonicalSegments(canonical);
+      const elements = await materializeOutboundMedia(this, wire);
       const kookContent = convertToKookSendable(
         elements,
         (els) => this.convertToKookFormat(els),