# 平台支持

开发用的宿主窗口 (`acdev dev`) 在 macOS、Windows、Linux 上都能跑; Dopame OS 本身是 Linux. 运行时有这些构建: macOS 的 Apple 芯片和 Intel、Linux 的 x86_64、Windows 的 x64, 见 [安装](https://docs.dopame.ai/zh/start/install.md#支持的平台).

| | macOS | Windows | Linux (开发) | Dopame OS |
| --- | --- | --- | --- | --- |
| 页面渲染 (需要 GPU) | Metal | DX12 | Vulkan (硬件驱动) | Vulkan |
| `acde:fs`、文件选择器 | ✓ | ✓ | ✓ | ✓ |
| 声音、剪贴板 | ✓ | ✓ | ✓ | ✓ |
| 系统通知 | ✓ | 只在桌面里, 由桌面显示 | ✓ | 由桌面显示 |
| 应用后端 | ✓ | ✓ (见 [后端](https://docs.dopame.ai/zh/guide/backend.md#windows-上)) | ✓ | ✓ |
| `acde:terminal` (`terminal`) | ✓ | ✓ | ✓ | ✓ |
| 摄像头和麦克风 (`camera`、`microphone`) | ✓ | | ✓ | 还没有: `getUserMedia()` 以 `NotAllowedError` reject |
| `acde:network`、`acde:office` (`network`、`office`) | | | ✓ | ✓ |
| `acde:system`、`acde:bluetooth`、`acde:audio`、`acde:devices`、`acde:power`、`acde:input`、`acde:display` (同名的能力) | | | ✓ | ✓ |
| 空闲检测 (`idleDetection`) | | | ✓ | ✓ |
| 嵌在窗口里的原生程序 (`slots`) | | | | ✓ |
| WebGPU、语音输入 | | | ✓ | ✓ |
| 原生程序 (`.desktop`) | | | ✓ | ✓ |
| headless (`--headless`、`acdev test`) | ✓ | ✓ | ✓ (要 GPU) | |

- 平台上没有的能力不会给假的实现. **必需**这种能力的应用在那里启动不了 (`Notes needs "network" (unsupported on this platform)`), 也不在应用列表里; 把它列在 `optional` 里的应用能启动, `import('acde:<name>')` 对这个模块会 reject, `acde:capabilities` 报告 `state: 'unsupported'`. 见 [系统能力](https://docs.dopame.ai/zh/guide/capabilities.md#可选能力).
- `acdev check --platform windows` (或 `macos`、`linux`) 在你去那里跑之前就告诉你: `error: macos (standalone): app "notes" requires network, which this mode lacks`, 能力是可选的时候则是一条 `note:`. 数据是 `@dopame/acde-api` 里的 `PLATFORM_SUPPORT`, 按平台和运行方式分: `session` (Dopame OS)、`desktop` (宿主窗口里的桌面)、`standalone` (宿主窗口里的单个应用). 页面从 `acde:capabilities` 读自己的 (`platform`、`mode`).
- 运行时在 GPU 上画页面. Linux 上没有 GPU 时退回软件 Vulkan 驱动 (lavapipe, Debian、Ubuntu 和 Fedora 上在 `mesa-vulkan-drivers` 里, Arch 上是 `vulkan-swrast`), 它在 CPU 上画, 动画很慢, 所以没有 GPU 的 Linux CI 装上这个驱动后就能跑 headless. macOS 的 CI runner 用自己的 GPU.
- Linux 上运行时要的是机器 GPU 的**硬件 Vulkan 驱动**; 软件驱动 (lavapipe / llvmpipe) 只在没有别的驱动时才用, `acdev doctor` 会对此发出警告. 完全没有 Vulkan 驱动时 `acdev dev` 启动就失败, 日志里有一行说明这一点, 并指出系统里有的是哪块 GPU: `web layer unavailable: the system has a GPU (card0, kernel driver i915) but no usable Vulkan driver was found: install the GPU's Vulkan driver (for example vulkan-intel, vulkan-radeon, nvidia-utils) or point VK_DRIVER_FILES at its ICD (…)`. 解决办法是装上驱动, 再确认 `vulkaninfo --summary` 列出了这块 GPU: Mesa 的话, Arch 上是 `vulkan-intel` 或 `vulkan-radeon`, Debian、Ubuntu 和 Fedora 上是 `mesa-vulkan-drivers`; NVIDIA 用厂商的驱动.
