# @flowfuse/mqtt-schema-agent 中文文档

规范地址：https://npmcn.com/package/%40flowfuse/mqtt-schema-agent/

版本：1\.1\.3
npm 元数据更新时间：2026-07-02T13:16:38.919Z
中文译文更新时间：2026-11-15T00:22:03.526Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：36.8 kB，11 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.x
- 运行依赖：5 个
- 首次发布：2025-02-05T15:23:26.776Z
- 最新版本发布：2026-07-02T13:16:38.742Z
- 近 30 天下载量：7791（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 3 个）

## 中文简介

收集 MQTT 专题Schema 代理

## 安装

```sh
npm install @flowfuse/mqtt-schema-agent
```

也可以使用：`pnpm add @flowfuse/mqtt-schema-agent`、`yarn add @flowfuse/mqtt-schema-agent`、`bun add @flowfuse/mqtt-schema-agent`

## README

# 从 MQTT 经纪公司收集活动主题的工具

无意手动运行, 应该由 FlowFuse k8s 驱动程序启动

## 释放过程

在这个项目中 [释放请](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/mqtt-schema-agent 是什么？

收集 MQTT 专题Schema 代理

### 如何安装 @flowfuse/mqtt-schema-agent？

在项目目录运行 npm install @flowfuse/mqtt-schema-agent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mqtt-schema-agent，可以用 npx mqtt-schema-agent 直接运行。

### @flowfuse/mqtt-schema-agent 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/flowfuse\_\_mqtt-schema-agent 是否存在。

### @flowfuse/mqtt-schema-agent 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @flowfuse/mqtt-schema-agent 需要什么版本的 Node\.js？

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

### @flowfuse/mqtt-schema-agent 可以商用吗？

@flowfuse/mqtt-schema-agent 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @flowfuse/mqtt-schema-agent 的下载量有多少？

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

### @flowfuse/mqtt-schema-agent 还在维护吗？

最新版本 1\.1\.3 发布于 2026/07/02（4 个月前）；至今共发布 10 个版本，其中过去 12 个月发布了 3 个；首次发布于 2025/02/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。