配置总览
Mogick 将用户级配置和项目级配置分开保存。全局配置适用于当前用户的所有项目；项目配置只作用于当前工作区。
配置文件
| 文件 | 全局路径 | 项目路径 | 用途 |
|---|---|---|---|
config.json | <config-dir>/config.json | .mogick/config.json | LLM、权限、记忆、会话和运行时配置 |
mcp.json | <config-dir>/mcp.json | .mogick/mcp.json | MCP 服务器定义 |
auth.json | <config-dir>/auth.json | .mogick/auth.json | OAuth token、API Key 等凭据；不要提交到版本库 |
sessions.sqlite | <db-path> | — | 会话持久化数据 |
项目还可包含 .mogick/skills/，用于保存项目 Skills。Plan Artifact 随会话保存在 session store 中。
全局和项目两层配置的优先级：项目 .mogick/config.json 中显式填写的字段覆盖全局同名字段，未填写的继续使用全局值。llm.providers[] 在项目层非空时整体替换全局数组，auth.providers 按 Provider ID 合并。
按需求找页面
| 你要做什么 | 看这里 |
|---|---|
| 接入模型服务、配置 OAuth 或 API Key | 认证与模型 |
| 配置 MCP 服务器 | MCP 配置 |
| 调整工具权限策略或逐工具权限 | 工具权限策略 |
| 调整会话心跳、超时、并发或存储位置 | 会话与历史 |
常用环境变量
| 环境变量 | 作用 |
|---|---|
MOGICK_CONFIG_DIR | 覆盖默认全局配置目录 |
MOGICK_DATA_DIR | 覆盖数据目录 |
MOGICK_CONFIG_FILE | 指定配置文件（仅替代 config.json，不影响 auth/MCP/skills） |
MOGICK_RUNTIME_ENV | 选择 runtime preset |
MOGICK_TUI_THEME | 设置 auto、dark 或 light |
bash
export MOGICK_CONFIG_DIR=/home/user/.mogick
export MOGICK_DATA_DIR=/mnt/mogick-data
mogick完整列表见数据目录与环境变量。
路径占位符 <config-dir>、<db-path> 指当前 profile/通道实际生效的路径，见数据目录。