用途:在某个FOLIO模块的现有TestRail用例中批量替换短语、术语或措辞(如UI标签改名、术语更正),可选同时追加Jira引用或批量设置元数据字段。不适用于编写新用例、编辑单个已知ID的用例,或需要逐案人工判断的改动。
主要能力:直接调用TestRail API,无需运行脚本或设置开关。按发布版本分类:预发布用例先复制到存档区保留旧措辞(并加src:C<原始ID>标记)再原地更新,当前发布用例仅原地更新。搜索title、custom_preconds、custom_steps_separated[].content、custom_steps_separated[].expected、custom_steps、custom_expected等字段,使用词边界匹配并排除已含替换文本的用例;支持仅改元数据(此时源区段全部用例被选中,影响面大)。分页读取用例,每页limit=250,直到_links.next为null。
使用方式:依次检测模块、加载模块配置(无配置可用references/config-template.md新建)、收集查找与替换输入(替换内容或元数据至少给一项;元数据须用数值选项ID,需先用get_case_fields解析)、静默从.env、~/.folio-credentials或环境变量读取TESTRAIL_URL、TESTRAIL_USER、TESTRAIL_API_KEY、分页拉取用例、匹配与排除、按custom_release分类(>=阈值为当前,<阈值为预发布,null需询问不可猜测)、渲染预览并等待显式确认(yes/no/edit),之后执行并写入运行日志testrail-update-<module>-<YYYY-MM-DD>.md(含原始→副本ID映射)。凭据用Basic认证。
限制:写入前必须经确认,预览不可跳过或关闭;绝不能用子串匹配、不能按标题识别已存档副本、不能把null发布当预发布;不能静默跳过失败,也不要把单页响应当作全部(size仅为本页数量)。预发布副本与原件的复制和标记是两个独立调用,标记失败时不得视为已存档。分页读取可能瞬时失败,同一offset最多重试3次(2s/4s/8s退避);遇缺口须停止并从最后一个成功offset继续,不得跳过后声称成功。每次只能处理一个模块。API不可用时只能输出可手工应用的变更表格并明确说明未写入任何数据。支持/不支持的收费、价格、平台等信息资料未提供。