Operating Systems and Virtualization Workspace

TGOSKits面向系统软件研发的一体化工作区

汇聚 ArceOS、StarryOS、Axvisor 与共享组件栈，在同一仓库中组织系统内核、虚拟化、平台适配、测试验证和构建自动化，形成连贯的工程开发入口。

阅读概览开始上手 GitHub

项目概览快速开始构建系统组件视图

3核心系统

140+共享组件

4主流架构

xtask统一命令入口

workspace shell

$ cargo xtask arceos qemu --package ax-helloworld --target riscv64gc-unknown-none-elf
[ArceOS] Hello, world!

$ cargo xtask starry rootfs --arch riscv64
$ cargo starry qemu --arch riscv64
[StarryOS] shell started.

$ cargo axvisor defconfig qemu-aarch64
$ (cd os/axvisor && ./scripts/setup_qemu.sh arceos)
$ cargo axvisor qemu --config os/axvisor/.build.toml
[Axvisor] Guest[0] ArceOS running.

Core Capabilities

围绕系统软件工程构建统一能力面

首页首先回答项目能做什么，以及这些能力如何在同一工作区里被组织和使用。

统一入口

围绕根目录文档与 tg-xtask 组织日常开发入口，降低系统间切换成本。

组件共享

基础能力以独立 crate 组织，被多个系统路径复用，职责边界更清晰。

安全实现

以内存安全为优先，围绕 Rust 构建可维护的系统软件组件与接口。

多架构支持

围绕 riscv64、aarch64、x86_64、loongarch64 形成可迁移的构建与验证链路。

构建闭环

从配置、构建、镜像生成到 QEMU 运行与快照管理形成完整流程。

验证体系

从 host 侧测试到系统级运行验证，覆盖组件、系统和平台多个层面。

Architecture

从组件层到系统层，信息结构保持稳定且可推导

这一部分强调仓库的层次化结构，让首次进入项目的读者能快速建立整体心智模型。

统一工作区不只是把仓库放在一起

TGOSKits 将共享组件、系统实现、平台适配、测试套件和构建脚本放进同一个演进视角中，使“改动会影响哪里”“该从哪个入口验证”这类问题更容易回答。

components/*可复用基础组件层

os/*系统与虚拟化实现层

platform/*平台适配与板级支撑

test-suit/*系统级验证与回归

查看项目概览浏览仓库结构

Systems

三条系统路径，共享组件基础但面向不同开发目标

这里不是简单罗列子项目，而是帮助读者区分三条路径各自的职责、关注点与进入方式。

模块化内核路径，是多个系统能力向上复用的基础层。

聚焦模块、平台和示例应用
适合理解基础能力如何组合成系统
也是 StarryOS 与 Axvisor 的底座之一

进入指南

建立在 ArceOS 之上的 Linux 兼容系统，强调内核与 rootfs 联动。

覆盖 syscall、进程、信号等核心语义
包含 rootfs 与用户态验证路径
适合完整 OS 路径开发与调试

进入指南

Type-I Hypervisor 路径，围绕板级配置、VM 配置和 Guest 镜像组织开发流程。

覆盖 VM、vCPU、虚拟设备与地址空间抽象
强调虚拟化组件与板级能力协作
适合系统与虚拟化联合验证

进入指南

Getting Started

首页即入口，阅读顺序与命令顺序相互对应

这一部分将文档阅读、系统启动和验证动作串成一条连续路径，降低第一次进入项目时的决策成本。

建立仓库心智模型

先阅读 overview、repo 等文档，明确系统层、组件层和平台层之间的关系。

跑通最短命令路径

从 quick start 或目标系统指南入手，把本地构建和 QEMU 运行路径先打通。

深入设计与验证

进入 architecture、build、test、guest config 等文档，理解底层设计和验证策略。

高频命令路径

cargo xtask arceos qemu --package ax-helloworld --target riscv64gc-unknown-none-elfcargo xtask starry rootfs --arch riscv64cargo axvisor defconfig qemu-aarch64cargo xtask clippy

构建系统说明验证策略构建流程

Documentation Map