Basalt 任务书 v2(修订版)
依据用户 2026-11-15 决策(方案 B:纯 Limine)修订。仅改动引导相关条款,其余条款原样保留。
修订对照:删除线=原文,加粗=修订后。
系统基本信息
- 系统名:Basalt
- 实现语言:C++ 为主,C 用于底层/ABI 边界,
汇编用于引导与上下文切换 汇编用于 64 位入口桩与未来的上下文切换(M0 仅入口桩)
- 目标架构:x86(32 位与 64 位)为主体;arm64 仅做”兼容预留”,不实现完整功能
引导方式:8086 汇编入口 → 16 位实模式 → 转 32 位保护模式 / 64 位长模式
引导方式:Limine 引导程序完成固件初始化(BIOS/UEFI→16位→32位→64位长模式、页表构建、内核装载);Basalt 自身代码从 64 位长模式入口开始。原任务书中的 8086/16 位切换段由 Limine 而非 Basalt 实现。
引导协议:Multiboot2
引导协议:Limine Boot Protocol(Limine 现行版本已移除 Multiboot2 支持,ADR-002)。
本阶段交付目标(修订后)
引导流程可跑通:8086 汇编入口 → 16 位 → 32 位(及 64 位长模式路径)→ 进入 C/C++ 内核入口
引导流程可跑通:Limine 完成固件引导与模式切换 → Basalt 64 位入口桩 → C/C++ 内核入口。
Multiboot2 头正确,可被支持 Multiboot2 的加载器识别
Limine 请求标记正确(base revision + framebuffer 请求),可被 Limine 识别并装载。
- 内核入口后输出 “hello world”(通道 = framebuffer 主显示 + 调试串口(ADR-003))
- 保留清晰的扩展接口(输出抽象层、内存管理占位、arch/x86 与 arch/arm64 预留、开源组件接入点)——不变
- 提供构建脚本与运行方式说明(工具链:WSL2 + GCC + Make;模拟器:QEMU;镜像:xorriso + Limine 工具,ADR-005)——具体方案已确认
明确不做的事
不变:不做完整内核功能;不实现 arm64 启动;不擅自引入开源项目;不做危险操作(一切运行在模拟器/隔离环境)。
开源配额
- Limine 引导程序本体:运行时外部组件,不计入 25% 配额(与编译器/QEMU 同类,口径沿用原 GRUB 判例)。
limine.h 协议头(vendored 进仓库):计入,BSD-2-Clause,约 350 行,占比 <1%。
- Terminus 字模(转换后的数据文件):计入,SIL OFL 1.1,约 4KiB,占比极小。
- 其余代码 100% 自研。合计远低于 25% 上限。