fix: document repolishes (#46)

Author: Charliechen114514

.gitignore

@@ -12,6 +12,7 @@ host/
 node_modules/
 site/.vitepress/dist/
 site/.vitepress/cache/
+site/.vitepress/.temp/
 site/.vitepress/.build-cache/
 site/.vitepress/.build-tmp/
 *.tgz
@@ -34,4 +35,4 @@ modules.builtin.modinfo
 
 .venv/
 
-pnpm-workspace.yaml
+pnpm-workspace.yaml

README.md

@@ -47,7 +47,7 @@
 
 ### 📚 完整的 0→1 学习路径
 
-> **114 篇教程，从入门到实战**
+> **持续增长的教程体系，从入门到实战**
 
 ```
 工具链 → U-Boot → 内核 → Rootfs → 驱动开发 → 实战项目
@@ -77,13 +77,13 @@ IMX-Forge 支持 **Docker** 和 **WSL2 + Docker** 两种开发环境：
 
 #### 方式一：直接拉取镜像（最简单）
 
-我们提供预构建的 Docker 镜像，包含完整的开发环境：
+我们提供预构建的 Docker 镜像，包含完整的开发环境。正式版本标签从 `v0.1.0` 开始；历史 `v0.5` 仅作为路线图里程碑编号保留。
 
 | 标签 | 说明 | 适用场景 |
 |------|------|----------|
 | `latest` | 稳定版本 | 日常开发推荐 |
 | `preview` | 预览版本 | 测试新功能 |
-| `v1.0.0` 等 | 版本号 | 锁定特定版本 |
+| `v0.1.0` 等 | 版本号 | 锁定特定版本 |
 
 ```bash
 git clone --recurse-submodules https://github.com/Awesome-Embedded-Learning-Studio/imx-forge.git
@@ -98,7 +98,7 @@ docker run -it --rm -v $(pwd):/workspace ghcr.io/awesome-embedded-learning-studi
 
 使用特定版本：
 ```bash
-docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v1.0.0
+docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v0.1.0
 ```
 
 > **镜像说明**: 基于 Ubuntu 24.04，预装 ARM GNU Toolchain 15.2.rel1 及所有开发依赖，截至文档更新时约 2GB（实际大小可能存在波动）。详见 [Docker 发布文档](document/ci/docker-publish.md)

docker/README.md

@@ -14,7 +14,7 @@
 
 ### 方式一：直接拉取预构建镜像（推荐）
 
-我们已经为你构建好了 Docker 镜像，可以直接拉取使用：
+我们会为正式 release 提供预构建 Docker 镜像，可以直接拉取使用。正式版本标签从 `v0.1.0` 开始；如果尚未发布对应标签，请使用本地构建方式。
 
 ```bash
 # 拉取最新版本
@@ -27,7 +27,7 @@ docker run -it --rm -v $(pwd):/workspace ghcr.io/awesome-embedded-learning-studi
 
 使用特定版本：
 ```bash
-docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v1.0.0
+docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v0.1.0
 ```
 
 ### 方式二：本地构建

document/QUICK_START.md

@@ -39,8 +39,8 @@
 
 IMX-Forge 是一个面向 NXP i.MX6ULL 开发板的开源构建系统，它将通常散落在各处的嵌入式开发资源整合在一起：
 
-- **补丁管理** —— 基于 `format-patch + series` 的双轨补丁系统（linux-imx / mainline）
-- **构建脚本** —— 一键构建 U-Boot、Linux 内核（NXP BSP / Mainline）、BusyBox Rootfs
+- **补丁管理** —— 基于 `format-patch` 的双轨补丁管理（当前自动应用脚本按文件名选择最新 patch；`series` 机制属于后续增强方向）
+- **构建脚本** —— 一键构建 U-Boot、Linux NXP BSP 内核、BusyBox Rootfs；Mainline 由独立脚本和 CI 负责验证
 - **教程文档** —— 从工具链到系统调试的完整学习路径
 - **第三方源码** —— Git Submodule 管理的 U-Boot、Linux、BusyBox、QT 编译流水线
 
@@ -56,8 +56,8 @@ IMX-Forge 是一个面向 NXP i.MX6ULL 开发板的开源构建系统，它将
 │  U-Boot (NXP uboot-imx) → u-boot-dtb.imx                     │
 │         ↓                                                     │
 │  Linux Kernel (双轨支持)                                      │
-│    ├── linux-imx (NXP BSP 6.12.3) → zImage + .dtb           │
-│    └── linux_mainline (上游内核) → zImage + .dtb            │
+│    ├── linux-imx (NXP BSP 6.12.3，默认系统构建轨) → zImage + .dtb │
+│    └── linux_mainline (上游内核，CI 验证轨) → zImage + .dtb  │
 │         ↓                                                     │
 │  BusyBox Rootfs → 最小文件系统                               │
 │         ↓                                                     │
@@ -76,8 +76,8 @@ patches/
 └── [mainline]    上游内核      ← 已完成迁移
 ```
 
-- **linux-imx**：NXP 官方 BSP，稳定可靠，驱动支持完善
-- **mainline**：上游主线内核，长期维护，可向上游贡献
+- **linux-imx**：NXP 官方 BSP，稳定可靠，驱动支持完善，是默认系统构建轨
+- **mainline**：上游主线内核，长期维护，可向上游贡献，项目通过 CI 构建验证持续兼顾
 
 ### 适合谁
 

document/architecture/BUILD_SYSTEM.md

@@ -478,7 +478,7 @@ log_error "构建失败！"
 export SOURCE_DATE_EPOCH=1609459200  # 2021-01-01 00:00:00 UTC
 
 # 执行发布构建
-./scripts/release_builder/build_release_uboot.sh v1.0.0
+./scripts/release_builder/build_release_uboot.sh v0.1.0
 ```
 
 **构建信息文件**：
@@ -487,7 +487,7 @@ export SOURCE_DATE_EPOCH=1609459200  # 2021-01-01 00:00:00 UTC
 ========================================
 U-Boot Release Build Information
 ========================================
-Release Version: v1.0.0
+Release Version: v0.1.0
 Build Date: Fri Jan  1 00:00:00 UTC 2021
 Source Date Epoch: 1609459200
 

document/architecture/PATCH_SYSTEM.md

@@ -9,7 +9,7 @@
 ## 目录
 
 1. [系统概述](#系统概述)
-2. [format-patch + series 机制](#format-patch--series-机制)
+2. [format-patch 与 series 规划](#format-patch-与-series-规划)
 3. [补丁目录组织规范](#补丁目录组织规范)
 4. [补丁版本管理](#补丁版本管理)
 5. [自动化工具使用](#自动化工具使用)
@@ -59,7 +59,11 @@ IMX-Forge 项目采用 **Git Submodule + Patch** 的混合管理模式，将第
 
 ---
 
-## format-patch + series 机制
+## format-patch 与 series 规划
+
+::: info 当前实现状态
+当前 `scripts/apply_patches.sh` 采用简化策略：按文件名排序，仅应用目标补丁目录中最新的 `.patch` 文件。下文描述的 `series` 顺序应用机制是推荐架构和后续增强方向，不代表当前脚本已经完整实现。
+:::
 
 ### Git format-patch 原理
 
@@ -160,7 +164,7 @@ index 89171be84f27..b35ddc6e8ddb 100644
 1. **应用顺序控制**: 确保补丁按正确顺序应用
 2. **条件应用**: 通过注释分组管理补丁
 3. **版本追踪**: 在补丁文件名中嵌入版本信息
-4. **自动化集成**: 构建脚本读取 series 文件批量应用补丁
+4. **自动化集成**: 后续构建脚本可读取 series 文件批量应用补丁
 
 ### 补丁命名规范
 

document/architecture/SYSTEM_ARCHITECTURE.md

@@ -684,15 +684,17 @@ imx-forge/
 
 ## 7. 设计决策记录
 
-### 7.1 为什么选择 format-patch + series
+### 7.1 为什么选择 format-patch 与 series 规划
+
+> 当前实现说明：项目现有自动补丁脚本仍采用“按文件名排序，仅应用最新 patch”的简化策略。`series` 是推荐架构和后续增强方向，用于未来管理多补丁顺序。
 
 **背景**
 
 嵌入式开发中，对厂商 BSP 的修改管理是一个挑战。直接修改源码无法追踪、无法复用、难以贡献回上游。
 
 **决策**
 
-采用 Git `format-patch` 生成的标准补丁格式，配合 `series` 文件管理应用顺序。
+采用 Git `format-patch` 生成的标准补丁格式；后续可配合 `series` 文件管理应用顺序。
 
 **理由**
 

document/ci/ci-full.md

@@ -73,6 +73,10 @@
 |----------|------|--------|
 | release-images | `out/release-latest/images/` | 30 天 |
 
+::: info 双轨说明
+Full Build 同时验证 Linux NXP BSP 和 Linux Mainline。当前 `release-images` artifact 主要来自 `release-all.sh` 的 BSP 默认链路；Mainline 在同一次工作流中作为兼顾轨道进行构建验证。
+:::
+
 ## 使用场景
 
 1. **PR 完整验证**：添加 `full-build` 标签

document/ci/ci-release.md

@@ -2,6 +2,10 @@
 
 发布构建工作流，为正式发布准备构建产物。
 
+::: info 产物定位
+当前 Release Build 打包的是 `release-all.sh` 生成的构建验证产物，主要来自 BSP 默认链路。IMX-Forge 的交付重点是可复现构建体系，而不是承诺通用可直接烧录的 binary。
+:::
+
 ## 文件
 
 `.github/workflows/ci-release.yml`
@@ -19,8 +23,8 @@
 
 | 分支名 | 提取的版本 |
 |--------|------------|
-| `release-1.0.0` | `1.0.0` |
-| `release-2.5.0-beta` | `2.5.0-beta` |
+| `release-0.1.0` | `0.1.0` |
+| `release-0.2.0-beta` | `0.2.0-beta` |
 
 ## 构建流程
 
@@ -64,8 +68,8 @@ imx-forge-{version}.tar.gz
 
 1. 创建 release 分支：
    ```bash
-   git checkout -b release-1.0.0
-   git push origin release-1.0.0
+   git checkout -b release-0.1.0
+   git push origin release-0.1.0
    `` ``
 
 2. 等待 CI 构建完成

document/ci/docker-publish.md

@@ -1,16 +1,20 @@
-<PageHeader icon="🐳" title="Docker 镜像发布" description="IMX-Forge 预构建 Docker 镜像发布流程，用户可直接拉取使用" />
+<PageHeader icon="🐳" title="Docker 镜像发布" description="IMX-Forge Docker 镜像发布流程，正式版本从 v0.1.0 开始" />
 
 ## 概述
 
-IMX-Forge 提供**预构建的 Docker 镜像**，用户无需手动构建，可直接拉取使用。镜像通过 GitHub Actions 自动构建并发布到 GitHub Container Registry。
+IMX-Forge 会为正式 release 提供**预构建的 Docker 镜像**，用户无需手动构建即可获得一致的开发环境。镜像通过 GitHub Actions 自动构建并发布到 GitHub Container Registry。
+
+::: info 版本说明
+项目正式 release 从 `v0.1.0` 开始。历史 `v0.5` 是路线图里程碑编号，不等同于正式 Docker tag。
+:::
 
 ## 镜像标签策略
 
 | 标签 | 获取方式 | 稳定性 | 用途 |
 |------|----------|--------|------|
 | `latest` | 手动触发 / 发布 tag | <Badge type="tip" text="稳定" /> | 推荐给大多数用户 |
 | `preview` | 手动触发 | <Badge type="warning" text="实验性" /> | 测试新功能、尝鲜 |
-| `v1.0.0` 等 | 发布 tag | <Badge type="tip" text="稳定" /> | 锁定特定版本 |
+| `v0.1.0` 等 | 发布 tag | <Badge type="tip" text="稳定" /> | 锁定特定版本 |
 
 ## 发布流程
 
@@ -38,10 +42,10 @@ IMX-Forge 提供**预构建的 Docker 镜像**，用户无需手动构建，可
 
 ```bash
 # 创建版本 tag
-git tag v1.0.0
-git push origin v1.0.0
+git tag v0.1.0
+git push origin v0.1.0
 
-# 自动触发构建：v1.0.0, v1, latest
+# 自动触发构建：v0.1.0, v0.1, v0, latest
 ```
 
 ## 镜像内容
@@ -70,7 +74,7 @@ docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:latest
 docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:preview
 
 # 特定版本
-docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v1.0.0
+docker pull ghcr.io/awesome-embedded-learning-studio/imx-forge:v0.1.0
 ```
 
 ### 运行容器