node-red-contrib-knx-ultimate 7.1.4 → 8.0.2

package/nodes/locales/zh-CN/knxUltimateWatchDog.html

@@ -1,178 +0,0 @@
-<script type="text/markdown" data-help-name="knxUltimateWatchDog">
-### 升级到 KNX Ultimate 8
-
-版本 7 会在此编辑器顶部显示一个小型的 **升级到 v8** 按钮。它会下载流程备份、安装所需的 HUE/Matter 软件包、转换兼容节点、执行完整部署、验证已保存的流程并安装版本 8。出现提示后必须重启 Node-RED 服务；仅重新加载浏览器并不足够。旧版 KNX AI 节点会停止自动操作。
-
-[完整升级指南](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/zh-CN-Upgrade-to-v8)
-
-<br/>
-
-**已弃用：** 此专用节点仍支持现有流程。新流程请使用 **KNX Utility** 并选择对应功能。旧版节点已从节点面板中隐藏，并在流程中标记为 `(deprecated)`。其编辑器提供转换按钮，经确认后可转换所有流程和子流程中的全部兼容旧版 KNX 工具节点。转换在浏览器本地进行，保留节点 ID、设置、连接和分组，且可以撤销。确认后将关闭当前节点编辑器并丢弃未保存的编辑。请在部署前检查结果。
-
-# WatchDog（看门狗）
-
-用于检测与网关或特定 KNX 设备的连接状况，并在出现故障时执行自动化操作。
-
-**功能**
-
-1. 周期性发送报文并等待应答，若总线连接异常则向流程输出消息。提供两种检测级别（见下）。
-2. 通过消息修改配置节点（Config-Node）的网关参数，实现 KNX/IP 路由器/接口的切换（如主备切换）。
-3. 强制与 KNX 总线建立/断开连接。
-
-## 以太网层与 KNX 双绞线层检测
-
-WatchDog 提供两级检测：
-
-- 以太网级：仅检测 KNX-Ultimate 与 KNX/IP 接口（Unicast）之间的连通性。
-- 以太网 + KNX-TP：检查整条链路（以太网→TP）。需一个能响应读取请求的物理设备。
-
-适合用于错误/连接故障告警（邮件通知、自动切换备份网关等）。
-
-## 设置（SETTINGS）
-
-| 属性 | 说明 |
-|--|--|
-| 网关 | 选择的 KNX 网关。|
-| 需要监控的组地址 | 用于发送与监测的组地址；DPT 必须为 1.x（布尔）。|
-| 节点名称 | 节点名称。|
-| 自动启动看门狗定时器 | 在部署/启动时自动启动定时器。|
-| 监听 KNX-Ultimate 节点错误 | 默认启用。当与所选网关关联的 KNX-Ultimate 节点（包括 KNX Device）报告红色错误状态时，输出 `NodeError` 消息。禁用后只抑制这些 `NodeError` 消息；WatchDog 自身的总线检测和控制消息仍保持启用。|
-| 检查等级 (请查阅wiki) | 见上。|
-
-**Check level**
-
-> Ethernet：检测 KNX-Ultimate（Unicast）与 KNX/IP 接口之间的连接。<br/>
-
-<img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/WatchDogEthernetLevel.png" width="90%"><br/>
-
-> Ethernet + KNX TP：完整检测（支持路由器/接口）。向物理设备发送 Read 并等待 Response；以太网或 TP 的任何故障都会被上报。请在 ETS 中为某个执行器配置一条会响应读取的 **状态** GA。<br/>
-
-<img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/WatchDogEthernetKNXTPLevel.png" width="90%"><br/>
-
-## 高级选项
-
-| 属性 | 说明 |
-|--|--|
-| 重试间隔 (秒) | 以秒为单位的检测间隔。|
-| 出错前的重试次数 | 连续失败多少次后报告错误。|
-
-# WatchDog 的输出
-
-WatchDog 始终输出自身的总线检测和控制消息。启用 **监听 KNX-Ultimate 节点错误** 后，它还会输出与所选网关关联的 KNX-Ultimate 节点（包括 KNX Device）所报告的错误。
-
-**WatchDog 自身连接问题**
-
-<a href="https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration" target="_blank">详见此处</a>
-
-```javascript
-
-msg = {
-  type: "BUSError",
-  checkPerformed: "Ethernet" // 或 "Eth+KNX",
-  nodeid: "23HJ.2355",
-  payload: true,
-  description: "..."
-}
-```
-
-**启用错误监听且某个 KNX-Ultimate 节点报告错误时**
-
-```javascript
-
-msg = {
-  type: "NodeError",
-  checkPerformed: "Self KNX-Ultimate node reporting a red color status",
-  nodeid: "23HJ.2355",
-  payload: true,
-  description: "...",
-  completeError: {
-    nodeid: "23HJ.2355",
-    topic: "0/1/1",
-    devicename: "Kitchen Light",
-    GA: "0/1/1"
-  }
-}
-```
-
-**通过 setGatewayConfig 修改网关配置**
-
-```javascript
-
-msg = {
-  type: "setGatewayConfig",
-  checkPerformed: "The Watchdog node changed the gateway configuration.",
-  nodeid: "23HJ.2355",
-  payload: true,
-  description: "New Config issued to the gateway. IP:224.0.23.12 Port:3671 PhysicalAddress:15.15.1\nBindLocalInterface:Auto",
-  completeError: ""
-}
-```
-
-**强制连接/断开**
-
-```javascript
-
-msg = {
-  type: "connectGateway",
-  checkPerformed: "The Watchdog issued a connection/disconnection to the gateway.",
-  nodeid: "23HJ.2355",
-  payload: true, // true=连接，false=断开
-  description: "Connection",
-  completeError: ""
-}
-```
-
----
-
-# 输入消息（INPUT）
-
-## 启动/停止 WatchDog
-
-```javascript
-
-msg.start = true; return msg; // 启动
-```
-
-```javascript
-msg.start = false; return msg; // 停止
-```
-
-## 运行期修改 KNX/IP 网关设置
-
-通过 `msg.setGatewayConfig` 更改 IP/Port/PhysicalAddress/Protocol 等；配置节点会应用并重连。Node-RED 重启后恢复为配置节点中的设置。所有参数均为可选。
-
-```javascript
-
-msg.setGatewayConfig = { IP:"224.0.23.12", Port:3671, PhysicalAddress:"15.15.1", BindToEthernetInterface:"Auto",
-  Protocol:"Multicast", importCSV:`"Group name" "Address" "Central" "Unfiltered" "Description" "DatapointType" "Security"
-"Attuatori luci" "0/-/-" "" "" "" "" "Auto"
-"Luci primo piano" "0/0/-" "" "" "" "" "Auto"
-"Luce camera da letto" "0/0/1" "" "" "" "DPST-1-1" "Auto"` };
-return msg;
-```
-
-仅更改 IP：
-
-```javascript
-
-msg.setGatewayConfig = { IP:"224.0.23.12" }; return msg;
-```
-
-**强制断开并禁用自动重连**
-
-```javascript
-
-msg.connectGateway = false; return msg;
-```
-
-**强制连接并启用自动重连**
-
-```javascript
-
-msg.connectGateway = true; return msg;
-```
-
-## 参见
-
-[Sample WatchDog](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
-</script>

package/nodes/locales/zh-CN/knxUltimateWatchDog.json

@@ -1,27 +0,0 @@
-{
-    "knxUltimateWatchDog": {
-        "paletteLabel": "KNX 看门狗 (deprecated)",
-        "title": "看门狗",
-        "properties": {
-            "node-input-server": "网关",
-            "node-input-checkLevel": "检查等级 (请查阅wiki)",
-            "node-input-topic": "需要监控的组地址",
-            "node-input-name": "节点名称",
-            "node-input-autoStart": "自动启动看门狗定时器",
-            "node-input-listenToKnxUltimateNodeErrors": "监听 KNX-Ultimate 节点错误",
-            "advancedOptionsAccordion": "高级选项",
-            "node-input-retryInterval": "重试间隔 (秒)",
-            "node-input-maxRetry": "出错前的重试次数"
-        },
-        "placeholder": {
-            "monitor": " 对于“仅以太网”检查，请使用不存在的组地址.例如：12/0/0。"
-        },
-        "selectlists": {
-            "Ethernet": "仅以太网单播（默认），使用 ping。 仅适用于 KNX 接口（而非路由器）",
-            "EthKNX": "以太网 + KNX 双绞线，使用真正的 KNX 设备"
-        },
-        "legacy_notice": "此节点已弃用，但仍支持现有流程。新流程请使用 KNX Utility。下方按钮可转换所有流程和子流程中的全部兼容旧版 KNX 工具节点。",
-        "migration_button": "转换所有兼容的旧版 KNX 节点",
-        "migration_button_title": "将编辑器所有流程和子流程中的全部兼容旧版 KNX 工具节点转换为 KNX Utility"
-    }
-}

package/nodes/locales/zh-CN/matter-config.html

@@ -1,47 +0,0 @@
-<script type="text/markdown" data-help-name="matter-config">
-### 升级到 KNX Ultimate 8
-
-版本 7 会在此编辑器顶部显示一个小型的 **升级到 v8** 按钮。它会下载流程备份、安装所需的 HUE/Matter 软件包、转换兼容节点、执行完整部署、验证已保存的流程并安装版本 8。出现提示后必须重启 Node-RED 服务；仅重新加载浏览器并不足够。旧版 KNX AI 节点会停止自动操作。
-
-[完整升级指南](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/zh-CN-Upgrade-to-v8)
-
-<br/>
-
-# Matter 控制器
-
-## 概述
-
-此配置节点是一个完整的 **Matter 控制器**：它创建自己的 Matter *fabric* 并将您的 Matter 设备配对（调试）进来。配对后的设备可供 **Matter Device** 节点使用，将它们映射到 KNX 组地址。
-
-控制器通过 **IP 网络**（WiFi、以太网或经边界路由器的 Thread）与设备通信。不支持蓝牙配对：设备必须已经可以通过网络访问。
-
-## 配对设备
-
-1. 先**部署**此配置节点（控制器必须已运行）。
-2. 重新打开节点并输入**配对码**：11 位手动配对码（例如 `3497-011-2332`）或二维码内容（`MT:....`）。
-3. 对于手动输入的配对码，请点击**配对**。通过**摄像头**或**图片**读取二维码后会自动开始配对。调试过程最多可能需要一分钟。
-
-无需手动输入二维码 payload：点击**摄像头**可实时扫描，点击**图片**可从本地照片读取。支持浅色背景上的标准深色二维码以及深色背景上的反白二维码。解码完全在浏览器中进行；读取到有效的 Matter 二维码后，编辑器会填写配对码并立即自动开始配对。如需设置可选设备名称，请在扫描前填写。手动输入的配对码仍需点击**配对**才会开始。实时使用摄像头要求通过 HTTPS 或从 `localhost` 打开编辑器；若条件不满足，编辑器会说明此限制，而图片加载功能仍然可用。
-
-配对期间，阻塞式面板会覆盖编辑器并阻止进一步点击，直到操作成功完成或失败。进度条跟随 matter.js 的实际阶段，并以英文显示当前操作。当设备公开产品身份时，面板还会显示产品名称、Vendor ID 和 Product ID。
-
-如果设备是全新的且仅支持蓝牙配对，请先用厂商 App 或其他 Matter 控制器（Alexa、Google Home、Apple Home）配对，然后使用其**"与其他中枢共享/配对"**功能为 KNX-Ultimate 生成新的配对码。这样设备可以同时加入多个 fabric。
-
-优先使用二维码 payload（`MT:...`），因为它包含完整的鉴别码。手动配对码只包含短鉴别码；当多个相同型号同时处于配对模式时，可能会选错设备。请一次只配对一个设备。
-
-## 存储
-
-Fabric 凭据和已配对设备保存在 Node-RED 用户目录下的 `knxultimatestorage/matter` 文件夹中。删除该文件夹将移除所有配对。
-
-使用 **导出** 下载此控制器实例的完整备份，其中包含 Fabric、私有凭据、会话和已配网设备数据。**请像密码一样保护此文件。** 导入会替换此实例当前的 Matter 存储并短暂重启控制器。控制器备份不能导入网桥。
-
-## 移除设备
-
-使用已配对设备列表中的垃圾桶按钮。控制器会尝试正确地解除设备调试；如果设备无法访问，仍会从 fabric 中移除（之后可能需要对设备进行恢复出厂设置）。
-
-该列表为当前存储在此控制器 Matter fabric 中的每个节点显示一行。Node ID 在同一 fabric 内是唯一的；由同一个已调试 bridge 暴露的 endpoint 不会作为独立设备列出。状态列会显示各节点处于已连接、已断开、正在重新连接或等待发现状态。
-
-控制器会为每个已配对设备分别保持命令顺序。缓慢、离线或已移除的设备不会阻塞发送给其他设备的命令。仍引用已移除 Node ID 的 Controller 设备节点会立即拒绝新命令，并显示 **Device no longer commissioned**。
-
-设备不可用时，其 Controller 节点会保持锁定并忽略后续命令，直到该设备再次报告 `connected`。恢复会自动进行；打开设备节点编辑器也会解除锁定，以便手动重试。
-</script>

package/nodes/locales/zh-CN/matter-config.json

@@ -1,47 +0,0 @@
-{
-  "matter-config": {
-    "properties": {
-      "title": "Matter 控制器",
-      "node-config-input-name": "名称",
-      "fabric_label": "Fabric 标签",
-      "pairing_title": "配对新设备",
-      "pairing_help": "输入 11 位手动配对码（例如 3497-011-2332）或二维码内容（MT:....）。设备必须可通过 IP 网络访问（WiFi/以太网或通过边界路由器的 Thread）。如果设备已与其他控制器（Alexa、Google、Apple）配对，请使用其\"与其他中枢共享/配对\"功能获取新的配对码。",
-      "pairing_code": "配对码",
-      "pairing_name": "设备名称",
-      "pair_button": "配对",
-      "qr_acquire": "读取二维码",
-      "qr_scan_camera": "摄像头",
-      "qr_scan_image": "图片",
-      "qr_stop_camera": "停止摄像头",
-      "qr_camera_insecure": "由于 Node-RED 编辑器未通过 HTTPS 或 localhost 打开，浏览器无法使用摄像头。请通过 HTTPS 重新打开，或使用图片。",
-      "qr_camera_unsupported": "此浏览器无法访问摄像头。请使用受支持的浏览器或加载图片。",
-      "qr_camera_permission_denied": "摄像头权限被拒绝。请在浏览器中允许摄像头访问，或加载图片。",
-      "qr_camera_failed": "无法启动摄像头",
-      "qr_image_failed": "在所选图片中未找到可读取的二维码",
-      "qr_invalid_matter": "此二维码不是 Matter 配对码（MT:…）。",
-      "qr_found": "已读取 Matter 二维码。配对将自动开始。",
-      "qr_decoder_unavailable": "无法加载二维码读取器。",
-      "devices_title": "已配对设备",
-      "col_name": "名称",
-      "col_product": "产品",
-      "col_state": "状态",
-      "no_devices": "尚未配对任何设备。",
-      "unpair_confirm": "移除（解除配对）设备",
-      "unpair_ok": "设备已移除。",
-      "deploy_first": "请先部署此配置节点，然后重试。",
-      "pairing_code_missing": "请输入配对码。",
-      "pairing_wait": "正在配对，最多可能需要一分钟...",
-      "pairing_failed": "配对失败",
-      "pairing_ok": "设备配对成功！",
-      "rename_button": "重命名",
-      "rename_prompt": "新的设备名称",
-      "rename_ok": "设备已重命名。",
-      "storage_title": "Fabric 和配网备份",
-      "storage_export": "导出",
-      "storage_import": "导入",
-      "storage_warning": "备份包含 Fabric 凭据、私钥和已配网设备数据。请像密码一样妥善保管。导入会替换此控制器的 Matter 存储并短暂重启。",
-      "storage_import_confirm": "要用所选备份替换此控制器的 Matter Fabric 和已配网设备吗？",
-      "storage_import_ok": "Matter 备份已导入，控制器已重启。"
-    }
-  }
-}

package/nodes/locales/zh-CN/matterbridge-config.html

@@ -1,45 +0,0 @@
-<script type="text/markdown" data-help-name="matterbridge-config">
-### 升级到 KNX Ultimate 8
-
-版本 7 会在此编辑器顶部显示一个小型的 **升级到 v8** 按钮。它会下载流程备份、安装所需的 HUE/Matter 软件包、转换兼容节点、执行完整部署、验证已保存的流程并安装版本 8。出现提示后必须重启 Node-RED 服务；仅重新加载浏览器并不足够。旧版 KNX AI 节点会停止自动操作。
-
-[完整升级指南](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/zh-CN-Upgrade-to-v8)
-
-<br/>
-
-# Matter 桥接器
-
-## 概述
-
-此配置节点就是 **Matter 桥接器本身**：它运行 Matter 服务器，Alexa、Google Home、Apple Home（或任何 Matter 控制器）只需配对**一次**。流程中的每个 **Matter Bridge device** 节点都指向这里，并在 App 中显示为桥接器的一个设备。
-
-## 配置
-
-|字段|说明|
-|--|--|
-| 名称 | 此配置节点在 Node-RED 中的名称 |
-| Matter 桥接器名称 | 桥接器本身在 Matter App 中显示的名称。**留空则使用此节点的名称。** |
-| 端口 | Matter 服务器的 UDP 端口（默认 5540）。每个桥接器需要独立的端口，因此可以运行**多个独立的桥接器** |
-
-## 配对
-
-1. **部署**，等待几秒，然后重新打开此节点。
-2. 配对面板显示**二维码**和**手动配对码**：在 Alexa / Google Home / Apple Home 中扫描或输入（"添加 Matter 设备"）。
-3. 多个控制器可以与同一个桥接器配对（Matter 多 fabric）。
-
-二维码隐藏后如需添加其他控制器，请从一个已配对的控制器开启配对模式，然后在新控制器中添加 Matter 设备。仅在需要移除所有现有控制器并重新开始时使用**重置配对**。
-
-**重置配对**按钮会移除所有已配对的控制器并重新开始配对广播。
-
-## 身份与存储
-
-桥接器身份与此配置节点绑定，保存在 Node-RED 用户目录的 `knxultimatestorage/matter` 中：重新部署（即使更改端口或名称）**不**需要重新配对。只有删除此配置节点并新建一个才会改变身份——此时请从 Matter App 中移除旧桥接器并重新配对。
-
-使用 **导出** 下载此网桥实例的完整备份，其中包含 Fabric、私有凭据、会话和配对数据。**请像密码一样保护此文件。** 导入会替换此实例的存储并短暂重启网桥。网桥备份不能导入控制器。
-
-## 说明
-
-- Node-RED 主机必须启用 **IPv6 link-local**（Matter 标准要求），并且控制器可在本地网络访问到它。
-- 添加/重命名/移除的设备节点会在几秒内被已配对的控制器识别，无需重新配对。
-- **名称：** Alexa 和 Google Home 会采用你在此设置的名称（桥接器名称和设备节点名称）。**Apple Home 会忽略它们，并要求你在配置过程中手动为每个配件命名**——这是 Apple 的限制，而非桥接器的问题。
-</script>

package/nodes/locales/zh-CN/matterbridge-config.json

@@ -1,25 +0,0 @@
-{
-  "matterbridge-config": {
-    "properties": {
-      "title": "Matter 桥接器",
-      "intro": "此配置节点就是 Matter 桥接器本身：Alexa、Google Home、Apple Home（或任何 Matter 控制器）配对一次即可看到你挂接的所有 KNX 设备。在流程中添加 \"Matter Bridge device\" 节点并指向这里。先部署，然后重新打开获取配对码。",
-      "node-config-input-name": "名称",
-      "bridge_name": "Matter 桥接器名称",
-      "bridge_name_ph": "留空则使用节点名称",
-      "port": "端口",
-      "pairing_title": "配对（Alexa、Google Home、Apple Home...）",
-      "not_running": "Matter 桥接器尚未运行。请先部署，等待几秒后点击刷新。",
-      "commissioned": "桥接器已与以下控制器配对：",
-      "commissioned_hint": "二维码已隐藏，因为桥接器已经配对。若要将 Alexa 添加为另一个 Matter 控制器，请先从上方已配对的控制器之一（例如 Apple Home 或 Google Home）打开配对模式，然后在 Alexa 中添加 Matter 设备。只有在要移除所有现有控制器并重新开始时，才使用重置配对。",
-      "awaiting": "等待配对。请在您的 Matter App 中扫描二维码或输入手动配对码：",
-      "qr_link": "在浏览器中打开二维码",
-      "deploy_first": "请先部署此配置节点，然后点击刷新。",
-      "reset_button": "重置配对",
-      "reset_confirm": "移除所有已配对的控制器并重新开始配对？设备将从 Alexa/Google/Apple 中消失。",
-      "reset_ok": "配对已重置。桥接器重新进入配对模式。",
-      "storage_title": "Fabric 和配网备份", "storage_export": "导出", "storage_import": "导入",
-      "storage_warning": "备份包含 Fabric 凭据、私钥和配对数据。请像密码一样妥善保管。导入会替换此网桥的 Matter 存储并短暂重启。",
-      "storage_import_confirm": "要用所选备份替换此网桥的 Matter Fabric 和已配对控制器吗？", "storage_import_ok": "Matter 备份已导入，网桥已重启。"
-    }
-  }
-}