# 真实 XFEConsole 控制台示例

本项目直接引用 NuGet `XFEExtension.NetCore.XFEConsole` **2.6.0**，通过 `Packages.lock.json` 固定传递依赖 `XFEExtension.NetCore` **5.2.0** 及内容哈希，不提供冒名替代包。

共享业务入口供标准程序和裸机 NativeAOT 集成共同调用：

```csharp
ConsoleDemoScenario.Run(Console.Out);             // 真实包生成 ANSI，确定性文本/颜色场景
ConsoleDemoScenario.RunSystemConsoleColors();     // 真实 Console.ForegroundColor/BackgroundColor/ResetColor
ConsoleDemoScenario.RunXfeConsoleApi(Console.Out); // 真实 XFEConsole.WriteLine
```

`Run` 包含 RGB、256 色、ConsoleColor→ANSI、粗体/下划线、重置、回车/退格/清行/光标移动与中文。成功标记为 `XFE_CSHARP_CONSOLE_DEMO_OK`。`RunXfeConsoleApi` 临时连接指定 `TextWriter`，恢复原全局状态，不打开远程连接；该 API 的包实现包含远程输出分支，裸机 AOT 链必须实际验证所需导入。

`Samples/XFESystem.ConsoleDemo` 的普通入口直接调用以上三条路径。`--Verify Report.json` 捕获实际包生成的输出，逐字符送入真实终端解析器，检验文字、每行颜色、样式与重置，并生成报告。文本重定向不能证明宿主 `Console.ForegroundColor` 产生了屏幕颜色，因此报告明确将 PAL 单列为待原生控制台/guest 验证。

该包 2.6.0 仅包含 `lib/net10.0`，无法被 `.NET Framework 4.8` 直接引用；本阶段不提供 net48 程序或兼容性承诺。

宿主验证：

```powershell
dotnet run --project Samples/XFESystem.ConsoleDemo -- --Verify build/CSharp/ConsoleDemo/HostVerification.json
dotnet publish Samples/XFESystem.ConsoleDemo -c Release -r win-x64 -p:PublishAot=true -o build/CSharp/ConsoleDemo/WindowsNativeAot
build/CSharp/ConsoleDemo/WindowsNativeAot/XFESystem.ConsoleDemo.App.exe --Verify build/CSharp/ConsoleDemo/WindowsNativeAotVerification.json
```

Windows NativeAOT 运行属于宿主验证；编入内核后的 QEMU 实际运行属于静态 AOT 应用验证，均不等价于完整 CoreCLR 或独立 `.dll` 装载支持。