rl-rockcli 0.0.2 → 0.0.4

package/help/help.json

@@ -1,1071 +0,0 @@
-{
-  "name": "rockcli",
-  "description": "ROCK CLI - Reinforcement Open Construction Kit CLI",
-  "tagline": "强化学习沙箱环境的命令行管理工具",
-  "usage": "rockcli <命令> [选项]",
-  "groups": [
-    {
-      "name": "核心命令",
-      "commands": [
-        "sandbox"
-      ]
-    },
-    {
-      "name": "扩展命令",
-      "commands": [
-        "image",
-        "ray",
-        "test"
-      ]
-    }
-  ],
-  "globalOptions": [
-    {
-      "flags": "-v, --verbose",
-      "description": "日志级别 (-v: warning, -vv: info, -vvv: debug)"
-    },
-    {
-      "flags": "--base-url <url>",
-      "description": "服务端地址",
-      "default": "http://127.0.0.1:8080"
-    },
-    {
-      "flags": "--api-key <key>",
-      "description": "API 密钥"
-    },
-    {
-      "flags": "--cluster <id>",
-      "description": "集群标识"
-    },
-    {
-      "flags": "-h, --help",
-      "description": "显示帮助信息"
-    },
-    {
-      "flags": "--version",
-      "description": "显示版本号"
-    }
-  ],
-  "examples": [
-    {
-      "cmd": "rockcli sandbox start",
-      "desc": "启动一个沙箱"
-    },
-    {
-      "cmd": "rockcli sandbox <id> status",
-      "desc": "查看沙箱状态"
-    },
-    {
-      "cmd": "rockcli sandbox <id> exec -- ls -la",
-      "desc": "在沙箱中执行命令"
-    },
-    {
-      "cmd": "rockcli sandbox <id> log search -k \"error\"",
-      "desc": "搜索沙箱日志"
-    },
-    {
-      "cmd": "rockcli sandbox <id> attach",
-      "desc": "连接到沙箱"
-    }
-  ],
-  "footer": "使用 \"rockcli <命令> --help\" 获取命令详情\n\n快捷别名：rc\n\n钉钉答疑群：154245014753",
-  "commands": {
-    "attach": {
-      "description": "连接到沙箱并进入交互式 REPL 模式",
-      "usage": "rockcli attach [sandbox-id]",
-      "options": [
-        {
-          "flags": "[sandbox-id]",
-          "description": "沙箱 ID（不提供时交互式选择）",
-          "required": false
-        },
-        {
-          "flags": "--api-key <key>",
-          "description": "API 认证密钥"
-        },
-        {
-          "flags": "--cluster <id>",
-          "description": "集群标识"
-        },
-        {
-          "flags": "--base-url <url>",
-          "description": "服务端地址"
-        }
-      ],
-      "examples": [
-        {
-          "cmd": "rockcli attach abc123def456",
-          "desc": "连接到沙箱并进入交互式 REPL"
-        }
-      ]
-    },
-    "start": {
-      "description": "启动一个新的沙箱实例",
-      "usage": "rockcli start [选项]",
-      "options": [
-        {
-          "flags": "--image <name>",
-          "description": "Docker 镜像地址",
-          "default": "hub.docker.example.com/chatos/python:3.11"
-        },
-        {
-          "flags": "--memory <size>",
-          "description": "内存限制",
-          "default": "8g"
-        },
-        {
-          "flags": "--cpus <num>",
-          "description": "CPU 限制",
-          "default": "2.0"
-        },
-        {
-          "flags": "--timeout <sec>",
-          "description": "启动超时时间 (秒)",
-          "default": "120"
-        },
-        {
-          "flags": "--auto-clear <sec>",
-          "description": "自动清理时间 (秒)",
-          "default": "300"
-        },
-        {
-          "flags": "--wait-for-alive",
-          "description": "等待沙箱变为 alive 状态"
-        }
-      ],
-      "examples": [
-        {
-          "cmd": "rockcli start",
-          "desc": "基本启动"
-        },
-        {
-          "cmd": "rockcli start --memory 16g --cpus 4",
-          "desc": "自定义资源"
-        },
-        {
-          "cmd": "rockcli start --wait-for-alive",
-          "desc": "启动并等待就绪"
-        }
-      ]
-    },
-    "stop": {
-      "description": "停止指定的沙箱实例",
-      "usage": "rockcli stop <sandbox-id>",
-      "options": [
-        {
-          "flags": "<sandbox-id>",
-          "description": "沙箱 ID",
-          "required": true
-        }
-      ],
-      "examples": [
-        {
-          "cmd": "rockcli stop abc123def456",
-          "desc": "停止指定沙箱"
-        }
-      ]
-    },
-    "sandbox": {
-      "description": "沙箱实例管理",
-      "usage": "rockcli sandbox [start] | <id> <command>",
-      "subcommands": {
-        "start": {
-          "description": "启动一个新的沙箱实例",
-          "usage": "rockcli sandbox start [选项]",
-          "options": [
-            {
-              "flags": "--image <name>",
-              "description": "Docker 镜像地址",
-              "default": "hub.docker.example.com/chatos/python:3.11"
-            },
-            {
-              "flags": "--memory <size>",
-              "description": "内存限制",
-              "default": "8g"
-            },
-            {
-              "flags": "--cpus <num>",
-              "description": "CPU 限制",
-              "default": 2
-            },
-            {
-              "flags": "--timeout <sec>",
-              "description": "启动超时时间 (秒)",
-              "default": 120
-            },
-            {
-              "flags": "--auto-clear <sec>",
-              "description": "自动清理时间 (秒)",
-              "default": 300
-            },
-            {
-              "flags": "--wait-for-alive",
-              "description": "等待沙箱变为 alive 状态"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox start",
-              "desc": "基本启动"
-            },
-            {
-              "cmd": "rockcli sandbox start --memory 16g --cpus 4",
-              "desc": "自定义资源"
-            },
-            {
-              "cmd": "rockcli sandbox start --wait-for-alive",
-              "desc": "启动并等待就绪"
-            }
-          ]
-        },
-        "<id> stop": {
-          "description": "停止指定的沙箱实例",
-          "usage": "rockcli sandbox <id> stop",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> stop",
-              "desc": "停止指定沙箱"
-            }
-          ]
-        },
-        "<id> status": {
-          "description": "查看沙箱运行状态",
-          "usage": "rockcli sandbox <id> status",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> status",
-              "desc": "查看沙箱状态"
-            }
-          ]
-        },
-        "<id> attach": {
-          "description": "连接到沙箱并进入交互式 REPL 模式",
-          "usage": "rockcli sandbox <id> attach",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> attach",
-              "desc": "连接到沙箱并进入交互式 REPL"
-            }
-          ]
-        },
-        "<id> exec": {
-          "description": "在沙箱中执行命令",
-          "aliases": [
-            "execute"
-          ],
-          "usage": "rockcli sandbox <id> exec <command>",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            },
-            {
-              "flags": "<command>",
-              "description": "要执行的命令",
-              "required": true
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> exec 'ls -la'",
-              "desc": "执行命令"
-            },
-            {
-              "cmd": "rockcli sandbox <id> exec 'python script.py --arg1 value1'",
-              "desc": "执行带参数的命令"
-            }
-          ]
-        },
-        "<id> upload": {
-          "description": "上传文件或文件夹到沙箱",
-          "usage": "rockcli sandbox <id> upload [选项]",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            },
-            {
-              "flags": "--file <path>",
-              "description": "本地文件路径 (与 --dir 互斥)"
-            },
-            {
-              "flags": "--dir, -d <path>",
-              "description": "本地目录路径 (与 --file 互斥)"
-            },
-            {
-              "flags": "--target-path <path>",
-              "description": "目标路径",
-              "required": true
-            },
-            {
-              "flags": "-r, --recursive",
-              "description": "递归上传子目录"
-            },
-            {
-              "flags": "-a, --all",
-              "description": "包含隐藏文件"
-            },
-            {
-              "flags": "-n, --no-clobber",
-              "description": "不覆盖已存在的文件"
-            },
-            {
-              "flags": "-i, --interactive",
-              "description": "覆盖前提示确认"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> upload --file local.txt --target-path /tmp/remote.txt",
-              "desc": "上传单个文件"
-            },
-            {
-              "cmd": "rockcli sandbox <id> upload --dir ./src --target-path /app/src",
-              "desc": "上传目录"
-            },
-            {
-              "cmd": "rockcli sandbox <id> upload --dir ./project --target-path /app -r",
-              "desc": "递归上传目录"
-            }
-          ]
-        },
-        "<id> download": {
-          "description": "从沙箱下载文件",
-          "usage": "rockcli sandbox <id> download [选项]",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            },
-            {
-              "flags": "--file <path>",
-              "description": "远程文件路径",
-              "required": true
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> download --file /tmp/output.txt",
-              "desc": "下载文件"
-            }
-          ]
-        },
-        "<id> history": {
-          "description": "查看沙箱历史记录",
-          "usage": "rockcli sandbox <id> history [选项]",
-          "options": [
-            {
-              "flags": "<id>",
-              "description": "沙箱 ID",
-              "required": true
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli sandbox <id> history",
-              "desc": "查看历史记录"
-            }
-          ]
-        },
-        "<id> log": {
-          "description": "沙箱日志操作",
-          "usage": "rockcli sandbox <id> log <subcommand>",
-          "subcommands": {
-            "search": {
-              "description": "搜索沙箱日志",
-              "usage": "rockcli sandbox <id> log search [log-file] [选项]",
-              "options": [
-                {
-                  "flags": "<id>",
-                  "description": "沙箱 ID",
-                  "required": true
-                },
-                {
-                  "flags": "-k, --keyword <text>",
-                  "description": "搜索关键词 (可多次指定)"
-                },
-                {
-                  "flags": "-f, --field <name=value>",
-                  "description": "按字段过滤 (格式: field=value 或 field!=value)"
-                },
-                {
-                  "flags": "-q, --query <string>",
-                  "description": "直接指定 query_string，优先于 -k 和 -f"
-                },
-                {
-                  "flags": "[log-file]",
-                  "description": "日志文件名 (command.log, access.log, rocklet.log, rocklet_uvicorn.log)"
-                },
-                {
-                  "flags": "-A, --after-context <num>",
-                  "description": "显示匹配日志后的 n 行"
-                },
-                {
-                  "flags": "-B, --before-context <num>",
-                  "description": "显示匹配日志前的 n 行"
-                },
-                {
-                  "flags": "-C, --context <num>",
-                  "description": "显示匹配日志前后各 n 行"
-                },
-                {
-                  "flags": "-m, --minutes <num>",
-                  "description": "搜索最近 N 分钟的日志",
-                  "default": "15"
-                },
-                {
-                  "flags": "-s, --start-time <time>",
-                  "description": "开始时间 (支持时间戳、15m, 1h, 2d 或 ISO 日期)"
-                },
-                {
-                  "flags": "-e, --end-time <time>",
-                  "description": "结束时间，需与 -m 或 -s 搭配使用"
-                },
-                {
-                  "flags": "-l, --limit <num>",
-                  "description": "限制单个日志文件返回的结果数量",
-                  "default": "100"
-                },
-                {
-                  "flags": "-o, --offset <num>",
-                  "description": "跳过前 N 条日志 (用于分页)",
-                  "default": "0"
-                },
-                {
-                  "flags": "--raw",
-                  "description": "显示原始输出 (包含所有字段)"
-                },
-                {
-                  "flags": "--log-format <fmt>",
-                  "description": "输出格式 (logfmt, json, columns)",
-                  "default": "logfmt"
-                },
-                {
-                  "flags": "--columns <fields>",
-                  "description": "过滤显示的字段 (逗号分隔)"
-                },
-                {
-                  "flags": "--multilines",
-                  "description": "移除转义符号，允许多行展示"
-                },
-                {
-                  "flags": "--truncate <num>",
-                  "description": "截断长字段值 (使用 0 禁用截断)",
-                  "default": "2048"
-                },
-                {
-                  "flags": "--count",
-                  "description": "仅显示匹配的日志条数"
-                },
-                {
-                  "flags": "--group-by <fields>",
-                  "description": "按指定字段分组 (file, ip, app, hostname, cluster)"
-                }
-              ],
-              "examples": [
-                {
-                  "cmd": "rockcli sandbox <id> log search -k \"error\"",
-                  "desc": "搜索错误日志"
-                },
-                {
-                  "cmd": "rockcli sandbox <id> log search -m 30",
-                  "desc": "搜索最近30分钟日志"
-                },
-                {
-                  "cmd": "rockcli sandbox <id> log search command.log",
-                  "desc": "查询指定日志文件"
-                },
-                {
-                  "cmd": "rockcli sandbox <id> log search -k \"nohup\"",
-                  "desc": "查询匹配关键词的日志"
-                },
-                {
-                  "cmd": "rockcli sandbox <id> log search command.log -k \"error\" -C 5",
-                  "desc": "显示匹配日志前后各 5 行"
-                },
-                {
-                  "cmd": "rockcli sandbox <id> log search --group-by file",
-                  "desc": "按文件分组查询"
-                }
-              ]
-            },
-            "tail": {
-              "description": "实时跟踪沙箱日志",
-              "usage": "rockcli sandbox <id> log tail [选项]",
-              "options": [
-                {
-                  "flags": "<id>",
-                  "description": "沙箱 ID",
-                  "required": true
-                },
-                {
-                  "flags": "-k, --keyword <text>",
-                  "description": "过滤关键词"
-                },
-                {
-                  "flags": "-i, --interval <sec>",
-                  "description": "刷新间隔",
-                  "default": 5
-                }
-              ],
-              "examples": [
-                {
-                  "cmd": "rockcli sandbox <id> log tail -k \"error\"",
-                  "desc": "实时追踪错误日志"
-                }
-              ]
-            }
-          }
-        }
-      },
-      "commonOptions": [
-        {
-          "flags": "--base-url <url>",
-          "description": "服务端地址",
-          "default": "http://127.0.0.1:8080"
-        },
-        {
-          "flags": "--api-key <key>",
-          "description": "API 密钥"
-        },
-        {
-          "flags": "--cluster <id>",
-          "description": "集群标识"
-        },
-        {
-          "flags": "--extra-header, -H <key=value>",
-          "description": "额外 HTTP 头"
-        }
-      ],
-      "footer": "使用 \"rockcli sandbox <id> <command> --help\" 获取命令详情"
-    },
-    "ray": {
-      "description": "Ray 集群操作",
-      "usage": "rockcli ray <子命令> [选项]",
-      "note": "完整透传 ray-cli 参数，需先安装: pip install -U \"ray[default]\"",
-      "subcommands": {
-        "list": {
-          "description": "列出 Ray 资源",
-          "usage": "rockcli ray list <资源类型> [选项]",
-          "options": [
-            {
-              "flags": "--cluster <id>",
-              "description": "集群标识 (自动转换为 --address)"
-            },
-            {
-              "flags": "--sandbox-id <id>",
-              "description": "沙箱 ID (自动转换为 --filter)"
-            },
-            {
-              "flags": "--detail",
-              "description": "显示详细信息"
-            },
-            {
-              "flags": "--format <fmt>",
-              "description": "输出格式"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli ray list nodes --cluster=nt-gray",
-              "desc": "列出节点"
-            },
-            {
-              "cmd": "rockcli ray list actors --sandbox-id=sb-123 --cluster=nt-gray",
-              "desc": "列出沙箱 actor"
-            }
-          ]
-        },
-        "get": {
-          "description": "获取资源详情",
-          "usage": "rockcli ray get <资源类型> <id> [选项]",
-          "options": [
-            {
-              "flags": "--cluster <id>",
-              "description": "集群标识"
-            },
-            {
-              "flags": "--detail",
-              "description": "显示详细信息"
-            },
-            {
-              "flags": "--format <fmt>",
-              "description": "输出格式"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli ray get sandbox sb-123 --cluster=nt-gray",
-              "desc": "获取沙箱信息"
-            },
-            {
-              "cmd": "rockcli ray get sandbox sb-123 --cluster=nt-gray --detail",
-              "desc": "获取详细信息"
-            }
-          ]
-        }
-      },
-      "footer": "支持所有 ray-cli 原生参数透传"
-    },
-    "login": {
-      "description": "登录并保存凭据到配置文件",
-      "usage": "rockcli login [选项]",
-      "options": [
-        {
-          "flags": "--api-key <key>",
-          "description": "API 认证密钥",
-          "required": true
-        },
-        {
-          "flags": "--cluster <id>",
-          "description": "默认集群 ID"
-        },
-        {
-          "flags": "--user-id <id>",
-          "description": "默认用户 ID"
-        },
-        {
-          "flags": "--experiment-id <id>",
-          "description": "默认实验 ID"
-        }
-      ],
-      "examples": [
-        {
-          "cmd": "rockcli login --api-key <key>",
-          "desc": "基本登录"
-        },
-        {
-          "cmd": "rockcli login --api-key <key> --cluster zb-a --user-id 348956 --experiment-id test",
-          "desc": "完整参数登录"
-        }
-      ]
-    },
-    "logout": {
-      "description": "登出并清除已保存的凭据",
-      "usage": "rockcli logout",
-      "examples": [
-        {
-          "cmd": "rockcli logout",
-          "desc": "登出并清除凭据"
-        }
-      ]
-    },
-    "config": {
-      "description": "配置管理",
-      "usage": "rockcli config [选项]",
-      "options": [
-        {
-          "flags": "--list",
-          "description": "显示当前配置（脱敏敏感值）"
-        },
-        {
-          "flags": "--code-private-token <token>",
-          "description": "设置代码私有令牌用于 CI 访问"
-        },
-        {
-          "flags": "--whale-api-key <key>",
-          "description": "设置 Whale API 密钥用于 CI 传参"
-        },
-        {
-          "flags": "--api-key <key>",
-          "description": "设置沙箱认证的 API 密钥"
-        },
-        {
-          "flags": "--base-url <url>",
-          "description": "设置沙箱基础 URL"
-        },
-        {
-          "flags": "--cluster <id>",
-          "description": "设置默认集群 ID"
-        }
-      ],
-      "examples": [
-        {
-          "cmd": "rockcli config --list",
-          "desc": "显示当前配置"
-        },
-        {
-          "cmd": "rockcli config --code-private-token xxx",
-          "desc": "仅设置代码私有令牌，其他值保持不变"
-        },
-        {
-          "cmd": "rockcli config --code-private-token xxx --whale-api-key xxx",
-          "desc": "设置 CI 配置"
-        },
-        {
-          "cmd": "rockcli config --api-key xxx --base-url http://example.com",
-          "desc": "设置沙箱配置"
-        },
-        {
-          "cmd": "rockcli config --cluster zb-a",
-          "desc": "设置默认集群"
-        }
-      ]
-    },
-    "test": {
-      "description": "测试日志级别或触发 CI 流水线",
-      "usage": "rockcli test [子命令] [流水线名称] [选项]",
-      "subcommands": {
-        "cancel": {
-          "description": "取消正在运行的 CI 流水线",
-          "usage": "rockcli test cancel <流水线名称> <流水线运行ID>"
-        },
-        "summary": {
-          "description": "获取 CI 流水线运行的概要信息（直接输出原始 API 返回内容）",
-          "usage": "rockcli test summary <流水线名称> <流水线运行ID>"
-        },
-        "log": {
-          "description": "查看 CI 流水线运行的日志",
-          "usage": "rockcli test log <流水线名称> <流水线运行ID> [步骤名称] [过滤命令]"
-        }
-      },
-      "options": [
-        {
-          "flags": "--list",
-          "description": "列出所有可用的 CI 流水线"
-        },
-        {
-          "flags": "--branch <name>",
-          "description": "流水线分支名（覆盖默认值）"
-        },
-        {
-          "flags": "--params <string>",
-          "description": "流水线附加参数（格式: key1=value1,key2=value2 或 JSON字符串）"
-        },
-        {
-          "flags": "--simulate-error, -e",
-          "description": "模拟错误条件（用于日志测试）"
-        },
-        {
-          "flags": "--simulate-warning, -w",
-          "description": "模拟警告条件（用于日志测试）"
-        },
-        {
-          "flags": "--simulate-info, -i",
-          "description": "模拟信息条件（用于日志测试）"
-        },
-        {
-          "flags": "--simulate-debug, -d",
-          "description": "模拟调试条件（用于日志测试）"
-        }
-      ],
-      "examples": [
-        {
-          "cmd": "rockcli test --list",
-          "desc": "列出可用的 CI 流水线及默认参数"
-        },
-        {
-          "cmd": "rockcli test <流水线名称>",
-          "desc": "运行指定的 CI 流水线，支持的流水线名称：py-unity-rock-test, ScaleAligner-rock-smoke-test, ScaleAligner-rock-health, rock-xrl-ut"
-        },
-        {
-          "cmd": "rockcli test ScaleAligner-rock-health --params 'cluster=zb-a,rockSdk=rock-rl==0.1.8.3,apikey=xxx'",
-          "desc": "运行指定的 CI 流水线并以键值对形式传递参数"
-        },
-        {
-          "cmd": "rockcli test ScaleAligner-rock-smoke-test --params 'environment=pre,cluster=zb,api-key=xxx,user_id=400231,sdk_version=rock-rl,sdk_version_number=0.1.8.3,sdk_package_url=http://tisplus-console.oss-cn-hangzhou.aliyuncs.com/chatos/rockpackages/rl_rock-1.1.0-py3-none-any.whl'",
-          "desc": "运行指定的 CI 流水线并以键值对形式传递参数"
-        },
-        {
-          "cmd": "rockcli test py-unity-rock-test --params '{\"pytest_args\":[\"-s\",\"-v\",\"test_rock_sandbox.py\",\"--api-key t-xrl-qatest\",\"--cluster zb\",\"--url http://pre-127.0.0.1:8080\",\"--image hub.docker.example.com/chatos/python:3.11\",\"--user-id 378561\",\"--experiment-id cli-ci-test\"],\"sdk_package_url\":\"http://tisplus-console.oss-cn-hangzhou.aliyuncs.com/chatos/rockpackages/rl_rock-1.1.0-py3-none-any.whl\"}'",
-          "desc": "运行指定的 CI 流水线并以 JSON 格式传递复杂参数"
-        },
-        {
-          "cmd": "rockcli test <流水线名称> --branch feature/new-branch",
-          "desc": "使用自定义分支运行"
-        },
-        {
-          "cmd": "rockcli test cancel <流水线名称> <流水线运行ID>",
-          "desc": "取消正在运行的流水线"
-        },
-        {
-          "cmd": "rockcli test summary <流水线名称> <流水线运行ID>",
-          "desc": "获取流水线运行概要"
-        },
-        {
-          "cmd": "rockcli test log <流水线名称> <流水线运行ID>",
-          "desc": "查看流水线步骤列表"
-        }
-      ],
-      "note": "支持的 CI 流水线: py-unity-rock-test, ScaleAligner-rock-smoke-test, ScaleAligner-rock-health, rock-xrl-ut"
-    },
-    "update": {
-      "description": "检查并升级 ROCK CLI 到最新版本",
-      "usage": "rockcli update",
-      "examples": [
-        {
-          "cmd": "rockcli update",
-          "desc": "检查并升级到最新版本"
-        }
-      ],
-      "note": "此命令会检查 npm registry 上的最新版本，并提示用户是否升级。\n升级过程不受防打扰机制和环境变量限制。\n主版本号变化时不会自动升级，以避免破坏性更新。"
-    },
-    "image": {
-      "description": "镜像转储操作",
-      "usage": "rockcli image <子命令> [选项]",
-      "subcommands": {
-        "mirror": {
-          "description": "将 Docker 镜像从源仓库镜像到目标仓库",
-          "usage": "rockcli image mirror [镜像列表] [选项]",
-          "options": [
-            {
-              "flags": "[images..]",
-              "description": "Docker 镜像名称"
-            },
-            {
-              "flags": "--file, -f <path>",
-              "description": "包含镜像列表的输入文件 (txt 或 jsonl 格式)",
-              "group": "Input:"
-            },
-            {
-              "flags": "--mode <mode>",
-              "description": "执行模式",
-              "choices": [
-                "local",
-                "remote"
-              ],
-              "default": "remote",
-              "group": "Execution:"
-            },
-            {
-              "flags": "--concurrency, -c <num>",
-              "description": "沙箱并发数 (并行沙箱数量，最少3个，默认根据CPU核数自动计算)",
-              "group": "Execution:"
-            },
-            {
-              "flags": "--source-registry <url>",
-              "description": "源仓库 URL",
-              "group": "Source Registry:"
-            },
-            {
-              "flags": "--source-username <name>",
-              "description": "源仓库用户名",
-              "group": "Source Registry:"
-            },
-            {
-              "flags": "--source-password <pass>",
-              "description": "源仓库密码",
-              "group": "Source Registry:"
-            },
-            {
-              "flags": "--target-registry <url>",
-              "description": "目标仓库 URL (必需)",
-              "group": "Target Registry:"
-            },
-            {
-              "flags": "--target-username <name>",
-              "description": "目标仓库用户名 (私有仓库必需)",
-              "group": "Target Registry:"
-            },
-            {
-              "flags": "--target-password <pass>",
-              "description": "目标仓库密码 (私有仓库必需)",
-              "group": "Target Registry:"
-            },
-            {
-              "flags": "--namespace, -n <name>",
-              "description": "目标命名空间 (覆盖源命名空间)",
-              "group": "Target Registry:"
-            },
-            {
-              "flags": "--repo <name>",
-              "description": "目标仓库名 (覆盖源仓库名)",
-              "group": "Target Registry:"
-            },
-            {
-              "flags": "--auth-token <token>",
-              "description": "沙箱授权令牌 (remote 模式)",
-              "group": "Sandbox:"
-            },
-            {
-              "flags": "--cluster <id>",
-              "description": "集群 (remote 模式)",
-              "group": "Sandbox:"
-            },
-            {
-              "flags": "--retry <num>",
-              "description": "失败传输的重试次数",
-              "default": "3",
-              "group": "Options:"
-            },
-            {
-              "flags": "--resume",
-              "description": "从进度文件恢复",
-              "default": "false",
-              "group": "Options:"
-            },
-            {
-              "flags": "--progress-file <path>",
-              "description": "进度文件路径",
-              "group": "Options:"
-            },
-            {
-              "flags": "--verbose, -v",
-              "description": "详细输出",
-              "default": "false",
-              "group": "Options:"
-            },
-            {
-              "flags": "--quiet, -q",
-              "description": "静默输出",
-              "default": "false",
-              "group": "Options:"
-            },
-            {
-              "flags": "--skip-pull-if-exists",
-              "description": "如果本地/沙箱中镜像已存在则跳过 pull",
-              "default": "false",
-              "group": "Options:"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli image mirror nginx:latest --target-registry registry.example.com --target-username user --target-password pass",
-              "desc": "镜像单个镜像"
-            },
-            {
-              "cmd": "rockcli image mirror -f images.jsonl --target-registry registry.example.com --target-username user --target-password pass",
-              "desc": "从文件批量镜像"
-            },
-            {
-              "cmd": "rockcli image mirror -f images.jsonl -c 10 --mode remote --target-registry registry.example.com --target-username user --target-password pass",
-              "desc": "使用并发传输"
-            }
-          ]
-        },
-        "dump": {
-          "description": "通过沙箱传输 Docker 镜像",
-          "usage": "rockcli image dump [镜像列表] [选项]",
-          "options": [
-            {
-              "flags": "--file, -f <path>",
-              "description": "包含镜像列表的输入文件"
-            },
-            {
-              "flags": "--output-registry <url>",
-              "description": "目标仓库地址"
-            },
-            {
-              "flags": "--namespace <name>",
-              "description": "目标命名空间"
-            },
-            {
-              "flags": "--access-key-id <id>",
-              "description": "仓库认证的访问密钥 ID"
-            },
-            {
-              "flags": "--access-key-secret <secret>",
-              "description": "仓库认证的访问密钥"
-            },
-            {
-              "flags": "--sandbox-mode <mode>",
-              "description": "沙箱执行模式",
-              "default": "batch"
-            },
-            {
-              "flags": "--concurrency, -c <num>",
-              "description": "并发传输级别",
-              "default": "1"
-            },
-            {
-              "flags": "--retry <num>",
-              "description": "失败传输的重试次数",
-              "default": "3"
-            },
-            {
-              "flags": "--resume",
-              "description": "从进度文件恢复",
-              "default": "false"
-            },
-            {
-              "flags": "--verbose, -v",
-              "description": "详细输出",
-              "default": "false"
-            },
-            {
-              "flags": "--quiet, -q",
-              "description": "静默输出",
-              "default": "false"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli image dump nginx:latest",
-              "desc": "传输单个镜像"
-            },
-            {
-              "cmd": "rockcli image dump nginx:latest python:3.11",
-              "desc": "传输多个镜像"
-            },
-            {
-              "cmd": "rockcli image dump --file images.txt",
-              "desc": "从文件传输镜像"
-            },
-            {
-              "cmd": "rockcli image dump -f images.txt --concurrency 2",
-              "desc": "使用并行传输"
-            }
-          ]
-        },
-        "task": {
-          "description": "管理转储任务",
-          "usage": "rockcli image task <任务动作> [任务ID]",
-          "options": [
-            {
-              "flags": "<task-action>",
-              "description": "任务动作",
-              "choices": [
-                "list",
-                "status",
-                "resume"
-              ]
-            },
-            {
-              "flags": "[task-id]",
-              "description": "任务 ID (用于 status 和 resume 动作)"
-            }
-          ],
-          "examples": [
-            {
-              "cmd": "rockcli image task list",
-              "desc": "列出所有转储任务"
-            },
-            {
-              "cmd": "rockcli image task status <task-id>",
-              "desc": "获取任务状态"
-            },
-            {
-              "cmd": "rockcli image task resume <task-id>",
-              "desc": "恢复失败的任务"
-            }
-          ]
-        }
-      },
-      "footer": "使用 \"rockcli image <子命令> --help\" 获取子命令详情"
-    }
-  }
-}