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

> MQTTX 1.13.1 新增 CLI Agent Skill 和 MQTT 5.0 订阅用户属性，同时改进数据导出、渲染安全与日常调试体验。

> Language: zh-CN · Published: 2026-09-20 · Category: 版本发布 · Version: 1.13.1 · Canonical: https://mqttx.app/zh/blog/mqttx-1-13-1-released · Translation: [English](https://mqttx.app/blog/mqttx-1-13-1-released.md)

MQTTX 1.13.1 现已发布。这个版本让 AI 编码 Agent 更方便地使用 MQTTX CLI，并为 Desktop 和 Web 的订阅加入 MQTT 5.0 用户属性支持。此外，本次更新还改进了消息导出，为 CLI 增加接收时间戳，并修复了 Topic 和 Payload 渲染中的安全问题。

[下载 MQTTX](https://mqttx.app/zh/downloads)，或查看 [1.13.1 完整更新日志](https://mqttx.app/zh/changelogs/v1.13.1)。

## MQTTX CLI 的 AI Agent Skill

MQTTX 仓库新增了面向 Agent 的安装指南和 `mqttx-cli` Skill，可供 Claude Code、Codex、Cursor 等编码助手使用。Skill 提供命令参考与操作流程，覆盖连接检查、消息收发验证、压测和数据模拟。

[安装 MQTTX CLI](https://mqttx.app/zh/docs/cli/downloading-and-installation) 后，执行以下命令安装 Skill：

```shell
npx skills add emqx/MQTTX --skill mqttx-cli
```

随后可以让 Agent 使用唯一主题，在指定时间内验证本地 broker 的消息收发。安装提示词和完整示例见 [MQTTX AI Agent Skill 正式发布](https://mqttx.app/zh/blog/introducing-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 负责发送配置的值。实现细节见[订阅用户属性更新](https://github.com/emqx/MQTTX/pull/2066)。

## 更清晰、可靠的数据导出

消息导出的进度现在按已处理的消息数量计算。即使数据只来自一个连接，导出大量消息时也能逐步显示进度。

本次修复还移除了 JSON、YAML 和 XML 导出中的重复字段。CSV 和 Excel 改为每条消息占一行，将 Topic、Payload、QoS 等字段放入独立列；Excel 则按连接分为多个工作表，便于检查和后续处理。详见[导出修复](https://github.com/emqx/MQTTX/pull/2015)。

## 更多客户端控制选项

- **Desktop**：新增韩语界面。GPU 加速设置允许在排查渲染问题时关闭硬件加速；该选项默认开启，修改后需要重启应用。详见 [GPU 设置更新](https://github.com/emqx/MQTTX/pull/2037)。
- **Web**：连接列表支持折叠，为消息视图腾出更多空间。
- **CLI**：收到的消息新增 `received_at` 字段，以 UTC 时区的 ISO 8601 格式记录接收时间，方便排查问题时与应用日志对照。详见[接收时间戳更新](https://github.com/emqx/MQTTX/pull/2053)。

## 安全与问题修复

Topic 和 Payload 渲染现在会转义内容，防止 XSS。本次发布还补齐了部分翻译，并在 Desktop 连接更新失败时显示错误反馈。

完整变更和各平台安装包见 [v1.13.1 官方发布记录](https://github.com/emqx/MQTTX/releases/tag/v1.13.1)。