SuperAPI AI 工具集

devboxes

测试与质量

查看项目

更新于 10-16 01:33

技能介绍

该技能介绍如何通过 devbox 或 boxctl 操作 Namespace devboxes,即远程 linux/amd64 或 macos/arm64 机器,Linux 机器提供 Docker。主要用于创建开发机、传输文件、准备 workspace、安装工具链、执行命令、通过 devbox.so 共享网页工作,以及管理生命周期。

使用前先判断当前是否已在 devbox 上,可检查环境变量 NAMESPACE_DEVBOX_WORKSPACE_DIR;若在机器内,普通命令无需包装,两个 CLI 已位于 ~/.devbox/bin,且不要运行 devbox login。

创建示例:devbox create --name <name> [--platform <linux/amd64|macos/arm64>] --image <image> --size <size> [--ephemeral] [--checkout <repo-url>] --purpose "<purpose>"。可用 devbox image list -o json 查看镜像,--image 传短名;未指定 --checkout 时会自动克隆默认仓库,不需要时可传 --no_checkout。

文件传输:devbox upload <name> <local-path> <remote-path> [--mkdir]、devbox download <name> <remote-path> <local-path>,远端路径须为完整文件路径,可执行位不保留。命令执行:devbox exec <name> -- <cmd>,不经过 shell,&&、变量展开等需显式 bash -lc;长任务可用 devbox exec -d 配合 devbox logs。

适用场景包括隔离 Linux/macOS 环境、远程构建或测试、一次性任务、跨 devbox 分片测试等。限制:创建依赖 Namespace 计划资源,可能失败;创建耗时数十秒;远端用户非 root;认证与登录流程受限;资料未提供收费与价格信息。