用途：为 PPIO Agent Sandbox 编写与排错 Python、JavaScript/TypeScript 及 CLI 代码，提供准确的客户端入口、方法名、参数与等价命令。权威来源为 https://ppio.com/docs/sandbox/overview，变更见 https://ppio.com/docs/announcement/changelog-agent-sx。
主要能力：客户端入口统一为 PPIO client，操作走 ppio.sandbox.*。Python 示例 from ppio_sandbox import PPIO；ppio = PPIO()；sandbox = ppio.sandbox.create()。JS/TS 示例 import { PPIO } from 'ppio-sandbox'；const ppio = new PPIO()；const sandbox = await ppio.sandbox.create()。CLI 命令均为 ppio sandbox <verb>。JS 方法为 camelCase（getInfo、setTimeout、getEvents），Python 为 snake_case（get_info、set_timeout、get_events）；JS 时间单位为毫秒（timeoutMs），Python 为秒（timeout）。覆盖域选择、沙箱创建/运行命令/列表/连接/暂停恢复/终止/超时/长时运行/空闲超时/信息指标事件、网络访问（禁用互联网、出口规则、服务 URL）、受控访问、模板定义构建标签列表删除、快照、文件系统读写监控上传下载、密钥、卷、Git、PTY、日志流、Computer Use，以及 CLI 与共享参数参考。
必要用法：需 SDK/CLI >= 2.1.0。Python：pip install "ppio-sandbox>=2.1.0"（Python 3.10+）；JS/TS：npm i ppio-sandbox@^2.1.0（Node.js 20+）；CLI：npm i -g ppio-sandbox-cli@^2.1.0。三端均需在环境变量设置 PPIO_API_KEY。更新技能：npx skills add PPIO/ppio-skills --skill ppio-sandbox，随后重启会话。
限制：沙箱不再需要时须用 sandbox.kill() 释放，否则会持续计费至超时；沙箱内服务建议绑定 0.0.0.0，选择公开或令牌保护访问；控制器安全为独立设置。仓库内 SDK 代码可能落后于文档。具体地区列表、各操作参数细节及外部集成指南（Tailscale、OpenVPN、Browser Use、Codex、OpenAI Agents API、代理加速、S3 挂载、SSH 等）需查阅对应参考文件或文档页面；资料未提供的内容暂未说明。