node-red-contrib-knx-ultimate
Version:
Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.
89 lines (76 loc) • 4.89 kB
HTML
<script type="text/markdown" data-help-name="knxUltimateAI">
此节点会监听所选 KNX Ultimate 网关上的**所有 KNX 电报**，生成流量统计、检测异常，并可选调用 LLM。
## 输出
1. **摘要/统计**（`msg.payload` 为 JSON）
2. **异常**（`msg.payload` 为 JSON）
3. **AI 助手**（`msg.payload` 为文本，包含 `msg.summary`）
## 命令（输入）
发送 `msg.topic`：
- `summary`（或空）：立即输出摘要
- `reset`：清空内部历史与计数器
- `ask`：向已配置的 LLM 提问
`ask` 的问题建议放在 `msg.prompt`，也可放在 `msg.payload`（字符串）。
## 配置字段
以下是编辑器里用户可见的全部字段名称。
### 通用
- **Gateway**：作为电报来源的 KNX Ultimate 网关/配置节点。
- **Name**：节点名称与仪表板标题。
- **Topic**：节点输出使用的基础 topic。
- **Open KNX AI Web** 按钮：打开网页仪表板（`/knxUltimateAI/sidebar/page`）。
### Capture
- **Capture GroupValue_Write**：抓取 Write 电报。
- **Capture GroupValue_Response**：抓取 Response 电报。
- **Capture GroupValue_Read**：抓取 Read 电报。
### Analysis
- **Analysis window (seconds)**：摘要/速率统计主窗口。
- **History window (seconds)**：内部历史保留窗口。
- **同时将捕获的报文归档到磁盘**：除了 RAM，还会把报文保存到 `knxultimatestorage/knxai/history/<node-id>/YYYY-MM-DD.jsonl`。
- **磁盘归档保留天数**：归档文件在磁盘上保留的天数，超期后旧文件会自动删除。
- **Max stored events**：内存中保留的最大电报数量。
- **Auto emit summary (seconds, 0=off)**：周期性输出摘要间隔。
- **Top list size**：摘要中 top 组地址/来源数量。
- **Detect simple patterns (A -> B)**：启用组地址转移/模式检测。
- **Pattern max lag (ms)**：模式关联允许的最大时间差。
- **Pattern min occurrences**：报告模式前的最小出现次数。
### Anomalies
- **Rate window (seconds)**：异常速率检查滑动窗口。
- **Max overall telegrams/sec (0=off)**：全总线 telegram/s 阈值。
- **Max telegrams/sec per GA (0=off)**：单组地址 telegram/s 阈值。
- **Flap window (seconds)**：抖动/快速变化检测窗口。
- **Max changes per GA in window (0=off)**：窗口内允许的最大变化次数。
### AI 助手
- **Enable LLM assistant**：启用 Ask/chat 功能。
- **Provider**：LLM 后端（OpenAI-compatible 或 Ollama）。
- **Endpoint URL**：chat/completions 接口 URL。
- **API key**：API Key（本地 Ollama 可不填）。
- **Model**：模型 ID/名称。
- **System prompt**：KNX 分析全局系统提示词（Advanced）。
- 如果启用了磁盘归档，**Ask** 默认会查询该归档：若问题里写了明确日期/时间范围就按其查询，否则默认查询最近 24 小时并补上当前 RAM 事件。
- **Include raw payload hex**：在提示词中包含原始十六进制 payload。
- **包含 Node-RED 项目清单**：在提示词中加入整个 Node-RED 项目的节点清单，不仅包含 KNX 节点，也包含 function/change/inject/template 等在内且带有 KNX 逻辑或组地址的有用节点。
- **Include documentation snippets (help/README/examples)**：在提示词中包含文档片段。
- **Docs language**：文档片段优先语言。
- **Refresh** 按钮：请求 provider 并加载可用模型 ID。
### Advanced
- **Analysis window (seconds)**：摘要/速率统计主窗口。
- **Max stored events**：内存中保留的最大电报数量。
- **Top list size**：摘要中 top 组地址/来源数量。
- **Pattern max lag (ms)**：模式关联允许的最大时间差。
- **Pattern min occurrences**：报告模式前的最小出现次数。
- **Rate window (seconds)**：异常速率检查滑动窗口。
- **Max overall telegrams/sec (0=off)**：全总线 telegram/s 阈值。
- **Max telegrams/sec per GA (0=off)**：单组地址 telegram/s 阈值。
- **Flap window (seconds)**：抖动/快速变化检测窗口。
- **Max changes per GA in window (0=off)**：窗口内允许的最大变化次数。
### Ollama 快速配置（本地）
- 选择 **Provider = Ollama**。
- 默认 endpoint：`http://localhost:11434/api/chat`。
- 若未发现本地模型：
- **1) Download model**：打开 **Model library** 页面。
- **2) Install it**：在本机下载并安装模型（例如 `llama3.1`）。
- 在刷新/安装模型时，KNX AI 也会在可能情况下尝试自动启动 Ollama 服务。
- 若安装因连接错误失败，请确认 Ollama 已运行（桌面应用或 `ollama serve`）。
- 若 Node-RED 运行在 Docker 中，endpoint 请使用 `host.docker.internal` 替代 `localhost`。
## 安全说明
启用 LLM 后，KNX 流量上下文可能发送到所配置的 endpoint。若需严格本地化，请使用本地 provider。
</script>