用途：MQTTX CLI 用于 MQTT 连接、发布与订阅、MQTT 5 特性、TLS 与 SCRAM 认证、载荷编解码与 Schema、基准测试和模拟。使用前先定位 mqttx，读取 mqttx --version，并查看 mqttx <command> --help；以已安装版本的帮助为准，不同发布渠道可能有差异。缺失或功能不可用时，按仓库根目录 INSTALL.md 或独立安装指南处理，不要每次调用都更新可用的 CLI。
主要能力：覆盖 conn、pub、sub 等基础工作流，连接与认证（传输、TLS/mTLS、WebSocket 头、凭据、SCRAM），MQTT 3/5、QoS、保留消息、会话、遗嘱、请求/响应、订阅属性，载荷与文件（文本/二进制输入、交互行模式、文件、编解码、Protobuf/Avro、随机载荷），以及 bench conn、bench pub、bench sub、simulate、ls --scenarios 和自定义生成器。
使用方式：从用户上下文确定 broker 主机名、端口、传输（mqtt、mqtts、ws、wss）、MQTT 版本、凭据、主题和操作，只询问影响执行的缺失信息；失败后不要替换为公共 broker。~/.mqttx-cli/config 可提供默认主机、端口、协议和凭据，不要打印其密钥或为一次性任务覆盖它；显式 CLI 参数优先于默认值，--load-options 加载命令专属 JSON/YAML 选项，显式 CLI 参数优先。为连接/订阅任务设置有限观察期限并保留进程句柄，完成或超时后终止并等待。
限制：本仓库 CLI 1.13.0 的命令注册不提供通用 --timeout、--max-messages、--json 或 --output jsonl 标志，不要臆造；其他版本请重新查看帮助。--reconnect-period 0 禁用重连，不是总体期限。conn 成功后保持连接，sub 持续监听直到停止。sub --output-mode clean 输出连续美化 JSON 对象流，不是 JSONL 或单个 JSON 数组，需用流式 JSON 解析器；clean 模式会抑制就绪与部分错误，且载荷输出绕过 Protobuf/Avro 解码结果，就绪检查、Schema 解码和诊断应使用默认输出。部分连接错误路径可能不显式设置非零退出码，退出码 0 或 clean 空输出都不能单独证明成功。二进制载荷订阅时用 --format base64 等可逆表示；--format json 控制载荷格式而非 CLI 输出格式。临时检查默认关闭 retain、持久会话和 Last Will；不要为通过连接而削弱 TLS 验证；凭据不要出现在报告和示例中，-P 可能通过进程参数暴露密码。基准测试和模拟需在用户请求的负载范围内，并明确限制连接数、速率、消息数和运行时间。