# Bot Images 使用说明

这个目录用于构建 `nanobot-base` 相关镜像。

## 1. 直接构建镜像

```bash
./bot-images/build.sh
```

执行后脚本会提示你选择：

- `1` 从远程拉取最新版本再构建
- `2` 从本地已有 `nanobot-base-*` 目录中选择一个构建

默认行为只构建 Docker 镜像，不导出压缩产物。

## 2. 构建后同时导出镜像产物

如果需要把构建好的镜像发给没有源码的客户，可以加：

```bash
./bot-images/build.sh --save-artifact
```

执行完成后，会在你运行命令时的当前目录生成一个压缩包，例如：

```text
nanobot-base-v0.1.5.tar.gz
```

这个压缩包本质上是 `docker save | gzip` 的产物，可以直接拿到客户机器上导入。

## 3. 指定导出目录

如果不想导出到当前目录，可以指定目录：

```bash
./bot-images/build.sh --artifact-dir /path/to/output
```

执行完成后，镜像压缩包会输出到指定目录。

## 4. 客户侧如何导入

客户机器上拿到压缩包后可执行：

```bash
gunzip -c nanobot-base-v0.1.5.tar.gz | docker load
```

导入完成后，可用下面命令确认：

```bash
docker images | grep nanobot-base
```

## 5. 说明

- `--artifact-dir` 会自动包含 `--save-artifact` 的效果。
- 如果只是本机构建测试，不需要加导出参数。
- 如果后续要给多个客户复用，推荐保留导出的 `.tar.gz`，这样不需要客户再拿源码构建。