node-red-contrib-knx-ultimate 6.2.3-beta.2 → 6.2.3-beta.4

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueContactSensor">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点将 HUE 接触传感器事件映射到 KNX 组地址。</p>
 
 开始输入GA字段，KNX设备的名称或组地址，可用设备在输入时开始显示。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueController">
-<p><a href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E" target="_blank" rel="noopener noreferrer"><strong>KNX-Ultimate 视频教程（YouTube 播放列表）</strong></a></p>
+<p><a href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E" target="_blank" rel="noopener noreferrer"><strong>KNX-Ultimate 视频教程（YouTube 播放列表）</strong></a> 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p><strong>HUE Controller</strong> 是面向 Hue API v2 资源的统一节点。</p>
 <p>选择设备功能，然后使用原有专用 Hue 节点中已经稳定的 KNX 映射和行为设置。</p>
 <p>设备功能选择器使用可用宽度的三分之一，使编辑器保持紧凑。</p>
@@ -9,8 +9,8 @@
 <p>对于单灯，<strong>调光</strong>、<strong>可调白光</strong>、<strong>RGB/HSV</strong> 和原生效果部分会根据所选 Hue API v2 资源实时报告的能力显示。当灯具提供 <code>dimming</code>、<code>color_temperature</code> 或 <code>color</code> 时，相应的 KNX 映射会自动出现。</p>
 <p>Hue Bridge 加载资源期间，灯光编辑器会显示旋转的沙漏，并每 500 毫秒检查一次就绪状态。约 10 秒后编辑器会解除等待，映射选项卡保持隐藏，并显示本地化错误。保存、关闭或切换功能都会取消尚未结束的等待。</p>
 <p>选择网关后，映射字段可输入 KNX 组地址或从 ETS 导入的名称；兼容的数据点会从该网关加载。</p>
-<p>仅当 Node-RED 编辑器在当前流程中检测到至少一个旧版 HUE 节点时，才会显示迁移按钮。每个旧版 HUE 编辑器的弃用提示下方也提供相同的橙色按钮。</p>
-<p><strong>转换旧版 HUE 节点</strong>会完全在浏览器中完成转换，不会发送任何流程或节点数据。成功完成本地转换后，浏览器会打开一封发给作者的可编辑邮件草稿，而不会离开 Node-RED，并在新窗口中打开捐赠页面。草稿只包含已转换节点数量和可选备注空间，绝不会自动发送，也不会向 PayPal 链接添加任何流程数据。</p>
+<p>仅当 Node-RED 编辑器在当前流程中检测到至少一个旧版 HUE 节点时，才会显示迁移按钮。每个旧版 HUE 编辑器的弃用提示下方也提供带白色文字的相同高对比度橙色按钮。</p>
+<p><strong>转换旧版 HUE 节点</strong>会完全在浏览器中完成转换，不会发送任何流程或节点数据。成功完成本地转换后，浏览器只会打开一封发给作者的可编辑邮件草稿，而不会离开 Node-RED。草稿只包含已转换节点数量和可选备注空间，绝不会自动发送。最终的 Node-RED 消息会提供一个可选的支持按钮；只有点击该按钮时才会打开捐赠页面。</p>
 <p>开始之前，请先导出流程备份。编辑器只把检测到的旧版 HUE 节点转换为 HUE Controller 实例。原有属性、配置引用、位置、分组和连线都保持不变。流程会标记为已修改，但不会自动部署：请检查后自行点击 <strong>Deploy</strong>。节点已变化、流程被锁定或发生本地转换错误时，流程不会发生变化。<strong>安全检查：</strong>点击 Deploy 前，请逐一检查所有已修改 HUE 节点的功能、配置引用、输入/输出端口和连线。处理完成后，Node-RED 的固定消息会一直显示，直到点击<strong>确定</strong>。</p>
 <p>Hue 事件仍然只是状态更新，不会变成新的 Hue 命令。HUE Controller 内置私有的运行时、编辑器、模板和翻译配置，因此不依赖加载已弃用的节点类型。原始 Hue Light 节点保持不变。原有专用 Hue 节点仍会注册以兼容现有流程，但这些节点现已冻结，不再获得新功能或维护更新。Node-RED 会从节点面板中隐藏其特殊的 <code>deprecated</code> 分类；现有实例仍可编辑和部署，颜色比 HUE Controller 更浅，会在画布上标记为 <code>(deprecated)</code>，编辑器顶部也会显示迁移提示。</p>
 

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

@@ -8,21 +8,24 @@
     "legacy_node_notice": "此旧版 HUE 节点已弃用。新流程请使用新的 HUE Controller 节点。",
     "migration_button": "转换旧版 HUE 节点",
     "migration_button_title": "转换编辑器中的所有旧版 HUE 节点",
-    "migration_disclaimer": "转换完全在浏览器中进行，不会发送任何流程或节点数据。随后会打开可编辑的邮件草稿，并在新窗口中打开捐赠页面；不会自动发送任何内容，也不会向 PayPal 链接添加任何流程数据。",
+    "migration_video": "视频指南",
+    "migration_video_title": "在 YouTube 上观看旧版 HUE 节点转换指南",
+    "migration_disclaimer": "转换完全在浏览器中进行，不会发送任何流程或节点数据。随后只会打开可编辑的邮件草稿，不会自动发送任何内容。只有您选择最终消息中的可选支持按钮时，才会打开捐赠页面。",
     "migration_title": "转换旧版 HUE 节点",
     "migration_confirm": "将在编辑器中直接转换 {{count}} 个旧版 HUE 节点。",
     "migration_privacy": "转换完全在此浏览器中进行。不会传输或保留任何流程、节点、配置、凭据、组地址或连线数据。",
-    "migration_email_notice": "转换后，邮件应用会打开一封收件人为作者的可编辑草稿，而不会离开 Node-RED 页面；浏览器新窗口会打开捐赠页面。草稿只包含已转换节点的数量和可选备注区域；不会自动发送，也不会向 PayPal 链接添加任何流程数据。",
+    "migration_email_notice": "转换后，邮件应用会打开一封收件人为作者的可编辑草稿，而不会离开 Node-RED 页面。草稿只包含已转换节点的数量和可选备注区域；不会自动发送。最终的 Node-RED 消息会提供一个支持 KNX Ultimate 的可选按钮。",
     "migration_email_subject": "KNX Ultimate - 已使用旧版 HUE 转换",
     "migration_email_body": "Massimo，您好：\n\n我使用了旧版 HUE 节点转换按钮。\n已转换的旧版 HUE 节点：{{count}}。\n\n可选备注：\n",
     "migration_email_failed": "节点已转换，但无法打开邮件草稿。",
-    "migration_donation_failed": "节点已转换，但无法打开捐赠页面。",
+    "migration_donation_failed": "无法打开捐赠页面。您可以重试。",
     "migration_deploy_notice": "继续之前，请先导出流程备份。当前编辑器将关闭。只修改旧版 HUE 节点；所有配置节点和连线保持不变。请检查结果，然后自行点击 Deploy。",
     "migration_review_notice": "安全检查：转换后，请逐一检查流程中所有已修改的 HUE 节点。点击 Deploy 前，请确认所选功能、配置引用、输入/输出端口和连线均正确。",
     "migration_convert": "转换 HUE 节点",
     "migration_close": "取消",
+    "migration_donate": "支持 KNX Ultimate ❤️",
     "migration_ok": "确定",
-    "migration_success": "处理完成。已转换 {{count}} 个旧版 HUE 节点。点击 Deploy 前，请逐一检查所有已修改节点的功能、配置、端口和连线。",
+    "migration_success": "处理完成。已转换 {{count}} 个旧版 HUE 节点。点击 Deploy 前，请逐一检查所有已修改节点的功能、配置、端口和连线。如果本次转换为您节省了时间，可以通过下方的可选按钮支持 KNX Ultimate 的持续开发。",
     "migration_failed": "本地 HUE 迁移失败；流程未被修改：",
     "migration_none": "未找到旧版 HUE 节点。",
     "migration_unavailable": "HUE 迁移工具不可用。更新软件包后请重启 Node-RED。",

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueHumiditySensor">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点从 HUE 湿度传感器读取相对湿度 (%) 并映射到 KNX。</p>
 
 在 GA 字段中开始输入（名称或组地址）以关联 KNX GA；输入时会显示匹配的设备。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLight">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>此节点使您可以控制飞利浦色调灯和分组的灯光，还可以将此灯的状态发送到KNX巴士。</p>
 
 **一般的**

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLightSensor">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点从 HUE 光照传感器读取 Lux 事件并发布到 KNX。</p>
 
 每当环境光变化时会输出 Lux 值。在 GA 字段输入 KNX 设备名或组地址（自动补全）以进行关联。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueMotion">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点订阅 Hue 运动传感器的事件，并将其同步到 KNX 以及 Node-RED 流程。</p>
 
 在 GA 字段输入 KNX 设备名称或组地址即可自动补全；"Hue 传感器”旁的刷新按钮可重新加载 Hue 设备列表。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuePlug">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 # Hue 插座 / Plug
 
 ## 概述

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueScene">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 **Hue Scene** 节点将 Hue 场景发布到 KNX，并且可以把 Hue 的原始事件发送到 Node-RED 流程。场景字段支持自动补全；在网桥中新增场景后，请点击刷新图标更新列表。
 
 ### 选项卡概览

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTapDial">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 **Hue Tap Dial** 节点将 Tap Dial 的旋转服务映射到 KNX，并把原始 Hue 事件发送到 Node-RED 流程。配对新设备后，请点击设备字段旁的刷新图标。
 
 ### 选项卡

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTemperatureSensor">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>此节点读取 HUE 温度传感器的温度（°C），并将其映射到 KNX。</p>
 
 在 GA 字段（名称或组地址）中输入以关联 KNX GA；输入时会显示设备建议。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueZigbeeConnectivity">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点从 HUE 设备读取 Zigbee 连接状态，并发布到 KNX。</p>
 
 在 GA 字段输入 KNX 设备名或组地址，输入时会自动联想。

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

@@ -1,5 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuedevice_software_update">
-<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中的橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后会打开一封可编辑的邮件草稿，并在浏览器新窗口中打开捐赠页面。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”。</p>
+<p><strong>已弃用：</strong>此专用 HUE 节点仍可用于现有流程。新项目请使用 <strong>HUE Controller</strong>。旧版节点会在节点面板和画布上标记为 <code>(deprecated)</code>，颜色比 HUE Controller 更浅，编辑器顶部也会显示迁移提示。 此编辑器中带白色文字的高对比度橙色迁移按钮会在本地转换所有旧版 HUE 节点；完成后只会打开一封可编辑的邮件草稿。邮件绝不会自动发送。流程结束后，Node-RED 的固定消息会一直显示，直到您点击“确定”，并提供一个可选支持按钮；只有点击该按钮时才会打开捐赠页面。 开始前，请<a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">在 YouTube 上观看说明视频</a>。</p>
 <p>该节点监控 HUE 设备的软件更新状态，并发布到 KNX。</p>
 
 开始在GA字段中键入KNX设备的名称或组地址，可用的设备开始显示

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

@@ -15,7 +15,7 @@
 
 无需手动输入二维码 payload：点击**摄像头**可实时扫描，点击**图片**可从本地照片读取。支持浅色背景上的标准深色二维码以及深色背景上的反白二维码。解码完全在浏览器中进行；读取到有效的 Matter 二维码后，编辑器会填写配对码并立即自动开始配对。如需设置可选设备名称，请在扫描前填写。手动输入的配对码仍需点击**配对**才会开始。实时使用摄像头要求通过 HTTPS 或从 `localhost` 打开编辑器；若条件不满足，编辑器会说明此限制，而图片加载功能仍然可用。
 
-配对期间，阻塞式等待面板会覆盖编辑器并阻止进一步点击，直到操作成功完成或失败。
+配对期间，阻塞式面板会覆盖编辑器并阻止进一步点击，直到操作成功完成或失败。进度条跟随 matter.js 的实际阶段，并以英文显示当前操作。当设备公开产品身份时，面板还会显示产品名称、Vendor ID 和 Product ID。
 
 如果设备是全新的且仅支持蓝牙配对，请先用厂商 App 或其他 Matter 控制器（Alexa、Google Home、Apple Home）配对，然后使用其**"与其他中枢共享/配对"**功能为 KNX-Ultimate 生成新的配对码。这样设备可以同时加入多个 fabric。
 

package/nodes/matter-config.html

@@ -22,6 +22,11 @@
             var $devicesBody = $("#matter-devices-body");
             var $refreshDevices = $("#matterRefreshDevices");
             var $pairSpinner = $("#matterPairSpinner");
+            var $pairProgress = $("#matter-pairing-progress");
+            var $pairProgressBar = $("#matter-pairing-progress-bar");
+            var $pairProgressPercent = $("#matter-pairing-progress-percent");
+            var $pairProgressDescription = $("#matter-pairing-progress-description");
+            var $pairProgressDevice = $("#matter-pairing-progress-device");
             var $storageExport = $('#matter-storage-export');
             var $storageImport = $('#matter-storage-import');
             var $storageFile = $('#matter-storage-file');
@@ -35,6 +40,8 @@
             var qrScannerControls = null;
             var qrScannerStarting = false;
             var qrUtils = window.KNXUltimateMatterQrScanner;
+            var pairingProgressTimer = null;
+            var pairingOperationId = '';
 
             function qrText(key) {
                 return RED._("node-red-contrib-knx-ultimate/matter-config:matter-config.properties." + key);
@@ -183,7 +190,10 @@
                 this.value = '';
                 scanQrImage(file);
             });
-            node._matterQrCleanup = stopQrCamera;
+            node._matterQrCleanup = function () {
+                stopQrCamera();
+                stopPairingProgress();
+            };
 
             function storageExportUrl() {
                 var adminRoot = (RED.settings && typeof RED.settings.httpAdminRoot === 'string') ? RED.settings.httpAdminRoot : '/';
@@ -209,6 +219,44 @@
                 });
             }
 
+            function setPairingProgress(data) {
+                if (!data) return;
+                var percent = Number(data.percent);
+                if (!isFinite(percent)) percent = 0;
+                percent = Math.max(0, Math.min(100, Math.round(percent)));
+                $pairProgress.attr('aria-valuenow', percent);
+                $pairProgressBar.css('width', percent + '%');
+                $pairProgressPercent.text(percent + '%');
+                if (data.message) $pairProgressDescription.text(data.message);
+                if (data.device && data.device.productName) {
+                    var details = data.device.productName;
+                    if (data.device.vendorId !== undefined) details += ' · VID ' + data.device.vendorId;
+                    if (data.device.productId !== undefined) details += ' · PID ' + data.device.productId;
+                    $pairProgressDevice.text(details).show();
+                }
+            }
+
+            function stopPairingProgress() {
+                if (pairingProgressTimer !== null) clearInterval(pairingProgressTimer);
+                pairingProgressTimer = null;
+                pairingOperationId = '';
+            }
+
+            function startPairingProgress(operationId) {
+                stopPairingProgress();
+                pairingOperationId = operationId;
+                $pairProgressDevice.empty().hide();
+                setPairingProgress({ percent: 2, message: 'Preparing Matter commissioning…' });
+                pairingProgressTimer = setInterval(function () {
+                    var activeOperationId = pairingOperationId;
+                    if (!activeOperationId) return;
+                    $.getJSON('KNXUltimateMatterPairProgress?serverId=' + encodeURIComponent(node.id) + '&operationId=' + encodeURIComponent(activeOperationId) + '&_=' + Date.now(), function (data) {
+                        if (activeOperationId !== pairingOperationId || !data || data.operationId !== activeOperationId) return;
+                        setPairingProgress(data);
+                    });
+                }, 400);
+            }
+
             function renderDevices(devices) {
                 $devicesBody.empty();
                 if (!Array.isArray(devices) || devices.length === 0) {
@@ -293,15 +341,20 @@
                     return;
                 }
                 $pairButton.prop('disabled', true);
+                var operationId = 'matter-' + Date.now() + '-' + Math.random().toString(36).slice(2, 10);
+                var pairingSucceeded = false;
+                startPairingProgress(operationId);
                 $pairSpinner.show();
                 $.ajax({
-                    url: 'KNXUltimateMatterPair?serverId=' + node.id + '&code=' + encodeURIComponent(code) + (desiredName !== '' ? '&name=' + encodeURIComponent(desiredName) : ''),
+                    url: 'KNXUltimateMatterPair?serverId=' + encodeURIComponent(node.id) + '&operationId=' + encodeURIComponent(operationId) + '&code=' + encodeURIComponent(code) + (desiredName !== '' ? '&name=' + encodeURIComponent(desiredName) : ''),
                     dataType: 'json',
                     timeout: 180000
                 }).done(function (data) {
                     if (data && data.error) {
                         notifyPairingError(data.error);
                     } else {
+                        pairingSucceeded = true;
+                        setPairingProgress({ percent: 100, message: 'Matter commissioning completed successfully.' });
                         var pairedName = data.name || data.productName || data.nodeId;
                         RED.notify(RED._("node-red-contrib-knx-ultimate/matter-config:matter-config.properties.pairing_ok") + ' ' + pairedName + ' (Node ID ' + data.nodeId + ')', { type: 'success' });
                         if (data.renameError) RED.notify(data.renameError, { type: 'warning', fixed: true });
@@ -314,8 +367,10 @@
                     try { msg = jqXHR.responseJSON.error; } catch (e) { msg = errorThrown || textStatus; }
                     notifyPairingError(msg);
                 }).always(function () {
+                    stopPairingProgress();
                     $pairButton.prop('disabled', false);
-                    $pairSpinner.hide();
+                    if (pairingSucceeded) setTimeout(function () { $pairSpinner.hide(); }, 350);
+                    else $pairSpinner.hide();
                 });
             });
 
@@ -496,9 +551,15 @@
 
   <div id="matterPairSpinner" role="alertdialog" aria-modal="true" aria-labelledby="matter-pairing-overlay-message"
        style="display:none; position:fixed; inset:0; z-index:100000; background:rgba(20, 24, 28, 0.72); cursor:wait;">
-    <div style="position:absolute; top:50%; left:50%; transform:translate(-50%, -50%); min-width:280px; max-width:80vw; padding:28px 34px; border-radius:8px; background:#fff; color:#333; text-align:center; box-shadow:0 8px 30px rgba(0,0,0,0.4);">
-      <i class="fa fa-circle-notch fa-spin" aria-hidden="true" style="display:block; margin-bottom:16px; color:#1b7d33; font-size:54px;"></i>
-      <strong id="matter-pairing-overlay-message" data-i18n="matter-config.properties.pairing_wait" style="font-size:16px;"></strong>
+    <div style="position:absolute; top:50%; left:50%; transform:translate(-50%, -50%); width:460px; max-width:80vw; padding:28px 34px; border-radius:8px; background:#fff; color:#333; text-align:center; box-shadow:0 8px 30px rgba(0,0,0,0.4);">
+      <strong id="matter-pairing-overlay-message" data-i18n="matter-config.properties.pairing_wait" style="display:block; margin-bottom:18px; font-size:16px;"></strong>
+      <div id="matter-pairing-progress" role="progressbar" aria-label="Matter commissioning progress" aria-valuemin="0" aria-valuemax="100" aria-valuenow="0"
+           style="position:relative; width:100%; height:20px; overflow:hidden; border-radius:10px; background:#66717a; box-shadow:inset 0 1px 3px rgba(0,0,0,0.22);">
+        <div id="matter-pairing-progress-bar" style="width:0; height:100%; border-radius:10px; background:#1b7d33; transition:width 250ms ease;"></div>
+        <span id="matter-pairing-progress-percent" style="position:absolute; inset:0; color:#fff; font-size:12px; font-weight:bold; line-height:20px; text-shadow:0 1px 2px #000;">0%</span>
+      </div>
+      <div id="matter-pairing-progress-description" aria-live="polite" style="min-height:20px; margin-top:14px; font-size:14px; line-height:20px;">Preparing Matter commissioning…</div>
+      <div id="matter-pairing-progress-device" style="display:none; margin-top:7px; color:#666; font-size:12px;"></div>
     </div>
   </div>
 

package/nodes/matter-config.js

@@ -22,6 +22,13 @@ module.exports = (RED) => {
     node.matterManager = null
     node.timerMatterConfigCheckState = null
     node.storageOperation = null
+    node.commissioningProgress = {
+      active: false,
+      operationId: '',
+      sequence: 0,
+      percent: 0,
+      message: 'Waiting for commissioning to start.'
+    }
     try {
       node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'matter-config.js' })
     } catch (error) { console.log(error.stack) }
@@ -247,6 +254,50 @@ module.exports = (RED) => {
       return node.matterManager.commission(_pairingCode, _options)
     }
 
+    node.beginCommissioningProgress = (_operationId) => {
+      if (node.commissioningProgress.active === true) return false
+      node.commissioningProgress = {
+        active: true,
+        operationId: String(_operationId || ''),
+        sequence: node.commissioningProgress.sequence + 1,
+        percent: 2,
+        phase: 'starting',
+        message: 'Preparing Matter commissioning…',
+        updatedAt: Date.now()
+      }
+      return true
+    }
+
+    node.reportCommissioningProgress = (_operationId, _progress = {}) => {
+      if (node.commissioningProgress.operationId !== String(_operationId || '')) return false
+      const numericPercent = Number(_progress.percent)
+      const previousPercent = Number(node.commissioningProgress.percent) || 0
+      node.commissioningProgress = {
+        ...node.commissioningProgress,
+        ..._progress,
+        active: true,
+        operationId: node.commissioningProgress.operationId,
+        sequence: node.commissioningProgress.sequence + 1,
+        percent: Number.isFinite(numericPercent) ? Math.max(previousPercent, Math.min(100, Math.max(0, numericPercent))) : previousPercent,
+        updatedAt: Date.now()
+      }
+      return true
+    }
+
+    node.endCommissioningProgress = (_operationId, _progress = {}) => {
+      if (node.commissioningProgress.operationId !== String(_operationId || '')) return false
+      node.reportCommissioningProgress(_operationId, _progress)
+      node.commissioningProgress.active = false
+      return true
+    }
+
+    node.getCommissioningProgress = (_operationId) => {
+      if (node.commissioningProgress.operationId !== String(_operationId || '')) {
+        return { active: false, percent: 0, message: 'Waiting for commissioning to start.' }
+      }
+      return { ...node.commissioningProgress }
+    }
+
     node.removeCommissionedNode = async (_nodeId) => {
       if (node.matterManager === null) throw new Error('Matter controller not started')
       return node.matterManager.removeNode(_nodeId)

package/nodes/utils/matterEngine.mjs

@@ -88,15 +88,95 @@ class classMatter extends EventEmitter {
     const { Environment, StorageService, Logger, LogLevel } = await import('@matter/main')
     const { Seconds } = await import('@matter/general')
     const { CommissioningController } = await import('@project-chip/matter.js')
+    const { ControllerCommissioningFlow } = await import('@matter/protocol')
     const { NodeStates } = await import('@project-chip/matter.js/device')
     const { ManualPairingCodeCodec, QrPairingCodeCodec, NodeId } = await import('@matter/main/types')
     const { BasicInformation, GeneralCommissioning } = await import('@matter/main/clusters')
     this._api = {
-      Environment, StorageService, Logger, LogLevel, Seconds, CommissioningController, NodeStates, ManualPairingCodeCodec, QrPairingCodeCodec, NodeId, BasicInformation, GeneralCommissioning
+      Environment, StorageService, Logger, LogLevel, Seconds, CommissioningController, ControllerCommissioningFlow, NodeStates, ManualPairingCodeCodec, QrPairingCodeCodec, NodeId, BasicInformation, GeneralCommissioning
     }
     return this._api
   }
 
+  _reportCommissioningProgress = (_callback, progress) => {
+    if (typeof _callback !== 'function') return
+    try {
+      _callback(progress)
+    } catch (error) {
+      this._log('warn', `classMatter: commissioning progress callback: ${error.message}`)
+    }
+  }
+
+  _createProgressCommissioningFlow = (_callback) => {
+    const BaseFlow = this._api.ControllerCommissioningFlow
+    const report = (progress) => this._reportCommissioningProgress(_callback, progress)
+    const descriptions = {
+      GetInitialData: { percent: 22, message: 'Reading commissioning information from the device…' },
+      'GeneralCommissioning.ArmFailsafe': { percent: 30, message: 'Arming the device fail-safe timer…' },
+      'GeneralCommissioning.ConfigureRegulatoryInformation': { percent: 36, message: 'Applying regulatory configuration…' },
+      'TimeSynchronization.SynchronizeTime': { percent: 42, message: 'Synchronizing the device clock…' },
+      'OperationalCredentials.DeviceAttestation': { percent: 50, message: 'Verifying device identity and attestation…' },
+      'OperationalCredentials.Certificates': { percent: 62, message: 'Installing operational credentials…' },
+      AccessControl: { percent: 72, message: 'Configuring Matter access control…' },
+      'NetworkCommissioning.Validate': { percent: 76, message: 'Checking the device network configuration…' },
+      'NetworkCommissioning.Wifi': { percent: 78, message: 'Connecting the device to the Wi-Fi network…' },
+      'NetworkCommissioning.Thread': { percent: 78, message: 'Connecting the device to the Thread network…' },
+      Reconnect: { percent: 84, message: 'Reconnecting through the operational CASE session…' },
+      'GeneralCommissioning.Complete': { percent: 92, message: 'Completing commissioning on the device…' },
+      'OperationalCredentials.UpdateFabricLabel': { percent: 96, message: 'Applying the Matter fabric label…' },
+      'AdditionalLogic.AddDefaultOtaProvider': { percent: 97, message: 'Configuring the default OTA provider…' }
+    }
+
+    return class ProgressCommissioningFlow extends BaseFlow {
+      constructor (...args) {
+        super(...args)
+        this.commissioningSteps.forEach((step) => {
+          const stepLogic = step.stepLogic
+          step.stepLogic = async () => {
+            const description = descriptions[step.name] || {
+              percent: 20,
+              message: `Running Matter commissioning step ${step.stepNumber}.${step.subStepNumber}: ${step.name}…`
+            }
+            const device = this.collectedCommissioningData?.productName
+              ? {
+                  productName: this.collectedCommissioningData.productName,
+                  vendorId: this.collectedCommissioningData.vendorId,
+                  productId: this.collectedCommissioningData.productId
+                }
+              : undefined
+            report({
+              phase: 'commissioning',
+              step: `${step.stepNumber}.${step.subStepNumber}`,
+              stepName: step.name,
+              percent: description.percent,
+              message: description.message,
+              device
+            })
+            const result = await stepLogic()
+            // GetInitialData is the first point where the commissionee may have exposed
+            // its product identity. Publish it immediately instead of waiting for the
+            // following step to make the editor show it.
+            if (step.name === 'GetInitialData' && this.collectedCommissioningData?.productName) {
+              report({
+                phase: 'commissioning',
+                step: `${step.stepNumber}.${step.subStepNumber}`,
+                stepName: step.name,
+                percent: 28,
+                message: 'Device identified. Preparing secure commissioning…',
+                device: {
+                  productName: this.collectedCommissioningData.productName,
+                  vendorId: this.collectedCommissioningData.vendorId,
+                  productId: this.collectedCommissioningData.productId
+                }
+              })
+            }
+            return result
+          }
+        })
+      }
+    }
+  }
+
   _resolveTargetHosts = async (_targetHost) => {
     const host = normalizeHostForCompare(_targetHost)
     if (host === '') return []
@@ -286,6 +366,12 @@ class classMatter extends EventEmitter {
     let passcode
     let identifierData
     const discoveryCapabilities = { onIpNetwork: true }
+    const onProgress = _options?.onProgress
+    this._reportCommissioningProgress(onProgress, {
+      phase: 'preparing',
+      percent: 5,
+      message: 'Validating the Matter pairing code…'
+    })
     if (code.toUpperCase().startsWith('MT:')) {
       const qr = api.QrPairingCodeCodec.decode(code)[0]
       passcode = qr.passcode
@@ -305,6 +391,11 @@ class classMatter extends EventEmitter {
       }
       const targetHost = (_options?.targetHost || '').toString().trim()
       if (targetHost !== '') {
+        this._reportCommissioningProgress(onProgress, {
+          phase: 'discovery',
+          percent: 10,
+          message: `Looking for the Matter device at ${targetHost}…`
+        })
         const commissionableDevice = await this._discoverCommissionableDeviceAtHost(identifierData, discoveryCapabilities, targetHost)
         discovery = commissionableDevice !== undefined
           ? {
@@ -319,6 +410,11 @@ class classMatter extends EventEmitter {
       let lastError
       for (const discoveryAttempt of discoveryAttempts) {
         try {
+          this._reportCommissioningProgress(onProgress, {
+            phase: 'pase',
+            percent: 15,
+            message: 'Discovering the device and establishing a secure PASE session…'
+          })
           nodeId = await this.controller.commissionNode({
             commissioning: {
               nodeId: commissioningNodeId,
@@ -326,7 +422,10 @@ class classMatter extends EventEmitter {
             },
             discovery: discoveryAttempt,
             passcode
-          }, { connectNodeAfterCommissioning: false })
+          }, {
+            connectNodeAfterCommissioning: false,
+            commissioningFlowImpl: this._createProgressCommissioningFlow(onProgress)
+          })
           lastError = undefined
           break
         } catch (error) {
@@ -355,12 +454,22 @@ class classMatter extends EventEmitter {
       throw error
     }
     try {
+      this._reportCommissioningProgress(onProgress, {
+        phase: 'attaching',
+        percent: 98,
+        message: 'Loading the commissioned device structure…'
+      })
       await this._attachNode(nodeId)
     } catch (error) {
       // Pairing succeeded: never report it as failed just because the first connection
       // attempt errored. The node will be attached again at the next controller start.
       this._log('warn', `classMatter: commission: node ${nodeId} paired but not yet attached: ${error.message}`)
     }
+    this._reportCommissioningProgress(onProgress, {
+      phase: 'complete',
+      percent: 100,
+      message: 'Matter commissioning completed successfully.'
+    })
     return nodeId.toString()
   }
 

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.2.3-beta.2",
+  "version": "6.2.3-beta.4",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",