@@ -46,7 +46,7 @@ Unlike traditional OS teaching projects, SimpleKernel adopts an **Interface-Driv
4646| 🌐 ** Three-Architecture Support** | x86_64, RISC-V 64, AArch64 — one set of interfaces adapting to different hardware |
4747| 🧪 ** Test-Driven Verification** | GoogleTest test suites verify whether AI-generated implementations conform to interface contracts |
4848| 📖 ** Complete Doxygen Documentation** | Every interface has responsibility descriptions, preconditions, postconditions, and usage examples |
49- | 🏗️ ** Engineering Infrastructure** | CMake build, Docker environment, CI/CD, clang-format/clang-tidy |
49+ | 🏗️ ** Engineering Infrastructure** | CMake build, Dev Container environment, CI/CD, clang-format/clang-tidy |
5050
5151## 🤖 AI-Oriented Design Philosophy
5252
@@ -204,29 +204,33 @@ SimpleKernel's interfaces are organized into the following layers:
204204### 📋 System Requirements
205205
206206- **Operating System**: Linux (Ubuntu 24.04 recommended) or macOS
207- - **Container Engine**: Docker 20.10 +
208- - **Toolchain**: Included in Docker image (GCC cross-compilers, CMake, QEMU, etc.)
207+ - **Container Engine**: Docker or compatible container runtime
208+ - **Toolchain**: Included in Dev Container (GCC 14 cross-compilers, CMake, QEMU, etc.)
209209- ** AI Tools (recommended)** : GitHub Copilot / ChatGPT / Claude
210210
211211### 🛠️ Environment Setup
212212
213- ** Option 1: Using Docker (Recommended)**
213+ ** Option 1: Using Dev Container (Recommended)**
214214
215215``` shell
216216# 1. Clone the project
217217git clone https://github.com/simple-xx/SimpleKernel.git
218218cd SimpleKernel
219- git submodule update --init --recursive
220219
221- # 2. Start development environment
222- docker pull ptrnull233/simple_kernel:latest
223- docker run --name SimpleKernel-dev -itd -p 233:22 \
224- -v $( pwd) :/root/SimpleKernel ptrnull233/simple_kernel:latest
220+ # 2. Open in VS Code and reopen in container
221+ # Install Dev Containers extension, click the >< icon at bottom-left
222+ # Select "Reopen in Container"
225223
226- # 3. Enter development container
227- docker exec -it SimpleKernel-dev /bin/zsh
224+ # Or use CLI
225+ npm install -g @devcontainers/cli
226+ devcontainer up --workspace-folder .
227+ devcontainer exec --workspace-folder . bash
228228```
229229
230+ > Also supports ** GitHub Codespaces** : Click Code → Codespaces → Create codespace on main
231+ >
232+ > See [ Dev Container documentation] ( ./docs/docker.md ) for details.
233+
230234** Option 2: Local Environment**
231235
232236Refer to [ Toolchain Documentation] ( ./docs/0_工具链.md ) for local development environment setup.
@@ -411,7 +415,7 @@ subject: max 50 chars, no period
411415- ** System Boot** : [ docs/1_系统启动.md] ( ./docs/1_系统启动.md )
412416- ** Debug Output** : [ docs/2_调试输出.md] ( ./docs/2_调试输出.md )
413417- ** Interrupts** : [ docs/3_中断.md] ( ./docs/3_中断.md )
414- - ** Docker ** : [ docs/docker.md] ( ./docs/docker.md )
418+ - ** Dev Container ** : [ docs/docker.md] ( ./docs/docker.md )
415419- ** Interface Refactoring Plan** : [ docs/TODO_interface_refactor.md] ( ./docs/TODO_interface_refactor.md )
416420
417421## 🤝 Contributing
0 commit comments