MQTTX 1.13.1 发布:AI Agent Skill 与 MQTT 5.0 订阅用户属性

MQTTX 1.13.1 现已发布。这个版本让 AI 编码 Agent 更方便地使用 MQTTX CLI,并为 Desktop 和 Web 的订阅加入 MQTT 5.0 用户属性支持。此外,本次更新还改进了消息导出,为 CLI 增加接收时间戳,并修复了 Topic 和 Payload 渲染中的安全问题。
下载 MQTTX,或查看 1.13.1 完整更新日志。
MQTTX CLI 的 AI Agent Skill
MQTTX 仓库新增了面向 Agent 的安装指南和 mqttx-cli Skill,可供 Claude Code、Codex、Cursor 等编码助手使用。Skill 提供命令参考与操作流程,覆盖连接检查、消息收发验证、压测和数据模拟。
安装 MQTTX CLI 后,执行以下命令安装 Skill:
npx skills add emqx/MQTTX --skill mqttx-cli
随后可以让 Agent 使用唯一主题,在指定时间内验证本地 broker 的消息收发。安装提示词和完整示例见 MQTTX AI Agent Skill 正式发布。
这项集成通过 MQTTX CLI 运行,无需打开 Desktop 应用。
MQTT 5.0 订阅用户属性
Desktop 和 Web 现在都可以为订阅添加用户属性。这些键值对会随 MQTT 5.0 SUBSCRIBE 报文发送,可用于携带 broker 支持的订阅元数据。
将连接协议设为 MQTT 5.0,打开订阅对话框,即可在订阅标识符旁添加用户属性。保存后,将鼠标移到订阅列表的 Topic 上,就能在提示中查看这些属性,无需再次打开编辑器。
编辑和重新订阅时,MQTTX 会保留用户属性。再次订阅已有主题时,列表中保存的订阅选项也会与实际发往 broker 的选项同步。重复键和空值同样会被保留。
例如,订阅 EMQX MQTT Streams 时,可以用 stream-offset: earliest 请求从流的起点回放消息。用户属性的具体含义由 broker 决定,MQTTX 负责发送配置的值。实现细节见订阅用户属性更新。
更清晰、可靠的数据导出
消息导出的进度现在按已处理的消息数量计算。即使数据只来自一个连接,导出大量消息时也能逐步显示进度。
本次修复还移除了 JSON、YAML 和 XML 导出中的重复字段。CSV 和 Excel 改为每条消息占一行,将 Topic、Payload、QoS 等字段放入独立列;Excel 则按连接分为多个工作表,便于检查和后续处理。详见导出修复。
更多客户端控制选项
- Desktop:新增韩语界面。GPU 加速设置允许在排查渲染问题时关闭硬件加速;该选项默认开启,修改后需要重启应用。详见 GPU 设置更新。
- Web:连接列表支持折叠,为消息视图腾出更多空间。
- CLI:收到的消息新增
received_at字段,以 UTC 时区的 ISO 8601 格式记录接收时间,方便排查问题时与应用日志对照。详见接收时间戳更新。
安全与问题修复
Topic 和 Payload 渲染现在会转义内容,防止 XSS。本次发布还补齐了部分翻译,并在 Desktop 连接更新失败时显示错误反馈。
完整变更和各平台安装包见 v1.13.1 官方发布记录。