# @flowfuse/nr-project-nodes 中文文档

规范地址：https://npmcn.com/package/%40flowfuse/nr-project-nodes/

版本：1\.0\.0
npm 元数据更新时间：2026-11-16T10:53:59.553Z
中文译文更新时间：2026-11-16T11:10:32.174Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40flowfuse/nr-project-nodes
原文对照：https://npmcn.com/package/%40flowfuse/nr-project-nodes/?lang=original
项目主页：https://github.com/FlowFuse/nr-project-nodes#readme
源码仓库：https://github.com/FlowFuse/nr-project-nodes

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：314 kB，26 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=16\.x
- 运行依赖：5 个
- 首次发布：2023-10-24T16:24:57.880Z
- 最新版本发布：2026-11-16T10:53:59.300Z
- 近 30 天下载量：12250（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：200（近 12 个月 111 个）

## 中文简介

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

## 安装

```sh
npm install @flowfuse/nr-project-nodes
```

也可以使用：`pnpm add @flowfuse/nr-project-nodes`、`yarn add @flowfuse/nr-project-nodes`、`bun add @flowfuse/nr-project-nodes`

## README

# FlowFuse 项目节点

用于节点-RED实例之间方便通信的节点集 运行在 [流线灯平台](https://flowfuse.com/)。 。 。 .

这些节点的作用与核心节点-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 目标,直接发送到应用程序指定设备和应用程序广播

或者,你可以 [注册到"流花"云](https://flowfuse.com/product/) 现在试试这些节点.

### 节点

本集有三个节点:

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

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

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

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

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

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

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

## 释放过程

在这个项目中 [释放请](https://github.com/googleapis/release-please) 用于根据代码库中的承诺信息自动确定下一个发布版本.

通过使用 [常规武器委员会](https://www.conventionalcommits.org/en/v1.0.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 是什么？

用于在 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 和提交记录判断。

