Sine Box / 私有工作空间
为文件、代码和命令准备独立工作空间。
为应用或智能体提供自己的工作环境。轻量命令可以选择 Lite，需要 Linux 的任务可以选择 Sandbox，并统一管理私有文件、执行记录与快照恢复。
可以用它做什么
按任务选择环境
Lite 提供受支持的轻量 shell 与文件操作。需要完整 Linux 环境时可选择 Sandbox，并主动启动已资助的运行窗口。
让文件与结果保持在一起
通过控制台或 API 读写私有工作空间文件，同时查看已保存的命令输出、退出状态和执行历史，核对任务实际生成的结果。
通过快照继续工作
创建并检查工作空间备份、读取已保存文件，或从快照恢复。恢复过程保留明确状态，便于确认结果后继续任务。
Sine Box
从控制台开始使用
适合你的工作流程
- 私有文件处理与轻量自动化
- 需要独立 Linux 环境的任务
- 为已授权智能体会话提供专用工作空间
创建 Box
创建工作空间时选择 Lite 或 Sandbox。保存 Box 的基本信息不会启动虚拟机，也不会执行命令。
准备文件与运行环境
加入任务所需文件，检查权限、可用积分和预计预留。使用 Sandbox 时，需要主动启动已资助的运行窗口。
执行并检查结果
提交命令后保留执行 ID，查看输出和最终状态。连接中断时查询同一次执行，避免重复提交任务。
只读 API 示例
通过 API 读取你的工作空间。
修改文件或提交命令前，可以先读取文件列表。此请求只读取工作空间，不启动 Sandbox，也不运行代码。
export SINE_CLOUD_URL="https://sinecloud.dev"
curl "$SINE_CLOUD_URL/api/products/sine-box/boxes/$BOX_ID/workspace/files?path=%2Fworkspace" \
-H "Authorization: Bearer $SINE_CLOUD_API_KEY"将 BOX_ID 设置为已创建的 Box ID。Cloud API Key 需要具备该工作空间的 Box fileRead 权限，且当前生命周期允许读取文件。
请在安全的环境变量中设置 SINE_CLOUD_API_KEY，并授予所需产品权限。密钥只应保存在服务端，不要放入浏览器代码。
权限与计费
工作空间权限
工作空间权限由组织与具体 Box 共同限定。不同运行时可能需要独立的发布审批和可用容量；文件访问、命令执行及运行时管理分别检查所需权限。