从这里开始：

1vm doctor          # 主机、权限、库、引擎
1vm capabilities    # 这台 Mac 能做什么、不能做什么
1vm logs <vm>       # 来宾串口与主机生命周期日志

logs 接受 --source guest|host|all、--lines N 与 --follow。多数“就是失败了”的问题看来宾串口最后几行即可。

所有机器无法启动

几乎总是签名。应用须带 virtualization 权限，移出 bundle 或剥离签名的二进制无法启动任何机器。从原始 app 重装，不要拆文件。1vm doctor 直接报告权限状态。

机器显示运行但没有画面

查看 1vm logs <vm> --source guest。虚拟 CPU 存在即报告 running，即使固件未进入来宾 — “running” 加黑屏通常是引擎之上的启动失败，不是缺窗口。

Virtualization.framework 回退引擎上的 Windows，Setup 黑屏直到显示驱动绑定属预期。改用 1VM 引擎，ramfb 无需驱动即可显示 Setup。

不能。两引擎在 Apple silicon 上原生运行来宾代码，来宾须 ARM64。无模拟、无转换 — 需要 OS 的 ARM64 构建。这是最常见意外，Omarchy 指南有完整说明。

安装 virtio-win 的 NetKVM 驱动。Windows 自带 NVMe 与 xHCI 驱动，磁盘与键盘立即可用，但无 virtio-net。创建时用 --drivers 附加驱动 ISO。

安装程序是内存峰值，非运行系统。给机器更多内存再试：

1vm stop dev --force
1vm set dev memory 8GiB
1vm start dev

若 Mac 本身吃紧，1VMTool 会缩小配置并告知，而非静默超分。

点按释放组合键 — 控制台状态条显示该窗口当前组合。可配置：

1vm get dev input.releaseChord

运行中机器上的硬件变更会被拒绝，除非设置明确支持。停止、改、再启。设置时即校验，错误直接说明问题，而非下次启动才失败。

用 1vm wait-ready <vm> 而非 sleep。“Running”表示机器在执行；“ready”表示来宾经 SSH 或 guest agent 可达。差距是脚本 flaky 的来源。

1vm discard-session dev --force   # 撤销本次启动以来一切
1vm snapshot restore dev clean    # 到命名快照
1vm reset dev --force             # 回到干净状态

若跳过快照，此刻该开始：几乎无成本，这正是要点。