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

沙箱能做什么

运行代码

专家可以编写并执行代码,支持 Python、JavaScript/TypeScript、Shell 等多种语言

构建网站

基于预装的 Web 开发框架,专家可以创建网站并提供实时预览

处理文件

读写文件、解析数据、生成文档——沙箱拥有完整的文件系统

安装依赖

专家可以按需安装额外的软件包和工具

预装环境

沙箱镜像预装了常用的开发工具和框架,专家到手即可使用:
  • Bun:JavaScript/TypeScript 运行时与包管理器
  • Python:常用数据科学和脚本工具
  • Node.js:JavaScript 运行时
  • 常用系统工具:curl、jq 等

沙箱的隔离性

每个用户与专家的组合拥有独立的沙箱环境:
  • 用户隔离:你的沙箱与其他用户完全隔离,彼此不可见
  • 专家隔离:不同专家的沙箱也是隔离的,专家 A 的文件不会出现在专家 B 中
  • 安全边界:沙箱内的代码执行受到资源限制和安全策略保护
沙箱是云端环境,不要在其中存储敏感密码或密钥。如需使用第三方服务,建议使用环境变量。

按需启动

沙箱采用懒加载(lazy start)策略——只在需要时才启动资源密集型服务:
  1. 纯文字对话:不启动沙箱,不消耗执行环境资源
  2. 需要执行代码:自动启动沙箱(通常几秒内就绪)
  3. 需要预览网站:在沙箱启动后按需启动开发服务器
这种设计确保你只在真正需要时才占用计算资源,普通的问答对话不会产生额外开销。
首次启动沙箱可能需要几秒钟等待。后续交互中,沙箱保持活跃状态,响应会更快。

文件持久化

沙箱使用**持久化云文件系统(CFS)**存储文件:
  • 专家生成的代码、文档、图片等文件会自动保存
  • 关闭浏览器后文件不会丢失
  • 下次打开同一专家的对话,之前的文件还在
  • 同一专家的多个会话共享同一个工作区文件系统

文件同步

在对话过程中,专家创建或修改的文件会自动同步到你的文件面板。你可以在对话界面右侧的文件浏览器中:
  • 查看文件目录结构
  • 打开和阅读文件内容
  • 下载文件到本地

网站预览

当专家构建网站时,你可以在对话界面右侧的预览面板中实时查看效果:
  • 实时刷新:专家修改代码后,预览自动更新
  • 热更新:支持 HMR(Hot Module Replacement),修改即时生效
  • 全屏查看:可以将预览面板扩展为全屏模式
预览面板只在专家启动了开发服务器后才会出现。如果你需要预览,可以告诉专家「帮我预览网站」。

存储限制

沙箱的存储空间受你的套餐限制:
具体存储配额以产品内实时显示为准。超出限制时,你可以清理不需要的文件或升级套餐。

沙箱与 Sites 插件

如果你启用了 Sites 插件,专家构建的网站可以发布到公网:
  1. 专家在沙箱中完成网站开发
  2. 你在预览面板确认效果
  3. 点击「发布」按钮
  4. 网站部署到公网,获得可访问的 URL
网站发布需要你的确认——专家不会自动发布,你始终掌控发布决策。

下一步

会话与工作区

了解会话与工作区之间的关系

插件

了解专家可用的插件和工具能力