用途:帮助用户查找仍从 _key 读取语言的旧 GROQ 查询,并为 v5 安全改写。适用于 sanity-plugin-internationalized-array 从 v4 迁移到 v5,或 @sanity/document-internationalization 从 v5 迁移到 v6 并伴随语言字段变化时,也可用于查找仍用 _key 做语言查找的查询、更新 _key == "en" 或 _key == $language 之类的过滤条件。
主要能力:提供基于 grep 的检测命令,搜索 _key 上的直接语言比较,以及提及 _key 的本地化数组过滤;优先识别 field[_key == ...][0].value 和 select(...) 中比较 _key 与语言值的分支;检查 groq 使用情况,并显式检查模板插值语言表达式(如 _key == "${language}"、_key == "${locale}")。改写时沿用原查询中的同一语言操作数(字符串字面量、变量或模板插值)。
使用方式:先运行检测命令定位匹配,再逐条人工复核,避免把用于数组项身份的 _key 误判为语言。迁移前使用向后兼容写法:_key == <languageExpr> 改为 language == <languageExpr> || _key == <languageExpr>;迁移完成后改为最终写法:language == <languageExpr>。报告时列出每个仍以 _key 为语言来源的位置、给出使用同一语言表达式的替换,并标注为向后兼容(迁移前)或最终(迁移后),同时把匹配归类为 runtime、docs/example 或 ambiguous,指出需人工复核的模糊用法。
限制:检测命令基于 grep,环境不同需改用编辑器全局搜索的等效模式;需排除 node_modules;改写前必须确认 _key 确实用于语言而非无关的数组项标识,否则可能产生误报。资料未提供其他平台或收费信息。