@flowfuse/nr-project-nodes

中文文档
1.0.0发布于 2026/11/16Apache-2.0近 30 天下载 1.2万

用于在 FlowFuse 平台运行的节点-RED 实例之间方便通信的节点集

中文使用文档
文档目录6 节
  1. 先决条件
  2. 节点
  3. 释放过程
  4. 构成部分
  5. 拉动请求标题格式
  6. 处理中断更改

FlowFuse 项目节点

用于节点-RED实例之间方便通信的节点集 运行在 流线灯平台。 。 。 .

这些节点的作用与核心节点-RED链接节点类似 - 但可以是 用于在不同节点-RED实例和设备之间发送和接收消息.

虽然这些节点是在Apache-2.0许可证下发布的,但只能是 与FlowFuse平台的一个实例一起使用,并申请了有效的EE许可证. 如果您尝试在非流体 EE 平台上安装这些节点, 您将在您的节点- RED 日志中看到以下错误 : Error: Project Link nodes cannot be loaded outside of FlowFuse EE environment 这可以被安全忽略.

先决条件

  • FlowFuse 0.8+ 使用有效的 EE 许可证及其集成的 MQTT 经纪运行
  • FlowFuse 1.14+,用于与指定的应用程序设备进行通信
  • 提供 project-link/targets 应用意识的 API 目标,直接发送到应用程序指定设备和应用程序广播

或者,你可以 注册到"流花"云 现在试试这些节点.

节点

本集有三个节点:

  • Project In - 收听其他节点RED节目正在播放的信息,或 信件发送到此实例
  • Project Out - 向其他节点RED实例发送信息
  • Project Call - 向其他节点RED实例发送信息并等待答复

节点发送整个 msg 对象。 由于节点编码信息的方式, 有一些数据类型不被发送。 例如 msg.req编号 :msg.res 核心 HTTP 节点所使用的属性将不会发送。 而是暂时的 从信件中去除,并在收到回信时重新附载.

每个节点都配置了它发送或接收信件的主题 继续 这在概念上与 MQTT 主题类似 - 尽管节点目前没有 支持在主题中使用 MQTT 通配符.

"Out"项目节点可以向任何听者播放关于一个话题的信息, 或者,他们可以将关于某一主题的信息发送给特定的其他实例或远程实例.

二. 项目 在节点做相反的 - 他们可以听 消息是 或直接发给他们的信息.

广播通过两个频道之一发送和接收: 团队 频道(默认), 或 应用程序 频道,只有同一应用程序中的情况才能使用. 两道相分. 旧版本的节点(0.8.0前)不发送或接收应用程序广播. 如果一个流流运行在旧版本上, 应用程序播放 输出节点不发送任何信息, 应用程序 广播 在节点中,不接收团队广播(大多数情况下,它们接收直接发送到该实例的信息).

工程调用节点可用于向另一个工程发送消息 然后等待回应, 如果它不到达, 内置超时. 使用配置响应调用的项目输出节点发送回回复 节点.

释放过程

在这个项目中 释放请 用于根据代码库中的承诺信息自动确定下一个发布版本.

通过使用 常规武器委员会,项目遵守承诺信息的标准格式 Release Please 用于确定下一次发布是主要、次要还是补丁发布.

构成部分

  1. 这个 Prepare release GitHub 动作工作流程 :

    • 请分析信件的动作,以根据常规承诺的规格确定需要的释放类型(主要、次要、补丁)
    • 创建带有拟议版本凸起和更改日志的预放拉动请求
    • 合并后,自动更新版本编号 package.json 并在 GitHub 上创建新的版本,并附带适当的更改日志
  2. 这个 Lint Pull Request Title GitHub 动作工作流程 :

    • 运行于拉动请求创建和使用 amannn/action-semantic-pull-request 行动以验证拉动请求标题遵循《公约》格式
    • 与调整后的默认合并承诺消息一起,这确保所有合并到主分支中的承诺都遵守预期格式,允许发布请求正确运行

拉动请求标题格式

常规委员会预设的拉动请求标题格式如下:

<type>(<scope>): <subject>
  • 类型:描述承诺的类别。 例如:
    • feat:一个新的特性(触发一个小版本的凸起).
    • fix: a bug fix (触发补丁版本的出错).
    • perf: 代码更改能改善性能(触发补丁版本的出错).
    • refactor:一个代码更改,既不修补一个错误,也不添加一个特性(除非伴有 BREAKING CHANGE,否则不会触发发布).
    • docs: 仅文档更改(不触发发布).
    • chore: 构建过程或辅助工具和库的更改(不触发发布).
  • 范围:一个可选部分,提供关于所改变内容的额外上下文(例如模块,组件).
  • 主题:变化简介.

处理中断更改

为了表示突破性的变化,感叹标记 ! 应在类型/范围之后立即使用:

  • feat!:,
  • fix!:
  • refactor!:

版本与发布记录

@flowfuse/nr-project-nodes 共发布 200 个版本,首次发布于 2023/10/25;过去 12 个月发布了 111 个版本。

版本发布日期距今
1.0.0latest2026/11/16今天
1.0.1-85bfb3b-202611161051.0nightly2026/11/16今天
0.8.1-c61c6ba-202611161045.02026/11/16今天
0.8.1-5ebd3db-202611161036.02026/11/16今天
0.8.02026/11/16今天
0.7.10-95216a2-202611121423.02026/11/123 天前

其他发布通道:pre-staging-feat-pp-1 → 0.7.5-c54abfc-202501082055.0,nightly → 1.0.1-85bfb3b-202611161051.0。

关于 @flowfuse/nr-project-nodes 的常见问题

@flowfuse/nr-project-nodes 是什么?

用于在 FlowFuse 平台运行的节点-RED 实例之间方便通信的节点集

如何安装 @flowfuse/nr-project-nodes?

在项目目录运行 npm install @flowfuse/nr-project-nodes,或使用 pnpm add / yarn add / bun add。

@flowfuse/nr-project-nodes 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/flowfuse__nr-project-nodes 是否存在。

@flowfuse/nr-project-nodes 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16.x。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@flowfuse/nr-project-nodes 可以商用吗?

@flowfuse/nr-project-nodes 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@flowfuse/nr-project-nodes 的下载量有多少?

根据 npm 官方下载统计,@flowfuse/nr-project-nodes 在 2026/10/15 – 2026/11/13 这 30 天内被下载 12,250 次,日均约 408 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@flowfuse/nr-project-nodes 还在维护吗?

最新版本 1.0.0 发布于 2026/11/16(今天);至今共发布 200 个版本,其中过去 12 个月发布了 111 个;首次发布于 2023/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。