配置
数据目录、config.json v2、.spirit/ 和环境变量。
Spirit 把二进制和数据放在不同地方。混在一起，通常就是「CLI 装上了但设置是空的」。
数据目录
用 SPIRIT_AGENT_DATA_DIR 覆盖。Server 还可以用 SPIRIT_SERVER_DATA_DIR（优先于前者）。
| 系统 | 默认 |
|---|---|
| macOS | ~/Library/Application Support/SpiritAgent |
| Windows | %APPDATA%\SpiritAgent |
| Linux | $XDG_DATA_HOME/SpiritAgent 或 ~/.local/share/SpiritAgent |
| 回退 | ~/.spirit-agent |
常见文件：
{spiritDataDir}/
config.json
mcp.json
hooks.json
rule.md
skills/
chats/
plans/
extensions/
automations/
dreams/
server.token
server/instances/CLI 二进制在 SPIRIT_HOME（~/.spirit 或 %LOCALAPPDATA%\Spirit）。那不是这个目录。见 安装 CLI。
config.json v2
schemaVersion 必须是 2。版本 1 会被拒绝——删掉旧文件，再重连提供商。
核心字段：
providerGroups— 已接的提供商、API Base、传输、模型activeModelimageGenerationModel/videoGenerationModel/lightweightChatModel
Key 不在这个文件里。它们在钥匙串。
工作区 .spirit/
| 路径 | 作用 |
|---|---|
.spirit/rule.md | 工作区 rule |
.spirit/skills/ | 工作区 skills |
.spirit/mcp.json | 工作区 MCP |
.spirit/hooks.json | 工作区 hooks |
另外还会用：{workspace}/AGENTS.md、{workspace}/.agents/skills/、{workspace}/plans/。
环境变量
| 变量 | 作用 |
|---|---|
SPIRIT_AGENT_DATA_DIR | 数据目录 |
SPIRIT_SERVER_DATA_DIR | Server 数据目录（优先） |
SPIRIT_ACP_DATA_DIR / SPIRIT_ACP_WORKSPACE | ACP |
SPIRIT_HOME / SPIRIT_VERSION / SPIRIT_DOWNLOAD_HOST | CLI 安装脚本 |
SPIRIT_API_KEY / SPIRIT_API_BASE | CLI 进程覆盖 |
SPIRIT_WEB_HOST / SPIRIT_WEB_PORT / SPIRIT_DESKTOP_WEB_HOST | Desktop Web Host |
SPIRIT_TERMINAL_SHELL | Desktop PTY shell |