@vui-design/openclaw-plugin-feishu-progress 0.2.5 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vui-design/openclaw-plugin-feishu-progress",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "飞书任务进度卡片插件 — 在 AI 执行复杂多步骤任务时，实时更新飞书进度卡片",
   "keywords": [
     "openclaw-plugin",

package/src/index.ts

@@ -1,28 +1,132 @@
 import { FeishuClient } from './feishu-client.js';
 
-// 常见工具名称中文映射
-const TOOL_LABEL: Record<string, string> = {
-  read_file: '读取文件',
-  write_file: '写入文件',
-  list_directory: '浏览目录',
-  bash: '执行命令',
-  web_search: '网络搜索',
-  tavily_search: '网络搜索',
-  web_fetch: '抓取网页',
-  computer: '操作电脑',
-  screenshot: '截图',
-  str_replace_editor: '编辑文件',
-  create_file: '创建文件',
-  delete_file: '删除文件',
-};
+// ── 工具名称标签构建（解析实际参数，生成语义化中文描述）──────────────────────
+
+function basename(p: string): string {
+  return p.split(/[/\\]/).filter(Boolean).pop() ?? p;
+}
 
-function toolLabel(name: string): string {
-  return TOOL_LABEL[name] ?? name;
+function str(v: unknown, max = 60): string {
+  return String(v ?? '').slice(0, max).trim();
 }
 
-// sessionKey → conversationId（飞书 chat_id）
+function buildToolLabel(toolName: string, params: Record<string, unknown>): string {
+  switch (toolName) {
+    case 'exec':
+    case 'bash': {
+      const cmd = str(params?.command ?? params?.cmd ?? params?.input, 150);
+
+      const brewInstall = cmd.match(/brew\s+install\s+([\w@./-]+)/);
+      if (brewInstall) return `📦 安装 ${brewInstall[1]}`;
+      const brewUninstall = cmd.match(/brew\s+uninstall\s+([\w@./-]+)/);
+      if (brewUninstall) return `🗑️ 卸载 ${brewUninstall[1]}`;
+
+      const which = cmd.match(/^(?:which|command\s+-v)\s+([\w.-]+)/);
+      if (which) return `🔍 检查 ${which[1]} 是否已安装`;
+
+      const npmInstall = cmd.match(/(?:npm|pnpm|yarn)\s+(?:install|add)\s+([\w@./-]+)?/);
+      if (npmInstall) return npmInstall[1] ? `📦 安装 ${npmInstall[1]}` : '📦 安装依赖';
+      const npmRun = cmd.match(/(?:npm|pnpm|yarn)\s+run\s+([\w:.-]+)/);
+      if (npmRun) return `▶️ 运行 ${npmRun[1]}`;
+
+      const pip = cmd.match(/pip(?:\d)?\s+install\s+([\w@.-]+)/);
+      if (pip) return `📦 安装 ${pip[1]}`;
+
+      const gitClone = cmd.match(/git\s+clone\s+(?:.*\/)?([^/\s]+?)(?:\.git)?(?:\s|$)/);
+      if (gitClone) return `📥 克隆仓库 ${gitClone[1]}`;
+      if (/git\s+commit/.test(cmd)) return '💾 提交代码';
+      if (/git\s+push/.test(cmd)) return '🚀 推送代码';
+      if (/git\s+pull/.test(cmd)) return '⬇️ 拉取代码';
+
+      const mkdir = cmd.match(/^mkdir\s+(?:-[\w]+\s+)?([\w./~-]+)/);
+      if (mkdir) return `📁 创建目录 ${basename(mkdir[1])}`;
+
+      const rm = cmd.match(/^rm\s+(?:-[\w]+\s+)?([\w./~-]+)/);
+      if (rm) return `🗑️ 删除 ${basename(rm[1])}`;
+
+      const curlUrl = cmd.match(/(?:curl|wget)\s+.*?(https?:\/\/[^\s]+)/);
+      if (curlUrl) { try { return `🌐 请求 ${new URL(curlUrl[1]).hostname}`; } catch { /**/ } }
+
+      if (cmd) return `⚡ ${cmd.slice(0, 40)}`;
+      return '⚡ 执行命令';
+    }
+
+    case 'process': {
+      const cmd = str(params?.command ?? params?.cmd, 80);
+      return cmd ? `⚡ 运行：${cmd.slice(0, 40)}` : '⚡ 执行进程';
+    }
+
+    case 'read':
+    case 'read_file': {
+      const p = str(params?.path ?? params?.file_path ?? params?.filePath);
+      return p ? `📂 读取 ${basename(p)}` : '📂 读取文件';
+    }
+
+    case 'write':
+    case 'write_file':
+    case 'create_file': {
+      const p = str(params?.path ?? params?.file_path ?? params?.filePath);
+      return p ? `✏️ 写入 ${basename(p)}` : '✏️ 写入文件';
+    }
+
+    case 'str_replace_editor':
+    case 'edit_file': {
+      const p = str(params?.path ?? params?.file_path);
+      return p ? `✏️ 编辑 ${basename(p)}` : '✏️ 编辑文件';
+    }
+
+    case 'list_directory': {
+      const p = str(params?.path ?? params?.directory);
+      return p ? `📋 浏览 ${basename(p) || p}` : '📋 浏览目录';
+    }
+
+    case 'search':
+    case 'web_search':
+    case 'tavily_search': {
+      const q = str(params?.query ?? params?.q, 30);
+      return q ? `🌐 搜索「${q}」` : '🌐 网络搜索';
+    }
+
+    case 'fetch':
+    case 'web_fetch': {
+      const url = str(params?.url ?? params?.href);
+      try { return `🌐 访问 ${new URL(url).hostname}`; } catch { /**/ }
+      return '🌐 抓取网页';
+    }
+
+    case 'computer': {
+      const action = str(params?.action);
+      return action ? `🖥️ 操作电脑：${action}` : '🖥️ 操作电脑';
+    }
+
+    case 'screenshot': return '📸 截图';
+
+    case 'delete_file': {
+      const p = str(params?.path ?? params?.file_path);
+      return p ? `🗑️ 删除 ${basename(p)}` : '🗑️ 删除文件';
+    }
+
+    default: return `🔧 ${toolName}`;
+  }
+}
+
+// ── 提取 AI 文本中最有意义的一句（用于工具调用前的说明）─────────────────────
+
+function extractSnippet(text: string): string {
+  // 取最后一段非空文本，截取前 50 字
+  const lines = text.split(/\n+/).map(l => l.trim()).filter(Boolean);
+  const last = lines[lines.length - 1] ?? '';
+  return last.slice(0, 50);
+}
+
+// ── 主插件逻辑 ──────────────────────────────────────────────────────────────
+
+// agentId → 飞书裸 ID（ou_xxx / oc_xxx）
 const sessionChatMap = new Map<string, string>();
 
+// runId → 最近一次 LLM turn 的 AI 文本（用于 before_tool_call 显示上下文）
+const runTextMap = new Map<string, string>();
+
 export default {
   id: 'feishu-progress',
 
@@ -31,7 +135,7 @@ export default {
 
     if (!cfg.appId || !cfg.appSecret) {
       api.logger?.warn(
-        '[feishu-progress] appId / appSecret 未配置，进度卡片功能已禁用。\n' +
+        '[feishu-progress] appId / appSecret 未配置，进度通知已禁用。\n' +
         '请执行：\n' +
         '  openclaw config set plugins.entries.feishu-progress.config.appId     "cli_xxx"\n' +
         '  openclaw config set plugins.entries.feishu-progress.config.appSecret "xxx"\n' +
@@ -46,42 +150,51 @@ export default {
       domain: cfg.domain ?? 'feishu',
     });
 
-    // ── 1. 收到用户消息时，记录当前会话对应的飞书 chat_id ────────────────────
+    // ── 1. 收到用户消息时，记录 agentId → 飞书 ID ────────────────────────────
     api.on('message_received', async (_event: any, ctx: any) => {
-      api.logger.info(`[feishu-progress][DEBUG] message_received: channelId=${ctx.channelId} accountId=${ctx.accountId} conversationId=${ctx.conversationId}`);
       if (ctx.channelId !== 'feishu') return;
       if (!ctx.conversationId) return;
-      // OpenClaw 内部格式为 "user:ou_xxx" / "group:oc_xxx"，需剥离前缀取裸 Feishu ID
+      // OpenClaw 内部格式 "user:ou_xxx" / "group:oc_xxx"，剥离前缀取裸 Feishu ID
       const rawId = ctx.conversationId.includes(':')
         ? ctx.conversationId.split(':').pop()!
         : ctx.conversationId;
-      const key = ctx.accountId ?? 'default';
-      sessionChatMap.set(key, rawId);
-      api.logger.info(`[feishu-progress][DEBUG] stored: key=${key} rawId=${rawId} (original=${ctx.conversationId})`);
+      sessionChatMap.set(ctx.accountId ?? 'default', rawId);
     });
 
-    // ── 2. 每次工具调用前，自动推送进度到飞书 ──────────────────────────────
+    // ── 2. LLM 完成一轮生成后，缓存 AI 文本供 before_tool_call 使用 ──────────
+    api.on('llm_output', async (event: any, _ctx: any) => {
+      if (!event.runId) return;
+      const texts: string[] = event.assistantTexts ?? [];
+      const text = texts.join('').trim();
+      if (text) runTextMap.set(event.runId, text);
+    });
+
+    // ── 3. 工具调用前，推送进度到飞书 ───────────────────────────────────────
     api.on('before_tool_call', async (event: any, ctx: any) => {
-      api.logger.info(`[feishu-progress][DEBUG] before_tool_call: tool=${event.toolName} agentId=${ctx.agentId} sessionKey=${ctx.sessionKey}`);
       const key = ctx.agentId ?? ctx.sessionKey ?? 'default';
       const chatId = sessionChatMap.get(key);
-      api.logger.info(`[feishu-progress][DEBUG] lookup: key=${key} chatId=${chatId} mapSize=${sessionChatMap.size}`);
       if (!chatId) return;
 
-      const label = toolLabel(event.toolName);
+      // AI 文本优先（取自本轮 LLM 输出的最后一句），没有则用参数解析标签
+      let label: string;
+      if (event.runId && runTextMap.has(event.runId)) {
+        const snippet = extractSnippet(runTextMap.get(event.runId)!);
+        runTextMap.delete(event.runId); // 每轮只用一次
+        label = snippet || buildToolLabel(event.toolName, event.params ?? {});
+      } else {
+        label = buildToolLabel(event.toolName, event.params ?? {});
+      }
+
       try {
-        await client.sendText(chatId, `🔧 正在执行：${label}`);
-        api.logger.info(`[feishu-progress][DEBUG] sendText OK: chatId=${chatId} label=${label}`);
+        await client.sendText(chatId, label);
       } catch (err: any) {
         api.logger?.warn(`[feishu-progress] 推送失败: ${err?.message}`);
       }
     });
 
-    // ── 3. 任务结束后清理 session 映射 ───────────────────────────────────────
+    // ── 4. 任务结束后清理 session 映射 ─────────────────────────────────────
     api.on('agent_end', async (_event: any, ctx: any) => {
-      const key = ctx.agentId ?? ctx.sessionKey ?? 'default';
-      api.logger.info(`[feishu-progress][DEBUG] agent_end: key=${key}`);
-      sessionChatMap.delete(key);
+      sessionChatMap.delete(ctx.agentId ?? ctx.sessionKey ?? 'default');
     });
   },
 };