XFESystem 用户约定
每轮完成后提交并推送
用户于 2026-10-14 明确要求：每次改动完成后都要记得推送。每轮完成相关构建和验收后，将本轮改动及其必要依赖提交并推送到对应开发分支，无需再次确认。不得将失败、未执行的检查声称为通过；保留无关的本地改动，不提交凭据、编译输出或临时测试产物。推送失败时保留本地提交并说明实际原因，不强制推送或覆盖他人的提交。
每版自动更新专用启动 U 盘
用户于 2026-10-14 明确要求：每一版都要记得自动写入 U 盘。这是本项目持续有效的授权和交付流程；每版完成构建与验收后，自动将已验证的 x86_64 中文 RAM live 镜像更新到下述专用启动 U 盘，无需再次询问是否更新同一设备。
已确认的目标身份：
- USB 总线，序列号
230222336207。 - 正常 UniqueId：
5000000000002AEF。 - 历史正常容量：
256060514304字节；逻辑扇区 512 字节。用户后续明确取消与历史容量完全相等的要求；实际可写空间仍必须足以容纳完整镜像。 - 硬件显示名为
lankxin T.Pssd USB 3.2；用户希望称其为 XFEstudio。 - 磁盘编号和盘符可能变化，不能仅按
J:、卷标或磁盘编号选择目标。
写入前必须重新核对完整目标身份、源镜像 SHA256、已通过的发行镜像验收记录及现有分区；拒绝任何系统盘、启动盘、身份不符或无法容纳镜像的设备。容量只作为寻址边界和 GPT 几何计算依据，不因为与历史容量不完全相等而再次向用户确认。使用项目已有 scripts/physical-media.ps1 的磁盘专用计划/校验令牌及安全写入流程。写后核验完整镜像（考虑实际容量导致的 GPT 几何调整）和实际末尾的备份 GPT，关闭句柄，保留离线状态和日志。保留所有既有发行目录及 ZIP，不覆盖旧版产物。
设备曾间歇性显示为 262144 字节、UniqueId 5001FF20564C4900、RAW。用户要求尽量直接重写、避免每次手动拔插。可以先核对同一序列号和精确 USB 存储父节点，仅重启这只设备的驱动栈以尝试恢复；不得重启整个 USB 控制器、根集线器或其他设备。精确存储节点历史值为 USB\VID_2109&PID_0715\MSFT30230222336207，操作前验证当前父子关系。若实际只能寻址 256 KiB，就无法写入 256 MiB 镜像，应记录技术失败，不能只覆盖开头后谎报成功，也不能通过格式化或刷固件绕过边界。自动恢复不成功时再说明需要物理重新连接。
2026-10-14 定向设备重启返回 Windows 退出码 3010（需要重启系统后完成），只读 IOCTL_DISK_GET_LENGTH_INFO 也返回 262144 字节。不要将 3010 当作即时恢复成功，不得为自动更新 U 盘擅自重启宿主电脑。记录在 build/usb-media/XFEstudio-0.2.0-dev.2-1791926174494/recovery-result.json；待用户物理重新连接或自行重启后继续核验并写入。
随后用户重新插入，设备恢复正常。已成功写入并完整校验 x86_64 / 中文 RAM live / 0.2.0-dev.2，当时保持离线。完成记录：build/usb-media/XFEstudio-0.2.0-dev.2-write-1791926820235/completion.json。前述待写记录已由同目录 resolved-by-write.json 标记解决。
2026-10-14 最新已自动更新为 x86_64 / 中文 RAM live / 0.2.0-dev.3。源镜像 SHA256 c6fd067fd2b99bd121b908b397d77eb078346c9858dba8be4ddf849055457d32，实际容量 GPT 调整后的完整镜像 SHA256 967f37e0ace921c37f2cfd93e4b01bc06bff678392a7076dfe74549c558debe5；完整 256 MiB 及真实末尾备份 GPT 校验通过，辅助进程退出、句柄关闭，当前 U 盘保持离线。本次容量正常，无需拔插或重启设备。完成记录：build/usb-media/XFEstudio-0.2.0-dev.3-write-1791929195597/completion.json。下一版继续同一安全流程自动更新。
写入系统镜像不等于刷写 U 盘、键盘或主板固件。该自动更新授权只适用于上述专用启动介质，不适用于内置磁盘或其他 USB 设备。
辅助脚本兼容 Windows PowerShell 5：读取 UTF-8 JSON 时显式使用 Get-Content -Raw -Encoding UTF8，避免中文字段被按 ANSI 解码导致 JSON 失效。分区盘符的 null 与 NUL 字符使用语义比较，不能直接比较不同 PowerShell 版本序列化的 JSON。写前编码/解析失败仍须保留独立日志，修复后使用新的结果文件名重试。
2026-10-15 用户再次要求写入 U 盘后，已更新同一专用设备为 x86_64 / C# RAM-only 实验镜像。使用 CSharpExperimental128 安全流程，源镜像 SHA256 667a11784dfecda7664c5f64e4ea90fe4d14f6a2ac9cfb2ab85a0aa0324501e5；容量调整后的完整镜像 SHA256 d3088024debdc0bb7076f474801bedfc99a5f0c65827338e3fd01521ec782436。完整 128 MiB 回读及真实末尾备份 GPT 校验通过，辅助进程退出，句柄关闭，U 盘保持离线。完成记录：build/usb-media/XFEstudio-CSharp-1792007708404/Completion.json；可提交摘要：docs/validation-results/CSharpUsbExperimental20261015.json。这份启动实验镜像尚未通过完整稳定性、实体输入兼容或 CUDA/GPU 验收，不得标记为完整发行版；其源码绑定配置关闭存储，文件在内存中，关机不保留。
2026-10-15 用户报告实体启动停在近似 [Kernel] … chars 后，已更新同一 U 盘为 C# RAM-only 启动诊断版：修复 x64 串口无限等待，添加 B00–B99 屏幕启动阶段及普通启动失败原因。92 项 IL 检查、QEMU 正常串口启动、无串口设备的连续两帧桌面检查通过；实体故障根因仍未知，等待用户复测，不得声称实体启动已修复。源镜像 SHA256 6a6de06d471ca25fab53b4c13d95ac18fa3d7500cbf4000c0b91e668f23b8ce6，容量调整后的完整镜像 SHA256 8bd7f07abc9334f28d60388251a2919e0c9f6b8cd1ce85fd6392670bb4422b43。完整 128 MiB 与真实盘尾 GPT 校验通过，句柄关闭、辅助进程退出、保持离线。记录：build/usb-media/XFEstudio-CSharp-BootFix-1792008935142/Completion.json；摘要：docs/validation-results/CSharpPhysicalBootDiagnostics20261015.json。本轮未改动 EFI 源文件，保留其原有本地换行差异。完整稳定性、实体输入和 CUDA/GPU 验收仍未完成。
2026-10-15 用户照片显示周期 LAPIC/STRIDE 输出后，已在 QEMU 8 CPU 配置复现旧镜像的线程合约失败，并修复“发现全部 CPU 却只启动 BSP”的调度数量错误。当前仍只执行一个 CPU；保留 ACPI 枚举，两个 IRQ 调度入口统一逻辑索引 0，移除正常周期中断打印，启动诊断提前到 A00，网络初始化移到首帧后的独立线程。117 项运行时、41 项平台、19 项等待逻辑检查通过；同一新镜像通过 QEMU 8 CPU、单 CPU 无网卡、8 CPU 无串口三种启动检查。实体机仍待复测，不能据此声称实体启动已验收。专用 U 盘已更新并完整校验：源 SHA256 60b9e277ed6aef7e7a44aadac99e4af099dcf9818ac8cbb84d0394878fa7cd3b，容量调整后 SHA256 ee1fca1e28b5e367582d6444e506b5d06ef2395f99a4e859d27f5dba34303bc1；真实盘尾 GPT 通过，句柄关闭、进程退出、保持离线。记录：build/usb-media/XFEstudio-CSharp-MulticoreFix-1792012187587/Completion.json；摘要：docs/validation-results/CSharpMulticoreBoot20261015.json。仍是 RAM-only 实验版，不包含完整稳定性或 CUDA/GPU 验收；DHCP 内部等待自身仍没有完整恢复保证。
2026-10-15 默认入口已迁移为 自研 C# 独立裸机内核 / 官方 Microsoft .NET 10 NativeAOT / RAM-only / 0.3.0-dev.1，Cosmos 仅保留显式 Legacy 入口。37 项平台与 133 项原生契约等合计 14 组、1,137 项宿主检查通过；强化 Probe 的 GC/EH/弱引用/终结器/线程/Monitor/TLS/压缩 GC 根检查通过。同一完整应用镜像通过 QEMU 1/8 虚拟 CPU 强 GUI 验收（实际执行仍为 BSP 1），含真实 PS/2、RAM 保存重开、JS DOM 12、Monaco 实际字形/颜色及第四行键盘编辑新像素、ConsoleIL 与 ANSI/XFEConsole。完整 runtime、编译器、bflat Zero、musl、Limine、LunarFonts 和浏览器资源仍是外部引用，不称自研 CLR/GC 或全部从零实现。
同一专用 U 盘已自动更新并完整校验 独立内核 0.3.0-dev.1 实验镜像：序列号 230222336207、UniqueId 5000000000002AEF、USB、实际容量 256060514304 字节；使用 IndependentCSharp128 安全流程。源 SHA256 04e8188343b75521f3337c3f004cd3afd3ab391d103321a2102e28edd885c196；容量调整后的完整镜像实际/预期 SHA256 均为 7e068728de99cdc8666ee1569bef6a47f01ccec34e7e5b0f0c6258f022adf7da。完整 134217728 字节回读、真实盘尾备份 GPT（ActualLastLba 500118191）通过；句柄关闭、辅助进程 PID 69312 已完成并退出，fresh 磁盘状态离线且非系统/启动盘。完成与 postflight 记录：build/usb-media/XFEstudio-Independent-0.3.0-dev.1-retry-1792018512682/Completion.json / Postflight.json；可提交摘要：docs/validation-results/IndependentKernel20261015.json。
首轮配置证据锁定失败及后续 Windows 提权取消均发生在实体磁盘打开之前，记录保留，已由同目录 resolved-by-write.json 标记后续成功解决。写入仍不等于实体启动或输入验收；持久存储、原生网络/TLS、USB HID、GPU/CUDA、SMP 与长期稳定性尚未通过，FullReleaseQualified 仍为 false。文件与设置只在 RAM 会话，关机不保留。下一版继续使用同一专用设备身份与新镜像/源码绑定回执、新计划/token、安全写入及完整回读流程。