> 历史 Cosmos 预览说明，保存的是独立内核迁移前的能力和验收范围。默认路径已改为本项目自研裸机内核与官方 Microsoft NativeAOT，见 [当前 README](../README.md) 和 [独立内核说明](IndependentKernel.md)。旧 Cosmos 内核须显式使用 BuildCosmosKernel.ps1 或 XFESystem.Legacy.slnx。下文命令仍从仓库根目录运行；本文链接已按 docs/ 所在位置修正。旧网络、后台编辑器、WHPX 和历史性能结果不能作为新路径通过证据。

# XFESystem

XFESystem 当前开发分支使用 **C# 自研裸机内核和桌面**，解决方案为 [XFESystem.Legacy.slnx](../XFESystem.Legacy.slnx)。内核通过 Cosmos 3.0.94 / NativeAOT 编译为 ELF，经 UEFI、C# 显示初始化助手和 Limine 引导。来宾没有使用 Linux、Windows、Chromium 或宿主 WebView 代替内核或浏览器。

当前 C# 开发预览仅支持 **x86_64、QEMU q35、UEFI、单 CPU**。完整网页与 Monaco 验收使用 **1 GiB RAM**；旧版其他架构和 512 MiB 记录不代表当前实现通过。默认深色主题，终端前景为 `#75C9F5`、背景为 `#0C1321`。实体硬件兼容和完整 .NET 环境仍在移植。

## 当前实现

- 桌面、任务栏、文件管理器、编辑器、终端和 Settings；窗口拖动、缩放、最小化、关闭、双击最大化及 Win / Alt+Tab 等快捷键。
- Windows 风格系统路径；文件和设置保存在 RAM 会话，关机后消失。
- 自研 CSS 级联、有限布局、字体光栅化、DOM 事件和绘制；AngleSharp 解析 HTML，Jint 执行有预算的 JavaScript，原生 HTTP 经来宾网络适配器访问受控服务。
- Markdown 使用指定 XFEStudioWebSite 的渲染策略、原字节 CSS/JS；Monaco 使用真实 0.52.2 核心。C# 着色通过显式适配器复用网站 highlight.js 语法和 CSS 调色板。
- 受限的 `.NET 10 ConsoleIL` 程序执行层，示例实际调用 `XFEExtension.NetCore.XFEConsole` 与 ANSI/控制台颜色接口；这不等于完整 CoreCLR 或任意 .NET 程序兼容。

**首次完整预览小于 1 秒、真正 CUDA 和 GPU 光栅化尚未通过验收。** 当前实际绘制仍为 CPU framebuffer。PCI 发现、EDID 刷新率、WHPX/TCG 和宿主显卡均不能作为 GPU 成功证据。原生移植缺项见 [CUDA 移植状态](NativeCudaPort.md)，后端选择及证据要求见 [渲染后端](CSharpRenderBackends.md)。每轮实际通过项目、耗时与剩余问题以对应 `Validation` 报告为准。

C# 文件的独立 worker、源文件首帧与 Monaco 交接设计见 [后台编辑器](CSharpBackgroundEditor.md)。NVIDIA 原生命令编码、映射提交和完成信号组件见 [GPU 协议工具](../Tools/Gpu/Readme.md)；该组件当前未接入桌面，离线测试不能代替真实 GPU/CUDA 执行验收。

本轮窗口、光标缓存、后台编辑响应及未完成验收项目见 [2026-10-15 开发进度](../Validation/CSharp-BackgroundEditor-20261015.md)。

## Windows 构建与验收

需要 Windows x64、[global.json](../global.json) 固定的 .NET SDK、PowerShell 5.1 或更新版本、Python/Pillow，以及已核验的 QEMU、EDK2、Limine、LLVM 和 bflat。原生工具来源与哈希见 [工具锁定](../tools-lock.json)、[C# 依赖锁定](../Tools/CSharpBoot/Dependencies.json) 和各项目 `Packages.lock.json`。`scripts/fetch-deps.ps1` 按锁文件下载和解包基础工具；不运行 QEMU 安装器。独立宿主网页对照另需 Node.js 和 Edge/Chrome。

在仓库根目录执行：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\Tools\CSharpBoot\BuildBootShim.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\Tools\CSharpBoot\BuildCosmosKernel.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\Tools\TestCSharp.ps1 -BrowserDom
```

`BuildBootShim.ps1` 构建 [C# UEFI 助手](../Source/XFESystem.Boot/EfiEntry.cs)，显示交接与模式策略位于 [DisplayContracts.cs](../Source/XFESystem.Boot/DisplayContracts.cs)。`BuildKernel.ps1` 使用锁定 NuGet 依赖并执行项目所需 NativeAOT 运行时修补。宿主测试生成独立输出；测试通过不等于来宾启动或实体硬件通过。

使用真实 QEMU 来宾验收桌面，以及外部脚本/事件/Monaco 管线：

```powershell
python .\Tools\CSharpBoot\TestBoot.py --resolution 3840x2160 --desktop-ui --desktop-v4 --memory-mib 1024 --accel tcg
python .\Tools\CSharpBoot\TestBoot.py --resolution 3840x2160 --browser-pipeline --memory-mib 1024 --accel tcg
python .\Tools\CSharpBoot\TestBoot.py --resolution 3840x2160 --preview-performance --memory-mib 1024 --accel tcg
python .\Tools\CSharpBoot\TestBoot.py --resolution 3840x2160 --document-first-paint --memory-mib 1024 --accel whpx --display-backend sdl
python .\Tools\CSharpBoot\TestBoot.py --resolution 3840x2160 --editor-responsiveness --memory-mib 1024 --accel whpx
```

每次结果写入新的 `build/CSharpBoot/Proof-*` 目录，包含 `System.img`、`Result.json`、串口日志、原生截图、镜像/内核/源码哈希及 QEMU 清理结果。失败记录保留，不能混用不同镜像或内存配置的通过记录。性能验收通过真实点击测量预览，输入发送速率不能充当可见 FPS。

## 打开实际测试窗口

从上述目录选取本轮 **TCG 验收通过** 的 `Result.json`，将示例中的目录编号替换为真实值：

```powershell
$proof = '.\build\CSharpBoot\Proof-实际编号'
powershell -NoProfile -ExecutionPolicy Bypass -File .\Tools\OpenCSharp.ps1 -ImagePath "$proof\System.img" -VerifiedBootResult "$proof\Result.json" -QemuPath ".\.tools\qemu\qemu-system-x86_64.exe" -Acceleration tcg
```

启动器核对镜像与验收记录，创建独立镜像及固件变量副本，并打开 QEMU 操作窗口。默认最大化并适配整个桌面；宿主视口缩放与来宾原生分辨率、界面倍率分别处理。Win / Alt+Tab 等快捷键需要 QEMU 捕获键盘，可按窗口提示切换捕获。

本机 WHPX+GTK 的固件启动未通过，WHPX+SDL 实际可见桌面已启动成功。可显式使用 `-Acceleration whpx -DisplayBackend sdl`；SDL 使用 `gl=off`，`-NativePixels` 仅适用于 GTK。WHPX/SDL 均不代表来宾 GPU/CUDA 加速。首次正文和增强脚本就绪分别计时，`--document-first-paint` 的首帧扫描缓冲指纹必须与 QMP 截图一致；TCG 与 WHPX 的结果分别报告。

发行包使用 `Tools/PackageCSharp.ps1` 打包已验证镜像、宿主结果和总报告；已有目录与 ZIP 保留。解压已验收包后运行其中的 `Start.ps1 -QemuPath <路径>`。源码改动后的新镜像须重新验收，历史包不能为新源码提供通过结论。

## 尚未完成

完整 CoreCLR/.NET 10、Framework 4.8、JIT、任意 C# 程序兼容、独立用户进程隔离、持久化文件系统和账号权限仍未完成。浏览器为有限实现；原生 HTTPS/TLS、Worker、完整语言服务、WebAssembly、完整 CSS/SVG/数学/Mermaid 绘制尚未完成。字体实际回退与网站截图存在差异，不能宣称整站逐像素一致。

当前桌面为单输出；实体 USB 键鼠、多屏、GPU 模式设置、VSync 和持续 240 Hz 可见呈现尚未验收。专用 U 盘的自动更新及 Git 提交推送遵守 [AGENTS.md](../AGENTS.md)；C# 开发预览不能冒充已通过实体介质验收的版本。

后台编辑器的短时响应检查通过后，更长的可见窗口交互仍在最终镜像上触发了来宾 OOM 停止，持续运行稳定性未通过。首次加载响应改善不表示内存耗尽或浏览器内连续编辑故障已经解决。

历史发行包、截图和验收报告保留在 `dist/`、`Validation/` 和 Git 历史；当前工作树不再提供旧语言的内核构建入口。较早 C# 说明中的阶段性实现也应结合对应镜像阅读。网站资源与截图对照方法见 [浏览器预览说明](CSharpBrowserPreview6.md)，第三方版权和许可证见 [THIRD_PARTY.md](../THIRD_PARTY.md)。