Serial Port Assistant
面向 Windows 的中文串口调试助手。
为嵌入式、单片机、模块联调和工业串口现场准备，覆盖收发、过滤、高亮、协议解析、脚本自动化、实时波形和日志记录。
界面预览
| 协议解析 |
脚本自动化 |
 |
 |
| 实时波形 |
 |
为什么做这个
常见串口工具要么只适合简单收发，要么功能分散在多个窗口里。Serial Port Assistant 的目标是把日常调试流程放在一个清晰的中文桌面工具中：
- 打开串口后立即收发数据。
- 在接收区快速过滤、定位关键字。
- 用快捷按钮和定时发送反复测试设备响应。
- 对协议帧做拆包、校验和分区显示。
- 用脚本把重复调试动作自动化。
- 长时间运行时持续记录日志，方便复盘问题。
功能亮点
| 能力 |
说明 |
| 多会话串口 |
每个 Tab 独立维护串口、收发区、日志和统计 |
| 中文界面 |
菜单、按钮、状态栏、提示信息面向中文用户 |
| HEX / ASCII |
支持文本发送、十六进制字节发送、HEX 显示和时间戳 |
| 定时发送 |
支持 50 ms 到 60 s 周期发送，适合压力测试和轮询 |
| 快捷发送 |
内置常用命令按钮，可配合发送历史快速复用 |
| 自动应答 |
支持按 ASCII / HEX 匹配接收数据，并按规则延迟回复 |
| 数据过滤 |
支持关键字高亮、只看匹配、忽略匹配 |
| 协议解析 |
支持帧头、帧尾、长度域、CRC8、CRC16 Modbus、CRC32 |
| 实时波形 |
支持多通道数据曲线和常见整数/浮点格式 |
| 脚本自动化 |
基于 QJSEngine，提供 serial、logger、timer、sys、plot API |
| 日志记录 |
自动写入 logs 目录，支持日志轮转 |
| 打包发布 |
GitHub Actions 自动构建、测试、打包 Windows portable 版本 |
下载
最新正式版本：
下载 v0.6.0 Windows 便携版
下载 SerialPortAssistant-v0.6.0-win64-portable.zip，解压后运行：
ComAssistant.exe
快速开始
推荐使用 com0com 创建一对标准 COM 名称：
COM7 <-> COM8
测试流程：
- 打开程序，新建两个会话。
- 会话 1 选择
COM7，波特率 115200，点击“打开串口”。
- 会话 2 选择
COM8，波特率 115200，点击“打开串口”。
- 在会话 1 输入
Hello，点击“发送”。
- 会话 2 应收到
Hello。
- 勾选“HEX 发送”，发送
48 65 6C 6C 6F，接收结果等价于 Hello。
如果 CNCA0/CNCB0 提示“找不到文件”，优先改用 COM7/COM8、COM9/COM10 这类标准 COM 名称。
构建
环境要求：
| 项目 |
要求 |
| 操作系统 |
Windows 10 / Windows 11 |
| Qt |
Qt 6.11.x |
| 编译器 |
MSVC 2022 x64 或 MinGW 13.1 x64 |
| 构建工具 |
CMake 3.28+ |
| 串口模块 |
Qt SerialPort |
使用脚本构建：
.\scripts\build.ps1
手动构建：
cmake -S . -B build/msvc -G "Visual Studio 17 2022" -A x64
cmake --build build/msvc --config Release
运行测试：
ctest --test-dir build/msvc -C Release --output-on-failure
打包便携版：
.\scripts\package.ps1 -BuildDir build/msvc -Configuration Release -Installer None
脚本示例
每秒发送一次心跳：
timer.loop(1000, function() {
serial.send("ping\r\n");
logger.info("heartbeat", "sent ping");
});
收到 OK 后自动回复：
serial.onReceive(function(text, hex) {
logger.info("rx", text);
if (text.indexOf("OK") >= 0) {
serial.send("next\r\n");
}
});
向波形窗口添加数据点：
plot.addPoint(12.5, 0);
plot.addPoint(7.8, 1);
脚本运行在独立线程中，并带有超时中断保护。脚本 API 不暴露文件系统、进程和网络能力。
文档
- 用户手册：安装、com0com 测试、收发、过滤高亮、协议解析、波形、脚本和常见问题。
- 全功能手动测试说明：发布前按步骤验收主界面、串口收发、过滤高亮、协议、波形、脚本和打包结果。
- 架构说明：项目结构和核心数据流。
- 验收记录：外部测试和打包验证记录。
项目结构
project/
├── src/
│ ├── app/ # QApplication、主题管理
│ ├── core/ # 串口、配置、日志、协议、脚本、内存监控
│ ├── ui/ # 主窗口、会话、收发区、协议视图、波形视图
│ └── util/ # HEX/ASCII 工具和常量
├── res/ # QSS 主题和 Qt 资源
├── tests/ # 单元测试和集成测试
├── scripts/ # 构建、验证、打包辅助脚本
├── packaging/ # Windows 安装包配置
├── docs/ # 架构、手册和验收文档
└── img/ # README 截图
当前状态
v0.6.0 已发布：新增自动应答规则、亮暗主题切换、应用图标、中文便携包说明和更完整的串口调试体验。
许可证
当前仓库尚未声明开源许可证。正式开放协作前建议补充 LICENSE 文件，例如 MIT、Apache-2.0 或 GPL-3.0。
评论