[refactor]: 项目结构重构与构建系统升级

- **项目结构重组**: 将所有示例模块移至src目录，统一管理源代码
- **构建系统现代化**: 全面升级CMake配置，引入模块化架构检测和跨平台输出目录管理
- **Qt版本升级**: 从6.9.2升级到6.10.0，移除已弃用的QtCharts模块依赖
- **CI/CD优化**: 重构GitHub Actions工作流，改进条件判断和构建矩阵配置
- **跨平台支持增强**: 完善macOS通用二进制构建，明确设置部署目标为13.0
- **QMake配置统一**: 引入标准化项目设置文件，统一编译器标志和架构检测
- **文档同步更新**: 调整README中的示例路径说明，反映新的目录结构
- **开发体验改进**: 更新.gitignore排除规则和VS Code配置，优化调试信息输出

Author: RealChuan

.clang-format

@@ -110,4 +110,4 @@ StatementMacros:
   - Q_UNUSED
   - QT_REQUIRE_VERSION
 TabWidth: 4
-UseTab: Never
+UseTab: Never

.github/actions/install-dependencies/action.yml

@@ -4,12 +4,12 @@ inputs:
   qt_modules:
     description: 'qt modules'
     required: false
-    default: 'qtcharts qt5compat qtnetworkauth qtimageformats'
+    default: 'qt5compat qtnetworkauth qtimageformats'
     type: string
   qt_ver:
     description: 'qt version'
     required: false
-    default: '6.9.2'
+    default: '6.10.0'
     type: string
 
 runs:

.github/workflows/cmake.yml

@@ -1,24 +1,40 @@
 name: CMake Build
 
-on: 
+on:
   push:
-    paths-ignore: 
-        - '**/picture/**'
-        - 'packaging/**'
-        - '.clang-*'
-        - '.gitignore'
-        - 'LICENSE'
-        - '*.pro'
-        - 'README*'
+    paths-ignore:
+      - 'docs/**'
+      - 'packaging/**'
+      - 'qmake/**'
+      - 'translations/**'
+      - '**/*.md'
+      - '**/*.txt'
+      - '**/.clang-*'
+      - '**/.gitignore'
+      - '**/*.pri'
+      - '**/LICENSE*'
+      - '**/*.pro'
+      - '**/README*'
   pull_request:
-    paths-ignore: 
-        - '**/picture/**'
-        - 'packaging/**'
-        - '.clang-*'
-        - '.gitignore'
-        - 'LICENSE'
-        - '*.pro'
-        - 'README*'
+    paths-ignore:
+      - 'docs/**'
+      - 'packaging/**'
+      - 'qmake/**'
+      - 'translations/**'
+      - '**/*.md'
+      - '**/*.txt'
+      - '**/.clang-*'
+      - '**/.gitignore'
+      - '**/*.pri'
+      - '**/LICENSE*'
+      - '**/*.pro'
+      - '**/README*'
+
+env:
+  MACOSX_DEPLOYMENT_TARGET: '13.0'
+  MACOSX_BUILD_ARCHS: 'x86_64;arm64'
+  BUILD_DIR: build
+  BUILD_TYPE: RelWithDebInfo
 
 jobs:
   build:
@@ -31,8 +47,6 @@ jobs:
           - windows-latest
           - macos-latest
           - ubuntu-latest
-        build_type:
-          - "RelWithDebInfo"
         generators:
           - "Ninja"
 
@@ -44,23 +58,36 @@ jobs:
       - uses: ./.github/actions/install-dependencies
 
       - name: Configure and build windows
-        if: startsWith(matrix.os, 'windows')
+        if: runner.os == 'Windows'
         shell: pwsh
         run: |
           .\packaging\windows\Enter-VsDevShell.ps1
           cmake `
             -S . `
-            -B ./build `
-            -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} `
+            -B "${{ env.BUILD_DIR }}" `
+            -DCMAKE_BUILD_TYPE=${{ env.BUILD_TYPE }} `
+            -G "${{ matrix.generators }}"
+          cmake --build "${{ env.BUILD_DIR }}" --config ${{ env.BUILD_TYPE }}
+
+      - name: Configure and build ubuntu
+        if: runner.os == 'Linux'
+        shell: bash
+        run: |
+          cmake \
+            -S . \
+            -B "${{ env.BUILD_DIR }}" \
+            -DCMAKE_BUILD_TYPE=${{ env.BUILD_TYPE }} \
             -G "${{ matrix.generators }}"
-          cmake --build ./build --config ${{ matrix.build_type }}
-      - name: Configure and build on ubuntu or macos
-        if: startsWith(matrix.os, 'ubuntu') || startsWith(matrix.os, 'macos')
+          cmake --build "${{ env.BUILD_DIR }}" --config ${{ env.BUILD_TYPE }}
+
+      - name: Configure and build macos
+        if: runner.os == 'macOS'
         shell: bash
         run: |
           cmake \
             -S . \
-            -B ./build \
-            -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} \
+            -B "${{ env.BUILD_DIR }}" \
+            -DCMAKE_BUILD_TYPE=${{ env.BUILD_TYPE }} \
+            -DCMAKE_OSX_ARCHITECTURES="${{ env.MACOSX_BUILD_ARCHS }}" \
             -G "${{ matrix.generators }}"
-          cmake --build ./build --config ${{ matrix.build_type }}
+          cmake --build "${{ env.BUILD_DIR }}" --config ${{ env.BUILD_TYPE }}

.github/workflows/codeql.yml

@@ -1,34 +1,43 @@
 name: CodeQL
 
-on: 
+on:
   push:
-    paths-ignore: 
-        - '**/picture/**'
-        - 'packaging/**'
-        - '.clang-*'
-        - '.gitignore'
-        - 'LICENSE'
-        - '*.pro'
-        - 'README*'
+    paths-ignore:
+      - 'docs/**'
+      - 'packaging/**'
+      - 'qmake/**'
+      - 'translations/**'
+      - '**/*.md'
+      - '**/*.txt'
+      - '**/.clang-*'
+      - '**/.gitignore'
+      - '**/*.pri'
+      - '**/LICENSE*'
+      - '**/*.pro'
+      - '**/README*'
     branches-ignore:
         - 'dependabot/**'
   pull_request:
-    paths-ignore: 
-        - '**/picture/**'
-        - 'packaging/**'
-        - '.clang-*'
-        - '.gitignore'
-        - 'LICENSE'
-        - '*.pro'
-        - 'README*'
+    paths-ignore:
+      - 'docs/**'
+      - 'packaging/**'
+      - 'qmake/**'
+      - 'translations/**'
+      - '**/*.md'
+      - '**/*.txt'
+      - '**/.clang-*'
+      - '**/.gitignore'
+      - '**/*.pri'
+      - '**/LICENSE*'
+      - '**/*.pro'
+      - '**/README*'
     branches-ignore:
         - 'dependabot/**'
 
   schedule:
     - cron: '0 0 1 * *'
   workflow_dispatch:
 
-
 jobs:
   CodeQL:
     runs-on: ubuntu-latest

.github/workflows/delete_workflow.yml

@@ -42,7 +42,7 @@ on:
         required: false
 
 jobs:
-  del_runs:
+  delete-workflow-runs:
     runs-on: ubuntu-latest
     permissions:
       actions: write

.github/workflows/qmake.yml

@@ -2,25 +2,38 @@ name: QMake Build
 
 on: 
   push:
-    paths-ignore: # 下列文件的变更不触发部署，可以自行添加
-        - '**/picture/**'
-        - 'cmake/**'
+    paths-ignore:
+        - 'cmake/**' 
+        - 'docs/**'
         - 'packaging/**'
-        - '.clang-*'
-        - '.gitignore'
-        - 'CMake*'
-        - 'LICENSE'
-        - 'README*'
+        - 'translations/**'
+        - '**/CMakeLists.txt'
+        - '**/*.md'
+        - '**/*.txt'
+        - '**/.clang-*'
+        - '**/.gitignore'
+        - '**/LICENSE*'
+        - '**/README*'
+        - 'vcpkg.json'    
   pull_request:
-    paths-ignore: # 下列文件的变更不触发部署，可以自行添加
-        - '**/picture/**'
-        - 'cmake/**'
+    paths-ignore:
+        - 'cmake/**' 
+        - 'docs/**'
         - 'packaging/**'
-        - '.clang-*'
-        - '.gitignore'
-        - 'CMake*'
-        - 'LICENSE'
-        - 'README*'
+        - 'translations/**'
+        - '**/CMakeLists.txt'
+        - '**/*.md'
+        - '**/*.txt'
+        - '**/.clang-*'
+        - '**/.gitignore'
+        - '**/LICENSE*'
+        - '**/README*'
+        - 'vcpkg.json'  
+
+env:
+  MACOSX_DEPLOYMENT_TARGET: 13.0
+  MACOSX_BUILD_ARCHS: 'x86_64 arm64'
+  BUILD_DIR: build
 
 jobs:
   build:
@@ -43,30 +56,31 @@ jobs:
 
       - uses: RealChuan/install-jom@main
 
-      - name: mkdir build
+      - name: Create build directory
         shell: bash
-        run: |
-          mkdir build
+        run: mkdir -p ${{ env.BUILD_DIR }}
 
-      - name: msvc-build
-        if: startsWith(matrix.os, 'windows')
+      - name: Build windows
+        if: runner.os == 'Windows'
+        working-directory: ${{ env.BUILD_DIR }}
         shell: pwsh
         run: |
           ..\packaging\windows\Enter-VsDevShell.ps1
-          & qmake ./../.
+          & qmake ..\.
           & jom
-        working-directory: build
-      - name: ubuntu-build
-        if: startsWith(matrix.os, 'ubuntu')
+        
+      - name: Build linux
+        if: runner.os == 'Linux'
+        working-directory: ${{ env.BUILD_DIR }}
         shell: bash
         run: |
-          qmake ./../.
+          qmake ../.
           make -j $(nproc)
-        working-directory: build
-      - name: macos-build
-        if: startsWith(matrix.os, 'macos')
+
+      - name: Build macos
+        if: runner.os == 'macOS'
+        working-directory: ${{ env.BUILD_DIR }}
         shell: bash
         run: |
-          qmake ./../.
-          make -j $(sysctl -n hw.ncpu)
-        working-directory: build
+          qmake QMAKE_APPLE_DEVICE_ARCHS="${{ env.MACOSX_BUILD_ARCHS }}" ../.
+          make -j $(sysctl -n hw.ncpu)

.github/workflows/readme.yml

@@ -9,12 +9,11 @@ on:
       - README.md
 
 jobs:
-  build:
+  Translate:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
+      - uses: actions/setup-node@v6
       # ISO Langusge Codes: https://cloud.google.com/translate/docs/languages  
       - name: Adding README - English
         uses: dephraiim/translate-readme@main

.gitignore

@@ -88,7 +88,25 @@ tags
 *.dll
 *.exe
 
+# 编译 & 打包产出
+build/
+debian/tmp/
+debian/.debhelper/
+debian/debhelper-build-stamp
+debian/files
+debian/*.log
+debian/*.substvars
+*.deb
+*.changes
+*.buildinfo
+*.upload
+obj-x86_64-linux-gnu/
+
 # Others
+.cache
 .vscode
-bin-*
-build
+binaries
+output
+packet
+releases
+install

.vscode/settings.json

@@ -4,6 +4,6 @@
     },
     "cmake.generator": "Ninja",
     "cmake.environment": {
-        "PATH": "C:\\Qt\\6.9.2\\msvc2022_64\\bin;${env:PATH};"
+        "PATH": "C:\\Qt\\6.10.0\\msvc2022_64\\bin;${env:PATH};"
     }
 }