项目简介SimpleKernel 是由 Simple-XX 团队维护的一个开源操作系统内核项目。与传统教学内核不同它采用Interface-Driven接口驱动​ 的设计理念旨在利用 AI 辅助进行操作系统内核的学习与开发。项目采用 C23 编写支持 x86_64、RISC-V 64 和 AArch64 三种主流架构提供了从引导程序到内存管理、中断处理、任务调度的完整内核组件。该项目的核心思想是“接口即文档”。开发者只需阅读头文件中定义清晰的抽象接口包含详细的 Doxygen 注释理解模块的契约与职责然后利用 AI 工具如 GitHub Copilot、ChatGPT根据接口生成具体的实现代码最后通过项目内置的 GoogleTest 测试套件验证实现的正确性。这种模式将学习者的精力从繁琐的底层编码细节中解放出来聚焦于操作系统核心原理的理解与设计。主要功能多架构支持同一套代码逻辑适配 x86_64UEFI/GRUB、RISC-V 64OpenSBI和 AArch64ATF/OP-TEE架构便于对比学习不同硬件平台的特异性。模块化接口设计定义了完整的抽象基类如ConsoleDriver控制台驱动、SchedulerBase调度器、VirtualMemory虚拟内存管理强制实现与接口分离。AI-First 开发范式头文件中的 Doxygen 注释brief, pre, post直接作为 AI 生成代码的 Prompt极大降低了实现门槛。工程化基础设施基于 CMake 的现代构建系统集成 clang-format/clang-tidy 代码规范检查支持 Docker 一键开发环境内置单元测试与集成测试。核心子系统包含物理内存管理PMM、虚拟内存管理VMM、中断控制器抽象GIC/PLIC/APIC、多任务调度CFS/FIFO/RR、自旋锁与互斥锁、设备树解析FDT、ELF 加载等核心功能。安装与配置环境要求操作系统Linux推荐 Ubuntu 24.04或 macOS。工具链CMake 3.20支持 C23 的编译器GCC/ClangQEMU 模拟器。AI 工具推荐安装 GitHub Copilot 插件或配置 ChatGPT/Claude API。快速搭建Docker 推荐为了规避复杂的交叉编译环境配置项目提供了预配置的 Docker 镜像。克隆项目git clone https://github.com/Simple-XX/SimpleKernel.git cd SimpleKernel git submodule update --init --recursive启动开发容器docker pull ptrnull233/simple_kernel:latest docker run --name SimpleKernel-dev -itd -p 233:22 -v $(pwd):/root/SimpleKernel ptrnull233/simple_kernel:latest docker exec -it SimpleKernel-dev /bin/zsh本地环境备选若选择本地编译需安装对应架构的交叉编译器如riscv64-unknown-elf-gcc及 QEMU。如何使用1. 编译与运行项目使用 CMake Presets 管理不同架构的构建配置。配置构建cmake --preset build_riscv64以 RISC-V 为例。编译内核进入build_riscv64目录执行make SimpleKernel。运行测试make unit-test运行单元测试验证逻辑make run在 QEMU 中启动内核。2. AI 辅助开发工作流这是 SimpleKernel 的核心使用方式以实现一个“控制台驱动”为例阅读接口打开src/driver/include/console_driver.h阅读ConsoleDriver类的纯虚函数定义及 Doxygen 注释理解PutChar和GetChar的契约。AI 生成在对应的.cpp文件如ns16550a.cpp中输入提示词“请根据 ConsoleDriver 接口实现 NS16550A 串口的 MMIO 读写操作”或直接利用 Copilot 自动补全。测试验证运行make unit-test查看测试用例是否通过。若失败根据错误信息修正 AI 生成的代码逻辑。对照参考项目提供了完整的参考实现可在src/driver/下查看用于对比学习。3. 文档生成项目代码注释遵循 Doxygen 规范可生成 HTML 文档便于查阅doxygen Doxyfile应用场景实例实例 1操作系统原理教学与实验场景高校计算机专业《操作系统》课程实验。传统实验要求学生从零编写汇编引导代码极易因环境配置或指针错误卡壳导致无法进入核心原理学习。应用教师要求学生使用 SimpleKernel。学生只需理解SchedulerBase接口中Schedule方法的含义选择下一个运行的任务然后让 AI 生成时间片轮转RR算法的具体代码。学生将重点放在比较 RR 与 CFS完全公平调度算法的优缺点上而非陷入链表操作的调试中。通过修改预设学生可以轻松在 x86 和 RISC-V 两种架构下运行同一套调度逻辑直观感受硬件无关性的设计价值。实例 2嵌入式系统驱动移植场景嵌入式工程师需要为一款新的 RISC-V 开发板移植基础 BSP板级支持包该开发板使用了一款非标准的 UART 芯片。应用工程师参考 SimpleKernel 中已有的Ns16550a标准串口实现基于ConsoleDriver接口编写新驱动的头文件描述寄存器映射关系。随后利用 AI 工具根据新芯片的数据手册自动生成Init、PutChar等函数的 MMIO 操作代码。利用项目内置的 QEMU Virt 机器进行仿真测试快速验证驱动正确性再移植到真实硬件。实例 3内核模块安全审计练习场景安全研究员希望练习操作系统内核漏洞挖掘技能但缺乏一个结构清晰、模块边界明确的靶场环境。应用SimpleKernel 的接口隔离设计使得每个模块如虚拟内存系统的输入输出非常明确。研究员可以专注于VirtualMemory::MapPage接口要求 AI 生成一个存在“权限检查缺失”漏洞的实现例如用户态映射了内核页然后编写测试用例或利用调试器GDB来发现并利用该漏洞。这种“契约-破坏-验证”的循环是高效的安全学习路径。GitHub 地址项目主页https://github.com/Simple-XX/SimpleKernel开源协议MIT License项目状态活跃维护中欢迎提交 Issue 和 Pull Request。