chore: maintaining documentation

Author: GZTimeWalker

docs/labs/0x00/index.md

@@ -35,7 +35,6 @@
 2. 请参考 [代码与提交规范](../../general/specification.md) 进行实验代码编写。
 
 3. 依据 [实验任务](./tasks.md) 完成实验。
-
     - 代码编写任务：观察提供的代码，完善所有标记为 `FIXME:` 的部分，并验证结果是否符合预期。**请在报告中介绍实现思路，截图展示关键结果。**
     - 思考任务：完成 “思考题” 和 “实验任务” 部分的内容，**在报告中简要进行回答**。_注：思考题可能也是理解代码、实现功能的重要提示。_
     - Bonus 加分项：学有余力的同学可以任选 Bonus 部分完成，尝试完成更多的功能，并在报告中进行展示。这部分内容不是必须的要求。

docs/labs/0x00/tasks.md

@@ -14,9 +14,9 @@
 
 我们推荐在以下环境进行实验：
 
-- Ubuntu 22.04 LTS (jammy) on WSL 2 **(推荐 Windows 用户选择)**
+- Ubuntu 24.04 LTS (Noble) on WSL 2 **(推荐 Windows 用户选择)**
 - Windows 10/11 **(Windows 原生备选，GDB 相关功能无法使用)**
-- Ubuntu 22.04 LTS (jammy)
+- Ubuntu 24.04 LTS (Noble)
 - macOS with Apple Silicon
 
 以上环境经过我们的测试和验证，可以正常进行实验。对于其他常用的 Linux 发行版，通常也可以正常进行实验，但我们不提供技术支持。
@@ -51,7 +51,6 @@
     - 你还可以通过配置文件 `rustfmt.toml` 和 `taplo.toml` 自定义你的代码 `*.rs` 和配置文件 `*.toml` 如何格式化，[实验 0x00 代码](https://github.com/YatSenOS/YatSenOS-Tutorial-Volume-2/tree/main/src/0x00/)已经给出了这样 2 个配置文件供参考。
 
 1.  使用 Rust 编写一个程序，完成以下任务：
-
     1. 创建一个函数 `count_down(seconds: u64)`
 
         该函数接收一个 u64 类型的参数，表示倒计时的秒数。
@@ -75,7 +74,6 @@
         !!! tip "尝试将 `std::io::Result` 转换为 `std::Result`，你可能需要 `map_err` 等函数。"
 
     4. 在 `main` 函数中，按照如下顺序调用上述函数：
-
         - 首先调用 `count_down(5)` 函数进行倒计时
         - 然后调用 `read_and_print("/etc/hosts")` 函数尝试读取并输出文件内容
         - 最后使用 `std::io` 获取几个用户输入的路径，并调用 `file_size` 函数尝试获取文件大小，并处理可能的错误。
@@ -85,7 +83,6 @@
     注意：在处理文件操作时，需要使用到 Rust 的文件处理相关库，如 `std::fs` 和 `std::io`。在处理错误时，需要使用到 Rust 的错误处理机制，如 `expect` 和 `unwrap` 等。
 
 2.  实现一个进行字节数转换的函数，并格式化输出：
-
     1.  实现函数 `humanized_size(size: u64) -> (f64, &'static str)` 将字节数转换为人类可读的大小和单位
 
         使用 1024 进制，并使用二进制前缀（B, KiB, MiB, GiB）作为单位
@@ -129,7 +126,6 @@
     输出一些带有颜色的字符串，并尝试直接使用 `print!` 宏输出一到两个相同的效果。
 
     尝试输出如下格式和内容：
-
     - `INFO: Hello, world!`，其中 `INFO:` 为绿色，后续内容为白色
     - `WARNING: I'm a teapot!`，颜色为黄色，加粗，并为 `WARNING` 添加下划线
     - `ERROR: KERNEL PANIC!!!`，颜色为红色，加粗，并尝试让这一行在控制行窗口居中
@@ -140,7 +136,6 @@
 4.  使用 `enum` 对类型实现同一化
 
     实现一个名为 `Shape` 的枚举，并为它实现 `pub fn area(&self) -> f64` 方法，用于计算不同形状的面积。
-
     - 你可能需要使用模式匹配来达到相应的功能
     - 请实现 `Rectangle` 和 `Circle` 两种 `Shape`，并使得 `area` 函数能够正确计算它们的面积
     - 使得你的实现能够通过如下测试：
@@ -164,7 +159,6 @@
 5.  实现一个元组结构体 `UniqueId(u16)`
 
     使得每次调用 `UniqueId::new()` 时总会得到一个新的不重复的 `UniqueId`。
-
     - 你可以在函数体中定义 `static` 变量来存储一些全局状态
     - 你可以尝试使用 `std::sync::atomic::AtomicU16` 来确保多线程下的正确性（无需进行验证，相关原理将在 Lab 5 介绍，此处不做要求）
     - 使得你的实现能够通过如下测试：
@@ -394,15 +388,13 @@ BdsDxe: starting Boot0002 "UEFI QEMU HARDDISK QM00001 " from ...
 1. 😋 基于控制行颜色的 Rust 编程题目，参考 `log` crate 的文档，为不同的日志级别输出不同的颜色效果，并进行测试输出。
 
 2. 🤔 基于第一个 Rust 编程题目，实现一个简单的 shell 程序：
-
     - 实现 `cd` 命令，可以切换当前工作目录（可以不用检查路径是否存在）
     - 实现 `ls` 命令，尝试列出当前工作目录下的文件和文件夹，以及有关的信息（如文件大小、创建时间等）
     - 实现 `cat` 命令，输出某个文件的内容
 
     !!! question "路径的切换是很容易出现问题的操作，你的程序能正常处理 `cd ../../././../a/b/c/../.././d/` 吗？"
 
 3. 🤔 尝试使用线程模型，基于 `UniqueId` 的任务：
-
     - 尝试证明 `static mut` 变量在多线程下的不安全（可能获得相同的 `UniqueId`）
     - 尝试验证 `AtomicU16` 来实现 `UniqueId` 时的正确性
 

docs/labs/0x01/index.md

@@ -33,7 +33,6 @@
 2. 请参考 [代码与提交规范](../../general/specification.md) 进行实验代码编写。
 
 3. 依据 [实验任务](./tasks.md) 完成实验。
-
     - 代码编写任务：观察提供的代码，完善所有标记为 `FIXME:` 的部分，并验证结果是否符合预期。**请在报告中介绍实现思路，截图展示关键结果。**
     - 思考任务：完成 “思考题” 和 “实验任务” 部分的内容，**在报告中简要进行回答**。_注：思考题可能也是理解代码、实现功能的重要提示。_
     - Bonus 加分项：学有余力的同学可以任选 Bonus 部分完成，尝试完成更多的功能，并在报告中进行展示。这部分内容不是必须的要求。

docs/labs/0x01/tasks.md

@@ -34,23 +34,23 @@
 
 ```json
 {
-  "llvm-target": "x86_64-unknown-none",
-  "data-layout": "e-m:e-p270:32:32-p271:32:32-p272:64:64-i64:64-i128:128-f80:128-n8:16:32:64-S128",
-  "arch": "x86_64",
-  "target-endian": "little",
-  "target-pointer-width": "64",
-  "target-c-int-width": "32",
-  "os": "none",
-  "executables": true,
-  "linker-flavor": "ld.lld",
-  "linker": "rust-lld",
-  "panic-strategy": "abort",
-  "disable-redzone": true,
-  "features": "-mmx,-sse,+soft-float",
-  "rustc-abi": "x86-softfloat",
-  "pre-link-args": {
-    "ld.lld": ["-Tcrates/kernel/config/kernel.ld", "-export-dynamic"]
-  }
+    "llvm-target": "x86_64-unknown-none",
+    "data-layout": "e-m:e-p270:32:32-p271:32:32-p272:64:64-i64:64-i128:128-f80:128-n8:16:32:64-S128",
+    "arch": "x86_64",
+    "target-endian": "little",
+    "target-pointer-width": "64",
+    "target-c-int-width": "32",
+    "os": "none",
+    "executables": true,
+    "linker-flavor": "ld.lld",
+    "linker": "rust-lld",
+    "panic-strategy": "abort",
+    "disable-redzone": true,
+    "features": "-mmx,-sse,+soft-float",
+    "rustc-abi": "x86-softfloat",
+    "pre-link-args": {
+        "ld.lld": ["-Tcrates/kernel/config/kernel.ld", "-export-dynamic"]
+    }
 }
 ```
 
@@ -187,14 +187,14 @@ unsafe {
 
     !!! note "使用 `.gdbinit` 方便你的调试过程"
 
-        以下是一个 `.gdbinit` 的例子，你可以将其放置在你的工作目录下，这样每次进入 GDB 调试环境时，它都会自动加载。请注意部分指令是 `gef` 所提供的，详情请见调试文档。
+          以下是一个 `.gdbinit` 的例子，你可以将其放置在你的工作目录下，这样每次进入 GDB 调试环境时，它都会自动加载。请注意部分指令是 `gef` 所提供的，详情请见调试文档。
 
-        ```bash
-        file esp/KERNEL.ELF
-        gef-remote localhost 1234
-        tmux-setup
-        b ysos_kernel::init
-        ```
+          ```bash
+          file esp/KERNEL.ELF
+          gef-remote localhost 1234
+          tmux-setup
+          b ysos_kernel::init
+          ```
 
 - 使用 `c` 命令继续执行，你将会看到 QEMU 窗口中的输出，同时 GDB 将会在断点处停下。
 - 查看断点处的汇编和符号是否正确，使用 `vmmap` 和 `readelf` 等指令查看内核的加载情况。
@@ -514,7 +514,6 @@ println!("{}", record.args());
 3.  串口驱动是在进入内核后启用的，那么在进入内核之前，显示的内容是如何输出的？
 
 4.  在 QEMU 中，我们通过指定 `-nographic` 参数来禁用图形界面，这样 QEMU 会默认将串口输出重定向到主机的标准输出。
-
     - 假如我们将 `Makefile` 中取消该选项，QEMU 的输出窗口会发生什么变化？请观察指令 `make run QEMU_OUTPUT=` 的输出，结合截图分析对应现象。
     - 在移除 `-nographic` 的情况下，如何依然将串口重定向到主机的标准输入输出？请尝试自行构造命令行参数，并查阅 QEMU 的文档，进行实验。
     - 如果你使用 `ysos.py` 来启动 qemu，可以尝试修改 `-o` 选项来实现上述功能。
@@ -534,7 +533,6 @@ println!("{}", record.args());
 3. 🤔 尝试添加字符串型启动配置变量 `log_level`，并修改 `logger` 的初始化函数，使得内核能够根据启动参数进行日志输出。
 
 4. 🤔 尝试使用调试器，在内核初始化之后（`ysos::init` 调用结束后）下断点，查看、记录并解释如下的信息：
-
     - 内核的栈指针、栈帧指针、指令指针等寄存器的值。
     - 内核的代码段、数据段、BSS 段等在内存中的位置。
 

docs/labs/0x02/index.md

@@ -34,7 +34,6 @@
 2. 请参考 [代码与提交规范](../../general/specification.md) 进行实验代码编写。
 
 3. 依据 [实验任务](./tasks.md) 完成实验。
-
     - 代码编写任务：观察提供的代码，完善所有标记为 `FIXME:` 的部分，并验证结果是否符合预期。**请在报告中介绍实现思路，截图展示关键结果。**
     - 思考任务：完成 “思考题” 和 “实验任务” 部分的内容，**在报告中简要进行回答**。_注：思考题可能也是理解代码、实现功能的重要提示。_
     - Bonus 加分项：学有余力的同学可以任选 Bonus 部分完成，尝试完成更多的功能，并在报告中进行展示。这部分内容不是必须的要求。