安装
系统要求
| 平台 | 要求 |
|---|---|
| macOS | macOS 12(Monterey)及以上,Apple Silicon(aarch64)或 Intel |
| Windows | Windows 10 / 11,x86_64 |
| 硬盘 | 约 100 MB,加上 ~/.atm/(macOS)或 %APPDATA%\atm\(Windows)下的本地数据 |
| 网络 | 仅回环。网关 127.0.0.1:4317 不会对外开放 |
安装(macOS)

- 下载
.dmg并双击挂载。 - 把
ATM.app拖进Applications。 - 从 Launchpad 启动。
ATM 已用 Apple Developer 证书签名,新 macOS 上直接打开即可,不会有"未验证的开发者"提示。
安装(Windows)
- 下载
.zip并解压到任意目录。 - 双击
ATM.exe启动。
验证
ls ~/.atm/ # 本地数据已生成
curl -s http://127.0.0.1:4317/health # 网关启动后应返回 ok
把 CLI 加到 PATH(可选)
# 全局(需 sudo 写入 /usr/local/bin)
ln -sf /Applications/ATM.app/Contents/MacOS/atm /usr/local/bin/atm
# 或用户目录
mkdir -p ~/.local/bin
ln -sf /Applications/ATM.app/Contents/MacOS/atm ~/.local/bin/atm
不带参数运行 atm 仍会打开桌面端。完整命令见 CLI 参考。
升级
ATM 不支持自动更新。升级步骤:从托盘菜单退出 ATM → 下载新 .dmg → 拖入 Applications 覆盖旧版 → 重新启动。~/.atm/ 数据不受影响,迁移前会自动备份至 ~/.atm/backups/。
卸载
osascript -e 'quit app "ATM"' # 先退出 ATM
rm -rf /Applications/ATM.app # 删除应用
rm -rf ~/.atm # 删除本地数据(不可逆)
rm -f /usr/local/bin/atm ~/.local/bin/atm # 如果装过 CLI 软链