@cnbcool/cnb-cli 1.0.0 → 1.0.2

package/skills/artifact-migrate/SKILL.md

@@ -1,674 +0,0 @@
----
-name: artifact-migrate
-description: CNB 制品批量迁移工具。支持从 CODING、CNB、CodeUp、Nexus、Jfrog、TCR 等平台迁移 Maven、NPM、Docker、NuGet、Composer、PyPI、Conan、Cargo 制品到 CNB 平台。通过 Docker 运行迁移工具，支持全量迁移、正则过滤、指定包版本和断点续传。
----
-
-# CNB 制品批量迁移工具 - Skill 文档
-
----
-
-## 🔧 环境准备
-
-### 依赖工具
-
-| 工具 | 版本要求 | 安装方式 | 说明 |
-|------|----------|----------|------|
-| Docker | 19.03+ | [官方文档](https://docs.docker.com/get-docker/) | 用于运行迁移工具容器 |
-| Podman（可选） | 3.0+ | `brew install podman` 或系统包管理器 | Docker 的替代方案 |
-
-> **说明**：迁移工具以 Docker 镜像方式分发，镜像地址为 `docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest`，镜像内已内置所有运行时依赖（Go 编译产物、skopeo、Python3、Conan 等）。
-
-### 权限要求
-
-- **源制品库**：需要 **读取** 权限（用户名 + 密码/Token）；公开仓库可不填用户名密码
-- **目标制品库（CNB）**：需要 **写入** 权限（仅需 `TAR_REGISTRY_PASSWORD`，用户名固定为 `cnb`）
-
----
-
-## ⚙️ 参数说明
-
-### 核心参数（必填）
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|:----:|--------|------|
-| `ARTIFACT_TYPE` | string | ✅ | - | 制品类型，可选：`maven`、`npm`、`docker`、`nuget`、`composer`、`pypi`、`conan`、`cargo` |
-| `SRC_REGISTRY_TYPE` | string | ✅ | - | 源仓库平台类型，可选：`coding`、`cnb`、`codeup`、`nexus`、`jfrog`、`tcr`、`other` |
-| `SRC_REGISTRY_URL` | string | ✅ | - | 源仓库地址 |
-| `TAR_REGISTRY_URL` | string | ✅ | - | 目标仓库地址（CNB 仓库地址） |
-| `TAR_REGISTRY_PASSWORD` | string | ✅ | - | 目标仓库（CNB）密码/Token |
-
-### 源仓库认证参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|:----:|--------|------|
-| `SRC_REGISTRY_USERNAME` | string | 条件必填 | - | 源仓库用户名（公开仓库可不填） |
-| `SRC_REGISTRY_PASSWORD` | string | 条件必填 | - | 源仓库密码（公开仓库可不填） |
-
-### 过滤与筛选参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|:----:|--------|------|
-| `INCLUDE_REGX` | string | ❌ | - | 包含正则（多个用 `,` 分隔），匹配格式为 `包名#版本`；为空则包含所有 |
-| `EXCLUDE_REGX` | string | ❌ | - | 排除正则（多个用 `,` 分隔），匹配格式为 `包名#版本`；为空则不排除 |
-| `PACKAGE_VERSIONS_FILE_NAME` | string | ❌ | - | 包版本配置文件路径（容器内路径），用于迁移少量指定包版本 |
-| `PACKAGE_VERSIONS_EXT` | string | ❌ | - | Maven 额外文件扩展名（多个用 `,` 分隔），仅 Other 源 Maven 使用 |
-
-### 高级参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|:----:|--------|------|
-| `CONCURRENCY` | uint | ❌ | `5` | 并发数（最大 256） |
-| `LOG_LEVEL` | string | ❌ | `info` | 日志等级，可选：`trace`、`debug`、`info`、`warn`、`error`、`fatal`、`panic` |
-| `SRC_PAGE_SIZE` | int | ❌ | `500` | 源仓库分页大小 |
-| `IS_STRICT_VERSION_ORDER` | bool | ❌ | `false` | 是否按版本排序后再上传（多版本场景） |
-
-### 平台专用参数
-
-| 参数名 | 类型 | 专用平台 | 说明 |
-|--------|------|----------|------|
-| `SRC_CODING_DISABLE_THIRD_PACKAGE` | bool | CODING | 是否过滤第三方包（**强烈推荐 `true`**） |
-| `SRC_DOCKER_ISTLSVERIFY` | bool | Docker | 源仓库是否使用 HTTPS（HTTPS 时设 `true`） |
-| `TAR_DOCKER_ISTLSVERIFY` | bool | Docker | 目标仓库是否使用 HTTPS（HTTPS 时设 `true`） |
-| `SRC_NEXUS_DOCKER_REPO_URL` | string | Nexus+Docker | Nexus 平台 Docker 仓库实际地址 |
-| `SRC_CODEUP_TOKEN` | string | CodeUp | CodeUp 平台 API 访问令牌 |
-| `SRC_CODEUP_LOGIN_ALIYUNID_TICKET` | string | CodeUp+Maven | CodeUp Maven 文件列表令牌（需单引号包裹） |
-| `SRC_TCR_REGION` | string | TCR | TCR 平台地域编码，如 `ap-shanghai` |
-| `SRC_TCR_SECRET_ID` | string | TCR | TCR 云账号 API 访问令牌 ID |
-| `SRC_TCR_SECRET_KEY` | string | TCR | TCR 云账号 API 访问令牌 Key |
-| `TAR_NPM_API_VERSION` | string | NPM | 目标仓库 NPM API 版本，可选 `v1`、`v2`，默认 `v2` |
-| `SRC_TEMP_DIR` | string | PyPI | PyPI 临时目录 |
-
----
-
-## 🚀 使用步骤
-
-### Step 1：拉取迁移工具镜像
-
-```bash
-docker pull docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-### Step 2：准备访问凭证
-
-1. **源仓库**：获取源制品仓库的地址、用户名、密码（各平台获取方式不同，参考项目文档 `docs/certificate.md`）
-2. **目标仓库（CNB）**：在 CNB 创建制品仓库，获取仓库地址和访问 Token
-
-### Step 3：执行迁移
-
-#### 模式一：迁移仓库下所有制品
-
-```bash
-docker run --rm \
-  -e ARTIFACT_TYPE=npm \
-  -e SRC_REGISTRY_TYPE=coding \
-  -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-  -e SRC_REGISTRY_USERNAME="my-username" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-  -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-#### 模式二：使用正则过滤迁移
-
-```bash
-docker run --rm \
-  -e ARTIFACT_TYPE=npm \
-  -e INCLUDE_REGX="^@myorg,^mypackage" \
-  -e EXCLUDE_REGX="^third-party" \
-  -e SRC_REGISTRY_TYPE=coding \
-  -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-  -e SRC_REGISTRY_USERNAME="my-username" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-  -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-#### 模式三：迁移指定包版本（文件模式）
-
-1. 创建本地文件 `package-versions.txt`，格式示例：
-   ```
-   @coding/migrate#1.0.0
-   lodash#4.17.21
-   lodash
-   ```
-   - `包名#版本`：迁移指定版本
-   - `包名`（不带版本）：迁移该包所有版本
-
-2. 执行迁移命令：
-   ```bash
-   docker run --rm \
-     -e ARTIFACT_TYPE=npm \
-     -e PACKAGE_VERSIONS_FILE_NAME=/app/config.txt \
-     -e SRC_REGISTRY_TYPE=coding \
-     -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-     -e SRC_REGISTRY_USERNAME="my-username" \
-     -e SRC_REGISTRY_PASSWORD=xxx \
-     -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-     -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-     -e TAR_REGISTRY_PASSWORD=xxx \
-     -u root \
-     -v $(pwd)/log:/app/log \
-     -v $(pwd)/package-versions.txt:/app/config.txt \
-     docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-   ```
-
-### Step 4：查看迁移结果
-
-迁移结束后，终端会自动输出统计报告：
-
-```
-INFO[0042] ----------------- MigrateRecord Print Start-----------------
-INFO[0042] Migrate success ✅ ✅ ✅ ✅
-INFO[0042] 迁移制品类型: npm
-INFO[0042] 源仓库类型: coding
-INFO[0042] 源仓库地址: https://example-npm.pkg.coding.net/my-project/my-repo/
-INFO[0042] 目标仓库地址: https://npm.cnb.cool/my-project2/my-repo2/-/packages/
-INFO[0042] 开始时间: 2025-01-01T10:00:00+08:00
-INFO[0042] 结束时间: 2025-01-01T10:00:42+08:00
-INFO[0042] 耗时: 42s
-INFO[0042] 总数: 120, 成功数: 118, 存在数: 2, 忽略数: 0, 错误数: 0
-INFO[0042] ----------------- Migrate Print End  -----------------
-```
-
----
-
-## 📝 完整示例
-
-### 示例 1：从 CODING 迁移全量 NPM 制品
-
-```bash
-docker run --rm \
-  -e ARTIFACT_TYPE=npm \
-  -e SRC_REGISTRY_TYPE=coding \
-  -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-  -e SRC_REGISTRY_USERNAME="my-username" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-  -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-**预期输出**：
-```
-INFO[0000] Load config from environment variables success
-INFO[0000] migrate start   artifactType=npm
-INFO[0042] migrate end     artifactType=npm
-INFO[0042] ----------------- MigrateRecord Print Start-----------------
-INFO[0042] Migrate success ✅ ✅ ✅ ✅
-INFO[0042] 迁移制品类型: npm
-INFO[0042] 总数: 50, 成功数: 48, 存在数: 2, 忽略数: 0, 错误数: 0
-INFO[0042] ----------------- Migrate Print End  -----------------
-```
-
-### 示例 2：从 Nexus 迁移 Maven 制品（正则过滤）
-
-```bash
-docker run --rm \
-  -e ARTIFACT_TYPE=maven \
-  -e INCLUDE_REGX="^com\.myorg" \
-  -e EXCLUDE_REGX="^com\.myorg\.test" \
-  -e SRC_REGISTRY_TYPE=nexus \
-  -e SRC_REGISTRY_URL="https://nexus.example.com:8081/repository/maven-releases/" \
-  -e SRC_REGISTRY_USERNAME="admin" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e TAR_REGISTRY_URL="https://maven.cnb.cool/my-project/my-repo/-/packages/" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-**预期输出**：
-```
-INFO[0000] Load config from environment variables success
-INFO[0000] migrate start   artifactType=maven
-INFO[0120] migrate end     artifactType=maven
-INFO[0120] ----------------- MigrateRecord Print Start-----------------
-INFO[0120] Migrate success ✅ ✅ ✅ ✅
-INFO[0120] 迁移制品类型: maven
-INFO[0120] 包括包名规则: ^com\.myorg
-INFO[0120] 排除包名规则: ^com\.myorg\.test
-INFO[0120] 总数: 200, 成功数: 195, 存在数: 5, 忽略数: 0, 错误数: 0
-INFO[0120] ----------------- Migrate Print End  -----------------
-```
-
-### 示例 3：从 Jfrog 迁移 Docker 镜像
-
-```bash
-docker run --rm \
-  -e ARTIFACT_TYPE=docker \
-  -e SRC_REGISTRY_TYPE=jfrog \
-  -e SRC_REGISTRY_URL="https://jfrog.example.com/artifactory/docker-repo/" \
-  -e SRC_REGISTRY_USERNAME="admin" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e SRC_DOCKER_ISTLSVERIFY=true \
-  -e TAR_REGISTRY_URL="docker.cnb.cool/my-project/my-repo" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -e TAR_DOCKER_ISTLSVERIFY=true \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-### 示例 4：断点续传
-
-```bash
-# 第一次迁移（中途失败/中断）
-docker run --rm \
-  -e ARTIFACT_TYPE=npm \
-  -e SRC_REGISTRY_TYPE=coding \
-  -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-  -e SRC_REGISTRY_USERNAME="my-username" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-  -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-
-# 第二次迁移（自动从断点继续，且优先重试上次失败的制品）
-# 使用完全相同的命令即可
-docker run --rm \
-  -e ARTIFACT_TYPE=npm \
-  -e SRC_REGISTRY_TYPE=coding \
-  -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-  -e SRC_REGISTRY_USERNAME="my-username" \
-  -e SRC_REGISTRY_PASSWORD=xxx \
-  -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-  -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-  -e TAR_REGISTRY_PASSWORD=xxx \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-### 示例 5：在 CNB 云原生构建中使用
-
-```yaml
-main:
-  push:
-    - services:
-        - docker
-      stages:
-        - name: 拉取镜像
-          script: |
-            docker pull docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-
-        - name: 开始迁移
-          script: |
-            mkdir -p /workspace/log
-            docker run --rm \
-              -e ARTIFACT_TYPE=npm \
-              -e SRC_REGISTRY_TYPE=coding \
-              -e SRC_REGISTRY_URL="https://example-npm.pkg.coding.net/my-project/my-repo/" \
-              -e SRC_REGISTRY_USERNAME="my-username" \
-              -e SRC_REGISTRY_PASSWORD=xxx \
-              -e SRC_CODING_DISABLE_THIRD_PACKAGE=true \
-              -e TAR_REGISTRY_URL="https://npm.cnb.cool/my-project2/my-repo2/-/packages/" \
-              -e TAR_REGISTRY_PASSWORD=xxx \
-              -e LOG_LEVEL=info \
-              -u root \
-              -v /workspace/log:/app/log \
-              docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-            tar czf /workspace/artifact-migrate.tar.gz -C /workspace log
-
-        - name: 上传迁移日志到commit附件
-          image: cnbcool/attachments:latest
-          settings:
-            commit: ${CNB_COMMIT}
-            attachments:
-              - "./artifact-migrate.tar.gz"
-```
-
----
-
-## 🔄 迁移流程图
-
-```
-                        ┌──────────────────────┐
-                        │     加载环境变量配置     │
-                        │   (Config.LoadConfig)  │
-                        └──────────┬───────────┘
-                                   │
-                        ┌──────────▼───────────┐
-                        │   初始化迁移管理器       │
-                        │  (MigrateManager)      │
-                        │  - 解析制品类型          │
-                        │  - 编译正则表达式        │
-                        │  - 加载断点续传记录      │
-                        │  - 初始化 HTTP 客户端    │
-                        │  - 初始化工作池          │
-                        └──────────┬───────────┘
-                                   │
-                   ┌───────────────┼───────────────┐
-                   │               │               │
-          ┌────────▼────────┐     │     ┌─────────▼─────────┐
-          │  创建 Producer   │     │     │  创建 N 个 Consumer │
-          │ (源仓库适配器)    │     │     │  (并发消费者)       │
-          └────────┬────────┘     │     └─────────┬─────────┘
-                   │               │               │
-                   └───────┬───────┘───────────────┘
-                           │
-                ┌──────────▼───────────┐
-                │    启动迁移 Pipeline    │
-                │  Producer → Channel → │
-                │     → N × Consumer    │
-                └──────────┬───────────┘
-                           │
-              ┌────────────▼────────────┐
-              │      Producer 生产流程     │
-              │                          │
-              │  1. 重试上次失败的制品      │
-              │     (FailedTask)          │
-              │  2. 从断点分页继续拉取      │
-              │     (RegxTask)            │
-              │  ─── 或 ───               │
-              │  文件模式: 按配置文件拉取    │
-              │     (FileTask)            │
-              └────────────┬────────────┘
-                           │
-                           │ chan *MigrateParam
-                           │
-              ┌────────────▼────────────┐
-              │    Consumer 消费流程       │
-              │                          │
-              │  1. 从 channel 取任务     │
-              │  2. 从源仓库下载制品       │
-              │  3. 上传至 CNB 目标仓库    │
-              │  4. 返回 MigrateResult    │
-              │  5. Record 统一记录结果    │
-              └────────────┬────────────┘
-                           │
-              ┌────────────▼────────────┐
-              │      迁移结束 & 收尾       │
-              │                          │
-              │  1. 剩余任务写入失败文件    │
-              │  2. 全部记录刷入日志文件    │
-              │  3. 打印统计报告           │
-              │     (总/成功/存在/忽略/错误)│
-              └─────────────────────────┘
-```
-
----
-
-## 🧩 核心架构与逻辑说明
-
-### 架构设计
-
-工具采用 **生产者-消费者** 模式：
-
-- **Producer**：负责从源仓库拉取制品元数据列表，通过 Channel 发送给 Consumer
-- **Consumer**：并发消费任务，负责下载制品文件并上传至目标仓库
-- **MigrateManager**：核心调度器，管理配置、正则匹配、迁移记录
-- **MigrateRecord**：迁移状态记录器，实现断点续传和结果统计
-
-### 三种迁移模式
-
-| 模式 | 触发条件 | 说明 |
-|------|----------|------|
-| **全量模式** | 不配置 `INCLUDE_REGX`、`EXCLUDE_REGX`、`PACKAGE_VERSIONS_FILE_NAME` | 迁移源仓库所有制品 |
-| **正则模式** | 配置 `INCLUDE_REGX` 和/或 `EXCLUDE_REGX` | 按正则匹配过滤迁移 |
-| **文件模式** | 配置 `PACKAGE_VERSIONS_FILE_NAME` | 仅迁移配置文件中指定的包版本 |
-
-### 关键函数 / 模块
-
-| 函数/模块名 | 功能描述 | 输入 | 输出 |
-|-------------|----------|------|------|
-| `config.LoadConfig()` | 从环境变量加载并验证配置 | 环境变量 | `*Config` |
-| `manager.NewMigrateManager()` | 创建迁移管理器（初始化正则、记录、工作池） | `*Config` | `*MigrateManager` |
-| `producer.NewProducer()` | 创建生产者（绑定源仓库适配器） | `*MigrateManager` | `Producer` |
-| `consumer.NewConsumer()` | 按制品类型创建消费者实例 | `*MigrateManager` | `Consumer` |
-| `Producer.Product()` | 生产待迁移任务（断点续传 + 分页拉取 或 文件模式） | `ctx`, `chan` | 通过 Channel 发送 `*MigrateParam` |
-| `Consumer.DoMigrate()` | 消费一个迁移任务（下载 → 上传） | `ctx`, `*MigrateParam` | `*MigrateResult` |
-| `MigrateRecord.RecordMigrateResult()` | 记录迁移结果（成功/失败/已存在/忽略） | `TaskType`, `*MigrateResult` | - |
-| `MigrateManager.Print()` | 打印最终迁移统计报告 | - | 日志输出 |
-| `repository.NewRepository()` | 按源仓库类型创建仓库适配器 | `*MigrateManager` | `Repository` |
-| `Repository.GetArtifactsByPage()` | 分页获取制品列表 | `ctx`, `page` | `*FetchResult`, 页码, 是否最后一页, error |
-| `Repository.GetArtifactsByPackageOrVersion()` | 按包名/版本获取制品列表 | `ctx`, `pkgName`, `versions` | `*FetchResult`, error |
-
-### 断点续传机制
-
-1. 每次迁移结束（正常或异常），所有状态信息写入 `log/` 目录下的 7 个文件
-2. 下次启动时自动读取这些文件，恢复上次迁移状态
-3. **优先重试上次失败的制品**（`failed-files.txt`），然后从分页断点（`pagination.txt`）继续拉取
-4. 文件模式（`PACKAGE_VERSIONS_FILE_NAME`）不支持断点续传，每次都会清空历史记录
-
-### 信号处理
-
-工具监听 `SIGINT`（Ctrl+C）和 `SIGTERM` 信号，收到信号后会：
-
-1. 取消 context，通知 Producer 和 Consumer 停止
-2. 将 Channel 中未处理的任务写入失败文件
-3. 将迁移记录刷入日志文件
-4. 打印统计报告
-
----
-
-## ⚠️ 注意事项
-
-1. **强烈建议不迁移第三方包**：CNB 有加速源可直接拉取第三方包，CODING 源请设置 `SRC_CODING_DISABLE_THIRD_PACKAGE=true`，其他平台可通过 `EXCLUDE_REGX` 正则过滤
-2. **Docker 迁移必须关注 TLS 配置**：迁移 Docker 时，如果源/目标仓库使用 HTTPS，必须设置 `SRC_DOCKER_ISTLSVERIFY=true` 和 `TAR_DOCKER_ISTLSVERIFY=true`
-3. **断点续传依赖日志目录**：断点续传功能依赖工作目录下的 `log` 文件夹，请确保 `-v $(pwd)/log:/app/log` 挂载正确，且不要手动删除日志文件
-4. **文件模式不支持断点续传**：使用 `PACKAGE_VERSIONS_FILE_NAME` 时，每次运行都是全量迁移该文件中的包
-5. **云原生构建中不支持断点续传**：在 CNB 云原生构建流水线中运行时，每次构建环境都是全新的，日志可在附件中查看
-6. **Nexus 平台限制**：当仓库下总版本数大于 10,000 条时，只能采用文件模式（`PACKAGE_VERSIONS_FILE_NAME`）迁移
-7. **Other 源仅支持文件模式**：`SRC_REGISTRY_TYPE=other` 只支持通过 `PACKAGE_VERSIONS_FILE_NAME` 指定包版本迁移
-8. **目标仓库用户名固定**：目标仓库用户名统一为 `cnb`（代码中硬编码），仅需配置 `TAR_REGISTRY_PASSWORD`
-9. **并发数计算规则**：消费者数量 = `CONCURRENCY / 2`（至少为 1），默认并发数为 5，最大 256
-
----
-
-## ❌ 常见错误与解决方案
-
-| 错误信息 | 原因 | 解决方案 |
-|----------|------|----------|
-| `ARTIFACT_TYPE is required` | 未配置制品类型 | 添加 `-e ARTIFACT_TYPE=<type>` |
-| `SRC_REGISTRY_TYPE is required` | 未配置源仓库类型 | 添加 `-e SRC_REGISTRY_TYPE=<type>` |
-| `SRC_REGISTRY_URL is required` | 未配置源仓库地址 | 添加 `-e SRC_REGISTRY_URL=<url>` |
-| `TAR_REGISTRY_URL is required` | 未配置目标仓库地址 | 添加 `-e TAR_REGISTRY_URL=<url>` |
-| `TAR_REGISTRY_PASSWORD is required` | 未配置目标仓库密码 | 添加 `-e TAR_REGISTRY_PASSWORD=<token>` |
-| `The current scope does not support access to this API` | CODING 迁移 Docker 时未配置 TLS | 添加 `-e SRC_DOCKER_ISTLSVERIFY=true` |
-| `artifact type xxx is not supported` | 制品类型不在支持列表中 | 检查 `ARTIFACT_TYPE` 拼写是否正确 |
-| `packageVersionFile must be a .txt file` | 文件模式配置文件不是 .txt 格式 | 确保配置文件以 `.txt` 结尾 |
-| `packageVersionFile is empty` | 配置文件为空或格式不正确 | 检查文件内容，格式为 `包名#版本` 或 `包名` |
-| 迁移 0 个包 | CODING 配置了 `SRC_CODING_DISABLE_THIRD_PACKAGE` 后全为三方包 | 确认是否确实有自有包需要迁移 |
-
----
-
-## 📊 输出说明
-
-### 迁移结果统计
-
-| 输出项 | 说明 |
-|--------|------|
-| `Migrate success ✅` | 总数 = 成功数 + 存在数 + 忽略数（无失败） |
-| `Migrate failed ❌` | 存在迁移失败的制品 |
-| 迁移制品类型 | 当前迁移的制品类型（如 npm、maven） |
-| 包括/排除包名规则 | 本次使用的正则过滤规则 |
-| 源仓库/目标仓库地址 | 迁移的源和目标 |
-| 开始/结束时间、耗时 | 迁移总耗时 |
-| 本次迁移错误列表 | 逐条列出失败的包名和错误信息 |
-| **总数** | 需要迁移的制品版本总数 |
-| **成功数** | 本次成功上传的制品版本数 |
-| **存在数** | 目标仓库已存在的制品版本数（无需重复上传） |
-| **忽略数** | 被正则/规则过滤跳过的制品版本数 |
-| **错误数** | 迁移失败的制品版本数 |
-
-### 日志文件
-
-所有日志文件存储在 `log/{平台}-{制品类型}-{源仓库}-{目标仓库}/` 目录下：
-
-| 文件 | 格式 | 说明 |
-|------|------|------|
-| `versions.txt` | 每行一个 `包名#版本` | 所有需迁移的制品版本列表 |
-| `success-versions.txt` | 每行一个 `包名#版本` | 成功迁移的制品版本 |
-| `exist-versions.txt` | 每行一个 `包名#版本` | 目标仓库已存在的版本 |
-| `ignore-versions.txt` | 每行一个 `包名#版本` | 被忽略的版本 |
-| `failed-versions.txt` | 每行一个 `包名#版本` | 失败的制品版本（断点续传依赖） |
-| `failed-files.txt` | 每行 `包名#版本#URL` | 失败的制品文件详情（断点续传依赖） |
-| `pagination.txt` | JSON | 分页断点信息 `{"latestPage":"...", "isLastPage":false}` |
-
-### 迁移输出示例
-
-#### 成功场景
-
-```log
-INFO ----------------- MigrateRecord Print Start-----------------
-INFO Migrate success ✅ ✅ ✅ ✅
-INFO 迁移制品类型: npm
-INFO 包括包名规则: ^@myorg
-INFO 排除包名规则: ^third-party
-INFO 迁移包版本文件路径:
-INFO 迁移包版本: map[]
-INFO maven专用 文件ext:
-INFO 是否使用严格上传模式: false
-INFO 源仓库类型: coding
-INFO 源仓库地址: https://example-npm.pkg.coding.net/my-project/my-repo/
-INFO coding专用 是否不迁移源仓库第三方包: true
-INFO docker专用 源仓库是否使用https: false
-INFO nexus专用 源仓库docker地址:
-INFO 目标仓库地址: https://npm.cnb.cool/my-project2/my-repo2/-/packages/
-INFO docker专用 目标仓库是否使用https: false
-INFO 开始时间: 2025-01-15T10:00:00+08:00
-INFO 结束时间: 2025-01-15T10:02:30+08:00
-INFO 耗时: 2m30s
-INFO 本次迁移错误列表:
-INFO 总数: 120, 成功数: 115, 存在数: 5, 忽略数: 0, 错误数: 0
-INFO ----------------- Migrate Print End  -----------------
-```
-
-#### 部分失败场景
-
-```log
-INFO ----------------- MigrateRecord Print Start-----------------
-INFO Migrate failed  ❌ ❌ ❌ ❌
-INFO 迁移制品类型: maven
-INFO 源仓库类型: nexus
-INFO 源仓库地址: https://nexus.example.com:8081/repository/maven-releases/
-INFO 目标仓库地址: https://maven.cnb.cool/my-project/my-repo/-/packages/
-INFO 开始时间: 2025-01-15T14:00:00+08:00
-INFO 结束时间: 2025-01-15T14:15:42+08:00
-INFO 耗时: 15m42s
-INFO 本次迁移错误列表:
-INFO pkgName: com.example:broken-lib, errorMsg: upload failed: 502 Bad Gateway
-INFO pkgName: com.example:large-artifact, errorMsg: context deadline exceeded
-INFO 总数: 500, 成功数: 490, 存在数: 3, 忽略数: 5, 错误数: 2
-INFO ----------------- Migrate Print End  -----------------
-```
-
-### 智能体输出总结模板
-
-当迁移完成后，智能体应使用以下模板对迁移结果进行结构化总结：
-
-```markdown
-## 迁移结果总结
-
-**状态**: [成功 ✅ / 部分失败 ⚠️ / 失败 ❌]
-
-| 指标 | 数量 |
-|------|------|
-| 总计 | {总数} |
-| 成功 | {成功数} |
-| 已存在 | {存在数} |
-| 忽略 | {忽略数} |
-| 失败 | {错误数} |
-
-**耗时**: {耗时}
-**源仓库**: {源仓库类型} - {源仓库地址}
-**目标仓库**: {目标仓库地址}
-
-{如有失败项，逐条列出失败原因}
-
-{如有失败，建议：重新运行相同命令即可自动断点续传（仅全量/正则模式）}
-```
-
-**状态判定规则**：
-
-```
-若 总数 == 成功数 + 存在数 + 忽略数 → 成功 ✅
-若 错误数 > 0 且 成功数 > 0           → 部分失败 ⚠️
-若 错误数 == 总数                      → 失败 ❌
-```
-
----
-
-## 🔗 快速参考
-
-### 最小化命令模板
-
-```bash
-docker run --rm \
-  -e ARTIFACT_TYPE=<制品类型> \
-  -e SRC_REGISTRY_TYPE=<源平台> \
-  -e SRC_REGISTRY_URL="<源仓库地址>" \
-  -e SRC_REGISTRY_USERNAME="<用户名>" \
-  -e SRC_REGISTRY_PASSWORD=<密码> \
-  -e TAR_REGISTRY_URL="<目标仓库地址>" \
-  -e TAR_REGISTRY_PASSWORD=<CNB Token> \
-  -u root \
-  -v $(pwd)/log:/app/log \
-  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest
-```
-
-### 制品类型 × 目标仓库 URL 格式
-
-| 制品 | ARTIFACT_TYPE | 目标仓库 URL 格式 |
-|------|---------------|-------------------|
-| Maven | `maven` | `https://maven.cnb.cool/<project>/<repo>/-/packages/` |
-| NPM | `npm` | `https://npm.cnb.cool/<project>/<repo>/-/packages/` |
-| Docker | `docker` | `docker.cnb.cool/<project>/<repo>` |
-| NuGet | `nuget` | `https://nuget.cnb.cool/<project>/<repo>/-/packages/` |
-| Composer | `composer` | `https://composer.cnb.cool/<project>/<repo>/-/packages/` |
-| PyPI | `pypi` | `https://pypi.cnb.cool/<project>/<repo>/simple` |
-| Conan | `conan` | `https://conan.cnb.cool/<project>/<repo>/-/packages/` |
-| Cargo | `cargo` | `https://cargo.cnb.cool/<project>/<repo>/-/packages/` |
-
-### 源平台 × 额外参数速查
-
-| 平台 | SRC_REGISTRY_TYPE | 额外必填参数 |
-|------|-------------------|--------------|
-| CODING | `coding` | `SRC_CODING_DISABLE_THIRD_PACKAGE=true`（推荐） |
-| CNB | `cnb` | - |
-| CodeUp | `codeup` | `SRC_CODEUP_TOKEN` |
-| Nexus | `nexus` | Docker 额外需要 `SRC_NEXUS_DOCKER_REPO_URL` |
-| Jfrog | `jfrog` | - |
-| TCR | `tcr` | `SRC_TCR_REGION` + `SRC_TCR_SECRET_ID` + `SRC_TCR_SECRET_KEY` |
-| Other | `other` | 必须配合 `PACKAGE_VERSIONS_FILE_NAME` 使用 |
-
-### 常用正则示例
-
-```bash
-# 只迁移特定前缀的包
--e INCLUDE_REGX="^@myorg"
-
-# 排除第三方包
--e EXCLUDE_REGX="^third-party"
-
-# 只迁移特定包的特定版本范围
--e INCLUDE_REGX="^myapp#[1-7].*$"
-
-# 组合多个规则（逗号分隔）
--e INCLUDE_REGX="^@myorg,^mypackage"
--e EXCLUDE_REGX="^@myorg/test,^@myorg/dev"
-```
-
----
-
-## 🔗 相关资源
-
-- **镜像地址**：`docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest`
-- **快速开始**：`docs/usage.md`
-- **参数说明**：`docs/parameters.md`
-- **访问凭证获取**：`docs/certificate.md`