高级配置

分层与配置来源

先用 config/read 的 cwd 选择项目上下文，includeLayers 可用于检查配置来源。用户 YAML 是全局默认，项目 TOML 只覆盖可信项目的新线程默认值，线程和轮次的显式设置作用于当前会话。管理员要求在执行前重新校验。

当前 CLI 没有通用配置档案文件或原始 TOML 覆盖参数。需要可复用权限时使用具名权限档案；需要隔离用户配置时让进程读取明确的 LIME_CONFIG_PATH。

配置与状态的存储

用户设置位于系统配置目录的 lime/config.yaml；LIME_HOME 管理智能体工作目录相关状态，两者职责不同。会话历史、记忆、凭据与日志不应混作可随意复制的配置包。迁移前先检查目标路径、版本与敏感内容。

项目配置

项目 .lime/config.toml 从最近 Git 根到 cwd 分层加载。信任记录位于用户配置 projects.<absolute-path>.trust_level。未信任项目不会激活项目层，项目不能通过配置扩大管理员允许范围。

通过 config/value/write 或 config/batchWrite 写入项目文件时，使用绝对 filePath 和读取到的版本。写入保护注释及无关字段，未知键、CAS 冲突与无法安全编辑的结构都会失败；冲突后重新读取并合并。

项目指南与角色

AGENTS.md 保存长期规则，技能保存流程。需要专业分工时，在主任务中明确每个智能体的职责、模型要求、文件范围和交付形式。不要把其他产品的 agents TOML 角色文件或并发设置粘贴为 Lime 配置。

自定义模型提供商

在提供商设置中配置 endpoint、凭据和模型，先验证文本请求，再验证工具调用和所需媒体。能力来自提供商显式声明、模型目录和实际 wire 协议的交集，不能通过模型名称推断。

推理、输出与限制

model_reasoning_effort、model_reasoning_summary 和 model_verbosity 控制已支持模型的请求偏好。能力不支持的值不能假定会被接受。结构化最终输出使用 CLI --output-schema 或 turn/start.outputSchema。Token 预算与上下文长度是不同限制，应分别查看模型与线程状态。

审批与沙盒

审批 on-request 可在需要时请求决定；never 不会显示新的人工审批，因此未获准操作可能直接失败。沙盒有 read-only、workspace-write 与 danger-full-access。文件写入范围、网络访问与系统后端就绪状态需要同时核对。

具名权限档案使用用户 YAML 的 permissions，支持 extends、filesystem.entries 和 network.enabled。default_permissions 选择默认档案；CLI --permissions 显式选择。不要同时传入权限档案与显式沙盒，未知档案、继承环和非法授予会拒绝。

Shell 环境策略

命令进程会继承经过策略处理的环境。只传递所需变量，令牌、凭据和代理设置需按进程范围检查。shell_environment_policy 可配置继承与过滤；更改后在实际执行环境中验证，桌面进程与登录 shell 的环境可能不同。

MCP 与钩子

MCP 连接由同一工具运行时管理，在连接设置检查 transport、启动参数、凭据和发现结果。钩子用于确定性的生命周期检查；项目钩子同样受信任边界控制。连接配置存在不等于服务已启动，钩子成功也不代替业务结果。

可观测性

Lime 的本地日志与诊断用于定位请求、工具和状态问题。先保留时间、线程 ID、模型、工具名和脱敏错误，再根据实际启用的日志配置扩大范围。参考产品的专属 OTel 指标名、默认云端遥测和额度事件不属于 Lime 的监控合同。

不要在日志中记录 API 密钥、完整请求正文或私人文件。推理摘要是否可见由模型和提供商决定，隐藏界面展示不改变外部服务的处理方式。

通知与历史

桌面通知、终端提示和任务事件是不同通道。历史恢复使用 canonical 线程，不把终端滚动缓冲当作会话存储。归档、删除、压缩和回退有不同影响；回退聊天历史不会自动还原磁盘文件。

桌面与终端偏好

桌面外观使用浅色、深色或跟随系统。终端可配置已支持的快捷键、状态行和窗口标题；不继承自定义主题文件。文件打开、编辑器和界面偏好使用设置中的现役入口。