feat: upgrade the scripts, see details in PR (#49)

* feat: upgrade the scripts, see details in PR

* fix: dead link

Author: Charliechen114514

docker/Dockerfile

@@ -13,6 +13,7 @@ FROM ubuntu:24.04 AS builder
 
 ARG TOOLCHAIN_VERSION=15.2.rel1
 ARG TOOLCHAIN_URL=https://developer.arm.com/-/media/Files/downloads/gnu/${TOOLCHAIN_VERSION}/binrel/arm-gnu-toolchain-${TOOLCHAIN_VERSION}-x86_64-arm-none-linux-gnueabihf.tar.xz
+ARG VERBOSE=0
 
 WORKDIR /build
 
@@ -22,7 +23,11 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
-RUN wget -q ${TOOLCHAIN_URL} -O toolchain.tar.xz \
+RUN if [ "$VERBOSE" = "1" ]; then \
+        wget -v ${TOOLCHAIN_URL} -O toolchain.tar.xz; \
+    else \
+        wget --progress=bar:force:noscroll ${TOOLCHAIN_URL} -O toolchain.tar.xz; \
+    fi \
     && tar -xf toolchain.tar.xz \
     && mv arm-gnu-toolchain-${TOOLCHAIN_VERSION}-x86_64-arm-none-linux-gnueabihf /opt/arm-gnu-toolchain \
     && rm toolchain.tar.xz \

docker/Dockerfile.cn

@@ -11,6 +11,7 @@ FROM ubuntu:24.04 AS builder
 
 ARG TOOLCHAIN_VERSION=15.2.rel1
 ARG TOOLCHAIN_URL=https://developer.arm.com/-/media/Files/downloads/gnu/${TOOLCHAIN_VERSION}/binrel/arm-gnu-toolchain-${TOOLCHAIN_VERSION}-x86_64-arm-none-linux-gnueabihf.tar.xz
+ARG VERBOSE=0
 
 WORKDIR /build
 
@@ -21,7 +22,11 @@ RUN sed -i 's@//.*archive.ubuntu.com@//mirrors.aliyun.com@g' /etc/apt/sources.li
     ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
-RUN wget -q ${TOOLCHAIN_URL} -O toolchain.tar.xz \
+RUN if [ "$VERBOSE" = "1" ]; then \
+        wget -v ${TOOLCHAIN_URL} -O toolchain.tar.xz; \
+    else \
+        wget --progress=bar:force:noscroll ${TOOLCHAIN_URL} -O toolchain.tar.xz; \
+    fi \
     && tar -xf toolchain.tar.xz \
     && mv arm-gnu-toolchain-${TOOLCHAIN_VERSION}-x86_64-arm-none-linux-gnueabihf /opt/arm-gnu-toolchain \
     && rm toolchain.tar.xz \

docker/README.md

@@ -146,6 +146,37 @@ docker build \
     .
 ```
 
+### 控制构建输出详细程度
+
+`VERBOSE` 和 Docker 的进度输出是两层不同的开关：
+
+- `--build-arg VERBOSE=1`：让 Dockerfile 里的 `wget` 使用详细输出
+- `--progress=plain`：让 BuildKit 不使用动态刷新界面，按普通日志逐行输出
+
+```bash
+# 默认模式（显示进度条）
+docker build -t imx-forge:latest .
+
+# 详细输出模式（推荐用于调试下载问题）
+docker build --progress=plain --build-arg VERBOSE=1 -t imx-forge:latest .
+
+# 如果从项目根目录构建，请显式指定 Dockerfile 路径
+docker build --progress=plain --build-arg VERBOSE=1 -f docker/Dockerfile -t imx-forge:latest .
+
+# 国内镜像源版本
+docker build --progress=plain --build-arg VERBOSE=1 -f docker/Dockerfile.cn -t imx-forge:latest .
+```
+
+**参数说明**：
+
+| 参数 | 控制对象 | 效果 |
+|------|----------|------|
+| `VERBOSE=0` 或未设置 | Dockerfile 内部命令 | 使用默认下载输出 |
+| `VERBOSE=1` | Dockerfile 内部命令 | `wget` 使用详细输出 |
+| `--progress=plain` | Docker BuildKit 输出界面 | 禁用动态刷新，按普通日志逐行输出 |
+
+**注意**：如果只设置 `--build-arg VERBOSE=1`，BuildKit 仍可能使用动态进度界面重绘终端，看起来像日志被覆盖。调试时优先使用 `--progress=plain`，通常不需要禁用 BuildKit。
+
 ### 持久化容器
 
 创建一个持久化的开发容器：

document/todo/archive/v0.5-milestone.md

@@ -7,7 +7,7 @@
 如果你是第一次了解 IMX-Forge，建议按以下顺序阅读：
 
 1. **📖 [总体路线图](roadmap)** - 了解项目全貌和发展规划
-2. **📦 [v0.5 归档](archive/v0.5-milestone)** - 了解已完成的工作
+2. **📦 v0.5 里程碑** - Mainline 内核迁移 + QT6 支持已完成
 3. **🎯 [当前重点：D1 方向](directions/d1-environment)** - 查看环境完善方向
 
 ### 贡献者入口

document/todo/index.md

@@ -14,7 +14,7 @@
   - [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)
+- 📦 **已完成**：v0.5 里程碑（Mainline 内核迁移 + QT6 支持）
 
 ---
 
@@ -172,7 +172,7 @@ P3 ──► 可选补充 (参考资源+更多项目)
 - ✅ WSL2 Mirrored 网络模式支持
 - ✅ 持续增长的完整教程体系
 
-**详细记录**：参见 [v0.5 归档](./archive/v0.5-milestone)
+**详细记录**：v0.5 里程碑已完成 Mainline 内核迁移和 QT6 支持
 
 ---
 

document/todo/roadmap.md

@@ -15,7 +15,7 @@
   - [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)
+- 📦 **已完成**：v0.5 里程碑（Mainline 内核迁移 + QT6 支持）
 - 🔗 **GitHub Issue #47**：[路线任务追踪](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/47)
 
 ---
@@ -76,7 +76,7 @@ P3 ──► 可选补充 (参考资源+更多项目)
 - [x] **WSL2 Mirrored 网络模式**：Windows 用户无缝使用
 - [x] **完整教程体系**：持续增长的教程内容覆盖完整学习路径
 
-**详细记录**：参见 [v0.5 归档](archive/v0.5-milestone)
+**详细记录**：v0.5 里程碑已完成 Mainline 内核迁移和 QT6 支持
 
 ---