n8n-nodes-siliconflow-ai 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nam2009
+
+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,185 @@
+# n8n-nodes-siliconflow-ai
+
+一个面向 [n8n](https://n8n.io) 的社区节点，封装 [SiliconFlow（硅基流动）](https://siliconflow.cn) 的 OpenAI 兼容 REST API：**Chat Completion**、**Embedding**、**Image Generation**、**Rerank**。
+
+> 🎯 **核心目的**：解决 [QixYuanmeng/n8n-nodes-siliconflow](https://github.com/QixYuanmeng/n8n-nodes-siliconflow) 在最新 n8n 中因 `langchain` 与 `@langchain/core` 版本冲突（`ERESOLVE`）导致的安装失败问题。
+>
+> 本节点**零运行时三方依赖**（除 `n8n-workflow` 作为 peer dep），完全使用 n8n 内置 HTTP helper 直连 SiliconFlow，永不与宿主 n8n 冲突。
+
+---
+
+## 📦 安装
+
+### 方式 1：通过 n8n UI 安装（推荐）
+
+需要 n8n >= 1.0。
+
+1. 启动 n8n
+2. 打开 **Settings → Community Nodes**
+3. 点击 **Install**
+4. 输入包名：`n8n-nodes-siliconflow-ai`
+5. 同意风险提示 → Install
+
+### 方式 2：本地加载（无需发布到 npm）
+
+启动 n8n 前设置环境变量：
+
+```bash
+# Linux / macOS / Git Bash
+export N8N_CUSTOM_EXTENSIONS="/d/GITHUB/n8n-nodes-siliconflow-ai"
+
+# Windows CMD
+set N8N_CUSTOM_EXTENSIONS=D:\GITHUB\n8n-nodes-siliconflow-ai
+
+# Windows PowerShell
+$env:N8N_CUSTOM_EXTENSIONS="D:\GITHUB\n8n-nodes-siliconflow-ai"
+```
+
+或者把 `dist/` + `package.json` 复制到 `~/.n8n/custom/n8n-nodes-siliconflow-ai/`。
+
+### 方式 3：Docker 自定义镜像
+
+```dockerfile
+FROM n8nio/n8n:latest
+USER root
+RUN mkdir -p /home/node/.n8n/custom/n8n-nodes-siliconflow-ai
+COPY --chown=node:node dist /home/node/.n8n/custom/n8n-nodes-siliconflow-ai/dist
+COPY --chown=node:node package.json /home/node/.n8n/custom/n8n-nodes-siliconflow-ai/
+USER node
+```
+
+---
+
+## 🔑 凭证配置
+
+1. 登录 [SiliconFlow 控制台](https://cloud.siliconflow.cn/account/ak) 创建 API Key（新用户注册送 2000 万 token 免费额度）
+2. n8n → **Credentials → New → SiliconFlow API**
+3. 填写：
+   - **API Key**：你的密钥
+   - **Base URL**：默认 `https://api.siliconflow.cn/v1`（一般无需修改）
+4. 点击 **Test connection**，会请求 `/v1/models` 验证
+
+---
+
+## ✨ 支持的能力
+
+| Resource | Operation | 端点 | 说明 |
+|---|---|---|---|
+| Chat Completion | Send Message | `POST /chat/completions` | 兼容 OpenAI 格式的对话 |
+| Embedding | Create Embeddings | `POST /embeddings` | 文本向量化 |
+| Image Generation | Generate | `POST /images/generations` | 文生图 |
+| Rerank | Rerank Documents | `POST /rerank` | 文档重排序（RAG 后处理） |
+
+---
+
+## 🚀 典型用法
+
+### 1. 简易聊天工作流
+
+```
+[Manual Trigger] → [SiliconFlow (Chat)] → [Set] → [Respond to Webhook]
+```
+
+**SiliconFlow 节点配置：**
+- Resource: `Chat Completion`
+- Model: `Qwen/Qwen2.5-7B-Instruct`
+- Messages: `=[{"role":"system","content":"你是一个翻译助手"},{"role":"user","content":"{{$json.text}}"}]`
+- Additional Options → Temperature: `0.5`，Max Tokens: `1024`
+
+**Set 节点**：把 `choices[0].message.content` 提取到 `output` 字段。
+
+### 2. 批量 Embedding
+
+把上游节点的 `texts` 字段传入：
+
+- Resource: `Embedding`
+- Model: `BAAI/bge-m3`
+- Input: `={{$json.texts}}`（值为字符串数组）
+- Additional Options → Encoding Format: `Float`
+
+下游节点用 `data[0].embedding` 取第一条向量。
+
+### 3. RAG 中的 Rerank 流程
+
+```
+[Vector Store] → [SiliconFlow (Rerank)] → [Top-K 送入 LLM]
+```
+
+- Resource: `Rerank`
+- Model: `BAAI/bge-reranker-v2-m3`
+- Query: `{{$json.question}}`
+- Documents: `={{$json.docs}}`（如 `["doc1","doc2",...]` 或 `[{"text":"doc1"}]`）
+- Top N: `3`
+
+输出 `results` 数组中每项含 `index`、`relevance_score` 和 `document`（开启 Return Documents 时）。
+
+### 4. 文生图
+
+- Resource: `Image Generation`
+- Model: `stabilityai/stable-diffusion-2-1`
+- Prompt: `a cute cat astronaut, cinematic lighting`
+- Image Size: `1024x1024`，Batch Size: `1`
+
+输出 `images[0].url` 即图片 URL（部分模型返回 base64）。
+
+---
+
+## 🧪 常见模型参考
+
+| 用途 | 模型示例 |
+|---|---|
+| 对话 | `Qwen/Qwen2.5-7B-Instruct`、`deepseek-ai/DeepSeek-V3`、`THUDM/glm-4-9b-chat` |
+| Embedding | `BAAI/bge-m3`、`Pro/BAAI/bge-m3` |
+| 图像 | `stabilityai/stable-diffusion-2-1`、`black-forest-labs/FLUX.1-schnell` |
+| Rerank | `BAAI/bge-reranker-v2-m3` |
+
+完整列表见 [SiliconFlow 模型广场](https://siliconflow.cn/models)。
+
+---
+
+## 🆚 与原 n8n-nodes-siliconflow 的区别
+
+| 项 | 原项目 | 本项目 |
+|---|---|---|
+| 运行时依赖 | `langchain` + `@langchain/core` + `axios` + `zod` | **零**（只用 n8n 内置 helper） |
+| 最新 n8n 安装 | ❌ `ERESOLVE` 报错 | ✅ 干净通过 |
+| 包大小 | ~50MB+ | < 50KB |
+| 维护难度 | 跟随 langchain 升级 | 跟随 SiliconFlow API 变更即可 |
+
+---
+
+## 🛠 开发
+
+```bash
+# 克隆
+git clone https://github.com/nam2009/n8n-nodes-siliconflow-ai.git
+cd n8n-nodes-siliconflow-ai
+
+# 安装开发依赖
+npm install
+
+# 编译
+npm run build
+
+# 监听模式（自动编译）
+npm run dev
+```
+
+修改源码后建议在本地 n8n 验证（见上文「方式 2：本地加载」）。
+
+---
+
+## 📚 参考文档
+
+- [SiliconFlow API 总览](https://docs.siliconflow.cn/cn/api-reference/authentication)
+- [SiliconFlow Chat Completions](https://docs.siliconflow.cn/cn/api-reference/chat-completions/chat-completions)
+- [SiliconFlow Embeddings](https://docs.siliconflow.cn/cn/api-reference/embeddings/embeddings)
+- [SiliconFlow Images](https://docs.siliconflow.cn/cn/api-reference/images/images)
+- [SiliconFlow Rerank](https://docs.siliconflow.cn/cn/api-reference/rerank/rerank)
+- [n8n 社区节点开发指南](https://docs.n8n.io/integrations/community-nodes/building-community-nodes/)
+
+---
+
+## 📄 License
+
+MIT

package/dist/credentials/SiliconFlowApi.credentials.d.ts

@@ -0,0 +1,15 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+/**
+ * SiliconFlow（硅基流动）API 凭证
+ *
+ * 文档：https://docs.siliconflow.cn/cn/api-reference/authentication
+ * 获取 API Key：https://cloud.siliconflow.cn/account/ak
+ */
+export declare class SiliconFlowApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/SiliconFlowApi.credentials.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiliconFlowApi = void 0;
+/**
+ * SiliconFlow（硅基流动）API 凭证
+ *
+ * 文档：https://docs.siliconflow.cn/cn/api-reference/authentication
+ * 获取 API Key：https://cloud.siliconflow.cn/account/ak
+ */
+class SiliconFlowApi {
+    constructor() {
+        this.name = 'siliconFlowApi';
+        this.displayName = 'SiliconFlow API';
+        this.documentationUrl = 'https://docs.siliconflow.cn/';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: '在 https://cloud.siliconflow.cn/account/ak 创建的 API 密钥',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.siliconflow.cn/v1',
+                required: true,
+                description: 'SiliconFlow OpenAI 兼容 API 根地址。国内用户一般无需修改；如使用海外站点请改为对应地址。',
+            },
+        ];
+        // 在每个请求头里注入 Bearer Token
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        // 凭证测试：调用 /models 公开端点验证 Key 是否有效
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/models',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.SiliconFlowApi = SiliconFlowApi;

package/dist/nodes/SiliconFlow/SiliconFlow.node.d.ts

@@ -0,0 +1,18 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+/**
+ * SiliconFlow（硅基流动）AI 节点 v0.2.0
+ *
+ * 本节点使用 n8n 内置的 helpers.httpRequestWithAuthentication 直接调用 SiliconFlow
+ * 的 OpenAI 兼容 REST API，不引入任何 langchain 或 axios 等三方依赖，从而彻底规避
+ * 宿主 n8n 环境的 peer dependency 冲突。
+ *
+ * 支持的能力：
+ *   - Chat Completion  （POST /chat/completions）
+ *   - Embedding        （POST /embeddings）
+ *   - Image Generation （POST /images/generations）
+ *   - Rerank           （POST /rerank）
+ */
+export declare class SiliconFlow implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/SiliconFlow/SiliconFlow.node.js

@@ -0,0 +1,676 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SiliconFlow = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * SiliconFlow（硅基流动）AI 节点 v0.2.0
+ *
+ * 本节点使用 n8n 内置的 helpers.httpRequestWithAuthentication 直接调用 SiliconFlow
+ * 的 OpenAI 兼容 REST API，不引入任何 langchain 或 axios 等三方依赖，从而彻底规避
+ * 宿主 n8n 环境的 peer dependency 冲突。
+ *
+ * 支持的能力：
+ *   - Chat Completion  （POST /chat/completions）
+ *   - Embedding        （POST /embeddings）
+ *   - Image Generation （POST /images/generations）
+ *   - Rerank           （POST /rerank）
+ */
+class SiliconFlow {
+    constructor() {
+        this.description = {
+            displayName: 'SiliconFlow',
+            name: 'siliconFlow',
+            icon: 'file:siliconflow.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["resource"] + ": " + $parameter["operation"]}}',
+            description: '调用 SiliconFlow（硅基流动）AI 能力：Chat Completion / Embedding / Image / Rerank',
+            defaults: {
+                name: 'SiliconFlow',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'siliconFlowApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                baseURL: '={{$credentials.baseUrl}}',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                // ============================================================
+                // Resource
+                // ============================================================
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Chat Completion',
+                            value: 'chat',
+                            description: '与大语言模型对话（OpenAI 兼容）',
+                        },
+                        {
+                            name: 'Embedding',
+                            value: 'embedding',
+                            description: '将文本转换为向量',
+                        },
+                        {
+                            name: 'Image Generation',
+                            value: 'image',
+                            description: '文生图',
+                        },
+                        {
+                            name: 'Rerank',
+                            value: 'rerank',
+                            description: '文档重排序（用于 RAG 检索后处理）',
+                        },
+                    ],
+                    default: 'chat',
+                },
+                // ============================================================
+                // Chat 相关字段
+                // ============================================================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['chat'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Send Message',
+                            value: 'send',
+                            action: 'Send a chat completion request',
+                        },
+                    ],
+                    default: 'send',
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'string',
+                    default: 'Qwen/Qwen2.5-7B-Instruct',
+                    required: true,
+                    description: '模型 ID。完整列表：https://docs.siliconflow.cn/cn/api-reference/chat-completions/chat-completions',
+                    displayOptions: {
+                        show: {
+                            resource: ['chat'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Messages',
+                    name: 'messages',
+                    type: 'json',
+                    default: '=[{"role":"user","content":"Hello"}]',
+                    required: true,
+                    description: 'OpenAI 格式的 messages 数组。支持 JSON 表达式，可引用上游数据，例如：[{"role":"user","content":"{{$json.text}}"}]',
+                    displayOptions: {
+                        show: {
+                            resource: ['chat'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Options',
+                    name: 'additionalOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['chat'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Temperature',
+                            name: 'temperature',
+                            type: 'number',
+                            default: 0.7,
+                            typeOptions: {
+                                minValue: 0,
+                                maxValue: 2,
+                            },
+                            description: '采样温度，0 表示更确定，2 表示更发散',
+                        },
+                        {
+                            displayName: 'Max Tokens',
+                            name: 'max_tokens',
+                            type: 'number',
+                            default: 512,
+                            description: '生成的最大 token 数',
+                        },
+                        {
+                            displayName: 'Top P',
+                            name: 'top_p',
+                            type: 'number',
+                            default: 0.9,
+                            typeOptions: {
+                                minValue: 0,
+                                maxValue: 1,
+                            },
+                        },
+                        {
+                            displayName: 'Stream',
+                            name: 'stream',
+                            type: 'boolean',
+                            default: false,
+                            description: '是否启用流式响应（启用时本节点仍按非流式处理，因为 n8n 不支持边收边发）',
+                        },
+                    ],
+                },
+                // ============================================================
+                // Embedding 相关字段
+                // ============================================================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['embedding'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Create Embeddings',
+                            value: 'create',
+                            action: 'Create embeddings',
+                        },
+                    ],
+                    default: 'create',
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'string',
+                    default: 'BAAI/bge-m3',
+                    required: true,
+                    description: 'Embedding 模型 ID，例如 BAAI/bge-m3、Pro/BAAI/bge-m3',
+                    displayOptions: {
+                        show: {
+                            resource: ['embedding'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Input',
+                    name: 'input',
+                    type: 'json',
+                    default: '="hello"',
+                    required: true,
+                    description: '要编码的文本。可为单个字符串（如 "hello"）或字符串数组（如 ["text1","text2"]）。支持 JSON 表达式，可引用上游 {{$json.texts}}。',
+                    displayOptions: {
+                        show: {
+                            resource: ['embedding'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Options',
+                    name: 'additionalOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['embedding'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Encoding Format',
+                            name: 'encoding_format',
+                            type: 'options',
+                            default: 'float',
+                            options: [
+                                { name: 'Float', value: 'float' },
+                                { name: 'Base64', value: 'base64' },
+                            ],
+                        },
+                    ],
+                },
+                // ============================================================
+                // Image Generation 相关字段
+                // ============================================================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['image'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Generate',
+                            value: 'generate',
+                            action: 'Generate an image from a prompt',
+                        },
+                    ],
+                    default: 'generate',
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'string',
+                    default: 'stabilityai/stable-diffusion-2-1',
+                    required: true,
+                    description: '图像模型 ID，例如 stabilityai/stable-diffusion-2-1、black-forest-labs/FLUX.1-schnell',
+                    displayOptions: {
+                        show: {
+                            resource: ['image'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 3,
+                    },
+                    default: '',
+                    required: true,
+                    description: '用于生成图像的文本提示词',
+                    displayOptions: {
+                        show: {
+                            resource: ['image'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Options',
+                    name: 'additionalOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['image'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Negative Prompt',
+                            name: 'negative_prompt',
+                            type: 'string',
+                            typeOptions: { rows: 2 },
+                            default: '',
+                            description: '不希望出现的元素描述',
+                        },
+                        {
+                            displayName: 'Image Size',
+                            name: 'image_size',
+                            type: 'options',
+                            default: '1024x1024',
+                            options: [
+                                { name: '512x512', value: '512x512' },
+                                { name: '768x768', value: '768x768' },
+                                { name: '1024x1024', value: '1024x1024' },
+                                { name: '1024x576 (16:9)', value: '1024x576' },
+                                { name: '576x1024 (9:16)', value: '576x1024' },
+                            ],
+                        },
+                        {
+                            displayName: 'Num Images',
+                            name: 'batch_size',
+                            type: 'number',
+                            default: 1,
+                            typeOptions: { minValue: 1, maxValue: 4 },
+                        },
+                        {
+                            displayName: 'Seed',
+                            name: 'seed',
+                            type: 'number',
+                            default: 0,
+                            description: '随机种子；0 表示随机',
+                        },
+                        {
+                            displayName: 'Guidance Scale',
+                            name: 'guidance_scale',
+                            type: 'number',
+                            default: 7.5,
+                            typeOptions: { minValue: 1, maxValue: 20 },
+                        },
+                        {
+                            displayName: 'Num Inference Steps',
+                            name: 'num_inference_steps',
+                            type: 'number',
+                            default: 20,
+                            typeOptions: { minValue: 1, maxValue: 100 },
+                        },
+                    ],
+                },
+                // ============================================================
+                // Rerank 相关字段
+                // ============================================================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['rerank'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Rerank Documents',
+                            value: 'rerank',
+                            action: 'Rerank documents against a query',
+                        },
+                    ],
+                    default: 'rerank',
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'string',
+                    default: 'BAAI/bge-reranker-v2-m3',
+                    required: true,
+                    description: 'Rerank 模型 ID，例如 BAAI/bge-reranker-v2-m3',
+                    displayOptions: {
+                        show: {
+                            resource: ['rerank'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Query',
+                    name: 'query',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 2,
+                    },
+                    default: '',
+                    required: true,
+                    description: '用户查询',
+                    displayOptions: {
+                        show: {
+                            resource: ['rerank'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Documents',
+                    name: 'documents',
+                    type: 'json',
+                    default: '=[{"text":"示例文档 1"},{"text":"示例文档 2"}]',
+                    required: true,
+                    description: '文档数组。可以是字符串数组 ["doc1","doc2"] 或对象数组 [{"text":"doc1"}]。支持 JSON 表达式，可引用上游数据。',
+                    displayOptions: {
+                        show: {
+                            resource: ['rerank'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Options',
+                    name: 'additionalOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['rerank'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Top N',
+                            name: 'top_n',
+                            type: 'number',
+                            default: 5,
+                            description: '返回前 N 个最相关文档',
+                        },
+                        {
+                            displayName: 'Return Documents',
+                            name: 'return_documents',
+                            type: 'boolean',
+                            default: true,
+                            description: '是否在响应中包含原始文档内容',
+                        },
+                        {
+                            displayName: 'Max Chunks Per Doc',
+                            name: 'max_chunks_per_doc',
+                            type: 'number',
+                            default: 0,
+                            description: '每个文档的最大切分数（0 表示不切分）',
+                        },
+                        {
+                            displayName: 'Overlap Tokens',
+                            name: 'overlap_tokens',
+                            type: 'number',
+                            default: 80,
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let responseData;
+                if (resource === 'chat') {
+                    responseData = await handleChat(this, i);
+                }
+                else if (resource === 'embedding') {
+                    responseData = await handleEmbedding(this, i);
+                }
+                else if (resource === 'image') {
+                    responseData = await handleImage(this, i);
+                }
+                else if (resource === 'rerank') {
+                    responseData = await handleRerank(this, i);
+                }
+                else {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `未知的 Resource: ${resource}`, {
+                        itemIndex: i,
+                    });
+                }
+                const executionData = this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(responseData), { itemData: { item: i } });
+                returnData.push(...executionData);
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.SiliconFlow = SiliconFlow;
+// ----------------------------------------------------------------
+// Helper functions（独立于类外，正确接收 IExecuteFunctions 上下文）
+// ----------------------------------------------------------------
+/**
+ * Chat Completion 处理函数
+ */
+async function handleChat(ctx, itemIndex) {
+    const model = ctx.getNodeParameter('model', itemIndex);
+    const messages = ctx.getNodeParameter('messages', itemIndex);
+    const additionalOptions = ctx.getNodeParameter('additionalOptions', itemIndex, {});
+    const body = {
+        model,
+        messages,
+        stream: false,
+    };
+    if (typeof additionalOptions.temperature === 'number') {
+        body.temperature = additionalOptions.temperature;
+    }
+    if (typeof additionalOptions.max_tokens === 'number') {
+        body.max_tokens = additionalOptions.max_tokens;
+    }
+    if (typeof additionalOptions.top_p === 'number') {
+        body.top_p = additionalOptions.top_p;
+    }
+    const requestOptions = {
+        method: 'POST',
+        url: '/chat/completions',
+        body,
+        json: true,
+    };
+    return (await ctx.helpers.httpRequestWithAuthentication.call(ctx, 'siliconFlowApi', requestOptions));
+}
+/**
+ * Embedding 处理函数
+ */
+async function handleEmbedding(ctx, itemIndex) {
+    const model = ctx.getNodeParameter('model', itemIndex);
+    const inputRaw = ctx.getNodeParameter('input', itemIndex);
+    const additionalOptions = ctx.getNodeParameter('additionalOptions', itemIndex, {});
+    // input 可能是字符串或字符串数组；优先按 JSON 解析
+    let input;
+    if (typeof inputRaw === 'string') {
+        const trimmed = inputRaw.trim();
+        if (trimmed.startsWith('[')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (Array.isArray(parsed)) {
+                    input = parsed;
+                }
+                else {
+                    input = trimmed;
+                }
+            }
+            catch {
+                input = trimmed;
+            }
+        }
+        else {
+            input = trimmed;
+        }
+    }
+    else if (Array.isArray(inputRaw)) {
+        input = inputRaw;
+    }
+    else {
+        input = String(inputRaw);
+    }
+    const body = { model, input };
+    if (additionalOptions.encoding_format) {
+        body.encoding_format = additionalOptions.encoding_format;
+    }
+    const requestOptions = {
+        method: 'POST',
+        url: '/embeddings',
+        body,
+        json: true,
+    };
+    return (await ctx.helpers.httpRequestWithAuthentication.call(ctx, 'siliconFlowApi', requestOptions));
+}
+/**
+ * Image Generation 处理函数
+ */
+async function handleImage(ctx, itemIndex) {
+    const model = ctx.getNodeParameter('model', itemIndex);
+    const prompt = ctx.getNodeParameter('prompt', itemIndex);
+    const additionalOptions = ctx.getNodeParameter('additionalOptions', itemIndex, {});
+    const body = {
+        model,
+        prompt,
+        image_size: additionalOptions.image_size ?? '1024x1024',
+        batch_size: additionalOptions.batch_size ?? 1,
+    };
+    if (additionalOptions.negative_prompt) {
+        body.negative_prompt = additionalOptions.negative_prompt;
+    }
+    if (typeof additionalOptions.seed === 'number' && additionalOptions.seed !== 0) {
+        body.seed = additionalOptions.seed;
+    }
+    if (typeof additionalOptions.guidance_scale === 'number') {
+        body.guidance_scale = additionalOptions.guidance_scale;
+    }
+    if (typeof additionalOptions.num_inference_steps === 'number') {
+        body.num_inference_steps = additionalOptions.num_inference_steps;
+    }
+    const requestOptions = {
+        method: 'POST',
+        url: '/images/generations',
+        body,
+        json: true,
+    };
+    return (await ctx.helpers.httpRequestWithAuthentication.call(ctx, 'siliconFlowApi', requestOptions));
+}
+/**
+ * Rerank 处理函数
+ */
+async function handleRerank(ctx, itemIndex) {
+    const model = ctx.getNodeParameter('model', itemIndex);
+    const query = ctx.getNodeParameter('query', itemIndex);
+    const documentsRaw = ctx.getNodeParameter('documents', itemIndex);
+    const additionalOptions = ctx.getNodeParameter('additionalOptions', itemIndex, {});
+    // documents: 接受字符串数组或 {text:string} 数组
+    let documents;
+    if (typeof documentsRaw === 'string') {
+        const trimmed = documentsRaw.trim();
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed)) {
+                documents = parsed;
+            }
+            else {
+                throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'Documents 字段必须为 JSON 数组', {
+                    itemIndex,
+                });
+            }
+        }
+        catch (err) {
+            throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Documents 字段不是合法的 JSON: ${err.message}`, { itemIndex });
+        }
+    }
+    else if (Array.isArray(documentsRaw)) {
+        documents = documentsRaw;
+    }
+    else {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'Documents 字段类型不支持', { itemIndex });
+    }
+    const body = {
+        model,
+        query,
+        documents,
+        top_n: additionalOptions.top_n ?? 5,
+        return_documents: additionalOptions.return_documents ?? true,
+    };
+    if (typeof additionalOptions.max_chunks_per_doc === 'number') {
+        body.max_chunks_per_doc = additionalOptions.max_chunks_per_doc;
+    }
+    if (typeof additionalOptions.overlap_tokens === 'number') {
+        body.overlap_tokens = additionalOptions.overlap_tokens;
+    }
+    const requestOptions = {
+        method: 'POST',
+        url: '/rerank',
+        body,
+        json: true,
+    };
+    return (await ctx.helpers.httpRequestWithAuthentication.call(ctx, 'siliconFlowApi', requestOptions));
+}

package/dist/nodes/SiliconFlow/siliconflow.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#4F46E5"/>
+      <stop offset="100%" stop-color="#06B6D4"/>
+    </linearGradient>
+  </defs>
+  <rect x="2" y="2" width="56" height="56" rx="12" fill="url(#g)"/>
+  <text x="30" y="40" text-anchor="middle" font-family="Helvetica, Arial, sans-serif"
+        font-size="22" font-weight="700" fill="#ffffff">SF</text>
+</svg>

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "n8n-nodes-siliconflow-ai",
+  "version": "0.2.0",
+  "description": "n8n community node for SiliconFlow AI (SiliconFlow / 硅基流动). Zero-dependency, direct REST API client. Supports Chat Completion, Embedding, Image Generation and Rerank.",
+  "keywords": [
+    "n8n",
+    "n8n-community-node-package",
+    "siliconflow",
+    "silicon-flow",
+    "硅基流动",
+    "ai",
+    "llm",
+    "embedding",
+    "image-generation",
+    "rerank"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "nam2009",
+    "email": "nam2009@users.noreply.github.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nam2009/n8n-nodes-siliconflow-ai.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nam2009/n8n-nodes-siliconflow-ai/issues"
+  },
+  "homepage": "https://github.com/nam2009/n8n-nodes-siliconflow-ai#readme",
+  "main": "index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/copy-assets.js",
+    "build:watch": "tsc --watch",
+    "lint": "eslint nodes credentials --ext .ts",
+    "lint:fix": "eslint nodes credentials --ext .ts --fix",
+    "format": "prettier --write \"nodes/**/*.ts\" \"credentials/**/*.ts\"",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "n8n-workflow": "^1.0.0",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "^1.0.0"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/SiliconFlowApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/SiliconFlow/SiliconFlow.node.js"
+    ]
+  }
+}