# rCoreOS

**Repository Path**: yinglichina/rCoreOS

## Basic Information

- **Project Name**: rCoreOS
- **Description**: 采用 rCore 的 RISC-V 架构的 RustOS，进行操作系统的学习。
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rCoreOS - 基于 RISC-V 与 Rust 的操作系统实践课程

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/rust-1.70%2B-orange.svg)](https://www.rust-lang.org)
[![RISC-V](https://img.shields.io/badge/arch-RISC--V-green.svg)](https://riscv.org)
[![AI Powered](https://img.shields.io/badge/AI-OpenClaw-purple.svg)](https://openclaw.ai)

## 📖 项目简介

本项目是**贵州民族大学软件工程专业**《操作系统原理》课程的配套实践框架。课程采用 **Rust 语言**与 **RISC-V 架构**，参考业界领先的教学内核 `rCore-Tutorial` 与 `blog_os`，引导学生在 **QEMU 模拟器**上从零构建一个微型操作系统内核。

课程最大的特色是首创 **“AI 赋能的三阶段教学法”**（自动档 → 手动档 → 修车技能），借助大模型与 AI Agent 技术（如 OpenClaw），大幅降低环境配置与早期开发的门槛，让普通本科院校，甚至零基础的高中学生也能**先跑通、再理解、最后深入底层**，获得真实可用的系统级开发与调试能力。

## ✨ 课程特色与理念

### 🏎️ AI 赋能的三阶段学习路径

| 阶段 | 名称 | 周期 | 核心目标 | 教学形式 |
| :--- | :--- | :--- | :--- | :--- |
| **第一阶段** | **🚗 自动档** | 第1-6周 | 建立信心，激发兴趣 | 通过自然语言指令驱动 OpenClaw，一键部署环境、生成代码、在 QEMU 中运行，体会创造的乐趣。 |
| **第二阶段** | **🕹️ 手动档** | 第7-12周 | 理解原理，掌握核心 | 切换至 VS Code，手动替换 AI 生成的“黑盒”代码，实现内存管理、进程调度等核心模块。 |
| **第三阶段** | **🔧 修车技能** | 第13-18周 | 培养分析、调试与解决复杂问题的能力 | 主动制造 Bug，学习使用 GDB 连接 QEMU 进行汇编级调试，追踪系统调用与异常。 |

这种“先会用、再深入、后懂 Why”的路径，旨在最大化激发学生潜能，确保 **80% 以上的学生能够跟上并完成一个完整的内核**。

## 🚀 快速开始

### 环境要求

- **操作系统**：Ubuntu 22.04+ (推荐使用 WSL2 或原生系统)
- **AI 助手**：[OpenClaw](https://openclaw.ai) (可选，用于体验“自动档”教学)

### 一键部署（推荐）

我们为学生提供了基于 OpenClaw 的自动化环境部署方案。在配置好 OpenClaw 后，只需下达指令：

> `@OpenClaw 请使用 os-dev-env 技能，为我部署 RISC-V 操作系统开发环境。`

AI 将自动安装 Rust 工具链、QEMU 模拟器、RISC-V 交叉编译目标以及拉取本实验框架代码。

### 手动安装（传统方式）

若不使用 AI 助手，也可通过以下脚本手动配置：

```bash
# 1. 克隆仓库
git clone https://gitee.com/your-org/rcore-os.git
cd rcore-os

# 2. 运行环境安装脚本
chmod +x scripts/setup.sh
./scripts/setup.sh

# 3. 编译并运行第一个内核
cd os-kernel
cargo run

📚 教学大纲与目录结构
text
.
├── docs/                 # 理论课程讲义与 PPT
├── labs/                 # 每周上机实验指导书
│   ├── lab1/             # 第1周：环境配置与 Hello World
│   ├── lab2/             # 第2-3周：Rust 语法练习
│   └── ...
├── os-kernel/            # 操作系统内核源码 (逐步迭代)
│   ├── stage1-auto/      # 第一阶段：AI 辅助生成的参考实现
│   ├── stage2-manual/    # 第二阶段：手动编写的核心代码
│   └── stage3-debug/     # 第三阶段：用于调试分析的内核
├── tools/                # OpenClaw Skills 定义、GDB 脚本等工具
├── scripts/              # 环境安装与构建脚本
└── README.md
🎯 考核与评价体系
课程采用 “重过程、轻考试” 的多元评价机制：

考核项	权重	说明
基础实验完成度	70%	包含前12周的分阶实验。要求提交代码 + 人机对话日志（若使用AI） + 实验报告。设置“AI代码解释红线”，无法解释原理则判定不合格。
期末分组项目	20%	3-4人一组，选题涵盖文件系统添加、真机移植或应用开发，重点考察创新与协作。
课堂参与	10%	鼓励提问、分享及在 Gitee Issues 中的讨论贡献。
🤝 贡献指南
欢迎提交 Issue 和 Pull Request 来完善本项目：

发现问题：在 Gitee Issues 中提交详细问题描述。

贡献代码：Fork 本仓库，创建新的分支进行修改，随后提交 PR 至 develop 分支。

文档优化：对讲义、实验指导书的任何改进建议都极具价值。

📄 许可证
本项目源码与文档遵循 GPL License 3.0 开源协议。 教学项目必须彻底开源，而且禁止不道德的，偷窃式的使用方式。

顺便鄙视一下 Hermes Agent，直接利用 国内 Eva

🙏 致谢与参考
理论框架与实验设计参考：rCore-Tutorial-Book 第三版： https://rcore-os.cn/rCore-Tutorial-Book-v3/

x86_64 架构 Rust OS 教程参考：Writing an OS in Rust：https://os.phil-opp.com/

AI 工作流设计受 OpenClaw Community（https://openclaw.ai/） 启发。

本教程的编写和开发，使用了 Deepseek 的 WebUI， Minimaxi 的 极速版 Max Coding Plan 的支持，以及  OpenClaw 和 OpenCode 的工具支持，在此表示感谢！

信息平权，AI 平权 和 低价优质的算力是 AI 时代教育的动力源泉，目前国内的环境已经为我们开启了无限可能的广阔新世界，我们一起进行自由的探索吧！