用途:通过 API 或 CLI 管理 Boat(boat.dev,原 Ascii 的 Box)云沙箱,可在虚拟机内使用 SSH 或命令 API。涉及直接 API 调用、凭据变更或恢复前,应先阅读操作与观察说明及认证示例。
主要能力:识别账户与目标(核对账户、组织、沙箱、仓库,复用已有映射);加载 BOAT_API_KEY(从环境或项目文档化的 gitignore 凭据文件,不假设通用路径、不搜索无关凭据库、不打印凭据);用 GET /me、/limits、/sandboxes 或 CLI boat status、boat list 检查认证与状态;环境与模板管理(环境保存仓库、密钥与凭据权限,命名快照/模板保存已装工具与磁盘状态);隔离与凭据控制(个人沙箱只授予必要凭据/仓库,第三方使用需选 safeForThirdParties: true 的环境或 noEnv: true 创建)。
使用方式:本地 CLI 用 command -v boat 定位,旧安装可能只有 box;设置 BOAT_ID 后运行 boat --no-update --json status、list --all、info "$BOAT_ID"、ssh "$BOAT_ID" 等,--json 输出结构化结果,--no-update 跳过更新检查。API 基址 https://boat.dev/api/v1,请求头 Authorization: Bearer $BOAT_API_KEY,JSON 体用 Content-Type: application/json。安装不会自动登录,可用 boat login --key-stdin 经 stdin 传入令牌,勿用参数传递。
限制:账户级操作需账户密钥,机器级密钥仅覆盖其沙箱;创建受限密钥需浏览器登录或管理员令牌,轮换与撤销受会话限制。保存环境会创建版本,已有沙箱不会自动获得,升级可能影响多个沙箱并删除被扣留的密钥,重钉旧版本不恢复已删文件。受保护模式为单向转换并清除受管凭据文件,但不清理任意磁盘内容。文档不能证明认证操作成功,需在沙箱内实际验证。价格、限制、模型目录与安装命令应实时查询。缺失信息暂未提供。