协议调试助手用于设备通信、协议联调和本机收发验证，将 TCP、UDP、串口、MQTT 与 Modbus 调试集中在一个桌面工作区中。
本页提供协议调试助手完整功能免费下载，无需付费：Windows 0.1.0 x64 安装版、免安装版，macOS 0.1.0 Universal 通用版，以及 Linux 0.1.0 x64 / ARM64 版。各平台包的构建日期和验证范围不同，请按电脑系统选择。下方“资料下载”附有说明与 SHA-256 校验文件。
软件真实运行截图
下方两张图片为本软件在 macOS 上实际运行时的原始截图，分别展示 TCP 本机回环接收与 MQTT 消息订阅；数据为本机演示。Windows 下载版的窗口样式、语言及功能以安装后的实际界面为准。
macOS 下载与安装
下载 macOS-Universal.zip，完整解压后将“协议调试助手.app”拖入“应用程序”。支持 Apple Silicon（arm64）与 Intel（x86_64），最低系统设为 macOS 11.0。
此官网包于 2026-11-14 重新构建，含 40 个离线语言选项，可自动匹配系统语言，并可在设置中手动切换。新增译文尚未全部经过母语审校。
本包只有 ad-hoc 本地签名，未做 Developer ID 发行签名和 Apple 公证，网络下载后可能被 Gatekeeper 阻止。确认来源、核对校验值后，可按 macOS 提供的“隐私与安全性”单应用授权流程处理；请勿关闭系统安全功能。需要 Apple 公证包的用户请暂缓安装此包。
已核对 Universal 两种架构、本地签名完整性，并在当前 Apple Silicon Mac 启动；8 项前端逻辑测试和 13 项 Rust 测试通过。尚未验收 Intel 实机、最低系统版本及真实串口设备。ZIP 内附 macOS 安装说明。
Linux 下载与安装
普通 Intel / AMD 64 位电脑选择 Linux-x64.zip（uname -m 显示 x86_64）；ARM 64 位电脑选择 Linux-ARM64.zip（显示 aarch64）。这两个包适用于 Ubuntu 24.04 桌面版及兼容发行版，需要 glibc 2.39 或更高版本、GTK3 和 WebKitGTK 4.1，不是适用于所有 Linux 发行版的静态程序。
完整解压 ZIP 后，打开终端进入解压目录，执行 sudo apt install ./okesd-protocol-debug-assistant_0.1.0_amd64.deb；ARM64 版将文件名末尾换为 arm64.deb。使用 apt 可从系统仓库安装依赖。
安装后从应用菜单启动“OKESD 协议调试助手”，或运行 okesd-protocol-debug-assistant。卸载命令：sudo apt remove okesd-protocol-debug-assistant。ZIP 内附中文安装说明及 DEB 文件的 SHA-256。
两种 Linux 包于 2026-11-14 构建，含 40 个离线语言选项，可自动匹配系统语言，也可在设置中选择。新增译文尚未全部经过母语审校。
验证范围：ARM64 在 Ubuntu 24.04 虚拟机原生运行；x64 在同一系统中通过 QEMU 10 的 x86_64 模拟运行。两种架构均通过 13 项后端测试及 DEB 安装检查，并检查了 X11 虚拟显示环境的启动界面。尚未验收 x64 物理机、Wayland、其他发行版及真实串口设备。
串口设备需要当前用户具有设备访问权限，可由管理员按设备所属组配置（Ubuntu 通常为 dialout），修改组后重新登录；请勿使用 chmod 777 放开设备权限。
01 Windows 选择适合的下载包
Setup.zip：安装版。完整解压后，运行 ProtocolDebugAssistant-0.1.0-x64-setup.exe，按提示安装。
Portable.zip：免安装版。完整解压到固定目录后，运行 ProtocolDebugAssistant.exe；仍需已安装 Microsoft Edge WebView2 Runtime。
Manual.pdf：4 页中文使用说明，包含安装、TCP 回环、UDP、串口、MQTT、Modbus、常见问题与校验方法。两个 ZIP 中也附有相同说明。
SHA256SUMS-AllPlatforms.txt：用于核对下载包及说明文档的一致性。
02 Windows 运行环境与安装
面向 Windows 10 / 11 x64 电脑；32 位 Windows 不适用。应用使用 Microsoft Edge WebView2 Runtime，若提示缺少运行时，请从微软官网获取 Evergreen Runtime（x64）。安装程序可能需要联网获取运行时。
现有 Windows EXE 未做发行签名，系统可能显示未知发布者。请从本页下载并先核对 SHA-256；不要为了运行软件关闭系统安全功能。
03 主要调试场景
TCP 客户端与服务端：连接真实设备或建立本机回环，查看 HEX / ASCII 收发。
UDP：设置本地监听端口与远端地址，检查双向数据。
串口：选择 COM 端口及波特率、数据位、停止位和校验方式，配合设备协议发送数据。
MQTT：连接已有 Broker，订阅和发布主题消息。具体 QoS、Retain 与语言选项以实际下载版本为准。
Modbus TCP / RTU：按设备说明配置地址、站号和通信参数，读取或写入线圈、寄存器，核对数据类型、字序与倍率。
循环发送、CRC16、日志导出与配置档等操作详见 PDF；已有 CRC 的完整报文不要重复追加 CRC。
04 五分钟 TCP 回环自测
新建 TCP 服务端，绑定 127.0.0.1:9000 并启动监听。
再新建 TCP 客户端，连接 127.0.0.1:9000。在 ASCII 模式发送 hello，检查另一端接收区；反向发送一次，确认双向收发。
如端口已占用，双方一起改用同一个空闲端口。连接实际设备时，再填写设备 IP 与端口，并核对防火墙范围。
05 文件校验与版本范围
可在 Windows PowerShell 中使用 Get-FileHash 文件路径 -Algorithm SHA256，结果与随附 SHA256SUMS-AllPlatforms.txt 比较。
Windows 部分整理现有分发文件，保留 EXE 原始字节，完成文件格式、ZIP 结构及 SHA-256 一致性检查；没有重新编译，也未进行 Windows 实机安装重测。功能及语言选项以下载版本界面为准，不能将其他平台的测试结果当作 Windows 实机验收。
配置档和日志可能包含地址、账号及业务数据；MQTT 密码可能以明文保存在本机配置中。分享前请脱敏。
技术支持
反馈时请提供软件版本、Windows 版本、会话类型与复现步骤，并附脱敏日志。 电话：15913800863 邮箱：yuhua.xie@okesd.com