@onebots/adapter-feishu 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# @onebots/adapter-feishu
+
+onebots 飞书/Lark 适配器，同时支持飞书（国内版）和 Lark（国际版）。
+
+## 安装
+
+```bash
+npm install @onebots/adapter-feishu
+# 或
+pnpm add @onebots/adapter-feishu
+```
+
+## 配置
+
+在 `config.yaml` 中配置：
+
+```yaml
+# 飞书（国内版）- 默认
+feishu.feishu_bot:
+  app_id: "YOUR_APP_ID"
+  app_secret: "YOUR_APP_SECRET"
+  encrypt_key: "YOUR_ENCRYPT_KEY"  # 可选，事件加密密钥
+  verification_token: "YOUR_VERIFICATION_TOKEN"  # 可选，事件验证 Token
+
+# Lark（国际版）
+feishu.lark_bot:
+  app_id: "YOUR_APP_ID"
+  app_secret: "YOUR_APP_SECRET"
+  endpoint: "https://open.larksuite.com/open-apis"  # Lark 端点
+```
+
+### 端点配置
+
+| 端点 | URL | 说明 |
+|------|-----|------|
+| 飞书（默认） | `https://open.feishu.cn/open-apis` | 国内版 |
+| Lark | `https://open.larksuite.com/open-apis` | 国际版 |
+
+### TypeScript 配置（推荐）
+
+```typescript
+import { FeishuEndpoint } from '@onebots/adapter-feishu';
+
+// 飞书（国内版）
+{
+  account_id: 'feishu_bot',
+  app_id: 'cli_xxx',
+  app_secret: 'xxx',
+  // endpoint 可省略，默认为 FeishuEndpoint.FEISHU
+}
+
+// Lark（国际版）
+{
+  account_id: 'lark_bot',
+  app_id: 'cli_xxx',
+  app_secret: 'xxx',
+  endpoint: FeishuEndpoint.LARK,
+}
+
+// 私有化部署
+{
+  account_id: 'private_bot',
+  app_id: 'cli_xxx',
+  app_secret: 'xxx',
+  endpoint: 'https://your-private-feishu.com/open-apis',
+}
+```
+
+## 使用
+
+```bash
+onebots -r feishu
+```
+
+## 功能
+
+- ✅ 单聊消息收发
+- ✅ 群聊消息收发
+- ✅ 文本消息
+- ✅ 富文本消息（部分支持）
+- ✅ 消息编辑和删除
+- ✅ 群组管理（获取信息、踢出成员等）
+- ✅ 事件订阅（Webhook）
+- ✅ 支持飞书和 Lark 双端点
+
+## 获取应用凭证
+
+### 飞书（国内版）
+1. 访问 [飞书开放平台](https://open.feishu.cn/)
+2. 创建企业自建应用
+3. 获取 `App ID` 和 `App Secret`
+4. 配置事件订阅 URL（Webhook）
+5. 配置应用权限（消息收发、通讯录等）
+
+### Lark（国际版）
+1. 访问 [Lark Developer](https://open.larksuite.com/)
+2. 创建应用并获取凭证
+3. 配置方式与飞书相同，只需设置 `endpoint` 为 Lark 端点
+
+## 相关链接
+
+- [飞书开放平台](https://open.feishu.cn/)
+- [Lark Developer](https://open.larksuite.com/)
+- [飞书 Bot 开发文档](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)
+- [onebots 文档](https://onebots.pages.dev/)
+

package/lib/adapter.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 飞书适配器
+ * 继承 Adapter 基类，实现飞书平台功能
+ */
+import { Account } from "onebots";
+import { Adapter } from "onebots";
+import { BaseApp } from "onebots";
+import { FeishuBot } from "./bot.js";
+import { type FeishuConfig } from "./types.js";
+export declare class FeishuAdapter extends Adapter<FeishuBot, "feishu"> {
+    constructor(app: BaseApp);
+    /**
+     * 根据端点获取对应的图标
+     */
+    private getIconForEndpoint;
+    /**
+     * 判断是否为 Lark（国际版）
+     */
+    private isLarkEndpoint;
+    /**
+     * 发送消息
+     */
+    sendMessage(uin: string, params: Adapter.SendMessageParams): Promise<Adapter.SendMessageResult>;
+    /**
+     * 删除/撤回消息
+     */
+    deleteMessage(uin: string, params: Adapter.DeleteMessageParams): Promise<void>;
+    /**
+     * 获取消息
+     */
+    getMessage(uin: string, params: Adapter.GetMessageParams): Promise<Adapter.MessageInfo>;
+    /**
+     * 更新消息
+     */
+    updateMessage(uin: string, params: Adapter.UpdateMessageParams): Promise<void>;
+    /**
+     * 获取机器人自身信息
+     */
+    getLoginInfo(uin: string): Promise<Adapter.UserInfo>;
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(uin: string, params: Adapter.GetUserInfoParams): Promise<Adapter.UserInfo>;
+    /**
+     * 获取好友列表（飞书不支持）
+     */
+    getFriendList(uin: string, params?: Adapter.GetFriendListParams): Promise<Adapter.FriendInfo[]>;
+    /**
+     * 获取好友信息
+     */
+    getFriendInfo(uin: string, params: Adapter.GetFriendInfoParams): Promise<Adapter.FriendInfo>;
+    /**
+     * 获取群列表（飞书不支持）
+     */
+    getGroupList(uin: string, params?: Adapter.GetGroupListParams): Promise<Adapter.GroupInfo[]>;
+    /**
+     * 获取群信息
+     */
+    getGroupInfo(uin: string, params: Adapter.GetGroupInfoParams): Promise<Adapter.GroupInfo>;
+    /**
+     * 退出群组
+     */
+    leaveGroup(uin: string, params: Adapter.LeaveGroupParams): Promise<void>;
+    /**
+     * 获取群成员列表
+     */
+    getGroupMemberList(uin: string, params: Adapter.GetGroupMemberListParams): Promise<Adapter.GroupMemberInfo[]>;
+    /**
+     * 获取群成员信息
+     */
+    getGroupMemberInfo(uin: string, params: Adapter.GetGroupMemberInfoParams): Promise<Adapter.GroupMemberInfo>;
+    /**
+     * 踢出群成员
+     */
+    kickGroupMember(uin: string, params: Adapter.KickGroupMemberParams): Promise<void>;
+    /**
+     * 设置群名片（飞书不支持）
+     */
+    setGroupCard(uin: string, params: Adapter.SetGroupCardParams): Promise<void>;
+    /**
+     * 获取版本信息
+     */
+    getVersion(uin: string): Promise<Adapter.VersionInfo>;
+    /**
+     * 获取运行状态
+     */
+    getStatus(uin: string): Promise<Adapter.StatusInfo>;
+    createAccount(config: Account.Config<'feishu'>): Account<'feishu', FeishuBot>;
+    /**
+     * 处理飞书事件
+     */
+    private handleFeishuEvent;
+}
+declare module "onebots" {
+    namespace Adapter {
+        interface Configs {
+            feishu: FeishuConfig;
+        }
+    }
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.js

@@ -0,0 +1,454 @@
+/**
+ * 飞书适配器
+ * 继承 Adapter 基类，实现飞书平台功能
+ */
+import { Account, AdapterRegistry, AccountStatus } from "onebots";
+import { Adapter } from "onebots";
+import { FeishuBot } from "./bot.js";
+export class FeishuAdapter extends Adapter {
+    constructor(app) {
+        super(app, "feishu");
+        this.icon = "https://open.feishu.cn/favicon.ico";
+    }
+    /**
+     * 根据端点获取对应的图标
+     */
+    getIconForEndpoint(endpoint) {
+        if (endpoint.includes('larksuite.com')) {
+            return 'https://open.larksuite.com/favicon.ico';
+        }
+        return 'https://open.feishu.cn/favicon.ico';
+    }
+    /**
+     * 判断是否为 Lark（国际版）
+     */
+    isLarkEndpoint(endpoint) {
+        return endpoint.includes('larksuite.com');
+    }
+    // ============================================
+    // 消息相关方法
+    // ============================================
+    /**
+     * 发送消息
+     */
+    async sendMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const { scene_id, scene_type, message } = params;
+        // 解析消息内容
+        let text = '';
+        const content = {};
+        for (const seg of message) {
+            if (typeof seg === 'string') {
+                text += seg;
+            }
+            else if (seg.type === 'text') {
+                text += seg.data.text || '';
+            }
+            else if (seg.type === 'at') {
+                const userId = seg.data.qq || seg.data.id || seg.data.user_id;
+                if (userId === 'all') {
+                    text += '<at user_id="all">所有人</at>';
+                }
+                else {
+                    text += `<at user_id="${userId}">${seg.data.name || userId}</at>`;
+                }
+            }
+            else if (seg.type === 'image') {
+                // 飞书图片消息需要先上传图片，这里简化处理
+                if (seg.data.url || seg.data.file) {
+                    text += `[图片: ${seg.data.url || seg.data.file}]`;
+                }
+            }
+        }
+        // 构建飞书消息内容
+        content.text = text;
+        // 根据场景类型发送消息
+        let receiveIdType = 'open_id';
+        if (scene_type === 'private' || scene_type === 'direct') {
+            receiveIdType = 'open_id';
+        }
+        else if (scene_type === 'group' || scene_type === 'channel') {
+            receiveIdType = 'chat_id';
+        }
+        const result = await bot.sendMessage(scene_id.string, receiveIdType, content, 'text');
+        return {
+            message_id: this.createId(result.data.message_id),
+        };
+    }
+    /**
+     * 删除/撤回消息
+     */
+    async deleteMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const msgId = params.message_id.string;
+        const chatId = params.scene_id?.string || '';
+        // 飞书删除消息 API
+        const http = bot.getHttpClient();
+        await http.delete(`/im/v1/messages/${msgId}`);
+    }
+    /**
+     * 获取消息
+     */
+    async getMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const msgId = params.message_id.string;
+        // 飞书获取消息 API
+        const http = bot.getHttpClient();
+        const response = await http.get(`/im/v1/messages/${msgId}`);
+        if (response.data.code !== 0) {
+            throw new Error(`获取消息失败: ${response.data.msg}`);
+        }
+        const msg = response.data.data.items[0];
+        return {
+            message_id: this.createId(msg.message_id),
+            time: parseInt(msg.create_time),
+            sender: {
+                scene_type: msg.chat_id ? 'group' : 'private',
+                sender_id: this.createId(msg.sender.id),
+                scene_id: this.createId(msg.chat_id || msg.sender.id),
+                sender_name: msg.sender.id,
+                scene_name: '',
+            },
+            message: [{
+                    type: 'text',
+                    data: { text: JSON.parse(msg.body.content).text || '' },
+                }],
+        };
+    }
+    /**
+     * 更新消息
+     */
+    async updateMessage(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const msgId = params.message_id.string;
+        // 解析消息内容
+        let text = '';
+        for (const seg of params.message) {
+            if (typeof seg === 'string') {
+                text += seg;
+            }
+            else if (seg.type === 'text') {
+                text += seg.data.text || '';
+            }
+        }
+        // 飞书更新消息 API
+        const http = bot.getHttpClient();
+        await http.put(`/im/v1/messages/${msgId}`, {
+            content: JSON.stringify({ text }),
+        });
+    }
+    // ============================================
+    // 用户相关方法
+    // ============================================
+    /**
+     * 获取机器人自身信息
+     */
+    async getLoginInfo(uin) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const me = bot.getCachedMe();
+        return {
+            user_id: this.createId(me?.user_id || me?.open_id || ''),
+            user_name: me?.name || '',
+            user_displayname: me?.nickname || me?.name || '',
+            avatar: me?.avatar_url || me?.avatar_big,
+        };
+    }
+    /**
+     * 获取用户信息
+     */
+    async getUserInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const userId = params.user_id.string;
+        const user = await bot.getUserInfo(userId);
+        return {
+            user_id: this.createId(user.user_id || user.open_id),
+            user_name: user.name || '',
+            user_displayname: user.nickname || user.name || '',
+            avatar: user.avatar_url || user.avatar_big,
+        };
+    }
+    // ============================================
+    // 好友（私聊会话）相关方法
+    // ============================================
+    /**
+     * 获取好友列表（飞书不支持）
+     */
+    async getFriendList(uin, params) {
+        // 飞书不提供好友列表 API
+        return [];
+    }
+    /**
+     * 获取好友信息
+     */
+    async getFriendInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const userId = params.user_id.string;
+        const user = await bot.getUserInfo(userId);
+        return {
+            user_id: this.createId(user.user_id || user.open_id),
+            user_name: user.name || '',
+            remark: user.nickname || user.name || '',
+        };
+    }
+    // ============================================
+    // 群组相关方法
+    // ============================================
+    /**
+     * 获取群列表（飞书不支持）
+     */
+    async getGroupList(uin, params) {
+        // 飞书不提供群列表 API，需要通过事件订阅获取
+        return [];
+    }
+    /**
+     * 获取群信息
+     */
+    async getGroupInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const chatId = params.group_id.string;
+        const chat = await bot.getChatInfo(chatId);
+        return {
+            group_id: this.createId(chat.chat_id),
+            group_name: chat.name || '',
+        };
+    }
+    /**
+     * 退出群组
+     */
+    async leaveGroup(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const chatId = params.group_id.string;
+        // 飞书退出群组 API
+        const http = bot.getHttpClient();
+        await http.delete(`/im/v1/chats/${chatId}/members/me`);
+    }
+    /**
+     * 获取群成员列表
+     */
+    async getGroupMemberList(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const chatId = params.group_id.string;
+        const members = await bot.getChatMembers(chatId);
+        return members.map((user) => ({
+            group_id: params.group_id,
+            user_id: this.createId(user.user_id || user.open_id),
+            user_name: user.name || '',
+            card: user.nickname || user.name || '',
+            role: 'member',
+        }));
+    }
+    /**
+     * 获取群成员信息
+     */
+    async getGroupMemberInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const userId = params.user_id.string;
+        const user = await bot.getUserInfo(userId);
+        return {
+            group_id: params.group_id,
+            user_id: this.createId(user.user_id || user.open_id),
+            user_name: user.name || '',
+            card: user.nickname || user.name || '',
+            role: 'member',
+        };
+    }
+    /**
+     * 踢出群成员
+     */
+    async kickGroupMember(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const chatId = params.group_id.string;
+        const userId = params.user_id.string;
+        // 飞书踢出群成员 API
+        const http = bot.getHttpClient();
+        await http.delete(`/im/v1/chats/${chatId}/members/${userId}`);
+    }
+    /**
+     * 设置群名片（飞书不支持）
+     */
+    async setGroupCard(uin, params) {
+        // 飞书不支持设置群名片
+        throw new Error('飞书不支持设置群名片');
+    }
+    // ============================================
+    // 系统相关方法
+    // ============================================
+    /**
+     * 获取版本信息
+     */
+    async getVersion(uin) {
+        const account = this.getAccount(uin);
+        const isLark = account ? this.isLarkEndpoint(account.client.endpoint) : false;
+        const platformName = isLark ? 'Lark' : '飞书';
+        return {
+            app_name: `onebots ${platformName} Adapter`,
+            app_version: '1.0.0',
+            impl: 'feishu',
+            version: '1.0.0',
+        };
+    }
+    /**
+     * 获取运行状态
+     */
+    async getStatus(uin) {
+        const account = this.getAccount(uin);
+        return {
+            online: account?.status === AccountStatus.Online,
+            good: account?.status === AccountStatus.Online,
+        };
+    }
+    // ============================================
+    // 账号创建
+    // ============================================
+    createAccount(config) {
+        const feishuConfig = {
+            account_id: config.account_id,
+            app_id: config.app_id,
+            app_secret: config.app_secret,
+            encrypt_key: config.encrypt_key,
+            verification_token: config.verification_token,
+            endpoint: config.endpoint,
+        };
+        const bot = new FeishuBot(feishuConfig);
+        const account = new Account(this, bot, config);
+        // 根据端点判断是飞书还是 Lark
+        const isLark = this.isLarkEndpoint(bot.endpoint);
+        const platformName = isLark ? 'Lark' : '飞书';
+        const accountIcon = this.getIconForEndpoint(bot.endpoint);
+        // Webhook 路由
+        this.app.router.post(`${account.path}/webhook`, bot.handleWebhook.bind(bot));
+        // 监听 Bot 事件
+        bot.on('ready', () => {
+            this.logger.info(`${platformName} Bot ${config.account_id} 已就绪 (endpoint: ${bot.endpoint})`);
+        });
+        bot.on('error', (error) => {
+            this.logger.error(`${platformName} Bot ${config.account_id} 错误:`, error);
+        });
+        // 监听飞书事件
+        bot.on('event', (event) => {
+            this.handleFeishuEvent(account, event);
+        });
+        // 启动时初始化 Bot
+        account.on('start', async () => {
+            try {
+                await bot.start();
+                account.status = AccountStatus.Online;
+                const me = bot.getCachedMe();
+                account.nickname = me?.name || `${platformName} Bot`;
+                account.avatar = me?.avatar_url || accountIcon;
+            }
+            catch (error) {
+                this.logger.error(`启动 ${platformName} Bot 失败:`, error);
+                account.status = AccountStatus.OffLine;
+            }
+        });
+        account.on('stop', async () => {
+            await bot.stop();
+            account.status = AccountStatus.OffLine;
+        });
+        return account;
+    }
+    /**
+     * 处理飞书事件
+     */
+    handleFeishuEvent(account, event) {
+        const eventType = event.header.event_type;
+        // 处理消息事件
+        if (eventType === 'im.message.receive_v1') {
+            const message = event.event.message;
+            if (!message)
+                return;
+            // 忽略自己发送的消息
+            const bot = account.client;
+            const me = bot.getCachedMe();
+            if (me && message.sender.id === me.open_id)
+                return;
+            // 打印消息接收日志
+            const content = JSON.parse(message.body.content || '{}').text || '';
+            const contentPreview = content.length > 100 ? content.substring(0, 100) + '...' : content;
+            this.logger.info(`[飞书] 收到消息 | 消息ID: ${message.message_id} | ` +
+                `发送者: ${message.sender.id} | 内容: ${contentPreview}`);
+            // 构建消息段
+            const messageSegments = [];
+            if (content) {
+                messageSegments.push({
+                    type: 'text',
+                    data: { text: content },
+                });
+            }
+            // 判断是私聊还是群聊
+            const isGroup = message.chat_id && message.chat_id !== message.sender.id;
+            const messageType = isGroup ? 'group' : 'private';
+            // 转换为 CommonEvent 格式
+            const commonEvent = {
+                id: this.createId(message.message_id),
+                timestamp: parseInt(message.create_time) * 1000,
+                platform: 'feishu',
+                bot_id: this.createId(account.config.account_id),
+                type: 'message',
+                message_type: messageType,
+                sender: {
+                    id: this.createId(message.sender.id),
+                    name: message.sender.id,
+                    avatar: undefined,
+                },
+                ...(isGroup ? {
+                    group: {
+                        id: this.createId(message.chat_id),
+                        name: '',
+                    },
+                } : {}),
+                message_id: this.createId(message.message_id),
+                raw_message: content,
+                message: messageSegments,
+            };
+            // 派发到协议层
+            account.dispatch(commonEvent);
+        }
+    }
+}
+AdapterRegistry.register('feishu', FeishuAdapter, {
+    name: 'feishu',
+    displayName: '飞书官方机器人',
+    description: '飞书官方机器人适配器，支持单聊、群聊和富文本消息',
+    icon: 'https://open.feishu.cn/favicon.ico',
+    homepage: 'https://open.feishu.cn/',
+    author: '凉菜',
+});
+//# sourceMappingURL=adapter.js.map

package/lib/bot.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 飞书 Bot 客户端
+ * 基于飞书开放平台 API，使用 fetch 实现
+ */
+import { EventEmitter } from 'events';
+import type { RouterContext, Next } from 'onebots';
+import { type FeishuConfig, type FeishuSendMessageResponse, type FeishuUser, type FeishuChat } from './types.js';
+export declare class FeishuBot extends EventEmitter {
+    private config;
+    private tenantAccessToken;
+    private tokenExpireTime;
+    private me;
+    /** 当前使用的 API 端点 */
+    readonly endpoint: string;
+    constructor(config: FeishuConfig);
+    /**
+     * 发送 HTTP 请求
+     */
+    private request;
+    /**
+     * GET 请求
+     */
+    get<T = any>(path: string, params?: Record<string, string | number | boolean>): Promise<{
+        data: T;
+    }>;
+    /**
+     * POST 请求
+     */
+    post<T = any>(path: string, body?: any, params?: Record<string, string | number | boolean>): Promise<{
+        data: T;
+    }>;
+    /**
+     * PUT 请求
+     */
+    put<T = any>(path: string, body?: any): Promise<{
+        data: T;
+    }>;
+    /**
+     * DELETE 请求
+     */
+    delete<T = any>(path: string): Promise<{
+        data: T;
+    }>;
+    /**
+     * 获取租户访问令牌
+     */
+    getTenantAccessToken(): Promise<string>;
+    /**
+     * 启动 Bot
+     */
+    start(): Promise<void>;
+    /**
+     * 停止 Bot
+     */
+    stop(): Promise<void>;
+    /**
+     * 处理 Webhook 请求
+     */
+    handleWebhook(ctx: RouterContext, next: Next): Promise<void>;
+    /**
+     * 获取缓存的 Bot 信息
+     */
+    getCachedMe(): FeishuUser | null;
+    /**
+     * 获取 Bot 信息
+     */
+    getBotInfo(): Promise<FeishuUser>;
+    /**
+     * 发送消息
+     */
+    sendMessage(receiveId: string, receiveIdType: 'open_id' | 'user_id' | 'union_id' | 'email' | 'chat_id', content: string | any, msgType?: string): Promise<FeishuSendMessageResponse>;
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(userId: string, userIdType?: 'open_id' | 'user_id' | 'union_id'): Promise<FeishuUser>;
+    /**
+     * 获取群组信息
+     */
+    getChatInfo(chatId: string): Promise<FeishuChat>;
+    /**
+     * 获取群组成员列表
+     */
+    getChatMembers(chatId: string): Promise<FeishuUser[]>;
+    /**
+     * 获取 HTTP 客户端实例（返回 this 以便链式调用）
+     */
+    getHttpClient(): FeishuBot;
+}
+//# sourceMappingURL=bot.d.ts.map

package/lib/bot.js

@@ -0,0 +1,224 @@
+/**
+ * 飞书 Bot 客户端
+ * 基于飞书开放平台 API，使用 fetch 实现
+ */
+import { EventEmitter } from 'events';
+import { FeishuEndpoint } from './types.js';
+export class FeishuBot extends EventEmitter {
+    config;
+    tenantAccessToken = '';
+    tokenExpireTime = 0;
+    me = null;
+    /** 当前使用的 API 端点 */
+    endpoint;
+    constructor(config) {
+        super();
+        this.config = config;
+        // 使用配置的端点，默认为飞书（国内版）
+        this.endpoint = config.endpoint || FeishuEndpoint.FEISHU;
+    }
+    /**
+     * 发送 HTTP 请求
+     */
+    async request(path, options = {}) {
+        const { method = 'GET', headers = {}, body, params, skipAuth = false } = options;
+        // 构建 URL
+        let url = `${this.endpoint}${path}`;
+        if (params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(params)) {
+                searchParams.append(key, String(value));
+            }
+            url += `?${searchParams.toString()}`;
+        }
+        // 构建请求头
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            ...headers,
+        };
+        // 添加认证 token（除了获取 token 的请求）
+        if (!skipAuth) {
+            const token = await this.getTenantAccessToken();
+            requestHeaders['Authorization'] = `Bearer ${token}`;
+        }
+        // 发送请求
+        const response = await fetch(url, {
+            method,
+            headers: requestHeaders,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        return response.json();
+    }
+    /**
+     * GET 请求
+     */
+    async get(path, params) {
+        const data = await this.request(path, { params });
+        return { data };
+    }
+    /**
+     * POST 请求
+     */
+    async post(path, body, params) {
+        const data = await this.request(path, { method: 'POST', body, params });
+        return { data };
+    }
+    /**
+     * PUT 请求
+     */
+    async put(path, body) {
+        const data = await this.request(path, { method: 'PUT', body });
+        return { data };
+    }
+    /**
+     * DELETE 请求
+     */
+    async delete(path) {
+        const data = await this.request(path, { method: 'DELETE' });
+        return { data };
+    }
+    /**
+     * 获取租户访问令牌
+     */
+    async getTenantAccessToken() {
+        if (this.tenantAccessToken && Date.now() < this.tokenExpireTime) {
+            return this.tenantAccessToken;
+        }
+        const data = await this.request('/auth/v3/tenant_access_token/internal', {
+            method: 'POST',
+            body: {
+                app_id: this.config.app_id,
+                app_secret: this.config.app_secret,
+            },
+            skipAuth: true,
+        });
+        if (data.code !== 0) {
+            throw new Error(`获取租户访问令牌失败: ${data.msg}`);
+        }
+        this.tenantAccessToken = data.tenant_access_token || '';
+        this.tokenExpireTime = Date.now() + (data.expire - 60) * 1000; // 提前60秒刷新
+        return this.tenantAccessToken;
+    }
+    /**
+     * 启动 Bot
+     */
+    async start() {
+        try {
+            // 获取访问令牌
+            await this.getTenantAccessToken();
+            // 获取 Bot 信息
+            this.me = await this.getBotInfo();
+            this.emit('ready');
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw error;
+        }
+    }
+    /**
+     * 停止 Bot
+     */
+    async stop() {
+        this.emit('stopped');
+    }
+    /**
+     * 处理 Webhook 请求
+     */
+    async handleWebhook(ctx, next) {
+        const body = ctx.request.body;
+        // 验证事件（如果配置了 verification_token）
+        if (this.config.verification_token && body.header?.token !== this.config.verification_token) {
+            ctx.status = 401;
+            ctx.body = { error: 'Invalid token' };
+            return;
+        }
+        // 处理 URL 验证（飞书首次配置 webhook 时会发送验证请求）
+        if (body.type === 'url_verification') {
+            ctx.body = { challenge: body.challenge };
+            return;
+        }
+        // 处理事件
+        const event = body;
+        this.emit('event', event);
+        ctx.body = { code: 0 };
+        await next();
+    }
+    /**
+     * 获取缓存的 Bot 信息
+     */
+    getCachedMe() {
+        return this.me;
+    }
+    /**
+     * 获取 Bot 信息
+     */
+    async getBotInfo() {
+        const response = await this.get('/im/v1/bots', { page_size: 1 });
+        if (response.data.code !== 0) {
+            throw new Error(`获取 Bot 信息失败: ${response.data.msg}`);
+        }
+        // 飞书没有直接的 getBotInfo API，这里返回一个占位信息
+        return {
+            user_id: this.config.app_id,
+            open_id: this.config.app_id,
+            name: 'Feishu Bot',
+        };
+    }
+    /**
+     * 发送消息
+     */
+    async sendMessage(receiveId, receiveIdType, content, msgType = 'text') {
+        const request = {
+            receive_id: receiveId,
+            receive_id_type: receiveIdType,
+            msg_type: msgType,
+            content: typeof content === 'string' ? JSON.stringify({ text: content }) : JSON.stringify(content),
+        };
+        const response = await this.post('/im/v1/messages', request, {
+            receive_id_type: receiveIdType,
+        });
+        if (response.data.code !== 0) {
+            throw new Error(`发送消息失败: ${response.data.msg}`);
+        }
+        return response.data;
+    }
+    /**
+     * 获取用户信息
+     */
+    async getUserInfo(userId, userIdType = 'open_id') {
+        const response = await this.get(`/contact/v3/users/${userId}`, {
+            user_id_type: userIdType,
+        });
+        if (response.data.code !== 0) {
+            throw new Error(`获取用户信息失败: ${response.data.msg}`);
+        }
+        return response.data.data.user;
+    }
+    /**
+     * 获取群组信息
+     */
+    async getChatInfo(chatId) {
+        const response = await this.get(`/im/v1/chats/${chatId}`);
+        if (response.data.code !== 0) {
+            throw new Error(`获取群组信息失败: ${response.data.msg}`);
+        }
+        return response.data.data;
+    }
+    /**
+     * 获取群组成员列表
+     */
+    async getChatMembers(chatId) {
+        const response = await this.get(`/im/v1/chats/${chatId}/members`);
+        if (response.data.code !== 0) {
+            throw new Error(`获取群组成员列表失败: ${response.data.msg}`);
+        }
+        return response.data.data.items || [];
+    }
+    /**
+     * 获取 HTTP 客户端实例（返回 this 以便链式调用）
+     */
+    getHttpClient() {
+        return this;
+    }
+}
+//# sourceMappingURL=bot.js.map

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { FeishuEndpoint, type FeishuConfig, type FeishuEndpointType } from './types.js';
+export * from './adapter.js';
+export * from './bot.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -0,0 +1,5 @@
+// 导出类型和常量
+export { FeishuEndpoint } from './types.js';
+export * from './adapter.js';
+export * from './bot.js';
+//# sourceMappingURL=index.js.map

package/lib/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 飞书开放平台 API 类型定义
+ * 基于飞书开放平台官方 API
+ */
+/**
+ * API 端点常量
+ * - FEISHU: 飞书（国内版）
+ * - LARK: Lark（国际版）
+ */
+export declare const FeishuEndpoint: {
+    /** 飞书（国内版）API 端点 */
+    readonly FEISHU: "https://open.feishu.cn/open-apis";
+    /** Lark（国际版）API 端点 */
+    readonly LARK: "https://open.larksuite.com/open-apis";
+};
+export type FeishuEndpointType = typeof FeishuEndpoint[keyof typeof FeishuEndpoint];
+export interface FeishuConfig {
+    account_id: string;
+    app_id: string;
+    app_secret: string;
+    encrypt_key?: string;
+    verification_token?: string;
+    /**
+     * API 端点，可选值：
+     * - FeishuEndpoint.FEISHU (默认): 'https://open.feishu.cn/open-apis'
+     * - FeishuEndpoint.LARK: 'https://open.larksuite.com/open-apis'
+     * - 或自定义端点 URL
+     */
+    endpoint?: string;
+}
+export interface FeishuUser {
+    user_id: string;
+    union_id?: string;
+    open_id: string;
+    name: string;
+    en_name?: string;
+    nickname?: string;
+    email?: string;
+    avatar_url?: string;
+    avatar_thumb?: string;
+    avatar_middle?: string;
+    avatar_big?: string;
+    status?: number;
+}
+export interface FeishuChat {
+    chat_id: string;
+    name?: string;
+    description?: string;
+    avatar?: string;
+    owner_id?: string;
+    owner_id_type?: string;
+    external?: boolean;
+    tenant_key?: string;
+}
+export interface FeishuMessage {
+    message_id: string;
+    root_id?: string;
+    parent_id?: string;
+    msg_type: string;
+    create_time: string;
+    update_time?: string;
+    deleted?: boolean;
+    updated?: boolean;
+    chat_id: string;
+    sender: {
+        id: string;
+        id_type: string;
+        sender_type: string;
+        tenant_key?: string;
+    };
+    body: {
+        content: string;
+    };
+    mentions?: Array<{
+        key: string;
+        id: string;
+        id_type: string;
+        name: string;
+        tenant_key?: string;
+    }>;
+}
+export interface FeishuEvent {
+    schema: string;
+    header: {
+        event_id: string;
+        event_type: string;
+        create_time: string;
+        token?: string;
+        app_id: string;
+        tenant_key: string;
+    };
+    event: any;
+}
+export interface FeishuTokenResponse {
+    code: number;
+    msg: string;
+    tenant_access_token?: string;
+    app_access_token?: string;
+    expire: number;
+}
+export interface FeishuSendMessageRequest {
+    receive_id: string;
+    receive_id_type: 'open_id' | 'user_id' | 'union_id' | 'email' | 'chat_id';
+    msg_type: 'text' | 'post' | 'image' | 'file' | 'audio' | 'media' | 'sticker' | 'interactive' | 'share_chat' | 'share_user';
+    content: string | any;
+    uuid?: string;
+}
+export interface FeishuSendMessageResponse {
+    code: number;
+    msg: string;
+    data: {
+        message_id: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.js

@@ -0,0 +1,16 @@
+/**
+ * 飞书开放平台 API 类型定义
+ * 基于飞书开放平台官方 API
+ */
+/**
+ * API 端点常量
+ * - FEISHU: 飞书（国内版）
+ * - LARK: Lark（国际版）
+ */
+export const FeishuEndpoint = {
+    /** 飞书（国内版）API 端点 */
+    FEISHU: 'https://open.feishu.cn/open-apis',
+    /** Lark（国际版）API 端点 */
+    LARK: 'https://open.larksuite.com/open-apis',
+};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@onebots/adapter-feishu",
+  "version": "1.0.0",
+  "description": "onebots 飞书适配器",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "keywords": [
+    "onebots",
+    "feishu",
+    "lark",
+    "adapter"
+  ],
+  "author": "凉菜",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "/lib/**/*.js",
+    "/lib/**/*.d.ts"
+  ],
+  "devDependencies": {
+    "tsc-alias": "latest",
+    "typescript": "latest",
+    "@types/node": "^22.7.3"
+  },
+  "peerDependencies": {
+    "onebots": "1.0.0"
+  },
+  "dependencies": {},
+  "scripts": {
+    "build": "tsc --project tsconfig.json && tsc-alias -p tsconfig.json",
+    "clean": "rm -rf lib *.tsbuildinfo"
+  }
+}