在 Node-RED 编辑器侧边栏内嵌入 AI 助手（Agent + Skills），让 AI 直接读取和操作画布、安装节点、根据自然语言修改流程。
这是一个 Node-RED 的 fork，在保留原有功能与构建流程的基础上，新增了一整套 AI 协作能力。上游 README 保留在 README-upstream.md。
- 工具栏「AI」标签，进入对话面板
- 每个流程 tab 维持独立会话，切换 tab 自动 swap 历史
- 删除流程 tab 会自动清理对应 session
- 顶部显示当前对话所属的 flow 名称
- 右上角操作：清空当前会话 / 技能管理 / AI 设置
- OpenAI 兼容（OpenAI、DeepSeek、Moonshot、SiliconFlow 等）
- Anthropic Claude（claude-sonnet-4-6、claude-opus-4-7 等）
- API Key 用 AES-256-GCM 加密存储在
<userDir>/ai-config.json，前端只能看到尾部 hint
AI 不再贴 JSON，而是通过工具直接读写画布：
| 工具 | 作用 | 是否需审批 |
|---|---|---|
list_installed_node_types |
列出已注册节点类型 | 否 |
get_node_info |
读取节点 help / metadata | 否 |
list_flows |
列出所有 flow tab | 否 |
get_current_flow |
取当前 flow 的所有节点 | 否 |
get_selection |
读取用户当前选中的节点 | 否 |
get_node_config |
取某节点完整配置 | 否 |
search_palette |
搜索 palette 市场 | 否 |
install_palette_module |
安装节点模块 | ✅ |
add_subflow |
新建子流程 | ✅ |
add_nodes |
在画布添加节点 | ✅ |
wire_nodes |
连接节点 | ✅ |
update_node |
修改节点配置（最小补丁） | ✅ |
delete_node |
删除节点 | ✅ |
list_skills / read_skill |
查阅 / 读取已安装技能 | 否 |
install_skill_from_url |
下载安装技能 | ✅ |
需审批的操作会通过 toast 弹出「同意 / 拒绝」按钮，用户确认后才执行。
- 在画布上选中节点后，输入框上方显示节点 chip：
name [type·idShort] - 点击 chip 可在画布定位节点；点 × 把该节点从此次上下文移除
- 发送时把选中节点 id 列表注入到用户消息，提示 AI 「先
get_node_config读取再update_node修改」
- 输入框旁回形针按钮，支持上传 ≤ 200 KB 的文本 / Markdown / 协议文档
- 多个附件并入同一条用户消息发给 AI
- AI 可基于附件回答或生成子流程
- 技能 = 带 YAML frontmatter 的 Markdown 操作手册
- 启用的技能会被注入到 Agent 系统提示，AI 看到匹配描述会自动
read_skill阅读全文再行动
支持三种安装方式：
1. 直接 URL：https://example.com/skill.md
2. npx 命令：npx skills add <name> ← 启动子进程到临时目录抓取
3. 内置技能名：superpower ← 项目内置
首次启动会自动安装 superpower 技能，内容是 Node-RED IoT 接入与画布编排心法（节点选择策略、工具调用顺序、复杂度门槛等）。删除后下次启动会再次 seed。
技能存储位置：<userDir>/ai-skills/
git clone https://github.com/caishenao/node-red-ai.git
cd node-red-ai
npm install
npx grunt build
node packages/node_modules/node-red/red.js --userDir .userdir --port 1880打开 http://127.0.0.1:1880，在右侧栏切换到「AI」标签，点齿轮图标配置 API Key，开始对话。
仓库根目录提供了完整的 fork 自构建 Dockerfile（多阶段：builder 跑 npm install + grunt build，runtime 仅保留运行时产物）。镜像大小约 660MB。
# 构建
docker build -t node-red-ai:latest .
# 运行（持久化数据到命名卷 ai-data）
docker volume create ai-data
docker run -d --name node-red-ai \
-p 1880:1880 \
-v ai-data:/data \
node-red-ai:latest数据目录 /data 与上游 nodered/node-red 镜像保持一致：flows.json、ai-config.json（AES-GCM 加密的 API Key）、ai-skills/ 都落在该卷里，重启不丢。容器以非 root 用户 node (UID 1000) 运行，并使用 tini 做 PID 1 处理 SIGTERM。
健康检查内置：HEALTHCHECK 每 30s 探测 http://127.0.0.1:1880/，失败 3 次置为 unhealthy。
仓库根目录还提供 docker-compose.yml，一行起停：
docker compose up -d # 第一次会自动构建镜像
docker compose logs -f # 跟随日志
docker compose down # 停止（保留数据卷 node-red-ai-data）
docker compose down -v # 连同数据卷一起删除（清空 flows / AI 配置 / 技能）如需把数据放到宿主机目录，把 docker-compose.yml 里 volumes 改成 - ./userdir:/data，并 mkdir -p userdir && chown 1000:1000 userdir（容器内是 UID 1000 的 node 用户）。
| 字段 | 示例 |
|---|---|
| 服务商 | OpenAI 兼容 / Anthropic Claude |
| 模型 | gpt-4o-mini、deepseek-chat、claude-sonnet-4-6 |
| Base URL | https://api.openai.com、https://api.deepseek.com、https://api.anthropic.com |
| API Key | sk-... |
packages/node_modules/@node-red/
├── editor-api/
│ └── lib/admin/
│ ├── ai.js # 后端 AI 服务（chat / agent / skills）
│ ├── index.js # /ai/* 路由注册
│ └── skills-builtin/
│ └── superpower.md # 内置技能
└── editor-client/
├── src/js/ui/
│ └── tab-ai.js # 前端 AI 侧边栏（agent loop / skills UI）
├── src/sass/
│ └── tab-ai.scss # 样式
└── locales/
├── en-US/editor.json # 英文文案
└── zh-CN/editor.json # 中文文案
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /ai/config |
读取配置（API Key 已脱敏） |
| POST | /ai/config |
保存配置 |
| POST | /ai/chat |
普通对话 |
| POST | /ai/agent |
Agent 模式（带工具调用） |
| POST | /ai/parse-protocol |
解析协议文档 |
| POST | /ai/generate-subflow |
从协议生成子流程 |
| GET | /ai/skills |
列出已安装技能 |
| GET | /ai/skills/:id |
读取技能完整内容 |
| POST | /ai/skills |
安装技能（spec / content） |
| PUT | /ai/skills/:id |
启用/停用 |
| DELETE | /ai/skills/:id |
删除 |
- API Key 用 AES-256-GCM 加密存储，前端永远收不到原文
- 所有写入类工具（
update_node/delete_node/install_palette_module/install_skill_from_url等）必须用户 toast 确认 - URL 安装的技能限制 ≤ 512 KB、仅 http(s)、最多 5 次重定向
npx skills add在临时目录执行，不影响项目 node_modules
---
name: my-mqtt-bridge
description: 把 MQTT 主题映射成 HTTP webhook
tags: mqtt, http
---
# 步骤
1. ...
2. ...把上面这种 .md 文件放到 <userDir>/ai-skills/ 或通过技能面板上传即可。
继承上游 Node-RED 项目的 Apache-2.0 协议，详见 LICENSE。
- Node-RED — 上游项目
- Anthropic Claude / OpenAI — LLM 服务