配置基础

从用户 YAML、可信项目 TOML 和任务设置确定有效配置。

配置文件在哪里

Lime 用户配置使用系统配置目录中的 lime/config.yaml；可通过 LIME_CONFIG_PATH 指定该文件路径。项目覆盖使用 .lime/config.toml。常用设置优先通过应用设置修改，精确编辑前先确认文件和格式。

范围	位置	用途
用户	系统配置目录/lime/config.yaml	模型服务、桌面偏好和全局默认值
项目	项目路径/.lime/config.toml	受信任项目的新线程默认值
管理员	/etc/lime/requirements.toml；Windows 为 ProgramData/Lime/requirements.toml	限制可用审批、沙盒、搜索及已支持的应用策略

读取配置时，Lime 组合用户配置与从最近 Git 根目录到工作目录之间的可信项目层。越接近工作目录的有效项目设置越具体。项目可信状态来自用户配置，项目自身不能授予信任；未信任或通过符号链接引入的项目层不参与合成。

新线程按工作目录冻结默认值，恢复已有线程时保留线程设置快照。更改用户默认值后，应使用新线程验证。管理员要求是约束，即使任务显式指定值也不能绕过。

yaml

approval_policy: on-request
sandbox_mode: workspace-write
model_reasoning_effort: medium
agent:
  default_model: <YOUR_MODEL_ID>

模型必须来自已配置提供商的可用目录。推理强度仅在模型与协议均支持时生效。审批策略决定何时请求决定，沙盒决定命令的文件与网络范围，两者需要一起设置。

toml

approval_policy = "on-request"
sandbox_mode = "workspace-write"
model_reasoning_effort = "medium"

项目文件只能包含已接入的线程默认字段。模型服务凭据、桌面偏好和管理员约束放在各自的用户或系统入口，不在仓库里建立第二套配置来源。

bash

lime exec --sandbox read-only --ask-for-approval never "概述仓库结构，不修改文件"
lime --model <YOUR_MODEL_ID> --effort medium

Lime 使用实际命令提供的参数进行任务覆盖。不要把通用 -c、--config 或 --profile 作为当前 CLI 已支持的入口。

先用 config/read 查看生效值、来源和层信息，再检查新线程的设置。功能开关通过设置或 experimentalFeature/list 与 enablement/set 管理；可用键和成熟度以当前返回结果为准。未知字段、非法值和受管字段写入会被拒绝。