feat: shared compiled; ui base; memory detections

Author: Charliechen114514

.gitignore

@@ -8,4 +8,8 @@ BLUEPRINT.md
 out/
 
 # .vscode
-.vscode
+.vscode
+
+# third_party dependencies (downloaded during configuration)
+third_party/*/
+!third_party/.gitkeep

CMakeLists.txt

@@ -12,7 +12,44 @@ message("Including Requested CMake Dependencies OK")
 include(cmake/check_toolchain.cmake)
 project(CFDesktop VERSION 0.0.1 LANGUAGES CXX)
 
+# ------ Build Type Configuration ------
+# Validate and set build type
+if(NOT CMAKE_BUILD_TYPE)
+    message(FATAL_ERROR "CMAKE_BUILD_TYPE is not set. Please specify build_type in build_*.config.ini")
+endif()
+
+set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "RelWithDebInfo")
+
+# Set compiler flags for each build type (use CACHE FORCE to override CMake defaults)
+# Debug: No optimization (-O0), full debug info (-g)
+set(CMAKE_CXX_FLAGS_DEBUG "-O0 -g" CACHE STRING "Flags used by the C++ compiler during Debug builds" FORCE)
+set(CMAKE_EXE_LINKER_FLAGS_DEBUG "" CACHE STRING "Linker flags used during Debug builds" FORCE)
+
+# Release: Maximum optimization (-O3), no debug info
+set(CMAKE_CXX_FLAGS_RELEASE "-O3 -DNDEBUG" CACHE STRING "Flags used by the C++ compiler during Release builds" FORCE)
+set(CMAKE_EXE_LINKER_FLAGS_RELEASE "-s" CACHE STRING "Linker flags used during Release builds" FORCE)
+
+# RelWithDebInfo: Optimization (-O2) + full debug info
+set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O2 -g -DNDEBUG" CACHE STRING "Flags used by the C++ compiler during RelWithDebInfo builds" FORCE)
+set(CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO "" CACHE STRING "Linker flags used during RelWithDebInfo builds" FORCE)
+
+string(TOUPPER "${CMAKE_BUILD_TYPE}" _build_type_upper)
+
+# Log build type and compiler flags (use variable indirection for nested expansion)
+set(_cxx_flags_var   "CMAKE_CXX_FLAGS_${_build_type_upper}")
+set(_link_flags_var  "CMAKE_EXE_LINKER_FLAGS_${_build_type_upper}")
+
+log_info("BuildSettings" "CMAKE_BUILD_TYPE: ${CMAKE_BUILD_TYPE}")
+log_info("BuildSettings" "CMAKE_CXX_FLAGS: ${CMAKE_CXX_FLAGS}")
+log_info("BuildSettings" "CMAKE_CXX_FLAGS_${CMAKE_BUILD_TYPE}: ${${_cxx_flags_var}}")
+log_info("BuildSettings" "CMAKE_EXE_LINKER_FLAGS: ${CMAKE_EXE_LINKER_FLAGS}")
+log_info("BuildSettings" "CMAKE_EXE_LINKER_FLAGS_${CMAKE_BUILD_TYPE}: ${${_link_flags_var}}")
+
 # ------ Build Settings ------
+# Set output directories for all targets to ensure DLLs and executables are together
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib")
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 # Disable response files in compile_commands.json for better clangd compatibility
 set(CMAKE_CXX_RESPONSE_FILE_FLAG "@")
@@ -48,15 +85,25 @@ include(cmake/generate_develop_helpers.cmake)
 log_info("DevHelpers" "Will Generate VSCode clangd configuration")
 generate_vscode_clangd()
 
+log_info("DevHelpers" "Will Generate VSCode debug configuration")
+generate_vscode_debug_config()
+
 # Print build configuration
 log_config_summary()
 log_qt_dir()
+
 # Log base module start
 log_module_start("base")
 add_subdirectory(base)
 # Log base module end
 log_module_end("base")
 
+# Log base module start
+log_module_start("ui")
+add_subdirectory(ui)
+# Log base module end
+log_module_end("ui")
+
 
 log_module_start("example")
 add_subdirectory("example")

README.md

@@ -44,27 +44,49 @@
      ✓ 自动生成 clangd 配置
      ✓ 保证与 QtCreator 几乎一致的丝滑开发体验
      ✓ 支持 C++23 语法高亮和代码补全
+     ✓ 自动生成 launch.json 和 tasks.json（支持 GDB/LLDB 调试）
 
 +3. 自动化构建脚本
      ✓ Windows PowerShell 构建脚本
      ✓ Linux Bash 构建脚本
      ✓ 支持多种工具链配置（LLVM/GCC）
      ✓ 部署（deploy）与开发（develop）双模式构建
-     ✓ 为后续开发打下坚实的基础
+     ✓ 新增测试运行脚本（windows_run_tests.ps1 / linux_run_tests.sh）
 
 +4. CMake 基础设施
      ✓ 模块化 CMake 架构
      ✓ 自定义日志输出系统
      ✓ 工具链检测与配置管理
      ✓ 编译命令生成（compile_commands.json）
+     ✓ 第三方依赖管理（third_party_helper.cmake）
+     ✓ 自动化输出目录配置（bin/lib 分离）
+
++5. 硬件探针模块（Phase 1）
+     ✓ CPU 信息检测（型号、核心数、频率）
+     ✓ CPU Profile 和 Features 检测
+     ✓ 内存信息检测（Windows 平台完成）
+
++6. Base 基础库（Phase 2）
+     ✓ 统一 cfbase.dll 动态库架构
+     ✓ expected 类型（std::expected 风格的错误处理）
+     ✓ scope_guard（RAII 风格的资源管理）
+
++7. UI 组件库（Phase 4 - 提前启动）
+     ✓ Material Design 规范文档（MaterialRules.md）
+     ✓ 基础数学工具（math_helper）
+     ✓ 颜色处理工具（color_helper, color）
+     ✓ 缓动曲线封装（easing）
+     ✓ 几何图形工具（geometry_helper）
+     ✓ 设备像素转换（device_pixel）
 ```
 
 ### 🚧 开发中
 
 | 模块 | 状态 | 阶段 |
 |:---|:---:|:---:|
 | 🔍 硬件探针模块 | ⏳ 进行中 | Phase 1 |
-| 📦 Base 基础库 | 📋 计划中 | Phase 2 |
+| 📦 Base 基础库 | ⏳ 进行中 | Phase 2 |
+| 🎨 UI 组件库 | ⏳ 进行中 | Phase 4 |
 | ⌨️ 输入抽象层 | 📋 计划中 | Phase 3 |
 
 ---
@@ -121,6 +143,9 @@
 # 完整构建（包含完整清理流程）
 .\scripts\build_helpers\windows_develop_build.ps1
 .\scripts\build_helpers\windows_deploy_build.ps1
+
+# 运行测试
+.\scripts\build_helpers\windows_run_tests.ps1
 ```
 
 ### 🐧 Linux 构建
@@ -132,6 +157,9 @@
 # 快速构建（推荐日常开发）
 ./scripts/build_helpers/linux_fast_develop_build.sh
 ./scripts/build_helpers/linux_fast_deploy_build.sh
+
+# 运行测试
+./scripts/build_helpers/linux_run_tests.sh
 ```
 
 ### ⚙️ 构建配置
@@ -157,12 +185,20 @@
 
 ### 🤝 VSCode + Clangd
 
-项目已配置自动生成 clangd 配置。首次运行 CMake 配置后，会在项目根目录生成 `.clangd` 配置文件，提供：
+项目已配置自动生成 VSCode 开发配置。首次运行 CMake 配置后：
+
+**在构建目录生成：**
+- `.vscode/launch.json` - 调试配置（自动检测 GDB/LLDB）
+- `.vscode/tasks.json` - 构建任务（CMake Configure/Build/Clean/CTest）
+- `.clangd` - Clangd 语言服务器配置
 
+**提供的功能：**
 - ✨ 精准的代码补全
 - ✔️ 实时语法检查
 - 🔍 跳转到定义
 - 🔧 重构支持
+- 🐛 一键调试（F5）
+- 📦 快速构建（Ctrl+Shift+B）
 
 ### 🎨 QtCreator
 
@@ -261,7 +297,7 @@ graph LR
 
   **Made with ❤️ for embedded devices**
 
-  *最后更新: 2026-02-21*
+  *最后更新: 2026-02-23*
 
   [⬆ 返回顶部](#-cfdesktop)
 

base/CMakeLists.txt

@@ -1,30 +1,36 @@
 # Base library - fundamental utilities and platform abstractions
 cmake_minimum_required(VERSION 3.16)
 
-# Include subdirectory CMakeLists
+# Include subdirectory CMakeLists (OBJECT libraries)
 add_subdirectory(system/cpu)
 add_subdirectory(system/memory)
 
 # ============================================================
-# Unified Base Library
+# Unified Base Library - Single DLL: cfbase.dll
 # ============================================================
 
-# Create interface library that merges all sub-libraries
-add_library(cfbase INTERFACE)
+# Create the unified shared library
+add_library(cfbase SHARED)
 
-# Link all CPU and memory modules
-target_link_libraries(cfbase INTERFACE
-    cfbase_cpu_info
-    cfbase_cpu_profile
-    cfbase_cpu_bonus
-    cfbase_cpu_features
-    cfbase_memory_info
+# Merge all object files from sub-modules
+target_sources(cfbase PRIVATE
+    $<TARGET_OBJECTS:cfbase_cpu>
+    $<TARGET_OBJECTS:cfbase_memory>
+)
+
+# Set include directories
+target_include_directories(cfbase PUBLIC
+    ${CMAKE_CURRENT_SOURCE_DIR}/include
+)
+
+# Link dependencies
+target_link_libraries(cfbase PUBLIC
     Qt6::Core
 )
 
-# Platform-specific link for unified library
+# Platform-specific link libraries
 if(WIN32)
-    target_link_libraries(cfbase INTERFACE
+    target_link_libraries(cfbase PUBLIC
         wbemuuid
         PowrProf
         pdh
@@ -36,3 +42,6 @@ endif()
 # Aliases
 # ============================================================
 add_library(CFDesktop::base ALIAS cfbase)
+# For backward compatibility
+add_library(CFDesktop::base_cpu ALIAS cfbase)
+add_library(CFDesktop::base_memory ALIAS cfbase)

base/include/base/expected/expected.hpp

@@ -1248,13 +1248,34 @@ template <typename T, typename E> class expected {
         } else if (!has_val_ && !o.has_val_) {
             swap(storage_.err, o.storage_.err);
         } else {
-            expected* src = has_val_ ? this : &o;
-            expected* dst = has_val_ ? &o : this;
-            ::new (&dst->storage_.val) T(std::move(src->storage_.val));
-            src->storage_.val.~T();
-            ::new (&src->storage_.err) E(std::move(dst->storage_.err));
-            dst->storage_.err.~E();
-            swap(src->has_val_, dst->has_val_);
+            // Swap between value-holding and error-holding expected
+            if (has_val_) {
+                // this has value, o has error
+                T tmp_val(std::move(storage_.val));
+                storage_.val.~T();
+
+                ::new (&storage_.err) E(std::move(o.storage_.err));
+                o.storage_.err.~E();
+
+                ::new (&o.storage_.val) T(std::move(tmp_val));
+                // tmp_val is destroyed here
+
+                has_val_ = false;
+                o.has_val_ = true;
+            } else {
+                // this has error, o has value
+                E tmp_err(std::move(storage_.err));
+                storage_.err.~E();
+
+                ::new (&storage_.val) T(std::move(o.storage_.val));
+                o.storage_.val.~T();
+
+                ::new (&o.storage_.err) E(std::move(tmp_err));
+                // tmp_err is destroyed here
+
+                has_val_ = true;
+                o.has_val_ = false;
+            }
         }
     }
 

base/include/base/scope_guard/scope_guard.hpp

@@ -60,7 +60,8 @@ class ScopeGuard {
      * @since      0.1
      * @ingroup    base_utilities
      */
-    explicit ScopeGuard(std::function<void()> f) : fn_(std::move(f)) {}
+    template <typename F>
+    explicit ScopeGuard(F&& f) : fn_(std::forward<F>(f)) {}
 
     /**
      * @brief  Destroys the scope guard and executes the cleanup function.
@@ -78,7 +79,7 @@ class ScopeGuard {
      * @since      0.1
      * @ingroup    base_utilities
      */
-    ~ScopeGuard() {
+    ~ScopeGuard() noexcept(false) {
         if (active_)
             fn_();
     }
@@ -99,6 +100,22 @@ class ScopeGuard {
      */
     ScopeGuard& operator=(const ScopeGuard&) = delete;
 
+    /**
+     * @brief  Move constructor is deleted.
+     *
+     * @since      0.1
+     * @ingroup    base_utilities
+     */
+    ScopeGuard(ScopeGuard&&) = delete;
+
+    /**
+     * @brief  Move assignment operator is deleted.
+     *
+     * @since      0.1
+     * @ingroup    base_utilities
+     */
+    ScopeGuard& operator=(ScopeGuard&&) = delete;
+
     /**
      * @brief  Dismisses the scope guard.
      *

base/system/cpu/CMakeLists.txt

@@ -1,7 +1,7 @@
-# CPU Module Library
+# CPU Module - compiled as OBJECT library for merging into cfbase.dll
 cmake_minimum_required(VERSION 3.16)
 
-add_library(cfbase_cpu STATIC)
+add_library(cfbase_cpu OBJECT)
 target_include_directories(cfbase_cpu
     PUBLIC
         ${CMAKE_CURRENT_SOURCE_DIR}/../../include
@@ -24,7 +24,6 @@ if(WIN32)
     target_include_directories(cfbase_cpu PRIVATE
         ${CMAKE_CURRENT_SOURCE_DIR}/private
     )
-    target_link_libraries(cfbase_cpu PUBLIC wbemuuid PowrProf pdh)
 elseif(UNIX)
     target_sources(cfbase_cpu PRIVATE
         private/linux_impl/cpu_profile.cpp
@@ -34,5 +33,3 @@ elseif(UNIX)
         ../../utils/linux/proc_parser.cpp
     )
 endif()
-
-add_library(CFDesktop::base_cpu ALIAS cfbase_cpu)

base/system/memory/CMakeLists.txt

@@ -1,7 +1,7 @@
-# Memory Module Library
+# Memory Module - compiled as OBJECT library for merging into cfbase.dll
 cmake_minimum_required(VERSION 3.16)
 
-add_library(cfbase_memory STATIC)
+add_library(cfbase_memory OBJECT)
 target_include_directories(cfbase_memory
     PUBLIC
         ${CMAKE_CURRENT_SOURCE_DIR}/../../include
@@ -20,15 +20,8 @@ if(WIN32)
         private/win_impl/process_memory.cpp
         private/win_impl/dimm_info.cpp
     )
-    target_link_libraries(cfbase_memory PUBLIC psapi)
 elseif(UNIX)
     target_sources(cfbase_memory PRIVATE
         private/linux_impl/memory_info.cpp
     )
 endif()
-
-# Link Qt Core for QtGlobal header
-find_package(Qt6 COMPONENTS Core REQUIRED)
-target_link_libraries(cfbase_memory PRIVATE Qt6::Core)
-
-add_library(CFDesktop::base_memory ALIAS cfbase_memory)