SuperAPI AI 工具集

cloud

测试与质量

查看项目

更新于 10-16 09:28

技能介绍

用途:Shiplight Cloud 用于把本地项目中的测试资产与 Shiplight 云端同步,并通过 REST API 管理云端测试资源。

主要能力:通过 MCP 工具保存与获取测试用例、测试账号、模板和 TypeScript 函数;上传后可记录云端 ID 以避免重复创建(测试用例写顶层 test_case_id,模板写 template_id,函数用 @function_id JSDoc 标签)。REST API 支持测试用例的查询、获取、软删除、批量移动文件夹;测试运行的列表、详情、触发与用例结果查询;环境、环境变量、测试账号、文件夹、测试套件、标签、模板、函数和 S3 工件下载等接口。可通过用例、套件、标签或组合方式触发运行,并按标签(OR 逻辑)解析用例。

使用方式:需在项目 .env 中设置 SHIPLIGHT_API_TOKEN,然后重连 MCP(/mcp)。所有 REST 调用使用 Authorization: Bearer $SHIPLIGHT_API_TOKEN。MCP 保存时优先传 file_path 而非内容,获取测试用例时使用 output_format: 'yaml'。查询套件时建议用 ?fields= 指定所需字段。二进制工件下载需用 curl -o 保存。

适用场景:本地测试用例与云端保持同步、云端执行与查看测试结果、按标签或套件组织回归运行、下载视频与 trace 等测试工件。

限制:未设置令牌时云工具不可用,错误码 401/403/404/422 分别对应令牌无效、权限不足、资源不存在和校验失败。部分端点(run-results、test-case-results)不带 /v1/ 前缀。触发运行后需轮询相关接口获取状态。其他未在资料中说明的定价或平台细节暂未提供。