build: 更新Qt版本至6.11.1并完善工程配置规范

1.  更新VSCode、CI、打包脚本中的Qt 6.10.2路径为6.11.1
2.  新增项目代码规范文档：Qt6、C++20、CMake、QML、内存安全、错误处理等
3.  重构编译配置：替换旧的弃用定义宏，新增统一编译器警告设置
4.  优化路径引用和代码格式，修复部分clang-tidy检查规则
5.  调整qmake和cmake的输出目录、平台库配置逻辑

Author: RealChuan

.clang-format

@@ -5,36 +5,39 @@ AlignAfterOpenBracket: Align
 AlignConsecutiveAssignments: false
 AlignConsecutiveDeclarations: false
 AlignEscapedNewlines: DontAlign
-AlignOperands: true
-AlignTrailingComments: true
+AlignOperands: Align
+AlignTrailingComments:
+  Kind: Always
+  OverEmptyLines: 1
 AllowAllParametersOfDeclarationOnNextLine: true
-AllowShortBlocksOnASingleLine: true
+AllowShortBlocksOnASingleLine: Always
 AllowShortCaseLabelsOnASingleLine: true
+AllowShortEnumsOnASingleLine: true
 AllowShortFunctionsOnASingleLine: Inline
-AllowShortIfStatementsOnASingleLine: false
-AlwaysBreakAfterDefinitionReturnType: None
-AlwaysBreakAfterReturnType: None
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
 AlwaysBreakBeforeMultilineStrings: false
 AlwaysBreakTemplateDeclarations: Yes
 BinPackArguments: false
 BinPackParameters: false
 BraceWrapping:
   AfterClass: true
-  AfterControlStatement: false
+  AfterControlStatement: Never
   AfterEnum: false
   AfterFunction: true
   AfterNamespace: false
-  AfterObjCDeclaration: false
   AfterStruct: true
   AfterUnion: false
   AfterExternBlock: false
   BeforeCatch: false
   BeforeElse: false
+  BeforeLambdaBody: false
+  BeforeWhile: false
   IndentBraces: false
   SplitEmptyFunction: false
   SplitEmptyRecord: false
   SplitEmptyNamespace: false
-BreakAfterJavaFieldAnnotations: false
+BreakAfterReturnType: None
 BreakBeforeBinaryOperators: All
 BreakBeforeBraces: Custom
 BreakBeforeTernaryOperators: true
@@ -44,13 +47,13 @@ BreakStringLiterals: true
 ColumnLimit: 100
 CommentPragmas: '^ IWYU pragma:'
 CompactNamespaces: false
-ConstructorInitializerAllOnOneLineOrOnePerLine: false
 ConstructorInitializerIndentWidth: 4
 ContinuationIndentWidth: 4
 Cpp11BracedListStyle: true
 DerivePointerAlignment: false
 DisableFormat: false
-ExperimentalAutoDetectBinPacking: false
+EmptyLineAfterAccessModifier: Never
+EmptyLineBeforeAccessModifier: LogicalBlock
 FixNamespaceComments: true
 ForEachMacros:
   - forever
@@ -67,30 +70,19 @@ IndentCaseLabels: false
 IndentPPDirectives: None
 IndentWidth: 4
 IndentWrappedFunctionNames: false
-JavaScriptQuotes: Leave
-JavaScriptWrapImports: true
+InsertNewlineAtEOF: true
 KeepEmptyLinesAtTheStartOfBlocks: false
 Language: Cpp
-MacroBlockBegin: ''
-MacroBlockEnd: ''
 MaxEmptyLinesToKeep: 1
 NamespaceIndentation: None
-ObjCBinPackProtocolList: Auto
-ObjCBlockIndentWidth: 4
-ObjCSpaceAfterProperty: false
-ObjCSpaceBeforeProtocolList: true
-PenaltyBreakAssignment: 150
-PenaltyBreakBeforeFirstCallParameter: 300
-PenaltyBreakComment: 500
-PenaltyBreakFirstLessLess: 400
-PenaltyBreakString: 600
-PenaltyBreakTemplateDeclaration: 10
-PenaltyExcessCharacter: 50
-PenaltyReturnTypeOnItsOwnLine: 300
+PackConstructorInitializers: NextLine
 PointerAlignment: Right
+QualifierAlignment: Left
+ReferenceAlignment: Pointer
 ReflowComments: false
-SortIncludes: true
-SortUsingDeclarations: true
+SeparateDefinitionBlocks: Always
+SortIncludes: CaseInsensitive
+SortUsingDeclarations: LexicographicNumeric
 SpaceAfterCStyleCast: true
 SpaceAfterTemplateKeyword: false
 SpaceBeforeAssignmentOperators: true
@@ -101,7 +93,7 @@ SpaceBeforeParens: ControlStatements
 SpaceBeforeRangeBasedForLoopColon: true
 SpaceInEmptyParentheses: false
 SpacesBeforeTrailingComments: 1
-SpacesInAngles: false
+SpacesInAngles: Never
 SpacesInCStyleCastParentheses: false
 SpacesInContainerLiterals: false
 SpacesInParentheses: false
@@ -110,4 +102,4 @@ StatementMacros:
   - Q_UNUSED
   - QT_REQUIRE_VERSION
 TabWidth: 4
-UseTab: Never
+UseTab: Never

.clang-tidy

@@ -7,7 +7,12 @@ Checks: >
   modernize-*,
   cppcoreguidelines-*,
   concurrency-*,
+  portability-*,
+  readability-duplicate-include,
+  readability-redundant-string-cstr,
+  readability-simplify-boolean-expr,
   -modernize-use-trailing-return-type,
+  -modernize-use-std-print,
   -cppcoreguidelines-avoid-magic-numbers,
   -llvm-header-guard,
   -readability-identifier-length,
@@ -32,7 +37,6 @@ WarningsAsErrors: >
   performance-trivially-destructible,
   bugprone-exception-escape
 
-HeaderFilterRegex: '.'
+HeaderFilterRegex: "."
 AnalyzeTemporaryDtors: true
 FormatStyle: file
-User: user

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

@@ -9,7 +9,7 @@ inputs:
   qt_ver:
     description: "qt version"
     required: false
-    default: "6.10.2"
+    default: "6.11.1"
     type: string
 
 runs:

.trae/rules/cmake-best-practices.md

@@ -0,0 +1,14 @@
+- 要求 CMake 3.25+；使用 `cmake_minimum_required(VERSION 3.25)`
+- 优先使用 `target_*` 命令；仅当设置需应用于所有目标时才用全局 `add_compile_definitions`/`add_compile_options`
+- 禁止全局 `include_directories`/`add_definitions`（路径/定义应按目标控制）
+- 用 `target_compile_features(target PRIVATE cxx_std_20)` 设置语言标准
+- 用 `GNUInstallDirs` 实现可移植安装路径
+- 用 `FetchContent` 或带版本约束的 `find_package`
+- 禁止 `file(GLOB)` 收集源文件；显式列出
+- 使用 `BUILD_INTERFACE`/`INSTALL_INTERFACE` 生成器表达式
+- 使用 `CMakePresets.json` 管理构建配置
+- 通过 `target_compile_options` 启用警告，而非原始标志
+- 使用 `cmake_policy(SET CMP0167 NEW)` 发现 Qt6 模块
+- 使用 `qt_standard_project_setup()` 初始化 Qt6 项目
+- 导出目标时设置 `NAMESPACE` 和配置文件
+- CI 中将警告视为错误：`-Werror`

.trae/rules/cpp-modern.md

@@ -0,0 +1,14 @@
+- 最低目标 C++20，工具链支持时优先 C++23
+- 用 `std::span` 替代指针+长度参数对
+- 可恢复错误优先用 `std::expected`，而非异常
+- 用 `constexpr`/`consteval` 进行编译期计算
+- 用 `concepts` 约束模板，替代 SFINAE
+- 用 `std::format` 替代 printf/iostream 格式化
+- 优先用 `std::ranges` 算法替代手写循环
+- 用 `std::jthread` 替代 `std::thread`（自动 join）
+- 禁止裸 `new`/`delete`；用 `std::make_unique`/`std::make_shared`
+- 适当标记 `[[nodiscard]]`、`[[deprecated]]`
+- 用结构化绑定处理多返回值
+- 统一用 `=` 或 `{}` 初始化；避免 `()`
+- 用 `if constexpr` 替代标签分派
+- 优先用 `enum class`，避免裸 `enum`

.trae/rules/cross-platform.md

@@ -0,0 +1,13 @@
+- 平台特定代码使用 `Q_OS_WIN`/`Q_OS_MACOS`/`Q_OS_LINUX`
+- 使用 `QDir::separator()` 或 `/`（Qt 会自动规范化路径）
+- 使用 `QStandardPaths` 获取系统路径
+- 使用 `QSysInfo` 进行运行时平台检测
+- 避免平台特定 API；必要时用 `#ifdef` 包裹
+- 使用 `#pragma once` 替代头文件保护宏
+- 使用 `Q_DECL_DEPRECATED` 标记弃用
+- 使用 `Q_REQUIRED_RESULT` 替代 `[[nodiscard]]`
+- 使用 `Q_LIKELY`/`Q_UNLIKELY` 进行分支提示
+- 使用 `qint64`/`qint32` 等可移植整数类型
+- 避免编译器特定 `#pragma`；使用 `Q_*` 宏
+- CI 中在所有目标平台上测试
+- 使用 `QFile`/`QSaveFile` 替代原始文件 API

.trae/rules/error-handling.md

@@ -0,0 +1,12 @@
+- 异常仅用于不可恢复情况，不用于控制流
+- 可恢复错误使用 `std::expected<T, E>`
+- 跨边界错误报告使用 `std::error_code`
+- OS 级错误使用 `std::system_error`
+- 按常量引用捕获：`catch (const std::exception& e)`
+- 移动构造函数和析构函数标记 `noexcept`
+- 调试断言使用 `Q_ASSERT`
+- 不可达代码使用 `Q_UNREACHABLE()`
+- 日志使用 `qWarning()`/`qCritical()`
+- 文档中注明异常保证：基本、强、不抛出
+- 永不返回的函数标记 `[[noreturn]]`
+- 跨线程错误传播使用 `QException`

.trae/rules/memory-safety.md

@@ -0,0 +1,13 @@
+- 独占所有权使用 `std::unique_ptr`
+- 仅在需要共享所有权时使用 `std::shared_ptr`
+- 使用 `std::weak_ptr` 打破循环引用
+- 使用 `std::make_unique`/`std::make_shared` 替代 `new`
+- Qt 风格 RAII 可使用 `QScopedPointer`
+- 使用 `std::vector` 替代 `new[]`
+- 非拥有视图使用 `std::span`
+- 只读字符串参数使用 `std::string_view`
+- C++ 中禁止使用 `malloc`/`free`
+- QObject 弱引用使用 `QPointer`
+- 延迟删除使用 `QObject::deleteLater()`
+- 裸指针仅作非拥有视图；禁止作为所有者
+- 互斥锁 RAII 使用 `std::lock_guard`/`std::unique_lock`

.trae/rules/qml-best-practices.md

@@ -0,0 +1,14 @@
+- 使用 Qt 6 QML 无版本导入：`import QtQuick`
+- 根元素优先用 `Item`；避免用 `Rectangle` 作容器
+- 使用 `required property` 定义显式接口
+- 慎用 `Component.onCompleted`；优先使用属性绑定
+- 用 `QML_ELEMENT` 注册 C++ 类型，替代 `qmlRegisterType`
+- 列表使用 `ListView` 配合 `model` 和 `delegate`
+- 使用 `Loader` 延迟加载重型组件
+- 仅在需要动态重绑定时使用 `Qt.binding()`
+- 分离模型（C++）与视图（QML）；遵循 MVC 模式
+- 避免命令式 JS；使用属性绑定
+- CI 中运行 `qmllint` 和 `qmlformat`
+- 使用 `property alias` 暴露内部组件
+- 全局对象优先用 `QML_SINGLETON`
+- 结构化数据使用 `QML_STRUCTURED_VALUE`

.trae/rules/qt6-best-practices.md

@@ -0,0 +1,13 @@
+- 优先使用 Qt 6 API，避免 Qt 5 遗留接口
+- 使用 `QString` 字面量：`u"s..."_s`
+- 信号槽使用函数指针语法，禁止 `SIGNAL()`/`SLOT()` 字符串形式
+- 用 `QML_ELEMENT`/`QML_NAMED_ELEMENT` 将 C++ 类型暴露给 QML
+- 用 `QProperty`/`QBindable` 实现响应式绑定
+- 用 `std::make_unique` 或 Qt 父对象所有权；禁止裸 `new`
+- 不可拷贝类型使用 `Q_DISABLE_COPY_MOVE`
+- 优先用 `QMetaObject::invokeMethod` 的 functor 重载
+- 槽函数中禁止阻塞调用；使用 `QtConcurrent` 或 `QThreadPool`
+- 异步操作使用 `QFutureWatcher` 或 `QCoro`
+- 发射信号时使用 `emit` 关键字
+- 元数据反射优先用 `Q_ENUM`/`Q_FLAG`
+- 使用 `qWarning()`/`qInfo()`/`qCritical()` 分类日志