node-red-contrib-vibe-function 0.1.0

package/README.md

@@ -0,0 +1,169 @@
+# node-red-contrib-vibe-function
+
+AI 驱动的 Node-RED Function 节点，用自然语言描述需求，自动生成、校验、修复代码。基于 **DeepSeek API**（兼容 Anthropic 协议）。
+
+## 安装
+
+```bash
+# 进入 Node-RED 目录
+cd ~/.node-red
+
+# 克隆或创建插件目录，放入 vibe-function.js 和 vibe-function.html
+mkdir -p node-red-contrib-vibe-function
+cp vibe-function.* node-red-contrib-vibe-function/
+ln -s ../node-red-contrib-vibe-function node_modules/node-red-contrib-vibe-function
+
+# 设置 API Key（二选一）
+export DEEPSEEK_API_KEY=sk-xxxxx   # 环境变量
+# 或在编辑面板中创建 vibe-function-config 配置节点
+
+# 重启 Node-RED
+node-red
+```
+
+## 快速上手
+
+1. 从节点面板拖入 **Vibe Function**（橙色、function 分类）
+2. 打开编辑面板 → **Coding** Tab
+3. 在「描述」中写："解析输入的时间戳，格式化为 YYYY-MM-DD HH:mm:ss"
+4. 点击 **✨ 生成代码**
+5. 检查 On Message / On Start / On Stop 中的代码
+6. 部署
+
+## 界面
+
+| Tab | 说明 |
+|-----|------|
+| **Coding** | 核心：API 配置、自然语言描述、一键生成代码 |
+| **Schema** | 定义输入/输出 msg 结构，提供属性下拉快速添加 |
+| **Setup** | Outputs 数量、Timeout、外部模块导入 (lodash, moment 等) |
+| **On Start** | 初始化代码，节点启动时执行一次 |
+| **On Message** | 消息处理函数，每次收到消息时执行 |
+| **On Stop** | 清理代码，节点停止时执行 |
+
+## 代码生成
+
+一次生成三段代码，对应节点的三个生命周期：
+
+- **On Start** — 初始化变量、建立连接（可用 `node.send()`）
+- **On Message** — 消息处理逻辑（`async function`，可用 `await`、`node.send()`、`return msg`）
+- **On Stop** — 清理资源、关闭连接（不可用 `node.send()`）
+
+在 **Schema** Tab 中描述输入输出结构后，生成的代码会更精确：
+
+```
+Input Schema:
+msg.payload = number (timestamp in ms)
+msg.topic   = device ID
+
+Output Schema:
+msg.payload = "YYYY-MM-DD HH:mm:ss" formatted time string
+```
+
+## Debug 模式
+
+节点上有一个 **🐛/</>** 切换开关，点击即可启用/禁用（无需重新部署）。
+
+启用后，运行时会对每条消息执行两道检查：
+
+### 1. 错误自动修复
+
+代码抛出异常 → 错误 + 输入 + 上下文发送给 LLM → 返回修复后代码 → 自动重试
+
+### 2. Schema 校验
+
+代码正常执行 → 输出 msg 发送给 LLM 验证 → 对比 Output Schema → 不符合则自动修复
+
+修复后的代码同时更新运行时和编辑器（重开编辑面板可见）。
+
+## API 配置节点
+
+在节点面板「配置」分类中拖入 **vibe-function-config**：
+
+| 字段 | 默认值 | 说明 |
+|------|--------|------|
+| API 格式 | `Anthropic Messages` | 可选 Anthropic 或 OpenAI 兼容格式 |
+| Base URL | `https://api.deepseek.com/anthropic` | API 基础地址 |
+| Model | `deepseek-v4-pro[1m]` | 模型名称 |
+| API Key | *(必填)* | 凭证，加密存储 |
+
+可创建多个配置节点供不同节点使用。未配置时回退到 `DEEPSEEK_API_KEY` 环境变量。
+
+## 兼容的 API 提供商
+
+同时支持 **Anthropic Messages** 和 **OpenAI Chat Completions** 两种 API 格式。
+
+### Anthropic 格式
+
+| 提供商 | Base URL | 示例 Model |
+|--------|----------|------------|
+| DeepSeek | `https://api.deepseek.com/anthropic` | `deepseek-v4-pro[1m]` |
+| Anthropic 官方 | `https://api.anthropic.com` | `claude-sonnet-4-6` |
+
+### OpenAI 格式
+
+| 提供商 | Base URL | 示例 Model |
+|--------|----------|------------|
+| DeepSeek | `https://api.deepseek.com` | `deepseek-chat` |
+| OpenAI 官方 | `https://api.openai.com` | `gpt-4o` |
+| Ollama (本地) | `http://localhost:11434` | `llama3` |
+| 其他兼容代理 | 自定义地址 | 自定义 |
+
+## 支持的内置 API
+
+沙箱中可直接使用：
+
+- `node.send(msg)` / `node.done()` — 消息控制
+- `context` / `flow` / `global` — 上下文存储
+- `env.get("VAR")` — 读取环境变量
+- `util` — Node.js util 模块
+- `Buffer` / `URL` / `Date` — 标准对象
+- `setTimeout` / `setInterval` / `clearTimeout` / `clearInterval` — 定时器（自动清理）
+- `console` — 日志输出
+
+## 示例
+
+### 时间格式化
+
+**描述：** 解析输入的时间戳，转换为 "YYYY-MM-DD HH:mm:ss" 格式
+
+**Input Schema:**
+```
+msg.payload = number (Unix timestamp in ms)
+```
+
+**Output Schema:**
+```
+msg.payload = "YYYY-MM-DD HH:mm:ss" formatted time string
+```
+
+**生成代码（On Message）：**
+```javascript
+let ts = msg.payload;
+if (typeof ts === "string") ts = Number(ts);
+if (ts < 1e12) ts *= 1000;
+let d = new Date(ts);
+let Y = d.getFullYear();
+let M = String(d.getMonth() + 1).padStart(2, "0");
+let D = String(d.getDate()).padStart(2, "0");
+let h = String(d.getHours()).padStart(2, "0");
+let m = String(d.getMinutes()).padStart(2, "0");
+let s = String(d.getSeconds()).padStart(2, "0");
+msg.payload = `${Y}-${M}-${D} ${h}:${m}:${s}`;
+return msg;
+```
+
+### HTTP 响应处理
+
+**描述：** 解析 HTTP 响应，提取状态码和 body，如果状态码不是 2xx 则设置 error
+
+**Output Schema:**
+```
+msg.payload = parsed response body (object)
+msg.statusCode = HTTP status code (number)
+msg.error = error message if status not 2xx (string or undefined)
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "node-red-contrib-vibe-function",
+  "version": "0.1.0",
+  "description": "AI-powered Node-RED function node — generate, validate, and self-heal code with natural language",
+  "license": "MIT",
+  "keywords": [
+    "node-red",
+    "node-red-contrib",
+    "function",
+    "llm",
+    "ai",
+    "deepseek",
+    "code-generation",
+    "self-healing",
+    "vibe-coding"
+  ],
+  "node-red": {
+    "nodes": {
+      "vibe-function": "vibe-function.js"
+    }
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iceshard999/node-red-contrib-vibe-function"
+  },
+  "author": {
+    "name": "Kesong Wan",
+    "email": "7632470@qq.com"
+  }
+}

package/vibe-function.html

@@ -0,0 +1,412 @@
+<script type="text/javascript">
+    // 配置节点
+    RED.nodes.registerType('vibe-function-config', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            baseUrl: { value: 'https://api.deepseek.com/anthropic' },
+            model: { value: 'deepseek-v4-pro[1m]' },
+            apiFormat: { value: 'anthropic' }
+        },
+        credentials: {
+            apiKey: { type: 'text' }
+        },
+        label: function() {
+            return this.name || 'DeepSeek API';
+        }
+    });
+
+    RED.nodes.registerType('vibe-function', {
+        category: 'function',
+        color: '#fdd0a2',
+        icon: 'status.svg',
+        defaults: {
+            name: { value: '' },
+            func: { value: '\nreturn msg;' },
+            outputs: { value: 1 },
+            timeout: { value: 0 },
+            initialize: { value: '' },
+            finalize: { value: '' },
+            libs: { value: [] },
+            description: { value: '' },
+            debug: { value: false },
+            configRef: { value: '', type: 'vibe-function-config', required: false },
+            inputSchema: { value: '' },
+            outputSchema: { value: '' }
+        },
+        inputs: 1,
+        outputs: 1,
+        label: function() {
+            return this.name || 'vibe-function';
+        },
+        button: {
+            toggle: 'debug',
+            label: function() {
+                return this.debug ? 'debug: on' : 'debug: off';
+            },
+            icon: function() {
+                return this.debug ? 'fa fa-bug' : 'fa fa-code';
+            },
+            onclick: function() {
+                var node = this;
+                // toggle 已翻转 node.debug，直接同步到运行时
+                $.ajax({
+                    url: '/vibe-function/debug-toggle/' + node.id,
+                    method: 'POST',
+                    contentType: 'application/json',
+                    data: JSON.stringify({ debug: node.debug }),
+                    error: function() {
+                        node.debug = !node.debug; // revert
+                        RED.notify('Debug 切换失败', 'error');
+                        RED.view.redraw();
+                    }
+                });
+            }
+        },
+        oneditprepare: function() {
+            var that = this;
+            var tabs = RED.tabs.create({
+                id: 'vibe-func-tabs',
+                onchange: function(tab) {
+                    $('#vibe-func-tabs-content').children().hide();
+                    $('#' + tab.id).show();
+                }
+            });
+
+            tabs.addTab({ id: 'vibe-tab-coding',    iconClass: 'fa fa-magic',     label: 'Coding' });
+            tabs.addTab({ id: 'vibe-tab-schema',    iconClass: 'fa fa-list-alt',  label: 'Schema' });
+            tabs.addTab({ id: 'vibe-tab-setup',     iconClass: 'fa fa-cog',       label: 'Setup' });
+            tabs.addTab({ id: 'vibe-tab-init',      iconClass: 'fa fa-play',      label: 'On Start' });
+            tabs.addTab({ id: 'vibe-tab-func',      iconClass: 'fa fa-code',      label: 'On Message' });
+            tabs.addTab({ id: 'vibe-tab-finalize',  iconClass: 'fa fa-stop',      label: 'On Stop' });
+
+            tabs.activateTab('vibe-tab-coding');
+
+            // ========== Module management ==========
+            var libsList = $('#node-input-libs-container').editableList({
+                addItem: function(container, i, opt) {
+                    var row = $('<div/>').css({
+                        'display': 'flex', 'gap': '4px', 'margin-bottom': '4px'
+                    }).appendTo(container);
+                    $('<input/>', {
+                        type: 'text', placeholder: 'module name (e.g. lodash)',
+                        class: 'node-input-libs-module'
+                    }).css({ flex: '1' }).appendTo(row).val(opt.module || '');
+                    $('<input/>', {
+                        type: 'text', placeholder: 'var name (e.g. _)',
+                        class: 'node-input-libs-var'
+                    }).css({ flex: '1' }).appendTo(row).val(opt.var || '');
+                },
+                removable: true
+            });
+            var libs = that.libs || [];
+            for (var i = 0; i < libs.length; i++) {
+                libsList.editableList('addItem', libs[i]);
+            }
+
+            // ========== Spinners ==========
+            $('#node-input-outputs').spinner({ min: 1, max: 500 });
+            $('#node-input-timeout').spinner({ min: 0, max: 4294967 });
+
+            // ========== 从运行时加载最新代码（Debug 修复后的） ==========
+            $.getJSON('/vibe-function/code/' + that.id, function(data) {
+                if (data.func && data.func !== $('#node-input-func').val()) {
+                    $('#node-input-func').val(data.func);
+                }
+                if (data.initialize && data.initialize !== $('#node-input-initialize').val()) {
+                    $('#node-input-initialize').val(data.initialize);
+                }
+                if (data.finalize && data.finalize !== $('#node-input-finalize').val()) {
+                    $('#node-input-finalize').val(data.finalize);
+                }
+            });
+
+            // ========== Schema 属性快速添加 ==========
+            function setupSchemaAdd(selectId, inputId, btnId, textareaId) {
+                $('#' + btnId).on('click', function() {
+                    var prop = $('#' + inputId).val().trim();
+                    if (!prop) {
+                        prop = $('#' + selectId).val();
+                    }
+                    if (!prop) return;
+                    var ta = $('#' + textareaId);
+                    var cur = ta.val().trim();
+                    var line = prop + ' = ';
+                    ta.val(cur ? cur + '\n' + line : line);
+                    $('#' + inputId).val('');
+                    $('#' + selectId).prop('selectedIndex', 0);
+                });
+            }
+            setupSchemaAdd('vibe-input-prop-select', 'vibe-input-custom-prop', 'vibe-input-add-btn', 'node-input-inputSchema');
+            setupSchemaAdd('vibe-output-prop-select', 'vibe-output-custom-prop', 'vibe-output-add-btn', 'node-input-outputSchema');
+
+            // ========== LLM Code Generation ==========
+            $('#vibe-generate-btn').on('click', function() {
+                var desc = $('#node-input-description').val();
+                if (!desc) {
+                    $('#vibe-status').text('请先填写描述');
+                    return;
+                }
+                var configNodeId = $('#node-input-configRef').val();
+                var inputSchema = $('#node-input-inputSchema').val();
+                var outputSchema = $('#node-input-outputSchema').val();
+
+                $('#vibe-status').text('生成中...');
+                $('#vibe-generate-btn').prop('disabled', true);
+
+                $.ajax({
+                    url: '/vibe-function/generate',
+                    method: 'POST',
+                    contentType: 'application/json',
+                    data: JSON.stringify({
+                        description: desc,
+                        configNodeId: configNodeId,
+                        inputSchema: inputSchema,
+                        outputSchema: outputSchema
+                    }),
+                    success: function(res) {
+                        if (res.name)        $('#node-input-name').val(res.name);
+                        if (res.initCode)   $('#node-input-initialize').val(res.initCode);
+                        if (res.funcCode)   $('#node-input-func').val(res.funcCode);
+                        if (res.finalizeCode) $('#node-input-finalize').val(res.finalizeCode);
+                        var parts = [];
+                        if (res.initCode)   parts.push('On Start');
+                        if (res.funcCode)   parts.push('On Message');
+                        if (res.finalizeCode) parts.push('On Stop');
+                        $('#vibe-status').text('已生成 → ' + parts.join(' + '));
+                    },
+                    error: function(err) {
+                        $('#vibe-status').text('生成失败: ' + err.responseText);
+                    },
+                    complete: function() {
+                        $('#vibe-generate-btn').prop('disabled', false);
+                    }
+                });
+            });
+
+            // ========== Debug 自动修复代码推送 ==========
+            RED.comms.subscribe('vibe-function:code-fixed', function(topic, data) {
+                if (data && data.nodeId === that.id) {
+                    $('#node-input-func').val(data.func);
+                    RED.notify('🛠️ Debug 模式已自动修复代码并更新编辑器', {
+                        type: 'success',
+                        timeout: 5000
+                    });
+                }
+            });
+        },
+        oneditsave: function() {
+            var libs = [];
+            $('#node-input-libs-container').editableList('items').each(function() {
+                var item = $(this);
+                var mod = item.find('.node-input-libs-module').val();
+                var vname = item.find('.node-input-libs-var').val();
+                if (mod && vname) libs.push({ module: mod, var: vname });
+            });
+            this.libs = libs;
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="vibe-function-config">
+    <div class="form-row">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-config-input-name" placeholder="DeepSeek API">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-apiFormat"><i class="fa fa-plug"></i> API 格式</label>
+        <select id="node-config-input-apiFormat" style="width: calc(100% - 105px);">
+            <option value="anthropic">Anthropic Messages</option>
+            <option value="openai">OpenAI Chat Completions</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-baseUrl"><i class="fa fa-globe"></i> Base URL</label>
+        <input type="text" id="node-config-input-baseUrl" placeholder="https://api.deepseek.com/anthropic">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-model"><i class="fa fa-cube"></i> Model</label>
+        <input type="text" id="node-config-input-model" placeholder="deepseek-v4-pro[1m]">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-apiKey"><i class="fa fa-key"></i> API Key</label>
+        <input type="password" id="node-config-input-apiKey" placeholder="sk-...">
+    </div>
+</script>
+
+<script type="text/html" data-template-name="vibe-function">
+    <style>
+        .vibe-code-area {
+            width: 100%;
+            font-family: 'Menlo', 'Consolas', monospace;
+            font-size: 13px;
+            line-height: 1.5;
+            tab-size: 4;
+            resize: vertical;
+            box-sizing: border-box;
+        }
+        .vibe-full-row {
+            clear: both;
+        }
+        .vibe-full-row > label {
+            display: block;
+            width: 100% !important;
+            float: none;
+            margin-bottom: 4px;
+        }
+        .vibe-full-row input[type=text],
+        .vibe-full-row textarea,
+        .vibe-full-row select {
+            width: 100% !important;
+            box-sizing: border-box;
+        }
+        .vibe-modules-row { margin-bottom: 0; }
+    </style>
+
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" style="width: calc(100% - 105px);">
+    </div>
+
+    <div class="form-row" style="margin-bottom: 0;">
+        <ul style="min-width: 500px; margin-bottom: 15px;" id="vibe-func-tabs"></ul>
+    </div>
+
+    <div id="vibe-func-tabs-content" style="min-height: calc(100% - 95px);">
+
+        <!-- Tab: Setup -->
+        <div id="vibe-tab-setup" style="display:none;">
+            <div class="form-row">
+                <label for="node-input-outputs"><i class="fa fa-random"></i> Outputs</label>
+                <input id="node-input-outputs" style="width: 60px;" value="1">
+            </div>
+            <div class="form-row">
+                <label for="node-input-timeout"><i class="fa fa-clock-o"></i> Timeout (s)</label>
+                <input id="node-input-timeout" style="width: 60px;" placeholder="0">
+            </div>
+            <div class="form-row vibe-modules-row">
+                <label><i class="fa fa-cubes"></i> 模块</label>
+            </div>
+            <div class="form-row vibe-full-row">
+                <ol id="node-input-libs-container" style="min-height: 80px;"></ol>
+            </div>
+        </div>
+
+        <!-- Tab: Schema -->
+        <div id="vibe-tab-schema" style="display:none;">
+            <!-- Input Schema -->
+            <div class="form-row vibe-full-row">
+                <label>Input Schema</label>
+                <div style="font-size:11px;color:#888;margin-bottom:4px;">
+                    描述输入 msg 对象的结构，会用于代码生成
+                </div>
+                <div style="display:flex;gap:4px;margin-bottom:4px;">
+                    <select id="vibe-input-prop-select" style="flex:1;">
+                        <option value="msg.payload">msg.payload</option>
+                        <option value="msg.topic">msg.topic</option>
+                        <option value="msg.qos">msg.qos</option>
+                        <option value="msg.retain">msg.retain</option>
+                        <option value="msg.error">msg.error</option>
+                        <option value="msg.status">msg.status</option>
+                        <option value="msg.headers">msg.headers</option>
+                        <option value="msg.params">msg.params</option>
+                        <option value="msg.req">msg.req</option>
+                        <option value="msg.res">msg.res</option>
+                        <option value="msg.cookies">msg.cookies</option>
+                        <option value="msg.filename">msg.filename</option>
+                        <option value="msg.ip">msg.ip</option>
+                        <option value="msg._msgid">msg._msgid</option>
+                    </select>
+                    <input type="text" id="vibe-input-custom-prop" placeholder="自定义属性..." style="flex:1;">
+                    <button id="vibe-input-add-btn" class="red-ui-button red-ui-button-small" style="white-space:nowrap;">+ 添加</button>
+                </div>
+                <textarea id="node-input-inputSchema" class="vibe-code-area" rows="6"
+                    placeholder="msg.payload = number (timestamp in ms)&#10;msg.topic = device id&#10;msg.status = device status (&quot;on&quot; | &quot;off&quot;)"></textarea>
+            </div>
+            <!-- Output Schema -->
+            <div class="form-row vibe-full-row">
+                <label>Output Schema</label>
+                <div style="font-size:11px;color:#888;margin-bottom:4px;">
+                    描述输出 msg 对象的结构
+                </div>
+                <div style="display:flex;gap:4px;margin-bottom:4px;">
+                    <select id="vibe-output-prop-select" style="flex:1;">
+                        <option value="msg.payload">msg.payload</option>
+                        <option value="msg.topic">msg.topic</option>
+                        <option value="msg.qos">msg.qos</option>
+                        <option value="msg.retain">msg.retain</option>
+                        <option value="msg.error">msg.error</option>
+                        <option value="msg.status">msg.status</option>
+                        <option value="msg.headers">msg.headers</option>
+                        <option value="msg.params">msg.params</option>
+                        <option value="msg.res">msg.res</option>
+                        <option value="msg.filename">msg.filename</option>
+                    </select>
+                    <input type="text" id="vibe-output-custom-prop" placeholder="自定义属性..." style="flex:1;">
+                    <button id="vibe-output-add-btn" class="red-ui-button red-ui-button-small" style="white-space:nowrap;">+ 添加</button>
+                </div>
+                <textarea id="node-input-outputSchema" class="vibe-code-area" rows="6"
+                    placeholder="msg.payload = formatted time string&#10;msg.topic = same as input"></textarea>
+            </div>
+        </div>
+
+        <!-- Tab: Coding (LLM code generation) -->
+        <div id="vibe-tab-coding" style="display:none;">
+            <div class="form-row vibe-full-row">
+                <label for="node-input-configRef">API 配置</label>
+                <input type="text" id="node-input-configRef">
+            </div>
+            <div class="form-row vibe-full-row">
+                <label for="node-input-description">描述</label>
+                <textarea id="node-input-description" class="vibe-code-area" rows="4"
+                    placeholder="用自然语言描述你想让这个节点做什么...&#10;&#10;可以写多行，越详细生成的代码越准确。"></textarea>
+            </div>
+            <div class="form-row">
+                <button id="vibe-generate-btn" class="red-ui-button">
+                    <i class="fa fa-magic"></i> 生成代码
+                </button>
+                <span id="vibe-status" style="margin-left:8px;font-size:12px;color:#999;"></span>
+            </div>
+            <div style="font-size:11px;color:#888;margin-top:8px;">
+                一次生成 On Start / On Message / On Stop 三个 Tab 的代码
+            </div>
+        </div>
+
+        <!-- Tab: On Start -->
+        <div id="vibe-tab-init" style="display:none;">
+            <div class="form-row vibe-full-row">
+                <label>初始化代码</label>
+                <div style="font-size:11px;color:#888;margin-bottom:4px;">
+                    节点启动时执行一次。初始化变量、建立连接等。
+                </div>
+                <textarea id="node-input-initialize" class="vibe-code-area" rows="12"
+                    placeholder="// 初始化代码，节点启动时执行&#10;context.set('count', 0);"></textarea>
+            </div>
+        </div>
+
+        <!-- Tab: On Message -->
+        <div id="vibe-tab-func" style="display:none;">
+            <div class="form-row vibe-full-row">
+                <label>消息处理函数</label>
+                <div style="font-size:11px;color:#888;margin-bottom:4px;">
+                    每次收到消息时执行。修改 <code>msg</code> 后 <code>return msg;</code>，或使用 <code>node.send(msg)</code>。
+                </div>
+                <textarea id="node-input-func" class="vibe-code-area" rows="16"
+                    style="min-height: 240px;">return msg;</textarea>
+            </div>
+        </div>
+
+        <!-- Tab: On Stop -->
+        <div id="vibe-tab-finalize" style="display:none;">
+            <div class="form-row vibe-full-row">
+                <label>清理代码</label>
+                <div style="font-size:11px;color:#888;margin-bottom:4px;">
+                    节点停止或重新部署时执行。清理资源、关闭连接。<b>此函数中不能使用 node.send()</b>。
+                </div>
+                <textarea id="node-input-finalize" class="vibe-code-area" rows="12"
+                    placeholder="// 清理代码，节点停止时执行&#10;// 注意：此函数中不能使用 node.send()"></textarea>
+            </div>
+        </div>
+
+    </div>
+</script>

package/vibe-function.js

@@ -0,0 +1,660 @@
+const vm = require('vm');
+const util = require('util');
+
+module.exports = function(RED) {
+    "use strict";
+
+    // ========== 共享的 LLM 调用工具 ==========
+
+    async function callLLM(configNodeId, promptContent) {
+        let baseUrl = 'https://api.deepseek.com/anthropic';
+        let model = 'deepseek-v4-pro[1m]';
+        let apiKey = process.env.DEEPSEEK_API_KEY;
+        let apiFormat = 'anthropic';
+
+        if (configNodeId) {
+            const configNode = RED.nodes.getNode(configNodeId);
+            if (configNode) {
+                if (configNode.baseUrl)   baseUrl   = configNode.baseUrl;
+                if (configNode.model)     model     = configNode.model;
+                if (configNode.apiFormat) apiFormat = configNode.apiFormat;
+                if (configNode.credentials && configNode.credentials.apiKey) {
+                    apiKey = configNode.credentials.apiKey;
+                }
+            }
+        }
+
+        if (!apiKey) {
+            throw new Error('请先配置 API Key');
+        }
+
+        let endpoint, headers, body;
+        if (apiFormat === 'openai') {
+            endpoint = `${baseUrl}/v1/chat/completions`;
+            headers = {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`
+            };
+            body = JSON.stringify({
+                model,
+                max_tokens: 4096,
+                messages: [{ role: 'user', content: promptContent }]
+            });
+        } else {
+            endpoint = `${baseUrl}/v1/messages`;
+            headers = {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey,
+                'anthropic-version': '2023-06-01'
+            };
+            body = JSON.stringify({
+                model,
+                max_tokens: 4096,
+                messages: [{ role: 'user', content: promptContent }]
+            });
+        }
+
+        const response = await fetch(endpoint, { method: 'POST', headers, body });
+        const data = await response.json();
+
+        if (data.error) {
+            throw new Error(data.error.message || JSON.stringify(data.error));
+        }
+
+        let rawText;
+        if (apiFormat === 'openai') {
+            if (data.choices && data.choices[0] && data.choices[0].message) {
+                rawText = data.choices[0].message.content.trim();
+            }
+        } else {
+            if (data.content && Array.isArray(data.content)) {
+                const textBlock = data.content.find(b => b.type === 'text');
+                if (textBlock && textBlock.text) {
+                    rawText = textBlock.text.trim();
+                } else if (data.content[0] && data.content[0].text) {
+                    rawText = data.content[0].text.trim();
+                }
+            }
+            if (!rawText && data.choices && data.choices[0] && data.choices[0].message) {
+                rawText = data.choices[0].message.content.trim();
+            }
+        }
+
+        if (!rawText) {
+            throw new Error('未知的响应格式: ' + JSON.stringify(data).slice(0, 200));
+        }
+
+        return rawText;
+    }
+
+    function extractJSON(rawText) {
+        let jsonStr = rawText;
+        const jsonMatch = rawText.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        if (jsonMatch) jsonStr = jsonMatch[1].trim();
+        return JSON.parse(jsonStr);
+    }
+
+    // ========== 配置节点 ==========
+
+    function LLMFunctionConfigNode(config) {
+        RED.nodes.createNode(this, config);
+        this.name = config.name;
+        this.baseUrl = config.baseUrl;
+        this.model = config.model;
+        this.apiFormat = config.apiFormat || 'anthropic';
+    }
+    RED.nodes.registerType('vibe-function-config', LLMFunctionConfigNode, {
+        defaults: {
+            name: { value: '' },
+            baseUrl: { value: 'https://api.deepseek.com/anthropic' },
+            model: { value: 'deepseek-v4-pro[1m]' },
+            apiFormat: { value: 'anthropic' }
+        },
+        credentials: {
+            apiKey: { type: 'text' }
+        }
+    });
+
+    // ========== Helper ==========
+
+    function sendResults(node, send, msgs, cloneFirstMessage) {
+        if (msgs == null) return;
+        if (!Array.isArray(msgs)) msgs = [msgs];
+        let msgCount = 0;
+        for (let m = 0; m < msgs.length; m++) {
+            if (msgs[m]) {
+                if (!Array.isArray(msgs[m])) msgs[m] = [msgs[m]];
+                for (let n = 0; n < msgs[m].length; n++) {
+                    const msg = msgs[m][n];
+                    if (msg !== null && msg !== undefined) {
+                        if (typeof msg === 'object' && !Buffer.isBuffer(msg) && !Array.isArray(msg)) {
+                            if (msgCount === 0 && cloneFirstMessage !== false) {
+                                msgs[m][n] = RED.util.cloneMessage(msgs[m][n]);
+                            }
+                            msgCount++;
+                        } else {
+                            node.error(RED._("function.error.non-message-returned"));
+                        }
+                    }
+                }
+            }
+        }
+        if (msgCount > 0) send(msgs);
+    }
+
+    // ========== 节点运行时 ==========
+
+    function LLMFunctionNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        node._config = config; // 保存 flow 配置引用，用于写回修复后的代码
+
+        node.name = config.name;
+        node.func = config.func || 'return msg;';
+        node.outputs = parseInt(config.outputs) || 1;
+        node.timeout = (parseInt(config.timeout) || 0) * 1000;
+        node.ini = (config.initialize || '').trim();
+        node.fin = (config.finalize || '').trim();
+        node.libs = config.libs || [];
+        node.debug = config.debug || false;
+        node.description = config.description || '';
+        node.inputSchema = config.inputSchema || '';
+        node.outputSchema = config.outputSchema || '';
+        node.configRef = config.configRef;
+
+        if (RED.settings.functionExternalModules === false && node.libs.length > 0) {
+            node.error(RED._("function.error.externalModuleNotAllowed"));
+            return;
+        }
+
+        function buildFunctionText(userCode) {
+            return "var results = null;" +
+                "results = (async function(msg,__send__,__done__){" +
+                    "var __msgid__ = msg._msgid;" +
+                    "var node = {" +
+                        "id:__node__.id," +
+                        "name:__node__.name," +
+                        "outputCount:__node__.outputCount," +
+                        "log:__node__.log," +
+                        "error:__node__.error," +
+                        "warn:__node__.warn," +
+                        "debug:__node__.debug," +
+                        "trace:__node__.trace," +
+                        "on:__node__.on," +
+                        "status:__node__.status," +
+                        "send:function(msgs,cloneMsg){ __node__.send(__send__,__msgid__,msgs,cloneMsg);}," +
+                        "done:__done__" +
+                    "};\n" +
+                    userCode + "\n" +
+                "})(msg,__send__,__done__);";
+        }
+
+        const sandbox = {
+            console, util, Buffer, URL, URLSearchParams, Date,
+            __node__: {
+                id: node.id,
+                name: node.name,
+                outputCount: node.outputs,
+                log: function() { node.log.apply(node, arguments); },
+                error: function() { node.error.apply(node, arguments); },
+                warn: function() { node.warn.apply(node, arguments); },
+                debug: function() { node.debug.apply(node, arguments); },
+                trace: function() { node.trace.apply(node, arguments); },
+                send: function(send, id, msgs, cloneMsg) { sendResults(node, send, msgs, cloneMsg); },
+                on: function() {
+                    if (arguments[0] === "input") throw new Error(RED._("function.error.inputListener"));
+                    node.on.apply(node, arguments);
+                },
+                status: function() { node.status.apply(node, arguments); }
+            },
+            context: {
+                set: function() { node.context().set.apply(node, arguments); },
+                get: function() { return node.context().get.apply(node, arguments); },
+                keys: function() { return node.context().keys.apply(node, arguments); },
+                get global() { return node.context().global; },
+                get flow() { return node.context().flow; }
+            },
+            flow: {
+                set: function() { node.context().flow.set.apply(node, arguments); },
+                get: function() { return node.context().flow.get.apply(node, arguments); },
+                keys: function() { return node.context().flow.keys.apply(node, arguments); }
+            },
+            global: {
+                set: function() { node.context().global.set.apply(node, arguments); },
+                get: function() { return node.context().global.get.apply(node, arguments); },
+                keys: function() { return node.context().global.keys.apply(node, arguments); }
+            },
+            env: { get: function(envVar) { return RED.util.getSetting(node, envVar); } },
+            setTimeout: function() {
+                const func = arguments[0]; let timerId;
+                arguments[0] = function() {
+                    sandbox.clearTimeout(timerId);
+                    try { func.apply(node, arguments); } catch(err) { node.error(err, {}); }
+                };
+                timerId = setTimeout.apply(node, arguments);
+                node.outstandingTimers.push(timerId);
+                return timerId;
+            },
+            clearTimeout: function(id) {
+                clearTimeout(id);
+                const index = node.outstandingTimers.indexOf(id);
+                if (index > -1) node.outstandingTimers.splice(index, 1);
+            },
+            setInterval: function() {
+                const func = arguments[0]; let timerId;
+                arguments[0] = function() {
+                    try { func.apply(node, arguments); } catch(err) { node.error(err, {}); }
+                };
+                timerId = setInterval.apply(node, arguments);
+                node.outstandingIntervals.push(timerId);
+                return timerId;
+            },
+            clearInterval: function(id) {
+                clearInterval(id);
+                const index = node.outstandingIntervals.indexOf(id);
+                if (index > -1) node.outstandingIntervals.splice(index, 1);
+            }
+        };
+
+        node.outstandingTimers = [];
+        node.outstandingIntervals = [];
+
+        // Debug 校验与修复
+        let debugValidationCount = 0;
+        const DEBUG_MAX_VALIDATIONS = 50; // 最多校验 50 次，避免无限循环
+
+        async function validateOutput(outputMsg, inputMsg) {
+            if (!node.outputSchema) return true;
+            if (debugValidationCount >= DEBUG_MAX_VALIDATIONS) return true;
+            debugValidationCount++;
+            try {
+                const prompt = `You are a validator. Check if this Node-RED function output matches the expected schema.
+
+Input msg: ${JSON.stringify(inputMsg)}
+Output msg: ${JSON.stringify(outputMsg)}
+Expected output schema: ${node.outputSchema}
+
+Reply EXACTLY "YES" if the output matches the schema, or "NO: <reason>" if it does not.`;
+
+                const response = await callLLM(node.configRef, prompt);
+                const ok = response.trim().toUpperCase().startsWith('YES');
+                if (!ok) {
+                    node.warn('[Debug] 输出不符合 Schema: ' + response.trim().substring(0, 120));
+                }
+                return ok;
+            } catch (err) {
+                // 校验失败不影响流程
+                node.warn('[Debug] Schema 校验请求失败: ' + err.message);
+                return true;
+            }
+        }
+
+        async function autoFixCode(reason, inputMsg) {
+            if (!node.debug) return null;
+            const canCall = !!(process.env.DEEPSEEK_API_KEY || (node.configRef && RED.nodes.getNode(node.configRef)));
+            if (!canCall) return null;
+            try {
+                const prompt = `你是一个 Node-RED function 节点调试修复器。
+以下代码需要修复，请返回修复后的代码。
+
+原始描述：${node.description || '无'}
+输入 Schema：${node.inputSchema || '无'}
+输出 Schema：${node.outputSchema || '无'}
+
+当前代码：
+\`\`\`javascript
+${node.func}
+\`\`\`
+
+收到的输入 msg：${JSON.stringify(inputMsg, null, 2)}
+
+问题：${reason}
+
+请只返回修复后的纯代码，不要包含任何解释、markdown 或 JSON 包装。直接输出可执行的 JavaScript 函数体。`;
+
+                const fixedCode = await callLLM(node.configRef, prompt);
+                const cleaned = fixedCode.replace(/```(?:javascript)?\s*\n?/g, '').trim();
+                node.func = cleaned;
+
+                // 重新编译脚本
+                node.script = new vm.Script(buildFunctionText(cleaned), {
+                    filename: 'Function:' + node.id,
+                    displayErrors: true
+                });
+
+                // 写回 flow 配置 + 推送给编辑器
+                if (node._config) {
+                    node._config.func = cleaned;
+                }
+                try {
+                    RED.comms.publish('vibe-function:code-fixed', {
+                        nodeId: node.id,
+                        func: cleaned
+                    }, false);
+                } catch (e) {
+                    // comms 不可用也不影响
+                }
+                node.warn('[Debug] 代码已自动修复');
+
+                return cleaned;
+            } catch (fixErr) {
+                node.error('[Debug] 自动修复失败: ' + fixErr.message);
+                return null;
+            }
+        }
+
+        function extractFirstOutputMsg(results) {
+            if (!results) return null;
+            // results 可能是: msg, [msg], [[msg]], [[msg1, msg2]]
+            let arr = results;
+            if (!Array.isArray(arr)) return arr;
+            if (arr.length === 0) return null;
+            if (Array.isArray(arr[0])) arr = arr[0];
+            return arr[0] || null;
+        }
+
+        // 加载外部模块
+        const moduleLoadPromises = [];
+        if (node.hasOwnProperty("libs")) {
+            node.libs.forEach(mod => {
+                const vname = mod.var || mod.name;
+                if (vname && vname !== "") {
+                    if (sandbox.hasOwnProperty(vname) || vname === 'node') {
+                        node.error(RED._("function.error.moduleNameError", { name: vname }));
+                        return;
+                    }
+                    sandbox[vname] = null;
+                    const spec = mod.module || mod.spec;
+                    if (spec && spec !== "") {
+                        moduleLoadPromises.push(
+                            RED.import(spec).then(lib => {
+                                sandbox[vname] = lib.default || lib;
+                            }).catch(err => {
+                                node.error(RED._("function.error.moduleLoadError", { module: spec, error: err.toString() }));
+                                throw err;
+                            })
+                        );
+                    }
+                }
+            });
+        }
+
+        const RESOLVING = 0, RESOLVED = 1;
+        let state = RESOLVING;
+        let messages = [];
+        let processMessage = () => {};
+
+        node.on("input", function(msg, send, done) {
+            if (state === RESOLVING) {
+                messages.push({ msg, send, done });
+            } else if (state === RESOLVED) {
+                processMessage(msg, send, done);
+            }
+        });
+
+        Promise.all(moduleLoadPromises).then(() => {
+            const context = vm.createContext(sandbox);
+
+            let iniScript = null, iniOpt = null;
+            if (node.ini) {
+                const iniText = `
+                (async function(__send__) {
+                    var node = {
+                        id:__node__.id,
+                        name:__node__.name,
+                        outputCount:__node__.outputCount,
+                        log:__node__.log,
+                        error:__node__.error,
+                        warn:__node__.warn,
+                        debug:__node__.debug,
+                        trace:__node__.trace,
+                        status:__node__.status,
+                        send: function(msgs, cloneMsg) {
+                            __node__.send(__send__, RED.util.generateId(), msgs, cloneMsg);
+                        }
+                    };
+                    ` + node.ini + `
+                })(__initSend__);`;
+                iniOpt = { filename: 'Setup:' + node.id };
+                if (node.timeout > 0) { iniOpt.timeout = node.timeout; iniOpt.breakOnSigint = true; }
+                iniScript = new vm.Script(iniText, iniOpt);
+            }
+
+            node.script = new vm.Script(buildFunctionText(node.func), {
+                filename: 'Function:' + node.id,
+                displayErrors: true
+            });
+
+            let finScript = null, finOpt = null;
+            if (node.fin) {
+                const finText = `(function() {
+                    var node = {
+                        id:__node__.id,
+                        name:__node__.name,
+                        outputCount:__node__.outputCount,
+                        log:__node__.log,
+                        error:__node__.error,
+                        warn:__node__.warn,
+                        debug:__node__.debug,
+                        trace:__node__.trace,
+                        status:__node__.status,
+                        send: function() { __node__.error("Cannot send from close function"); }
+                    };
+                    ` + node.fin + `
+                })();`;
+                finOpt = { filename: 'Cleanup:' + node.id };
+                if (node.timeout > 0) { finOpt.timeout = node.timeout; finOpt.breakOnSigint = true; }
+                finScript = new vm.Script(finText, finOpt);
+            }
+
+            let promise = Promise.resolve();
+            if (iniScript) {
+                context.__initSend__ = function(msgs) { node.send(msgs); };
+                promise = iniScript.runInContext(context, iniOpt);
+            }
+
+            // Debug 启动检查
+            if (node.debug) {
+                const hasConfig = !!(node.configRef && RED.nodes.getNode(node.configRef));
+                const hasEnvKey = !!process.env.DEEPSEEK_API_KEY;
+                if (!hasConfig && !hasEnvKey) {
+                    node.warn('[Debug] 未配置 API Key，自动修复不会生效。请在 Coding Tab 中选择 API 配置或设置 DEEPSEEK_API_KEY 环境变量');
+                }
+            }
+
+            processMessage = function(msg, send, done) {
+                context.msg = msg;
+                context.__send__ = send;
+                context.__done__ = done;
+                let opts = {};
+                if (node.timeout > 0) { opts.timeout = node.timeout; opts.breakOnSigint = true; }
+
+                async function runAndMaybeFix() {
+                    // 第一阶段：执行脚本（同步错误在此捕获，如语法错误）
+                    try {
+                        node.script.runInContext(context, opts);
+                    } catch (err) {
+                        return handleError(err);
+                    }
+                    // 第二阶段：await 结果（用户代码逻辑错误在此 reject）
+                    try {
+                        const results = await context.results;
+                        // Debug 模式：校验输出是否符合 Schema
+                        if (node.debug && node.outputSchema) {
+                            const outputMsg = extractFirstOutputMsg(results);
+                            const isValid = await validateOutput(outputMsg, msg);
+                            if (!isValid) {
+                                return handleError(
+                                    new Error('输出不符合 Schema: ' + node.outputSchema)
+                                );
+                            }
+                        }
+                        sendResults(node, send, results, false);
+                        done();
+                    } catch (err) {
+                        return handleError(err);
+                    }
+                }
+
+                async function handleError(err) {
+                    if (err && err.hasOwnProperty("stack")) msg.error = err;
+                    if (!node.debug) {
+                        done(err);
+                        return;
+                    }
+                    const errMsg = err.stack || err.message || String(err);
+                    node.warn('[Debug] 代码执行出错，尝试自动修复...');
+                    const fixed = await autoFixCode(errMsg, msg);
+                    if (fixed) {
+                        try {
+                            node.script.runInContext(context, opts);
+                            const results = await context.results;
+                            // Debug 模式：修复后也校验输出
+                            if (node.debug && node.outputSchema) {
+                                const outputMsg = extractFirstOutputMsg(results);
+                                const isValid = await validateOutput(outputMsg, msg);
+                                if (!isValid) {
+                                    node.warn('[Debug] 修复后输出仍不符合 Schema，停止重试');
+                                }
+                            }
+                            sendResults(node, send, results, false);
+                            done();
+                            return;
+                        } catch (retryErr) {
+                            done(retryErr);
+                            return;
+                        }
+                    }
+                    done(err);
+                }
+
+                runAndMaybeFix();
+            };
+
+            state = RESOLVED;
+            messages.forEach(m => processMessage(m.msg, m.send, m.done));
+            messages = [];
+        }).catch(err => {
+            node.error(err);
+        });
+
+        node.on("close", function() {
+            if (node.fin) {
+                const ctx = vm.createContext(Object.assign({}, sandbox));
+                try {
+                    const s = new vm.Script(
+                        `(function() {
+                            var node = {
+                                id:__node__.id, name:__node__.name,
+                                outputCount:__node__.outputCount,
+                                log:__node__.log, error:__node__.error,
+                                warn:__node__.warn, debug:__node__.debug,
+                                trace:__node__.trace, status:__node__.status,
+                                send: function() { __node__.error("Cannot send from close function"); }
+                            };
+                            ` + node.fin + `
+                        })();`,
+                        { filename: 'Cleanup:' + node.id }
+                    );
+                    s.runInContext(ctx);
+                } catch (err) { node.error(err); }
+            }
+            node.outstandingTimers.forEach(t => clearTimeout(t));
+            node.outstandingIntervals.forEach(t => clearInterval(t));
+        });
+    }
+
+    // Admin API: 即时切换 debug 模式（无需 redeploy）
+    RED.httpAdmin.post('/vibe-function/debug-toggle/:id', function(req, res) {
+        const node = RED.nodes.getNode(req.params.id);
+        if (node && node.type === 'vibe-function') {
+            node.debug = !!req.body.debug;
+            res.json({ ok: true, debug: node.debug });
+        } else {
+            res.status(404).send('Node not found');
+        }
+    });
+
+    // Admin API: 获取节点当前运行中的代码
+    RED.httpAdmin.get('/vibe-function/code/:id', function(req, res) {
+        const node = RED.nodes.getNode(req.params.id);
+        if (node && node.type === 'vibe-function') {
+            res.json({
+                func: node.func || '',
+                initialize: node.ini || '',
+                finalize: node.fin || ''
+            });
+        } else {
+            res.json({});
+        }
+    });
+
+    // ========== Admin API: 生成代码 ==========
+
+    RED.httpAdmin.post('/vibe-function/generate', async function(req, res) {
+        const { description, configNodeId, inputSchema, outputSchema } = req.body;
+
+        let schemaHint = '';
+        if (inputSchema)  schemaHint += `\n输入 msg 结构：\n${inputSchema}`;
+        if (outputSchema) schemaHint += `\n输出 msg 结构：\n${outputSchema}`;
+
+        const promptContent = `你是一个 Node-RED function 节点代码生成器。
+根据以下描述，生成三部分 JavaScript 代码，分别对应节点的三个生命周期。
+
+1. On Start (初始化代码) — 节点启动时执行一次，用于初始化变量、建立连接。可用 context, node.send()。
+2. On Message (消息处理) — 每次收到消息时执行，async function 内部。通过 return msg 输出，可用 node.send()。
+3. On Stop (清理代码) — 节点停止时执行，用于清理资源、关闭连接。不能用 node.send()。
+
+请严格按以下 JSON 格式输出，不要包含任何其他文字：
+
+{
+  "name": "节点名称（简短中文，如：时间格式化）",
+  "initCode": "// On Start 代码",
+  "funcCode": "// On Message 代码",
+  "finalizeCode": "// On Stop 代码"
+}
+
+注意：
+- 只返回 JSON，不要包含解释、注释或 markdown
+- JSON 字符串中的换行用 \\n 转义，引号用 \\" 转义
+- 如果某部分不需要代码，设为空字符串 ""
+${schemaHint}
+描述：${description}`;
+
+        try {
+            const rawText = await callLLM(configNodeId, promptContent);
+            const result = extractJSON(rawText);
+            res.json({
+                name: result.name || '',
+                initCode: result.initCode || '',
+                funcCode: result.funcCode || '',
+                finalizeCode: result.finalizeCode || ''
+            });
+        } catch(err) {
+            RED.log.error(`[vibe-function] 生成失败: ${err.message}`);
+            res.status(500).send(err.message);
+        }
+    });
+
+    RED.nodes.registerType('vibe-function', LLMFunctionNode, {
+        defaults: {
+            name: { value: '' },
+            func: { value: '\nreturn msg;' },
+            outputs: { value: 1 },
+            timeout: { value: 0 },
+            initialize: { value: '' },
+            finalize: { value: '' },
+            libs: { value: [] },
+            description: { value: '' },
+            debug: { value: false },
+            configRef: { value: '', type: 'vibe-function-config', required: false },
+            inputSchema: { value: '' },
+            outputSchema: { value: '' }
+        },
+        inputs: 1,
+        outputs: 1,
+        label: function() {
+            return this.name || 'vibe-function';
+        }
+    });
+};