| 说明 | 显示 Kit 制品详情 |
| 用法 | sbx kit inspect REFERENCE [flags] |
实验性
此命令为实验性功能。
实验性功能仅用于测试和反馈，其功能或设计可能在不同版本之间无预警地发生变化，也可能在未来的版本中被完全移除。
描述
加载并显示某个 Kit 制品的详情。
引用可以是本地目录、ZIP 文件路径、OCI 镜像仓库引用或 git 仓库。
传入 --kit-arg 可以预览给定一组参数时 Kit 的解析结果；输出会显示替换后的内容。
--resolved 会把 Kit 的 extends: parent 合并进来，因此输出的是 sbx 实际应用的 结果，而不只是 Kit 声明的内容。
--offline 会跳过由守护进程提供的 Kit 策略（kit.allowedSources、 kit.allowLocalKits、kit.requireSignature），因此该命令既不需要 sandboxd，也不需要 已登录的会话；它只接受本地目录或 ZIP 引用，因为只有这两类引用适用该检查。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--format | 输出格式：table、json 或 yaml | |
--json | 以 JSON 格式输出 | |
--kit-arg | Kit 所声明参数的取值，对所有 Kit 使用 name=value，对单个 Kit 使用 kit.name=value（可重复） | |
--kit-args-file | 包含 name=value 形式 Kit 参数的文件，每行一个（可重复）；--kit-arg 优先 | |
--offline | 跳过由守护进程支撑的 Kit 策略检查；仅支持本地目录或 ZIP 引用 | |
--resolved | 把 Kit 的 extends: parent 合并进输出 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
sbx kit inspect ./my-kit
sbx kit inspect ghcr.io/myorg/my-kit:1.0
# 机器可读输出
sbx kit inspect ghcr.io/myorg/my-kit:1.0 --format json
# 显示合并了 extends: parent 之后的 Kit
sbx kit inspect ./my-kit --resolved --format yaml
# 在 sandboxd 未运行、也未登录 Docker 的情况下查看
sbx kit inspect ./my-kit --offline参见
sbx kit— （实验性）管理 Kit 制品