数据放在哪里
| 内容 | 位置 |
|---|---|
| 用户目录 | macOS：~/.easyai-work；Windows：%USERPROFILE%\.easyai-work。可以用环境变量 EASYAI_AGENT_USER_DIR 换成别的位置。 |
| 工作空间 | 主目录下的 EasyAIWorkSpace，每位专家一个子文件夹，比如内置专家是 agent-builtin-default。可以在 设置 › 通用设置 › 数据存储 › 默认工作空间 修改，也可以在专家编辑器里给某位专家单独设。 |
| 成果 | 工作空间里的 deliverables/，见 成果与资料库。 |
| API 密钥与令牌 | 操作系统的凭据库：macOS 钥匙串、Windows 凭据管理器。不在用户目录里，也不进备份。 |
头像菜单 › 关于 里的「数据目录」「日志目录」旁边都有 打开 按钮，可以直接打开对应文件夹。
用户目录里有什么
| 文件或文件夹 | 内容 |
|---|---|
studio.db | 数据库：专家、任务和对话、模型平台、技能与连接器的登记信息、用量记录。 |
studio.db.vN.bak | 升级数据库结构前自动留的快照。 |
skills/ | 已安装的技能。.trash、.staging 是回收区和临时区。 |
agents/ | 你自己写的子智能体定义文件。 |
connectors/ | 命令行连接器的厂商工具（cli/）和它们带来的技能（skills/）。 |
runtimes/ | EasyAI Work 托管的 Python、Node 等运行时。 |
plugins/ | 通过插件管理器安装的插件。 |
backups/ | 自动备份、更新前备份和手工备份的默认位置。 |
updates/ | 下载的新版本安装包和更新日志 update.log。 |
logs/ | 默认日志目录，模型调用日志写在这里，见日志。 |
cache/、tmp/、environment/ | 缓存、临时文件、本机环境检测结果。 |
*.properties、Startup/ | 界面语言、窗口布局、字体等偏好。 |
设置 › 通用设置 › 数据存储 的「目录列表」会列出这些位置各占多大空间。点 清理缓存… 只删除标为「缓存」的项目（模型调用日志、升级快照、回收区），会先确认，最新的一份升级快照会保留。
自动备份
- 启动时在后台备份数据库，24 小时内最多一次，文件在
backups/studio-auto-日期-时间.db。 - 默认保留 7 份（可设 1–30），超出后删除最旧的自动备份，手工备份不受影响。
- 在线更新安装新版本前，也会先备份数据库；这类备份保留最近 2 份。备份失败时，更新会取消。
- 开关、备份目录和保留份数在 设置 › 数据安全 › 数据备份与恢复 里设置。
手工备份
在 设置 › 数据安全 › 数据备份与恢复 › 立即备份：
| 方式 | 包含 |
|---|---|
| 完整备份（推荐） | 数据库、技能、子智能体定义、界面偏好，打包成一个 .zip。可以勾选「包含工作空间产出（workspaces/）」把智能体的文件也带上。 |
| 仅数据库 | 数据库的一致性快照，一个 .db 文件。 |
点 备份到… 选位置。换电脑时，用完整备份最省事。
备份不包含任何 API 密钥或访问令牌。恢复到另一台电脑后，要重新输入模型平台的密钥，也要重新填写连接器的令牌、重新登录授权。
从备份恢复
- 在 设置 › 数据安全 › 数据备份与恢复 点 选择备份文件…，选 .zip 或 .db。也可以在「最近的自动备份」列表里选一份，点 恢复选中…。
- 检查预览：类型、创建时间、数据库版本、包含哪些内容、完整性。
- 勾选「我已了解恢复会覆盖当前数据」，点 恢复并重启。
- 恢复不会马上发生，而是在下次启动时完成。当前数据会先另存一份，页面上会写明存在哪里。
- 重启之前改了主意，点 取消恢复。
- 恢复完成后，到 模型设置 里重新输入密钥。
如果启动时数据库打不开（比如被更新的版本改过结构），会弹出对话框，让你选「恢复所选备份」「打开备份文件夹」或「退出」。
日志
| 日志 | 位置与说明 |
|---|---|
| 应用日志 | macOS：~/Library/Logs/EasyAIWork/launcher.log；Windows：用户目录下的 logs\launcher.log。程序打不开或出错时先看这里。 |
| 模型调用日志 | 默认关闭。打开后写在日志目录（默认是用户目录下的 logs/，可以在 数据存储 › 默认日志目录 修改）下的 model-calls/专家/会话/运行/，每次调用一个 call-N.log，上下文压缩另有 compaction-N.log。见 模型 › 模型调用日志。 |
| 更新日志 | 用户目录下的 updates/update.log。 |
反馈问题时，最有用的是三样东西：关于对话框里的「复制诊断信息」、设置 › 基础环境 › 环境监测 里的「导出诊断包…」，以及出问题那段时间的 launcher.log。