ensure update todo requests

Author: Charliechen114514

README.md

@@ -280,6 +280,18 @@
 
 ---
 
+## 📋 TODO
+
+项目开发任务清单请查看 [document/todo/](document/todo/)：
+
+| 资源 | 描述 |
+|:---|:---|
+| [TODO 看板](document/todo/index.md) | 各模块任务清单与进度跟踪 |
+| [项目状态报告](document/todo/done/PROJECT_STATUS_REPORT.md) | 整体完成度与优先级建议 |
+| [参考文档](document/todo/done/) | 各模块实现参考文档 |
+
+---
+
 ## 🔧 技术栈
 
 <div align="center">

document/todo/00_project_skeleton.md

@@ -0,0 +1,151 @@
+# Phase 0: 工程骨架搭建 TODO
+
+> **状态**: 🚧 进行中
+> **预计周期**: 1~2 周
+> **依赖阶段**: 无
+> **目标交付物**: 完整的 CMake 构建体系、目录结构、跨平台 CI/CD
+
+---
+
+## 一、阶段目标
+
+### 核心目标
+建立项目的工程化基础，确保后续所有开发工作在稳固的架构上进行。
+
+### 具体交付物
+- [ ] 完整的 CMake 构建体系
+- [ ] 三层模块目录结构（base/sdk/shell）
+- [ ] 跨平台 CI/CD 流水线
+- [ ] 开发环境配置指南
+- [ ] 代码规范与格式化配置
+
+---
+
+## 二、Week 1 任务
+
+### Day 1-2: 目录结构创建
+- [ ] 创建完整目录树
+  - [ ] `src/base/` - 基础库源码
+  - [ ] `src/sdk/` - SDK 层源码
+  - [ ] `src/shell/` - Shell UI 源码
+  - [ ] `src/simulator/` - 模拟器源码
+  - [ ] `include/CFDesktop/` - 公共头文件
+  - [ ] `tests/` - 测试代码
+  - [ ] `cmake/` - CMake 模块
+  - [ ] `assets/` - 资源文件
+- [ ] 编写主 [CMakeLists.txt](../../CMakeLists.txt)
+  - [ ] 设置 C++23 标准
+  - [ ] 配置 Qt6 依赖
+  - [ ] 添加子目录
+- [ ] 配置 [CMakePresets.json](../../CMakePresets.json)
+  - [ ] `linux-default` - 本地开发
+  - [ ] `linux-arm-sf` - ARMv7 软渲染
+  - [ ] `linux-arm-hf` - ARM64 硬件加速
+- [ ] 创建各子模块的 CMakeLists.txt 框架
+
+### Day 3-4: 交叉编译配置
+- [ ] 编写 ARMv7 工具链文件 `cmake/toolchains/arm-linux-gnueabihf.cmake`
+  - [ ] 设置 CMAKE_SYSTEM_NAME 为 Linux
+  - [ ] 配置 arm-linux-gnueabihf-gcc/g++
+  - [ ] 设置 Qt6 路径
+- [ ] 编写 ARM64 工具链文件 `cmake/toolchains/aarch64-linux-gnu.cmake`
+  - [ ] 设置 CMAKE_SYSTEM_PROCESSOR 为 aarch64
+  - [ ] 配置 aarch64-linux-gnu-gcc/g++
+  - [ ] 设置 Qt6 ARM64 路径
+- [ ] 配置 Qt6 路径查找逻辑
+- [ ] 测试交叉编译（可用 Docker 验证）
+  - [ ] 验证 ARMv7 编译
+  - [ ] 验证 ARM64 编译
+
+### Day 5: 代码规范配置
+- [ ] 配置 [.clang-format](../../.clang-format)
+  - [ ] 基于 Google 风格
+  - [ ] 设置缩进为 4 空格
+  - [ ] 配置列宽 100
+  - [ ] 设置指针对齐方式
+- [ ] 配置 [.clang-tidy](../../.clang-tidy)
+  - [ ] 启用 modernize 检查
+  - [ ] 配置性能相关检查
+- [ ] 编写代码格式化脚本 `tools/format.sh`
+- [ ] 配置 Git pre-commit hook
+  - [ ] 创建 `.git-hooks/pre-commit` 脚本
+  - [ ] 自动格式化检查 (clang-format --dry-run)
+  - [ ] 静态分析 (clang-tidy)
+  - [ ] 添加 trailing whitespace 检查
+  - [ ] 配置可跳过选项 (git commit --no-verify)
+  - [ ] 安装脚本配置 (`tools/install-hooks.sh`)
+
+---
+
+## 三、Week 2 任务
+
+### Day 1-3: CI/CD 搭建
+- [ ] 创建 Docker 构建镜像
+  - [ ] `docker/builder-linux-x64/Dockerfile`
+  - [ ] `docker/builder-arm-sf/Dockerfile`
+  - [ ] 配置 Qt6 环境
+- [ ] 编写 GitHub Actions 工作流 `.github/workflows/build.yml`
+  - [ ] `build-linux-x64` 作业
+  - [ ] `build-arm-sf` 交叉编译作业
+  - [ ] `code-quality` 静态分析作业
+  - [ ] 配置 artifact 上传
+- [ ] 配置部署流程 `.github/workflows/deploy.yml`
+  - [ ] 设备选择输入
+  - [ ] SSH 部署配置
+- [ ] 测试完整构建流程
+
+### Day 4-5: 开发工具完善
+- [ ] 创建 VSCode 工作区配置 `.vscode/settings.json`
+  - [ ] CMake 配置参数
+  - [ ] 代码格式化保存
+  - [ ] Clang 配置
+- [ ] 配置推荐扩展 `.vscode/extensions.json`
+  - [ ] CMake Tools
+  - [ ] C/C++
+  - [ ] clang-format
+- [ ] 编写开发环境设置文档 `docs/development/SETUP.md`
+- [ ] 创建应用模板框架 `templates/app-template/`
+- [ ] 编写 Hello World 测试程序
+
+---
+
+## 四、验收标准
+
+### 构建系统
+- [ ] `cmake --preset linux-default && cmake --build build --preset linux-default` 成功
+- [ ] `cmake --preset linux-arm-sf && cmake --build build --preset linux-arm-sf` 产出 ARM 二进制
+- [ ] 所有目标编译无警告
+
+### CI/CD
+- [ ] Push 代码自动触发构建
+- [ ] 构建失败发送通知
+- [ ] 测试用例自动运行
+- [ ] Artifact 正确上传
+
+### 开发环境
+- [ ] VSCode 能够正确索引所有符号
+- [ ] 代码格式化一键执行
+- [ ] 远程调试配置可用
+- [ ] 新团队成员能在 30 分钟内完成环境搭建
+
+---
+
+## 五、风险与缓解
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| Qt6 交叉编译配置复杂 | 延迟 2-3 天 | 使用 Docker 预配置环境 |
+| CI 资源不足 | 构建时间长 | 优化依赖缓存，使用矩阵策略 |
+| 工具链版本兼容性 | 编译失败 | 固定 Docker 镜像版本 |
+
+---
+
+## 六、相关文档
+
+- 设计文档: [../design_stage/00_phase0_project_skeleton.md](../design_stage/00_phase0_project_skeleton.md)
+- 主 CMakeLists.txt: [../../CMakeLists.txt](../../CMakeLists.txt)
+- CMake 预设: [../../CMakePresets.json](../../CMakePresets.json)
+
+---
+
+*最后更新: 2026-03-05*

document/todo/01_hardware_probe.md

@@ -0,0 +1,226 @@
+# Phase 1: 硬件探针与能力分级 TODO
+
+> **状态**: ⬜ 待开始
+> **预计周期**: 2~3 周
+> **依赖阶段**: Phase 0
+> **目标交付物**: 硬件检测模块、能力档位枚举、配置文件系统
+
+---
+
+## 一、阶段目标
+
+### 核心目标
+实现开机自动硬件检测，输出能力档位枚举，作为后续所有模块的行为裁剪依据。
+
+### 具体交付物
+- [ ] `HardwareProbe` 模块及其单元测试
+- [ ] `CapabilityPolicy` 策略引擎
+- [ ] `HWTier` 枚举定义及查询接口
+- [ ] 设备配置文件 `/etc/CFDesktop/device.conf`
+- [ ] Mock 数据集用于单元测试
+
+---
+
+## 二、Week 1: 基础检测器实现
+
+### Day 1-2: CPU 检测器
+- [ ] 创建 `CPUDetector` 类框架
+  - [ ] 定义 `CPUInfo` 结构体
+  - [ ] 实现 `detectCPU()` 方法
+- [ ] 实现 `/proc/cpuinfo` 解析
+  - [ ] 解析 CPU 型号
+  - [ ] 解析核心数
+  - [ ] 解析频率
+  - [ ] 解析特性 (neon, vfpv4)
+- [ ] 实现设备树 compatible 读取
+  - [ ] 读取 `/sys/firmware/devicetree/base/compatible`
+- [ ] 实现 `uname` 架构检测
+- [ ] 编写 CPU 检测单元测试
+  - [ ] IMX6ULL Mock 数据
+  - [ ] RK3568 Mock 数据
+  - [ ] RK3588 Mock 数据
+
+### Day 3: GPU 检测器
+- [ ] 创建 `GPUDetector` 类框架
+  - [ ] 定义 `GPUInfo` 结构体
+- [ ] 实现 DRM 设备检测
+  - [ ] 检测 `/dev/dri/card*`
+- [ ] 实现 OpenGL 上下文创建
+  - [ ] 获取 GPU 信息
+  - [ ] 获取扩展列表
+- [ ] 实现 GPU 能力查询
+  - [ ] 最大纹理尺寸
+  - [ ] OpenGL 版本
+- [ ] 编写 GPU 检测单元测试
+
+### Day 4: 内存与网络检测器
+- [ ] 实现 `/proc/meminfo` 解析
+  - [ ] 定义 `MemoryInfo` 结构体
+  - [ ] 解析总内存
+  - [ ] 解析可用内存
+  - [ ] 解析 Swap
+- [ ] 实现网络接口枚举
+  - [ ] 定义 `NetworkInterface` 结构体
+  - [ ] 枚举 `/sys/class/net/*`
+  - [ ] 获取 IP 地址
+- [ ] 编写相应单元测试
+
+### Day 5: 档位计算逻辑
+- [ ] 实现评分算法
+  - [ ] CPU 评分规则
+  - [ ] GPU 评分规则
+  - [ ] 内存评分规则
+- [ ] 定义档位阈值
+  - [ ] Low: 0-60 分
+  - [ ] Mid: 61-120 分
+  - [ ] High: 121+ 分
+- [ ] 实现 `calculateTier()` 方法
+- [ ] 验证各板卡档位判定
+  - [ ] IMX6ULL → Low
+  - [ ] RK3568 → Mid
+  - [ ] RK3588 → High
+
+---
+
+## 三、Week 2: 策略引擎与配置
+
+### Day 1-2: CapabilityPolicy 实现
+- [ ] 定义各策略结构体
+  - [ ] `AnimationPolicy`
+  - [ ] `RenderingPolicy`
+  - [ ] `VideoDecoderPolicy`
+  - [ ] `MemoryPolicy`
+- [ ] 实现档位特定策略配置
+  - [ ] Low 档策略
+  - [ ] Mid 档策略
+  - [ ] High 档策略
+- [ ] 实现 `getAnimationPolicy()`
+- [ ] 实现 `getRenderingPolicy()`
+- [ ] 实现 `getVideoDecoderPolicy()`
+- [ ] 实现 `getMemoryPolicy()`
+
+### Day 3: DeviceConfig 实现
+- [ ] 实现配置文件解析
+  - [ ] INI 格式解析
+  - [ ] 默认值处理
+- [ ] 实现配置文件写入
+- [ ] 实现自定义脚本执行
+  - [ ] 脚本路径配置
+  - [ ] JSON 输出解析
+- [ ] 编写配置测试
+
+### Day 4: 集成测试
+- [ ] 创建端到端测试用例
+  - [ ] 完整检测流程
+  - [ ] 策略应用验证
+- [ ] 测试 IMX6ULL 真机
+  - [ ] CPU 信息验证
+  - [ ] 档位验证
+- [ ] 测试 RK3568 真机
+- [ ] 测试 RK3588 真机
+- [ ] 验证自动档位判定
+
+### Day 5: 文档与优化
+- [ ] 编写 API 文档
+  - [ ] HardwareProbe 接口
+  - [ ] CapabilityPolicy 接口
+- [ ] 优化检测性能
+  - [ ] 目标: < 500ms
+- [ ] 添加性能日志
+- [ ] Code Review
+
+---
+
+## 四、Week 3: 完善与验证
+
+### Day 1-2: 跨平台支持
+- [ ] 实现 Windows 平台检测
+  - [ ] WMI 查询
+  - [ ] GPU 检测
+- [ ] 实现模拟器平台适配
+  - [ ] Mock 数据支持
+  - [ ] 环境变量检测
+- [ ] 编写平台特定测试
+
+### Day 3-4: 真机验证
+- [ ] 在 IMX6ULL 上完整测试
+  - [ ] 性能测试
+  - [ ] 内存占用测试
+- [ ] 在 RK3568 上完整测试
+  - [ ] OpenGL 检测验证
+  - [ ] 硬件解码验证
+- [ ] 在 RK3588 上完整测试
+  - [ ] 全功能验证
+- [ ] 收集性能数据
+
+### Day 5: 发布准备
+- [ ] 最终测试
+- [ ] 更新文档
+- [ ] 准备演示
+- [ ] 合并主分支
+
+---
+
+## 五、验收标准
+
+### 功能验收
+- [ ] 在 IMX6ULL 上正确识别为 Low 档
+- [ ] 在 RK3568 上正确识别为 Mid 档
+- [ ] 在 RK3588 上正确识别为 High 档
+- [ ] 所有单元测试通过（覆盖率 > 90%）
+- [ ] 配置文件覆盖功能正常
+- [ ] 自定义脚本执行正常
+
+### 性能验收
+- [ ] 硬件检测耗时 < 500ms
+- [ ] 内存占用 < 5MB
+- [ ] 不影响系统启动时间
+
+### 代码质量
+- [ ] 符合代码规范
+- [ ] 通过 clang-tidy 检查
+- [ ] API 文档完整
+- [ ] 代码审查通过
+
+---
+
+## 六、文件清单
+
+### 头文件
+- [ ] `include/CFDesktop/Base/HardwareProbe/HWTier.h`
+- [ ] `include/CFDesktop/Base/HardwareProbe/HardwareInfo.h`
+- [ ] `include/CFDesktop/Base/HardwareProbe/HardwareProbe.h`
+- [ ] `include/CFDesktop/Base/HardwareProbe/CapabilityPolicy.h`
+- [ ] `include/CFDesktop/Base/HardwareProbe/DeviceConfig.h`
+
+### 源文件
+- [ ] `src/base/hardware/HardwareProbe.cpp`
+- [ ] `src/base/hardware/CapabilityPolicy.cpp`
+- [ ] `src/base/hardware/DeviceConfig.cpp`
+- [ ] `src/base/hardware/detectors/CPUDetector.cpp`
+- [ ] `src/base/hardware/detectors/GPUDetector.cpp`
+- [ ] `src/base/hardware/detectors/MemoryDetector.cpp`
+- [ ] `src/base/hardware/detectors/NetworkDetector.cpp`
+- [ ] `src/base/hardware/platform/LinuxDetector.cpp`
+- [ ] `src/base/hardware/platform/WindowsDetector.cpp`
+
+### 测试文件
+- [ ] `tests/unit/base/hardware/test_hardware_probe.cpp`
+- [ ] `tests/unit/base/hardware/test_capability_policy.cpp`
+- [ ] `tests/mock/proc/cpuinfo_imx6ull`
+- [ ] `tests/mock/proc/cpuinfo_rk3568`
+- [ ] `tests/mock/proc/cpuinfo_rk3588`
+- [ ] `tests/mock/proc/meminfo_512mb`
+- [ ] `tests/mock/proc/meminfo_1gb`
+- [ ] `tests/mock/proc/meminfo_4gb`
+
+---
+
+## 七、相关文档
+
+- 设计文档: [../design_stage/01_phase1_hardware_probe.md](../design_stage/01_phase1_hardware_probe.md)
+- 依赖: [00_project_skeleton.md](00_project_skeleton.md)
+
+---
+
+*最后更新: 2026-03-05*