@dsh-overdrive/gateway 0.3.0 → 0.3.1

package/package.json

@@ -1,16 +1,21 @@
-{
+{
   "name": "@dsh-overdrive/gateway",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "prepack": "npm run build"
   },
   "bin": {
     "dsh-overdrive-gateway": "dist/index.js",
     "dsh-overdrive-setup": "dist/setup.js"
   },
+  "files": [
+    "dist",
+    "web"
+  ],
   "dependencies": {
-    "@dsh-overdrive/sdk": "0.1.2",
+    "@dsh-overdrive/sdk": "^0.1.2",
     "@larksuiteoapi/node-sdk": "^1.50.0",
     "@slack/bolt": "^3.0.0",
     "@whiskeysockets/baileys": "^6.0.1",

package/src/adapter.ts

@@ -1,42 +0,0 @@
-export interface NormalizedMessage {
-  chatId: string;
-  userId: string;
-  text: string;
-  media?: { kind: 'voice' | 'image' | 'video' | 'file'; url?: string; mime?: string; caption?: string };
-}
-
-export interface OutboundButton { id: string; label: string; }
-
-/** 出站媒体（/send 等）：path 为本地文件路径。 */
-export interface OutboundMedia {
-  kind: 'image' | 'file' | 'voice';
-  path: string;
-  caption?: string;
-}
-
-export interface OutboundPayload {
-  text: string;
-  buttons?: OutboundButton[];
-  /** 可选：随消息发送的本地媒体文件；不支持媒体的适配器忽略并只发文本。 */
-  media?: OutboundMedia;
-}
-
-/** 按钮回执的点击者身份（用于白名单校验）。chatId 在个别平台回调中可能缺失，缺失时按未授权处理（fail-closed）。 */
-export interface ReplySender {
-  chatId: string;
-  userId: string;
-}
-
-/** 平台适配器契约：M2/M3 的 WhatsApp/Telegram/… 都实现它。 */
-export interface Adapter {
-  readonly id: string;
-  connect(): Promise<void>;
-  send(chatId: string, payload: OutboundPayload): Promise<void>;
-  /** 可选：平台"正在输入"指示（Telegram/WhatsApp 实现，其余默认无操作）。 */
-  sendTyping?(chatId: string): Promise<void>;
-  /** 可选：连接状态（供控制台）。 */
-  status?(): { connected: boolean };
-  onMessage(cb: (msg: NormalizedMessage) => void): void;
-  /** 按钮点击回执：buttonId + 点击者身份。身份缺失即传空字符串，由上层按未授权处理。 */
-  onReply(cb: (buttonId: string, sender: ReplySender) => void): void;
-}

package/src/adapters/cli.ts

@@ -1,37 +0,0 @@
-import { createInterface } from 'node:readline';
-import type { Adapter, NormalizedMessage, OutboundPayload } from '../adapter.js';
-
-/** 本地命令行适配器：M1 用于验证全链路，也是 M2+ 平台适配器的样板。 */
-export class CliAdapter implements Adapter {
-  readonly id = 'cli';
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-  private rl?: ReturnType<typeof createInterface>;
-
-  async connect(): Promise<void> {
-    this.rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-    this.rl.on('line', (line) => {
-      const trimmed = line.trim();
-      if (!trimmed) return;
-      const btn = trimmed.match(/^\/btn\s+(\S+)$/i);
-      if (btn) {
-        this.replyCb?.(btn[1], { chatId: 'cli', userId: 'local' });
-        return;
-      }
-      this.messageCb?.({ chatId: 'cli', userId: 'local', text: trimmed });
-    });
-  }
-
-  async send(_chatId: string, payload: OutboundPayload): Promise<void> {
-    const lines = [payload.text];
-    for (const b of payload.buttons ?? []) {
-      lines.push(`  [按钮] ${b.label} → 输入 /btn ${b.id}`);
-    }
-    process.stdout.write(lines.join('\n') + '\n');
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  /** CLI 是本地进程内适配器：恒为已连接。 */
-  status(): { connected: boolean } { return { connected: true }; }
-}

package/src/adapters/dingtalk.ts

@@ -1,206 +0,0 @@
-import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
-import { PendingButtons } from '../pending-buttons.js';
-import { DWClient, TOPIC_CARD, TOPIC_ROBOT, type RobotMessage } from 'dingtalk-stream-sdk-nodejs';
-
-// dingtalk-stream-sdk-nodejs@2.0.4 实测：exports 提供 DWClient + TOPIC_ROBOT
-// （/v1.0/im/bot/messages/get）；回调 registerCallbackListener(TOPIC_ROBOT, (msg) => …)，
-// msg.data 是 RobotMessage 的 JSON 字符串；回复直接 POST 消息内的 sessionWebhook（无需 access_token）。
-
-// ── 纯函数 ────────────────────────────────────────────────────
-
-export interface ParsedRobotMessage {
-  chatId: string;
-  userId: string;
-  text: string;
-  sessionWebhook: string;
-}
-
-export function parseBotMessage(data: RobotMessage): ParsedRobotMessage | null {
-  if (data.msgtype !== 'text' || !data.text?.content) return null;
-  if (!data.conversationId || !data.senderStaffId || !data.sessionWebhook) return null;
-  return {
-    chatId: data.conversationId,
-    userId: data.senderStaffId,
-    text: data.text.content,
-    sessionWebhook: data.sessionWebhook,
-  };
-}
-
-export function buildReplyBody(text: string): { msgtype: 'text'; text: { content: string } } {
-  return { msgtype: 'text', text: { content: text } };
-}
-
-export function buildNumberedText(text: string, buttons: OutboundButton[]): string {
-  if (buttons.length === 0) return text;
-  const options = buttons.map((b, i) => `${i + 1}) ${b.label}`).join('\n');
-  return `${text}\n\n${options}\n\n回复数字选择。`;
-}
-
-export function matchNumberedButton(text: string, buttons: OutboundButton[]): OutboundButton | undefined {
-  const n = Number(text.trim());
-  if (!Number.isInteger(n) || n < 1 || n > buttons.length) return undefined;
-  return buttons[n - 1];
-}
-
-/** 按钮 id（"approve:<reqId>" / "reject:<reqId>"）→ 卡片回调载荷 JSON 字符串。 */
-export function buttonCallbackData(button: OutboundButton): string {
-  const idx = button.id.indexOf(':');
-  return JSON.stringify({
-    action: idx >= 0 ? button.id.slice(0, idx) : button.id,
-    reqId: idx >= 0 ? button.id.slice(idx + 1) : '',
-  });
-}
-
-/** 钉钉 actionCard 消息体（Roadmap v0.2）。按钮回调经 TOPIC_CARD 走 Stream 返回。 */
-export function buildActionCard(text: string, buttons: OutboundButton[]): {
-  msgtype: 'actionCard';
-  actionCard: { title: string; text: string; btnOrientation: string; btns: Array<{ title: string; actionURL: string }> };
-} {
-  return {
-    msgtype: 'actionCard',
-    actionCard: {
-      title: '需要批准',
-      text,
-      btnOrientation: '1',
-      btns: buttons.map((b) => ({
-        title: b.label,
-        actionURL: `dingtalk://dingtalkclient/action/openapp?cardCallbackData=${encodeURIComponent(buttonCallbackData(b))}`,
-      })),
-    },
-  };
-}
-
-export interface CardCallbackResult {
-  buttonId: string;
-  chatId?: string;
-  userId?: string;
-}
-
-/**
- * 钉钉卡片回调载荷 → { buttonId, chatId?, userId? }。
- * Stream 模式下回调 JSON 的字段名（cardCallbackData / params / cardActionData，以及会话/用户字段）
- * 在不同卡片版本有差异，这里做多路径深度兜底解析；真机验证后可按实际字段收敛。找不到返回 null。
- */
-export function parseCardCallback(raw: unknown): CardCallbackResult | null {
-  let buttonId: string | null = null;
-  let chatId: string | undefined;
-  let userId: string | undefined;
-
-  const visit = (obj: unknown, depth: number): void => {
-    if (depth > 5 || !obj || typeof obj !== 'object') return;
-    for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {
-      if (!buttonId && typeof value === 'string' && (key === 'cardCallbackData' || key === 'params' || key === 'cardActionData')) {
-        try {
-          const parsed = JSON.parse(value) as { action?: string; reqId?: string };
-          if ((parsed.action === 'approve' || parsed.action === 'reject') && typeof parsed.reqId === 'string' && parsed.reqId) {
-            buttonId = `${parsed.action}:${parsed.reqId}`;
-          }
-        } catch {
-          /* 该字段不是 JSON 载荷，继续往下找 */
-        }
-      }
-      if (!chatId && typeof value === 'string' && (key === 'conversationId' || key === 'conversation_id') && value) {
-        chatId = value;
-      }
-      if (!userId && typeof value === 'string' && (key === 'senderStaffId' || key === 'senderId' || key === 'userid' || key === 'userId') && value) {
-        userId = value;
-      }
-      if (typeof value === 'object') visit(value, depth + 1);
-    }
-  };
-  visit(raw, 0);
-  return buttonId ? { buttonId, chatId, userId } : null;
-}
-
-// ── 适配器 ────────────────────────────────────────────────────
-
-export interface DingTalkAdapterOptions {
-  clientId: string;
-  clientSecret: string;
-}
-
-export class DingTalkAdapter implements Adapter {
-  readonly id = 'dingtalk';
-  private client?: DWClient;
-  private connected = false;
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-  private readonly pendingButtons = new PendingButtons();
-  /** conversationId → 最近的 sessionWebhook（回复通道，过期由钉钉侧管理） */
-  private readonly webhooks = new Map<string, string>();
-
-  constructor(private readonly opts: DingTalkAdapterOptions) {}
-
-  async connect(): Promise<void> {
-    const client = new DWClient({ clientId: this.opts.clientId, clientSecret: this.opts.clientSecret });
-    this.client = client;
-    client.registerCallbackListener(TOPIC_ROBOT, (msg) => {
-      let data: RobotMessage;
-      try {
-        data = JSON.parse(msg.data) as RobotMessage;
-      } catch {
-        return;
-      }
-      const parsed = parseBotMessage(data);
-      if (!parsed) return;
-      this.webhooks.set(parsed.chatId, parsed.sessionWebhook);
-      const button = this.pendingButtons.match(parsed.chatId, parsed.text);
-      if (button) {
-        this.replyCb?.(button.id, { chatId: parsed.chatId, userId: parsed.userId });
-        return;
-      }
-      this.messageCb?.({ chatId: parsed.chatId, userId: parsed.userId, text: parsed.text });
-    });
-    // 原生 actionCard 按钮回调（Stream 模式，Roadmap v0.2）
-    client.registerCallbackListener(TOPIC_CARD, (msg) => {
-      let data: unknown;
-      try {
-        data = JSON.parse(msg.data) as unknown;
-      } catch {
-        return;
-      }
-      const result = parseCardCallback(data);
-      if (result) {
-        this.replyCb?.(result.buttonId, {
-          chatId: result.chatId ?? result.userId ?? '',
-          userId: result.userId ?? '',
-        });
-      }
-    });
-    await client.connect();
-    this.connected = true;
-    console.log('[dingtalk] 钉钉 Stream 已连接');
-  }
-
-  async send(chatId: string, payload: OutboundPayload): Promise<void> {
-    const webhook = this.webhooks.get(chatId);
-    if (!webhook) throw new Error(`钉钉会话 ${chatId} 无可用 sessionWebhook（先让用户发一条消息）`);
-    if (payload.buttons?.length) {
-      this.pendingButtons.set(chatId, payload.buttons); // 卡片之外仍支持编号回复兜底
-      const res = await fetch(webhook, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify(buildActionCard(payload.text, payload.buttons)),
-      });
-      if (!res.ok) {
-        const body = await res.text();
-        throw new Error(`钉钉回发失败 ${res.status}: ${body.slice(0, 200)}`);
-      }
-      return;
-    }
-    const text = buildNumberedText(payload.text, payload.buttons ?? []);
-    const res = await fetch(webhook, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify(buildReplyBody(text)),
-    });
-    if (!res.ok) {
-      const body = await res.text();
-      throw new Error(`钉钉回发失败 ${res.status}: ${body.slice(0, 200)}`);
-    }
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  status(): { connected: boolean } { return { connected: this.connected }; }
-}

package/src/adapters/discord.ts

@@ -1,127 +0,0 @@
-import {
-  ActionRowBuilder,
-  ButtonBuilder,
-  ButtonStyle,
-  Client,
-  Events,
-  GatewayIntentBits,
-  type ButtonInteraction,
-  type Message,
-} from 'discord.js';
-import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
-
-// ── 纯函数 ────────────────────────────────────────────────────
-
-export interface RawDiscordMessage {
-  channelId?: string;
-  author?: { id?: string; bot?: boolean };
-  content?: string;
-  attachments?: Array<{ url?: string; contentType?: string }>;
-}
-
-/** 纯函数：取第一条附件的下载 URL（attachments.first().url）；无附件返回 undefined。 */
-export function discordAttachmentUrl(raw: RawDiscordMessage): string | undefined {
-  return raw.attachments?.[0]?.url;
-}
-
-type MediaKind = 'voice' | 'image' | 'video' | 'file';
-
-function mediaKindFromMime(mime?: string): MediaKind {
-  if (mime?.startsWith('image/')) return 'image';
-  if (mime?.startsWith('audio/')) return 'voice';
-  if (mime?.startsWith('video/')) return 'video';
-  return 'file';
-}
-
-export function normalizeDiscordMessage(raw: RawDiscordMessage): NormalizedMessage | null {
-  if (!raw.channelId || !raw.author?.id || raw.author.bot) return null;
-  const text = raw.content ?? '';
-  const url = discordAttachmentUrl(raw);
-  if (!text && !url) return null;
-  const out: NormalizedMessage = { chatId: raw.channelId, userId: raw.author.id, text };
-  if (url) out.media = { kind: mediaKindFromMime(raw.attachments?.[0]?.contentType), url };
-  return out;
-}
-
-export function discordComponents(buttons: OutboundButton[]): Array<{ type: 1; components: unknown[] }> {
-  return [{
-    type: 1,
-    components: buttons.map((b) => ({
-      type: 2,
-      custom_id: b.id,
-      label: b.label,
-      style: 1, // ButtonStyle.Primary
-    })),
-  }];
-}
-
-// ── 适配器 ────────────────────────────────────────────────────
-
-export interface DiscordAdapterOptions { token: string; }
-
-export class DiscordAdapter implements Adapter {
-  readonly id = 'discord';
-  private readonly client: Client;
-  private connected = false;
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-
-  constructor(opts: DiscordAdapterOptions) {
-    this.client = new Client({
-      intents: [
-        GatewayIntentBits.Guilds,
-        GatewayIntentBits.GuildMessages,
-        GatewayIntentBits.DirectMessages,
-        GatewayIntentBits.MessageContent,
-      ],
-    });
-    void opts.token;
-    this.client.login(opts.token).catch((e) => console.error('[discord] 登录失败:', e));
-  }
-
-  async connect(): Promise<void> {
-    this.client.once(Events.ClientReady, () => { this.connected = true; console.log('[discord] 已连接 Discord'); });
-    this.client.on(Events.MessageCreate, (m: Message) => {
-      const msg = normalizeDiscordMessage(m as never);
-      if (msg) this.messageCb?.(msg);
-    });
-    this.client.on(Events.InteractionCreate, async (interaction) => {
-      if (!interaction.isButton()) return;
-      const button = interaction as ButtonInteraction;
-      await button.deferUpdate().catch(() => undefined);
-      this.replyCb?.(button.customId, {
-        chatId: button.channelId,
-        userId: button.user.id,
-      });
-    });
-  }
-
-  async send(chatId: string, payload: OutboundPayload): Promise<void> {
-    const channel = await this.client.channels.fetch(chatId);
-    if (!channel || !('send' in channel)) {
-      console.error(`[discord] 无法向 ${chatId} 发送（channel 不可用）`);
-      return;
-    }
-    if (payload.media) {
-      await (channel as { send: (o: unknown) => Promise<unknown> }).send({
-        content: payload.text,
-        files: [payload.media.path],
-      });
-      return;
-    }
-    if (payload.buttons?.length) {
-      const row = new ActionRowBuilder<ButtonBuilder>().addComponents(
-        payload.buttons.map((b) =>
-          new ButtonBuilder().setCustomId(b.id).setLabel(b.label).setStyle(ButtonStyle.Primary),
-        ),
-      );
-      await (channel as { send: (o: unknown) => Promise<unknown> }).send({ content: payload.text, components: [row] });
-      return;
-    }
-    await (channel as { send: (o: unknown) => Promise<unknown> }).send(payload.text);
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  status(): { connected: boolean } { return { connected: this.connected }; }
-}

package/src/adapters/feishu.ts

@@ -1,224 +0,0 @@
-import { readFileSync } from 'node:fs';
-import lark from '@larksuiteoapi/node-sdk';
-import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
-import { PendingButtons } from '../pending-buttons.js';
-
-// @larksuiteoapi/node-sdk 是 CommonJS 包（main=lib/index.js，无 "type":"module"）：
-// Node 原生 ESM 下必须 default 导入后解构（同 M2b 的 @slack/bolt 处理）。
-const { Client, WSClient, EventDispatcher } = lark;
-
-// ── 纯函数 ────────────────────────────────────────────────────
-
-export interface FeishuReceivePayload {
-  event?: {
-    message?: {
-      message_id?: string;
-      chat_id?: string;
-      message_type?: string;
-      content?: string;
-    };
-    sender?: { sender_id?: { open_id?: string } };
-  };
-}
-
-export function parseFeishuTextMessage(payload: FeishuReceivePayload): NormalizedMessage | null {
-  const message = payload.event?.message;
-  const sender = payload.event?.sender?.sender_id?.open_id;
-  if (!message?.chat_id || !sender) return null;
-  if (message.message_type !== 'text') return null;
-  let text = '';
-  try {
-    text = (JSON.parse(message.content ?? '{}') as { text?: string }).text ?? '';
-  } catch {
-    return null;
-  }
-  if (!text) return null;
-  return { chatId: message.chat_id, userId: sender, text };
-}
-
-export function buildNumberedText(text: string, buttons: OutboundButton[]): string {
-  if (buttons.length === 0) return text;
-  const options = buttons.map((b, i) => `${i + 1}) ${b.label}`).join('\n');
-  return `${text}\n\n${options}\n\n回复数字选择。`;
-}
-
-export function matchNumberedButton(text: string, buttons: OutboundButton[]): OutboundButton | undefined {
-  const n = Number(text.trim());
-  if (!Number.isInteger(n) || n < 1 || n > buttons.length) return undefined;
-  return buttons[n - 1];
-}
-
-/** 按钮 id（"approve:<reqId>" / "reject:<reqId>"）→ 卡片按钮 value。 */
-export function buttonValue(button: OutboundButton): { action: string; reqId: string } {
-  const idx = button.id.indexOf(':');
-  return {
-    action: idx >= 0 ? button.id.slice(0, idx) : button.id,
-    reqId: idx >= 0 ? button.id.slice(idx + 1) : '',
-  };
-}
-
-/** 交互卡片 JSON（msg_type: interactive）。原生按钮点击走 card.action.trigger 回调。 */
-export function buildApprovalCard(text: string, buttons: OutboundButton[]): string {
-  const actions = buttons.map((b) => ({
-    tag: 'button',
-    text: { tag: 'plain_text', content: b.label },
-    type: b.id.startsWith('approve:') ? 'primary' : 'default',
-    value: buttonValue(b),
-  }));
-  const card = {
-    config: { wide_screen_mode: true },
-    header: { title: { tag: 'plain_text', content: text.slice(0, 60) }, template: 'blue' },
-    elements: [
-      { tag: 'div', text: { tag: 'lark_md', content: text } },
-      { tag: 'action', actions },
-    ],
-  };
-  return JSON.stringify(card);
-}
-
-/** 卡片回调 value → 按钮 id（"approve:<reqId>"）；缺字段返回 null。 */
-export function cardActionToButtonId(value: unknown): string | null {
-  if (!value || typeof value !== 'object') return null;
-  const { action, reqId } = value as { action?: unknown; reqId?: unknown };
-  if ((action !== 'approve' && action !== 'reject') || typeof reqId !== 'string' || !reqId) return null;
-  return `${action}:${reqId}`;
-}
-
-// ── 适配器 ────────────────────────────────────────────────────
-
-export interface FeishuAdapterOptions {
-  appId: string;
-  appSecret: string;
-}
-
-export class FeishuAdapter implements Adapter {
-  readonly id = 'feishu';
-  private readonly client: InstanceType<typeof Client>;
-  private ws?: InstanceType<typeof WSClient>;
-  private connected = false;
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-  private readonly pendingButtons = new PendingButtons();
-  /** chatId → 最近一条入站消息的 message_id（send 优先 reply，缺失则 create 兜底） */
-  private readonly lastMessageIds = new Map<string, string>();
-
-  constructor(private readonly opts: FeishuAdapterOptions) {
-    this.client = new Client({ appId: opts.appId, appSecret: opts.appSecret });
-  }
-
-  async connect(): Promise<void> {
-    const dispatcher = new EventDispatcher({}).register({
-      'im.message.receive_v1': async (data: FeishuReceivePayload) => {
-        const message = data.event?.message;
-        if (message?.chat_id && message.message_id) {
-          this.lastMessageIds.set(message.chat_id, message.message_id);
-        }
-        const normalized = parseFeishuTextMessage(data);
-        if (!normalized) return;
-        const chatId = normalized.chatId;
-        const button = this.pendingButtons.match(chatId, normalized.text);
-        if (button) {
-          this.replyCb?.(button.id, { chatId, userId: normalized.userId });
-          return;
-        }
-        this.messageCb?.(normalized);
-      },
-      // 原生交互卡片按钮回调 → 审批应答（Roadmap v0.2）
-      // 载荷字段（operator.open_id / context.open_chat_id）取自官方卡片回调事件；
-      // 个别版本字段名可能不同 —— 拿不到身份时上层按未授权处理（fail-closed），编号回复兜底不受影响。
-      'card.action.trigger': async (data: {
-        action?: { value?: unknown };
-        operator?: { open_id?: string };
-        context?: { open_chat_id?: string };
-      }) => {
-        const buttonId = cardActionToButtonId(data?.action?.value);
-        if (buttonId) {
-          this.replyCb?.(buttonId, {
-            chatId: data?.context?.open_chat_id ?? '',
-            userId: data?.operator?.open_id ?? '',
-          });
-        }
-      },
-    });
-    this.ws = new WSClient({
-      appId: this.opts.appId,
-      appSecret: this.opts.appSecret,
-      loggerLevel: lark.LoggerLevel.error,
-    });
-    await this.ws.start({ eventDispatcher: dispatcher });
-    this.connected = true;
-    console.log('[feishu] 飞书长连接已建立');
-  }
-
-  async send(chatId: string, payload: OutboundPayload): Promise<void> {
-    if (payload.media) {
-      // 媒体发送：上传 → 换取 image_key / file_key → 发消息；失败降级为文本路径
-      try {
-        const buf = readFileSync(payload.media.path);
-        const messageId = this.lastMessageIds.get(chatId);
-        if (payload.media.kind === 'image') {
-          const uploaded = await this.client.im.image.create({
-            data: { image_type: 'message', image: buf },
-          });
-          const content = JSON.stringify({ image_key: uploaded?.image_key ?? '' });
-          if (messageId) {
-            await this.client.im.message.reply({ path: { message_id: messageId }, data: { msg_type: 'image', content } });
-          } else {
-            await this.client.im.message.create({ params: { receive_id_type: 'chat_id' }, data: { receive_id: chatId, msg_type: 'image', content } });
-          }
-          return;
-        }
-        const uploaded = await this.client.im.file.create({
-          data: { file_type: 'stream', file_name: payload.media.caption ?? payload.media.path.split('/').pop() ?? 'file', file: buf },
-        });
-        const content = JSON.stringify({ file_key: uploaded?.file_key ?? '' });
-        if (messageId) {
-          await this.client.im.message.reply({ path: { message_id: messageId }, data: { msg_type: 'file', content } });
-        } else {
-          await this.client.im.message.create({ params: { receive_id_type: 'chat_id' }, data: { receive_id: chatId, msg_type: 'file', content } });
-        }
-        return;
-      } catch (error) {
-        console.warn(`[feishu] 媒体上传失败，降级为文本: ${error instanceof Error ? error.message : String(error)}`);
-        // 继续走文本发送（含 📎 路径）
-      }
-    }
-    if (payload.buttons?.length) {
-      this.pendingButtons.set(chatId, payload.buttons); // 卡片之外仍支持编号回复兜底
-      const content = buildApprovalCard(payload.text, payload.buttons);
-      const messageId = this.lastMessageIds.get(chatId);
-      if (messageId) {
-        await this.client.im.message.reply({
-          path: { message_id: messageId },
-          data: { msg_type: 'interactive', content },
-        });
-      } else {
-        await this.client.im.message.create({
-          params: { receive_id_type: 'chat_id' },
-          data: { receive_id: chatId, msg_type: 'interactive', content },
-        });
-      }
-      return;
-    }
-    const text = buildNumberedText(payload.text, payload.buttons ?? []);
-    const content = JSON.stringify({ text });
-    const messageId = this.lastMessageIds.get(chatId);
-    if (messageId) {
-      // 有最近入站消息：im.message.reply（path=message_id）回复原消息
-      await this.client.im.message.reply({
-        path: { message_id: messageId },
-        data: { msg_type: 'text', content },
-      });
-    } else {
-      // 无入站消息（主动下发）：im.message.create 按 receive_id=chat_id 发送
-      await this.client.im.message.create({
-        params: { receive_id_type: 'chat_id' },
-        data: { receive_id: chatId, msg_type: 'text', content },
-      });
-    }
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  status(): { connected: boolean } { return { connected: this.connected }; }
-}