From 59659d01f323287762aa7bf44ba30ca4d5163e1e Mon Sep 17 00:00:00 2001
From: Charliechen114514 <725610365@qq.com>
Date: Fri, 22 May 2026 08:15:43 +0800
Subject: [PATCH 1/2] todo update once for issues

---
 document/todo/directions/d1-environment.md | 266 +++++----------------
 document/todo/directions/d2-tools.md       | 258 +++++---------------
 document/todo/directions/d3-examples.md    | 139 +++--------
 document/todo/directions/d4-ecosystem.md   | 260 ++++++--------------
 document/todo/roadmap.md                   |  96 ++++----
 document/todo/todo.md                      |  87 ++++---
 6 files changed, 337 insertions(+), 769 deletions(-)

diff --git a/document/todo/directions/d1-environment.md b/document/todo/directions/d1-environment.md
index aa3d1c50..87cae227 100644
--- a/document/todo/directions/d1-environment.md
+++ b/document/todo/directions/d1-environment.md
@@ -1,5 +1,8 @@
 # 方向 D1：环境完善
 
+> **最后更新**：2026-05-21
+> **任务数量**：25项 (6工具 + 19文档)
+
 ---
 
 ## 📋 为什么重要
@@ -12,238 +15,86 @@
 - 减少环境配置问题
 - 提升开发效率
 
-当开发者能够快速搭建好环境并开始工作时，他们更容易继续深入学习和贡献。
-
----
-
-## 💡 如何开始
-
-根据你的需求和情况选择任务：
-
-**如果你是新用户，想要快速开始：**
-1. 从 **D1-004** (env-init.sh) 开始 - 一键配置本地环境
-2. 然后尝试 **D1-001** (Dockerfile) - 容器化开发环境
-
-**如果你是 VS Code 用户：**
-1. 优先完成 **D1-001** (Dockerfile)
-2. 然后做 **D1-003** (Devcontainer) - 获得最佳体验
-
-**如果你需要频繁烧录系统：**
-1. 先完成 **D1-004** (env-init.sh)
-2. 然后做 **D1-005** (flash.sh) - 安全烧录脚本
-
-**如果你想要多板卡支持：**
-1. 可以选择 **D1-006** (板卡配置重构) - 可选任务
-
----
-
-## 🎯 核心目标
-
-- 提供开箱即用的开发环境
-- 容器化构建系统
-- 完善辅助工具链
-- 更新文档体系
-
-::: info 当前状态
-项目已经具备 Dockerfile、国内镜像版本、`env-init.sh` 和基础文档。D1 后续重点不是从零开始，而是补齐 Devcontainer、Compose/TFTP/NFS 辅助服务、安全烧录脚本和板卡配置抽象。
-:::
-
----
-
-## 📝 任务清单
-
-### 任务 D1-001：创建 Dockerfile
-
-**优先级**：P0
-**推荐基础**：无
-
-**为什么重要**：Docker 环境可以确保所有开发者使用完全一致的工具链和依赖，避免"在我机器上能跑"的问题。
-
-**适合场景**：希望快速搭建一致的开发环境，或在 CI/CD 中使用。
-
-**详细要求**：
-创建完整的 Docker 构建环境，预装所有必需的工具和依赖。
-
-- 基于 Ubuntu 24.04 官方镜像
-- 安装 ARM 交叉编译工具链（15.2.rel1）
-- 安装所有构建依赖（build-essential, device-tree-compiler, etc.）
-- 优化镜像大小（使用多阶段构建）
-- 支持非 root 用户运行
-- 提供便捷的 ENTRYPOINT
-
-**验收标准**：
-- [ ] 镜像大小 < 2GB
-- [ ] 可以成功编译 U-Boot
-- [ ] 可以成功编译 Linux 内核
-- [ ] 可以成功编译 BusyBox
-- [ ] 提供使用文档
-
-**相关文件**：
-- `docker/Dockerfile`
-- `docker/README.md`
-
 ---
 
-### 任务 D1-002：创建 docker-compose.yml
-
-**优先级**：P1
-**推荐基础**：D1-001
-
-**为什么重要**：Docker Compose 可以简化 Docker 使用，让开发者一键启动完整的开发环境（包括 TFTP、NFS 等辅助服务）。
-
-**适合场景**：需要频繁使用网络启动（TFTP/NFS）的开发者。
-
-**详细要求**：
-编写 Docker Compose 配置文件，简化 Docker 使用。
-
-- 配置构建容器服务
-- 可选：配置 TFTP 服务器
-- 可选：配置 NFS 服务器
-- 支持卷挂载（源代码目录）
-- 支持环境变量配置
-- 提供一键启动脚本
-
-**验收标准**：
-- [ ] `docker-compose up` 可以启动开发环境
-- [ ] 可以在容器中执行构建
-- [ ] 可以访问 TFTP/NFS 服务（如果配置）
-- [ ] 提供使用文档
+## 📊 优先级概览
 
-**相关文件**：
-- `docker-compose.yml`
-- `docker/README.md`
+| 优先级 | 工具任务 | 文档任务 | 总计 |
+|--------|----------|----------|------|
+| P0 | 2项 ✅ | 19项 | 21 |
+| P1 | 3项 | - | 3 |
+| P2 | 1项 | - | 1 |
+| **总计** | **6** | **19** | **25** |
 
 ---
 
-### 任务 D1-003：创建 Devcontainer 配置
+## 📋 P0: 主线闭环 (21项)
 
-**优先级**：P1
-**推荐基础**：D1-001
+> 新用户能够从零到第一次成功启动的完整路径
 
-**为什么重要**：VS Code Devcontainer 提供最佳的开发体验，一键打开即可获得完整环境，无需手动配置。
+### 工具任务 (2项)
 
-**适合场景**：使用 VS Code 作为主要编辑器的开发者。
-
-**详细要求**：
-为 VS Code 用户提供完整的开发容器配置。
-
-- 创建 `.devcontainer/devcontainer.json`
-- 配置 VS Code 扩展推荐
-- 配置开发环境变量
-- 支持端口转发（TFTP/NFS）
-- 提供使用文档
-
-**验收标准**：
-- [ ] VS Code 可以自动识别 Devcontainer
-- [ ] 一键打开容器
-- [ ] 预装推荐的 VS Code 扩展
-- [ ] 提供使用文档
-
-**相关文件**：
-- `.devcontainer/devcontainer.json`
-- `.devcontainer/devcontainer-compose.yml`（可选）
-
----
+| 任务 | 状态 | 说明 |
+|------|------|------|
+| D1-001: Dockerfile | ✅ | 容器化开发环境 |
+| D1-004: env-init.sh | ✅ | 本地环境配置脚本 |
 
-### 任务 D1-004：创建 env-init.sh
+### 文档任务 (19项)
 
-**优先级**：P0
-**推荐基础**：无
+#### P0-0: 系统工程主线闭环 (10项)
 
-**为什么重要**：对于不使用 Docker 的开发者，env-init.sh 可以自动检查和配置本地环境，大幅降低环境配置的难度。
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] Board bring-up quick start / 板子上手与硬件速查 | `document/tutorial/start/` |
+| [ ] First boot and serial console checklist / 第一次上电与串口检查流程 | `document/tutorial/start/` |
+| [ ] Boot mode and storage selection guide / 启动介质选择说明 | `document/tutorial/start/` |
+| [ ] Safe flashing guide / 安全烧录教程 | `document/tutorial/usage/` |
+| [ ] **Full build workflow from a clean clone** / 从空仓库到完整构建的主线教程 | `document/tutorial/build/` |
+| [ ] **`out/` directory explanation** / `out/` 目录结构说明 | `document/tutorial/build/` |
+| [ ] BSP default build workflow / BSP 默认构建链路说明 | `document/tutorial/build/` |
+| [ ] Mainline build verification workflow / mainline 构建验证链路说明 | `document/tutorial/build/` |
+| [ ] Patch workflow guide / patch 工作流实战说明 | `document/tutorial/build/` |
+| [ ] Common build failure troubleshooting / 常见构建失败排查说明 | `document/tutorial/troubleshooting/` |
 
-**适合场景**：希望在本地（特别是 WSL2）直接开发的用户。
+#### P0-1: Rootfs 与用户空间 (9项)
 
-**详细要求**：
-编写一键环境配置脚本，自动检查依赖、设置环境变量、验证工具链。
-
-- 检测操作系统版本
-- 验证所有必需的依赖包
-- 自动设置 PATH 环境变量
-- 验证交叉编译工具链
-- 生成环境配置报告
-- 支持 WSL2 特殊配置
-- 提供修复建议
-
-**验收标准**：
-- [x] 可以检测缺失的依赖
-- [x] 可以自动设置环境变量
-- [x] 可以验证工具链版本
-- [x] 输出清晰的环境报告
-- [x] 支持 WSL2
-- [x] 提供使用文档
-
-**相关文件**：
-- `scripts/init/env-init.sh` ✅ 已完成
-- `document/tutorial/start/02_env_init_guide.md` ✅ 已完成
-
-**状态**：✅ **已完成** (2026-04-07)
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] BusyBox Rootfs extension guide / BusyBox Rootfs 扩展教程 | `document/tutorial/rootfs/` |
+| [ ] init process explanation / init 流程说明 | `document/tutorial/rootfs/` |
+| [ ] mdev, fstab, network and startup scripts / mdev、fstab、网络配置与启动脚本说明 | `document/tutorial/rootfs/` |
+| [ ] rootfs overlay guide / rootfs overlay 使用教程 | `document/tutorial/rootfs/` |
+| [ ] Kernel module deployment guide / 内核模块部署教程 | `document/tutorial/rootfs/` |
+| [ ] Auto-loading kernel modules at boot / 内核模块开机加载说明 | `document/tutorial/rootfs/` |
+| [ ] Firmware and third-party library deployment / 固件与第三方库部署说明 | `document/tutorial/rootfs/` |
+| [ ] NFS-based development workflow / NFS 开发流说明 | `document/tutorial/rootfs/` |
+| [ ] Rootfs mount failure troubleshooting / Rootfs 挂载失败排查 | `document/tutorial/debug/` |
 
 ---
 
-### 任务 D1-005：创建 flash.sh
-
-**优先级**：P1
-**推荐基础**：D1-004
-
-**为什么重要**：统一的烧录脚本可以避免手动操作的错误，提供安全的确认机制，防止误删除重要数据。
+## 📋 P1: 重要功能 (3项)
 
-**适合场景**：需要频繁烧录 SD 卡或 eMMC 的开发者。
+> 提升开发体验的关键工具
 
-**详细要求**：
-编写统一的 SD 卡/eMMC 烧录脚本，支持自动分区、格式化、文件复制。
+### 工具任务 (3项)
 
-- 自动检测存储设备
-- 安全确认机制（防止误操作）
-- 自动分区和格式化
-- 复制 U-Boot、内核、DTB、Rootfs
-- 支持 eMMC 和 SD 卡
-- 提供进度显示
-- 完整的错误处理
-
-**验收标准**：
-- [ ] 可以安全烧录 SD 卡
-- [ ] 可以安全烧录 eMMC
-- [ ] 有完善的安全检查
-- [ ] 提供进度显示
-- [ ] 错误处理完善
-- [ ] 提供使用文档
-
-**相关文件**：
-- `scripts/flash.sh`
-- `document/tutorial/usage/01_flash_guide.md`（新增）
+| 任务 | 优先级 | 推荐基础 | 说明 |
+|------|--------|----------|------|
+| D1-002: docker-compose.yml | P1 | D1-001 | 含 TFTP/NFS 辅助服务 |
+| D1-003: Devcontainer 配置 | P1 | D1-001 | VS Code 一键开发环境 |
+| D1-005: flash.sh | P1 | D1-004 | 安全烧录脚本 |
 
 ---
 
-### 任务 D1-006：板卡配置重构（可选）
-
-**优先级**：P2
-**推荐基础**：无
-
-**为什么重要**：统一的板卡配置结构可以简化多板卡支持，让新板卡的接入更加规范和简单。
-
-**适合场景**：需要支持多个板卡，或希望为项目添加新板卡支持的开发者。
-
-**详细要求**：
-将板卡配置迁移到新的 `boards/` 目录结构，简化多板卡支持。
+## 📋 P2: 优化体验 (1项)
 
-- 创建 `boards/` 目录
-- 创建 `boards/alpha-board/board.conf`
-- 创建 `boards/alpha-board/linux/` 和 `boards/alpha-board/uboot/`
-- 创建 `scripts/select-board.sh`
-- 更新构建脚本支持板卡配置
+> 可选的增强功能
 
-**验收标准**：
-- [ ] 新的目录结构创建完成
-- [ ] 板卡配置文件创建完成
-- [ ] 可以切换板卡
-- [ ] 构建脚本支持新配置
-- [ ] 提供迁移文档
+### 工具任务 (1项)
 
-**相关文件**：
-- `boards/alpha-board/board.conf`
-- `scripts/select-board.sh`
-- `document/todo/board_migration.md`（新增）
+| 任务 | 优先级 | 推荐基础 | 说明 |
+|------|--------|----------|------|
+| D1-006: 板卡配置重构 | P2 | - | 多板卡支持框架 |
 
 ---
 
@@ -257,7 +108,8 @@
 ## 🔗 相关资源
 
 - **主路线图**：[roadmap.md](../roadmap.md)
-- **快速开始**：QUICK_START.md
+- **快速开始**：[../../QUICK_START.md](../../QUICK_START.md)
+- **GitHub Issue #47**: [路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
 
 ---
 
diff --git a/document/todo/directions/d2-tools.md b/document/todo/directions/d2-tools.md
index 6fbbf84a..62e17689 100644
--- a/document/todo/directions/d2-tools.md
+++ b/document/todo/directions/d2-tools.md
@@ -1,5 +1,8 @@
 # 方向 D2：工具完备
 
+> **最后更新**：2026-05-21
+> **任务数量**：23项 (6工具 + 17文档)
+
 ---
 
 ## 📋 为什么重要
@@ -12,224 +15,86 @@
 - 完善文档体系
 - 支持多板卡扩展
 
-好的工具可以大幅减少重复性工作，让开发者专注于核心功能开发。
-
----
-
-## 💡 如何开始
-
-根据你的需求选择任务：
-
-**如果你想提升日常开发效率：**
-1. **D2-001** (menuconfig.sh) - 统一的配置入口
-2. **D2-002** (clean.sh) - 智能清理工具
-
-**如果你需要支持多个板卡：**
-1. **D2-003** (select-board.sh) - 方便切换板卡
-2. **D2-004** (板卡接入文档) - 了解如何添加新板卡
-
-**如果你关注代码质量：**
-1. **D2-005** (CI - Patch 校验) - 确保补丁格式正确
-2. **D2-006** (CI - Docker 构建) - 自动化测试
-
-**推荐的开始顺序：**
-- 先做 D2-001 和 D2-002（日常使用最频繁）
-- 再做 D2-003 和 D2-004（如果需要多板卡支持）
-- 最后做 D2-005 和 D2-006（建立 CI/CD 基础）
-
 ---
 
-## 🎯 核心目标
-
-- 完整的辅助脚本集
-- CI/CD 基础建立
-- 板卡接入规范
-- 多板卡支持框架
+## 📊 优先级概览
 
-::: info 当前状态
-项目已经具备分层 CI、组件构建、Full Build、Release Build 和 Docker Publish 工作流。D2 后续重点是补齐日常开发工具、补丁校验细化、板卡接入规范，以及把现有 CI 与项目阶段验收绑定起来。
-:::
+| 优先级 | 工具任务 | 文档任务 | 总计 |
+|--------|----------|----------|------|
+| P0 | - | - | - |
+| P1 | 3项 | 17项 | 20 |
+| P2 | 3项 | - | 3 |
+| **总计** | **6** | **17** | **23** |
 
 ---
 
-## 📝 任务清单
+## 📋 P1: 重要功能 (20项)
 
-### 任务 D2-001：创建 menuconfig.sh
+> 提升开发效率和调试能力的关键功能
 
-**优先级**：P2
-**推荐基础**：D1-004
+### 工具任务 (3项)
 
-**为什么重要**：统一的 menuconfig 入口可以简化内核配置流程，避免手动设置环境变量。
+| 任务 | 推荐基础 | 说明 |
+|------|----------|------|
+| D2-003: select-board.sh | D1-006 | 板卡切换脚本 |
+| D2-004: 板卡接入文档 | D1-006 | 多板卡接入规范 |
+| D2-005: CI - Patch 校验 | - | 自动补丁格式检查 |
 
-**适合场景**：需要频繁修改 U-Boot、Linux 或 BusyBox 配置的开发者。
+### 文档任务 (17项)
 
-**详细要求**：
-提供统一的内核配置入口，支持 U-Boot、Linux 内核、BusyBox 的 menuconfig。
+#### P1-1: 系统调试手册 (10项)
 
-- 支持选择配置目标（U-Boot/Linux/BusyBox）
-- 自动设置交叉编译环境
-- 支持保存和恢复配置
-- 提供配置指导
-- 集成到构建流程
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] U-Boot common issues / U-Boot 常见问题排查 | `document/tutorial/debug/` |
+| [ ] Serial console no-output troubleshooting / 串口无输出排查 | `document/tutorial/debug/` |
+| [ ] Network boot troubleshooting / 网络启动问题排查 | `document/tutorial/debug/` |
+| [ ] Kernel panic common issues / Kernel panic 常见问题排查 | `document/tutorial/debug/` |
+| [ ] DTB mismatch troubleshooting / DTB 不匹配问题排查 | `document/tutorial/debug/` |
+| [ ] Rootfs and init failure troubleshooting / Rootfs 与 init 失败排查 | `document/tutorial/debug/` |
+| [ ] NFS / TFTP troubleshooting / NFS / TFTP 常见问题排查 | `document/tutorial/debug/` |
+| [ ] Kernel module loading failure troubleshooting / 模块加载失败排查 | `document/tutorial/debug/` |
+| [ ] Serial log reading guide / 串口日志阅读指南 | `document/tutorial/debug/` |
+| [ ] How to submit useful debug logs / 如何提交有效的问题日志 | `document/tutorial/debug/` |
 
-**验收标准**：
-- [ ] 可以方便地启动 menuconfig
-- [ ] 自动设置环境变量
-- [ ] 支持所有组件
-- [ ] 提供使用文档
+#### P1-2: 交叉调试与诊断 (7项)
 
-**相关文件**：
-- `scripts/menuconfig.sh`
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] gdbserver deployment guide / gdbserver 板端部署说明 | `document/tutorial/debug/` |
+| [ ] VSCode + GDB cross-debugging setup / VSCode + GDB 交叉调试配置 | `document/tutorial/workflow/` |
+| [ ] Debugging shared libraries / 共享库调试说明 | `document/tutorial/debug/` |
+| [ ] `strace` basic usage / `strace` 基础使用 | `document/tutorial/tools/` |
+| [ ] Core dump debugging workflow / core dump 调试流程 | `document/tutorial/debug/` |
+| [ ] Basic logging workflow / 基础日志收集流程 | `document/tutorial/debug/` |
+| [ ] Basic performance inspection tools / 基础性能分析工具说明 | `document/tutorial/tools/` |
 
 ---
 
-### 任务 D2-002：创建 clean.sh
-
-**优先级**：P2
-**推荐基础**：无
-
-**为什么重要**：智能清理脚本可以帮助开发者快速释放磁盘空间，同时保留重要的配置文件。
-
-**适合场景**：磁盘空间有限，或需要频繁清理构建产物的开发者。
-
-**详细要求**：
-编写智能清理脚本，支持选择性清理构建产物、临时文件、子模块。
-
-- 支持分类清理（内核/U-Boot/Rootfs/全部）
-- 保留配置文件
-- 显示清理前后的空间变化
-- 安全确认机制
-- 支持 dry-run 模式
-
-**验收标准**：
-- [ ] 可以选择性清理
-- [ ] 显示空间变化
-- [ ] 有安全确认
-- [ ] 支持 dry-run
-- [ ] 提供使用文档
-
-**相关文件**：
-- `scripts/clean.sh`
-
----
-
-### 任务 D2-003：创建 select-board.sh
-
-**优先级**：P1
-**推荐基础**：D1-006（如果完成）
-
-**为什么重要**：板卡切换脚本让多板卡开发变得简单，避免手动修改配置文件。
-
-**适合场景**：需要在不同板卡之间切换的开发者，或为项目添加新板卡支持。
-
-**详细要求**：
-创建板卡切换脚本，方便用户在不同板卡配置之间切换。
-
-- 列出所有可用板卡
-- 显示当前板卡
-- 支持交互式选择
-- 自动更新构建配置
-- 提供板卡信息查看
-
-**验收标准**：
-- [ ] 可以列出所有板卡
-- [ ] 可以切换板卡
-- [ ] 显示当前板卡
-- [ ] 自动更新配置
-- [ ] 提供使用文档
-
-**相关文件**：
-- `scripts/select-board.sh`
-
----
-
-### 任务 D2-004：编写板卡接入文档
-
-**优先级**：P1
-**推荐基础**：D1-006（如果完成）
-
-**为什么重要**：详细的板卡接入文档可以让其他开发者轻松为项目添加新板卡支持，扩大项目影响力。
-
-**适合场景**：希望为自己的板卡添加支持，或了解板卡移植流程的开发者。
-
-**详细要求**：
-创建详细的板卡接入指南，说明如何为新板卡添加支持。
-
-- 说明设备树移植流程
-- 说明驱动适配流程
-- 提供检查清单
-- 包含实际案例
-- 说明配置文件填写要求
-
-**验收标准**：
-- [ ] 文档完整清晰
-- [ ] 包含具体步骤
-- [ ] 有检查清单
-- [ ] 有实际案例
-- [ ] 有故障排除指南
-
-**相关文件**：
-- `docs/04-板卡接入规范.md`
-
----
-
-### 任务 D2-005：配置 GitHub Actions - Patch 校验
-
-**优先级**：P1
-**推荐基础**：无
-
-**为什么重要**：自动化的补丁校验可以确保 PR 的质量，减少维护者的审查负担。
-
-**适合场景**：项目接受社区 PR，或希望确保代码质量的团队。
-
-**详细要求**：
-创建 CI 工作流，自动验证补丁能够正确应用。
-
-- 创建 `.github/workflows/patch-check.yml`
-- 自动检测补丁格式
-- 尝试应用所有补丁
-- 检查补丁冲突
-- 生成检查报告
-- 支持手动触发
-
-**验收标准**：
-- [ ] PR 提交时自动运行
-- [ ] 检测补丁格式
-- [ ] 检查补丁冲突
-- [ ] 生成清晰报告
-- [ ] 支持手动触发
-
-**相关文件**：
-- `.github/workflows/patch-check.yml`
-
----
-
-### 任务 D2-006：配置 GitHub Actions - Docker 构建
-
-**优先级**：P2
-**推荐基础**：D1-001
-
-**为什么重要**：自动构建 Docker 镜像可以确保镜像始终可用，并提前发现构建问题。
+## 📋 P2: 优化体验 (3项)
 
-**适合场景**：使用 Docker 作为开发环境，或希望自动化测试的开发者。
+> 提升开发效率的高级功能
 
-**详细要求**：
-自动构建 Docker 镜像并测试构建流程。
+### 工具任务 (3项)
 
-- 创建 `.github/workflows/docker-build.yml`
-- 自动构建 Docker 镜像
-- 测试基本构建流程
-- 发布到 Docker Hub（可选）
-- 定期更新基础镜像
+| 任务 | 推荐基础 | 说明 |
+|------|----------|------|
+| D2-001: menuconfig.sh | D1-004 | 统一配置入口 |
+| D2-002: clean.sh | - | 智能清理工具 |
+| D2-006: CI - Docker 构建 | D1-001 | 自动镜像构建 |
 
-**验收标准**：
-- [ ] 代码提交时自动构建
-- [ ] 测试构建流程
-- [ ] 生成构建报告
-- [ ] （可选）发布镜像
+### 文档任务 (P2-0: 开发工作流与工具链) - 8项
 
-**相关文件**：
-- `.github/workflows/docker-build.yml`
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] VSCode development workflow / VSCode 开发工作流说明 | `document/tutorial/workflow/` |
+| [ ] WSL2 development notes / WSL2 开发注意事项 | `document/tutorial/workflow/` |
+| [ ] Docker development workflow / Docker 开发环境说明 | `document/tutorial/workflow/` |
+| [ ] Remote-SSH workflow / Remote-SSH 工作流说明 | `document/tutorial/workflow/` |
+| [ ] clangd cross-compilation configuration / clangd 交叉编译配置说明 | `document/tutorial/workflow/` |
+| [ ] tasks.json command templates / tasks.json 常用任务模板 | `document/tutorial/workflow/` |
+| [ ] Host and board file synchronization workflow / 主机与板端文件同步流程 | `document/tutorial/workflow/` |
+| [ ] Git workflow for third-party source patches / 第三方源码 patch 的 Git 工作流 | `document/tutorial/workflow/` |
 
 ---
 
@@ -244,6 +109,7 @@
 
 - **主路线图**：[roadmap.md](../roadmap.md)
 - **D1 详情**：[d1-environment.md](./d1-environment.md)
+- **GitHub Issue #47**: [路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
 
 ---
 
diff --git a/document/todo/directions/d3-examples.md b/document/todo/directions/d3-examples.md
index 1e15176c..f20632f4 100644
--- a/document/todo/directions/d3-examples.md
+++ b/document/todo/directions/d3-examples.md
@@ -1,5 +1,8 @@
 # 方向 D3：示例展示
 
+> **最后更新**：2026-05-21
+> **任务数量**：11项 (3工具 + 8文档)
+
 ---
 
 ## 📋 为什么重要
@@ -12,67 +15,55 @@
 - 建立项目影响力
 - 吸引用户和贡献者
 
-示例项目是项目的"门面"，决定了第一印象和传播效果。
-
 ---
 
-## 💡 如何开始
+## 📊 优先级概览
 
-根据你的兴趣和技能选择任务：
+| 优先级 | 工具任务 | 文档任务 | 总计 |
+|--------|----------|----------|------|
+| P1 | 3项 | 8项 | 11 |
+| **总计** | **3** | **8** | **11** |
 
-**如果你对 Qt GUI 开发感兴趣：**
-1. **D3-001** (QT6 完整应用示例) - 学习 Qt 和触摸屏开发
-2. 然后选择旗舰项目继续深入
+---
 
-**如果你对 IoT 和传感器感兴趣：**
-1. 先做 **D3-001** (QT6 基础)
-2. 然后做 **D3-002** (PROJ-001 环境监测站) - 完整的 IoT 系统
+## 📋 P1: 重要功能 (11项)
 
-**如果你对图像处理感兴趣：**
-1. 先做 **D3-001** (QT6 基础)
-2. 然后做 **D3-003** (PROJ-002 图像分析仪) - OpenCV + V4L2
+> 展示项目能力，建立项目影响力
 
-**如果你想快速展示项目效果：**
-1. **D3-002** 或 **D3-003** 选择一个旗舰项目
-2. 专注于完整性和可展示性
+### 工具任务 (3项)
 
-**推荐的开始顺序：**
-- 必须先完成 D3-001（Qt 基础示例）
-- 然后根据兴趣选择 D3-002 或 D3-003（二选一即可）
-- 如果有时间和精力，可以完成另一个旗舰项目
+| 任务 | 推荐基础 | 说明 |
+|------|----------|------|
+| D3-001: QT6 完整应用示例 | - | QT6 + GT911 触摸屏 |
+| D3-002: PROJ-001 环境监测站 | D3-001 | IoT + MQTT + 云端 |
+| D3-003: PROJ-002 图像分析仪 | D3-001 | OpenCV + V4L2 |
 
----
+### 文档任务 (8项)
 
-## 🎯 核心目标
+#### P1-0: 应用开发与部署 (8项)
 
-- QT6 完整应用示例
-- 至少一个旗舰级项目
-- 完整的教程和演示
-- 展示项目价值
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] C / CMake cross-compilation tutorial / C/CMake 交叉编译应用教程 | `document/tutorial/app/` |
+| [ ] Minimal Qt application deployment / Qt 最小应用部署教程 | `document/tutorial/app/` |
+| [ ] Qt touchscreen configuration / Qt 触摸屏配置说明 | `document/tutorial/app/` |
+| [ ] Qt font and input device configuration / Qt 字体与输入设备配置说明 | `document/tutorial/app/` |
+| [ ] Application deployment convention / 应用部署规范说明 | `document/tutorial/app/` |
+| [ ] Deploying applications via rootfs overlay / 通过 rootfs overlay 部署应用 | `document/tutorial/app/` |
+| [ ] Deploying applications via NFS / 通过 NFS 部署应用 | `document/tutorial/app/` |
+| [ ] Board-side application debugging guide / 板端应用调试说明 | `document/tutorial/debug/` |
 
 ---
 
-## 📝 任务清单
+## 🎯 项目详情
 
-### 任务 D3-001：QT6 + GT911 完整应用示例
+### D3-001: QT6 完整应用示例
 
 **优先级**：P1
 **推荐基础**：无
 
 **为什么重要**：这是所有旗舰项目的基础，展示了 Qt6、触摸屏、硬件控制的完整流程。
 
-**适合场景**：所有开发者都应该完成这个任务，作为其他项目的前置。
-
-**详细要求**：
-创建一个完整的 QT6 应用，展示触摸屏、GUI、硬件控制等功能。
-
-- 实现触摸屏校准
-- 实现多页面界面
-- 集成硬件控制示例（LED、传感器等）
-- 提供构建脚本
-- 编写详细教程
-- （可选）演示视频
-
 **验收标准**：
 - [ ] 代码结构清晰
 - [ ] 触摸屏响应流畅
@@ -81,40 +72,16 @@
 - [ ] 有完整文档
 - [ ] 可在开发板上运行
 
-**相关文件**：
-- `examples/qt/complete_demo/`
-- `document/tutorial/qt/README.md`
+**相关文件**：`examples/qt/complete_demo/`
 
 ---
 
-### 任务 D3-002：PROJ-001 - 便携式环境监测站
+### D3-002: PROJ-001 环境监测站
 
 **优先级**：P1
 **推荐基础**：D3-001
 
-**为什么重要**：完整的 IoT 系统，展示了从驱动到云端的全栈能力，非常适合展会展示。
-
-**适合场景**：对 IoT、传感器、云端通信感兴趣的开发者。
-
-**核心亮点**：
-- 驱动 + 可视化 + 云端联动
-- 完整产品闭环
-- 展会常驻运行极具说服力
-
-**技术栈**：
-- C + Qt Widgets + QCustomPlot
-- 自研驱动（IIC/SPI）
-- MQTT + 4G
-- Web 看板
-
-**详细要求**：
-完整的 IoT 系统，包含传感器驱动、Qt 界面、MQTT 云端通信。
-
-- 传感器驱动开发（温湿度、气压、陀螺仪、光照）
-- Qt 实时数据界面
-- MQTT 云端通信
-- Web 看板展示
-- 完整教程文档
+**技术栈**：C + Qt + MQTT + 驱动
 
 **验收标准**：
 - [ ] 所有传感器正常工作
@@ -122,41 +89,17 @@
 - [ ] 云端通信正常
 - [ ] Web 看板可用
 - [ ] 有完整教程
-- [ ] 适合展会展示
 
-**相关文件**：
-- `examples/project/proj-001-env-monitor/`
-- `document/todo/projects/proj-001-env-monitor.md`
+**相关文件**：`examples/project/proj-001-env-monitor/`
 
 ---
 
-### 任务 D3-003：PROJ-002 - 嵌入式图像采集与分析仪
+### D3-003: PROJ-002 图像分析仪
 
 **优先级**：P1
 **推荐基础**：D3-001
 
-**为什么重要**：展示了图像处理能力，技术含量高，适合简历展示。
-
-**适合场景**：对计算机视觉、图像处理感兴趣的开发者。
-
-**核心亮点**：
-- 摄像头静态拍照 + OpenCV 离线分析
-- 规避视频流，深挖图像处理能力
-- 现场对准物体拍照，屏幕立刻显示分析结果
-
-**技术栈**：
-- C++ + Qt Widgets + OpenCV
-- V4L2 + ZBar
-- libcurl
-
-**详细要求**：
-基于 V4L2 和 OpenCV 的图像处理系统。
-
-- V4L2 摄像头驱动集成
-- 图像处理算法实现
-- Qt 分析界面
-- 存储和网络功能
-- 完整教程
+**技术栈**：C++ + Qt + OpenCV + V4L2
 
 **验收标准**：
 - [ ] 摄像头正常工作
@@ -164,11 +107,8 @@
 - [ ] 界面友好
 - [ ] 可以保存结果
 - [ ] 有完整教程
-- [ ] 适合展会展示
 
-**相关文件**：
-- `examples/project/proj-002-image-analyzer/`
-- `document/todo/projects/proj-002-image-analyzer.md`
+**相关文件**：`examples/project/proj-002-image-analyzer/`
 
 ---
 
@@ -194,10 +134,9 @@
 ## 🔗 相关资源
 
 - **主路线图**：[roadmap.md](../roadmap.md)
-- **D1 详情**：[d1-environment.md](./d1-environment.md)
-- **D2 详情**：[d2-tools.md](./d2-tools.md)
 - **PROJ-001 详情**：[projects/proj-001-env-monitor.md](../projects/proj-001-env-monitor.md)
 - **PROJ-002 详情**：[projects/proj-002-image-analyzer.md](../projects/proj-002-image-analyzer.md)
+- **GitHub Issue #47**: [路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
 
 ---
 
diff --git a/document/todo/directions/d4-ecosystem.md b/document/todo/directions/d4-ecosystem.md
index b3ea8cdd..15aab5bb 100644
--- a/document/todo/directions/d4-ecosystem.md
+++ b/document/todo/directions/d4-ecosystem.md
@@ -1,5 +1,8 @@
 # 方向 D4：生态成熟
 
+> **最后更新**：2026-05-21
+> **任务数量**：18项 (7工具 + 11文档)
+
 ---
 
 ## 📋 为什么重要
@@ -12,70 +15,83 @@
 - 展示项目的多样性
 - 建立活跃的社区
 
-一个成熟的项目生态可以吸引更多贡献者，形成良性循环。
-
 ---
 
-## 💡 如何开始
+## 📊 优先级概览
 
-根据你的兴趣和专长选择任务：
+| 优先级 | 工具任务 | 文档任务 | 总计 |
+|--------|----------|----------|------|
+| P2 | 4项 | - | 4 |
+| P3 | 3项 | 11项 | 14 |
+| **总计** | **7** | **11** | **18** |
 
-**如果你对系统构建感兴趣：**
-1. **D4-001** (Buildroot Rootfs) - 学习嵌入式 Linux 系统构建
-2. **D4-002** (Debian Rootfs) - 提供完整的包管理体验
-
-**如果你关注 DevOps 和 CI/CD：**
-1. **D4-003** (完善 CI/CD) - 建立完整的质量保障体系
+---
 
-**如果你对网络和底层技术感兴趣：**
-1. 先完成 **D3-001** (Qt 基础)
-2. 然后做 **D4-004** (PROJ-003 协议分析仪) - 硬核网络技术
+## 📋 P2: 优化体验 (4项)
 
-**如果你想做有趣的项目：**
-1. 先完成 **D3-001** (Qt 基础)
-2. 然后做 **D4-005** (PROJ-004 游戏模拟器) - 娱乐性强
+> 高级系统功能和精品项目
 
-**如果你想做更多项目：**
-1. **D4-006** (PROJ-005/006) - 其他精品项目
-2. **D4-007** (PROJ-007~010) - 快速项目
+### 工具任务 (4项)
 
-**推荐的开始顺序：**
-- 如果你想深入学习系统构建：先做 D4-001 和 D4-002
-- 如果你想提高项目质量：做 D4-003
-- 如果你想展示技术实力：选择一个旗舰项目（D4-004 或 D4-005）
-- 如果你想丰富项目示例：做快速项目（D4-007）
+| 任务 | 推荐基础 | 说明 |
+|------|----------|------|
+| D4-001: Buildroot Rootfs | - | 轻量级 Rootfs 方案 |
+| D4-003: CI/CD 完善 | D2-005, D2-006 | 自动化测试和发布 |
+| D4-004: PROJ-003 协议分析仪 | D3-001 | libpcap 网络抓包 |
+| D4-005: PROJ-004 游戏模拟器 | D3-001 | 模拟器移植 + 体感 |
 
 ---
 
-## 🎯 核心目标
-
-- 多种 Rootfs 方案
-- 完整的 CI/CD
-- 多个精品项目
-- 活跃的社区
+## 📋 P3: 可选补充 (14项)
+
+> 参考资源和更多项目
+
+### 工具任务 (3项)
+
+| 任务 | 推荐基础 | 说明 |
+|------|----------|------|
+| D4-002: Debian Rootfs | D4-001 | 完整包管理支持 |
+| D4-006: PROJ-005/006 | D3-001 | 其他精品项目 |
+| D4-007: PROJ-007~010 | D3-001 | 快速项目 |
+
+### 文档任务 (11项)
+
+#### P3-0: 参考资源索引 (11项)
+
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] NXP official documentation index / NXP 官方文档索引 | `document/reference/` |
+| [ ] i.MX6ULL reference manual links / i.MX6ULL 手册链接 | `document/reference/` |
+| [ ] NXP Linux BSP links / NXP Linux BSP 链接 | `document/reference/` |
+| [ ] U-Boot documentation links / U-Boot 文档索引 | `document/reference/` |
+| [ ] Linux Kernel Documentation links / Linux Kernel Documentation 索引 | `document/reference/` |
+| [ ] Device Tree documentation links / 设备树文档索引 | `document/reference/` |
+| [ ] Buildroot documentation links / Buildroot 文档索引 | `document/reference/` |
+| [ ] Yocto documentation links / Yocto 文档索引 | `document/reference/` |
+| [ ] Qt documentation links / Qt 文档索引 | `document/reference/` |
+| [ ] ARM GCC toolchain links / ARM GCC 工具链文档索引 | `document/reference/` |
+| [ ] Community and forum links / 社区与论坛索引 | `document/reference/` |
+
+#### P3-2: 版本号与发布策略 (8项)
+
+| 任务 | 相关文件 |
+|------|----------|
+| [ ] Release versioning policy / release 版本号策略 | `document/release/` |
+| [ ] Distinguish roadmap numbers from release tags / 区分路线图编号与正式 release tag | `document/release/` |
+| [ ] Docker tag policy / Docker tag 策略 | `document/release/` |
+| [ ] `preview` image policy / `preview` 镜像策略 | `document/release/` |
+| [ ] `latest` image policy / `latest` 镜像策略 | `document/release/` |
+| [ ] `vX.Y.Z` image policy / `vX.Y.Z` 镜像策略 | `document/release/` |
+| [ ] GitHub Release checklist / GitHub Release 检查清单 | `document/release/` |
+| [ ] CI artifact explanation / CI artifact 定位说明 | `document/ci/` |
 
 ---
 
-## 📝 任务清单
+## 🎯 项目详情
 
-### 任务 D4-001：Buildroot Rootfs 支持
+### D4-001: Buildroot Rootfs
 
 **优先级**：P2
-**推荐基础**：无
-
-**为什么重要**：Buildroot 是嵌入式 Linux 的标准构建系统，提供高度定制的轻量级 Rootfs。
-
-**适合场景**：需要定制化、小型化的嵌入式系统。
-
-**详细要求**：
-集成 Buildroot 构建系统，提供更完整的 Rootfs 方案。
-
-- 创建 Buildroot 配置
-- 添加 IMX6ULL defconfig
-- 集成常用包选择
-- 提供构建脚本
-- 文档说明配置方法
-- 测试基本功能
 
 **验收标准**：
 - [ ] 可以成功构建
@@ -84,63 +100,15 @@
 - [ ] 有构建脚本
 - [ ] 在开发板上运行正常
 
-**相关文件**：
-- `rootfs/buildroot/`
-- `scripts/build_helper/build-buildroot.sh`
+**相关文件**：`rootfs/buildroot/`
 
 ---
 
-### 任务 D4-002：Debian Rootfs 支持
-
-**优先级**：P3
-**推荐基础**：D4-001
-
-**为什么重要**：Debian 提供完整的包管理系统，适合需要大量软件包的场景。
-
-**适合场景**：需要丰富的软件包，或习惯 Debian/Ubuntu 的开发者。
-
-**详细要求**：
-提供基于 Debian 的 Rootfs，支持 apt 包管理。
-
-- 使用 debootstrap 创建基础系统
-- 配置 apt 源
-- 优化系统大小
-- 提供构建脚本
-- 文档说明使用方法
-- 测试包安装功能
-
-**验收标准**：
-- [ ] 可以成功构建
-- [ ] apt 包管理可用
-- [ ] 系统大小合理
-- [ ] 有配置文档
-- [ ] 有构建脚本
-- [ ] 在开发板上运行正常
-
-**相关文件**：
-- `rootfs/debian/`
-- `scripts/build_helper/build-debian.sh`
-
----
-
-### 任务 D4-003：完善 CI/CD
+### D4-003: CI/CD 完善
 
 **优先级**：P2
 **推荐基础**：D2-005, D2-006
 
-**为什么重要**：完整的 CI/CD 可以确保代码质量，自动化测试和发布流程。
-
-**适合场景**：希望提高项目质量和开发效率的团队。
-
-**详细要求**：
-完善 CI/CD 系统，实现自动化测试、构建和发布。
-
-- 扩展 Patch 校验 CI
-- 扩展 Docker 构建 CI
-- 添加集成测试
-- 添加自动发布（可选）
-- 定期更新依赖
-
 **验收标准**：
 - [ ] CI 自动运行
 - [ ] 测试覆盖主要功能
@@ -148,36 +116,16 @@
 - [ ] （可选）自动发布
 - [ ] 有 CI 文档
 
-**相关文件**：
-- `.github/workflows/*.yml`
+**相关文件**：`.github/workflows/*.yml`
 
 ---
 
-### 任务 D4-004：PROJ-003 - 网络协议分析仪
+### D4-004: PROJ-003 协议分析仪
 
 **优先级**：P2
 **推荐基础**：D3-001
 
-**为什么重要**：展示系统级网络编程能力，技术含量极高，适合简历亮点。
-
-**适合场景**：对网络编程、驱动开发感兴趣的开发者。
-
-**核心亮点**：
-- 纯系统级 + 网络驱动
-- 技术含量极高，适合简历硬核亮点
-
-**技术栈**：
-- C + Qt + libpcap
-- 4G/WiFi 网卡驱动
-
-**详细要求**：
-基于 libpcap 的网络抓包和分析工具。
-
-- 网络驱动适配
-- 协议解析引擎
-- Qt 分析界面
-- BPF 过滤支持
-- 完整教程
+**技术栈**：C + Qt + libpcap
 
 **验收标准**：
 - [ ] 可以抓包
@@ -186,37 +134,16 @@
 - [ ] 支持 BPF 过滤
 - [ ] 有完整教程
 
-**相关文件**：
-- `examples/project/proj-003-protocol-analyzer/`
-- `document/todo/projects/proj-003-protocol-analyzer.md`
+**相关文件**：`examples/project/proj-003-protocol-analyzer/`
 
 ---
 
-### 任务 D4-005：PROJ-004 - 复古掌机模拟器
+### D4-005: PROJ-004 游戏模拟器
 
 **优先级**：P2
 **推荐基础**：D3-001
 
-**为什么重要**：娱乐性强，展会现场让观众亲手试玩，人气爆棚。
-
-**适合场景**：对游戏开发、模拟器移植感兴趣的开发者。
-
-**核心亮点**：
-- 娱乐互动，展会现场让观众亲手试玩
-- 人气爆棚
-
-**技术栈**：
-- C + Qt + 模拟器移植
-- 陀螺仪驱动
-
-**详细要求**：
-移植游戏模拟器，支持体感控制。
-
-- 模拟器移植
-- Qt 游戏界面
-- 体感控制实现
-- 音频驱动支持
-- 完整教程
+**技术栈**：C + Qt + 模拟器移植
 
 **验收标准**：
 - [ ] 模拟器正常工作
@@ -225,49 +152,7 @@
 - [ ] 音频正常
 - [ ] 有完整教程
 
-**相关文件**：
-- `examples/project/proj-004-game-emulator/`
-- `document/todo/projects/proj-004-game-emulator.md`
-
----
-
-### 任务 D4-006：PROJ-005/006 - 其他精品项目
-
-**优先级**：P3
-**推荐基础**：D3-001
-
-**为什么重要**：丰富项目示例，展示更多应用场景。
-
-**适合场景**：想要深入学习特定技术领域的开发者。
-
-**详细要求**：
-完成其他精品项目：工业调试工具、Web 服务器等。
-
-- 参见各项目详情文档
-
-**相关文件**：
-- `examples/project/proj-005-bus-debugger/`
-- `examples/project/proj-006-web-server/`
-
----
-
-### 任务 D4-007：PROJ-007~010 - 快速项目
-
-**优先级**：P3
-**推荐基础**：D3-001
-
-**为什么重要**：快速项目可以丰富示例，展示不同技术点。
-
-**适合场景**：想要快速完成项目，或学习特定技术的开发者。
-
-**项目列表**：
-- PROJ-007：陀螺仪 3D 姿态展示仪（10 天）
-- PROJ-008：二维码名片生成器（10 天）
-- PROJ-009：触摸屏手写白板（8 天）
-- PROJ-010：系统性能监视器（8 天）
-
-**相关文件**：
-- `examples/project/proj-*/`
+**相关文件**：`examples/project/proj-004-game-emulator/`
 
 ---
 
@@ -297,6 +182,7 @@
 - **D1 详情**：[d1-environment.md](./d1-environment.md)
 - **D2 详情**：[d2-tools.md](./d2-tools.md)
 - **D3 详情**：[d3-examples.md](./d3-examples.md)
+- **GitHub Issue #47**: [路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
 
 ---
 
diff --git a/document/todo/roadmap.md b/document/todo/roadmap.md
index 4e409360..08efc6e6 100644
--- a/document/todo/roadmap.md
+++ b/document/todo/roadmap.md
@@ -1,8 +1,20 @@
 # IMX-Forge 项目路线图
 
-> **最后更新**：2026-04-06
+> **最后更新**：2026-05-21
+> **数据来源**：GitHub Issue #47 + 本地规划
 > **当前历史里程碑**：v0.5
-> **正式 release 策略**：从 v0.1.0 开始
+
+---
+
+## 📑 快速导航
+
+- 📁 **按方向查看**：
+  - [D1: 环境完善](./directions/d1-environment.md) - 25项
+  - [D2: 工具完备](./directions/d2-tools.md) - 23项
+  - [D3: 示例展示](./directions/d3-examples.md) - 11项
+  - [D4: 生态成熟](./directions/d4-ecosystem.md) - 18项
+- 🔗 **GitHub Issue #47**：[路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
+- 📦 **已完成**：[archive/v0.5-milestone.md](./archive/v0.5-milestone.md)
 
 ---
 
@@ -12,11 +24,18 @@
 [✅] v0.1 - 基础框架搭建
 [✅] v0.3 - U-Boot 和内核移植
 [✅] 历史里程碑 v0.5 - Mainline 内核迁移 + QT6 支持
-[🚧] 当前重点：环境完善与工具开发
-[📋] 方向 D1：环境完善
-[📋] 方向 D2：工具完备
-[📋] 方向 D3：示例展示
-[📋] 方向 D4：生态成熟
+[🚧] 当前阶段：文档建设 + 工具开发
+```
+
+---
+
+## 📊 优先级说明
+
+```
+P0 ──► 主线闭环，必须完成 (新用户第一次启动的完整路径)
+P1 ──► 重要功能，尽快完成 (应用开发+调试能力)
+P2 ──► 优化体验，逐步完善 (工作流+高级工具)
+P3 ──► 可选补充 (参考资源+更多项目)
 ```
 
 ---
@@ -26,41 +45,40 @@
 根据你的兴趣和当前状态选择合适的发展方向：
 
 **如果你是新用户：**
-- 从 **D1：环境完善** 开始 - 搭建开发环境
+- 从 **D1：环境完善** P0 开始 - 搭建开发环境
 - 然后根据兴趣选择其他方向
 
 **如果你想提升开发效率：**
-- 专注于 **D2：工具完备** - 开发辅助工具
+- 专注于 **D2：工具完备** P1 - 开发辅助工具
 
 **如果你想展示项目能力：**
-- 跳到 **D3：示例展示** - 创建旗舰项目
+- 跳到 **D3：示例展示** P1 - 创建旗舰项目
 
 **如果你想深度参与：**
-- 致力于 **D4：生态成熟** - 建设完整生态
+- 致力于 **D4：生态成熟** P2/P3 - 建设完整生态
 
 ---
 
 ## 🎯 发展方向
 
-### 📍 方向 D1：环境完善
+### 📍 方向 D1：环境完善 (25项)
 
 **核心目标**：
 - ✅ 提供开箱即用的开发环境
 - 📦 容器化构建系统
 - 🛠️ 完善辅助工具链
-- 📚 更新文档体系
+- 📚 完整文档体系
 
-**如何开始**：
-根据你的需求选择任务（详见 [D1 详情](./directions/d1-environment)）：
-- 新用户：D1-004 (env-init.sh) → D1-001 (Dockerfile)
-- VS Code 用户：D1-001 (Dockerfile) → D1-003 (Devcontainer)
-- 需要烧录：D1-004 (env-init.sh) → D1-005 (flash.sh)
+**优先级分布**：
+| P0 | P1 | P2 | 总计 |
+|----|----|----| ---- |
+| 21 | 3 | 1 | 25 |
 
-**详细规划**：参见 [D1 详情](./directions/d1-environment)
+**详细规划**：[D1 详情](./directions/d1-environment.md)
 
 ---
 
-### 📍 方向 D2：工具完备
+### 📍 方向 D2：工具完备 (23项)
 
 **核心目标**：
 - 🔧 完整的辅助脚本集
@@ -68,17 +86,16 @@
 - 📖 板卡接入规范
 - 🎯 多板卡支持框架
 
-**如何开始**：
-根据你的需求选择任务（详见 [D2 详情](./directions/d2-tools)）：
-- 提升效率：D2-001 (menuconfig.sh) → D2-002 (clean.sh)
-- 多板卡支持：D2-003 (select-board.sh) → D2-004 (板卡接入文档)
-- 代码质量：D2-005 (CI - Patch 校验) → D2-006 (CI - Docker 构建)
+**优先级分布**：
+| P0 | P1 | P2 | 总计 |
+|----|----|----| ---- |
+| - | 20 | 3 | 23 |
 
-**详细规划**：参见 [D2 详情](./directions/d2-tools)
+**详细规划**：[D2 详情](./directions/d2-tools.md)
 
 ---
 
-### 📍 方向 D3：示例展示
+### 📍 方向 D3：示例展示 (11项)
 
 **核心目标**：
 - 🎨 QT6 完整应用示例
@@ -86,17 +103,16 @@
 - 📸 完整的教程和演示
 - 🌟 展示项目价值
 
-**如何开始**：
-根据你的兴趣选择任务（详见 [D3 详情](./directions/d3-examples)）：
-- 必须先做：D3-001 (QT6 完整应用示例)
-- IoT 方向：D3-002 (PROJ-001 环境监测站)
-- 图像处理：D3-003 (PROJ-002 图像分析仪)
+**优先级分布**：
+| P0 | P1 | P2 | P3 | 总计 |
+|----|----|----|----| ---- |
+| - | 11 | - | - | 11 |
 
-**详细规划**：参见 [D3 详情](./directions/d3-examples)
+**详细规划**：[D3 详情](./directions/d3-examples.md)
 
 ---
 
-### 📍 方向 D4：生态成熟
+### 📍 方向 D4：生态成熟 (18项)
 
 **核心目标**：
 - 🌐 多种 Rootfs 方案
@@ -104,14 +120,12 @@
 - 🎮 多个精品项目
 - 👥 活跃的社区
 
-**如何开始**：
-根据你的兴趣选择任务（详见 [D4 详情](./directions/d4-ecosystem)）：
-- 系统构建：D4-001 (Buildroot) → D4-002 (Debian)
-- DevOps：D4-003 (完善 CI/CD)
-- 网络技术：D4-004 (PROJ-003 协议分析仪)
-- 游戏开发：D4-005 (PROJ-004 游戏模拟器)
+**优先级分布**：
+| P0 | P1 | P2 | P3 | 总计 |
+|----|----|----|----| ---- |
+| - | - | 4 | 14 | 18 |
 
-**详细规划**：参见 [D4 详情](./directions/d4-ecosystem)
+**详细规划**：[D4 详情](./directions/d4-ecosystem.md)
 
 ---
 
diff --git a/document/todo/todo.md b/document/todo/todo.md
index 959e6fc4..c55df23e 100644
--- a/document/todo/todo.md
+++ b/document/todo/todo.md
@@ -1,50 +1,66 @@
 # IMX-Forge 待办事项
 
-> **最后更新**：2026-04-06
+> **最后更新**：2026-05-21
+> **数据来源**：GitHub Issue #47 + 本地规划
 > **当前历史里程碑**：v0.5
-> **正式 release 策略**：从 v0.1.0 开始
-> **查看详情**：[roadmap.md](roadmap.md)
 
 ---
 
 ## 📑 快速导航
 
 - 🗺️ **总体路线图**：[roadmap.md](roadmap.md)
-- 📁 **发展方向**：
-  - [D1: 环境完善](directions/d1-environment) - 开发环境搭建
-  - [D2: 工具完备](directions/d2-tools) - 提升开发效率
-  - [D3: 示例展示](directions/d3-examples) - 展示项目能力
-  - [D4: 生态成熟](directions/d4-ecosystem) - 建设完整生态
+- 📁 **按方向查看**：
+  - [D1: 环境完善](directions/d1-environment) - 25项 (6工具 + 19文档)
+  - [D2: 工具完备](directions/d2-tools) - 23项 (6工具 + 17文档)
+  - [D3: 示例展示](directions/d3-examples) - 11项 (3工具 + 8文档)
+  - [D4: 生态成熟](directions/d4-ecosystem) - 18项 (7工具 + 11文档)
 - 🎯 **示例项目**：[projects/](projects/)
 - 📦 **已完成**：[archive/v0.5-milestone.md](archive/v0.5-milestone)
+- 🔗 **GitHub Issue #47**：[路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
 
 ---
 
-## 🎯 当前重点：根据兴趣选择方向
+## 📊 优先级说明
 
-我们不再设定严格的里程碑和时间线，而是根据优先级和需求选择任务。
+```
+P0 ──► 主线闭环，必须完成 (新用户第一次启动的完整路径)
+P1 ──► 重要功能，尽快完成 (应用开发+调试能力)
+P2 ──► 优化体验，逐步完善 (工作流+高级工具)
+P3 ──► 可选补充 (参考资源+更多项目)
+```
+
+---
+
+## 📊 任务统计总览
+
+### 按方向统计
 
-### 如何选择方向？
+| 方向 | P0 | P1 | P2 | P3 | 总计 |
+|------|----|----|----|----| ---- |
+| D1: 环境完善 | 21 | 3 | 1 | - | 25 |
+| D2: 工具完备 | - | 20 | 3 | - | 23 |
+| D3: 示例展示 | - | 11 | - | - | 11 |
+| D4: 生态成熟 | - | - | 4 | 14 | 18 |
+| **总计** | **21** | **34** | **8** | **14** | **77** |
 
-**新用户**：从 [D1: 环境完善](directions/d1-environment) 开始
-**追求效率**：专注于 [D2: 工具完备](directions/d2-tools)
-**展示能力**：跳到 [D3: 示例展示](directions/d3-examples)
-**深度参与**：致力于 [D4: 生态成熟](directions/d4-ecosystem)
+### 按类型统计
+
+| 类型 | 数量 |
+|------|------|
+| 工具任务 | 22项 (D1:6 + D2:6 + D3:3 + D4:7) |
+| 文档任务 | 55项 (来自 Issue #47) |
+| **总计** | **77项** |
 
 ---
 
-## 📊 项目进度
+## 🎯 当前重点
 
-```
-[✅] v0.1 - 基础框架搭建
-[✅] v0.3 - U-Boot 和内核移植
-[✅] 历史里程碑 v0.5 - Mainline 内核迁移 + QT6 支持
-[🚧] 当前重点：环境完善与工具开发
-[📋] 方向 D1：环境完善
-[📋] 方向 D2：工具完备
-[📋] 方向 D3：示例展示
-[📋] 方向 D4：生态成熟
-```
+我们根据优先级和需求选择任务：
+
+**新用户**：从 [D1: 环境完善](directions/d1-environment) P0 开始
+**追求效率**：专注于 [D2: 工具完备](directions/d2-tools) P1
+**展示能力**：跳到 [D3: 示例展示](directions/d3-examples) P1
+**深度参与**：致力于 [D4: 生态成熟](directions/d4-ecosystem) P2/P3
 
 ---
 
@@ -99,24 +115,21 @@
 document/todo/
 ├── roadmap.md             # 总体路线图（从这里开始！）
 ├── todo.md                # 本文件：任务总览
-├── projects/              # 示例项目详情
 ├── directions/            # 发展方向
-│   ├── d1-environment.md  # D1: 环境完善
-│   ├── d2-tools.md        # D2: 工具完备
-│   ├── d3-examples.md     # D3: 示例展示
-│   └── d4-ecosystem.md    # D4: 生态成熟
+│   ├── d1-environment.md  # D1: 环境完善 (25项)
+│   ├── d2-tools.md        # D2: 工具完备 (23项)
+│   ├── d3-examples.md     # D3: 示例展示 (11项)
+│   └── d4-ecosystem.md    # D4: 生态成熟 (18项)
 ├── projects/              # 示例项目详情
-│   ├── proj-001-env-monitor.md
-│   └── proj-002-image-analyzer.md
-└── archive/               # 已完成归档
-    └── v0.5-milestone.md
+├── archive/               # 已完成归档
+│   └── v0.5-milestone.md
 ```
 
 ---
 
 ## 🔗 相关链接
 
-- **快速开始**：[../QUICK_START](../QUICK_START)
+- **快速开始**：[../../QUICK_START.md](../../QUICK_START.md)
 - **教程目录**：[../tutorial/](../tutorial/)
 - **GitHub Issues**：[提交问题](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues)
 
@@ -137,5 +150,3 @@ document/todo/
 ---
 
 **让嵌入式 Linux 开发变得简单！** 🚀
-
-> 💡 **提示**：新用户建议先阅读 [roadmap.md](roadmap.md) 了解项目全貌，然后根据兴趣选择合适的发展方向。

From f1be2c1f444b51adcd3d6aee6bdf476e426d2599 Mon Sep 17 00:00:00 2001
From: Charliechen114514 <725610365@qq.com>
Date: Fri, 22 May 2026 08:32:49 +0800
Subject: [PATCH 2/2] fix: ci build issue

---
 .gitignore            | 2 --
 document/todo/todo.md | 2 +-
 package.json          | 5 -----
 pnpm-workspace.yaml   | 2 ++
 4 files changed, 3 insertions(+), 8 deletions(-)
 create mode 100644 pnpm-workspace.yaml

diff --git a/.gitignore b/.gitignore
index 27f92eca..dd50421c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -34,5 +34,3 @@ modules.builtin
 modules.builtin.modinfo
 
 .venv/
-
-pnpm-workspace.yaml
diff --git a/document/todo/todo.md b/document/todo/todo.md
index c55df23e..9f016432 100644
--- a/document/todo/todo.md
+++ b/document/todo/todo.md
@@ -129,7 +129,7 @@ document/todo/
 
 ## 🔗 相关链接
 
-- **快速开始**：[../../QUICK_START.md](../../QUICK_START.md)
+- **快速开始**：[../QUICK_START.md](../QUICK_START.md)
 - **教程目录**：[../tutorial/](../tutorial/)
 - **GitHub Issues**：[提交问题](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues)
 
diff --git a/package.json b/package.json
index 919a0bbc..e6d19f1f 100644
--- a/package.json
+++ b/package.json
@@ -17,10 +17,5 @@
   },
   "dependencies": {
     "minisearch": "^7.2.0"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
   }
 }
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
new file mode 100644
index 00000000..5ed0b5af
--- /dev/null
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,2 @@
+allowBuilds:
+  esbuild: true