数据目录与环境变量
生效路径
基础配置目录默认为 ~/.mogick，可用 MOGICK_CONFIG_DIR 指定。基础数据目录默认跟随基础配置目录，可用 MOGICK_DATA_DIR 指定。
26.9.11 在启用 runtime profile 时，会在上述基础目录下使用 profiles/<profile-id>/。本文档中的 <config-dir>、<data-dir> 均指选择 profile 后实际生效的目录，不一定直接是 ~/.mogick。修改或迁移前应核对当前 profile，不要直接把文件放到基础目录。
| 路径 | 用途 |
|---|---|
<config-dir>/config.json | 全局非敏感配置 |
<config-dir>/auth.json | 全局认证凭据，禁止公开 |
<config-dir>/mcp.json | 全局 MCP 配置 |
<config-dir>/skills/ | 全局 Mogick Skills |
<data-dir>/sessions.sqlite | stable 通道默认会话数据库 |
<data-dir>/sessions.<channel>.sqlite | 非 stable 通道默认会话数据库 |
<data-dir>/mogick-state.sqlite | 运行时状态数据库 |
<db-path>.payloads/ | 实际会话数据库对应的载荷文件目录 |
<数据库所在目录>/last-session.txt | 最近会话指针 |
.mogick/config.json、.mogick/auth.json、.mogick/mcp.json | 相对于启动工作目录的项目配置 |
.mogick/skills/ | 项目 Skills |
显式设置 memory.db_path 时使用该路径，不再自动按通道改名。切换 profile 或通道可能改变可见的会话集合；切换后“找不到旧会话”不等于数据已被删除。
环境变量
| 变量 | 作用范围 |
|---|---|
MOGICK_CONFIG_DIR | 全局配置与 Skills 的基础目录 |
MOGICK_DATA_DIR | 默认数据的基础目录；未设时回退配置基础目录 |
MOGICK_CONFIG_FILE | 仅替代主配置文件路径，不搬迁 auth、MCP、Skills 或数据 |
MOGICK_RUNTIME_ENV | 选择运行时 preset |
MOGICK_TUI_THEME | auto、dark 或 light |
MW_LOG_LEVEL | 日志级别 |
MOGICK_UPGRADE_URL | 自定义更新服务地址 |
项目 .mogick/ 始终相对于启动时的工作目录。环境变量不是任意 JSON 字段的通用覆盖机制。
配置优先级
内置默认值与 runtime preset 之上依次叠加全局和项目配置。普通标量通常逐字段覆盖；项目层非空 llm.providers[] 整体替换 provider 数组；Agent 工具按 Agent 与工具名解析。认证和 MCP 使用各自的合并规则，见配置参考。
备份范围
备份前退出使用该数据库的所有 Mogick 进程，确保复制时数据一致。保留实际会话数据库及同名 .payloads/ 目录、生效的数据/状态目录，以及需要恢复的全局和项目配置。若需恢复整个项目，还须另外备份工作区文件。
不要把“只复制 sessions.sqlite”或“导出会话文本”视为完整备份。凭据、会话及载荷均可能含敏感信息。记录版本、profile、通道和原始路径，在隔离位置验证恢复后再依赖该备份；本页不承诺跨版本迁移兼容性。