说明	向沙箱添加 Mixin
用法	sbx kit add SANDBOX REFERENCE [flags]

实验性

此命令为实验性功能。

实验性功能仅用于测试和反馈，其功能或设计可能在不同版本之间无预警地发生变化，也可能在未来的版本中被完全移除。

描述

向已有沙箱添加一个 Mixin 制品。

沙箱的容器会被重新创建，新 Kit 会追加到原有的 Kit 列表末尾，替换过程中会保留由 Kit 拥有的持久卷（例如智能体会话状态）。工作区数据不受影响：绑定挂载的沙箱保留主机侧的 挂载点；使用 --clone 的沙箱则通过一个具名工作区持久卷保留容器内的工作树，该卷会重新 挂接到替换后的容器上。

沙箱必须已经存在，并且是使用支持重建的标签集创建的（在 kit add 重建特性发布之前创建的 沙箱会被拒绝，并给出明确的错误信息）。引用可以是本地目录、ZIP 文件路径、OCI 镜像仓库 引用或 git 仓库。

选项

选项	默认值	说明
--kit-arg		为 Kit 声明的参数设置值，name=value 表示所有 Kit，kit.name=value 表示指定的那个（可重复）
--kit-args-file		包含 name=value 形式 Kit 参数的文件，每行一个（可重复）；--kit-arg 的优先级更高

全局选项

选项	默认值	说明
--cloud		改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表）
-D, --debug		启用调试日志
--no-input		从不提示；需要应答的命令会直接失败，并给出应当运行的命令

示例

# 向沙箱添加一个本地 Mixin 目录
sbx kit add my-sandbox ./mcp-postgres/

# 从 ZIP 文件添加 Kit
sbx kit add my-sandbox ./mcp-postgres.zip

# 从 OCI 镜像仓库添加 Kit
sbx kit add my-sandbox ghcr.io/myorg/mcp-postgres:1.0

# 从 git 仓库添加 Kit
sbx kit add my-sandbox git+https://github.com/org/kits.git#dir=mcp-postgres

# 添加带参数的 Kit
sbx kit add my-sandbox ./mcp-postgres/ --kit-arg host=db.internal

参见

• sbx kit — （实验性）管理 Kit 制品