feat: 添加编码支持，允许选择 UTF-8、GBK、ASCII、Latin1 编码并持久化配置

Author: txp666

.github/workflows/ci.yml

@@ -50,7 +50,7 @@ jobs:
         uses: jurplel/install-qt-action@v4
         with:
           version: '6.8.0'
-          modules: 'qtserialport'
+          modules: 'qtserialport qt5compat'
           cache: true
 
       - name: Configure

.github/workflows/release.yml

@@ -50,7 +50,7 @@ jobs:
         uses: jurplel/install-qt-action@v4
         with:
           version: '6.8.0'
-          modules: 'qtserialport'
+          modules: 'qtserialport qt5compat'
           cache: true
 
       - name: Configure

CMakeLists.txt

@@ -39,7 +39,7 @@ if(MINGW)
     string(APPEND CMAKE_EXE_LINKER_FLAGS_MINSIZEREL " -Wl,--gc-sections -s")
 endif()
 
-find_package(Qt6 6.5 REQUIRED COMPONENTS Core Gui Widgets SerialPort Svg Network)
+find_package(Qt6 6.5 REQUIRED COMPONENTS Core Gui Widgets SerialPort Svg Network Core5Compat)
 
 set(FLUENTQTWIDGETS_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/third_party/FluentQtWidgets" CACHE PATH "Path to FluentQtWidgets checkout")
 if(NOT EXISTS "${FLUENTQTWIDGETS_ROOT}/CMakeLists.txt")
@@ -61,6 +61,8 @@ add_executable(FluentSerialAssistant
     src/app/core/font_preferences.h
     src/app/core/hex_utils.cpp
     src/app/core/hex_utils.h
+    src/app/core/text_encoding.cpp
+    src/app/core/text_encoding.h
     src/app/core/update_checker.cpp
     src/app/core/update_checker.h
     src/app/serial/serial_controller.cpp
@@ -111,6 +113,7 @@ target_link_libraries(FluentSerialAssistant
         Qt6::Widgets
         Qt6::SerialPort
         Qt6::Network
+        Qt6::Core5Compat
         FluentQtWidgets::Widgets
 )
 

README.md

@@ -26,6 +26,7 @@ Fluent 串口助手是一个基于 C++17、Qt 6 Widgets 和 FluentQtWidgets 的
 - 串口扫描：显示端口名、描述、厂商、VID/PID 和序列号。
 - 连接参数：支持常用和扩展波特率、数据位、校验位、停止位、流控、RTS、DTR。
 - 终端显示：支持文本、HEX、混合显示模式。
+- 编码支持：接收和文本发送可分别选择 UTF-8、GBK、ASCII、Latin1。
 - 自动断帧：按接收间隔自动插入帧分隔。
 - 记录显示：RX/TX 统一会话记录，支持暂停显示、自动滚动、清空和计数重置。
 - 终端检索：支持按关键字搜索，并按全部、接收、发送过滤当前显示。
@@ -60,6 +61,10 @@ Fluent 串口助手是一个基于 C++17、Qt 6 Widgets 和 FluentQtWidgets 的
 - 测试序列
 - 插件系统
 
+## 后续规划
+
+后续功能增强需求见 [功能需求规划](docs/feature-roadmap.md)。
+
 ## 技术栈
 
 - C++17
@@ -119,7 +124,7 @@ git submodule update --init --recursive
 
 - CMake 3.21+
 - Ninja
-- Qt 6.5+，需要包含 `SerialPort` 和 `Svg` 模块
+- Qt 6.5+，需要包含 `SerialPort`、`Svg` 和 `Core5Compat` 模块
 - Windows 本地预设默认使用：
   - Qt：`C:/Qt/6.11.1/mingw_64`
   - MinGW：`C:/Qt/Tools/mingw1310_64`
@@ -183,7 +188,7 @@ dist/FluentSerialAssistant-release
 2. 配置波特率、数据位、校验位、停止位、流控。
 3. 点击连接。
 4. 在终端记录区查看 RX/TX。
-5. 在发送区输入文本或 HEX 数据，选择行结束符后发送。
+5. 在发送区输入文本或 HEX 数据，必要时选择收发编码和行结束符后发送。
 6. 可在常用包中填写名称、内容、模式和换行后保存，之后选中条目即可填入发送区或直接发送。
 7. 可选择文件，配置块大小和间隔后分块发送。
 8. 可开启自动断帧、时间戳、自动滚动、循环发送等选项。

docs/feature-roadmap.md

@@ -0,0 +1,241 @@
+# Fluent 串口助手功能需求规划
+
+本文档记录后续功能增强方向。需求基于当前代码和 README 中已经具备的能力整理，避免重复规划已完成工作。
+
+## 已有能力基线
+
+- 串口扫描：端口名、描述、厂商、VID/PID、序列号。
+- 连接参数：波特率、数据位、校验位、停止位、流控、RTS、DTR。
+- 连接体验：手动刷新、自动重连、启动后自动连接上次串口。
+- 接收显示：文本、HEX、混合显示、时间戳、自动断帧、暂停显示、自动滚动、清空记录。
+- 终端检索：关键字搜索，以及全部、接收、发送方向过滤。
+- 状态统计：RX/TX 总量、实时速率、连接时长、计数重置。
+- 数据发送：文本/HEX 发送，None/CR/LF/CRLF 行结束符。
+- 发送历史：保存最近发送内容并可回填。
+- 常用包：保存、载入、发送、删除、排序。
+- 定时发送：按毫秒级间隔循环发送当前内容。
+- 文件发送：选择文件、按块发送、块间隔配置、发送进度。
+- 记录导出：TXT、CSV、BIN。
+- 接收保存：将接收原始数据保存到文件。
+- 会话恢复：恢复串口参数、发送输入、常用包、文件发送参数。
+- 外观设置：浅色、深色、跟随系统、主题色、界面字体和终端字体。
+
+## P0：优先增强
+
+### 1. 编码支持
+
+状态：已实现。
+
+接收显示和文本发送已经支持独立选择编码，覆盖常见设备和中文调试场景。
+
+需求：
+
+- 接收编码支持 UTF-8、GBK、ASCII、Latin1。
+- 发送编码支持 UTF-8、GBK、ASCII、Latin1。
+- 接收编码和发送编码可分别配置。
+- 编码配置需要持久化。
+- 无法按当前编码解码的内容，应有明确替代显示，不应导致界面异常。
+
+验收：
+
+- GBK 中文设备输出可以正确显示。
+- GBK 文本发送到设备时字节内容正确。
+- 切换编码后，后续新增记录按新编码显示。
+
+### 2. 校验工具
+
+增加常用校验计算能力，减少用户借助外部工具的成本。
+
+需求：
+
+- 支持 CRC16-Modbus、CRC16-CCITT、CRC32、LRC、XOR、SUM8。
+- 支持输入文本或 HEX 数据计算校验值。
+- 支持大小端显示校验结果。
+- 支持发送时自动追加指定校验码。
+- 自动追加校验时，应在发送记录中体现最终发送字节。
+
+验收：
+
+- 对标准测试向量能得到正确校验结果。
+- HEX 输入非法时给出明确错误位置。
+- 自动追加 CRC16-Modbus 后，发送字节包含低字节在前的校验码。
+
+### 3. 帧解析增强
+
+当前已有按接收间隔自动断帧。后续需要支持更多协议调试场景。
+
+需求：
+
+- 支持按固定帧头断帧。
+- 支持按固定帧尾断帧。
+- 支持按固定长度断帧。
+- 支持按超时断帧继续保留。
+- 每帧可显示时间、方向、长度、HEX、文本、校验状态。
+- 断帧策略需要持久化。
+
+验收：
+
+- 配置帧尾 `0D 0A` 后，接收数据按 CRLF 分帧。
+- 配置固定长度 8 后，连续数据按 8 字节分帧。
+- 断帧显示不影响原始接收保存。
+
+### 4. Modbus RTU 辅助
+
+增加常用 Modbus RTU 调试入口，降低手写帧成本。
+
+需求：
+
+- 支持读线圈、读离散输入、读保持寄存器、读输入寄存器。
+- 支持写单线圈、写单寄存器、写多线圈、写多寄存器。
+- 表单自动生成请求帧并追加 CRC16-Modbus。
+- 可直接发送生成的请求帧。
+- 对响应帧进行基础解析：站号、功能码、数据、异常码、CRC 是否正确。
+
+验收：
+
+- 功能码 03 读保持寄存器请求生成正确。
+- 响应 CRC 错误时明确标记。
+- Modbus 辅助不影响普通终端收发流程。
+
+### 5. 搜索体验增强
+
+当前已有关键字过滤，但还缺少终端常用的定位能力。
+
+需求：
+
+- 支持上一个/下一个匹配。
+- 显示匹配数量和当前匹配序号。
+- 支持大小写敏感开关。
+- 支持正则搜索开关。
+- 支持不隐藏其他记录，仅高亮匹配内容。
+
+验收：
+
+- 搜索时可以在终端记录中逐项跳转。
+- 清空搜索后恢复原显示。
+- 正则表达式非法时提示错误且不崩溃。
+
+## P1：实用增强
+
+### 6. 常用包增强
+
+当前已有常用包基础能力，需要增强批量管理能力。
+
+需求：
+
+- 支持常用包分组。
+- 支持备注字段。
+- 支持启用/禁用单条常用包。
+- 支持 JSON 导入导出。
+- 支持批量发送选中常用包。
+
+### 7. 宏命令 / 测试序列
+
+用于设备初始化、AT 指令测试和回归测试。
+
+需求：
+
+- 支持多步骤发送。
+- 支持步骤间延时。
+- 支持等待指定响应。
+- 支持循环次数。
+- 支持失败中止。
+- 支持导出测试结果。
+
+### 8. 自动应答
+
+用于握手协议、简单设备模拟和交互式调试。
+
+需求：
+
+- 支持收到文本/HEX/正则匹配后自动发送指定内容。
+- 支持延时应答。
+- 支持启用/禁用规则。
+- 自动应答记录需要标记来源，避免和手动发送混淆。
+
+### 9. 日志系统增强
+
+当前已有导出和原始接收保存，需要增强长期记录能力。
+
+需求：
+
+- 支持自动日志文件滚动。
+- 文件名支持日期、串口名、波特率。
+- 支持保存为可读 TXT、CSV 和原始 BIN。
+- 支持限制单个日志文件大小。
+- 日志状态需要在界面中明确展示。
+
+### 10. 多标签会话
+
+用于同时调试多个设备或多个 USB 转串口。
+
+需求：
+
+- 支持同时打开多个串口。
+- 每个会话独立终端、发送区、统计和日志设置。
+- 支持复制当前会话配置创建新标签。
+- 支持关闭单个会话时释放串口资源。
+
+## P2：专业能力
+
+### 11. 快速绘图
+
+README 中已经标注快速绘图暂未开放。
+
+需求：
+
+- 从接收文本中提取数字。
+- 支持多通道曲线。
+- 支持实时暂停和清空。
+- 支持曲线数据导出 CSV。
+
+### 12. 数据表格视图
+
+提供比纯终端更结构化的分析视图。
+
+需求：
+
+- 按帧显示时间、方向、长度、HEX、文本、校验。
+- 支持排序、过滤、复制单帧。
+- 支持从表格定位到终端记录。
+
+### 13. 脚本插件能力
+
+为复杂调试流程预留扩展空间。
+
+需求：
+
+- 支持一种脚本语言执行自动化逻辑。
+- 脚本可发送数据、读取收到的数据、写日志。
+- 脚本异常需要隔离并提示，不应影响主程序稳定性。
+
+### 14. 协议模板
+
+用于非标准私有协议解析。
+
+需求：
+
+- 支持定义帧头、长度字段、命令字、载荷、校验字段。
+- 支持保存和切换模板。
+- 支持按模板解析收到的帧。
+
+### 15. 串口转发 / 桥接
+
+用于调试中间链路和设备转发。
+
+需求：
+
+- 支持串口 A 到串口 B 双向转发。
+- 支持可选过滤规则。
+- 支持转发日志。
+- 支持转发方向统计。
+
+## 推荐实施顺序
+
+1. 编码支持。
+2. 校验工具。
+3. 帧解析增强。
+4. Modbus RTU 辅助。
+5. 搜索体验增强。
+
+前五项与现有终端、发送、记录模型关系最直接，收益高且工程风险可控。多标签、脚本插件和协议模板涉及架构扩展，建议在基础能力稳定后再实施。