Linehu b76e8f1556 feat: U2 UTRW slow path real branches
- slow_path.c: KEY_MISS -> PCKC re-derive (retry OK); EPOCH -> refresh cap epoch via out_cap (retry OK); STALE_CAP permanent; MAC_FAILED/POISONED -> PCKC invalidate + DRR fault report; RETRY passthrough
- status.h: add UTSM_ERR_MAC_FAILED (-11); utrw.h: slow path takes cap/rights/offset/len/reason + out_cap
- selftest: EPOCH refresh + KEY_MISS re-derive + POISONED passthrough coverage, full SELFTEST PASS in QEMU (.build_tmp/qemu_serial_u2slowpath.log)
2026-10-02 14:29:28 +08:00
2026-08-09 22:20:01 +08:00
2026-08-09 22:20:01 +08:00

Deshab-OS

实验内核 · QEMU 可启动演示 · 非生产系统

Deshab-OS 是一个从零编写的独立 64 位操作系统,基于 x86_64 long mode,采用单地址空间 Ring0(SAS-R0)内核架构,配套封缄内存(UTSM)、专用恢复根(DRR)与可加载驱动模块系统(DKM)。

当前已完成可启动的实验内核闭环:Limine 引导 → UTSM 首阶段内核 → 14 个 DKM 驱动加载 → DSK 主内核 → 桌面/登录/向导。

核心架构

SAS-R0-PCQ  单地址空间 Ring0 + Per-CPU O(1) 位图调度器(当前 BSP-only)
UTSM        UUID 调谐封缄内存(明文须经 UTRW 读写器)
UTRW        带标记读写器(Fast Path ✅ / Slow Path ⬜)
DRR         专用恢复根(看门狗 / checkpoint / A-B 回滚 / 独立 Emergency Pool)
DKM         驱动模块系统(ELF64 .drv ABI,4 stage 分阶段加载)

项目状态

唯一状态源见 docs/STATUS.md,本表只是引用摘要。

子系统 状态
早期启动 / IRQ / DMA / DKM 14 驱动 ✅
UTSM 封缄(Fast path + selftest) 🔶
AHCI / e1000 / FAT32 写盘 ✅
NVMe / virtio-net / FAT32 完整路径 🔶
PCQ 调度器 / DRR 恢复根 ✅(BSP-only / 演示级)
Five-Phase 填补计划 见 docs/ROADMAP_INSANE.md

已知边界(Non-Goals)

  1. 无进程隔离:SAS-R0 单地址空间 Ring0,驱动 bug = 内核全盘崩。这不是安全 OS,是敞开工坊。
  2. UTSM 仅 selftest 覆盖:封缄是"设计意图 + 演示级实现",不是机密计算。
  3. 驱动为演示级:QEMU 能演示 ≠ 真机可依赖;NVMe/virtio-net 尚未走完数据路径。

文档

文档 内容
STATUS.md 单一状态源(全子系统三色表 + 证据)
ROADMAP_INSANE.md 五期填补计划(F/U/D/R/E 唯一任务编号)
TASKBOARD.md 可勾选任务表
PHILOSOPHY.md 疯圣典:矛盾美学与「疯但好使」物理学
ARCHITECTURE.md 架构设计 + 非目标章
BOOT_SEQUENCE.md B0-B4 五阶段启动序列(演示版)
ROADMAP.md Phase 0-9 历史存档 + 用户态主线
CONTRIBUTING.md 开发环境、代码规范、Git 工作流
CLAUDE.md 项目当前状态与下一阶段路线
LESSONS_LEARNED.md 开发经验与教训

构建

⚠ 当前构建仅支持 Windows(build.ps1 + WSL mkfs.vfat/mkfs.ext4),跨平台构建见 ROADMAP_INSANE F3。

# 需求:LLVM Clang + ld.lld + Python/Pillow + QEMU + WSL(mkfs)
.\build.bat          # 构建 utsm.elf + deshab.elf + 14 个 .drv + ISO/deshab.img
.\build.bat -Variant dev      # 开发者模式(自动跑 shell 测试,调试全开)
.\build.bat -Variant release  # 发布版(进桌面+登录)
.\ISO\run_qemu.bat   # QEMU UEFI 启动验证(串口输出到 stdio)

"Deshab 不假装安全,只声明边界;不假装完成,只标⬜。" 🪷

S
Description
Deshab-OS 项目仓库
Readme Apache-2.0
710 MiB
Languages
C 99.2%
Shell 0.4%
PowerShell 0.1%
Python 0.1%