SuperAPI AI 工具集

i18n-helper

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:i18n-helper 用于为项目添加国际化支持,主要处理代码中的硬编码文本、语言文件生成与翻译完整性检查。触发场景包括扫描硬编码中英文文本、为项目接入 i18n、批量提取和翻译语言文件、检测缺失翻译 key。

主要能力:

  1. 项目分析:检测项目类型(React/Vue/Angular/Node.js/Python/Java 等)与已使用的 i18n 框架(react-intl、vue-i18n、i18next、gettext 等),扫描源代码目录结构。
  2. 硬编码文本扫描:在 .js/.jsx/.ts/.tsx/.vue/.py/.java/.go 等文件中搜索硬编码字符串,排除变量名、URL、正则、import 路径与日志调试信息,标记用户可见的 UI 文本、错误提示和通知消息。
  3. 语言文件生成:按框架生成对应格式,如 JSON(i18next/react-intl)、YAML(vue-i18n)、PO/POT(gettext)、Properties(Java)。
  4. 代码替换:将硬编码文本替换为 i18n 函数调用,并保持原有格式与变量插值。
  5. 完整性检查:对比主语言文件与翻译文件的 key 差异,输出缺失 key 列表与完成度百分比。

使用方式:通过自然语言请求触发,例如要求扫描硬编码文本、添加 i18n 支持、批量提取翻译或检查翻译完整性。输出为扫描报告,包含硬编码文本表格(文件、行号、内容、建议 key)、生成的语言文件路径以及各语言的翻译完整性统计。

支持框架:react-intl / FormatJS、vue-i18n、i18next / react-i18next / next-i18next、Angular @ngx-translate、Python gettext / Flask-Babel、Java ResourceBundle / Spring MessageSource、Go go-i18n。

限制与注意:不要翻译技术术语(API、SDK、HTTP 等);保留 {name}、{{count}}、%s 等变量占位符格式;复数形式与性别变体需特殊处理;日期、数字、货币格式应使用 locale 感知的格式化函数。资料未提供安装命令、具体命令参数、收费或价格信息。