Docker 镜像拉取工具

从任意 Docker Registry 拉取镜像，打包为 .tar 文件供离线 docker load 使用。

资源文件

• 脚本：scripts/docker_image_puller.py
• 配置：config.json（首次运行时引导生成）

首次使用 — 配置引导

检查 config.json 中 arch 字段：

• 若为空（"" 或不存在），引导用户完成首次配置：
  1. 下载方式 — 代理下载（推荐，最稳定）或镜像加速
  2. 代理地址（代理模式）— 默认 127.0.0.1:7890
  3. 镜像站地址（镜像模式）— 或让脚本运行时显示推荐列表
  4. 目标架构 — amd64（x86 服务器，默认）或 arm64v8（ARM 服务器）
• 若 arch 已有值，跳过引导，直接使用该配置

script_dir 自动解析为技能自带的 scripts/ 目录。

config.json 结构

{
  "mode": "proxy",
  "proxy_address": "127.0.0.1:7890",
  "mirror_url": "",
  "arch": "",
  "script_dir": "",
  "version": 1
}

arch 为空时触发首次引导。

执行流程

1. 读取配置，构建命令

读取 config.json，根据 mode 构建命令：

代理模式：

cd "<script_dir>" && printf 'n\nn' | python3 docker_image_puller.py -i "<镜像名>" --socks5 --socks5-proxy "<代理地址>" -a "<架构>"

镜像加速模式：

cd "<script_dir>" && printf 'y\ny\n<镜像站地址>' | python3 docker_image_puller.py -i "<镜像名>" -a "<架构>"

2. Sub-Agent 后台下载

使用 sessions_spawn 启动隔离子任务，不阻塞主会话：

sessions_spawn(
  task="读取 <skill-dir>/config.json 获取配置。为镜像 '<镜像名>' 构建下载命令。用 exec 执行（background=true, timeout=600）。每 30 秒用 process 轮询进度。完成后报告 tar 路径和 docker load 命令。失败则报告具体原因。",
  mode="run",
  runtime="subagent",
  timeoutSeconds=900
)

立即回复用户：

📥 已启动后台下载 <镜像名>（架构：<架构>）... 完成后会通知你，可继续其他操作。

3. 结果报告

补充说明

• 输出路径：<script_dir>/images/<仓库>_<标签>_<架构>.tar
• 脚本运行完毕后自动清理 tmp/ 临时目录，无需手动处理
• config.json 跨次复用，用户可随时要求切换下载模式或指定架构