跳到正文

权限配置档案

按任务选择文件和网络访问范围,并验证当前环境是否支持。

定义并选择权限

权限档案把一项任务需要的文件与网络范围组合起来。先读取当前可用档案,选择足够完成目标的最小范围。

内建档案使用场景
:read-only检查代码、整理材料,任务不需要更改工作区。
:workspace在当前工作空间中编辑文件和运行项目命令。
:danger-full-access移除本地沙盒边界,仅在已明确授权并有外层隔离时使用。
bash
lime --permissions :read-only
lime --permissions :workspace

扩展命名档案

团队有重复任务边界时可以配置命名档案,以内建档案或已有命名档案作为基础。只增加当前需要的文件权限和网络设置。未知父档案、循环继承和非法授权会被拒绝。

命名档案使用 Lime 支持的配置格式。不要把其他客户端的 TOML 路径表直接粘贴为 Lime 配置;保存后重新读取有效设置与当前可用状态。

理解文件系统权限

权限含义
read读取指定路径。
write允许在执行后端支持的范围修改文件。
deny / none排除不应访问的路径,具体写法按配置 Schema。

用精确路径保护秘密与身份材料。需要修改多个目录时分别确定范围,不把用户主目录整体作为工作区。通配符的匹配与新文件保护依赖后端,应以实际拒绝测试验证。

区分网络开关与目标限制

允许命令使用网络与限制网络目标是两件事。应用连接、MCP、浏览器、网页搜索和模型调用也有各自连接。不要把档案中开启网络理解为全部目标已经审核。

  • 列出必要目标与禁止目标。
  • 验证公网、私网、环回与间接连接。
  • Docker 或其他本地套接字可能授予主机管理能力,按独立高权限入口审查。
  • 采用组织网关或主机网络控制补充执行路径未覆盖的限制。

与显式沙盒参数二选一

同一请求不要同时指定权限档案和显式沙盒策略。CLI 会在连接前拒绝冲突的权限组;默认档案仅在没有显式选择时生效。

bash
lime --permissions :workspace
# 另一种独立选择:
lime --sandbox workspace-write --ask-for-approval on-request

验证适用范围与故障

档案可用性由当前工作目录、平台后端、全局策略及管理员要求共同决定。受限后端不可用时,目录中的只读或工作空间档案可能不可选;不要用相似名称绕过限制。

  • 在新任务、恢复任务和直接命令入口分别测试。
  • 执行一个应允许操作与一个应拒绝操作。
  • 保存后查看实际生效值,检查受管来源。
  • 权限被拒绝时保留错误与环境信息,修正范围或环境后再运行。