cursor-feishu 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NeverMore93
+
+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,244 @@
+# cursor-feishu
+
+[![npm](https://img.shields.io/npm/v/cursor-feishu)](https://www.npmjs.com/package/cursor-feishu)
+
+**Cursor 飞书集成** — 通过飞书 WebSocket 长连接将飞书消息接入 Cursor Headless CLI。
+
+## 特性
+
+- 🚀 **WebSocket 长连接** — 实时接收飞书消息，无需 Webhook 配置
+- 🤖 **多媒体支持** — 图片、文件、音频、富文本消息自动处理
+- 👥 **智能群聊** — 仅 @提及时回复，其他消息静默监听作为上下文
+- 💬 **流式响应** — 支持实时更新消息（流式输出）
+- 🔧 **灵活配置** — 支持环境变量注入和配置文件加载
+- 📝 **完整类型** — TypeScript 类型定义，开发友好
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+npm install cursor-feishu
+```
+
+### 2. 创建飞书配置文件
+
+创建 `~/.config/cursor/plugins/feishu.json`：
+
+```json
+{
+  "appId": "cli_xxxxxxxxxxxx",
+  "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+}
+```
+
+也支持通过环境变量注入敏感值（适合容器部署）：
+
+```json
+{
+  "appId": "${FEISHU_APP_ID}",
+  "appSecret": "${FEISHU_APP_SECRET}"
+}
+```
+
+### 3. 配置飞书应用
+
+在 [飞书开放平台](https://open.feishu.cn/app) 创建自建应用，然后：
+
+1. **添加机器人能力**
+2. **事件订阅** — 添加 `im.message.receive_v1` 和 `im.chat.member.bot.added_v1`
+3. **订阅方式** — 选择「使用长连接接收事件/回调」
+4. **权限** — 开通 `im:message`、`im:message:send_as_bot`、`im:chat`
+5. **发布应用**
+
+### 4. 使用
+
+```typescript
+import { createFeishuService } from 'cursor-feishu'
+
+const service = await createFeishuService({
+  onMessage: async (msgCtx) => {
+    console.log(`收到消息: ${msgCtx.content}`)
+    // 调用 cursor-agent 处理消息
+    // const result = await execCursor(msgCtx.content)
+    // 发送结果回飞书
+    // await service.getSender().sendText(msgCtx.chatId, result)
+  },
+  onBotAdded: async (chatId) => {
+    console.log(`Bot 已加入群聊: ${chatId}`)
+  }
+})
+
+await service.run()
+```
+
+## API 文档
+
+### `createFeishuService(options)`
+
+创建飞书服务实例。
+
+**参数**：
+
+```typescript
+interface FeishuServiceOptions {
+  /** 飞书配置，可从 ~/.config/cursor/plugins/feishu.json 自动加载 */
+  config?: Partial<ResolvedConfig>
+  /** 消息处理回调 */
+  onMessage?: (msgCtx: FeishuMessageContext) => Promise<void>
+  /** Bot 入群回调 */
+  onBotAdded?: (chatId: string) => Promise<void>
+  /** 卡片交互回调 */
+  onCardAction?: (action: any) => Promise<void>
+  /** 自定义日志函数 */
+  log?: LogFn
+}
+```
+
+**返回**：
+
+```typescript
+interface FeishuService {
+  run: () => Promise<void>           // 启动并运行服务
+  shutdown: () => Promise<void>      // 关闭服务
+  getSender: () => FeishuSender      // 获取消息发送器
+  getClient: () => LarkClient        // 获取 Lark SDK 客户端
+}
+```
+
+### `FeishuMessageContext`
+
+收到的消息上下文：
+
+```typescript
+interface FeishuMessageContext {
+  chatId: string           // 聊天 ID
+  messageId: string        // 消息 ID
+  messageType: string      // 消息类型（text, image, file 等）
+  content: string          // 提取的文本内容
+  rawContent: string       // 原始 JSON content
+  chatType: "p2p" | "group"  // 聊天类型
+  senderId: string         // 发送者 ID
+  rootId?: string          // 回复的消息 ID
+  createTime?: string      // 消息创建时间
+  shouldReply: boolean     // 是否需要回复
+}
+```
+
+### `FeishuSender`
+
+消息发送器：
+
+```typescript
+class FeishuSender {
+  // 发送文本消息
+  sendText(chatId: string, text: string): Promise<boolean>
+
+  // 发送富文本卡片
+  sendCard(chatId: string, card: any): Promise<boolean>
+
+  // 更新消息（用于流式响应）
+  updateMessage(messageId: string, text: string): Promise<boolean>
+}
+```
+
+## 配置说明
+
+完整配置字段（`~/.config/cursor/plugins/feishu.json`）：
+
+| 字段 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|:----:|--------|------|
+| `appId` | string | ✅ | — | 飞书应用 App ID |
+| `appSecret` | string | ✅ | — | 飞书应用 App Secret |
+| `timeout` | number | ❌ | `120000` | AI 响应超时（毫秒） |
+| `logLevel` | string | ❌ | `"info"` | 日志级别：fatal/error/warn/info/debug/trace |
+| `maxHistoryMessages` | number | ❌ | `200` | 入群时拉取历史消息的最大条数 |
+| `pollInterval` | number | ❌ | `1000` | 轮询响应的间隔（毫秒） |
+| `stablePolls` | number | ❌ | `3` | 连续几次轮询内容不变视为回复完成 |
+| `dedupTtl` | number | ❌ | `600000` | 消息去重缓存过期时间（毫秒） |
+| `directory` | string | ❌ | `""` | 默认工作目录，支持 `~` 和 `${ENV_VAR}` 展开 |
+
+## 群聊行为
+
+| 场景 | 接收消息 | 回复 |
+|------|:---:|:---:|
+| 单聊 | ✅ | ✅ |
+| 群聊 + @bot | ✅ | ✅ |
+| 群聊未 @bot | ✅ (静默) | ❌ |
+| bot 入群 | ✅ (历史) | ❌ |
+
+## 环境变量
+
+```bash
+# 启用调试日志（结构化 JSON 输出到 stderr）
+FEISHU_DEBUG=1
+
+# Feishu 应用凭证（如配置文件中使用 ${VAR} 占位符）
+FEISHU_APP_ID=cli_xxxxxxxxxxxx
+FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# HTTP/HTTPS 代理支持
+HTTP_PROXY=http://proxy.company.com:8080
+HTTPS_PROXY=http://proxy.company.com:8080
+```
+
+## 开发
+
+```bash
+npm install           # 安装依赖
+npm run build         # 构建
+npm run dev           # 开发模式（监听变更）
+npm run typecheck     # 类型检查
+npm run release       # 交互式版本发布
+npm publish           # 发布到 npm
+```
+
+## 项目结构
+
+```
+src/
+├── index.ts           # 主入口，导出 createFeishuService
+├── types.ts           # 类型定义
+├── feishu/
+│   ├── gateway.ts     # WebSocket 网关，连接飞书
+│   └── sender.ts      # 消息发送器
+```
+
+## 常见问题
+
+### Q: 消息无法接收？
+
+检查以下几点：
+
+1. 飞书应用凭证是否正确（在飞书开放平台验证）
+2. 是否订阅了 `im.message.receive_v1` 事件
+3. 是否使用「长连接」方式（不是 Webhook）
+4. 查看调试日志：`FEISHU_DEBUG=1 node app.js 2>&1 | grep error`
+
+### Q: 群聊消息无法回复？
+
+群聊中必须 @bot，否则消息只会静默监听。这是设计行为，可以避免 bot 过度回复。
+
+### Q: 如何支持代理？
+
+设置环境变量即可：
+
+```bash
+HTTP_PROXY=http://proxy:8080 npm start
+```
+
+### Q: 如何与 cursor-agent 容器集成？
+
+在 Dockerfile 中安装 cursor-feishu，然后启动一个长期运行的 Node.js 服务来处理飞书消息，再调用 cursor-agent 容器执行任务。
+
+示例见 `cursor-agent` 仓库的 `docs/feishu/` 目录。
+
+## 许可证
+
+MIT
+
+## 相关项目
+
+- [opencode-feishu](https://github.com/NeverMore93/opencode-feishu) — OpenCode 飞书插件（原型）
+- [cursor-agent](https://github.com/NeverMore93/cursor-agent) — Cursor Headless CLI 容器化解决方案
+- [Feishu SDK](https://open.feishu.cn/document) — 飞书官方文档

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+import * as Lark from '@larksuiteoapi/node-sdk';
+import { z } from 'zod';
+
+/**
+ * 飞书消息上下文
+ */
+interface FeishuMessageContext {
+    chatId: string;
+    messageId: string;
+    messageType: string;
+    /** 提取后的文本内容 */
+    content: string;
+    /** 原始 JSON content 字符串 */
+    rawContent: string;
+    chatType: "p2p" | "group";
+    senderId: string;
+    rootId?: string;
+    /** 消息创建时间 */
+    createTime?: string;
+    /** 是否需要回复 */
+    shouldReply: boolean;
+}
+declare const FeishuConfigSchema: z.ZodObject<{
+    appId: z.ZodString;
+    appSecret: z.ZodString;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        fatal: "fatal";
+        warn: "warn";
+        info: "info";
+        debug: "debug";
+        trace: "trace";
+    }>>;
+    maxHistoryMessages: z.ZodDefault<z.ZodNumber>;
+    pollInterval: z.ZodDefault<z.ZodNumber>;
+    stablePolls: z.ZodDefault<z.ZodNumber>;
+    dedupTtl: z.ZodDefault<z.ZodNumber>;
+    directory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * 合并默认值后的完整配置
+ */
+type ResolvedConfig = z.infer<typeof FeishuConfigSchema> & {
+    directory: string;
+};
+/**
+ * 日志函数签名
+ */
+type LogFn = (level: "info" | "warn" | "error", message: string, extra?: Record<string, unknown>) => void;
+/**
+ * 网关回调处理器
+ */
+interface GatewayHandlers {
+    onMessage?: (msgCtx: FeishuMessageContext) => Promise<void>;
+    onBotAdded?: (chatId: string) => Promise<void>;
+    onCardAction?: (action: CardAction) => Promise<void>;
+}
+/**
+ * 卡片交互动作
+ */
+interface CardAction {
+    actionId: string;
+    messageId: string;
+    chatId: string;
+    senderId: string;
+    actionValue: Record<string, unknown>;
+}
+
+/**
+ * 飞书消息发送 — 向飞书用户/群组发送消息
+ */
+
+declare class FeishuSender {
+    private larkClient;
+    private log;
+    constructor(larkClient: InstanceType<typeof Lark.Client>, log: LogFn);
+    /**
+     * 发送文本消息
+     */
+    sendText(chatId: string, text: string): Promise<boolean>;
+    /**
+     * 发送富文本卡片
+     */
+    sendCard(chatId: string, card: any): Promise<boolean>;
+    /**
+     * 更新消息（用于流式响应）
+     */
+    updateMessage(messageId: string, text: string): Promise<boolean>;
+}
+declare function createSender(larkClient: InstanceType<typeof Lark.Client>, log: LogFn): FeishuSender;
+
+/**
+ * Feishu WebSocket 网关 — 与飞书建立长连接，接收事件
+ */
+
+/**
+ * 类型增强：为 Lark SDK 添加缺失的类型定义
+ */
+declare module "@larksuiteoapi/node-sdk" {
+    const im: any;
+}
+interface FeishuGatewayResult {
+    shutdown: () => Promise<void>;
+}
+interface GatewayOptions {
+    config: ResolvedConfig;
+    larkClient: InstanceType<typeof Lark.Client>;
+    botOpenId: string;
+    handlers: GatewayHandlers;
+    log: LogFn;
+}
+/**
+ * 启动飞书 WebSocket 网关
+ */
+declare function startFeishuGateway(options: GatewayOptions): Promise<FeishuGatewayResult>;
+
+/**
+ * Cursor 飞书集成主模块
+ *
+ * 使用方式：
+ * ```typescript
+ * import { createFeishuService } from 'cursor-feishu'
+ *
+ * const service = await createFeishuService({
+ *   config: { appId: '...', appSecret: '...' },
+ *   onMessage: async (msg) => {
+ *     // 处理消息
+ *   }
+ * })
+ *
+ * // 等待服务运行
+ * await service.run()
+ * ```
+ */
+
+interface FeishuServiceOptions {
+    /** 飞书配置，可从 ~/.config/cursor/plugins/feishu.json 自动加载 */
+    config?: Partial<ResolvedConfig>;
+    /** 消息处理回调 */
+    onMessage?: (msgCtx: FeishuMessageContext) => Promise<void>;
+    /** Bot 入群回调 */
+    onBotAdded?: (chatId: string) => Promise<void>;
+    /** 卡片交互回调 */
+    onCardAction?: (action: any) => Promise<void>;
+    /** 自定义日志函数 */
+    log?: LogFn;
+}
+interface FeishuService {
+    /** 启动并运行服务 */
+    run: () => Promise<void>;
+    /** 关闭服务 */
+    shutdown: () => Promise<void>;
+    /** 获取 Feishu 消息发送器 */
+    getSender: () => FeishuSender;
+    /** 获取 Lark SDK 客户端 */
+    getClient: () => InstanceType<typeof Lark.Client>;
+}
+/**
+ * 创建 Cursor 飞书集成服务
+ */
+declare function createFeishuService(options: FeishuServiceOptions): Promise<FeishuService>;
+
+export { type FeishuMessageContext, type FeishuService, type FeishuServiceOptions, type LogFn, type ResolvedConfig, createFeishuService, createSender, startFeishuGateway };

package/dist/index.js

@@ -0,0 +1,368 @@
+// src/index.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import * as Lark2 from "@larksuiteoapi/node-sdk";
+import { z as z2 } from "zod";
+
+// src/types.ts
+import { z } from "zod";
+var AutoPromptSchema = z.object({
+  enabled: z.boolean().default(false),
+  intervalSeconds: z.number().int().positive().max(300).default(30),
+  maxIterations: z.number().int().positive().max(100).default(10),
+  message: z.string().min(1).default("\u8BF7\u540C\u6B65\u5F53\u524D\u8FDB\u5EA6\uFF0C\u5982\u9700\u5E2E\u52A9\u8BF7\u8BF4\u660E")
+});
+var FeishuConfigSchema = z.object({
+  appId: z.string().min(1, "appId \u4E0D\u80FD\u4E3A\u7A7A"),
+  appSecret: z.string().min(1, "appSecret \u4E0D\u80FD\u4E3A\u7A7A"),
+  timeout: z.number().int().positive().max(6e5).default(12e4),
+  logLevel: z.enum(["fatal", "error", "warn", "info", "debug", "trace"]).default("info"),
+  maxHistoryMessages: z.number().int().positive().max(500).default(200),
+  pollInterval: z.number().int().positive().default(1e3),
+  stablePolls: z.number().int().positive().default(3),
+  dedupTtl: z.number().int().positive().default(10 * 60 * 1e3),
+  directory: z.string().optional()
+});
+
+// src/feishu/gateway.ts
+import * as Lark from "@larksuiteoapi/node-sdk";
+async function startFeishuGateway(options) {
+  const { config, larkClient, botOpenId, handlers, log } = options;
+  log("info", "\u542F\u52A8\u98DE\u4E66 WebSocket \u7F51\u5173");
+  const ws = new Lark.EventDispatcher({});
+  ws.addEventListener(Lark.im.MessageReceive.v1, async (data) => {
+    try {
+      const event = data.detail.event;
+      const message = event.message;
+      const msgCtx = {
+        chatId: event.chat_id,
+        messageId: message.message_id,
+        messageType: message.message_type,
+        content: extractTextContent(message),
+        rawContent: message.content || "{}",
+        chatType: event.chat_type,
+        senderId: event.sender.sender_id.user_id || event.sender.sender_id.open_id || "",
+        rootId: message.root_id,
+        createTime: message.create_time,
+        shouldReply: shouldReply(event, botOpenId)
+      };
+      if (handlers.onMessage) {
+        await handlers.onMessage(msgCtx);
+      }
+    } catch (err) {
+      log("error", "\u5904\u7406\u6D88\u606F\u4E8B\u4EF6\u5931\u8D25", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  });
+  ws.addEventListener(Lark.im.ChatMemberBotAdded.v1, async (data) => {
+    try {
+      const chatId = data.detail.event.chat_id;
+      if (handlers.onBotAdded) {
+        await handlers.onBotAdded(chatId);
+      }
+    } catch (err) {
+      log("error", "\u5904\u7406 bot \u5165\u7FA4\u4E8B\u4EF6\u5931\u8D25", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  });
+  await larkClient.startEventDispatcher(ws);
+  log("info", "\u98DE\u4E66 WebSocket \u7F51\u5173\u5DF2\u542F\u52A8");
+  return {
+    shutdown: async () => {
+      log("info", "\u5173\u95ED\u98DE\u4E66 WebSocket \u7F51\u5173");
+      await larkClient.stopEventDispatcher(ws);
+    }
+  };
+}
+function extractTextContent(message) {
+  try {
+    if (message.message_type === "text") {
+      const content = JSON.parse(message.content || "{}");
+      return content.text || "";
+    }
+  } catch {
+  }
+  return "";
+}
+function shouldReply(event, botOpenId) {
+  if (event.chat_type === "p2p") {
+    return true;
+  }
+  const message = event.message;
+  if (message.message_type === "text") {
+    try {
+      const content = JSON.parse(message.content || "{}");
+      const text = content.text || "";
+      return text.includes(`<at user_id="${botOpenId}">`) || text.includes(`<at open_id="${botOpenId}">`);
+    } catch {
+    }
+  }
+  return false;
+}
+
+// src/feishu/sender.ts
+var FeishuSender = class {
+  constructor(larkClient, log) {
+    this.larkClient = larkClient;
+    this.log = log;
+  }
+  /**
+   * 发送文本消息
+   */
+  async sendText(chatId, text) {
+    try {
+      const res = await this.larkClient.im.message.create({
+        params: {
+          receive_id_type: "chat_id"
+        },
+        data: {
+          receive_id: chatId,
+          msg_type: "text",
+          content: JSON.stringify({ text })
+        }
+      });
+      const messageId = res?.data?.message_id;
+      if (messageId) {
+        this.log("info", "\u6D88\u606F\u5DF2\u53D1\u9001", { chatId, messageId });
+        return true;
+      } else {
+        this.log("error", "\u53D1\u9001\u6D88\u606F\u5931\u8D25", { chatId, response: res });
+        return false;
+      }
+    } catch (err) {
+      this.log("error", "\u53D1\u9001\u6D88\u606F\u5F02\u5E38", {
+        chatId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return false;
+    }
+  }
+  /**
+   * 发送富文本卡片
+   */
+  async sendCard(chatId, card) {
+    try {
+      const res = await this.larkClient.im.message.create({
+        params: {
+          receive_id_type: "chat_id"
+        },
+        data: {
+          receive_id: chatId,
+          msg_type: "interactive",
+          card
+        }
+      });
+      const messageId = res?.data?.message_id;
+      if (messageId) {
+        this.log("info", "\u5361\u7247\u5DF2\u53D1\u9001", { chatId, messageId });
+        return true;
+      } else {
+        this.log("error", "\u53D1\u9001\u5361\u7247\u5931\u8D25", { chatId, response: res });
+        return false;
+      }
+    } catch (err) {
+      this.log("error", "\u53D1\u9001\u5361\u7247\u5F02\u5E38", {
+        chatId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return false;
+    }
+  }
+  /**
+   * 更新消息（用于流式响应）
+   */
+  async updateMessage(messageId, text) {
+    try {
+      await this.larkClient.im.message.patch({
+        path: {
+          message_id: messageId
+        },
+        data: {
+          content: JSON.stringify({ text })
+        }
+      });
+      this.log("info", "\u6D88\u606F\u5DF2\u66F4\u65B0", { messageId });
+      return true;
+    } catch (err) {
+      this.log("error", "\u66F4\u65B0\u6D88\u606F\u5F02\u5E38", {
+        messageId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      return false;
+    }
+  }
+};
+function createSender(larkClient, log) {
+  return new FeishuSender(larkClient, log);
+}
+
+// src/index.ts
+var SERVICE_NAME = "cursor-feishu";
+var LOG_PREFIX = "[feishu]";
+var isDebug = !!process.env.FEISHU_DEBUG;
+async function createFeishuService(options) {
+  const { config: partialConfig, onMessage, onBotAdded, onCardAction, log: customLog } = options;
+  const log = customLog || ((level, message, extra) => {
+    const prefixed = `${LOG_PREFIX} ${message}`;
+    if (isDebug) {
+      console.error(JSON.stringify({
+        ts: (/* @__PURE__ */ new Date()).toISOString(),
+        service: SERVICE_NAME,
+        level,
+        message: prefixed,
+        ...extra
+      }));
+    } else if (level === "error" || level === "warn") {
+      console.error(prefixed, extra || "");
+    } else {
+      console.log(prefixed, extra || "");
+    }
+  });
+  const config = await loadConfig(partialConfig, log);
+  const larkClient = new Lark2.Client({
+    appId: config.appId,
+    appSecret: config.appSecret,
+    domain: Lark2.Domain.Feishu,
+    appType: Lark2.AppType.SelfBuild
+  });
+  const botOpenId = await fetchBotOpenId(larkClient, log);
+  const sender = createSender(larkClient, log);
+  let gateway = null;
+  const handlers = {
+    onMessage,
+    onBotAdded,
+    onCardAction
+  };
+  log("info", "\u98DE\u4E66\u670D\u52A1\u5DF2\u521D\u59CB\u5316", {
+    appId: config.appId.slice(0, 8) + "...",
+    botOpenId
+  });
+  return {
+    async run() {
+      try {
+        gateway = await startFeishuGateway({
+          config,
+          larkClient,
+          botOpenId,
+          handlers,
+          log
+        });
+        log("info", "\u98DE\u4E66\u670D\u52A1\u5DF2\u542F\u52A8");
+        await new Promise(() => {
+        });
+      } catch (err) {
+        log("error", "\u542F\u52A8\u98DE\u4E66\u670D\u52A1\u5931\u8D25", {
+          error: err instanceof Error ? err.message : String(err)
+        });
+        throw err;
+      }
+    },
+    async shutdown() {
+      if (gateway) {
+        await gateway.shutdown();
+      }
+      log("info", "\u98DE\u4E66\u670D\u52A1\u5DF2\u5173\u95ED");
+    },
+    getSender() {
+      return sender;
+    },
+    getClient() {
+      return larkClient;
+    }
+  };
+}
+async function loadConfig(partialConfig, log) {
+  if (partialConfig && partialConfig.appId && partialConfig.appSecret) {
+    const config = FeishuConfigSchema.parse({
+      appId: partialConfig.appId,
+      appSecret: partialConfig.appSecret,
+      ...partialConfig
+    });
+    return {
+      ...config,
+      directory: expandDirectoryPath(partialConfig.directory || "")
+    };
+  }
+  const configPath = join(homedir(), ".config", "cursor", "plugins", "feishu.json");
+  if (!existsSync(configPath)) {
+    throw new Error(
+      `\u7F3A\u5C11\u98DE\u4E66\u914D\u7F6E\u6587\u4EF6\uFF1A\u8BF7\u521B\u5EFA ${configPath}\uFF0C\u5185\u5BB9\u4E3A {"appId":"cli_xxx","appSecret":"xxx"}`
+    );
+  }
+  try {
+    const raw = resolveEnvPlaceholders(JSON.parse(readFileSync(configPath, "utf-8")));
+    const config = FeishuConfigSchema.parse(raw);
+    return {
+      ...config,
+      directory: expandDirectoryPath(config.directory || "")
+    };
+  } catch (err) {
+    if (err instanceof z2.ZodError) {
+      const details = err.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+      throw new Error(`${LOG_PREFIX} \u914D\u7F6E\u9A8C\u8BC1\u5931\u8D25:
+${details}`);
+    }
+    if (err instanceof SyntaxError) {
+      throw new Error(`\u98DE\u4E66\u914D\u7F6E\u6587\u4EF6\u683C\u5F0F\u9519\u8BEF\uFF1A${configPath} \u5FC5\u987B\u662F\u5408\u6CD5\u7684 JSON (${err.message})`);
+    }
+    throw err;
+  }
+}
+function expandDirectoryPath(dir) {
+  if (!dir) return dir;
+  if (dir.startsWith("~")) {
+    dir = join(homedir(), dir.slice(1));
+  }
+  dir = dir.replace(/\$\{(\w+)\}/g, (_match, name) => {
+    const val = process.env[name];
+    if (val === void 0) {
+      throw new Error(`\u73AF\u5883\u53D8\u91CF ${name} \u672A\u8BBE\u7F6E\uFF08directory \u5F15\u7528\u4E86 \${${name}}\uFF09`);
+    }
+    return val;
+  });
+  return dir;
+}
+function resolveEnvPlaceholders(obj) {
+  if (typeof obj === "string") {
+    if (!obj.includes("${")) return obj;
+    return obj.replace(/\$\{(\w+)\}/g, (_match, name) => {
+      const val = process.env[name];
+      if (val === void 0) {
+        throw new Error(`\u73AF\u5883\u53D8\u91CF ${name} \u672A\u8BBE\u7F6E\uFF08\u914D\u7F6E\u503C\u5F15\u7528\u4E86 \${${name}}\uFF09`);
+      }
+      return val;
+    });
+  }
+  if (Array.isArray(obj)) {
+    return obj.map(resolveEnvPlaceholders);
+  }
+  if (obj !== null && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[key] = resolveEnvPlaceholders(value);
+    }
+    return result;
+  }
+  return obj;
+}
+async function fetchBotOpenId(larkClient, log) {
+  const res = await larkClient.request({
+    url: "https://open.feishu.cn/open-apis/bot/v3/info",
+    method: "GET"
+  });
+  const openId = res?.bot?.open_id;
+  if (!openId) {
+    throw new Error("Bot open_id \u4E3A\u7A7A\uFF0C\u65E0\u6CD5\u542F\u52A8\u98DE\u4E66\u670D\u52A1");
+  }
+  log("info", "Bot open_id \u83B7\u53D6\u6210\u529F", { openId });
+  return openId;
+}
+export {
+  createFeishuService,
+  createSender,
+  startFeishuGateway
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/feishu/gateway.ts","../src/feishu/sender.ts"],"sourcesContent":["/**\n * Cursor 飞书集成主模块\n *\n * 使用方式：\n * ```typescript\n * import { createFeishuService } from 'cursor-feishu'\n *\n * const service = await createFeishuService({\n *   config: { appId: '...', appSecret: '...' },\n *   onMessage: async (msg) => {\n *     // 处理消息\n *   }\n * })\n *\n * // 等待服务运行\n * await service.run()\n * ```\n */\n\nimport { readFileSync, existsSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { homedir } from \"node:os\"\nimport * as Lark from \"@larksuiteoapi/node-sdk\"\nimport { z } from \"zod\"\nimport type { ResolvedConfig, LogFn, FeishuMessageContext, GatewayHandlers } from \"./types.js\"\nimport { FeishuConfigSchema } from \"./types.js\"\nimport { startFeishuGateway, type FeishuGatewayResult } from \"./feishu/gateway.js\"\nimport { createSender, type FeishuSender } from \"./feishu/sender.js\"\n\nconst SERVICE_NAME = \"cursor-feishu\"\nconst LOG_PREFIX = \"[feishu]\"\nconst isDebug = !!process.env.FEISHU_DEBUG\n\nexport interface FeishuServiceOptions {\n  /** 飞书配置，可从 ~/.config/cursor/plugins/feishu.json 自动加载 */\n  config?: Partial<ResolvedConfig>\n  /** 消息处理回调 */\n  onMessage?: (msgCtx: FeishuMessageContext) => Promise<void>\n  /** Bot 入群回调 */\n  onBotAdded?: (chatId: string) => Promise<void>\n  /** 卡片交互回调 */\n  onCardAction?: (action: any) => Promise<void>\n  /** 自定义日志函数 */\n  log?: LogFn\n}\n\nexport interface FeishuService {\n  /** 启动并运行服务 */\n  run: () => Promise<void>\n  /** 关闭服务 */\n  shutdown: () => Promise<void>\n  /** 获取 Feishu 消息发送器 */\n  getSender: () => FeishuSender\n  /** 获取 Lark SDK 客户端 */\n  getClient: () => InstanceType<typeof Lark.Client>\n}\n\n/**\n * 创建 Cursor 飞书集成服务\n */\nexport async function createFeishuService(options: FeishuServiceOptions): Promise<FeishuService> {\n  const { config: partialConfig, onMessage, onBotAdded, onCardAction, log: customLog } = options\n\n  // 日志函数\n  const log: LogFn = customLog || ((level, message, extra) => {\n    const prefixed = `${LOG_PREFIX} ${message}`\n    if (isDebug) {\n      console.error(JSON.stringify({\n        ts: new Date().toISOString(),\n        service: SERVICE_NAME,\n        level,\n        message: prefixed,\n        ...extra,\n      }))\n    } else if (level === \"error\" || level === \"warn\") {\n      console.error(prefixed, extra || \"\")\n    } else {\n      console.log(prefixed, extra || \"\")\n    }\n  })\n\n  // 加载配置\n  const config = await loadConfig(partialConfig, log)\n\n  // 创建 Lark 客户端\n  const larkClient = new Lark.Client({\n    appId: config.appId,\n    appSecret: config.appSecret,\n    domain: Lark.Domain.Feishu,\n    appType: Lark.AppType.SelfBuild,\n  })\n\n  // 获取 bot open_id\n  const botOpenId = await fetchBotOpenId(larkClient, log)\n\n  // 创建消息发送器\n  const sender = createSender(larkClient, log)\n\n  // 网关\n  let gateway: FeishuGatewayResult | null = null\n\n  // 创建处理器\n  const handlers: GatewayHandlers = {\n    onMessage,\n    onBotAdded,\n    onCardAction,\n  }\n\n  log(\"info\", \"飞书服务已初始化\", {\n    appId: config.appId.slice(0, 8) + \"...\",\n    botOpenId,\n  })\n\n  return {\n    async run() {\n      try {\n        gateway = await startFeishuGateway({\n          config,\n          larkClient,\n          botOpenId,\n          handlers,\n          log,\n        })\n        log(\"info\", \"飞书服务已启动\")\n        // 保持运行\n        await new Promise(() => {})\n      } catch (err) {\n        log(\"error\", \"启动飞书服务失败\", {\n          error: err instanceof Error ? err.message : String(err),\n        })\n        throw err\n      }\n    },\n\n    async shutdown() {\n      if (gateway) {\n        await gateway.shutdown()\n      }\n      log(\"info\", \"飞书服务已关闭\")\n    },\n\n    getSender() {\n      return sender\n    },\n\n    getClient() {\n      return larkClient\n    },\n  }\n}\n\n/**\n * 加载配置\n */\nasync function loadConfig(\n  partialConfig: Partial<ResolvedConfig> | undefined,\n  log: LogFn,\n): Promise<ResolvedConfig> {\n  if (partialConfig && partialConfig.appId && partialConfig.appSecret) {\n    // 使用传入的配置\n    const config = FeishuConfigSchema.parse({\n      appId: partialConfig.appId,\n      appSecret: partialConfig.appSecret,\n      ...partialConfig,\n    })\n    return {\n      ...config,\n      directory: expandDirectoryPath(partialConfig.directory || \"\"),\n    }\n  }\n\n  // 从配置文件加载\n  const configPath = join(homedir(), \".config\", \"cursor\", \"plugins\", \"feishu.json\")\n  if (!existsSync(configPath)) {\n    throw new Error(\n      `缺少飞书配置文件：请创建 ${configPath}，内容为 {\"appId\":\"cli_xxx\",\"appSecret\":\"xxx\"}`,\n    )\n  }\n\n  try {\n    const raw = resolveEnvPlaceholders(JSON.parse(readFileSync(configPath, \"utf-8\")))\n    const config = FeishuConfigSchema.parse(raw)\n    return {\n      ...config,\n      directory: expandDirectoryPath(config.directory || \"\"),\n    }\n  } catch (err) {\n    if (err instanceof z.ZodError) {\n      const details = err.issues.map((i) => `  - ${i.path.join(\".\")}: ${i.message}`).join(\"\\n\")\n      throw new Error(`${LOG_PREFIX} 配置验证失败:\\n${details}`)\n    }\n    if (err instanceof SyntaxError) {\n      throw new Error(`飞书配置文件格式错误：${configPath} 必须是合法的 JSON (${err.message})`)\n    }\n    throw err\n  }\n}\n\n/**\n * 展开目录路径中的环境变量和 ~ 前缀\n */\nfunction expandDirectoryPath(dir: string): string {\n  if (!dir) return dir\n  if (dir.startsWith(\"~\")) {\n    dir = join(homedir(), dir.slice(1))\n  }\n  dir = dir.replace(/\\$\\{(\\w+)\\}/g, (_match, name: string) => {\n    const val = process.env[name]\n    if (val === undefined) {\n      throw new Error(`环境变量 ${name} 未设置（directory 引用了 \\${${name}}）`)\n    }\n    return val\n  })\n  return dir\n}\n\n/**\n * 递归替换对象中字符串值里的 ${ENV_VAR} 占位符\n */\nfunction resolveEnvPlaceholders(obj: unknown): unknown {\n  if (typeof obj === \"string\") {\n    if (!obj.includes(\"${\")) return obj\n    return obj.replace(/\\$\\{(\\w+)\\}/g, (_match, name: string) => {\n      const val = process.env[name]\n      if (val === undefined) {\n        throw new Error(`环境变量 ${name} 未设置（配置值引用了 \\${${name}}）`)\n      }\n      return val\n    })\n  }\n  if (Array.isArray(obj)) {\n    return obj.map(resolveEnvPlaceholders)\n  }\n  if (obj !== null && typeof obj === \"object\") {\n    const result: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {\n      result[key] = resolveEnvPlaceholders(value)\n    }\n    return result\n  }\n  return obj\n}\n\n/**\n * 获取 bot 自身的 open_id\n */\nasync function fetchBotOpenId(\n  larkClient: InstanceType<typeof Lark.Client>,\n  log: LogFn,\n): Promise<string> {\n  const res = await larkClient.request<{ bot?: { open_id?: string } }>({\n    url: \"https://open.feishu.cn/open-apis/bot/v3/info\",\n    method: \"GET\",\n  })\n  const openId = res?.bot?.open_id\n  if (!openId) {\n    throw new Error(\"Bot open_id 为空，无法启动飞书服务\")\n  }\n  log(\"info\", \"Bot open_id 获取成功\", { openId })\n  return openId\n}\n\nexport type { ResolvedConfig, LogFn, FeishuMessageContext } from \"./types.js\"\nexport { startFeishuGateway } from \"./feishu/gateway.js\"\nexport { createSender } from \"./feishu/sender.js\"\n","import { z } from \"zod\"\n\n/**\n * 飞书消息上下文\n */\nexport interface FeishuMessageContext {\n  chatId: string\n  messageId: string\n  messageType: string\n  /** 提取后的文本内容 */\n  content: string\n  /** 原始 JSON content 字符串 */\n  rawContent: string\n  chatType: \"p2p\" | \"group\"\n  senderId: string\n  rootId?: string\n  /** 消息创建时间 */\n  createTime?: string\n  /** 是否需要回复 */\n  shouldReply: boolean\n}\n\n/**\n * 插件配置（从 ~/.config/cursor/plugins/feishu.json 读取）\n */\nexport interface FeishuPluginConfig {\n  appId: string\n  appSecret: string\n  timeout?: number\n  logLevel?: \"fatal\" | \"error\" | \"warn\" | \"info\" | \"debug\" | \"trace\"\n  /** 入群时拉取历史消息的最大条数 */\n  maxHistoryMessages?: number\n  /** 轮询响应的间隔毫秒数 */\n  pollInterval?: number\n  /** 连续几次轮询内容不变视为回复完成 */\n  stablePolls?: number\n  /** 消息去重缓存过期毫秒数 */\n  dedupTtl?: number\n  /** 默认工作目录 */\n  directory?: string\n}\n\nconst AutoPromptSchema = z.object({\n  enabled: z.boolean().default(false),\n  intervalSeconds: z.number().int().positive().max(300).default(30),\n  maxIterations: z.number().int().positive().max(100).default(10),\n  message: z.string().min(1).default(\"请同步当前进度，如需帮助请说明\"),\n})\n\nexport const FeishuConfigSchema = z.object({\n  appId: z.string().min(1, \"appId 不能为空\"),\n  appSecret: z.string().min(1, \"appSecret 不能为空\"),\n  timeout: z.number().int().positive().max(600_000).default(120_000),\n  logLevel: z.enum([\"fatal\", \"error\", \"warn\", \"info\", \"debug\", \"trace\"]).default(\"info\"),\n  maxHistoryMessages: z.number().int().positive().max(500).default(200),\n  pollInterval: z.number().int().positive().default(1_000),\n  stablePolls: z.number().int().positive().default(3),\n  dedupTtl: z.number().int().positive().default(10 * 60 * 1_000),\n  directory: z.string().optional(),\n})\n\n/**\n * 合并默认值后的完整配置\n */\nexport type ResolvedConfig = z.infer<typeof FeishuConfigSchema> & { directory: string }\n\n/**\n * 日志函数签名\n */\nexport type LogFn = (\n  level: \"info\" | \"warn\" | \"error\",\n  message: string,\n  extra?: Record<string, unknown>,\n) => void\n\n/**\n * 网关回调处理器\n */\nexport interface GatewayHandlers {\n  onMessage?: (msgCtx: FeishuMessageContext) => Promise<void>\n  onBotAdded?: (chatId: string) => Promise<void>\n  onCardAction?: (action: CardAction) => Promise<void>\n}\n\n/**\n * 卡片交互动作\n */\nexport interface CardAction {\n  actionId: string\n  messageId: string\n  chatId: string\n  senderId: string\n  actionValue: Record<string, unknown>\n}\n","/**\n * Feishu WebSocket 网关 — 与飞书建立长连接，接收事件\n */\n\nimport * as Lark from \"@larksuiteoapi/node-sdk\"\nimport type { ResolvedConfig, FeishuMessageContext, LogFn, CardAction, GatewayHandlers } from \"../types.js\"\n\n/**\n * 类型增强：为 Lark SDK 添加缺失的类型定义\n */\ndeclare module \"@larksuiteoapi/node-sdk\" {\n  export const im: any\n}\n\nexport interface FeishuGatewayResult {\n  shutdown: () => Promise<void>\n}\n\nexport interface GatewayOptions {\n  config: ResolvedConfig\n  larkClient: InstanceType<typeof Lark.Client>\n  botOpenId: string\n  handlers: GatewayHandlers\n  log: LogFn\n}\n\n/**\n * 启动飞书 WebSocket 网关\n */\nexport async function startFeishuGateway(options: GatewayOptions): Promise<FeishuGatewayResult> {\n  const { config, larkClient, botOpenId, handlers, log } = options\n\n  log(\"info\", \"启动飞书 WebSocket 网关\")\n\n  // 创建 WebSocket 客户端连接到飞书\n  const ws = new Lark.EventDispatcher({}) as any\n\n  // 注册事件处理器\n  ws.addEventListener((Lark.im as any).MessageReceive.v1, async (data: any) => {\n    try {\n      const event = data.detail.event\n      const message = event.message\n\n      const msgCtx: FeishuMessageContext = {\n        chatId: event.chat_id,\n        messageId: message.message_id,\n        messageType: message.message_type,\n        content: extractTextContent(message),\n        rawContent: message.content || \"{}\",\n        chatType: event.chat_type as \"p2p\" | \"group\",\n        senderId: event.sender.sender_id.user_id || event.sender.sender_id.open_id || \"\",\n        rootId: message.root_id,\n        createTime: message.create_time,\n        shouldReply: shouldReply(event, botOpenId),\n      }\n\n      if (handlers.onMessage) {\n        await handlers.onMessage(msgCtx)\n      }\n    } catch (err) {\n      log(\"error\", \"处理消息事件失败\", {\n        error: err instanceof Error ? err.message : String(err),\n      })\n    }\n  })\n\n  ws.addEventListener((Lark.im as any).ChatMemberBotAdded.v1, async (data: any) => {\n    try {\n      const chatId = data.detail.event.chat_id\n      if (handlers.onBotAdded) {\n        await handlers.onBotAdded(chatId)\n      }\n    } catch (err) {\n      log(\"error\", \"处理 bot 入群事件失败\", {\n        error: err instanceof Error ? err.message : String(err),\n      })\n    }\n  })\n\n  // 启动连接\n  await (larkClient as any).startEventDispatcher(ws)\n\n  log(\"info\", \"飞书 WebSocket 网关已启动\")\n\n  return {\n    shutdown: async () => {\n      log(\"info\", \"关闭飞书 WebSocket 网关\")\n      await (larkClient as any).stopEventDispatcher(ws)\n    },\n  }\n}\n\n/**\n * 从飞书消息中提取文本内容\n */\nfunction extractTextContent(message: any): string {\n  try {\n    if (message.message_type === \"text\") {\n      const content = JSON.parse(message.content || \"{}\")\n      return content.text || \"\"\n    }\n  } catch {\n    // ignore\n  }\n  return \"\"\n}\n\n/**\n * 判断是否应该回复\n */\nfunction shouldReply(event: any, botOpenId: string): boolean {\n  // 单聊总是回复\n  if (event.chat_type === \"p2p\") {\n    return true\n  }\n\n  // 群聊只有被 @提及 才回复\n  const message = event.message\n  if (message.message_type === \"text\") {\n    try {\n      const content = JSON.parse(message.content || \"{}\")\n      const text = content.text || \"\"\n      // 检查是否包含 @bot\n      return text.includes(`<at user_id=\"${botOpenId}\">`) || text.includes(`<at open_id=\"${botOpenId}\">`)\n    } catch {\n      // ignore\n    }\n  }\n\n  return false\n}\n","/**\n * 飞书消息发送 — 向飞书用户/群组发送消息\n */\n\nimport * as Lark from \"@larksuiteoapi/node-sdk\"\nimport type { LogFn } from \"../types.js\"\n\nexport interface SenderOptions {\n  larkClient: InstanceType<typeof Lark.Client>\n  log: LogFn\n}\n\nexport class FeishuSender {\n  constructor(private larkClient: InstanceType<typeof Lark.Client>, private log: LogFn) {}\n\n  /**\n   * 发送文本消息\n   */\n  async sendText(chatId: string, text: string): Promise<boolean> {\n    try {\n      const res = await this.larkClient.im.message.create({\n        params: {\n          receive_id_type: \"chat_id\",\n        },\n        data: {\n          receive_id: chatId,\n          msg_type: \"text\",\n          content: JSON.stringify({ text }),\n        },\n      })\n\n      const messageId = (res as any)?.data?.message_id\n      if (messageId) {\n        this.log(\"info\", \"消息已发送\", { chatId, messageId })\n        return true\n      } else {\n        this.log(\"error\", \"发送消息失败\", { chatId, response: res })\n        return false\n      }\n    } catch (err) {\n      this.log(\"error\", \"发送消息异常\", {\n        chatId,\n        error: err instanceof Error ? err.message : String(err),\n      })\n      return false\n    }\n  }\n\n  /**\n   * 发送富文本卡片\n   */\n  async sendCard(chatId: string, card: any): Promise<boolean> {\n    try {\n      const res = await (this.larkClient.im.message.create as any)({\n        params: {\n          receive_id_type: \"chat_id\",\n        },\n        data: {\n          receive_id: chatId,\n          msg_type: \"interactive\",\n          card,\n        },\n      })\n\n      const messageId = (res as any)?.data?.message_id\n      if (messageId) {\n        this.log(\"info\", \"卡片已发送\", { chatId, messageId })\n        return true\n      } else {\n        this.log(\"error\", \"发送卡片失败\", { chatId, response: res })\n        return false\n      }\n    } catch (err) {\n      this.log(\"error\", \"发送卡片异常\", {\n        chatId,\n        error: err instanceof Error ? err.message : String(err),\n      })\n      return false\n    }\n  }\n\n  /**\n   * 更新消息（用于流式响应）\n   */\n  async updateMessage(messageId: string, text: string): Promise<boolean> {\n    try {\n      await this.larkClient.im.message.patch({\n        path: {\n          message_id: messageId,\n        },\n        data: {\n          content: JSON.stringify({ text }),\n        },\n      })\n\n      this.log(\"info\", \"消息已更新\", { messageId })\n      return true\n    } catch (err) {\n      this.log(\"error\", \"更新消息异常\", {\n        messageId,\n        error: err instanceof Error ? err.message : String(err),\n      })\n      return false\n    }\n  }\n}\n\nexport function createSender(\n  larkClient: InstanceType<typeof Lark.Client>,\n  log: LogFn,\n): FeishuSender {\n  return new FeishuSender(larkClient, log)\n}\n"],"mappings":"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","names":["Lark","z","z"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "cursor-feishu",
+  "version": "1.0.3",
+  "description": "Cursor 飞书集成 — 通过飞书 WebSocket 长连接与 Cursor Headless CLI 交互",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./gateway": {
+      "types": "./dist/feishu/gateway.d.ts",
+      "default": "./dist/feishu/gateway.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run typecheck",
+    "release": "bumpp"
+  },
+  "author": "NeverMore93",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NeverMore93/cursor-feishu"
+  },
+  "homepage": "https://github.com/NeverMore93/cursor-feishu#readme",
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.56.1",
+    "https-proxy-agent": "^7.0.6",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "bumpp": "^10.4.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "cursor",
+    "cursor-cli",
+    "feishu",
+    "lark",
+    "飞书",
+    "飞书机器人",
+    "ai",
+    "chatbot"
+  ],
+  "license": "MIT"
+}