@zhin.js/adapter-wecom 0.0.1

package/lib/index.js

@@ -0,0 +1,115 @@
+/**
+ * 企业微信适配器入口：类型扩展、导出、注册
+ */
+import { usePlugin } from 'zhin.js';
+import { WecomAdapter } from './adapter.js';
+import { registerWecomPlatformPermitChecker, } from './platform-permit.js';
+export * from './types.js';
+export { WecomEndpoint } from './endpoint.js';
+export { WecomAdapter } from './adapter.js';
+const plugin = usePlugin();
+const { provide, useContext } = plugin;
+useContext('router', (router) => {
+    provide({
+        name: 'wecom',
+        description: 'WeCom (企业微信) Endpoint Adapter',
+        mounted: async (p) => {
+            const adapter = new WecomAdapter(p, router);
+            await adapter.start();
+            return adapter;
+        },
+        dispose: async (adapter) => {
+            await adapter.stop();
+        },
+    });
+});
+useContext('tool', 'wecom', (toolService, wecom) => {
+    const disposers = [];
+    disposers.push(registerWecomPlatformPermitChecker());
+    disposers.push(toolService.addTool({
+        name: 'wecom_get_user',
+        description: '获取企业微信用户信息',
+        parameters: {
+            type: 'object',
+            properties: {
+                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
+                user_id: { type: 'string', description: '用户 ID' },
+            },
+            required: ['endpoint_id', 'user_id'],
+        },
+        platforms: ['wecom'],
+        tags: ['wecom'],
+        execute: async (args) => {
+            const endpoint = wecom.endpoints.get(args.endpoint_id);
+            if (!endpoint)
+                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
+            return await endpoint.getUserInfo(args.user_id);
+        },
+    }, plugin.name));
+    disposers.push(toolService.addTool({
+        name: 'wecom_get_dept_users',
+        description: '获取企业微信部门用户列表',
+        parameters: {
+            type: 'object',
+            properties: {
+                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
+                dept_id: { type: 'string', description: '部门 ID' },
+            },
+            required: ['endpoint_id', 'dept_id'],
+        },
+        platforms: ['wecom'],
+        tags: ['wecom'],
+        execute: async (args) => {
+            const endpoint = wecom.endpoints.get(args.endpoint_id);
+            if (!endpoint)
+                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
+            const users = await endpoint.getDepartmentUsers(Number(args.dept_id));
+            return { users, count: users.length };
+        },
+    }, plugin.name));
+    disposers.push(toolService.addTool({
+        name: 'wecom_list_departments',
+        description: '获取企业微信部门列表',
+        parameters: {
+            type: 'object',
+            properties: {
+                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
+                dept_id: { type: 'string', description: '父部门 ID，默认 1（跟部门）' },
+            },
+            required: ['endpoint_id'],
+        },
+        platforms: ['wecom'],
+        tags: ['wecom'],
+        execute: async (args) => {
+            const endpoint = wecom.endpoints.get(args.endpoint_id);
+            if (!endpoint)
+                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
+            const departments = await endpoint.getDepartmentList(Number(args.dept_id) || 1);
+            return { departments, count: departments.length };
+        },
+    }, plugin.name));
+    disposers.push(toolService.addTool({
+        name: 'wecom_send_text',
+        description: '向指定企业微信用户发送文本消息',
+        parameters: {
+            type: 'object',
+            properties: {
+                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
+                user_id: { type: 'string', description: '用户 ID' },
+                content: { type: 'string', description: '消息内容' },
+            },
+            required: ['endpoint_id', 'user_id', 'content'],
+        },
+        platforms: ['wecom'],
+        tags: ['wecom'],
+        execute: async (args) => {
+            const endpoint = wecom.endpoints.get(args.endpoint_id);
+            if (!endpoint)
+                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
+            const success = await endpoint.sendTextMessage(args.user_id, args.content);
+            return { success, message: success ? '消息已发送' : '发送失败' };
+        },
+    }, plugin.name));
+    return () => disposers.forEach(d => d());
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/platform-permit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 企业微信 WeCom platform permit
+ */
+import type { Message } from 'zhin.js';
+export declare function platformPermit(perm: string): string;
+export declare function wecomGroupPermitResolver(logicalPerm: string): string;
+export declare function normalizeWecomSenderForPermit(input: {
+    isOwner?: boolean;
+    isAdmin?: boolean;
+}): {
+    role?: string;
+    permissions?: string[];
+};
+export declare function checkWecomPlatformPermit(perm: string, message: Message<any>): boolean;
+export declare function registerWecomPlatformPermitChecker(): () => void;
+//# sourceMappingURL=platform-permit.d.ts.map

package/lib/platform-permit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-permit.d.ts","sourceRoot":"","sources":["../src/platform-permit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAKvC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAOD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAQ5C;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAcrF;AAED,wBAAgB,kCAAkC,IAAI,MAAM,IAAI,CAE/D"}

package/lib/platform-permit.js

@@ -0,0 +1,39 @@
+import { registerPlatformPermitChecker } from 'zhin.js';
+const ADAPTER = 'wecom';
+export function platformPermit(perm) {
+    return `platform(${ADAPTER},${perm})`;
+}
+const FACTORY_PERM_MAP = {
+    group_admin: 'chat_admin',
+    group_owner: 'chat_owner',
+};
+export function wecomGroupPermitResolver(logicalPerm) {
+    return platformPermit(FACTORY_PERM_MAP[logicalPerm] ?? logicalPerm);
+}
+export function normalizeWecomSenderForPermit(input) {
+    if (input.isOwner) {
+        return { role: 'owner', permissions: ['chat_owner', 'chat_admin'] };
+    }
+    if (input.isAdmin) {
+        return { role: 'admin', permissions: ['chat_admin'] };
+    }
+    return { role: 'member', permissions: [] };
+}
+export function checkWecomPlatformPermit(perm, message) {
+    const sender = message.$sender;
+    const permissions = sender.permissions ?? [];
+    const role = sender.role;
+    const has = (t) => permissions.includes(t);
+    switch (perm) {
+        case 'chat_owner':
+            return role === 'owner' || has('chat_owner');
+        case 'chat_admin':
+            return role === 'owner' || role === 'admin' || has('chat_admin') || has('chat_owner');
+        default:
+            return false;
+    }
+}
+export function registerWecomPlatformPermitChecker() {
+    return registerPlatformPermitChecker(ADAPTER, checkWecomPlatformPermit);
+}
+//# sourceMappingURL=platform-permit.js.map

package/lib/platform-permit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-permit.js","sourceRoot":"","sources":["../src/platform-permit.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,OAAO,IAAI,IAAI,GAAG,CAAC;AACxC,CAAC;AAED,MAAM,gBAAgB,GAA2B;IAC/C,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;CAC1B,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,cAAc,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAG7C;IACC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,OAAqB;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAoD,CAAC;IAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/C,KAAK,YAAY;YACf,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QACxF;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,OAAO,6BAA6B,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;AAC1E,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 企业微信适配器类型定义
+ */
+export interface WecomEndpointConfig {
+    context: 'wecom';
+    name: string;
+    corpId: string;
+    agentSecret: string;
+    token: string;
+    encodingAESKey: string;
+    webhookPath?: string;
+    apiBaseUrl?: string;
+}
+export interface WecomMessage {
+    ToUserName: string;
+    FromUserName: string;
+    CreateTime: number;
+    MsgType: 'text' | 'image' | 'voice' | 'video' | 'shortvideo' | 'location' | 'link' | 'event';
+    Content?: string;
+    MsgId?: string;
+    PicUrl?: string;
+    MediaId?: string;
+    ThumbMediaId?: string;
+    Format?: string;
+    Recognition?: string;
+    Location_X?: string;
+    Location_Y?: string;
+    Scale?: string;
+    Label?: string;
+    Title?: string;
+    Description?: string;
+    Url?: string;
+    Event?: string;
+    EventKey?: string;
+    AgentID?: string;
+    [key: string]: unknown;
+}
+export interface AccessToken {
+    access_token: string;
+    expires_in: number;
+    timestamp: number;
+}
+export interface WecomApiResponse {
+    errcode: number;
+    errmsg?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAA;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB"}

package/lib/types.js

@@ -0,0 +1,5 @@
+/**
+ * 企业微信适配器类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@zhin.js/adapter-wecom",
+  "version": "0.0.1",
+  "description": "Zhin.js adapter for WeCom (企业微信)",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "bot",
+    "adapter",
+    "wecom",
+    "企业微信",
+    "wechat work",
+    "chatbot"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "repository": {
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "type": "git",
+    "directory": "plugins/adapters/wecom"
+  },
+  "devDependencies": {
+    "@types/koa": "^3.0.3",
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3",
+    "@zhin.js/host-router": "1.0.1",
+    "zhin.js": "2.0.1"
+  },
+  "peerDependencies": {
+    "@zhin.js/host-router": "1.0.1",
+    "zhin.js": "2.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/host-router": {
+      "optional": false
+    }
+  },
+  "files": [
+    "src",
+    "lib",
+    "skills",
+    "plugin.yml",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "pnpm build:node",
+    "clean": "rimraf lib",
+    "build:node": "tsc"
+  }
+}

package/plugin.yml

@@ -0,0 +1,3 @@
+name: adapter-wecom
+description: 企业微信适配器：消息接收与发送、用户与部门查询、AES 消息加解密
+version: 1.0.0

package/skills/wecom/PERMITS.md

@@ -0,0 +1,19 @@
+# 企业微信 WeCom Platform Permits
+
+## 入站字段
+
+| 字段 | 来源 |
+|------|------|
+| `$sender.role` | 默认 `member`；需业务侧扩展企业微信可见性/管理权限 |
+| `$sender.permissions` | `chat_owner` · `chat_admin` |
+
+## Permit 词汇表
+
+| `platform(wecom,…)` | 含义 |
+|---------------------|------|
+| `chat_owner` | 群主 |
+| `chat_admin` | 群管理员 |
+
+## 工厂映射
+
+`group_admin` → `chat_admin` · `group_owner` → `chat_owner`

package/skills/wecom/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: wecom
+platforms:
+  - wecom
+description: >-
+  企业微信平台管理能力。当用户在企业微信中请求用户信息查询、部门架构查询、
+  发送文本消息时使用。即使用户没有提到企业微信，只要上下文是企业微信/WeCom
+  场景且涉及用户查询、部门管理或消息发送，就应触发。
+keywords:
+  - wecom
+  - 企业微信
+  - adapter:wecom
+  - 部门
+  - 用户
+  - 通讯录
+  - 企业
+tags:
+  - im
+  - enterprise
+tools:
+  - wecom_get_user
+  - wecom_get_dept_users
+  - wecom_list_departments
+  - wecom_send_text
+---
+
+# 企业微信技能
+
+企业微信（WeCom）是腾讯面向企业的 IM 平台，具备组织架构（部门树）、应用消息推送等能力。
+
+## 核心原则
+
+### 组织架构是核心
+
+企业微信的用户隶属于部门树，查询操作需要从组织架构出发：
+```
+wecom_list_departments → 获取部门列表（默认从根部门 ID=1 开始）
+wecom_get_dept_users(dept_id) → 获取部门下的用户列表
+wecom_get_user(user_id) → 获取用户详情
+```
+
+### 消息发送
+
+`wecom_send_text` 通过应用消息接口发送文本消息，需要知道接收者的 `userid`。
+群消息通过 webhook 回调自动处理，不需要主动调用发送工具。
+
+## 工具分类
+
+### 组织架构
+
+| 工具 | 用途 | 说明 |
+|------|------|------|
+| `wecom_list_departments` | 部门列表 | 默认从根部门 ID=1 开始 |
+| `wecom_get_dept_users` | 部门用户列表 | 返回简单用户信息 |
+| `wecom_get_user` | 用户详情 | 需要通讯录权限 |
+
+### 消息
+
+| 工具 | 用途 | 说明 |
+|------|------|------|
+| `wecom_send_text` | 发送文本消息 | 发给指定用户，通过应用消息接口 |
+
+## 易错点
+
+1. **部门查询从根部门 ID=1 开始**。不知道部门 ID 时先 `list_departments` 获取整棵部门树。
+2. **消息发送需要 userid**，不是用户名或昵称。仅有昵称时先通过 `get_dept_users` 查找。
+3. **企业微信不支持机器人撤回消息**，一旦发出无法撤回。
+4. **Access Token 有效期 7200 秒**，适配器会自动刷新。

package/src/adapter.ts

@@ -0,0 +1,26 @@
+/**
+ * 企业微信适配器
+ */
+import { Adapter, Plugin } from 'zhin.js';
+import type { Router } from '@zhin.js/host-router/router';
+import { WecomEndpoint } from './endpoint.js';
+import type { WecomEndpointConfig } from './types.js';
+
+export class WecomAdapter extends Adapter<WecomEndpoint> {
+  static override readonly capabilities = ['inbound', 'outbound'] as const;
+
+  #router: Router;
+
+  constructor(plugin: Plugin, router: Router) {
+    super(plugin, 'wecom', []);
+    this.#router = router;
+  }
+
+  createEndpoint(config: WecomEndpointConfig): WecomEndpoint {
+    return new WecomEndpoint(this, this.#router, config);
+  }
+
+  async start(): Promise<void> {
+    await super.start();
+  }
+}