JoeAllen
ab13f485e0
连接句柄（mqtt.rs）： - ConnHandle 增加代数 generation，事件循环退出只在仍是自己这一代时 才移除句柄——旧循环无条件按 id 删除会把重连后的新句柄删掉， 导致连接显示在线却无法从 UI 断开、发布/订阅报连接不存在 - connect() 同步插入占位句柄（client=None），建连期间也可被取消； 建连完成后仅当句柄仍是本代才升级为可用客户端 - 重连 2 秒退避改为可取消的 select：原先 close() 的取消信号在退避 期间不可见，会对用户已关闭的连接继续真实重连 - 重连成功后清零计数（max_reconnect_times 限流的是连续失败次数）； v4 CONNACK 拒绝上报真实返回码；test_handshake 断开后再 poll 冲出 DISCONNECT 报文；建连的证书文件读取移入 spawn_blocking 消息记录与事件（model.rs / app.rs / connection_view.rs）： - 非文本负载保留原始字节（MqttRecord.raw_bytes，仅非法 UTF-8 时 占用，纯文本零开销），详情 Hex/Base64 不再展示 lossy 失真字节 - EngineEvent::Published 补齐 response_topic/correlation_data/ message_expiry；correlation_data 两侧统一「优先文本、回退 hex」 - 事件入口加连接存在性守卫：删除连接后排队的引擎事件不再复活 状态/消息（内存泄漏）或为已删连接写孤儿订阅 - SUBACK 失败时移除乐观插入的订阅行；成功事件只刷新已有订阅， 不再用默认字段复活 SUBACK 前被删除的订阅 - Connecting 期间侧栏电源按钮防抖；分组名恰为 all/ungrouped 时 chip 元素 id 改前缀避免共享交互状态 - 「清空」按钮按消息总数而非过滤命中数判断禁用；搜索匹配的 大小写快速路径限定 ASCII（U+1E9B 等小写映射非自身的字符） - 应用发布预设后同步模板变量面板，残留行不再写回全局变量 - 日志文件套 BufWriter，高频消息流不再逐条落盘 syscall
MQTTX — 基于 GPUI 的跨平台 MQTT 桌面客户端
使用 Rust + gpui-kit（基于 GPUI）重写的 MQTT 调试客户端，对标官方 MQTTX。 纯 Rust 实现：MQTT 引擎、数据持久化与原生 UI 同属一个轻量二进制，无 Electron/WebView 运行时。
旧的 Tauri + Vue 版本仍保留在
src/与src-tauri/，新实现位于gpui-app/。
功能特性
- 双协议支持 — MQTT 5.0 与 MQTT 3.1.1（
rumqttc-next） - 多传输方式 — 明文 TCP、TLS、WebSocket(ws)、WebSocket over TLS(wss)，默认 rustls（aws-lc）
- 多连接管理 — 同时管理多个连接，侧边栏实时显示连接状态（未连接/连接中/已连接/错误），多标签页切换；连接分组（分组 chips 过滤 + 表单分组归属）
- 完整 MQTT 5 属性 — 用户属性（可视化键值对编辑器）、Content-Type、消息过期间隔、Response Topic、Correlation Data（连接/遗嘱/发布三处均支持）
- 发布 / 订阅 — QoS 0/1/2、Retain、遗嘱消息（Last Will）、订阅自动恢复（auto resubscribe）、断线自动重连（可配置最大重连次数与连接超时）
- 订阅增强 — 逗号/换行多主题批量订阅、订阅别名、颜色标签（消息按订阅着色）、启用/禁用、点击订阅过滤消息流、MQTT 5 订阅选项（订阅标识符 / No Local / Retain As Published / Retain Handling）
- 消息流 — 收发方向区分、时间戳、QoS/Retain 标记、点击展开查看格式化 JSON 与 v5 属性、全部/接收/发布过滤、主题/内容搜索、逐条 payload 格式切换（自动/文本/Hex/Base64）、复制主题/负载/详情、清空历史
- 连接导入 / 导出 — 原生文件对话框（rfd）导出/导入连接 JSON，按 id 去重
- SSL/TLS 证书 — 自定义 CA、客户端证书/私钥（双向认证）、忽略 CA 校验
- 全局变量 — 发布主题与负载中使用
{{变量名}}，内置{{$ts}}、{{$ts_ms}}、{{$uuid}}，用户属性同样参与渲染 - 负载格式 — Plaintext / JSON（发送前校验）/ Base64 / Hex
- 阿里云 IoT — Token（GroupId@@@DeviceId + HMAC-SHA1 签名）与一机一密两种鉴权方式一键生成连接
- 连接测试 — 表单内握手测试（超时可配置），保存前验证连通性
- 日志面板 — 连接级事件日志（CONNACK/SUBACK/PUBACK/错误/重连等），按日落盘
mqttx-YYYY-MM-DD.log，设置内一键打开日志目录 - 快捷键 —
Ctrl+N新建连接、Ctrl+,设置、Ctrl+Shift+E导出、Ctrl+Shift+I导入、Ctrl+Enter发送消息 - 主题 — Linear 风格配色（近黑/纯白扁平底 + 靛蓝 #5e6ad2 主色，14px 紧凑排版、6px 圆角），浅色 / 深色 / 跟随系统
- 设置 — 自动检查更新开关、消息缓存条数、时间戳毫秒、数据目录展示与打开、关于页（版本 / 许可）
- 本地持久化 — 连接、订阅、预设、变量、设置以 JSON 存于系统数据目录
技术栈
| 层 | 技术 |
|---|---|
| UI | GPUI 0.3 + gpui-kit（gpui-component）0.6 |
| MQTT | rumqttc-v5-next 0.34 / rumqttc-v4-next 0.34（TCP/TLS/WS） |
| 异步 | 引擎跑在独立 tokio runtime，事件经 smol channel 泵回 UI 线程 |
| 持久化 | serde + serde_json，原子写（临时文件 + rename） |
| 其他 | chrono、dirs、uuid、hmac/sha1/base64（阿里云签名） |
目录结构
gpui-app/
├── Cargo.toml
├── src/
│ ├── main.rs # 入口：创建窗口、挂载 gpui-kit Root
│ ├── lib.rs # 库导出（模型/引擎/UI 可被集成测试复用）
│ ├── model.rs # 数据模型（连接/订阅/消息/预设/变量/设置/模板渲染）
│ ├── mqtt.rs # MQTT 引擎：多连接生命周期、TLS/WS、重连、事件通道
│ ├── store.rs # JSON 持久化（%APPDATA%/MQTTX-GPUI）
│ ├── aliyun.rs # 阿里云 IoT 签名与连接生成
│ └── ui/
│ ├── app.rs # 应用外壳：标题栏/侧边栏/标签页/事件泵
│ ├── connection_form.rs # 新建/编辑连接对话框
│ ├── connection_view.rs # 连接工作区：订阅、消息流、发布面板、日志
│ ├── aliyun_dialog.rs # 阿里云设备对话框
│ ├── variables_dialog.rs # 全局变量对话框
│ ├── settings_dialog.rs # 设置对话框
│ └── widgets.rs # 复用组件（枚举下拉、键值对编辑器等）
└── tests/
└── engine_live.rs # 真实 broker 端到端测试（默认 ignored）
构建与运行
前置：Rust nightly（GPUI 0.3 依赖，使用 rustup default nightly）。
# 开发运行
cargo run -p mqttx-desktop
# 优化构建
cargo build --release -p mqttx-desktop
# 产物：target/release/mqttx(.exe)
中国大陆网络下若
index.crates.io不可达，仓库已提供仅作用于本工程的.cargo/config.toml（rsproxy 镜像）。
端到端连通性测试
测试默认 #[ignore]，需要外网：
MQTTX_LIVE=1 cargo test -p mqttx-desktop --test engine_live -- --ignored
会连接公共服务器 broker.emqx.io:1883，验证：
- MQTT 5.0 连接 → 订阅 → 发布 → 回环接收
- MQTT 3.1.1 连接握手
发布到 Gitea Package Registry
构建产物可通过 Gitea 的 Generic Package API 发布，两种方式：
方式一：手动发布（本地脚本）
前置：构建 release 产物 + 一个 Gitea 访问令牌（需 package 写权限）。
# Windows（PowerShell）
$env:GITEA_URL = "https://gitea.example.com"
$env:GITEA_TOKEN = "gta_xxx"
.\scripts\publish-gitea.ps1 # 默认产物 + 自动推断版本/owner
.\scripts\publish-gitea.ps1 -Version v1.0.1 # 指定版本
# macOS / Linux（bash）
export GITEA_URL=https://gitea.example.com
export GITEA_TOKEN=gta_xxx
./scripts/publish-gitea.sh # 默认产物
./scripts/publish-gitea.sh target/release/mqttx v1.0.1
- owner 自动从
git remote origin推断（可用GITEA_OWNER/-Owner覆盖） - 版本 依次取参数 →
git describe --tags→Cargo.toml - 每个文件附带
.sha256校验侧车；同名版本重复上传按 409 跳过（Gitea 不允许覆盖） - 软件包页面：
{GITEA_URL}/{owner}?tab=packages
方式二：CI 自动发布（Gitea Actions）
推送 v* tag 即触发 .gitea/workflows/release.yml：
- 单元测试
- Windows / Linux 双平台 release 构建（产物重命名为
mqttx-<ver>-<target>-<ext>） - 调用
scripts/publish-gitea.sh上传到包注册表
需要在仓库 Settings → Actions → Secrets 配置 GITEA_TOKEN；
若 runner 使用自定义 label，请相应修改工作流的 runs-on。
数据目录
| 平台 | 路径 |
|---|---|
| Windows | %APPDATA%\MQTTX-GPUI |
| macOS | ~/Library/Application Support/MQTTX-GPUI |
| Linux | ~/.local/share/MQTTX-GPUI |
刻意与官方 Electron MQTTX 的 MQTTX/ 目录区分，互不影响。读取时容忍 UTF-8 BOM。
与 Tauri 版本的差异
- 单一 Rust 二进制（release ~17MB），无需打包 Node/WebView 资源
- MQTT 引擎从 Tauri 命令模型改为独立 tokio runtime + 事件通道，UI 直接订阅
- 数据存储从浏览器
localStorage迁移到系统数据目录下的 JSON 文件 - 新增 TLS/WSS 传输、负载格式（Base64/Hex）、遗嘱消息、连接测试等能力