i18n-helper

1# 🌍 i18n-helper — 国际化/本地化助手
2 
3## 触发条件
4当用户要求以下操作时激活此技能：
5- 扫描代码中的硬编码中文/英文文本
6- 为项目添加国际化支持（i18n）
7- 批量提取和翻译语言文件
8- 检查翻译完整性（缺失 key 检测）
9 
10## 工作流程
11 
12### 1. 项目分析
13- 检测项目类型（React/Vue/Angular/Node.js/Python/Java 等）
14- 识别已使用的 i18n 框架（react-intl, vue-i18n, i18next, gettext 等）
15- 扫描源代码目录结构
16 
17### 2. 硬编码文本扫描
18- 在 `.js/.jsx/.ts/.tsx/.vue/.py/.java/.go` 等文件中搜索硬编码字符串
19- 排除：变量名、URL、正则表达式、import 路径、日志调试信息
20- 标记：用户可见的 UI 文本、错误提示、通知消息
21 
22### 3. 语言文件生成
23根据项目框架生成对应格式：
24- **JSON** (i18next/react-intl): `{ "key": "value" }`
25- **YAML** (vue-i18n): `key: value`
26- **PO/POT** (gettext): 标准格式
27- **Properties** (Java): `key=value`
28 
29### 4. 代码替换
30- 将硬编码文本替换为 i18n 函数调用
31- 保持原有格式和变量插值
32- 示例：
33  ```javascript
34  // 替换前
35  alert('保存成功');
36  // 替换后
37  alert(t('alert.saveSuccess'));
38  ```
39 
40### 5. 完整性检查
41- 对比主语言文件与翻译文件的 key 差异
42- 输出缺失翻译的 key 列表
43- 统计翻译完成度百分比
44 
45## 输出格式
46```markdown
47## 📊 i18n 扫描报告
48 
49### 硬编码文本
50| 文件 | 行号 | 内容 | 建议 key |
51|------|------|------|----------|
52| src/App.tsx | 42 | '欢迎使用' | page.welcome |
53 
54### 语言文件
55已生成 `locales/zh-CN.json` 和 `locales/en-US.json`
56 
57### 翻译完整性
58- zh-CN: 45/45 (100%) ✅
59- en-US: 42/45 (93.3%) ⚠️ 缺少 3 个 key
60```
61 
62## 支持的 i18n 框架
63- react-intl / FormatJS
64- vue-i18n
65- i18next / react-i18next / next-i18next
66- Angular @ngx-translate
67- Python gettext / Flask-Babel
68- Java ResourceBundle / Spring MessageSource
69- Go go-i18n
70 
71## 注意事项
72- 不要翻译技术术语（API、SDK、HTTP 等）
73- 保留变量占位符 `{name}` `{{count}}` `%s` 等格式
74- 复数形式和性别变体需要特殊处理
75- 日期、数字、货币格式需使用 locale 感知的格式化函数