1. 项目定位与用途
AIO Sandbox 是一个面向 AI Agent 的全能沙盒环境，旨在提供一站式、安全、统一的执行环境。它通过单 Docker 容器将浏览器自动化、终端 Shell、文件操作、MCP 协议服务和 VSCode Server 紧密集成，使 AI Agent 和开发者能够在同一环境中无缝切换和协同使用多种工具，无需复杂配置。
项目档案文档型项目
agent-infra/sandbox 文档/知识库：适合谁看、怎么使用
agent-infra/sandbox：AIO Sandbox 是一个面向 AI Agent 的全能沙盒环境，通过单 Docker 容器集成浏览器、终端、文件系统、MCP 服务和 VS本页整理它适合谁看、核心内容和站内延伸入口。
AI 总结
AIO Sandbox 是一个面向 AI Agent 的全能沙盒环境，通过单 Docker 容器集成浏览器、终端、文件系统、MCP 服务和 VSCode Server，提供统一文件系统和零配置开发体验，实现多工具协同的安全执行环境。
中文项目介绍
AIO Sandbox 是一个面向 AI Agent 的全能沙盒环境，旨在解决传统单一功能沙盒在文件共享和功能协调上的挑战。它通过单 Docker 容器集成浏览器自动化、终端 Shell、文件系统操作、MCP 协议服务和 VSCode Server，提供统一文件系统和零配置开发体验。
项目解决了浏览器下载的文件无法在 Shell 中直接访问、多个沙盒间数据孤岛等问题，实现多工具协同的安全执行环境。
适用场景包括 AI Agent 开发与测试、浏览器自动化与网页抓取、代码执行与调试、文件系统操作、MCP 协议服务部署以及多工具协同工作流自动化。
技术特征基于云原生轻量级沙盒技术，支持 Python、TypeScript 和 Golang SDK，提供 VNC、VSCode、Jupyter 和 Terminal 等多种访问接口，并预配置 MCP 服务器和开发工具，确保安全隔离和即开即用。
详细信息与使用说明
2. 解决的问题
传统沙盒通常为单一功能设计（如仅浏览器或仅代码执行），导致文件共享困难、功能协调复杂。AIO Sandbox 通过统一文件系统确保浏览器下载的文件即时对 Shell 和文件操作可见，消除数据孤岛；同时预配置 MCP 服务器和开发工具，实现零配置启动和多接口（VNC、VSCode、Jupyter）统一访问，大幅降低 AI Agent 的集成与部署成本。
3. 适用场景
主要适用于：AI Agent 开发与测试，提供标准化的执行环境；浏览器自动化与网页抓取，结合文件操作保存结果；代码执行与调试，集成 VSCode Server 和 Jupyter；文件系统操作与管理，跨模块共享数据；MCP 协议服务部署，为 Agent 提供工具调用能力；以及多工具协同工作流自动化，如浏览器操作后立即在终端处理文件。
4. 安装方式
支持 Docker 直接运行和 SDK 集成两种方式。Docker 运行命令为：docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:latest（中国大陆用户可使用镜像 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest）。SDK 安装：Python 使用 pip install agent-sandbox；TypeScript 使用 npm install @agent-infra/sandbox；Golang 使用 go get github.com/agent-infra/sandbox-sdk-go。
5. 使用方式
容器启动后，可通过以下方式访问：API 文档位于 http://localhost:8080/v1/docs；VNC 浏览器界面位于 http://localhost:8080/vnc/index.html?autoconnect=true；VSCode Server 位于 http://localhost:8080/code-server/；MCP 服务端点位于 http://localhost:8080/mcp。使用 SDK 时，初始化客户端后可调用 shell.exec_command、file.read_file、browser.screenshot 等方法进行交互，示例代码见 examples 目录。
6. 补充说明与实现特点
项目基于云原生轻量级沙盒技术构建，确保 Python 和 Node.js 执行的安全隔离。提供零配置体验，预装 MCP 服务器和开发工具。支持多版本 Docker 镜像选择，并针对中国大陆用户提供加速镜像。仓库包含丰富的示例（examples）和评估套件（evaluation），涵盖文件操作、浏览器集成、代码执行等场景，便于开发者快速验证和集成。
思维导图
AIO Sandbox
核心模块
Browser
Shell
File
MCP
VSCode Server
Jupyter
技术特征
统一
常见问题
agent-infra/sandbox 是做什么的？
AIO Sandbox 是一个面向 AI Agent 的全能沙盒环境，通过单 Docker 容器集成浏览器、终端、文件系统、MCP 服务和 VSCode Server，提供统一文件系统和零配置开发体验，实现多工具协同的安全执行环境。
agent-infra/sandbox 适合用在什么场景？
AIO Sandbox 是一个面向 AI Agent 的全能沙盒环境，旨在提供一站式、安全、统一的执行环境。它通过单 Docker 容器将浏览器自动化、终端 Shell、文件操作、MCP 协议服务和 VSCode Server 紧密集成，使 AI Agent 和开发者能够在同一环境中无缝切换和协同使用多种工具，无需复杂配置。
agent-infra/sandbox 如何安装？
支持 Docker 直接运行和 SDK 集成两种方式。Docker 运行命令为：docker run --security-opt seccomp=unconfined --rm -it -p 8080:8080 ghcr.io/agent-infra/sandbox:latest（中国大陆用户可使用镜像 enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest）。SDK 安装：Python 使用 pip install agent-sandbox；TypeScript 使用 npm install @agent-infra/sandbox；Golang 使用 go get github.com/agent-infra/sandbox-sdk-go。
agent-infra/sandbox 如何开始使用？
容器启动后，可通过以下方式访问：API 文档位于 http://localhost:8080/v1/docs；VNC 浏览器界面位于 http://localhost:8080/vnc/index.html?autoconnect=true；VSCode Server 位于 http://localhost:8080/code-server/；MCP 服务端点位于 http://localhost:8080/mcp。使用 SDK 时，初始化客户端后可调用 shell.exec_command、file.read_file、browser.screenshot 等方法进行交互，示例代码见 examples 目录。