Aeria
GitHub
改 · 3.26

数据放在哪

最后核对 2026-10-07对应提交 7a2464e依据 config.py · personas.py · backup.py · plugins.py · storage.py

一个运行时的全部家当在一个数据目录里:每个人格一个 SQLite 库、一个系统库、配置、日志、备份、插件和它们的数据。密钥不在这里。

本页 5 节
  1. 目录
  2. 密钥在哪
  3. 备份
  4. 对应的代码
  5. 没做到的

目录

从源码跑时,数据目录就是项目目录(下面的路径都相对它);桌面版在系统的应用数据目录里(首次配置「就绪 → 高级」里能改)。

config/
  bot.toml                 主配置(开发用的中性基础配置)
  personas.toml            人格注册表:有哪些人格、各自的配置和库在哪、会话绑定
  personas/<人格>.toml      每个人格的配置(网页后台「配置管理」改的就是它)
  personas/.removed/       删掉的人格的配置挪到这里(挪回去就恢复)
data/
  personas/<人格>.db        每个人格一个库:聊天、记忆、关系、作息、决策记录……
  aeria.db                 默认的库路径(只有一个人格、没写库路径时)
  system.db                系统库:不属于任何一个人格的状态(访问密钥的哈希、插件的记录……)
  logs/aeria.jsonl         日志(打过码,按大小轮转)
  backups/                 备份
  plugins/<插件>/           装上的插件
  plugin_data/<插件>/       插件自己的数据(更新插件不动它)
  plugin_host/grants.json  装的人确认过的插件能力
  knowledge_staging/       知识库上传了、还没确认的文件
  webui.token              后台密码(从源码跑、没设 WEBUI_TOKEN 时自动生成)
.env                       从源码跑时的环境变量和密钥(不进 git、不进备份)

密钥在哪

备份

python -m aeria.backup create                          # 整机:每个人格的库 + 系统库 + 配置
python -m aeria.backup create --persona <人格>          # 只备一个人格
python -m aeria.backup verify data/backups/<名字>       # 校验:文件哈希、库完整、库属于谁
python -m aeria.backup restore data/backups/<名字> --persona <人格>   # 先停运行时

对应的代码

没做到的