Documentation
README
🌍 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):
{ "key": "value" } - YAML (vue-i18n):
key: value - PO/POT (gettext): 标准格式
- Properties (Java):
key=value
4. 代码替换
- 将硬编码文本替换为 i18n 函数调用
- 保持原有格式和变量插值
- 示例:
// 替换前 alert('保存成功'); // 替换后 alert(t('alert.saveSuccess'));
This is the opening of the README. Read the full README on GitHub.