用途:在运行中的应用里验证语言切换是否“真的”完成,而不只是某个词改变。它针对三个独立问题:切换后页面文案是否整体翻译、用户正在填写的表单内容是否保留、刷新后语言选择是否仍生效。
主要能力:可在无需编写测试代码的情况下对运行中的应用进行断言。使用前先确认会话可被观测:reticle_session({ action: "list" })。期望字符串应取自应用的翻译文件(如 locales/、messages/、i18n/),而非凭记忆。应选择页面上原本不存在的字符串进行断言,并把谓词范围限定到所在区域。
使用方式:先记录当前语言下不同区域的可见字符串,并向表单填入唯一值,确认 valueChanged: true。切换时使用 reticle_act_and_wait 并声明必须变化的内容,如新语言标题存在、旧语言标题缺席、翻译键缺席、无控制台错误;若选择存于服务端,可加网络断言。随后用 reticle_assert 证明输入值仍在,并通过 testid 查询,因为可访问名称已翻译。最后用 reticle_navigate({ sessionId, reload: true }) 真实刷新,在返回的新会话上断言仍为新语言。若切换导致整页加载,SDK 会被销毁,此时改用 reticle_navigate 指出地址,并将输入是否保留记为按设计丢失。
适用场景:国际化、语言选择器、区域设置相关的页面验证。
限制:结论仅针对一个语言对、你指定的字符串和你填入的一个字段;未断言的字符串应报告为未检查。从右到左布局、日期与数字格式、复数形式不在本技能检查范围。只有 verified: "yes" 才算通过;"no"、"unknown"、"no-fault" 均不构成切换有效的证据。若字符串未翻译,可用 reticle_look 获取文件:行位置。交付前应把语言切回,以免影响后续会话。
安装:未安装时使用 RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init,然后使用 install-and-verify 技能。能力参考:curl https://docs.reticle.sh/capabilities.md;其他文档:curl https://docs.reticle.sh/llms.txt。