chore: release v0.1.6

Author: txp666

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 本项目遵循面向用户的变更记录格式。版本号在正式发布前可能继续调整。
 
+## [0.1.6] - 2026-07-08
+
+### 新增
+
+- 接收显示和文本发送支持分别选择 UTF-8、GBK、ASCII、Latin1 编码，并持久化保存配置。
+- 增加校验工具，支持 CRC16-Modbus、CRC16-CCITT、CRC32、LRC、XOR、SUM8 手动计算、大小端显示和发送时自动追加。
+- 自动断帧增强为支持按接收间隔、固定帧头、固定帧尾和固定长度断帧。
+- 增加 Modbus RTU 辅助，支持常用读写请求帧生成、CRC16-Modbus 自动追加、填入发送区、直接发送和响应摘要解析。
+- 左侧连接、接收设置、发送设置、Modbus RTU、常用包和文件发送卡片支持折叠，并记住每张卡片的折叠状态。
+
+### 修复
+
+- 修复常用包和文件发送卡片折叠后仍残留内容区空白高度的问题。
+
 ## [0.1.5] - 2026-07-08
 
 ### 新增

CMakeLists.txt

@@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.21)
 
 project(
     FluentSerialAssistant
-    VERSION 0.1.5
+    VERSION 0.1.6
     DESCRIPTION "A Fluent Qt serial assistant prototype"
     LANGUAGES CXX
 )

README.md

@@ -35,6 +35,7 @@ Fluent 串口助手是一个基于 C++17、Qt 6 Widgets 和 FluentQtWidgets 的
 - 数据发送：支持文本和 HEX 发送，支持 None、CR、LF、CRLF 行结束符。
 - 校验工具：支持 CRC16-Modbus、CRC16-CCITT、CRC32、LRC、XOR、SUM8 手动计算和发送时自动追加。
 - Modbus RTU：支持常用读写请求帧生成、CRC 自动追加、直接发送和响应摘要解析。
+- 左侧卡片：连接、接收、发送、Modbus、常用包和文件发送卡片可折叠，并记住折叠状态。
 - 发送历史：保留最近 20 条唯一发送记录。
 - 常用包：支持保存、载入、发送、删除和排序常用发送包。
 - 循环发送：支持毫秒级发送间隔。
@@ -193,8 +194,9 @@ dist/FluentSerialAssistant-release
 5. 在发送区输入文本或 HEX 数据，必要时选择收发编码、行结束符和校验自动追加后发送。
 6. 可在常用包中填写名称、内容、模式和换行后保存，之后选中条目即可填入发送区或直接发送。
 7. 可选择文件，配置块大小和间隔后分块发送。
-8. 可开启自动断帧、时间戳、自动滚动、循环发送等选项。
-9. 使用 TXT、CSV、BIN 导出会话记录。
+8. 可点击左侧卡片标题折叠不常用配置，减少侧栏占用。
+9. 可开启自动断帧、时间戳、自动滚动、循环发送等选项。
+10. 使用 TXT、CSV、BIN 导出会话记录。
 
 ## 许可证
 

docs/feature-roadmap.md

@@ -7,10 +7,12 @@
 - 串口扫描：端口名、描述、厂商、VID/PID、序列号。
 - 连接参数：波特率、数据位、校验位、停止位、流控、RTS、DTR。
 - 连接体验：手动刷新、自动重连、启动后自动连接上次串口。
-- 接收显示：文本、HEX、混合显示、时间戳、自动断帧、暂停显示、自动滚动、清空记录。
+- 接收显示：文本、HEX、混合显示、接收编码选择、时间戳、自动断帧、暂停显示、自动滚动、清空记录。
 - 终端检索：关键字搜索，以及全部、接收、发送方向过滤。
 - 状态统计：RX/TX 总量、实时速率、连接时长、计数重置。
-- 数据发送：文本/HEX 发送，None/CR/LF/CRLF 行结束符。
+- 数据发送：文本/HEX 发送、发送编码选择、None/CR/LF/CRLF 行结束符、校验码自动追加。
+- 校验工具：CRC16-Modbus、CRC16-CCITT、CRC32、LRC、XOR、SUM8。
+- Modbus RTU：常用读写请求帧生成、CRC 自动追加、直接发送和响应摘要解析。
 - 发送历史：保存最近发送内容并可回填。
 - 常用包：保存、载入、发送、删除、排序。
 - 定时发送：按毫秒级间隔循环发送当前内容。
@@ -19,6 +21,7 @@
 - 接收保存：将接收原始数据保存到文件。
 - 会话恢复：恢复串口参数、发送输入、常用包、文件发送参数。
 - 外观设置：浅色、深色、跟随系统、主题色、界面字体和终端字体。
+- 布局体验：左侧连接、接收、发送、Modbus、常用包和文件发送卡片可折叠，并记住折叠状态。
 
 ## P0：优先增强
 

docs/release-notes/v0.1.6.md

@@ -0,0 +1,22 @@
+# Fluent 串口助手 v0.1.6
+
+这是一个协议调试能力和左侧布局体验增强版本。
+
+## 新增
+
+- 接收显示和文本发送支持分别选择 UTF-8、GBK、ASCII、Latin1 编码。
+- 增加校验工具，支持 CRC16-Modbus、CRC16-CCITT、CRC32、LRC、XOR、SUM8 计算。
+- 支持校验结果大小端显示，并可在发送时自动追加校验码。
+- 自动断帧支持按接收间隔、固定帧头、固定帧尾和固定长度断帧。
+- 增加 Modbus RTU 辅助，可生成常用读写请求帧、自动追加 CRC、填入发送区或直接发送。
+- Modbus RTU 响应支持基础摘要解析，包括站号、功能码、数据、异常码和 CRC 状态。
+- 左侧功能卡片支持折叠，并记住每张卡片的折叠状态。
+
+## 修复
+
+- 修复常用包和文件发送卡片折叠后仍残留内容区空白高度的问题。
+
+## 验证
+
+- `cmake --build build/codex-release --target format-check`
+- `cmake --build build/codex-release --parallel`

src/app/view/workbench/workbench_page_internal.h

@@ -23,6 +23,8 @@
 #include <QtCore/QSettings>
 #include <QtCore/QSignalBlocker>
 #include <QtCore/QStandardPaths>
+#include <QtCore/QTimer>
+#include <QtCore/QVariant>
 #include <QtGui/QIcon>
 #include <QtGui/QKeyEvent>
 #include <QtGui/QTextCharFormat>
@@ -144,6 +146,34 @@ inline void hideCardTitle(HeaderCardWidget *card)
     }
 }
 
+inline void normalizeCollapsedCardHeight(ExpandSettingCard *card)
+{
+    if (!card || card->isExpanded() || !card->card()) {
+        return;
+    }
+
+    card->setFixedHeight(card->card()->height());
+    card->updateGeometry();
+}
+
+inline void makeCollapsibleCard(ExpandSettingCard *card, const QString &settingsName)
+{
+    if (!card) {
+        return;
+    }
+
+    const QString key = QStringLiteral("workbench/leftCards/%1Collapsed").arg(settingsName);
+    card->setExpanded(!QSettings().value(key, false).toBool());
+    normalizeCollapsedCardHeight(card);
+    QObject::connect(card, &ExpandSettingCard::expandedChanged, card, [card, key](bool expanded) {
+        QSettings settings;
+        settings.setValue(key, !expanded);
+        if (!expanded) {
+            QTimer::singleShot(240, card, [card]() { normalizeCollapsedCardHeight(card); });
+        }
+    });
+}
+
 inline QVBoxLayout *cardBody(HeaderCardWidget *card, int margin = 12)
 {
     card->setBorderRadius(8);
@@ -158,6 +188,18 @@ inline QVBoxLayout *cardBody(HeaderCardWidget *card, int margin = 12)
     return layout;
 }
 
+inline QVBoxLayout *cardBody(ExpandSettingCard *card, int margin = 12)
+{
+    card->viewLayout()->setContentsMargins(0, 0, 0, 0);
+
+    auto *body = new QWidget(card->view());
+    auto *layout = new QVBoxLayout(body);
+    layout->setContentsMargins(margin, margin, margin, margin);
+    layout->setSpacing(8);
+    card->viewLayout()->addWidget(body);
+    return layout;
+}
+
 inline void makeCompactControl(QWidget *control)
 {
     control->setMinimumWidth(0);

src/app/view/workbench/workbench_page_modbus.cpp

@@ -5,7 +5,7 @@ using namespace WorkbenchPagePrivate;
 
 QWidget *WorkbenchPage::createModbusSection()
 {
-    auto *section = new HeaderCardWidget(QStringLiteral("Modbus RTU"), this);
+    auto *section = new ExpandSettingCard(FluentIcon::CommandPrompt, QStringLiteral("Modbus RTU"), QString(), this);
     auto *root = cardBody(section);
 
     m_modbusSlaveSpin = new SpinBox(section);
@@ -80,6 +80,7 @@ QWidget *WorkbenchPage::createModbusSection()
     connect(m_modbusSendButton, &PrimaryPushButton::clicked, this, &WorkbenchPage::sendModbusRequest);
 
     updateModbusUi();
+    makeCollapsibleCard(section, QStringLiteral("modbus"));
     return section;
 }
 

src/app/view/workbench/workbench_page_side_sections.cpp

@@ -5,8 +5,7 @@ using namespace WorkbenchPagePrivate;
 
 QWidget *WorkbenchPage::createConnectionSection()
 {
-    auto *section = new HeaderCardWidget(this);
-    hideCardHeader(section);
+    auto *section = new ExpandSettingCard(FluentIcon::Connect, QStringLiteral("连接"), QString(), this);
     auto *root = cardBody(section);
 
     m_portCombo = new ComboBox(section);
@@ -79,13 +78,13 @@ QWidget *WorkbenchPage::createConnectionSection()
         settings.setValue(QStringLiteral("serial/autoOpen"), checked);
     });
 
+    makeCollapsibleCard(section, QStringLiteral("connection"));
     return section;
 }
 
 QWidget *WorkbenchPage::createReceiveSettingsSection()
 {
-    auto *section = new HeaderCardWidget(this);
-    hideCardHeader(section);
+    auto *section = new ExpandSettingCard(FluentIcon::Download, QStringLiteral("接收设置"), QString(), this);
     auto *root = cardBody(section);
 
     m_displayModeSegment = new SegmentedWidget(section);
@@ -251,13 +250,13 @@ QWidget *WorkbenchPage::createReceiveSettingsSection()
     connect(m_exportCsvButton, &PushButton::clicked, this, [this]() { exportRecords(ExportFormat::Csv); });
     connect(m_exportBinButton, &PushButton::clicked, this, [this]() { exportRecords(ExportFormat::Bin); });
 
+    makeCollapsibleCard(section, QStringLiteral("receive"));
     return section;
 }
 
 QWidget *WorkbenchPage::createSendSettingsSection()
 {
-    auto *section = new HeaderCardWidget(this);
-    hideCardHeader(section);
+    auto *section = new ExpandSettingCard(FluentIcon::Send, QStringLiteral("发送设置"), QString(), this);
     auto *root = cardBody(section);
 
     m_lineEndingCombo = new ComboBox(section);
@@ -373,12 +372,13 @@ QWidget *WorkbenchPage::createSendSettingsSection()
         }
     });
 
+    makeCollapsibleCard(section, QStringLiteral("send"));
     return section;
 }
 
 QWidget *WorkbenchPage::createPacketSection()
 {
-    auto *section = new HeaderCardWidget(QStringLiteral("常用包"), this);
+    auto *section = new ExpandSettingCard(FluentIcon::Library, QStringLiteral("常用包"), QString(), this);
     auto *root = cardBody(section);
 
     m_packetNameEdit = new LineEdit(section);
@@ -459,12 +459,13 @@ QWidget *WorkbenchPage::createPacketSection()
     connect(m_packetDownButton, &ToolButton::clicked, this, [this]() { moveSelectedPacket(1); });
 
     updatePacketTable();
+    makeCollapsibleCard(section, QStringLiteral("packets"));
     return section;
 }
 
 QWidget *WorkbenchPage::createFileSendSection()
 {
-    auto *section = new HeaderCardWidget(QStringLiteral("文件发送"), this);
+    auto *section = new ExpandSettingCard(FluentIcon::Folder, QStringLiteral("文件发送"), QString(), this);
     auto *root = cardBody(section);
 
     m_filePathEdit = new LineEdit(section);
@@ -513,5 +514,6 @@ QWidget *WorkbenchPage::createFileSendSection()
     connect(m_fileCancelButton, &PushButton::clicked, this, &WorkbenchPage::cancelFileSend);
 
     updateFileSendUi(false);
+    makeCollapsibleCard(section, QStringLiteral("fileSend"));
     return section;
 }

src/main.cpp

@@ -20,7 +20,7 @@ int main(int argc, char *argv[])
     app.setStyle(QStyleFactory::create(QStringLiteral("Fusion")));
     QCoreApplication::setOrganizationName(QStringLiteral("txp"));
     QCoreApplication::setApplicationName(QStringLiteral("FluentSerialAssistant"));
-    QCoreApplication::setApplicationVersion(QStringLiteral("0.1.5"));
+    QCoreApplication::setApplicationVersion(QStringLiteral("0.1.6"));
 
     AppFontPreferences::loadCustomFonts();
     FluentQt::FluentConfig::instance()->load();