数据与文件
本页列出 ATM 读写的所有路径。
ATM 自有文件
ATM 数据全部在 ~/.atm/ 下。
| 路径 | 用途 |
|---|---|
~/.atm/atm.db |
SQLite 数据库。存 Provider 元数据、Agent、key 前缀、策略、日志、用量。 |
~/.atm/settings.json |
用户编辑设置（路径、语言、代理、通知开关）。 |
~/.atm/backups/ |
破坏性操作前的自动快照。 |
~/.atm/logs/ |
应用日志。轮转。应用关了之后可安全删除。 |
~/.atm/cache/ |
内部缓存。应用关了之后可安全删除。 |
ATM 永远不会写到 ~/.atm/ 和 Agent 原生配置文件（下一节）之外的位置。
Agent 原生配置文件
ATM 读取——并在你应用路由时写入——它管理的 Agent 配置文件。
| 工具 | 文件 | 备注 |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
选 ATM Gateway 时 ATM 写 env 块。 |
| Codex | ~/.codex/auth.json、~/.codex/config.toml |
API key 写到 auth.json，Provider 块写到 config.toml。 |
| OpenClaw | ~/.openclaw/openclaw.json |
合并到 models.providers 和 agents.defaults。 |
| Gemini CLI | ~/.gemini/config.json（默认） |
写 API endpoint 和 key。 |
| 通用 Agent | configPath 指向的位置 |
按 Agent 模板写指定字段。 |
ATM 在写入时尽量 保留非路由字段。自定义 prompts、tool permissions、Agent 专属覆盖、无关字段都保留。
本地历史
ATM 还会只读地读取每个工具自己产生的历史文件，喂给 Usage 页。
| 工具 | 读取自 |
|---|---|
| Claude Code | ~/.claude/projects/ |
| Codex | ~/.codex/history/、~/.codex/sessions/ |
| Cursor | ~/Library/Application Support/Cursor/... |
| OpenClaw | ~/.openclaw/history/ |
| OpenCode | 工具特定路径 |
| Gemini CLI | ~/.gemini/history/ |
| GitHub Copilot | 工具特定 |
| DeepSeek | 工具特定 |
| Doubao、Bagualu | 工具特定 |
ATM 永远不会修改这些历史文件。如果你删了它们，未来 Usage 图就缺那段时期。
备份
ATM 在做任何破坏性操作前写快照：
- Agent 配置回滚。
- 应用升级时的 schema 迁移。
- 批量策略或 Provider 编辑。
备份带时间戳：
~/.atm/backups/2026-05-20T14-22-31_pre-rollback/
├── claude_settings.json
├── codex_config.toml
└── manifest.json
桌面 UI 在 Settings → Backups 列出。
默认端口
| 端口 | 是什么 |
|---|---|
127.0.0.1:4317 |
ATM Gateway（仅回环） |
ATM 永远不会在非回环接口上开监听。
网络出站
ATM 自身不主动发送外部请求，除了：
- 经由网关，代表 Agent，向你配置的上游模型 Provider。
- 仅当你显式触发更新时，下载 App 更新包或内置 Provider 预设更新。
无遥测、无统计、无自动 phone-home。
清理
# 先退出 ATM
osascript -e 'quit app "ATM"'
# 抹掉 ATM 数据（不可逆）
rm -rf ~/.atm
# 删除 ATM 本身
rm -rf /Applications/ATM.app
卸载 ATM 不会删 Agent 原生配置文件。要清掉 ATM 对某个工具的修改，先用 Agent 的"重置配置" 操作，再卸载 ATM。