> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 沙箱

> 每个专家都有一个隔离的云端开发环境

沙箱（Sandbox）是专家的**隔离云端执行环境**。每当你与专家进行需要执行代码或管理文件的对话时，平台会自动为你分配一个沙箱。你不需要安装任何软件、配置任何环境——一切开箱即用。

## 沙箱能做什么

<CardGroup cols={2}>
  <Card title="运行代码" icon="play">
    专家可以编写并执行代码，支持 Python、JavaScript/TypeScript、Shell 等多种语言
  </Card>

  <Card title="构建网站" icon="globe">
    基于预装的 Web 开发框架，专家可以创建网站并提供实时预览
  </Card>

  <Card title="处理文件" icon="file-lines">
    读写文件、解析数据、生成文档——沙箱拥有完整的文件系统
  </Card>

  <Card title="安装依赖" icon="download">
    专家可以按需安装额外的软件包和工具
  </Card>
</CardGroup>

## 预装环境

沙箱镜像预装了常用的开发工具和框架，专家到手即可使用：

<Tabs>
  <Tab title="运行时">
    * **Bun**：JavaScript/TypeScript 运行时与包管理器
    * **Python**：常用数据科学和脚本工具
    * **Node.js**：JavaScript 运行时
    * 常用系统工具：curl、jq 等
  </Tab>

  <Tab title="Web 开发">
    沙箱预装了 Web 开发脚手架：

    * 基于现代 Web 框架的项目模板
    * `node_modules` 已预安装（省去安装等待时间）
    * 支持热更新（HMR）的开发服务器

    <Tip>
      Web 开发脚手架存放在沙箱的 `/home/user/project/web/` 目录。专家执行开发工作时会在独立的工作目录中操作。
    </Tip>
  </Tab>
</Tabs>

## 沙箱的隔离性

每个用户与专家的组合拥有独立的沙箱环境：

* **用户隔离**：你的沙箱与其他用户完全隔离，彼此不可见
* **专家隔离**：不同专家的沙箱也是隔离的，专家 A 的文件不会出现在专家 B 中
* **安全边界**：沙箱内的代码执行受到资源限制和安全策略保护

<Warning>
  沙箱是云端环境，不要在其中存储敏感密码或密钥。如需使用第三方服务，建议使用环境变量。
</Warning>

## 按需启动

沙箱采用**懒加载**（lazy start）策略——只在需要时才启动资源密集型服务：

1. **纯文字对话**：不启动沙箱，不消耗执行环境资源
2. **需要执行代码**：自动启动沙箱（通常几秒内就绪）
3. **需要预览网站**：在沙箱启动后按需启动开发服务器

这种设计确保你只在真正需要时才占用计算资源，普通的问答对话不会产生额外开销。

<Note>
  首次启动沙箱可能需要几秒钟等待。后续交互中，沙箱保持活跃状态，响应会更快。
</Note>

## 文件持久化

沙箱使用\*\*持久化云文件系统（CFS）\*\*存储文件：

* 专家生成的代码、文档、图片等文件会自动保存
* 关闭浏览器后文件不会丢失
* 下次打开同一专家的对话，之前的文件还在
* 同一专家的多个会话共享同一个工作区文件系统

### 文件同步

在对话过程中，专家创建或修改的文件会自动同步到你的文件面板。你可以在对话界面右侧的文件浏览器中：

* 查看文件目录结构
* 打开和阅读文件内容
* 下载文件到本地

## 网站预览

当专家构建网站时，你可以在对话界面右侧的预览面板中实时查看效果：

* **实时刷新**：专家修改代码后，预览自动更新
* **热更新**：支持 HMR（Hot Module Replacement），修改即时生效
* **全屏查看**：可以将预览面板扩展为全屏模式

<Tip>
  预览面板只在专家启动了开发服务器后才会出现。如果你需要预览，可以告诉专家「帮我预览网站」。
</Tip>

## 存储限制

沙箱的存储空间受你的套餐限制：

| 套餐   | 存储空间     |
| ---- | -------- |
| 免费版  | 基础存储空间   |
| 付费套餐 | 更大存储空间   |
| 团队版  | 团队共享存储配额 |

<Note>
  具体存储配额以产品内实时显示为准。超出限制时，你可以清理不需要的文件或升级套餐。
</Note>

## 沙箱与 Sites 插件

如果你启用了 Sites 插件，专家构建的网站可以发布到公网：

1. 专家在沙箱中完成网站开发
2. 你在预览面板确认效果
3. 点击「发布」按钮
4. 网站部署到公网，获得可访问的 URL

<Note>
  网站发布需要你的确认——专家不会自动发布，你始终掌控发布决策。
</Note>

## 下一步

<CardGroup cols={2}>
  <Card title="会话与工作区" icon="comments" href="/zh/documentation/concepts/sessions-and-workspace">
    了解会话与工作区之间的关系
  </Card>

  <Card title="插件" icon="plug" href="/zh/documentation/concepts/plugins">
    了解专家可用的插件和工具能力
  </Card>
</CardGroup>