Docker 镜像拉取工具
从任意 Docker Registry 拉取镜像，打包为 .tar 文件供离线 docker load 使用。
资源文件
- 脚本：
scripts/docker_image_puller.py - 配置：
config.json（首次运行时引导生成）
首次使用 — 配置引导
检查 config.json 中 arch 字段：
- 若为空（
""或不存在），引导用户完成首次配置：- 下载方式 — 代理下载（推荐，最稳定）或镜像加速
- 代理地址（代理模式）— 默认
127.0.0.1:7890 - 镜像站地址（镜像模式）— 或让脚本运行时显示推荐列表
- 目标架构 —
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. 结果报告
| 结果 | 处理方式 |
|---|---|
| ✅ 成功 | 报告 tar 文件路径 + docker load -i <路径> |
| ⏱ 超时 | "下载超时，请检查网络或代理" |
| 🔒 认证失败 401 | 请用户提供仓库用户名/密码 |
| 🌐 网络错误 | 报告具体 HTTP 错误码和失败 URL |
| 💾 磁盘不足 | 提醒用户清理磁盘空间 |
补充说明
- 输出路径：
<script_dir>/images/<仓库>_<标签>_<架构>.tar - 脚本运行完毕后自动清理
tmp/临时目录，无需手动处理 config.json跨次复用，用户可随时要求切换下载模式或指定架构