feat: desktop plan and retidy the doc

Author: Charliechen114514

PROJECT_STATUS_REPORT.md

@@ -0,0 +1,314 @@
+# CFDesktop 项目进展汇报
+
+**报告日期**: 2026-03-11
+**项目版本**: 0.9.2
+
+---
+
+## 一、项目概述
+
+**CFDesktop** 是一个基于 Qt6 和 C++17 开发的**嵌入式桌面 UI 框架**，采用 Material Design 3 设计规范。
+
+### 核心定位
+- **本质**：这是一个 UI 框架/组件库项目，**非完整的桌面环境**
+- **目标**：为嵌入式设备提供统一的 UI 组件库和开发框架
+- **特点**：性能自适应（根据硬件能力动态调整 UI 复杂度）
+
+### 技术栈
+| 技术 | 版本 |
+|------|------|
+| 编程语言 | C++17/23 |
+| UI 框架 | Qt 6.8.3+ |
+| 构建系统 | CMake 3.16+ |
+| 测试框架 | GoogleTest/GMock |
+| 支持平台 | Windows/Linux (x86_64/ARM64/ARMhf) |
+
+---
+
+## 二、整体完成度：约 55%
+
+```
+进度总览：
+████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 55%
+```
+
+### 各阶段完成度
+
+| 阶段 | 完成度 | 状态 |
+|------|--------|------|
+| Phase 0: 工程骨架 | 100% | ✅ 完成 |
+| Phase 1: 硬件探针 | 15% | 🚧 进行中 |
+| Phase 2: Base 库核心 | 35% | 🚧 进行中 |
+| Phase 3: 输入抽象层 | 0% | ⬜ 未开始 |
+| Phase 4: 多平台模拟器 | 0% | ⬜ 未开始 |
+| Phase 5: 测试体系 | 60% | 🚧 进行中 |
+| Phase 6: UI Material 框架 | 62% | 🚧 进行中 |
+
+---
+
+## 三、各模块详细完成情况
+
+### Phase 0: 工程骨架 ✅ 100%
+
+| 组件 | 状态 |
+|------|------|
+| CMake 构建系统 | ✅ 完成 - 支持 Debug/Release/RelWithDebInfo |
+| 代码规范配置 | ✅ 完成 - .clang-format 配置 |
+| Git pre-commit hooks | ✅ 完成 - 代码格式、文件名验证 |
+| CI/CD 流水线 | ✅ 完成 - Docker 多架构构建 |
+| 文档自动部署 | ✅ 完成 - MkDocs 集成 |
+
+**关键成果**：
+- 完整的目录结构建立
+- 跨平台构建支持 (Windows/Linux)
+- 自动化代码质量检查
+- VSCode 开发环境配置
+
+---
+
+### Phase 1: 硬件探针 🚧 15%
+
+| 组件 | 状态 | 说明 |
+|------|------|------|
+| CPU 检测器 | 🟡 80% | 型号、架构、频率、特性检测 |
+| 内存检测器 | 🟡 80% | 总内存、可用内存、Swap 检测 |
+| GPU 检测器 | ⬜ 0% | **待实现** - DRM设备检测、OpenGL上下文 |
+| HWTier 枚举定义 | ⬜ 0% | **待实现** - Low/Mid/High 三档 |
+| HardwareProbe 主类 | ⬜ 0% | **待实现** - 整合所有检测器 |
+| CapabilityPolicy 策略引擎 | ⬜ 0% | **待实现** - 档位特定配置 |
+
+**阻塞项**：HWTier 定义影响整个性能分级系统。
+
+---
+
+### Phase 2: Base 库核心 🚧 35%
+
+| 组件 | 状态 | 说明 |
+|------|------|------|
+| ThemeEngine (主题管理) | ✅ 100% | Material 配色方案、动态切换 |
+| AnimationManager (动画工厂) | ✅ 100% | 弹簧/时间动画、动画组 |
+| DPI 管理 | ✅ 100% | dp/sp 单位转换 |
+| ConfigStore (配置中心) | ⬜ 0% | **待实现** - 三层存储、变更监听 |
+| Logger (日志系统) | ⬜ 0% | **待实现** - 多Sink支持、日志轮转 |
+
+**注意**：已实现的功能偏向 UI 层，核心基础设施（ConfigStore、Logger）尚未完成。
+
+---
+
+### Phase 3: 输入抽象层 ⬜ 0%
+
+| 组件 | 状态 |
+|------|------|
+| InputManager 统一分发层 | ⬜ 待实现 |
+| TouchInputHandler 触摸处理器 | ⬜ 待实现 |
+| KeyInputHandler 按键处理器 | ⬜ 待实现 |
+| RotaryInputHandler 旋钮处理器 | ⬜ 待实现 |
+| GestureRecognizer 手势识别器 | ⬜ 待实现 |
+| FocusNavigator 焦点导航器 | ⬜ 待实现 |
+
+**风险**：这是所有交互功能的基础，完全未实现是项目的重大空白。
+
+---
+
+### Phase 4: 多平台模拟器 ⬜ 0%
+
+| 组件 | 状态 |
+|------|------|
+| SimulatorWindow 主窗口 | ⬜ 待实现 |
+| DeviceFrame 设备外壳渲染 | ⬜ 待实现 |
+| TouchVisualizer 触摸可视化 | ⬜ 待实现 |
+| HWTierSelector 硬件档位选择器 | ⬜ 待实现 |
+| DPI 注入器 | ⬜ 待实现 |
+| 硬件 Mock 系统 | ⬜ 待实现 |
+
+**依赖**：需要输入抽象层和硬件探针支持。
+
+---
+
+### Phase 5: 测试体系 🚧 60%
+
+| 组件 | 状态 | 覆盖率 |
+|------|------|--------|
+| Google Test 集成 | ✅ 100% | - |
+| Base Utilities 测试 | 🟡 90% | 4个测试文件 |
+| UI Base 测试 | 🟡 85% | 6个测试文件 |
+| UI Components 测试 | 🟡 60% | 5个测试文件 |
+| Widget 测试 | ⬜ 0% | **待补充** - P0控件单元测试 |
+| Animation 测试 | ⬜ 0% | **待补充** - 动画系统测试 |
+| UI 自动化测试 | ⬜ 0% | **待补充** - 鼠标/键盘/触摸模拟 |
+| 性能基准测试 | ⬜ 0% | **待补充** - 建立性能基线 |
+
+---
+
+### Phase 6: UI Material 框架 🚧 62%
+
+#### Layer 1-4 (底层架构) ✅ 100%
+- Layer 1: Core Math & Utility
+- Layer 2: Theme Engine
+- Layer 3: Animation Engine
+- Layer 4: Material Behavior
+
+#### P0 核心控件 ✅ 100% (7/7)
+
+| 控件 | 状态 |
+|------|------|
+| Button | ✅ |
+| TextField | ✅ |
+| TextArea | ✅ |
+| Label | ✅ |
+| CheckBox | ✅ |
+| RadioButton | ✅ |
+| GroupBox | ✅ |
+
+#### P1 常用控件 ⬜ 0% (0/12)
+> ComboBox, Slider, ProgressBar, Switch, ToggleButton, TabBar, TabView, ToolBar, ToolButton, MenuBar, ContextMenu, StatusBar
+
+#### P2 高级控件 ⬜ 0% (0/27)
+> DatePicker, TimePicker, Dialog, Card, Snackbar, Tooltip, Popover, SplitView, NavigationRail, NavigationDrawer, 等
+
+#### P3 专业控件 ⬜ 0% (0/25)
+> ChartView, CodeEditor, PropertyEditor, TreeView, TableView, 等
+
+---
+
+## 四、关键成果
+
+### 已实现的核心功能
+
+1. **完整的 Material Design 3 Token 系统**
+   - 颜色方案 (Material Scheme)
+   - 动作规范 (Motion)
+   - 圆角缩放 (Radius Scale)
+   - 字体类型 (Font Type)
+
+2. **分层架构**
+   - 数学 → 主题 → 动画 → 行为 → 控件
+
+3. **7个 Material 核心控件**完整实现
+   - 符合 Material Design 3 规范
+   - 状态机驱动的视觉反馈
+   - 涟漪效果、焦点环等交互细节
+
+4. **跨平台构建系统**
+   - 支持 Windows/Linux
+   - 多架构构建 (x86_64/ARM64/ARMhf)
+   - Docker CI/CD
+
+5. **测试框架**
+   - 21个测试文件
+   - 覆盖核心功能模块
+
+---
+
+## 五、关键阻塞点
+
+### 🔴 高优先级（P0）- 核心功能缺失
+
+| 模块 | 影响 |
+|------|------|
+| 输入抽象层 (0%) | 所有交互功能的基础 |
+| 硬件探针完善 | GPU检测、HWTier定义缺失 |
+| ConfigStore 配置中心 | 运行时配置管理 |
+| Logger 日志系统 | 调试和运维支持 |
+
+### 🟡 中优先级（P1）
+
+| 模块 | 影响 |
+|------|------|
+| P1 常用控件 (12个) | UI 组件库完整性 |
+| 模拟器开发 | 开发调试工具 |
+| Widget 测试补充 | 代码质量保障 |
+
+---
+
+## 六、依赖关系图
+
+```
+硬件探针 (15%) → Base库 (35%) → 输入层 (0%) → 模拟器 (0%)
+                      ↓
+                 UI框架 (62%)
+```
+
+---
+
+## 七、关键洞察
+
+### ⚠️ 项目定位分析
+
+**CFDesktop 当前更像是"UI 组件库"而非"桌面环境"**
+
+**已有**：
+- ✅ UI 基础框架
+- ✅ Material Design 主题系统
+- ✅ 动画引擎
+- ✅ 7个核心控件
+
+**缺失**（真正的"桌面"功能）：
+- ❌ 窗口管理器 (Window Manager)
+- ❌ 应用启动器 / 任务栏
+- ❌ 桌面图标 / 壁纸管理
+- ❌ 应用框架 / 沙箱
+- ❌ 系统托盘
+- ❌ 通知系统
+- ❌ 文件管理器集成
+- ❌ Shell 桌面界面
+
+---
+
+## 八、建议下一步
+
+### 如需完善当前 UI 框架
+
+1. **优先完成输入抽象层** (3-4周)
+   - InputManager 统一分发
+   - Touch/Key/Rotary 处理器
+   - 焦点导航系统
+
+2. **补充 P1 常用控件** (4-6周)
+   - ComboBox, Slider, ProgressBar 等
+
+3. **实现基础设施** (3-4周)
+   - ConfigStore 配置中心
+   - Logger 日志系统
+
+### 如需开发真正的桌面环境
+
+需要新增规划：
+
+- **窗口管理器** (Window Manager)
+- **应用框架** (Application Framework)
+- **Shell 桌面界面**
+- **系统服务集成**
+- **应用生命周期管理**
+
+---
+
+## 九、文件位置参考
+
+| 类型 | 路径 |
+|------|------|
+| 已完成任务文档 | `document/todo/done/*.md` |
+| 待办任务文档 | `document/todo/*.md` |
+| 源代码 | `base/`, `ui/` |
+| 测试 | `test/` |
+| 示例 | `example/` |
+
+---
+
+## 十、总结
+
+CFDesktop 项目在**基础设施和 UI 框架底层架构**方面取得了显著进展：
+- 工程骨架完善 ✅
+- Material Design 实现规范 ✅
+- 核心控件可用 ✅
+
+然而，项目面临**硬件抽象层和输入层的重大缺失**：
+- 输入层完全未实现 (0%) ❌
+- 硬件探针核心功能缺失 ❌
+- 配置和日志系统缺失 ❌
+
+这些是影响完整可用性的关键因素。建议优先完成硬件探针和输入层，以打通整个技术栈的闭环。
+
+---
+
+*本报告由自动化工具生成，基于 2026-03-11 的项目状态分析*