# 环境变量

## acdev

| 变量 | 作用 |
| --- | --- |
| `ACDEV_INSTALL` | 安装目录, 默认 `~/.acdev` |
| `ACDEV_DIST` | 安装脚本从哪里下载 acdev 和它的运行时, 也是 `acdev doctor --online` 去找更新版本的地方; 默认 `https://pkgs.dopame.ai/acdev` |
| `ACDEV_SDK` | `acdev new` 和 `acdev sdk update` 让 `@dopame/acde-api` 指向的 SDK 目录; 默认是随 acdev 一起来的那个 |
| `ACDEV_VM_DIR` | `acdev vm` 把客户机放在哪里: 镜像、overlay 磁盘、socket、日志; 默认 `~/.local/share/acdev/vm` |
| `ACDEV_VM_TRANSPORT` | `acdev vm start` 怎样连到客户机里的 acdevd: `vsock` (Linux 上的默认)、`tcp` (127.0.0.1 上的一个转发端口, macOS 和 Windows 上的默认) 或 `unix` (虚拟机目录里一个转发的 Unix socket; 只在设了时用, 需要支持 `hostfwd=unix` 的 QEMU (2025 年 10 月合入上游; 第一个带它的版本大概是 10.2, 未核实)、libslirp 4.7.0 或更新、不是 Windows 主机, 并且 socket 路径里没有 `-`, 除非 QEMU 还带了 2026 年 6 月那个按最后一个连字符拆分规则的修复; QEMU 8.2.2 会说 `Bad protocol name`) |
| `ACDEV_QEMU_DIR` | `acdev vm` 用的 `qemu-system-x86_64` 和 `qemu-img` 所在的目录 (先于 `PATH` 查找; Windows 上 `PATH` 之后再查注册表和 `%ProgramFiles%\qemu`, macOS 上再查 Homebrew 和 MacPorts) |
| `ACDEVTOOL` | `acdev vm` 跑的 `acdevtool` 二进制: Windows 上用 `acdevtool relay` 连 QEMU 的 QMP 和客户机代理的 socket, `acdev vm start --viewer` 和 `acdev vm view` 用 `acdevtool view` (默认: 装好的 `libexec/acdevtool`, 否则从检出的 `crates/tool` 构建) |
| `ACDEV_VM_ARCH` | `acdev vm` 的客户机架构: `x86_64` 或 `aarch64` (默认: Apple 芯片这类 arm64 主机上是 `aarch64`, 否则 `x86_64`) |
| `ACDEV_VM_CPUS` | `acdev vm start` 给客户机几个 CPU; 默认 4 |
| `ACDEV_VM_MEMORY` | `acdev vm start` 给客户机多少内存, 写法同 QEMU (`8G`、`4096M`); 默认 `8G` |
| `ACDEV_VM_DIST` | `acdev vm fetch` 从哪里下载客户机磁盘镜像; 默认是 acdev 自己的镜像服务器 |
| `ACDEV_VM_PASSWORD` | `acdev vm provision` 和 `acdev test --vm` 给客户机的测试用户设的密码; 默认 `dopame-dev` |
| `ACDEV_DEVD` | `acdev vm start` 放进客户机的 acdevd 二进制 (设备守护进程); 文件不在时 acdev 报错停下. 默认: 安装脚本按客户机架构放在 acdev 旁边的那个 (`libexec/acdevd-<arch>`) |
| `ACDEV_RUNTIME` | `acdev dev` 和 `acdev test` 跑的运行时二进制: 二进制的路径 (不在 PATH 上查找; 文件不在时 acdev 报错停下). 没设: 安装脚本装在 acdev 旁边的那个, 即安装目录的 `libexec/acdev` |
| `ACDEV_BUNDLER=vite` | Bun 上也用 Vite 打包 |
| `ACDEV_DEBUG=1` | 出错时还打出调用栈 (平常只有一行消息) |
| `ACDEV_BROWSER` | `acdev devtools` 和 `acdev dev` 里的 F12 在哪个浏览器里打开 DevTools: 一个路径, 或 `none`, 什么都不开, 只打出地址. 没设: Windows 上先 Edge 再 Chrome; macOS 上先 Chrome 再 Edge; Linux 上是 `PATH` 上的 Chrome、Chromium 或 Edge |
| `CI` | 设了时 `toHaveScreenshot` 不会写新的基线, 缺基线直接失败 |
| `NO_COLOR` | 设了且不为空: acdev 的输出不带颜色 |
| `FORCE_COLOR` | 设了且不是 `0` 或 `false`: 输出不是终端时也带颜色 |

## 运行时 (acdev runtime)

`acdev dev` 和 `acdev test` 会替你设好需要的. 手动调整:

| 变量 | 作用 |
| --- | --- |
| `ACDE_PATH` | 额外的包目录 (Windows 用 `;` 分隔) |
| `ACDE_DESKTOP` | 默认桌面 |
| `ACDE_HEADLESS=1` | 不开窗口 |
| `ACDE_SIZE` | 屏幕尺寸, 如 `1280x800` |
| `ACDE_SCALE` | headless 时的缩放 (0.5–4) |
| `ACDE_COLOR_SCHEME` | `light` / `dark` |
| `ACDE_STORAGE` | 网页存储的根目录; 设成空则只在内存 |
| `ACDE_AUTOSTART` | 自启动项默认只在 Dopame OS 会话里跑: `1` 在宿主窗口里也跑, `0` 不跑 |
| `ACDE_AUDIO=null` | 不出声 |
| `ACDE_CAPTURE=fake` | 用假的摄像头和麦克风 (`Fake camera`、`Fake microphone`) 代替系统的设备, 给 `getUserMedia()` 用 |
| `ACDE_FRAME_STYLE` | 标题栏样式: `mac` (红绿灯) 或 `windows` (Windows 的按钮). 没设: Windows 上的宿主窗口里是 `windows`, 其他情况是 `mac` |

## 应用后端

| 变量 | 是什么 |
| --- | --- |
| `ACDE_APP_ID` | 应用 id |
| `ACDE_APP_DATA` | 应用的数据目录 (也是工作目录) |
| `ACDE_APP_SOCKETS` | 应用的 socket 目录. Windows 上的 Node.js 后端没有这个变量, 它拿到的是 `ACDE_APP_CHANNEL=fd`; 见 [后端](https://docs.dopame.ai/zh/guide/backend.md#windows-上) |
| `PORT` | 配置的端口 |
| `NODE_ENV` | `production` |
| `http_proxy`、`https_proxy`、`all_proxy`、`no_proxy` | 会话的代理变量; 没有的话是系统的手动代理 (Windows、macOS) 连同它的例外, `no_proxy` 里再加上 `localhost,127.0.0.1,::1`; Windows 上是大写的名字, 其它平台大小写都有. 见 [后端](https://docs.dopame.ai/zh/guide/backend.md#运行) |
