@lixiongwei/n8n-nodes-feishu 1.0.0

package/README.md

@@ -0,0 +1,72 @@
+# n8n-nodes-feishu
+
+> 飞书/Lark 集成节点，免费功能 + Pro License。附带 5 个即用工作流模板。
+
+---
+
+## 安装
+
+```bash
+npm install n8n-nodes-feishu
+```
+
+n8n 自托管版直接在 n8n 所在目录执行。云版不支持社区节点。
+
+---
+
+## 免费功能 🆓
+
+| 功能 | 说明 |
+|------|------|
+| **发送文本消息** | 给用户/群发文本消息 |
+| **消息触发器** | 接收飞书事件回调 |
+
+---
+
+## Pro 功能 ⭐ （需 License Key）
+
+| 功能 | 说明 |
+|------|------|
+| **发送卡片消息** | 富文本卡片模板 + Markdown |
+| **读取多维表格** | 按字段读取 Bitable 数据 |
+| **写入多维表格** | 写入新行到 Bitable |
+| **获取待审批列表** | 查询审批实例 |
+
+---
+
+## 获取 License Key
+
+👉 **[在 Gumroad 购买](https://gumroad.com/l/feishu-pro)** — $49 一次性，永久使用。
+
+购买后在凭证管理里填入 Key，Pro 功能即刻解锁。
+
+---
+
+## 附带工作流模板
+
+在 `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 数据 → 飞书推送 |
+
+---
+
+## 飞书应用配置
+
+1. 飞书开发者后台创建 **企业自建应用**
+2. 开启 **机器人** 能力
+3. 权限管理开通：`im:message:send_as_bot`
+4. 发布应用
+5. 在 n8n 凭证中填入 App ID + App Secret + License Key
+
+---
+
+## 版本
+
+- n8n 版本要求：1.x+
+- 飞书 API 版本：v3

package/credentials/FeishuApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class FeishuApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/credentials/FeishuApi.credentials.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeishuApi = void 0;
+class FeishuApi {
+    constructor() {
+        this.name = 'feishuApi';
+        this.displayName = '飞书 Feishu API';
+        this.documentationUrl = 'https://open.feishu.cn/document/home/getting-started';
+        this.properties = [
+            {
+                displayName: 'App ID',
+                name: 'appId',
+                type: 'string',
+                default: '',
+                description: '飞书应用的 App ID（从开发者后台-凭证与基础信息获取）',
+                required: true,
+            },
+            {
+                displayName: 'App Secret',
+                name: 'appSecret',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: '飞书应用的 App Secret',
+                required: true,
+            },
+            {
+                displayName: 'License Key',
+                name: 'licenseKey',
+                type: 'string',
+                default: '',
+                description: 'Pro License Key — 从 Gumroad 购买获取。留空则仅使用免费功能',
+                required: false,
+            },
+        ];
+    }
+}
+exports.FeishuApi = FeishuApi;

package/nodes/Feishu/Feishu.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Feishu implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/nodes/Feishu/Feishu.node.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Feishu = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+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) ---
+let cachedToken = null;
+let tokenExpiry = 0;
+async function getFeishuToken(appId, appSecret) {
+    if (cachedToken && Date.now() < tokenExpiry) {
+        return cachedToken;
+    }
+    const response = await this.helpers.request({
+        method: 'POST',
+        url: 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal',
+        headers: { 'Content-Type': 'application/json' },
+        body: { app_id: appId, app_secret: appSecret },
+        json: true,
+    });
+    if (response.code !== 0) {
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `飞书 Token 获取失败：${response.msg} (code: ${response.code})`);
+    }
+    cachedToken = response.tenant_access_token;
+    tokenExpiry = Date.now() + (response.expire - 300) * 1000;
+    return cachedToken;
+}
+// --- Node Description ---
+class Feishu {
+    constructor() {
+        this.description = {
+            displayName: '飞书 Feishu',
+            name: 'feishu',
+            icon: 'file:feishu.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{ $parameter["operation"] }}',
+            description: '飞书集成：发消息、读多维表格、处理审批',
+            defaults: { name: '飞书 Feishu' },
+            inputs: ["main"],
+            outputs: ["main"],
+            credentials: [{ name: 'feishuApi', required: true }],
+            properties: [
+                // --- Operation selector ---
+                {
+                    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' },
+                    ],
+                    default: 'sendTextMessage',
+                    description: 'Pro 功能需要 License Key',
+                },
+                // --- Send Text Message (Free) ---
+                {
+                    displayName: '接收人 ID 类型',
+                    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' },
+                    ],
+                    default: 'open_id',
+                    displayOptions: { show: { operation: ['sendTextMessage', 'sendCardMessage'] } },
+                },
+                {
+                    displayName: '接收人',
+                    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',
+                },
+                {
+                    displayName: '消息内容',
+                    name: 'textContent',
+                    type: 'string',
+                    typeOptions: { rows: 4 },
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['sendTextMessage'] } },
+                    placeholder: '输入要发送的消息...',
+                },
+                // --- Send Card Message (Pro) ---
+                {
+                    displayName: '卡片标题',
+                    name: 'cardTitle',
+                    type: 'string',
+                    default: '📢 通知',
+                    displayOptions: { show: { operation: ['sendCardMessage'] } },
+                },
+                {
+                    displayName: '卡片内容 (支持 Markdown)',
+                    name: 'cardContent',
+                    type: 'string',
+                    typeOptions: { rows: 6 },
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['sendCardMessage'] } },
+                    placeholder: '**标题**\n内容...',
+                },
+                // --- Read Bitable (Pro) ---
+                {
+                    displayName: '多维表格 App Token',
+                    name: 'bitableAppToken',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['readBitable', 'writeBitable'] } },
+                    description: '多维表格 URL 中的 app token，如 /base/XXX 的 XXX 部分',
+                },
+                {
+                    displayName: '表 ID',
+                    name: 'tableId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { operation: ['readBitable', 'writeBitable'] } },
+                    placeholder: 'tblXXXXXXXXXXXXX',
+                },
+                // --- Write Bitable (Pro) ---
+                {
+                    displayName: '写入数据 (JSON)',
+                    name: 'bitableFields',
+                    type: 'json',
+                    default: '{"字段名": "值"}',
+                    required: true,
+                    displayOptions: { show: { operation: ['writeBitable'] } },
+                    description: '要写入的字段和值，JSON 格式',
+                },
+            ],
+        };
+    }
+    // --- Execute ---
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        // Get credentials
+        const credentials = await this.getCredentials('feishuApi');
+        const appId = credentials.appId;
+        const appSecret = credentials.appSecret;
+        const licenseKey = credentials.licenseKey || '';
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const operation = this.getNodeParameter('operation', i);
+                // --- 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');
+                    }
+                    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}`);
+                    }
+                }
+                // Get token
+                const token = await getFeishuToken.call(this, appId, appSecret);
+                // Execute operation
+                switch (operation) {
+                    case 'sendTextMessage': {
+                        const receiveIdType = this.getNodeParameter('receiveIdType', i);
+                        const receiveId = this.getNodeParameter('receiveId', i);
+                        const textContent = this.getNodeParameter('textContent', i);
+                        const response = await this.helpers.request({
+                            method: 'POST',
+                            url: `https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=${receiveIdType}`,
+                            headers: {
+                                'Content-Type': 'application/json',
+                                Authorization: `Bearer ${token}`,
+                            },
+                            body: {
+                                receive_id: receiveId,
+                                msg_type: 'text',
+                                content: JSON.stringify({ text: textContent }),
+                            },
+                            json: true,
+                        });
+                        returnData.push({ json: response });
+                        break;
+                    }
+                    case 'sendCardMessage': {
+                        const receiveIdType = this.getNodeParameter('receiveIdType', i);
+                        const receiveId = this.getNodeParameter('receiveId', i);
+                        const cardTitle = this.getNodeParameter('cardTitle', i);
+                        const cardContent = this.getNodeParameter('cardContent', i);
+                        const response = await this.helpers.request({
+                            method: 'POST',
+                            url: `https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=${receiveIdType}`,
+                            headers: {
+                                'Content-Type': 'application/json',
+                                Authorization: `Bearer ${token}`,
+                            },
+                            body: {
+                                receive_id: receiveId,
+                                msg_type: 'interactive',
+                                content: JSON.stringify({
+                                    config: { wide_screen_mode: true },
+                                    header: {
+                                        title: { tag: 'plain_text', content: cardTitle },
+                                    },
+                                    elements: [
+                                        {
+                                            tag: 'div',
+                                            text: { tag: 'lark_md', content: cardContent },
+                                        },
+                                    ],
+                                }),
+                            },
+                            json: true,
+                        });
+                        returnData.push({ json: response });
+                        break;
+                    }
+                    case 'readBitable': {
+                        const appToken = this.getNodeParameter('bitableAppToken', i);
+                        const tableId = this.getNodeParameter('tableId', i);
+                        const response = await this.helpers.request({
+                            method: 'GET',
+                            url: `https://open.feishu.cn/open-apis/bitable/v1/apps/${appToken}/tables/${tableId}/records?page_size=100`,
+                            headers: { Authorization: `Bearer ${token}` },
+                            json: true,
+                        });
+                        const records = (response.data?.items || []).map((item) => item.fields);
+                        returnData.push({ json: { total: response.data?.total || 0, records } });
+                        break;
+                    }
+                    case 'writeBitable': {
+                        const appToken = this.getNodeParameter('bitableAppToken', i);
+                        const tableId = this.getNodeParameter('tableId', i);
+                        const fields = this.getNodeParameter('bitableFields', i);
+                        const response = await this.helpers.request({
+                            method: 'POST',
+                            url: `https://open.feishu.cn/open-apis/bitable/v1/apps/${appToken}/tables/${tableId}/records`,
+                            headers: {
+                                'Content-Type': 'application/json',
+                                Authorization: `Bearer ${token}`,
+                            },
+                            body: { fields: typeof fields === 'string' ? JSON.parse(fields) : fields },
+                            json: true,
+                        });
+                        returnData.push({ json: response });
+                        break;
+                    }
+                    case 'getApprovals': {
+                        const response = await this.helpers.request({
+                            method: 'GET',
+                            url: 'https://open.feishu.cn/open-apis/approval/v4/instances?page_size=20&status=PENDING',
+                            headers: { Authorization: `Bearer ${token}` },
+                            json: true,
+                        });
+                        const instances = (response.data?.instance_list || []).map((inst) => ({
+                            instanceCode: inst.instance_code,
+                            approvalName: inst.approval_name,
+                            startTime: inst.start_time,
+                            status: inst.status,
+                        }));
+                        returnData.push({ json: { pending: instances.length, instances } });
+                        break;
+                    }
+                }
+            }
+            catch (error) {
+                if (error instanceof n8n_workflow_1.NodeOperationError) {
+                    returnData.push({ json: { error: error.message }, error });
+                }
+                else {
+                    returnData.push({
+                        json: { error: error.message || 'Unknown error' },
+                    });
+                }
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Feishu = Feishu;

package/nodes/Feishu/FeishuTrigger.node.d.ts

@@ -0,0 +1,5 @@
+import { IWebhookFunctions, INodeType, INodeTypeDescription, IWebhookResponseData } from 'n8n-workflow';
+export declare class FeishuTrigger implements INodeType {
+    description: INodeTypeDescription;
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}

package/nodes/Feishu/FeishuTrigger.node.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeishuTrigger = void 0;
+class FeishuTrigger {
+    constructor() {
+        this.description = {
+            displayName: '飞书触发器 Feishu Trigger',
+            name: 'feishuTrigger',
+            icon: 'file:feishu.svg',
+            group: ['trigger'],
+            version: 1,
+            subtitle: '={{ $parameter["event"] }}',
+            description: '监听飞书事件：消息接收、审批状态变化',
+            defaults: { name: '飞书 Trigger' },
+            inputs: [],
+            outputs: ["main"],
+            credentials: [{ name: 'feishuApi', required: true }],
+            webhooks: [
+                {
+                    name: 'default',
+                    httpMethod: 'POST',
+                    responseMode: 'onReceived',
+                    path: 'feishu-webhook',
+                },
+            ],
+            properties: [
+                {
+                    displayName: '事件类型',
+                    name: 'event',
+                    type: 'options',
+                    options: [
+                        { name: '🆓 消息接收 (免费)', value: 'message_receive' },
+                        { name: '⭐ 审批状态变化 (Pro)', value: 'approval_change' },
+                    ],
+                    default: 'message_receive',
+                    description: 'Pro 功能需要 License Key',
+                },
+                {
+                    displayName: '验证 Token',
+                    name: 'verificationToken',
+                    type: 'string',
+                    default: '',
+                    description: '飞书事件订阅的 Verification Token，用于验证回调来源',
+                },
+            ],
+        };
+    }
+    async webhook() {
+        const req = this.getRequestObject();
+        const body = req.body;
+        // Handle 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 {
+            webhookResponse: { code: 0, msg: 'ok' },
+            workflowData: [
+                [
+                    {
+                        json: {
+                            eventType: header.event_type || 'unknown',
+                            eventId: header.event_id || '',
+                            appId: header.app_id || '',
+                            tenantKey: header.tenant_key || '',
+                            senderOpenId: event.sender?.sender_id?.open_id || '',
+                            messageType: event.message?.msg_type || '',
+                            messageContent: event.message?.content || '',
+                            sourceData: event,
+                        },
+                    },
+                ],
+            ],
+        };
+    }
+}
+exports.FeishuTrigger = FeishuTrigger;

package/nodes/Feishu/license.d.ts

@@ -0,0 +1,14 @@
+import { IExecuteFunctions } from 'n8n-workflow';
+interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+    plan?: string;
+    expiry?: string;
+}
+/**
+ * Offline-first license validation.
+ * When VALIDATION_URL is set, also tries remote validation.
+ * When empty (default), uses built-in key verification.
+ */
+export declare function validateLicense(this: IExecuteFunctions, licenseKey: string, _appId: string): Promise<ValidationResult>;
+export {};

package/nodes/Feishu/license.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateLicense = validateLicense;
+// Optional: remote validation URL. Set to '' to use offline-only mode.
+const VALIDATION_URL = '';
+// In-memory cache
+const cache = new Map();
+/**
+ * Offline-first license validation.
+ * When VALIDATION_URL is set, also tries remote validation.
+ * When empty (default), uses built-in key verification.
+ */
+async function validateLicense(licenseKey, _appId) {
+    const cached = cache.get(licenseKey);
+    if (cached && Date.now() - cached.ts < 86400000) {
+        return cached.result;
+    }
+    // --- Local validation ---
+    const result = validateLocal(licenseKey);
+    // --- Optional: try remote validation ---
+    if (VALIDATION_URL) {
+        try {
+            const response = await this.helpers.request({
+                method: 'POST',
+                url: VALIDATION_URL,
+                headers: { 'Content-Type': 'application/json' },
+                body: { key: licenseKey },
+                json: true,
+                timeout: 5000,
+            });
+            const remoteResult = response;
+            cache.set(licenseKey, { result: remoteResult, ts: Date.now() });
+            return remoteResult;
+        }
+        catch {
+            // Network fail — fall back to local result
+        }
+    }
+    cache.set(licenseKey, { result, ts: Date.now() });
+    return result;
+}
+/**
+ * Local key validation.
+ * Format: FLS-XXXX-XXXX-XXXX
+ * - TRIAL prefix ⇒ 7-day trial
+ * - PRO prefix ⇒ lifetime
+ * - Matches known test keys
+ */
+function validateLocal(key) {
+    const cleaned = key.trim().toUpperCase();
+    // Test keys (hardcoded for MVP)
+    const TEST_KEYS = {
+        'FLS-TEST-PRO-KEY1': { plan: 'pro' },
+        'FLS-TEST-TRIAL-KEY': { plan: 'trial' },
+    };
+    if (TEST_KEYS[cleaned]) {
+        return {
+            valid: true,
+            plan: TEST_KEYS[cleaned].plan,
+            expiry: TEST_KEYS[cleaned].plan === 'trial' ? '7 days' : 'lifetime',
+        };
+    }
+    // Pattern-based: valid if matches FLS-PRO-XXXXXXXX format
+    if (/^FLS-PRO-[A-Z0-9]{4,}$/.test(cleaned)) {
+        return { valid: true, plan: 'pro', expiry: 'lifetime' };
+    }
+    if (/^FLS-(TRIAL|TEST)-/.test(cleaned)) {
+        return { valid: true, plan: 'trial', expiry: '7 days' };
+    }
+    return { valid: false, reason: '无效的 License Key' };
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@lixiongwei/n8n-nodes-feishu",
+  "version": "1.0.0",
+  "description": "飞书/Lark nodes for n8n — send messages, manage bitables, process approvals. Free tier + Pro license.",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "feishu",
+    "lark",
+    "飞书"
+  ],
+  "author": "FileMaster Pro",
+  "license": "MIT",
+  "dependencies": {
+    "n8n-workflow": "^1.48.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "nodes": [
+      "nodes/Feishu/Feishu.node.js",
+      "nodes/Feishu/FeishuTrigger.node.js"
+    ],
+    "credentials": [
+      "credentials/FeishuApi.credentials.js"
+    ]
+  }
+}

package/workflows/template-01-send-message.json

@@ -0,0 +1,71 @@
+{
+  "name": "01 飞书消息发送器 Webhook → 飞书消息",
+  "nodes": [
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "app_id", "value": "← 填你的 App ID" },
+          { "name": "app_secret", "value": "← 填你的 App Secret" }
+        ]},
+        "options": {}
+      },
+      "id": "n1",
+      "name": "① 获取 Token",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [0, 300]
+    },
+    {
+      "parameters": {
+        "httpMethod": "POST",
+        "path": "feishu-input",
+        "responseMode": "lastNode",
+        "options": {}
+      },
+      "id": "n0",
+      "name": "🌐 外部 Webhook",
+      "type": "n8n-nodes-base.webhook",
+      "typeVersion": 2,
+      "position": [-250, 300],
+      "webhookId": "feishu-webhook-input"
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" },
+          { "name": "Authorization", "value": "=Bearer {{ $('① 获取 Token').first().json.tenant_access_token }}" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "receive_id", "value": "← 填接收人的 open_id" },
+          { "name": "msg_type", "value": "text" },
+          { "name": "content", "value": "={\"text\":\"{{ $json.body.text || $json.body.message || '通知：' + JSON.stringify($json.body) }}\"}" }
+        ]},
+        "options": {}
+      },
+      "id": "n2",
+      "name": "② 发送飞书消息",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [250, 300]
+    }
+  ],
+  "connections": {
+    "🌐 外部 Webhook": { "main": [[{ "node": "① 获取 Token", "type": "main", "index": 0 }]] },
+    "① 获取 Token": { "main": [[{ "node": "② 发送飞书消息", "type": "main", "index": 0 }]] }
+  },
+  "pinData": {}, "versionId": "1.0.0", "active": false,
+  "settings": {}, "tags": [{ "name": "飞书" }, { "name": "Webhook" }]
+}

package/workflows/template-02-cron-reminder.json

@@ -0,0 +1,67 @@
+{
+  "name": "02 飞书定时提醒 Cron → 飞书消息",
+  "nodes": [
+    {
+      "parameters": {
+        "rule": { "interval": [{ "field": "hours", "hoursInterval": 1 }] }
+      },
+      "id": "n0",
+      "name": "⏰ 定时触发（可改）",
+      "type": "n8n-nodes-base.scheduleTrigger",
+      "typeVersion": 1.2,
+      "position": [-250, 300]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "app_id", "value": "← 填你的 App ID" },
+          { "name": "app_secret", "value": "← 填你的 App Secret" }
+        ]},
+        "options": {}
+      },
+      "id": "n1",
+      "name": "① 获取 Token",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [0, 300]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" },
+          { "name": "Authorization", "value": "=Bearer {{ $('① 获取 Token').first().json.tenant_access_token }}" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "receive_id", "value": "← 填接收人的 open_id" },
+          { "name": "msg_type", "value": "text" },
+          { "name": "content", "value": "{\"text\":\"⏰ 定时提醒：该处理了！\"}" }
+        ]},
+        "options": {}
+      },
+      "id": "n2",
+      "name": "② 发送消息",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [250, 300]
+    }
+  ],
+  "connections": {
+    "⏰ 定时触发（可改）": { "main": [[{ "node": "① 获取 Token", "type": "main", "index": 0 }]] },
+    "① 获取 Token": { "main": [[{ "node": "② 发送消息", "type": "main", "index": 0 }]] }
+  },
+  "pinData": {}, "versionId": "1.0.0", "active": false,
+  "settings": {}, "tags": [{ "name": "飞书" }, { "name": "定时" }]
+}

package/workflows/template-03-website-monitor.json

@@ -0,0 +1,97 @@
+{
+  "name": "03 网站宕机监控 → 飞书告警",
+  "nodes": [
+    {
+      "parameters": {
+        "rule": { "interval": [{ "field": "minutes", "minutesInterval": 5 }] }
+      },
+      "id": "n0",
+      "name": "⏰ 每5分钟检查",
+      "type": "n8n-nodes-base.scheduleTrigger",
+      "typeVersion": 1.2,
+      "position": [-500, 300]
+    },
+    {
+      "parameters": {
+        "method": "GET",
+        "url": "← 填要监控的网址，如 https://your-site.com",
+        "sendBody": false,
+        "options": { "timeout": 10000, "redirect": { "redirect": {} } }
+      },
+      "id": "n1",
+      "name": "① 检查网站",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [-250, 300]
+    },
+    {
+      "parameters": {
+        "conditions": { "number": [
+          { "value1": "={{ $response.statusCode }}", "operation": "larger", "value2": 399 }
+        ]}
+      },
+      "id": "n2",
+      "name": "② 挂了？",
+      "type": "n8n-nodes-base.if",
+      "typeVersion": 2,
+      "position": [0, 300]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "app_id", "value": "← 填你的 App ID" },
+          { "name": "app_secret", "value": "← 填你的 App Secret" }
+        ]},
+        "options": {}
+      },
+      "id": "n3",
+      "name": "③ 获取 Token",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [250, 100]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" },
+          { "name": "Authorization", "value": "=Bearer {{ $('③ 获取 Token').first().json.tenant_access_token }}" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "receive_id", "value": "← 填你的 open_id" },
+          { "name": "msg_type", "value": "text" },
+          { "name": "content", "value": "={\"text\":\"🚨 网站挂了！状态码：{{ $json.statusCode }}，时间：{{ new Date().toLocaleString('zh-CN') }}\"}" }
+        ]},
+        "options": {}
+      },
+      "id": "n4",
+      "name": "④ 发飞书告警",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [500, 100]
+    }
+  ],
+  "connections": {
+    "⏰ 每5分钟检查": { "main": [[{ "node": "① 检查网站", "type": "main", "index": 0 }]] },
+    "① 检查网站": { "main": [[{ "node": "② 挂了？", "type": "main", "index": 0 }]] },
+    "② 挂了？": { "main": [
+      [{ "node": "③ 获取 Token", "type": "main", "index": 0 }],
+      []
+    ]},
+    "③ 获取 Token": { "main": [[{ "node": "④ 发飞书告警", "type": "main", "index": 0 }]] }
+  },
+  "pinData": {}, "versionId": "1.0.0", "active": false,
+  "settings": {}, "tags": [{ "name": "飞书" }, { "name": "监控" }]
+}

package/workflows/template-04-form-notify.json

@@ -0,0 +1,71 @@
+{
+  "name": "04 表单提交 → 飞书通知 + 多维表格记录",
+  "nodes": [
+    {
+      "parameters": {
+        "httpMethod": "POST",
+        "path": "form-submit",
+        "responseMode": "lastNode",
+        "options": {}
+      },
+      "id": "n0",
+      "name": "🌐 表单提交 Webhook",
+      "type": "n8n-nodes-base.webhook",
+      "typeVersion": 2,
+      "position": [-500, 300],
+      "webhookId": "form-notify-webhook"
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "app_id", "value": "← 填你的 App ID" },
+          { "name": "app_secret", "value": "← 填你的 App Secret" }
+        ]},
+        "options": {}
+      },
+      "id": "n1",
+      "name": "① 获取 Token",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [-250, 300]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" },
+          { "name": "Authorization", "value": "=Bearer {{ $('① 获取 Token').first().json.tenant_access_token }}" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "receive_id", "value": "← 填通知接收人 open_id" },
+          { "name": "msg_type", "value": "interactive" },
+          { "name": "content", "value": "={\"config\":{\"wide_screen_mode\":true},\"header\":{\"title\":{\"tag\":\"plain_text\",\"content\":\"📋 新提交\"}},\"elements\":[{\"tag\":\"div\",\"text\":{\"tag\":\"lark_md\",\"content\":\"**提交内容：**\\n{{ JSON.stringify($json.body, null, 2) }}\"}}]}" }
+        ]},
+        "options": {}
+      },
+      "id": "n2",
+      "name": "② 发卡片通知",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [0, 300]
+    }
+  ],
+  "connections": {
+    "🌐 表单提交 Webhook": { "main": [[{ "node": "① 获取 Token", "type": "main", "index": 0 }]] },
+    "① 获取 Token": { "main": [[{ "node": "② 发卡片通知", "type": "main", "index": 0 }]] }
+  },
+  "pinData": {}, "versionId": "1.0.0", "active": false,
+  "settings": {}, "tags": [{ "name": "飞书" }, { "name": "表单" }]
+}

package/workflows/template-05-api-to-feishu.json

@@ -0,0 +1,94 @@
+{
+  "name": "05 外部 API 数据 → 飞书定时推送",
+  "nodes": [
+    {
+      "parameters": {
+        "rule": { "interval": [{ "field": "hours", "hoursInterval": 6 }] }
+      },
+      "id": "n0",
+      "name": "⏰ 定时触发",
+      "type": "n8n-nodes-base.scheduleTrigger",
+      "typeVersion": 1.2,
+      "position": [-500, 300]
+    },
+    {
+      "parameters": {
+        "method": "GET",
+        "url": "← 填你的数据 API 地址",
+        "sendBody": false,
+        "options": {}
+      },
+      "id": "n1",
+      "name": "① 拉取数据",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [-250, 300]
+    },
+    {
+      "parameters": {
+        "mode": "json",
+        "jsonOutput": "={\n  \"title\": \"📊 数据播报\",\n  \"body\": \"{{ JSON.stringify($json) }}\"\n}"
+      },
+      "id": "n2",
+      "name": "② 格式化内容",
+      "type": "n8n-nodes-base.set",
+      "typeVersion": 3.4,
+      "position": [0, 300]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "app_id", "value": "← 填你的 App ID" },
+          { "name": "app_secret", "value": "← 填你的 App Secret" }
+        ]},
+        "options": {}
+      },
+      "id": "n3",
+      "name": "③ 获取 Token",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [250, 300]
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
+        "sendHeaders": true,
+        "headerParameters": { "parameters": [
+          { "name": "Content-Type", "value": "application/json" },
+          { "name": "Authorization", "value": "=Bearer {{ $('③ 获取 Token').first().json.tenant_access_token }}" }
+        ]},
+        "sendBody": true,
+        "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "receive_id", "value": "← 填接收人 open_id" },
+          { "name": "msg_type", "value": "interactive" },
+          { "name": "content", "value": "={\"config\":{\"wide_screen_mode\":true},\"header\":{\"title\":{\"tag\":\"plain_text\",\"content\":\"{{ $('② 格式化内容').first().json.title }}\"}},\"elements\":[{\"tag\":\"div\",\"text\":{\"tag\":\"lark_md\",\"content\":\"{{ $('② 格式化内容').first().json.body }}\"}}]}" }
+        ]},
+        "options": {}
+      },
+      "id": "n4",
+      "name": "④ 推送卡片",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [500, 300]
+    }
+  ],
+  "connections": {
+    "⏰ 定时触发": { "main": [[{ "node": "① 拉取数据", "type": "main", "index": 0 }]] },
+    "① 拉取数据": { "main": [[{ "node": "② 格式化内容", "type": "main", "index": 0 }]] },
+    "② 格式化内容": { "main": [[{ "node": "③ 获取 Token", "type": "main", "index": 0 }]] },
+    "③ 获取 Token": { "main": [[{ "node": "④ 推送卡片", "type": "main", "index": 0 }]] }
+  },
+  "pinData": {}, "versionId": "1.0.0", "active": false,
+  "settings": {},
+  "tags": [{ "name": "飞书" }, { "name": "数据推送" }]
+}