@onebots/adapter-wecom 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,64 @@
+# @onebots/adapter-wecom
+
+onebots 企业微信适配器
+
+## 安装
+
+```bash
+npm install @onebots/adapter-wecom
+# 或
+pnpm add @onebots/adapter-wecom
+```
+
+## 配置
+
+在 `config.yaml` 中配置：
+
+```yaml
+wecom.your_bot_id:
+  corp_id: "YOUR_CORP_ID"
+  corp_secret: "YOUR_CORP_SECRET"
+  agent_id: "YOUR_AGENT_ID"
+  token: "YOUR_TOKEN"  # 可选，回调验证 Token
+  encoding_aes_key: "YOUR_ENCODING_AES_KEY"  # 可选，消息加解密密钥
+```
+
+## 使用
+
+```bash
+onebots -r wecom
+```
+
+## 功能
+
+- ✅ 应用消息推送
+  - 文本消息
+  - 图片消息
+  - 视频消息
+  - 文件消息
+  - 文本卡片
+  - Markdown 消息
+- ✅ 通讯录管理
+  - 获取用户信息
+  - 获取部门列表
+  - 获取部门成员列表
+- ✅ 事件订阅
+  - 通讯录变更事件
+  - 应用消息回调
+
+## 获取应用凭证
+
+1. 访问 [企业微信管理后台](https://work.weixin.qq.com/)
+2. 应用管理 → 创建应用
+3. 获取 `企业ID`（CorpID）
+4. 获取 `应用Secret`（CorpSecret）
+5. 获取 `应用ID`（AgentID）
+6. 配置回调 URL：`http://your-server:port/wecom/{account_id}/webhook`
+7. 获取 `Token` 和 `EncodingAESKey`（如果启用加密）
+
+## 相关链接
+
+- [企业微信开放平台](https://developer.work.weixin.qq.com/)
+- [企业微信应用开发文档](https://developer.work.weixin.qq.com/document/path/90488)
+- [onebots 文档](https://onebots.js.org/)
+

package/lib/adapter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 企业微信适配器
+ * 继承 Adapter 基类，实现企业微信平台功能
+ */
+import { Account } from "onebots";
+import { Adapter } from "onebots";
+import { BaseApp } from "onebots";
+import { WeComBot } from "./bot.js";
+import type { WeComConfig } from "./types.js";
+export declare class WeComAdapter extends Adapter<WeComBot, "wecom"> {
+    constructor(app: BaseApp);
+    /**
+     * 发送消息
+     */
+    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<'wecom'>): Account<'wecom', WeComBot>;
+    /**
+     * 处理企业微信事件
+     */
+    private handleWeComEvent;
+}
+declare module "onebots" {
+    namespace Adapter {
+        interface Configs {
+            wecom: WeComConfig;
+        }
+    }
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.js

@@ -0,0 +1,347 @@
+/**
+ * 企业微信适配器
+ * 继承 Adapter 基类，实现企业微信平台功能
+ */
+import { Account, AdapterRegistry, AccountStatus } from "onebots";
+import { Adapter } from "onebots";
+import { WeComBot } from "./bot.js";
+export class WeComAdapter extends Adapter {
+    constructor(app) {
+        super(app, "wecom");
+        this.icon = "https://work.weixin.qq.com/favicon.ico";
+    }
+    // ============================================
+    // 消息相关方法
+    // ============================================
+    /**
+     * 发送消息
+     */
+    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 request = {
+            msgtype: 'text',
+            agentid: parseInt(bot.getCachedMe()?.userid || bot['config'].agent_id),
+        };
+        // 根据场景类型设置接收者
+        if (scene_type === 'private' || scene_type === 'direct') {
+            request.touser = scene_id.string;
+        }
+        else if (scene_type === 'group') {
+            // 企业微信群聊通过 toparty 或 totag
+            request.toparty = scene_id.string;
+        }
+        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 += '@all ';
+                }
+                else {
+                    text += `@${userId} `;
+                }
+            }
+            else if (seg.type === 'image') {
+                // 企业微信图片消息需要先上传获取 media_id，这里简化处理
+                if (seg.data.url || seg.data.file) {
+                    text += `[图片: ${seg.data.url || seg.data.file}]`;
+                }
+            }
+        }
+        request.text = {
+            content: text,
+        };
+        const result = await bot.sendMessage(request);
+        return {
+            message_id: this.createId(result.msgid || result.response_code || Date.now().toString()),
+        };
+    }
+    /**
+     * 删除/撤回消息
+     */
+    async deleteMessage(uin, params) {
+        // 企业微信不支持撤回消息
+        throw new Error('企业微信不支持撤回消息');
+    }
+    /**
+     * 获取消息
+     */
+    async getMessage(uin, params) {
+        // 企业微信不支持直接获取消息
+        throw new Error('企业微信不支持直接获取消息');
+    }
+    /**
+     * 更新消息
+     */
+    async updateMessage(uin, params) {
+        // 企业微信不支持更新消息
+        throw new Error('企业微信不支持更新消息');
+    }
+    // ============================================
+    // 用户相关方法
+    // ============================================
+    /**
+     * 获取机器人自身信息
+     */
+    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?.userid || ''),
+            user_name: me?.name || '',
+            user_displayname: me?.name || '',
+            avatar: me?.avatar,
+        };
+    }
+    /**
+     * 获取用户信息
+     */
+    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.userid),
+            user_name: user.name || '',
+            user_displayname: user.name || '',
+            avatar: user.avatar,
+        };
+    }
+    // ============================================
+    // 好友（私聊会话）相关方法
+    // ============================================
+    /**
+     * 获取好友列表（企业微信不支持）
+     */
+    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.userid),
+            user_name: user.name || '',
+            remark: user.alias || user.name || '',
+        };
+    }
+    // ============================================
+    // 群组相关方法
+    // ============================================
+    /**
+     * 获取群列表（部门列表）
+     */
+    async getGroupList(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const departments = await bot.getDepartmentList();
+        return departments.map((dept) => ({
+            group_id: this.createId(dept.id.toString()),
+            group_name: dept.name || '',
+        }));
+    }
+    /**
+     * 获取群信息（部门信息）
+     */
+    async getGroupInfo(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const deptId = parseInt(params.group_id.string);
+        const departments = await bot.getDepartmentList(deptId);
+        const dept = departments.find(d => d.id === deptId);
+        if (!dept) {
+            throw new Error(`部门 ${deptId} 不存在`);
+        }
+        return {
+            group_id: this.createId(dept.id.toString()),
+            group_name: dept.name || '',
+        };
+    }
+    /**
+     * 退出群组（企业微信不支持）
+     */
+    async leaveGroup(uin, params) {
+        // 企业微信不支持退出部门
+        throw new Error('企业微信不支持退出部门');
+    }
+    /**
+     * 获取群成员列表（部门成员列表）
+     */
+    async getGroupMemberList(uin, params) {
+        const account = this.getAccount(uin);
+        if (!account)
+            throw new Error(`Account ${uin} not found`);
+        const bot = account.client;
+        const deptId = parseInt(params.group_id.string);
+        const members = await bot.getDepartmentMembers(deptId);
+        return members.map((user) => ({
+            group_id: params.group_id,
+            user_id: this.createId(user.userid),
+            user_name: user.name || '',
+            card: user.alias || user.name || '',
+            role: user.is_leader_in_dept?.some((isLeader, idx) => isLeader === 1 && user.department?.[idx] === deptId) ? 'admin' : '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);
+        const deptId = parseInt(params.group_id.string);
+        return {
+            group_id: params.group_id,
+            user_id: this.createId(user.userid),
+            user_name: user.name || '',
+            card: user.alias || user.name || '',
+            role: user.is_leader_in_dept?.some((isLeader, idx) => isLeader === 1 && user.department?.[idx] === deptId) ? 'admin' : 'member',
+        };
+    }
+    /**
+     * 踢出群成员（企业微信不支持）
+     */
+    async kickGroupMember(uin, params) {
+        // 企业微信不支持踢出部门成员
+        throw new Error('企业微信不支持踢出部门成员');
+    }
+    /**
+     * 设置群名片（企业微信不支持）
+     */
+    async setGroupCard(uin, params) {
+        // 企业微信不支持设置群名片
+        throw new Error('企业微信不支持设置群名片');
+    }
+    // ============================================
+    // 系统相关方法
+    // ============================================
+    /**
+     * 获取版本信息
+     */
+    async getVersion(uin) {
+        return {
+            app_name: 'onebots 企业微信 Adapter',
+            app_version: '1.0.0',
+            impl: 'wecom',
+            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 wecomConfig = {
+            account_id: config.account_id,
+            corp_id: config.corp_id,
+            corp_secret: config.corp_secret,
+            agent_id: config.agent_id,
+            token: config.token,
+            encoding_aes_key: config.encoding_aes_key,
+        };
+        const bot = new WeComBot(wecomConfig);
+        const account = new Account(this, bot, config);
+        // Webhook 路由（事件回调）
+        this.app.router.post(`${account.path}/webhook`, bot.handleWebhook.bind(bot));
+        // 监听 Bot 事件
+        bot.on('ready', () => {
+            this.logger.info(`企业微信 Bot ${config.account_id} 已就绪`);
+        });
+        bot.on('error', (error) => {
+            this.logger.error(`企业微信 Bot ${config.account_id} 错误:`, error);
+        });
+        // 监听企业微信事件
+        bot.on('event', (event) => {
+            this.handleWeComEvent(account, event);
+        });
+        // 启动时初始化 Bot
+        account.on('start', async () => {
+            try {
+                await bot.start();
+                account.status = AccountStatus.Online;
+                const me = bot.getCachedMe();
+                account.nickname = me?.name || '企业微信 Bot';
+                account.avatar = me?.avatar || this.icon;
+            }
+            catch (error) {
+                this.logger.error(`启动企业微信 Bot 失败:`, error);
+                account.status = AccountStatus.OffLine;
+            }
+        });
+        account.on('stop', async () => {
+            await bot.stop();
+            account.status = AccountStatus.OffLine;
+        });
+        return account;
+    }
+    /**
+     * 处理企业微信事件
+     */
+    handleWeComEvent(account, event) {
+        const eventType = event.EventType;
+        // 处理消息事件
+        if (eventType === 'change_contact' && event.ChangeType === 'create_user') {
+            // 用户创建事件
+            this.logger.info(`用户创建: ${event.UserID}`);
+        }
+        else if (eventType === 'change_contact' && event.ChangeType === 'update_user') {
+            // 用户更新事件
+            this.logger.info(`用户更新: ${event.UserID}`);
+        }
+        else if (eventType === 'change_contact' && event.ChangeType === 'delete_user') {
+            // 用户删除事件
+            this.logger.info(`用户删除: ${event.UserID}`);
+        }
+        // 注意：企业微信的消息事件需要通过其他方式接收（如应用消息回调）
+    }
+}
+AdapterRegistry.register('wecom', WeComAdapter, {
+    name: 'wecom',
+    displayName: '企业微信官方机器人',
+    description: '企业微信官方机器人适配器，支持应用消息推送、通讯录同步',
+    icon: 'https://work.weixin.qq.com/favicon.ico',
+    homepage: 'https://work.weixin.qq.com/',
+    author: '凉菜',
+});
+//# sourceMappingURL=adapter.js.map

package/lib/bot.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 企业微信 Bot 客户端
+ * 基于企业微信开放平台 API，使用 fetch 实现
+ */
+import { EventEmitter } from 'events';
+import type { RouterContext, Next } from 'onebots';
+import type { WeComConfig, WeComSendMessageRequest, WeComSendMessageResponse, WeComUser, WeComDepartment } from './types.js';
+export declare class WeComBot extends EventEmitter {
+    private config;
+    private accessToken;
+    private tokenExpireTime;
+    private me;
+    constructor(config: WeComConfig);
+    /**
+     * 发送 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;
+    }>;
+    /**
+     * 获取访问令牌
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * 启动 Bot
+     */
+    start(): Promise<void>;
+    /**
+     * 停止 Bot
+     */
+    stop(): Promise<void>;
+    /**
+     * 处理 Webhook 请求（事件回调）
+     */
+    handleWebhook(ctx: RouterContext, next: Next): Promise<void>;
+    /**
+     * 获取缓存的 Bot 信息
+     */
+    getCachedMe(): WeComUser | null;
+    /**
+     * 发送应用消息
+     */
+    sendMessage(request: WeComSendMessageRequest): Promise<WeComSendMessageResponse>;
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(userId: string): Promise<WeComUser>;
+    /**
+     * 获取部门列表
+     */
+    getDepartmentList(departmentId?: number): Promise<WeComDepartment[]>;
+    /**
+     * 获取部门成员列表
+     */
+    getDepartmentMembers(departmentId: number, fetchChild?: boolean): Promise<WeComUser[]>;
+    /**
+     * 获取 HTTP 客户端实例（返回 this 以便链式调用）
+     */
+    getHttpClient(): WeComBot;
+}
+//# sourceMappingURL=bot.d.ts.map

package/lib/bot.js

@@ -0,0 +1,191 @@
+/**
+ * 企业微信 Bot 客户端
+ * 基于企业微信开放平台 API，使用 fetch 实现
+ */
+import { EventEmitter } from 'events';
+const WECOM_API_BASE = 'https://qyapi.weixin.qq.com';
+export class WeComBot extends EventEmitter {
+    config;
+    accessToken = '';
+    tokenExpireTime = 0;
+    me = null;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * 发送 HTTP 请求
+     */
+    async request(path, options = {}) {
+        const { method = 'GET', headers = {}, body, params, skipAuth = false } = options;
+        // 构建 URL
+        const url = new URL(`${WECOM_API_BASE}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.append(key, String(value));
+                }
+            }
+        }
+        // 自动添加 token（除了获取 token 的请求）
+        if (!skipAuth && !path.includes('/gettoken')) {
+            const token = await this.getAccessToken();
+            url.searchParams.append('access_token', token);
+        }
+        // 构建请求头
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            ...headers,
+        };
+        // 发送请求
+        const response = await fetch(url.toString(), {
+            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 };
+    }
+    /**
+     * 获取访问令牌
+     */
+    async getAccessToken() {
+        if (this.accessToken && Date.now() < this.tokenExpireTime) {
+            return this.accessToken;
+        }
+        const data = await this.request('/cgi-bin/gettoken', {
+            params: {
+                corpid: this.config.corp_id,
+                corpsecret: this.config.corp_secret,
+            },
+            skipAuth: true,
+        });
+        if (data.errcode !== 0) {
+            throw new Error(`获取访问令牌失败: ${data.errmsg}`);
+        }
+        this.accessToken = data.access_token || '';
+        this.tokenExpireTime = Date.now() + ((data.expires_in || 7200) - 60) * 1000; // 提前60秒刷新
+        return this.accessToken;
+    }
+    /**
+     * 启动 Bot
+     */
+    async start() {
+        try {
+            // 获取访问令牌
+            await this.getAccessToken();
+            // 获取应用信息（企业微信没有直接的 getBotInfo API）
+            this.me = {
+                userid: this.config.agent_id,
+                name: 'WeCom Bot',
+            };
+            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;
+        const query = ctx.query;
+        // 处理 URL 验证（企业微信首次配置 webhook 时会发送验证请求）
+        if (query.msg_signature && query.timestamp && query.nonce && query.echostr) {
+            // 这里需要验证签名，简化处理直接返回 echostr
+            ctx.body = query.echostr;
+            return;
+        }
+        // 处理事件
+        if (body.EventType) {
+            const event = body;
+            this.emit('event', event);
+        }
+        ctx.body = { code: 0 };
+        await next();
+    }
+    /**
+     * 获取缓存的 Bot 信息
+     */
+    getCachedMe() {
+        return this.me;
+    }
+    /**
+     * 发送应用消息
+     */
+    async sendMessage(request) {
+        const response = await this.post('/cgi-bin/message/send', {
+            ...request,
+            agentid: parseInt(this.config.agent_id),
+        });
+        if (response.data.errcode !== 0) {
+            throw new Error(`发送消息失败: ${response.data.errmsg}`);
+        }
+        return response.data;
+    }
+    /**
+     * 获取用户信息
+     */
+    async getUserInfo(userId) {
+        const response = await this.get('/cgi-bin/user/get', { userid: userId });
+        if (response.data.errcode !== 0) {
+            throw new Error(`获取用户信息失败: ${response.data.errmsg}`);
+        }
+        return response.data;
+    }
+    /**
+     * 获取部门列表
+     */
+    async getDepartmentList(departmentId) {
+        const params = {};
+        if (departmentId !== undefined) {
+            params.id = departmentId;
+        }
+        const response = await this.get('/cgi-bin/department/list', params);
+        if (response.data.errcode !== 0) {
+            throw new Error(`获取部门列表失败: ${response.data.errmsg}`);
+        }
+        return response.data.department || [];
+    }
+    /**
+     * 获取部门成员列表
+     */
+    async getDepartmentMembers(departmentId, fetchChild) {
+        const response = await this.get('/cgi-bin/user/list', {
+            department_id: departmentId,
+            fetch_child: fetchChild ? 1 : 0,
+        });
+        if (response.data.errcode !== 0) {
+            throw new Error(`获取部门成员列表失败: ${response.data.errmsg}`);
+        }
+        return response.data.userlist || [];
+    }
+    /**
+     * 获取 HTTP 客户端实例（返回 this 以便链式调用）
+     */
+    getHttpClient() {
+        return this;
+    }
+}
+//# sourceMappingURL=bot.js.map

package/lib/index.d.ts

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

package/lib/index.js

@@ -0,0 +1,3 @@
+export * from './adapter.js';
+export * from './bot.js';
+//# sourceMappingURL=index.js.map

package/lib/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * 企业微信开放平台 API 类型定义
+ * 基于企业微信开放平台官方 API
+ */
+export interface WeComConfig {
+    account_id: string;
+    corp_id: string;
+    corp_secret: string;
+    agent_id: string;
+    token?: string;
+    encoding_aes_key?: string;
+}
+export interface WeComUser {
+    userid: string;
+    name: string;
+    alias?: string;
+    mobile?: string;
+    department?: number[];
+    order?: number[];
+    position?: string;
+    gender?: string;
+    email?: string;
+    avatar?: string;
+    status?: number;
+    is_leader_in_dept?: number[];
+    telephone?: string;
+    address?: string;
+    extattr?: any;
+    to_invite?: boolean;
+    external_position?: string;
+    external_profile?: any;
+}
+export interface WeComDepartment {
+    id: number;
+    name: string;
+    name_en?: string;
+    parentid?: number;
+    order?: number;
+}
+export interface WeComMessage {
+    msgid: string;
+    action: string;
+    from: {
+        type: string;
+        id: string;
+    };
+    tolist: string[];
+    roomid?: string;
+    msgtime: number;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: {
+        md5: string;
+        filesize: number;
+        sdkfileid: string;
+    };
+    voice?: {
+        md5: string;
+        voice_size: number;
+        play_length: number;
+        sdkfileid: string;
+    };
+    video?: {
+        md5: string;
+        filesize: number;
+        play_length: number;
+        sdkfileid: string;
+    };
+    file?: {
+        md5: string;
+        filename: string;
+        filesize: number;
+        sdkfileid: string;
+    };
+    [key: string]: any;
+}
+export interface WeComEvent {
+    EventType: string;
+    EventId: string;
+    TimeStamp: number;
+    FromUserName?: string;
+    ToUserName?: string;
+    AgentID?: string;
+    [key: string]: any;
+}
+export interface WeComTokenResponse {
+    errcode: number;
+    errmsg: string;
+    access_token?: string;
+    expires_in?: number;
+}
+export interface WeComSendMessageRequest {
+    touser?: string;
+    toparty?: string;
+    totag?: string;
+    msgtype: string;
+    agentid: number;
+    text?: {
+        content: string;
+    };
+    image?: {
+        media_id: string;
+    };
+    voice?: {
+        media_id: string;
+    };
+    video?: {
+        media_id: string;
+        title?: string;
+        description?: string;
+    };
+    file?: {
+        media_id: string;
+    };
+    textcard?: {
+        title: string;
+        description: string;
+        url: string;
+        btntxt?: string;
+    };
+    news?: {
+        articles: Array<{
+            title: string;
+            description?: string;
+            url: string;
+            picurl?: string;
+        }>;
+    };
+    mpnews?: {
+        articles: Array<{
+            title: string;
+            thumb_media_id: string;
+            author?: string;
+            content_source_url?: string;
+            content: string;
+            digest?: string;
+        }>;
+    };
+    markdown?: {
+        content: string;
+    };
+    [key: string]: any;
+}
+export interface WeComSendMessageResponse {
+    errcode: number;
+    errmsg: string;
+    invaliduser?: string;
+    invalidparty?: string;
+    invalidtag?: string;
+    msgid?: string;
+    response_code?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.js

@@ -0,0 +1,6 @@
+/**
+ * 企业微信开放平台 API 类型定义
+ * 基于企业微信开放平台官方 API
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@onebots/adapter-wecom",
+  "version": "1.0.0",
+  "description": "onebots 企业微信适配器",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "keywords": [
+    "onebots",
+    "wecom",
+    "wechat-work",
+    "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"
+  }
+}