开发者设置

选择设置层

常用偏好使用 Lime 设置页面，稳定项目约定使用 AGENTS.md，需要精确版本化的项目配置使用 .lime/config.toml。用户配置是系统配置目录中的 lime/config.yaml，LIME_CONFIG_PATH 可指定其路径。LIME_HOME 不等于用户 YAML 文件位置。

项目与终端

确认项目目录、工作树、本地环境初始化和实际 Shell。终端的环境与智能体运行环境可能不同；修改默认终端或工具安装后，用新进程检查 PATH、目录和版本。不要假定已有终端自动继承新设置。

模型与推理

在模型目录中选择实际可用的提供方、模型和推理强度，先验证文本请求，再验证工具与附件。模型声明和实际协议能力需要一致；目录中没有的服务层级不能通过任意字符串启用。

单次运行覆盖

lime exec --cd /path/to/project --sandbox read-only "检查当前项目，说明测试入口"
lime --provider <PROVIDER_ID> --model <MODEL_ID> --effort <EFFORT>

使用当前命令已定义的专用参数。Lime 不提供任意 -c key=value 或通用 --profile 覆盖；需要持久默认时在对应配置层修改并检查有效值。

配置来源与快照

config/read 可读取合并结果及 origins/layers。用户层、可信项目层、会话覆盖与管理员要求各自负责不同范围。项目不能自授信任，管理员限制也不能由用户配置或 RPC 扩大。

新线程冻结有效默认，已有线程可能继续使用其快照。修改后分别检查当前线程和新线程的实际返回配置。写入使用版本比较；冲突时先读取最新配置。

权限

通过命名权限档案或受支持沙盒模式设置文件与网络范围，审批策略另行控制何时请求额外授权。TUI 使用 /permissions PROFILE，/status 查看当前值。自动审查、人工审批和完全访问应有不同的明确选择。

审查与 Git

用 lime review 选择差异范围，并在 AGENTS.md 保存实际仓库的审查与验证规则。Git 身份、分支保护、提交和推送仍通过仓库既有流程；界面偏好或默认提示词不代表用户已授权远端写入。

MCP、技能与插件

通过统一连接控制面管理外部工具，并检查安装、启用、身份和实际调用状态。技能与插件的指令影响工作方式，服务端授权决定能访问什么。不要在项目配置中分发个人令牌。

浏览器开发权限

完整 CDP 能力用于性能诊断和深层浏览器调试，需要当前浏览器适配器、来源权限与明确批准。组织禁止时，本地开关不能绕过。站点工具、普通网页访问、截图与完整 CDP 是不同能力，分别核对范围。

TUI 显示偏好

偏好是否持久保存取决于具体入口。需要新会话默认时检查用户配置中的 tui 字段；不要写入不存在的终端主题或桌面皮肤字段。

编辑器边界

可以在你惯用的编辑器中修改项目，并让 Lime 读取明确文件或差异。Lime 当前没有可安装的独立 IDE 扩展，也不提供专属编辑器设置键、CodeLens、自动共享选区或与桌面聊天同步的扩展设置。

排查顺序

1. 确认实际运行的客户端与 App Server 版本。
2. 读取有效配置、来源、信任与管理员要求。
3. 检查当前线程快照。
4. 分别验证模型、工具、网络和文件权限。
5. 保留脱敏错误与关联 ID，再修改根因。