用途:通过 orbit CLI 管理 QMetry 的测试用例、测试周期、文件夹和项目,适用于 QMetry Cloud,基于 REST API,支持多配置档案与密钥解析(1Password、Infisical)。
前提条件:需安装 orbit CLI(若 which orbit 失败,可执行 brew install jorgemuza/tap/orbit,或 curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh,Windows 用 scoop bucket add jorgemuza https://github.com/jorgemuza/scoop-bucket && scoop install orbit);需在 ~/.config/orbit/config.yaml 配置 qmetry 服务;需 QMetry API key(在 QMetry Settings → API Keys 生成),可存为 1Password(op://)或 Infisical(infisical://<env>/<path>/<KEY>)引用。
配置:服务需设置 name、type: qmetry、base_url(如 https://qtmcloud.qmetry.com)、headers.referer(QMetry 的 CORS 校验要求)以及 auth.method: apiKey 与 apiKey。apiKey 认证会把密钥作为 apiKey HTTP 头随每次请求发送。
主要命令:orbit -p myprofile qm project 列出项目;qm folder --project-id 列出文件夹;qm tc list --project-id [--folder-id] 列出用例;qm tc view QTC-101 查看用例;qm tc create --project-id --summary 创建用例,可加 --folder-id、--description、--steps(BDD 步骤 JSON);qm cycle list --project-id 列出周期;qm cycle create --project-id --name 创建周期。
典型流程:读取 Jira 工单提取验收标准,为每条 AC 创建带 Given/When/Then 步骤的 QMetry 用例,并用返回的 QTC 键在自动化脚本中引用。可用 orbit qm project 与 orbit qm folder --project-id ID 发现 ID。
限制:资料未提供完整命令与参数细节(见 references/commands.md)、价格、平台支持范围或效果说明。