沙箱为智能体生成的命令提供受限的执行环境，确保智能体在安全隔离的环境中运行命令，防止未经授权的文件访问。 ## 支持的操作系统 * macOS * Windows（包括 Windows 原生系统以及 Remote WSL 2） * Linux：Debian 10 及以上、Ubuntu 20.04 及以上（TRAE 暂不支持 Linux 客户端，需通过 Remote SSH 和 Bubblewrap 实现） ## 安全策略：文件访问控制 :::tip 提示 * 当前安全策略不涉及网络访问。 * 读写权限继承当前用户权限；当读写与只读权限冲突时，以只读权限为准。 ::: 启用沙箱后，TRAE 的文件目录访问权限如下： |**权限类型** |**目录类型** |**目录列表** | |---|---|---| |只读 |项目目录中的受保护目录 |`.vscode` | |^^|根目录 |`/`（默认策略：所有未显式声明为可写的目录均为只读） | |读写 |项目目录 |除 `.trae`、`.vscode` 和 `.git` 之外的项目文件与目录 | |^^|临时目录 |* macOS：`/tmp`、`/var/folders`、`TMPDIR` 环境变量路径|\ | | |* Windows：`~/AppData/Local/Temp`、`~/AppData/LocalLow/Temp`|\ | | |* Linux：`/tmp`、`TMPDIR` 环境变量路径 | |^^|缓存目录 |* macOS：`~/Library/Caches`、`~/.cache`、`XDG_CACHE_HOME` 环境变量路径|\ | | |* Linux：`~/.cache`、`XDG_CACHE_HOME` 环境变量路径 | |^^|通用工具依赖目录 |* macOS & Linux：`~/.local/lib`、`~/.local/bin`、`~/.local/share`（通常用于 pip、uv/uvx、npm/pnpm、cmake 等工具的依赖目录）|\ | | |* Windows：`LOCALAPPDATA` 环境变量路径内的常见工具依赖的路径（pip、uv/uvx、npm/pnpm 等） | |^^|常用语言的工具链及其依赖目录 |Go、Java、Python、Node.js、Rust 和 C++ 等常用语言的工具链及其依赖目录。 | ## 使用流程 ### 第一步：在操作系统中配置环境使用沙箱前，需要根据你所使用的操作系统，完成相应的环境配置。 ```mixin-react return ( ); ``` ### 第二步：在 TRAE 中启用沙箱在 TRAE 中启用沙箱后，智能体将自动在沙箱中运行命令。启用沙箱的步骤如下： 1. 在 IDE 模式界面中，点击界面右上角的 **设置** 图标，进入设置中心。或在 SOLO 模式界面中，点击对话面板右上角的 **设置** 图标，进入设置中心。 2. 在左侧导航栏中，选择 **对话流**，进入 **对话流** 面板。 3. 在 **自动运行** 部分的 **自动运行命令** 处，为 IDE 和/或 SOLO 模式选择 **沙箱运行（支持白名单）** 模式。 4. 在 **白名单作用于** ** IDE / SOLO** 处，按需将命令前缀加入白名单。白名单中的命令将跳过沙箱，直接在沙箱外执行。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/cfe233ecd4f547fd92658313a829a892 =700x) ## 高风险命令的运行策略在智能体运行过程中，若检测到高风险命令，系统会在对话流中提示。你可以按需选择： * **跳过**：跳过该命令，不运行。 * **添加 { runningCommandList} 到白名单**：将该命令的前缀添加到白名单，之后可在沙箱外运行相关命令。 * **运行**：本次在沙箱内运行该命令。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/8f7b6505f8344c6885079c70b6e7a7f1 =700x)

TRAE CN