配置参考
按配置所有者查找字段、格式与生效范围。
用户配置与项目覆盖
本页列出 Lime 现役配置面。用户文件为 YAML，项目文件为 TOML，不能直接互换。读取时使用 config/read 检查 config、origins 和 layers；写入时使用同一次读取的版本，避免覆盖并行修改。
常用配置字段
| 字段 | 范围与类型 | 用途 |
|---|---|---|
| default_provider | 用户；字符串 | 默认提供商选择 |
| agent.default_model | 用户；字符串 | 默认模型 ID |
| model_reasoning_effort | 用户/已接入项目；可选枚举 | 模型推理强度 |
| model_reasoning_summary | 用户/已接入项目；枚举 | 推理摘要偏好 |
| model_verbosity | 用户/已接入项目；可选枚举 | 输出详略偏好 |
| approval_policy | 用户/项目；on-request 或 never | 审批策略 |
| sandbox_mode | 用户/项目；read-only、workspace-write、danger-full-access | 命令执行范围 |
| sandbox_workspace_write | 用户/项目；对象 | 工作区可写策略 |
| default_permissions | 用户；可选字符串 | 默认具名权限档案 |
| permissions.<name> | 用户；对象 | 权限档案继承、文件系统和网络 |
| projects.<absolute-path>.trust_level | 用户；trusted 或 untrusted | 项目配置激活的信任来源 |
| shell_environment_policy | 用户/已接入项目；对象 | 命令进程环境策略 |
| web_search | 用户/已接入项目；可选枚举 | 已支持的网页搜索模式 |
能力与界面
| 字段 | 说明 |
|---|---|
| features | 可选能力；通过功能目录确认实际支持键 |
| tui.animations | 终端动画 |
| tui.status_line | 状态行字段 ID 的有序列表 |
| tui.terminal_title | 终端标题字段 ID 的有序列表 |
| tui.keymap | global、pager、agents、list、editor、Vim 等上下文键位 |
| desktop | 桌面显示与行为偏好 |
| browser / browser_use / computer_use | 浏览器与计算机使用偏好；授权仍需单独检查 |
| worktrees | 托管工作树设置 |
| skills.config | 按 path 或 name 启用/禁用技能 |
| plugins / marketplaces | 插件启用与市场配置 |
| memory | 本地记忆启用、来源、保留与自动整理 |
管理员要求
requirements.toml 只能由管理员控制。Unix 使用 /etc/lime/requirements.toml，Windows 使用 ProgramData/Lime/requirements.toml。用户文件、项目文件和 RPC 参数不能指定管理员 authority。
toml
allowed_approval_policies = ["on-request"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
allowed_web_search_modes = ["disabled", "cached"]
[in_app_browser]
allow_external_browser_settings_import = false当前支持项由 configRequirements/read 返回。配置缺失时 requirements 可为 null；非法或空的审批/沙盒允许列表会拒绝加载。浏览器和计算机策略只收窄范围，不自动授予系统权限。
配置兼容边界
Lime 不读取参考产品的云端策略服务、个人套餐、托管额度或专属配置档案。不要复制其中的模型名、账号域名、otel 指标和 AWS 内置提供商设置。未知字段不会通过另建兼容文件生效。
验证配置
- 读取目标 cwd 的有效配置与来源。
- 核对管理员允许范围及运行平台就绪状态。
- 在新线程中检查模型、权限和工具发现。
- 执行一项小型只读任务，再验证所需写入或外部操作。