chore: 发布 v0.1.5

Author: txp666

.clang-format

@@ -0,0 +1,16 @@
+BasedOnStyle: LLVM
+IndentWidth: 4
+ColumnLimit: 120
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterClass: true
+  AfterControlStatement: false
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: false
+  AfterStruct: true
+  BeforeCatch: false
+  BeforeElse: false
+  IndentBraces: false
+PointerAlignment: Right
+SortIncludes: true

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 本项目遵循面向用户的变更记录格式。版本号在正式发布前可能继续调整。
 
+## [0.1.5] - 2026-07-08
+
+### 新增
+
+- 终端支持时间戳、RX/TX 方向符号和 ESP-IDF `V/D/I/W/E` 日志等级分色显示，并适配深色和浅色主题。
+- 增加项目级 `.clang-format`、格式化脚本和 CMake `format`、`format-check` 目标。
+
+### 变更
+
+- 将 Workbench 页面按布局、左侧设置区、终端渲染、常用包、文件发送、连接控制和状态管理拆分到 `src/app/view/workbench/`，降低单文件复杂度。
+- 使用 clang-format 统一格式化项目 C/C++ 源码。
+
 ## [0.1.4] - 2026-07-08
 
 ### 修复

CMakeLists.txt

@@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.21)
 
 project(
     FluentSerialAssistant
-    VERSION 0.1.4
+    VERSION 0.1.5
     DESCRIPTION "A Fluent Qt serial assistant prototype"
     LANGUAGES CXX
 )
@@ -14,6 +14,25 @@ set(CMAKE_AUTOMOC ON)
 set(CMAKE_AUTORCC ON)
 set(CMAKE_AUTOUIC ON)
 
+find_package(Python3 COMPONENTS Interpreter)
+find_program(CLANG_FORMAT_EXECUTABLE clang-format)
+if(CLANG_FORMAT_EXECUTABLE AND Python3_EXECUTABLE)
+    add_custom_target(format
+        COMMAND "${CMAKE_COMMAND}" -E env "CLANG_FORMAT=${CLANG_FORMAT_EXECUTABLE}"
+                "${Python3_EXECUTABLE}" "${CMAKE_CURRENT_SOURCE_DIR}/scripts/format_code.py" .
+        WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
+        COMMENT "Format C/C++ sources"
+        VERBATIM
+    )
+    add_custom_target(format-check
+        COMMAND "${CMAKE_COMMAND}" -E env "CLANG_FORMAT=${CLANG_FORMAT_EXECUTABLE}"
+                "${Python3_EXECUTABLE}" "${CMAKE_CURRENT_SOURCE_DIR}/scripts/format_code.py" --check .
+        WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
+        COMMENT "Check C/C++ source formatting"
+        VERBATIM
+    )
+endif()
+
 if(MINGW)
     string(APPEND CMAKE_CXX_FLAGS_MINSIZEREL " -ffunction-sections -fdata-sections")
     string(APPEND CMAKE_C_FLAGS_MINSIZEREL " -ffunction-sections -fdata-sections")
@@ -54,6 +73,15 @@ add_executable(FluentSerialAssistant
     src/app/view/settings_page.h
     src/app/view/workbench_page.cpp
     src/app/view/workbench_page.h
+    src/app/view/workbench/workbench_page_connection.cpp
+    src/app/view/workbench/workbench_page_files.cpp
+    src/app/view/workbench/workbench_page_internal.h
+    src/app/view/workbench/workbench_page_layout.cpp
+    src/app/view/workbench/workbench_page_packets.cpp
+    src/app/view/workbench/workbench_page_side_sections.cpp
+    src/app/view/workbench/workbench_page_state.cpp
+    src/app/view/workbench/workbench_page_terminal.cpp
+    src/app/view/workbench/workbench_page_terminal_sections.cpp
     src/app/resources/app.qrc
     src/main.cpp
 )

CONTRIBUTING.md

@@ -41,6 +41,17 @@ cmake --build --preset mingw-debug --parallel
 - 可见业务 UI 尽量使用 FluentQtWidgets 组件。
 - 不引入与当前目标无关的大型依赖。
 - 注释应解释必要的业务意图，避免重复代码字面含义。
+- 提交前建议运行格式化检查：
+
+```powershell
+cmake --build build/codex-release --target format-check
+```
+
+如需自动格式化：
+
+```powershell
+cmake --build build/codex-release --target format
+```
 
 ## Issue 建议
 

README.md

@@ -79,10 +79,19 @@ Fluent 串口助手是一个基于 C++17、Qt 6 Widgets 和 FluentQtWidgets 的
 ├── docs/images/              # README 截图和文档图片
 ├── scripts/                  # 发布和辅助脚本
 ├── src/
-│   ├── app/core/             # HEX 解析等通用逻辑
-│   ├── app/resources/        # Qt 资源与 Windows 图标
+│   ├── app/core/             # 字体偏好、HEX 解析、更新检查等通用逻辑
+│   ├── app/resources/        # Qt 资源、应用图标和平台资源
 │   ├── app/serial/           # QSerialPort 封装
-│   └── app/view/             # 主窗口、终端页、设置页
+│   └── app/view/             # 主窗口、设置页和终端工作台
+│       └── workbench/        # 终端工作台按职责拆分的实现文件
+│           ├── *_layout.cpp              # 页面整体布局
+│           ├── *_side_sections.cpp       # 左侧连接、收发、常用包、文件发送配置
+│           ├── *_terminal_sections.cpp   # 终端区和发送区 UI
+│           ├── *_terminal.cpp            # 终端记录、过滤、分色和渲染
+│           ├── *_packets.cpp             # 发送历史和常用包
+│           ├── *_files.cpp               # 记录导出、接收保存和文件发送
+│           ├── *_connection.cpp          # 连接、重连和控件启停
+│           └── *_state.cpp               # 设置恢复、保存、计数和状态更新
 ├── third_party/FluentQtWidgets/
 ├── CMakeLists.txt
 ├── CMakePresets.json
@@ -168,28 +177,6 @@ dist/FluentSerialAssistant-release
 - 排除未使用的插件、翻译和软件 OpenGL fallback
 - 对 `.exe` 和 `.dll` 执行 `strip --strip-unneeded`
 
-## CI
-
-仓库提供 GitHub Actions 工作流：
-
-```text
-.github/workflows/ci.yml
-```
-
-CI 会在以下平台执行 Release 构建：
-
-- Windows：`windows-latest`，MSVC 2022
-- Linux：`ubuntu-latest`，GCC
-- macOS：`macos-15`，Clang
-
-CI 不使用本机 `CMakePresets.json` 中的固定 Qt 路径，而是在工作流中安装 Qt 并通过 CMake 直接配置。
-
-推送 `v*` 标签会触发 Release 打包：
-
-- Windows：使用 `windeployqt` 生成部署目录。
-- macOS：使用 `.app` bundle，包含应用 `.icns` 图标。
-- Linux：生成携带 Qt 运行库、Qt 插件、启动脚本和桌面图标元数据的 `.tar.gz`。
-
 ## 使用说明
 
 1. 选择串口端口，必要时点击刷新。
@@ -202,19 +189,6 @@ CI 不使用本机 `CMakePresets.json` 中的固定 Qt 路径，而是在工作
 8. 可开启自动断帧、时间戳、自动滚动、循环发送等选项。
 9. 使用 TXT、CSV、BIN 导出会话记录。
 
-## 贡献
-
-欢迎提交 Issue 和 Pull Request。请先阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。
-
-建议贡献方向：
-
-- 串口协议解析器
-- 更完善的 HEX 编辑体验
-- 会话保存和恢复
-- 自动测试
-- 跨平台打包
-- UI 可访问性和键盘操作
-
 ## 许可证
 
 本项目采用 GNU General Public License v3.0 or later，详见 [LICENSE](LICENSE)。

docs/release-notes/v0.1.5.md

@@ -0,0 +1,20 @@
+# Fluent 串口助手 v0.1.5
+
+这是一个终端显示增强和代码结构整理版本。
+
+## 新增
+
+- 终端时间戳使用独立颜色显示。
+- RX/TX 方向符号使用独立颜色显示。
+- ESP-IDF `V/D/I/W/E` 日志等级前缀支持分色显示，例如 `I (4929)`、`W (3639)`、`E (3639)`。
+- 增加项目级 `.clang-format`、格式化脚本和 CMake `format`、`format-check` 目标。
+
+## 变更
+
+- 将 Workbench 页面拆分为多个职责清晰的实现文件，提升后续维护可读性。
+- 全量格式化项目 C/C++ 源码。
+
+## 验证
+
+- `cmake --build build/codex-release --target format-check`
+- `cmake --build build/codex-release --parallel`

scripts/format_code.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+SOURCE_SUFFIXES = {".c", ".cc", ".cpp", ".cxx", ".h", ".hh", ".hpp", ".hxx", ".m", ".mm"}
+EXCLUDED_DIRS = {
+    ".git",
+    ".github",
+    "build",
+    "dist",
+    "third_party",
+}
+
+
+def iter_source_files(paths):
+    for raw_path in paths:
+        path = (REPO_ROOT / raw_path).resolve() if not Path(raw_path).is_absolute() else Path(raw_path).resolve()
+        if not path.exists():
+            raise FileNotFoundError(path)
+        if path.is_file():
+            if path.suffix in SOURCE_SUFFIXES:
+                yield path
+            continue
+        for child in sorted(path.rglob("*")):
+            if not child.is_file() or child.suffix not in SOURCE_SUFFIXES:
+                continue
+            relative_parts = child.relative_to(REPO_ROOT).parts
+            if any(part in EXCLUDED_DIRS for part in relative_parts):
+                continue
+            yield child
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Format C/C++ source files with clang-format.")
+    parser.add_argument("paths", nargs="*", default=["src"], help="Files or directories to format.")
+    parser.add_argument("--check", action="store_true", help="Check formatting without modifying files.")
+    args = parser.parse_args()
+
+    clang_format = os.environ.get("CLANG_FORMAT") or shutil.which("clang-format")
+    if not clang_format:
+        print("clang-format was not found in PATH.", file=sys.stderr)
+        return 1
+
+    files = list(dict.fromkeys(iter_source_files(args.paths)))
+    if not files:
+        return 0
+
+    command = [clang_format, "--dry-run", "--Werror"] if args.check else [clang_format, "-i"]
+    result = subprocess.run(command + [str(path) for path in files], cwd=REPO_ROOT)
+    return result.returncode
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())