@hpplay-lebo/cluster-hub 3.0.0 → 3.2.0

package/README.md

@@ -141,6 +141,8 @@ openclaw hub tasks
 | `feishu_wiki` | 知识库操作（空间/节点/创建） |
 | `feishu_drive` | 云空间管理（文件列表/创建文件夹/移动/删除） |
 | `feishu_perm` | 权限管理（查看/添加/移除协作者） |
+| `feishu_contact` | 通讯录查询（按姓名搜索/按邮箱查 open_id） |
+| `feishu_message` | 发送飞书消息（文本/富文本/批量发送） |
 | `feishu_app_scopes` | 查看应用权限 |
 
 > **冲突处理**: 如果节点已安装并启用了 OpenClaw 飞书插件，Hub 下发的工具会自动跳过，不会冲突。

package/docs/GUIDE.md

@@ -42,6 +42,19 @@ openclaw plugins list
 # 应看到 cluster-hub 状态为 loaded
 ```
 
+### 更新插件
+
+已安装过的用户，拉取最新版本即可：
+
+```bash
+cd ~/.openclaw/extensions/cluster-hub
+git pull
+
+# 重启 Gateway 加载新代码
+kill -9 $(pgrep -f "openclaw.*gateway")
+openclaw gateway start
+```
+
 ---
 
 ## 第二步：创建集群（根节点）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hpplay-lebo/cluster-hub",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "OpenClaw Hub cluster plugin — cross-network node collaboration, chat, and task orchestration",
   "author": "HPPlay",
   "license": "MIT",

package/src/feishu-tools.ts

@@ -13,7 +13,13 @@ interface FeishuCredentials {
   domain?: string;
 }
 
+interface OwnerInfo {
+  openId: string;
+  name?: string;
+}
+
 let _credentials: FeishuCredentials | null = null;
+let _owner: OwnerInfo | null = null;
 let _tenantToken: string | null = null;
 let _tokenExpiresAt = 0;
 
@@ -29,6 +35,10 @@ export function setCredentials(creds: FeishuCredentials) {
   _tokenExpiresAt = 0;
 }
 
+export function setOwner(owner: OwnerInfo | undefined) {
+  if (owner?.openId) _owner = owner;
+}
+
 export function hasCredentials(): boolean {
   return !!_credentials?.appId && !!_credentials?.appSecret;
 }
@@ -181,11 +191,23 @@ async function docCreate(title: string, folderToken?: string) {
     folder_token: folderToken,
   });
   const doc = data?.document;
-  return {
+  const result: any = {
     document_id: doc?.document_id,
     title: doc?.title,
     url: `https://feishu.cn/docx/${doc?.document_id}`,
   };
+
+  // 自动给 owner 加编辑权限
+  if (_owner?.openId && doc?.document_id) {
+    try {
+      await permAdd(doc.document_id, 'docx', 'openid', _owner.openId, 'full_access');
+      result.owner_permission = 'full_access';
+    } catch (e: any) {
+      result.owner_permission_error = e.message;
+    }
+  }
+
+  return result;
 }
 
 async function docWrite(docToken: string, markdown: string) {
@@ -369,7 +391,7 @@ async function permList(token: string, type: string) {
 }
 
 async function permAdd(token: string, type: string, memberType: string, memberId: string, perm: string) {
-  const data = await feishuPost(`/open-apis/drive/v1/permissions/${token}/members?type=${type}&need_notification=false`, {
+  const data = await feishuPost(`/open-apis/drive/v1/permissions/${token}/members?type=${type}&need_notification=true`, {
     member_type: memberType, member_id: memberId, perm,
   });
   return { success: true, member: data?.member };
@@ -382,6 +404,88 @@ async function permRemove(token: string, type: string, memberType: string, membe
   return { success: true };
 }
 
+// ============================================================
+//  Contact API
+// ============================================================
+
+async function contactSearch(query: string) {
+  const data = await feishuPost('/open-apis/search/v1/user', { query });
+  return {
+    users: (data?.users || []).map((u: any) => ({
+      open_id: u.open_id,
+      name: u.name,
+      en_name: u.en_name,
+      email: u.email,
+      avatar: u.avatar?.avatar_72,
+      department: u.department_name,
+    })),
+  };
+}
+
+async function contactBatchGetId(emails?: string[], mobiles?: string[]) {
+  const body: any = {};
+  if (emails?.length) body.emails = emails;
+  if (mobiles?.length) body.mobiles = mobiles;
+  const data = await feishuPost('/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id', body);
+  return {
+    email_users: data?.email_users || {},
+    mobile_users: data?.mobile_users || {},
+  };
+}
+
+async function contactGetUser(userId: string) {
+  const data = await feishuGet(`/open-apis/contact/v3/users/${userId}`, { user_id_type: 'open_id' });
+  const u = data?.user;
+  return {
+    open_id: u?.open_id,
+    name: u?.name,
+    en_name: u?.en_name,
+    email: u?.email,
+    mobile: u?.mobile,
+    avatar: u?.avatar?.avatar_72,
+    department_ids: u?.department_ids,
+    status: u?.status,
+  };
+}
+
+// ============================================================
+//  Message API
+// ============================================================
+
+async function messageSend(receiveId: string, receiveIdType: string, msgType: string, content: any) {
+  const data = await feishuPost(`/open-apis/im/v1/messages?receive_id_type=${receiveIdType}`, {
+    receive_id: receiveId,
+    msg_type: msgType,
+    content: typeof content === 'string' ? content : JSON.stringify(content),
+  });
+  return {
+    message_id: data?.message_id,
+    create_time: data?.create_time,
+  };
+}
+
+async function messageSendText(receiveId: string, receiveIdType: string, text: string) {
+  return messageSend(receiveId, receiveIdType, 'text', JSON.stringify({ text }));
+}
+
+async function messageSendRichText(receiveId: string, receiveIdType: string, title: string, contentParts: any[][]) {
+  const post = { zh_cn: { title, content: contentParts } };
+  return messageSend(receiveId, receiveIdType, 'post', JSON.stringify(post));
+}
+
+async function messageSendBatch(receiveIds: string[], receiveIdType: string, msgType: string, content: any) {
+  const results: any[] = [];
+  for (const id of receiveIds) {
+    try {
+      const r = await messageSend(id, receiveIdType, msgType, content);
+      results.push({ receiveId: id, success: true, message_id: r.message_id });
+    } catch (e: any) {
+      results.push({ receiveId: id, success: false, error: e.message });
+    }
+  }
+  return { sent: results.filter(r => r.success).length, failed: results.filter(r => !r.success).length, results };
+}
+
 // ============================================================
 //  App Scopes API
 // ============================================================
@@ -447,10 +551,14 @@ export function registerFeishuTools(api: any, logger: any): boolean {
   } catch {}
 
   // ---- feishu_doc ----
+  const ownerHint = _owner?.openId
+    ? ` Documents created via API are owned by the app bot. Owner (openid: ${_owner.openId}) is auto-granted full_access on create.`
+    : '';
+
   api.registerTool({
     name: 'feishu_doc',
     label: 'Feishu Doc',
-    description: 'Feishu document operations. Actions: read, write, append, create, list_blocks, get_block, update_block, delete_block',
+    description: `Feishu document operations. Actions: read, write, append, create, list_blocks, get_block, update_block, delete_block.${ownerHint}`,
     parameters: {
       type: 'object',
       properties: {
@@ -540,10 +648,14 @@ export function registerFeishuTools(api: any, logger: any): boolean {
   }, { name: 'feishu_drive' });
 
   // ---- feishu_perm ----
+  const permOwnerHint = _owner?.openId
+    ? ` Owner open_id: ${_owner.openId}`
+    : '';
+
   api.registerTool({
     name: 'feishu_perm',
     label: 'Feishu Perm',
-    description: 'Feishu permission management. Actions: list, add, remove',
+    description: `Feishu permission management. Actions: list, add, remove.${permOwnerHint}`,
     parameters: {
       type: 'object',
       properties: {
@@ -568,6 +680,86 @@ export function registerFeishuTools(api: any, logger: any): boolean {
     },
   }, { name: 'feishu_perm' });
 
+  // ---- feishu_contact ----
+  api.registerTool({
+    name: 'feishu_contact',
+    label: 'Feishu Contact',
+    description: 'Feishu contact/user lookup. Actions: search (by name), batch_get_id (by emails/mobiles), get (by open_id). Use search to find a person\'s open_id by name.',
+    parameters: {
+      type: 'object',
+      properties: {
+        action: { type: 'string', enum: ['search', 'batch_get_id', 'get'], description: 'Action' },
+        query: { type: 'string', description: 'Search keyword (name) for search action' },
+        emails: { type: 'array', items: { type: 'string' }, description: 'Email list for batch_get_id' },
+        mobiles: { type: 'array', items: { type: 'string' }, description: 'Mobile list for batch_get_id' },
+        user_id: { type: 'string', description: 'User open_id for get action' },
+      },
+      required: ['action'],
+    },
+    async execute(_id: string, p: any) {
+      try {
+        switch (p.action) {
+          case 'search': return json(await contactSearch(p.query));
+          case 'batch_get_id': return json(await contactBatchGetId(p.emails, p.mobiles));
+          case 'get': return json(await contactGetUser(p.user_id));
+          default: return json({ error: `Unknown action: ${p.action}` });
+        }
+      } catch (err: any) { return json({ error: err.message }); }
+    },
+  }, { name: 'feishu_contact' });
+
+  // ---- feishu_message ----
+  api.registerTool({
+    name: 'feishu_message',
+    label: 'Feishu Message',
+    description: 'Send Feishu messages. Actions: send (single), send_batch (multiple). Supports text and rich text. Use feishu_contact to look up open_id first if needed.',
+    parameters: {
+      type: 'object',
+      properties: {
+        action: { type: 'string', enum: ['send', 'send_batch'], description: 'Action' },
+        receive_id: { type: 'string', description: 'Recipient ID (open_id or email)' },
+        receive_id_type: { type: 'string', enum: ['open_id', 'email', 'user_id', 'chat_id'], description: 'Recipient ID type (default: open_id)' },
+        receive_ids: { type: 'array', items: { type: 'string' }, description: 'Multiple recipient IDs for send_batch' },
+        msg_type: { type: 'string', enum: ['text', 'post'], description: 'Message type: text (plain) or post (rich text with links). Default: text' },
+        text: { type: 'string', description: 'Message text content (for text type)' },
+        title: { type: 'string', description: 'Rich text title (for post type)' },
+        content: {
+          type: 'array',
+          description: 'Rich text content blocks (for post type). Array of lines, each line is array of elements like {tag:"text",text:"..."} or {tag:"a",text:"click",href:"https://..."}',
+          items: { type: 'array', items: { type: 'object' } },
+        },
+      },
+      required: ['action'],
+    },
+    async execute(_id: string, p: any) {
+      try {
+        const idType = p.receive_id_type || 'open_id';
+        const msgType = p.msg_type || 'text';
+
+        if (p.action === 'send') {
+          if (msgType === 'text') {
+            return json(await messageSendText(p.receive_id, idType, p.text));
+          } else if (msgType === 'post') {
+            return json(await messageSendRichText(p.receive_id, idType, p.title || '', p.content || []));
+          } else {
+            return json(await messageSend(p.receive_id, idType, msgType, p.text || p.content));
+          }
+        } else if (p.action === 'send_batch') {
+          const ids = p.receive_ids || [];
+          if (msgType === 'text') {
+            const content = JSON.stringify({ text: p.text });
+            return json(await messageSendBatch(ids, idType, 'text', content));
+          } else if (msgType === 'post') {
+            const post = { zh_cn: { title: p.title || '', content: p.content || [] } };
+            return json(await messageSendBatch(ids, idType, 'post', JSON.stringify(post)));
+          }
+          return json({ error: 'Unsupported msg_type for batch' });
+        }
+        return json({ error: `Unknown action: ${p.action}` });
+      } catch (err: any) { return json({ error: err.message }); }
+    },
+  }, { name: 'feishu_message' });
+
   // ---- feishu_app_scopes ----
   api.registerTool({
     name: 'feishu_app_scopes',
@@ -581,6 +773,6 @@ export function registerFeishuTools(api: any, logger: any): boolean {
   }, { name: 'feishu_app_scopes' });
 
   _registered = true;
-  logger.info('[feishu-tools] ✅ 已注册 5 个飞书工具（feishu_doc/wiki/drive/perm/app_scopes）');
+  logger.info('[feishu-tools] ✅ 已注册 7 个飞书工具（feishu_doc/wiki/drive/perm/contact/message/app_scopes）');
   return true;
 }

package/src/index.ts

@@ -17,7 +17,7 @@ import path from 'path';
 import fs from 'fs';
 import { HubClient } from './hub-client.js';
 import { TaskStore, ChatStore, NodeEventStore } from './store.js';
-import { setCredentials, registerFeishuTools, hasCredentials } from './feishu-tools.js';
+import { setCredentials, setOwner, registerFeishuTools, hasCredentials } from './feishu-tools.js';
 import type {
   HubPluginConfig, DEFAULT_CONFIG, ResultPayload, WSMessage,
   QueuedTask, ChatConfig, StoredTask, StoredChatMessage, StoredNodeEvent,
@@ -671,6 +671,9 @@ const plugin = {
     // Hub 下发共享配置 → 注册飞书工具
     client.onSharedConfig = (config: any) => {
       api.logger.info(`[cluster-hub] 收到共享配置: ${JSON.stringify(Object.keys(config))}`);
+      if (config.owner) {
+        setOwner(config.owner);
+      }
       if (config.feishu?.appId && config.feishu?.appSecret) {
         setCredentials(config.feishu);
         registerFeishuTools(api, api.logger);