SuperAPI AI 工具集

i18n-validate

测试与质量

查看项目

更新于 10-15 22:15

技能介绍

用途:检查本地化(locale)文件的一致性,以一个参考语言为基准,对 locales 目录或单个文件做校验。零配置,可自动检测目录布局、文件格式与语言。

主要能力:错误类检查包括缺失语言、孤立语言、缺失键、多余键、占位符不匹配、复数结构、复数要求、解析错误;警告类检查包括空值与未翻译。

使用方式:安装可执行命令 i18n-validate,或执行 npm install -g @i18n-agent/i18n-validate。基本用法为 i18n-validate [OPTIONS] <path-to-locales-dir-or-file>。常用选项:--ref <LANG> 指定参考语言(默认 en);--expect <LANGS> 指定期望语言(逗号分隔,默认自动发现);--layout <TYPE> 指定 flat、directory、single-file(默认自动检测);--include / --exclude <PATTERN> 做 glob 过滤(可重复);--format <FORMAT> 选择 terminal、json、junit(默认 terminal);-o, --output <FILE> 将报告写入文件(默认 stdout);--strict 让警告计为错误;--no-warnings 抑制警告;--skip <CHECKS> 跳过指定检查;--quiet 仅返回退出码;--config <PATH> 指定配置文件(默认自动检测)。

退出码:0 通过;1 存在错误(或在 --strict 下存在警告);2 参数或配置错误。

适用场景:对 locale 文件做任何编辑后运行,作为低成本回归门禁;需要以编程方式解析并修复问题时使用 --format json,优先修复 missing-keys 与 placeholders 错误;CI 中可选用 --strict --format junit -o report.xml,使警告导致构建失败。

限制:资料未提供价格、平台支持范围、性能表现等细节,暂未提供。