WopalSpace空间配置
WopalSpace 的一个设计原则是：确定性配置由 CLI 管理，不靠你手敲 JSON。所以你很少需要直接编辑配置文件。
全局配置：settings.jsonc
全局状态位于：
$WOPAL_HOME/config/settings.jsonc
- 默认路径：macOS / Linux 为
~/.wopal；Windows 为%USERPROFILE%\.wopal。 - 这是 JSONC（允许注释），由 CLI 读取；写入时以纯 JSON 输出。
它主要承载机器管理的状态，顶层键包括：
| 键 | 含义 |
|---|---|
spaces | 已注册空间清单（路径、分支、类型） |
ontologies | 已安装的本体 source 及其模式（clone / fork） |
ontologyDir | （可选）本体存放根目录覆盖 |
globalSkillsDir | （可选）全局技能目录 |
logsDir | （可选）日志目录 |
ellamaka | 引擎相关配置 |
logging | 日志级别等 |
一般不需要手动改它。
wopal setup、wopal space init、wopal ontology install等命令会按需写入。如果你一定要改，注意它是 JSONC，且 CLI 后续写入可能覆盖手工格式。
AI 提供商凭证
AI 凭证不在 settings.jsonc 里，也不建议用环境变量硬编码。它由引擎保管在：
$WOPAL_HOME/ellamaka/data/auth.json
配置方式有两种：
# 方式一：随时配置
wopal ellamaka auth login
# 方式二：首次 setup 的 Configure 阶段填写
wopal setup
按提示选择提供商（OpenAI / Anthropic 等）并粘贴 API Key 即可。查看当前状态：
wopal ellamaka auth status
环境变量
只有少数覆盖项走环境变量，且优先级最高：
| 变量 | 作用 |
|---|---|
WOPAL_HOME | 覆盖全局根目录（默认 ~/.wopal） |
WOPAL_SETTINGS_PATH | 仅用于测试 / 高级覆盖，指定 settings 文件路径 |
不存在
WOPAL_API_KEY、WOPAL_SPACES_DIR这类变量——AI Key 走wopal ellamaka auth login，空间由注册表管理而非单一目录变量。
空间级配置
每个空间通过以下文件表达自身结构、规则与环境，而不是全局 JSON：
| 文件 | 作用 | 维护者 |
|---|---|---|
STRUCTURE.md | 空间结构真相源（组件清单） | /init 校准 |
REGULATIONS.md | 空间守则与安全红线 | 你 + /wopal:evolve |
.wopal/.env | 空间级环境变量 | 你 |
memory/USER.md / MEMORY.md | 用户偏好与长期经验 | /wopal:evolve |
memory/diary/ | 会话日记暂存 | /wopal:memo |
诊断
不确定环境是否健康，先跑：
wopal doctor
它是只读诊断，会检查 Git、网络、目录权限、引擎与本体状态，并给出修复建议。