@lixiongwei/n8n-nodes-feishu 1.0.1 → 1.0.2

package/README.md

@@ -1,72 +1,66 @@
-# n8n-nodes-feishu
+# @lixiongwei/n8n-nodes-feishu
 
-> 飞书/Lark 集成节点，免费功能 + Pro License。附带 5 个即用工作流模板。
+> Feishu / Lark integration nodes for n8n. Free tier + Pro License. Includes 5 workflow templates.
 
 ---
 
-## 安装
+## Install
 
 ```bash
 npm install @lixiongwei/n8n-nodes-feishu
 ```
 
-n8n 自托管版直接在 n8n 所在目录执行。云版不支持社区节点。
-
 ---
 
-## 免费功能 🆓
+## Free Features 🆓
 
-| 功能 | 说明 |
-|------|------|
-| **发送文本消息** | 给用户/群发文本消息 |
-| **消息触发器** | 接收飞书事件回调 |
+| Feature | Description |
+|---------|-------------|
+| Send Text Message | Send plain text to users or groups |
+| Webhook Trigger | Receive Feishu event callbacks |
 
 ---
 
-## Pro 功能 ⭐ （需 License Key）
+## Pro Features ⭐ (License Key required)
 
-| 功能 | 说明 |
-|------|------|
-| **发送卡片消息** | 富文本卡片模板 + Markdown |
-| **读取多维表格** | 按字段读取 Bitable 数据 |
-| **写入多维表格** | 写入新行到 Bitable |
-| **获取待审批列表** | 查询审批实例 |
+| Feature | Description |
+|---------|-------------|
+| Send Card Message | Rich interactive cards with Markdown |
+| Read Bitable | Query records from a Bitable |
+| Write to Bitable | Insert new records into a Bitable |
+| Get Pending Approvals | List pending approval instances |
 
 ---
 
-## 获取 License Key
-
-👉 **[在 Gumroad 购买](https://gumroad.com/l/feishu-pro)** — $49 一次性，永久使用。
+## Get a License Key
 
-购买后在凭证管理里填入 Key，Pro 功能即刻解锁。
+👉 **[Buy on Gumroad](https://1717465779306.gumroad.com/l/feishu-pro)** — $49 one-time, lifetime license.
 
 ---
 
-## 附带工作流模板
+## Included Workflow Templates
 
-在 `workflows/` 目录下，导入即用：
+Import from `workflows/`:
 
-| 模板 | 场景 |
-|------|------|
-| `template-01-send-message.json` | Webhook → 飞书消息 |
-| `template-02-cron-reminder.json` | 定时 → 飞书提醒 |
-| `template-03-website-monitor.json` | 网站监控 → 飞书告警 |
-| `template-04-form-notify.json` | 表单提交 → 卡片通知 |
-| `template-05-api-to-feishu.json` | API 数据 → 飞书推送 |
+| Template | Scenario |
+|----------|----------|
+| `template-01-send-message.json` | Webhook → Feishu message |
+| `template-02-cron-reminder.json` | Scheduled → Feishu reminder |
+| `template-03-website-monitor.json` | Website monitor → Feishu alert |
+| `template-04-form-notify.json` | Form submission → Card notification |
+| `template-05-api-to-feishu.json` | API data → Feishu push |
 
 ---
 
-## 飞书应用配置
+## Feishu App Setup
 
-1. 飞书开发者后台创建 **企业自建应用**
-2. 开启 **机器人** 能力
-3. 权限管理开通：`im:message:send_as_bot`
-4. 发布应用
-5. 在 n8n 凭证中填入 App ID + App Secret + License Key
+1. Create an **Enterprise Internal App** at [Feishu Developer Console](https://open.feishu.cn/)
+2. Enable **Bot** capability
+3. Add permissions: `im:message:send_as_bot`
+4. Publish the app
+5. In n8n credentials, fill in App ID + App Secret + License Key
 
 ---
 
-## 版本
-
-- n8n 版本要求：1.x+
-- 飞书 API 版本：v3
+- n8n version: 1.x+
+- Feishu API version: v3

package/credentials/FeishuApi.credentials.js

@@ -4,7 +4,7 @@ exports.FeishuApi = void 0;
 class FeishuApi {
     constructor() {
         this.name = 'feishuApi';
-        this.displayName = '飞书 Feishu API';
+        this.displayName = 'Feishu (Lark) API';
         this.documentationUrl = 'https://open.feishu.cn/document/home/getting-started';
         this.properties = [
             {
@@ -12,7 +12,7 @@ class FeishuApi {
                 name: 'appId',
                 type: 'string',
                 default: '',
-                description: '飞书应用的 App ID（从开发者后台-凭证与基础信息获取）',
+                description: 'Feishu App ID (from Developer Console → Credentials)',
                 required: true,
             },
             {
@@ -21,15 +21,15 @@ class FeishuApi {
                 type: 'string',
                 typeOptions: { password: true },
                 default: '',
-                description: '飞书应用的 App Secret',
+                description: 'Feishu App Secret',
                 required: true,
             },
             {
-                displayName: 'License Key',
+                displayName: 'License Key (optional)',
                 name: 'licenseKey',
                 type: 'string',
                 default: '',
-                description: 'Pro License Key — 从 Gumroad 购买获取。留空则仅使用免费功能',
+                description: 'Pro License Key from Gumroad. Leave empty for free features only. Get one at: https://1717465779306.gumroad.com/l/feishu-pro',
                 required: false,
             },
         ];

package/nodes/Feishu/Feishu.node.js

@@ -6,7 +6,7 @@ const license_1 = require("./license");
 // --- Operation definitions ---
 const FREE_OPERATIONS = ['sendTextMessage'];
 const PRO_OPERATIONS = ['sendCardMessage', 'readBitable', 'writeBitable', 'getApprovals'];
-// --- Token cache (in-memory, per-node lifetime) ---
+// --- Token cache ---
 let cachedToken = null;
 let tokenExpiry = 0;
 async function getFeishuToken(appId, appSecret) {
@@ -21,7 +21,7 @@ async function getFeishuToken(appId, appSecret) {
         json: true,
     });
     if (response.code !== 0) {
-        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `飞书 Token 获取失败：${response.msg} (code: ${response.code})`);
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Feishu token failed: ${response.msg} (code: ${response.code})`);
     }
     cachedToken = response.tenant_access_token;
     tokenExpiry = Date.now() + (response.expire - 300) * 1000;
@@ -31,98 +31,98 @@ async function getFeishuToken(appId, appSecret) {
 class Feishu {
     constructor() {
         this.description = {
-            displayName: '飞书 Feishu',
+            displayName: 'Feishu / Lark',
             name: 'feishu',
             icon: 'file:feishu.svg',
             group: ['transform'],
             version: 1,
             subtitle: '={{ $parameter["operation"] }}',
-            description: '飞书集成：发消息、读多维表格、处理审批',
-            defaults: { name: '飞书 Feishu' },
+            description: 'Feishu/Lark integration: send messages, manage Bitable, process approvals',
+            defaults: { name: 'Feishu / Lark' },
             inputs: ["main"],
             outputs: ["main"],
             credentials: [{ name: 'feishuApi', required: true }],
             properties: [
                 // --- Operation selector ---
                 {
-                    displayName: '操作 Operation',
+                    displayName: 'Operation',
                     name: 'operation',
                     type: 'options',
                     noDataExpression: true,
                     options: [
-                        { name: '🆓 发送文本消息 (免费)', value: 'sendTextMessage' },
-                        { name: '⭐ 发送卡片消息 (Pro)', value: 'sendCardMessage' },
-                        { name: '⭐ 读取多维表格 (Pro)', value: 'readBitable' },
-                        { name: '⭐ 写入多维表格 (Pro)', value: 'writeBitable' },
-                        { name: '⭐ 获取待审批列表 (Pro)', value: 'getApprovals' },
+                        { name: '🆓 Send Text Message (Free)', value: 'sendTextMessage' },
+                        { name: '⭐ Send Card Message (Pro)', value: 'sendCardMessage' },
+                        { name: '⭐ Read Bitable (Pro)', value: 'readBitable' },
+                        { name: '⭐ Write to Bitable (Pro)', value: 'writeBitable' },
+                        { name: '⭐ Get Pending Approvals (Pro)', value: 'getApprovals' },
                     ],
                     default: 'sendTextMessage',
-                    description: 'Pro 功能需要 License Key',
+                    description: 'Pro features require a License Key',
                 },
                 // --- Send Text Message (Free) ---
                 {
-                    displayName: '接收人 ID 类型',
+                    displayName: 'Recipient ID Type',
                     name: 'receiveIdType',
                     type: 'options',
                     options: [
-                        { name: '用户 Open ID', value: 'open_id' },
-                        { name: '用户 User ID', value: 'user_id' },
-                        { name: '邮箱', value: 'email' },
-                        { name: '群 Chat ID', value: 'chat_id' },
+                        { name: 'Open ID', value: 'open_id' },
+                        { name: 'User ID', value: 'user_id' },
+                        { name: 'Email', value: 'email' },
+                        { name: 'Chat ID', value: 'chat_id' },
                     ],
                     default: 'open_id',
                     displayOptions: { show: { operation: ['sendTextMessage', 'sendCardMessage'] } },
                 },
                 {
-                    displayName: '接收人',
+                    displayName: 'Recipient',
                     name: 'receiveId',
                     type: 'string',
                     default: '',
                     required: true,
                     displayOptions: { show: { operation: ['sendTextMessage', 'sendCardMessage'] } },
-                    placeholder: 'ou_xxx 或 chat_xxx 或 email',
-                    description: '接收人的 open_id、user_id、邮箱或群的 chat_id',
+                    placeholder: 'ou_xxx or chat_xxx or email@example.com',
+                    description: 'Recipient open_id, user_id, email, or chat_id',
                 },
                 {
-                    displayName: '消息内容',
+                    displayName: 'Message Content',
                     name: 'textContent',
                     type: 'string',
                     typeOptions: { rows: 4 },
                     default: '',
                     required: true,
                     displayOptions: { show: { operation: ['sendTextMessage'] } },
-                    placeholder: '输入要发送的消息...',
+                    placeholder: 'Type your message...',
                 },
                 // --- Send Card Message (Pro) ---
                 {
-                    displayName: '卡片标题',
+                    displayName: 'Card Title',
                     name: 'cardTitle',
                     type: 'string',
-                    default: '📢 通知',
+                    default: '📢 Notification',
                     displayOptions: { show: { operation: ['sendCardMessage'] } },
                 },
                 {
-                    displayName: '卡片内容 (支持 Markdown)',
+                    displayName: 'Card Body (Markdown supported)',
                     name: 'cardContent',
                     type: 'string',
                     typeOptions: { rows: 6 },
                     default: '',
                     required: true,
                     displayOptions: { show: { operation: ['sendCardMessage'] } },
-                    placeholder: '**标题**\n内容...',
+                    placeholder: '**Title**\nContent...',
                 },
                 // --- Read Bitable (Pro) ---
                 {
-                    displayName: '多维表格 App Token',
+                    displayName: 'Bitable App Token',
                     name: 'bitableAppToken',
                     type: 'string',
                     default: '',
                     required: true,
                     displayOptions: { show: { operation: ['readBitable', 'writeBitable'] } },
-                    description: '多维表格 URL 中的 app token，如 /base/XXX 的 XXX 部分',
+                    description: 'The app token from your Bitable URL (the XXX in /base/XXX)',
                 },
                 {
-                    displayName: '表 ID',
+                    displayName: 'Table ID',
                     name: 'tableId',
                     type: 'string',
                     default: '',
@@ -132,13 +132,13 @@ class Feishu {
                 },
                 // --- Write Bitable (Pro) ---
                 {
-                    displayName: '写入数据 (JSON)',
+                    displayName: 'Fields (JSON)',
                     name: 'bitableFields',
                     type: 'json',
-                    default: '{"字段名": "值"}',
+                    default: '{"Field Name": "Value"}',
                     required: true,
                     displayOptions: { show: { operation: ['writeBitable'] } },
-                    description: '要写入的字段和值，JSON 格式',
+                    description: 'Fields and values to write, in JSON format',
                 },
             ],
         };
@@ -147,7 +147,6 @@ class Feishu {
     async execute() {
         const items = this.getInputData();
         const returnData = [];
-        // Get credentials
         const credentials = await this.getCredentials('feishuApi');
         const appId = credentials.appId;
         const appSecret = credentials.appSecret;
@@ -155,21 +154,18 @@ class Feishu {
         for (let i = 0; i < items.length; i++) {
             try {
                 const operation = this.getNodeParameter('operation', i);
-                // --- License check for Pro operations ---
+                // License check for Pro operations
                 if (PRO_OPERATIONS.includes(operation)) {
                     if (!licenseKey) {
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), '⭐ 这是 Pro 功能。请在凭证中填写 License Key。\n' +
-                            '👉 购买 License Key：https://gumroad.com/l/feishu-pro\n' +
-                            '👉 获取免费 Key 试用 7 天：https://gumroad.com/l/feishu-pro');
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), '⭐ This is a Pro feature. Please add a License Key in your credentials.\n' +
+                            '👉 Get a License Key: https://1717465779306.gumroad.com/l/feishu-pro');
                     }
                     const validation = await license_1.validateLicense.call(this, licenseKey, appId);
                     if (!validation.valid) {
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `License Key 无效或已过期：${validation.reason}`);
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `License Key invalid or expired: ${validation.reason}`);
                     }
                 }
-                // Get token
                 const token = await getFeishuToken.call(this, appId, appSecret);
-                // Execute operation
                 switch (operation) {
                     case 'sendTextMessage': {
                         const receiveIdType = this.getNodeParameter('receiveIdType', i);
@@ -278,9 +274,7 @@ class Feishu {
                     returnData.push({ json: { error: error.message }, error });
                 }
                 else {
-                    returnData.push({
-                        json: { error: error.message || 'Unknown error' },
-                    });
+                    returnData.push({ json: { error: error.message || 'Unknown error' } });
                 }
             }
         }

package/nodes/Feishu/FeishuTrigger.node.js

@@ -4,14 +4,14 @@ exports.FeishuTrigger = void 0;
 class FeishuTrigger {
     constructor() {
         this.description = {
-            displayName: '飞书触发器 Feishu Trigger',
+            displayName: 'Feishu / Lark Trigger',
             name: 'feishuTrigger',
             icon: 'file:feishu.svg',
             group: ['trigger'],
             version: 1,
             subtitle: '={{ $parameter["event"] }}',
-            description: '监听飞书事件：消息接收、审批状态变化',
-            defaults: { name: '飞书 Trigger' },
+            description: 'Listen for Feishu events: message received, approval status changed',
+            defaults: { name: 'Feishu / Lark Trigger' },
             inputs: [],
             outputs: ["main"],
             credentials: [{ name: 'feishuApi', required: true }],
@@ -25,22 +25,22 @@ class FeishuTrigger {
             ],
             properties: [
                 {
-                    displayName: '事件类型',
+                    displayName: 'Event Type',
                     name: 'event',
                     type: 'options',
                     options: [
-                        { name: '🆓 消息接收 (免费)', value: 'message_receive' },
-                        { name: '⭐ 审批状态变化 (Pro)', value: 'approval_change' },
+                        { name: '🆓 Message Received (Free)', value: 'message_receive' },
+                        { name: '⭐ Approval Status Changed (Pro)', value: 'approval_change' },
                     ],
                     default: 'message_receive',
-                    description: 'Pro 功能需要 License Key',
+                    description: 'Pro events require a License Key',
                 },
                 {
-                    displayName: '验证 Token',
+                    displayName: 'Verification Token',
                     name: 'verificationToken',
                     type: 'string',
                     default: '',
-                    description: '飞书事件订阅的 Verification Token，用于验证回调来源',
+                    description: 'Feishu Event Subscription Verification Token',
                 },
             ],
         };
@@ -48,14 +48,13 @@ class FeishuTrigger {
     async webhook() {
         const req = this.getRequestObject();
         const body = req.body;
-        // Handle Feishu URL verification challenge
+        // Feishu URL verification challenge
         if (body?.type === 'url_verification') {
             return {
                 webhookResponse: { challenge: body.challenge },
                 workflowData: [],
             };
         }
-        // Handle event
         const event = body?.event || {};
         const header = body?.header || {};
         return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lixiongwei/n8n-nodes-feishu",
-  "version": "1.0.1",
-  "description": "飞书/Lark nodes for n8n — send messages, manage bitables, process approvals. Free tier + Pro license.",
+  "version": "1.0.2",
+  "description": "Feishu/Lark nodes for n8n — send messages, manage Bitables, process approvals. Free tier + Pro license.",
   "main": "index.js",
   "scripts": {
     "build": "tsc",