@zhin.js/adapter-lark 1.0.55 → 1.0.57

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @zhin.js/adapter-lark
 
+## 1.0.57
+
+### Patch Changes
+
+- Updated dependencies [bb6bfa8]
+- Updated dependencies [bb6bfa8]
+  - zhin.js@1.0.52
+  - @zhin.js/http@1.0.46
+
+## 1.0.56
+
+### Patch Changes
+
+- zhin.js@1.0.51
+- @zhin.js/http@1.0.45
+
 ## 1.0.55
 
 ### Patch Changes

package/README.md

@@ -9,7 +9,7 @@ Zhin.js 飞书 / Lark 适配器，支持飞书机器人的消息收发和群管
 - Bearer Token 自动刷新
 - 消息加密和签名验证（可选）
 - URL 验证自动处理
-- 群管理 AI 工具（通过 declareSkill 暴露给 AI）
+- 群管理 AI 工具（通过包内 `skills/lark/SKILL.md` 与 `addTool` 暴露给 AI）
 
 ## 安装
 

package/lib/adapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 飞书/Lark 适配器
+ */
+import { Adapter, Plugin } from "zhin.js";
+import { LarkBot } from "./bot.js";
+import type { LarkBotConfig } from "./types.js";
+export declare class LarkAdapter extends Adapter<LarkBot> {
+    #private;
+    constructor(plugin: Plugin, router: any);
+    createBot(config: LarkBotConfig): LarkBot;
+    kickMember(botId: string, sceneId: string, userId: string): Promise<boolean>;
+    listMembers(botId: string, sceneId: string): Promise<any[]>;
+    getGroupInfo(botId: string, sceneId: string): Promise<any>;
+    setGroupName(botId: string, sceneId: string, name: string): Promise<boolean>;
+    start(): Promise<void>;
+    /**
+     * 注册飞书平台特有工具（获取用户、设管等）
+     */
+    private registerLarkPlatformTools;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,OAAO,EACP,MAAM,EAGP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,WAAY,SAAQ,OAAO,CAAC,OAAO,CAAC;;gBAGjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAKvC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAMnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMzD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM1C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM3C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAQzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CA0MpC"}

package/lib/adapter.js

@@ -0,0 +1,253 @@
+/**
+ * 飞书/Lark 适配器
+ */
+import { Adapter, createGroupManagementTools, } from "zhin.js";
+import { LarkBot } from "./bot.js";
+export class LarkAdapter extends Adapter {
+    #router;
+    constructor(plugin, router) {
+        super(plugin, 'lark', []);
+        this.#router = router;
+    }
+    createBot(config) {
+        return new LarkBot(this, this.#router, config);
+    }
+    // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+    async kickMember(botId, sceneId, userId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.removeChatMembers(sceneId, [userId]);
+    }
+    async listMembers(botId, sceneId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.getChatMembers(sceneId);
+    }
+    async getGroupInfo(botId, sceneId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.getChatInfo(sceneId);
+    }
+    async setGroupName(botId, sceneId, name) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.updateChatInfo(sceneId, { name });
+    }
+    // ── 生命周期 ───────────────────────────────────────────────────────
+    async start() {
+        this.registerLarkPlatformTools();
+        const groupTools = createGroupManagementTools(this, this.name);
+        groupTools.forEach((t) => this.addTool(t));
+        await super.start();
+    }
+    /**
+     * 注册飞书平台特有工具（获取用户、设管等）
+     */
+    registerLarkPlatformTools() {
+        // 获取用户信息工具
+        this.addTool({
+            name: 'lark_get_user',
+            description: '获取飞书用户信息',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    user_id: { type: 'string', description: '用户 ID (open_id)' },
+                },
+                required: ['bot', 'user_id'],
+            },
+            platforms: ['lark'],
+            scopes: ['group', 'private'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId, user_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                return await bot.getUserInfo(user_id);
+            },
+        });
+        // 创建群聊工具
+        this.addTool({
+            name: 'lark_create_chat',
+            description: '创建飞书群聊',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    name: { type: 'string', description: '群名' },
+                    members: { type: 'array', items: { type: 'string' }, description: '成员 open_id 列表' },
+                    owner: { type: 'string', description: '群主 open_id（可选）' },
+                },
+                required: ['bot', 'name', 'members'],
+            },
+            platforms: ['lark'],
+            scopes: ['group', 'private'],
+            permissionLevel: 'group_admin',
+            execute: async (args) => {
+                const { bot: botId, name, members, owner } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const chatId = await bot.createChat(name, members, owner);
+                return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
+            },
+        });
+        // 更新群信息工具
+        this.addTool({
+            name: 'lark_update_chat',
+            description: '更新飞书群聊信息（群名、描述）',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    chat_id: { type: 'string', description: '群聊 ID' },
+                    name: { type: 'string', description: '新群名（可选）' },
+                    description: { type: 'string', description: '新描述（可选）' },
+                },
+                required: ['bot', 'chat_id'],
+            },
+            platforms: ['lark'],
+            scopes: ['group'],
+            permissionLevel: 'group_admin',
+            execute: async (args) => {
+                const { bot: botId, chat_id, name, description } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.updateChatInfo(chat_id, { name, description });
+                return { success, message: success ? '群信息更新成功' : '更新失败' };
+            },
+        });
+        // 添加群成员工具
+        this.addTool({
+            name: 'lark_add_members',
+            description: '添加飞书群成员',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    chat_id: { type: 'string', description: '群聊 ID' },
+                    user_ids: { type: 'array', items: { type: 'string' }, description: '用户 open_id 列表' },
+                },
+                required: ['bot', 'chat_id', 'user_ids'],
+            },
+            platforms: ['lark'],
+            scopes: ['group'],
+            permissionLevel: 'group_admin',
+            execute: async (args) => {
+                const { bot: botId, chat_id, user_ids } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.addChatMembers(chat_id, user_ids);
+                return { success, message: success ? '成员添加成功' : '添加失败' };
+            },
+        });
+        // 设置群管理员工具
+        this.addTool({
+            name: 'lark_set_managers',
+            description: '设置飞书群管理员',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    chat_id: { type: 'string', description: '群聊 ID' },
+                    user_ids: { type: 'array', items: { type: 'string' }, description: '用户 open_id 列表' },
+                },
+                required: ['bot', 'chat_id', 'user_ids'],
+            },
+            platforms: ['lark'],
+            scopes: ['group'],
+            permissionLevel: 'group_owner',
+            execute: async (args) => {
+                const { bot: botId, chat_id, user_ids } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.setChatManagers(chat_id, user_ids);
+                return { success, message: success ? '管理员设置成功' : '设置失败' };
+            },
+        });
+        // 移除群管理员工具
+        this.addTool({
+            name: 'lark_remove_managers',
+            description: '移除飞书群管理员',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    chat_id: { type: 'string', description: '群聊 ID' },
+                    user_ids: { type: 'array', items: { type: 'string' }, description: '用户 open_id 列表' },
+                },
+                required: ['bot', 'chat_id', 'user_ids'],
+            },
+            platforms: ['lark'],
+            scopes: ['group'],
+            permissionLevel: 'group_owner',
+            execute: async (args) => {
+                const { bot: botId, chat_id, user_ids } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.removeChatManagers(chat_id, user_ids);
+                return { success, message: success ? '管理员移除成功' : '移除失败' };
+            },
+        });
+        // 解散群聊工具
+        this.addTool({
+            name: 'lark_dissolve_chat',
+            description: '解散飞书群聊（需要群主权限）',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    chat_id: { type: 'string', description: '群聊 ID' },
+                },
+                required: ['bot', 'chat_id'],
+            },
+            platforms: ['lark'],
+            scopes: ['group'],
+            permissionLevel: 'group_owner',
+            execute: async (args) => {
+                const { bot: botId, chat_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const success = await bot.dissolveChat(chat_id);
+                return { success, message: success ? '群聊已解散' : '解散失败' };
+            },
+        });
+        // 文件上传
+        this.addTool({
+            name: 'lark_upload_file',
+            description: '上传文件到飞书（图片/文件/视频/音频）',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    file_path: { type: 'string', description: '本地文件路径' },
+                    file_type: { type: 'string', description: '文件类型：image/file/video/audio', enum: ['image', 'file', 'video', 'audio'] },
+                },
+                required: ['bot', 'file_path', 'file_type'],
+            },
+            platforms: ['lark'],
+            scopes: ['group', 'private'],
+            permissionLevel: 'user',
+            execute: async (args) => {
+                const { bot: botId, file_path, file_type } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const result = await bot.uploadFile(file_path, file_type);
+                return { success: true, file_key: result, message: `文件已上传，file_key: ${result}` };
+            },
+        });
+        this.plugin.logger.debug('已注册飞书平台群组管理工具');
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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

package/lib/bot.d.ts

@@ -0,0 +1,82 @@
+import { Bot, Message, SendOptions } from "zhin.js";
+import type { LarkBotConfig, LarkMessage } from "./types.js";
+import type { LarkAdapter } from "./adapter.js";
+export declare class LarkBot implements Bot<LarkBotConfig, LarkMessage> {
+    adapter: LarkAdapter;
+    $config: LarkBotConfig;
+    $connected: boolean;
+    private router;
+    private accessToken;
+    private axiosInstance;
+    get logger(): import("zhin.js").Logger;
+    get $id(): string;
+    constructor(adapter: LarkAdapter, router: any, $config: LarkBotConfig);
+    private setupWebhookRoute;
+    private handleWebhook;
+    private verifySignature;
+    private handleEvent;
+    private ensureAccessToken;
+    private refreshAccessToken;
+    $formatMessage(msg: LarkMessage, event?: any): Message<LarkMessage>;
+    private parseMessageContent;
+    private parseRichTextContent;
+    $sendMessage(options: SendOptions): Promise<string>;
+    $recallMessage(id: string): Promise<void>;
+    private formatSendContent;
+    $connect(): Promise<void>;
+    $disconnect(): Promise<void>;
+    getUserInfo(userId: string, userIdType?: 'open_id' | 'user_id' | 'union_id'): Promise<any>;
+    getChatInfo(chatId: string): Promise<any>;
+    uploadFile(filePath: string, fileType?: 'image' | 'file' | 'video' | 'audio'): Promise<string | null>;
+    /**
+     * 创建群聊
+     * @param name 群名
+     * @param userIds 成员 open_id 列表
+     * @param ownerId 群主 open_id
+     */
+    createChat(name: string, userIds: string[], ownerId?: string): Promise<string | null>;
+    /**
+     * 更新群信息
+     * @param chatId 群聊 ID
+     * @param options 更新选项
+     */
+    updateChatInfo(chatId: string, options: {
+        name?: string;
+        description?: string;
+    }): Promise<boolean>;
+    /**
+     * 添加群成员
+     * @param chatId 群聊 ID
+     * @param userIds 用户 ID 列表
+     */
+    addChatMembers(chatId: string, userIds: string[]): Promise<boolean>;
+    /**
+     * 移除群成员
+     * @param chatId 群聊 ID
+     * @param userIds 用户 ID 列表
+     */
+    removeChatMembers(chatId: string, userIds: string[]): Promise<boolean>;
+    /**
+     * 获取群成员列表
+     * @param chatId 群聊 ID
+     */
+    getChatMembers(chatId: string): Promise<any[]>;
+    /**
+     * 解散群聊
+     * @param chatId 群聊 ID
+     */
+    dissolveChat(chatId: string): Promise<boolean>;
+    /**
+     * 设置群管理员
+     * @param chatId 群聊 ID
+     * @param userIds 用户 ID 列表
+     */
+    setChatManagers(chatId: string, userIds: string[]): Promise<boolean>;
+    /**
+     * 移除群管理员
+     * @param chatId 群聊 ID
+     * @param userIds 用户 ID 列表
+     */
+    removeChatManagers(chatId: string, userIds: string[]): Promise<boolean>;
+}
+//# sourceMappingURL=bot.d.ts.map

package/lib/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,GAAG,EACH,OAAO,EACP,WAAW,EAIZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAA0B,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,qBAAa,OAAQ,YAAW,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC;IAcxC,OAAO,EAAE,WAAW;IAAsB,OAAO,EAAE,aAAa;IAbnF,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAe;IAEpC,IAAI,MAAM,6BAEX;IAED,IAAI,GAAG,WAEJ;gBAEkB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAS,OAAO,EAAE,aAAa;IA+BnF,OAAO,CAAC,iBAAiB;YAMX,aAAa;IAsD3B,OAAO,CAAC,eAAe;YAaT,WAAW;YAaX,iBAAiB;YAUjB,kBAAkB;IAiChC,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;IAoCnE,OAAO,CAAC,mBAAmB;IA0F3B,OAAO,CAAC,oBAAoB;IAyBtB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBnD,cAAc,CAAC,EAAE,EAAC,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC;IAM7C,OAAO,CAAC,iBAAiB;IAsFnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAezB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,GAAG,SAAS,GAAG,UAAsB,GAAG,OAAO,CAAC,GAAG,CAAC;IAcrG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAWzC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BnH;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB3F;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC;IAepB;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBzE;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5E;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcpD;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAepD;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1E;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAgBhF"}