用途：为 Novita Agent Sandbox 编写正确、符合习惯的代码并排查问题，覆盖 Python、JavaScript/TypeScript 与 novita CLI 三种方式，提供准确的客户端入口、方法名、参数和等价 CLI 命令。权威来源为 https://docs.novita.ai，版本变更见 https://docs.novita.ai/changelog。
主要能力：沙箱生命周期（创建、连接、暂停/恢复、终止、超时、空闲超时、长时运行）、命令执行（前台、后台、流式）、列表与信息/指标/事件、网络访问（禁用互联网、出口规则、服务 URL、Host 头掩码）、安全控制器访问；模板定义、构建、标签、列表删除；快照创建与恢复；文件系统读写、目录监听、上传下载；密钥管理；持久卷；以及 Git、PTY、日志流、Computer Use 虚拟桌面等集成。
使用方式：所有 SDK 调用经 Novita 客户端，再调用 novita.sandbox.*。Python 用 from novita_sandbox import Novita，novita = Novita()，sandbox = novita.sandbox.create()；JS/TS 用 import { Novita } from 'novita-sandbox'，const novita = new Novita()，const sandbox = await novita.sandbox.create()；CLI 命令为 novita sandbox <verb>。需设置 NOVITA_API_KEY。要求 SDK/CLI >= 2.1.0：Python 用 pip install "novita-sandbox>=2.1.0"（Python 3.9+），JS/TS 用 npm i novita-sandbox@^2.1.0（Node.js 20+），CLI 用 npm i -g novita-sandbox-cli@^2.1.0。注意 JS 方法为 camelCase、时间单位为毫秒，Python 为 snake_case、时间单位为秒。
适用场景：在沙箱中运行命令与代码、构建可复用模板、保存恢复状态、管理文件与密钥、挂载持久卷，以及 Git、交互终端、日志流、虚拟桌面等集成任务。
限制：资料未提供具体收费、价格与效果数据；部分操作在旧版本缺失或行为不同，需先升级；示例假设已初始化 Novita 客户端；不再需要的沙箱应调用 sandbox.kill() 释放，否则会持续计费至超时；API 密钥建议通过环境变量传入而非硬编码。