++ 信号机制
++ PCI 3.0
++ PCIe 1.1 (WIP)
++ Serial ATA AHCI
++ 文件系统
+ + 虚拟文件系统
+ + ISO9660
+ + 原生
+ + Rock Ridge拓展
++ 远程GDB串口调试 (COM1@9600Bd)
++ 用户程序加载与执行
++ 动态链接 (WIP)
++ 通用设备抽象层
++ 通用图形设备抽象层
+ + 标准VGA实现
++ 虚拟终端设备接口(兼容 POSIX.1-2008)
+
+已经测试过的环境:
+
++ QEMU (>=7.0.0)
++ Bochs(SATA功能不支持)
++ Virtualbox
++ Dell G3 3779
+
+## 3. 目录结构
+
+| | |
+| ----------------------------------------- | ---------------------------- |
+| [lunaix-os](lunaix-os/) | LunaixOS源代码 |
+| [slides](slides/) | 视频中所用的幻灯片和补充材料 |
+| [reference-material](reference-material/) | 标准,技术文档和参考文献 |
+
+## 4. 编译与构建
+
+构建该项目需要满足以下条件:
+
++ gcc 工具链
++ make
++ xorriso
++ grub-mkrescue
+
+### 4.1 使用 GNU CC 工具链
+
+正如同大多数OS一样,LunaixOS 是一个混合了 C 和汇编的产物。这就意味着你得要使用一些标准的C编译器来构建Lunaix。在这里,我推荐使用 GNU CC 工具链来进行构建。至于其他的工具链,如llvm,也可以去尝试,但对此我就不能作任何的保证了。
+
+如果你使用的是基于 x86 指令集的Linux系统,不论是64位还是32位,**其本机自带的gcc就足以编译Lunaix**。 当然了,如果说你的平台是其他非x86的,你也可以指定使用某个针对x86_32的gcc套件来进行交叉编译——在`make`时通过`CX_PREFIX`变量来指定gcc套件的前缀。如下例所示,我们可以在任意平台上,如risc-v,单独使用一个面向x86_32的gcc来进行交叉编译:
+
+```
+make CX_PREFIX=i686-linux-gnu- all
+```
+
+由于目前Lunaix仅支持x86_32微架构, `CX_PREFIX` 指向的gcc必须具有针对x86_32架构进行交叉编译的能力。
+
+### 4.2 Docker镜像
+
+对于开发环境,本项目也提供了Docker镜像封装。开箱即用,无需配置,非常适合懒人或惜时者。详细使用方法请转到:[Lunaix OSDK项目](https://github.com/Minep/os-devkit)。
+
+### 4.3 构建选项
+
+假若条件满足,那么可以直接执行`make all`进行构建,完成后可在生成的`build`目录下找到可引导的iso。
+
+本项目支持的make命令:
+| 命令 | 用途 |
+| ------------------------ | ----------------------------------------------- |
+| `make all` | 构建镜像(`-O2`,但禁用CSE相关的优化项 **※** ) |
+| `make instable` | 构建镜像(`-O2`,开启CSE相关优化) |
+| `make all-debug` | 构建适合调试用的镜像(`-Og`) |
+| `make run` | 使用QEMU运行build目录下的镜像 |
+| `make debug-qemu` | 构建并使用QEMU进行调试 |
+| `make debug-bochs` | 构建并使用Bochs进行调试 |
+| `make debug-qemu-vscode` | 用于vscode整合 |
+| `make clean` | 删除build目录 |
+
+**※:由于在`-O2`模式下,GCC会进行CSE优化,这导致LunaixOS会出现一些非常奇怪、离谱的bug,从而影响到基本运行。具体原因有待调查。**
+
+## 5. 运行,分支以及 Issue
+
+### 5.1 虚拟磁盘(非必须)
+
+你可以绑定一个虚拟磁盘镜像,可以使用如下命令快速创建一个:
+
+```bash
+qemu-img create -f vdi machine/disk0.vdi 128M
+```
+
+如果你想要使用别的磁盘镜像,需要修改`configs/make-debug-tool`
+
+找到这一行:
+
+```
+-drive id=disk,file="machine/disk0.vdi",if=none \
+```
+
+然后把`machine/disk0.vdi`替换成你的磁盘路径。
+
+有很多办法去创建一个虚拟磁盘,比如[qemu-img](https://qemu-project.gitlab.io/qemu/system/images.html)。