Qt UDP Tester: 基于 PyQt5 的高性能协议测试工具

标签:
分类:
更新于 2026/04/16 : docs(qt-udp-tester): simplify feature descriptions and update system support
原创声明：本文为作者原创作品，采用开放许可，允许自由使用、修改、分发及商业应用，无需额外授权。

Qt UDP Tester

一个基于 PyQt5 和 Fluent Design 设计的高性能、原生跨平台 UDP 调试与协议测试工具。

Main Interface

1. 核心功能

1.1 协议管理与持久化

  • 数据库驱动：使用 SQLite 本地数据库存储协议配置，支持海量协议快速检索。

Protocol Edit

  • 灵活配置：支持为每个协议独立配置名称, 目标/监听端口, 发送负载及循环频率 (0.01Hz - 1000Hz)。
  • 分类隔离：区分 发送 与 接收 类型，简化复杂测试场景下的操作流程。

1.2 高性能通信引擎

  • 异步并发处理：基于 select 多路复用与多线程技术，确保在高频报文冲击下 UI 依然流畅。
  • 数据批处理：内置报文缓冲区，通过智能合并刷新机制平衡实时性与系统开销。
  • 精准定时控制：高精度定时器确保循环发送任务的间隔误差降至最低。

1.3 现代化交互体验

  • Fluent Design 视觉：基于 PyQt-Fluent-Widgets 库实现，完美适配 Windows 11 视觉风格，且在非 Windows 系统下通过模拟实现统一的视觉体验。
  • 实时报文监控：结构化展示报文来源, 时间戳, 本地端口及原始内容。
  • 动态视图调节：
    • 字体缩放：表格与日志区支持实时 Add/Remove 缩放。
    • 弹性布局：内置视图比例调节器，可自由分配监控区与配置区的显示空间。
  • 智能过滤：支持通过标签 Tags 对接收到的数据流进行实时筛选。

2. 安装要求

  • Python: 3.8 或更高版本
  • 系统环境: 原生支持 Windows, Linux.

2.1 依赖安装

pip install -r requirements.txt

3. 使用指南

  1. 运行程序：
    python udp_tool_gui.py
  2. 定义协议：点击 添加 按钮，在弹出的 Fluent 风格对话框中输入协议参数。

Save Configuration

  1. 数据交互：
    • 配置为 Send 的协议可手动触发或开启循环自动发送。
    • 配置为 Receive 的协议将自动开启本地端口监听。
  2. 视图调整：使用监控表右上角的缩放按钮调整显示字体；拖动中间的分隔栏调整视图占比。

4. 项目结构

  • udp_tool_gui.py：程序主逻辑与 GUI 实现。
  • icons/：界面资源文件。
  • requirements.txt：依赖清单。
  • ~/.qt-udp-tester/：配置文件与协议数据库默认存储路径。

参考文档