@jesonliu/lark-claudecode-bridge 0.10.0 → 0.13.0

package/dist/feishu/slash-commands.d.ts

@@ -0,0 +1,77 @@
+import type { BridgeConfig, FeishuAppConfig, SlashCommandDef } from '../types.js';
+/** 远端（飞书侧）已注册的斜杠命令（GET 列表条目） */
+export interface RemoteSlashCommand {
+    command_id: string;
+    command: string;
+    description: {
+        default_value?: string;
+        i18n?: Record<string, string>;
+        icon?: {
+            icon_key?: string;
+        };
+    };
+}
+/** 最小 API 客户端（执行器依赖此接口，测试注入 mock） */
+export interface SlashApiClient {
+    list(): Promise<RemoteSlashCommand[]>;
+    create(def: SlashCommandDef): Promise<string>;
+    update(commandId: string, def: SlashCommandDef): Promise<void>;
+    remove(commandId: string): Promise<void>;
+}
+/** 内置命令集（SLASH_COMMAND_META 全量映射为注册定义）——expectedCommands 与 ensureBuiltins 共用 */
+export declare function builtinCommands(): SlashCommandDef[];
+/** 期望集 = 内置命令（SLASH_COMMAND_META 全量）+ config extras；与内置重名的 extra 跳过（内置优先） */
+export declare function expectedCommands(config: BridgeConfig): SlashCommandDef[];
+/** 全量对齐 diff：远端按 command 名匹配期望集；描述/icon 变化进 toUpdate，远端多余进 toDelete */
+export declare function diffSlashCommands(remote: RemoteSlashCommand[], expected: SlashCommandDef[]): {
+    toCreate: SlashCommandDef[];
+    toUpdate: Array<{
+        commandId: string;
+        def: SlashCommandDef;
+    }>;
+    toDelete: Array<{
+        commandId: string;
+        command: string;
+    }>;
+    unchanged: string[];
+};
+export interface SyncReport {
+    created: string[];
+    updated: string[];
+    deleted: string[];
+    unchanged: string[];
+    errors: Array<{
+        command: string;
+        error: string;
+    }>;
+}
+/** 执行全量对齐同步：list → diff → 逐条 create/update/delete，每条独立容错汇总报告 */
+export declare function syncSlashCommands(client: SlashApiClient, expected: SlashCommandDef[]): Promise<SyncReport>;
+/**
+ * 只补齐远端缺失的内置命令（0.13 Web 页「补齐内置命令」按钮）：
+ * list → 内置差集 → 逐条 create，**绝不 delete/update 远端已有命令**（用户手动注册的命令不受影响）。
+ * deleted/updated 恒空；already-exists（并发残留）计 unchanged。
+ */
+export declare function ensureBuiltins(client: SlashApiClient, builtins: SlashCommandDef[]): Promise<SyncReport>;
+/** node-sdk 通用 request 的最小类型（官方 Client.request 支持 data/params，SDK 类型面未导出） */
+interface SdkClient {
+    request(payload: {
+        method: string;
+        url: string;
+        data?: unknown;
+    }): Promise<unknown>;
+}
+interface SdkModule {
+    Client: new (opts: {
+        appId: string;
+        appSecret: string;
+        domain?: unknown;
+    }) => SdkClient;
+    Domain: {
+        Feishu: unknown;
+        Lark: unknown;
+    };
+}
+/** 独立 API 客户端：不依赖运行中的 gateway（lcb ui 独立进程同样可用）；token 由 SDK 自管 */
+export declare function createSlashApiClient(app: FeishuAppConfig, sdk?: SdkModule): SlashApiClient;
+export {};

package/dist/feishu/slash-commands.js

@@ -0,0 +1,188 @@
+// 飞书 Slash Command 同步：把 bridge 命令一键注册为飞书输入框斜杠指令
+// （用户输入 / 弹面板 → 选中后命令留在输入框可继续输入描述 → 发送后走 bridge 命令/透传链路）。
+// API：application/v7/app_slash_commands CRUD，scope application:app_slash_command:write/read，
+// tenant_access_token 认证；上限 100 条；客户端生效约 5 分钟（PC 端 7.70+）。
+// 纯函数（expectedCommands / diffSlashCommands）与执行（syncSlashCommands）分离，测试免网络
+import * as lark from '@larksuiteoapi/node-sdk';
+import { SLASH_COMMAND_META } from '../session/commands.js';
+/** 内置命令集（SLASH_COMMAND_META 全量映射为注册定义）——expectedCommands 与 ensureBuiltins 共用 */
+export function builtinCommands() {
+    return Object.entries(SLASH_COMMAND_META).map(([command, meta]) => ({
+        command, description: meta.description, icon: meta.icon,
+    }));
+}
+/** 期望集 = 内置命令（SLASH_COMMAND_META 全量）+ config extras；与内置重名的 extra 跳过（内置优先） */
+export function expectedCommands(config) {
+    const out = builtinCommands();
+    const seen = new Set(out.map((d) => d.command));
+    for (const extra of config.slashCommands?.extra ?? []) {
+        if (seen.has(extra.command)) {
+            console.warn(`[斜杠命令] extra "${extra.command}" 与内置命令重名，已跳过（内置优先）`);
+            continue;
+        }
+        seen.add(extra.command);
+        out.push(extra);
+    }
+    return out;
+}
+function sameCommand(remote, def) {
+    const desc = remote.description ?? {};
+    return desc.default_value === def.description
+        && desc.i18n?.zh_cn === def.description
+        && desc.i18n?.en_us === def.description
+        && (desc.icon?.icon_key ?? 'skill_outlined') === (def.icon ?? 'skill_outlined');
+}
+/** 全量对齐 diff：远端按 command 名匹配期望集；描述/icon 变化进 toUpdate，远端多余进 toDelete */
+export function diffSlashCommands(remote, expected) {
+    const byName = new Map(remote.map((r) => [r.command, r]));
+    const toCreate = [];
+    const toUpdate = [];
+    const unchanged = [];
+    for (const def of expected) {
+        const r = byName.get(def.command);
+        if (!r) {
+            toCreate.push(def);
+            continue;
+        }
+        if (sameCommand(r, def))
+            unchanged.push(def.command);
+        else
+            toUpdate.push({ commandId: r.command_id, def });
+    }
+    const expectedNames = new Set(expected.map((d) => d.command));
+    const toDelete = remote.filter((r) => !expectedNames.has(r.command))
+        .map((r) => ({ commandId: r.command_id, command: r.command }));
+    return { toCreate, toUpdate, toDelete, unchanged };
+}
+function isAlreadyExists(err) {
+    const e = err;
+    return e?.code === 40000000 || /already exists/i.test(String(e?.msg ?? e?.message ?? ''));
+}
+/** 执行全量对齐同步：list → diff → 逐条 create/update/delete，每条独立容错汇总报告 */
+export async function syncSlashCommands(client, expected) {
+    const report = { created: [], updated: [], deleted: [], unchanged: [], errors: [] };
+    let remote;
+    try {
+        remote = await client.list();
+    }
+    catch (e) {
+        report.errors.push({ command: '(list)', error: e instanceof Error ? e.message : String(e) });
+        return report;
+    }
+    const { toCreate, toUpdate, toDelete, unchanged } = diffSlashCommands(remote, expected);
+    report.unchanged = unchanged;
+    for (const def of toCreate) {
+        try {
+            await client.create(def);
+            report.created.push(def.command);
+        }
+        catch (e) {
+            if (isAlreadyExists(e)) {
+                // 并发/历史残留导致重名：转为对现有条目的更新，保证对齐
+                try {
+                    const existing = (await client.list()).find((r) => r.command === def.command);
+                    if (existing) {
+                        await client.update(existing.command_id, def);
+                        report.updated.push(def.command);
+                        continue;
+                    }
+                }
+                catch { /* 落入 errors */ }
+            }
+            report.errors.push({ command: def.command, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    for (const { commandId, def } of toUpdate) {
+        try {
+            await client.update(commandId, def);
+            report.updated.push(def.command);
+        }
+        catch (e) {
+            report.errors.push({ command: def.command, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    for (const { commandId, command } of toDelete) {
+        try {
+            await client.remove(commandId);
+            report.deleted.push(command);
+        }
+        catch (e) {
+            report.errors.push({ command, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return report;
+}
+/**
+ * 只补齐远端缺失的内置命令（0.13 Web 页「补齐内置命令」按钮）：
+ * list → 内置差集 → 逐条 create，**绝不 delete/update 远端已有命令**（用户手动注册的命令不受影响）。
+ * deleted/updated 恒空；already-exists（并发残留）计 unchanged。
+ */
+export async function ensureBuiltins(client, builtins) {
+    const report = { created: [], updated: [], deleted: [], unchanged: [], errors: [] };
+    let remote;
+    try {
+        remote = await client.list();
+    }
+    catch (e) {
+        report.errors.push({ command: '(list)', error: e instanceof Error ? e.message : String(e) });
+        return report;
+    }
+    const names = new Set(remote.map((r) => r.command));
+    for (const def of builtins) {
+        if (names.has(def.command)) {
+            report.unchanged.push(def.command);
+            continue;
+        }
+        try {
+            await client.create(def);
+            report.created.push(def.command);
+        }
+        catch (e) {
+            if (isAlreadyExists(e)) {
+                report.unchanged.push(def.command);
+                continue;
+            }
+            report.errors.push({ command: def.command, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return report;
+}
+/** 独立 API 客户端：不依赖运行中的 gateway（lcb ui 独立进程同样可用）；token 由 SDK 自管 */
+export function createSlashApiClient(app, sdk = lark) {
+    const client = new sdk.Client({
+        appId: app.appId,
+        appSecret: app.appSecret,
+        domain: app.domain === 'lark' ? sdk.Domain.Lark : sdk.Domain.Feishu,
+    });
+    // 业务失败 SDK 不抛错而是 code!=0：统一在此转 throw，调用方单一错误通道
+    const call = async (payload) => {
+        const res = (await client.request(payload));
+        if (res && typeof res.code === 'number' && res.code !== 0) {
+            const err = new Error(`${res.msg ?? 'unknown'}（code ${res.code}）`);
+            err.code = res.code;
+            throw err;
+        }
+        return (res?.data ?? {});
+    };
+    const body = (def) => ({
+        description: {
+            default_value: def.description,
+            i18n: { zh_cn: def.description, en_us: def.description },
+            ...(def.icon ? { icon: { icon_key: def.icon } } : {}),
+        },
+    });
+    return {
+        list: async () => (await call({ method: 'GET', url: '/open-apis/application/v7/app_slash_commands' })).items ?? [],
+        create: async (def) => (await call({
+            method: 'POST', url: '/open-apis/application/v7/app_slash_commands',
+            data: { command: def.command, ...body(def) },
+        })).command_id,
+        update: async (commandId, def) => {
+            await call({ method: 'PATCH', url: `/open-apis/application/v7/app_slash_commands/${commandId}`, data: body(def) });
+        },
+        remove: async (commandId) => {
+            await call({ method: 'DELETE', url: `/open-apis/application/v7/app_slash_commands/${commandId}` });
+        },
+    };
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/feishu/slash-commands.js.map

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

package/dist/gateway/card-builder.d.ts

@@ -7,6 +7,8 @@ export interface ProgressState {
     startedAt: number;
 }
 export declare function buildTextCard(markdown: string): unknown;
+/** 进度卡正文尾部的字符上限（防爆卡片）；任务收尾据此判断短回复是否需要独立结果消息 */
+export declare const PROGRESS_TAIL_CHARS = 1200;
 /** 图片卡片：caption（可选）显示在图片上方——逐张发图时带编号说明用 */
 export declare function buildImageCard(caption: string | undefined, imgKey: string): unknown;
 export declare function buildProgressCard(state: ProgressState): unknown;

package/dist/gateway/card-builder.js

@@ -8,6 +8,8 @@ function md(content) {
 export function buildTextCard(markdown) {
     return card([md(markdown)]);
 }
+/** 进度卡正文尾部的字符上限（防爆卡片）；任务收尾据此判断短回复是否需要独立结果消息 */
+export const PROGRESS_TAIL_CHARS = 1200;
 /** 图片卡片：caption（可选）显示在图片上方——逐张发图时带编号说明用 */
 export function buildImageCard(caption, imgKey) {
     const elements = [];
@@ -22,7 +24,7 @@ export function buildProgressCard(state) {
     if (state.toolLine)
         lines.push(`🔧 ${state.toolLine}`, ``);
     if (state.textTail)
-        lines.push('---', state.textTail.slice(-1200)); // 只保留尾部，防爆卡片
+        lines.push('---', state.textTail.slice(-PROGRESS_TAIL_CHARS)); // 只保留尾部，防爆卡片
     lines.push(``, `<font color='grey'>⏱ 已运行 ${Math.floor(elapsed / 60)} 分 ${elapsed % 60} 秒</font>`);
     return card([md(lines.join('\n'))]);
 }

package/dist/gateway/card-builder.js.map

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

package/dist/gateway/feishu-gateway.d.ts

@@ -1,4 +1,4 @@
-import type { FeishuAppConfig, GatewayHandlers, IncomingMessage } from '../types.js';
+import type { FeishuAppConfig, GatewayHandlers, IncomingMessage, RejectedMessage } from '../types.js';
 /** SDK 形状：仅用到 WSClient/EventDispatcher/Client/Domain 四个导出，测试注入假对象时按此约束 */
 export interface FeishuSdk {
     WSClient: new (params: {
@@ -75,6 +75,21 @@ export interface FeishuSdk {
                     file_key?: string;
                 } | null>;
             };
+            messageResource: {
+                get(payload: {
+                    params: {
+                        type: string;
+                    };
+                    path: {
+                        message_id: string;
+                        file_key: string;
+                    };
+                }): Promise<{
+                    writeFile(filePath: string): Promise<unknown>;
+                    getReadableStream(): NodeJS.ReadableStream;
+                    headers: unknown;
+                }>;
+            };
         };
         request(payload: {
             method: string;
@@ -97,6 +112,11 @@ export declare function stripMention(text: string): string;
 /**
  * 解析 im.message.receive_v1 事件为 IncomingMessage。
  *
+ * 支持的消息类型：text（纯文本，含手打多行）、post（富文本——粘贴带格式内容会被客户端编码为
+ * 此类型，拍平为多行纯文本并提取内嵌图片）、image（纯图片，提取 image_key 供 gateway 下载）。
+ * 其余类型（audio/media/file 等）：p2p 返回 RejectedMessage 供上层回提示（不再静默蒸发），
+ * 群聊保持 null 静默（@ 判定对非常规类型无法可靠进行）。
+ *
  * 群聊 @检测：botOpenId（机器人 open_id）可用时按 mentions 数组精确匹配——
  * 占位符/mentions 非空无法区分 @机器人 vs @普通人（群里 @任何人都命中，会被误当任务执行）；
  * botOpenId 缺失（获取失败/未提供）时退化为旧的占位符 + mentions 非空判定，
@@ -111,7 +131,7 @@ export declare function stripMention(text: string): string;
  */
 export declare function parseIncomingMessage(event: unknown, botOpenId?: string, opts?: {
     strictGroupMention?: boolean;
-}): IncomingMessage | null;
+}): IncomingMessage | RejectedMessage | null;
 export declare class FeishuGateway {
     private client;
     private sdk;
@@ -119,6 +139,10 @@ export declare class FeishuGateway {
     private ws?;
     private log;
     private strictGroupMention;
+    /** 入站图片落盘目录（默认 ~/.lark-claudecode-bridge/inbox/，测试可注入临时目录） */
+    private inboxDir;
+    private seenMessageIds;
+    private static readonly SEEN_MAX;
     constructor(cfg: FeishuAppConfig, deps?: {
         sdk?: FeishuSdk;
         /** 日志出口（多 app 部署时注入带 [app:name] 前缀的 logger 以区分机器人） */
@@ -128,6 +152,8 @@ export declare class FeishuGateway {
         };
         /** 严格群聊 @ 模式：botOpenId 不可用时丢弃群消息而非退化猜测（多机器人同群防双触发） */
         strictGroupMention?: boolean;
+        /** 入站图片下载目录，缺省 CONFIG_DIR/inbox */
+        inboxDir?: string;
     });
     /**
      * 拉取机器人 open_id：群聊 @检测的精确匹配依据。
@@ -136,6 +162,15 @@ export declare class FeishuGateway {
      * 仅 warn 一次并让群聊 @检测退化为占位符匹配（严格模式下群消息将被丢弃）。
      */
     private fetchBotOpenId;
+    /** 记录 messageId 并返回是否首次出现（true=新消息，false=重复投递应忽略） */
+    private markSeen;
+    /** 响应头 content-type → 图片扩展名（未知兜底 .png） */
+    private static extFromHeaders;
+    /**
+     * 下载消息内嵌图片到 inbox 目录（文件名 messageId_序号.扩展名）。
+     * 单张失败仅 warn 记录、不阻塞其余图片与消息转发（im:resource 权限缺失等场景文字任务照常）。
+     */
+    private downloadImages;
     /** 建立 WS 长连接并注册事件分发（im.message.receive_v1 / card.action.trigger） */
     start(handlers: GatewayHandlers): Promise<void>;
     /** 优雅关闭长连接（SIGINT/SIGTERM 时逐个 app 调用）；未 start 时为 no-op */

package/dist/gateway/feishu-gateway.js

@@ -1,15 +1,55 @@
 import * as realSdk from '@larksuiteoapi/node-sdk';
-import { createReadStream } from 'node:fs';
-import { basename } from 'node:path';
+import { createReadStream, mkdirSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { CONFIG_DIR } from '../config.js';
 import { buildImageCard, buildTextCard } from './card-builder.js';
 import { isImageFile } from '../util/file-types.js';
 /** 去 @机器人 前缀（飞书群聊 @ 在文本中渲染为 @_user_N 占位） */
 export function stripMention(text) {
     return text.replace(/@_user_\d+\s*/g, '').trim();
 }
+/**
+ * post 富文本拍平为纯文本 + 图片 key 列表：
+ * text→text 字段、a→[text](href)、img→收集 image_key、at 及其他 tag→跳过；
+ * title 非空作首行，行间 \n 连接（保留多行结构）。content 非法返回 null。
+ */
+function flattenPost(rawContent) {
+    try {
+        const post = JSON.parse(rawContent);
+        if (!Array.isArray(post.content))
+            return null;
+        const imageKeys = [];
+        const lines = [];
+        if (typeof post.title === 'string' && post.title.trim())
+            lines.push(post.title);
+        for (const line of post.content) {
+            if (!Array.isArray(line))
+                continue;
+            const parts = [];
+            for (const node of line) {
+                if (node?.tag === 'text' && node.text)
+                    parts.push(node.text);
+                else if (node?.tag === 'a' && node.text)
+                    parts.push(node.href ? `[${node.text}](${node.href})` : node.text);
+                else if (node?.tag === 'img' && node.image_key)
+                    imageKeys.push(node.image_key);
+            }
+            lines.push(parts.join(''));
+        }
+        return { text: lines.join('\n'), imageKeys };
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * 解析 im.message.receive_v1 事件为 IncomingMessage。
  *
+ * 支持的消息类型：text（纯文本，含手打多行）、post（富文本——粘贴带格式内容会被客户端编码为
+ * 此类型，拍平为多行纯文本并提取内嵌图片）、image（纯图片，提取 image_key 供 gateway 下载）。
+ * 其余类型（audio/media/file 等）：p2p 返回 RejectedMessage 供上层回提示（不再静默蒸发），
+ * 群聊保持 null 静默（@ 判定对非常规类型无法可靠进行）。
+ *
  * 群聊 @检测：botOpenId（机器人 open_id）可用时按 mentions 数组精确匹配——
  * 占位符/mentions 非空无法区分 @机器人 vs @普通人（群里 @任何人都命中，会被误当任务执行）；
  * botOpenId 缺失（获取失败/未提供）时退化为旧的占位符 + mentions 非空判定，
@@ -29,10 +69,31 @@ export function parseIncomingMessage(event, botOpenId, opts = {}) {
         const raw = event;
         const payload = raw.message || raw.sender ? raw : raw.event;
         const m = payload?.message;
-        if (!m?.chat_id || !m.message_id || m.message_type !== 'text')
+        if (!m?.chat_id || !m.message_id || !m.message_type)
             return null;
-        const text = JSON.parse(m.content ?? '{}').text ?? '';
-        if (!text.trim())
+        let text = '';
+        let imageKeys = [];
+        if (m.message_type === 'text') {
+            text = JSON.parse(m.content ?? '{}').text ?? '';
+        }
+        else if (m.message_type === 'post') {
+            const flat = flattenPost(m.content ?? '{}');
+            if (!flat)
+                return null;
+            text = flat.text;
+            imageKeys = flat.imageKeys;
+        }
+        else if (m.message_type === 'image') {
+            const key = JSON.parse(m.content ?? '{}').image_key;
+            if (key)
+                imageKeys.push(key);
+        }
+        else {
+            return m.chat_type === 'p2p'
+                ? { rejected: { kind: 'unsupported-type', chatId: m.chat_id, chatType: 'p2p', messageType: m.message_type } }
+                : null;
+        }
+        if (!text.trim() && imageKeys.length === 0)
             return null;
         const isGroup = m.chat_type !== 'p2p';
         if (isGroup) {
@@ -64,6 +125,7 @@ export function parseIncomingMessage(event, botOpenId, opts = {}) {
             userId,
             text: stripMention(text),
             messageId: m.message_id,
+            ...(imageKeys.length > 0 ? { imageKeys } : {}),
         };
     }
     catch {
@@ -105,6 +167,12 @@ export class FeishuGateway {
     ws;
     log;
     strictGroupMention;
+    /** 入站图片落盘目录（默认 ~/.lark-claudecode-bridge/inbox/，测试可注入临时目录） */
+    inboxDir;
+    // 入站消息去重：飞书 WS 长连接 at-least-once 投递，重连窗口内同一消息可能重投——
+    // 不去重会导致整个任务跑两遍（两张进度卡 + 两条结果）。Map 迭代序即插入序，容量超限删最旧。
+    seenMessageIds = new Map();
+    static SEEN_MAX = 1000;
     constructor(cfg, deps = {}) {
         this.cfg = cfg;
         this.sdk = deps.sdk ?? realSdk;
@@ -114,6 +182,7 @@ export class FeishuGateway {
             error: (...a) => console.error(tag, ...a),
         };
         this.strictGroupMention = deps.strictGroupMention ?? false;
+        this.inboxDir = deps.inboxDir ?? join(CONFIG_DIR, 'inbox');
         const domain = cfg.domain === 'lark' ? this.sdk.Domain.Lark : this.sdk.Domain.Feishu;
         this.client = new this.sdk.Client({ appId: cfg.appId, appSecret: cfg.appSecret, domain });
     }
@@ -136,6 +205,55 @@ export class FeishuGateway {
         }
         return undefined;
     }
+    /** 记录 messageId 并返回是否首次出现（true=新消息，false=重复投递应忽略） */
+    markSeen(messageId) {
+        if (this.seenMessageIds.has(messageId))
+            return false;
+        this.seenMessageIds.set(messageId, Date.now());
+        if (this.seenMessageIds.size > FeishuGateway.SEEN_MAX) {
+            const oldest = this.seenMessageIds.keys().next().value;
+            if (oldest !== undefined)
+                this.seenMessageIds.delete(oldest);
+        }
+        return true;
+    }
+    /** 响应头 content-type → 图片扩展名（未知兜底 .png） */
+    static extFromHeaders(headers) {
+        const ct = String(headers?.['content-type'] ?? '');
+        if (ct.includes('jpeg') || ct.includes('jpg'))
+            return '.jpg';
+        if (ct.includes('gif'))
+            return '.gif';
+        if (ct.includes('webp'))
+            return '.webp';
+        return '.png';
+    }
+    /**
+     * 下载消息内嵌图片到 inbox 目录（文件名 messageId_序号.扩展名）。
+     * 单张失败仅 warn 记录、不阻塞其余图片与消息转发（im:resource 权限缺失等场景文字任务照常）。
+     */
+    async downloadImages(msg) {
+        const paths = [];
+        const failures = [];
+        mkdirSync(this.inboxDir, { recursive: true });
+        for (let i = 0; i < (msg.imageKeys ?? []).length; i++) {
+            const key = msg.imageKeys[i];
+            try {
+                const res = await this.client.im.messageResource.get({
+                    path: { message_id: msg.messageId, file_key: key },
+                    params: { type: 'image' },
+                });
+                const filePath = join(this.inboxDir, `${msg.messageId}_${i + 1}${FeishuGateway.extFromHeaders(res?.headers)}`);
+                await res.writeFile(filePath);
+                paths.push(filePath);
+            }
+            catch (e) {
+                this.log.warn(`[图片] 下载失败（${key}）：`, e);
+                failures.push(key);
+            }
+        }
+        return { paths, failures };
+    }
     /** 建立 WS 长连接并注册事件分发（im.message.receive_v1 / card.action.trigger） */
     async start(handlers) {
         const botOpenId = await this.fetchBotOpenId();
@@ -143,9 +261,36 @@ export class FeishuGateway {
         this.ws = ws;
         const dispatcher = new this.sdk.EventDispatcher({}).register({
             'im.message.receive_v1': async (data) => {
-                const msg = parseIncomingMessage(data, botOpenId, { strictGroupMention: this.strictGroupMention });
-                if (msg)
-                    await handlers.onMessage(msg);
+                const parsed = parseIncomingMessage(data, botOpenId, { strictGroupMention: this.strictGroupMention });
+                if (parsed && 'rejected' in parsed) {
+                    // 不支持的消息类型（p2p）：明确反馈而非静默蒸发；提示发送失败不影响主流程
+                    if (parsed.rejected.chatType === 'p2p') {
+                        await this.sendText(parsed.rejected.chatId, `🤖 暂不支持该消息类型（${parsed.rejected.messageType}），当前支持：文字、富文本（多行/粘贴）、图片`)
+                            .catch((e) => this.log.warn('[类型提示] 发送失败：', e));
+                    }
+                    return;
+                }
+                if (parsed && !this.markSeen(parsed.messageId)) {
+                    this.log.warn('[去重] 忽略重复投递的消息', parsed.messageId);
+                    return;
+                }
+                if (parsed) {
+                    // 图片消息：先下载落盘，再把本地路径注记拼进 text——下游（触发词/命令/执行器/transcript）
+                    // 对注记形态无感知，Claude Code 侧用 Read 工具读取路径即可看到图片
+                    if ((parsed.imageKeys?.length ?? 0) > 0) {
+                        const { paths, failures } = await this.downloadImages(parsed);
+                        const hasText = parsed.text.trim().length > 0;
+                        const notes = [];
+                        if (paths.length > 0) {
+                            notes.push(`[用户${hasText ? '随消息' : ''}发送了 ${paths.length} 张图片${hasText ? '' : '（无文字说明）'}，已保存到本地：${paths.join('、')}。需要查看图片内容时用 Read 工具读取这些路径。]`);
+                        }
+                        if (failures.length > 0) {
+                            notes.push(`[另有 ${failures.length} 张图片下载失败（${failures.join('、')}）——如需查看请让用户重发，或检查应用 im:resource 权限。]`);
+                        }
+                        parsed.text = hasText ? `${parsed.text}\n\n${notes.join('\n')}` : notes.join('\n');
+                    }
+                    await handlers.onMessage(parsed);
+                }
             },
             // 卡片回调必须返回对象（飞书 SDK 契约：返回值经 WS 回传，undefined 会被当异常）；
             // handler 返回了响应体（如 toast / 内联换卡 card）则透传，否则返回 {}。