用途：通过 TestRail REST API 管理 QA 测试资产与执行结果，适合在命令行或 CI 流程中读取项目、套件、分区、用例、运行、测试、结果、里程碑和用户，并写入用例、运行与结果。
主要能力：列出/获取项目、套件、分区、用例、运行、测试、里程碑与用户；创建和更新测试用例；创建测试运行；为单个测试或按 case_id 批量添加结果；关闭测试运行。
使用方式：需设置 TESTRAIL_EMAIL、TESTRAIL_TOKEN、TESTRAIL_INSTANCE，使用 HTTP Basic 认证，邮箱作用户名、API 密钥作密码。基址为 https://$TESTRAIL_INSTANCE.testrail.io/index.php?/api/v2/，请求通过 curl 加 -u "$TESTRAIL_EMAIL:$TESTRAIL_TOKEN" 发送，POST 使用 Content-Type: application/json 并通过 -d @/tmp/testrail_request.json 传参。额外参数使用 &key=value。连接排查可运行 zero doctor check-connector --env-name TESTRAIL_TOKEN 或指定 --url 的检查命令。
适用场景：CI 回传结果、查询失败用例、按迭代创建并关闭测试运行、维护用例库。
限制：状态、优先级、类型 ID 可能因实例自定义而不同；批量端点原子提交，任一记录校验失败整批拒绝；分页使用 offset 与 limit，默认及最大 250；TestRail Cloud 默认每用户每分钟 180 次请求，429 会返回 Retry-After；自托管 Server 主机不同，需调整 TESTRAIL_INSTANCE。case_id 属于套件，test_id 属于具体运行，回传结果时不要混淆。付费与价格信息暂未提供。