← 返回主站

🌐 i18n-kit

一键将你的网页翻译成多种语言

📝
自动提取
智能识别并提取网页中的中文文案
🤖
AI 翻译
使用 Gemini API 翻译成 6 种语言
🔄
语言切换
自动添加右上角语言切换按钮
📊
日志记录
记录翻译时间和 token 消耗

🚀 快速开始

安装依赖
cd ~/MyTools/tasks/i18n-kit
pip install google-generativeai
设置 API Key
export GEMINI_API_KEY="your-gemini-api-key"
一键翻译
./auto-translate.sh ~/你的网页路径 "en-US,ja-JP,ko-KR"

📖 使用方法

方法 1：一键翻译（推荐）

最简单的方式，一行命令搞定：

cd ~/MyTools/tasks/i18n-kit
./auto-translate.sh <输入路径> <语言列表>
示例：翻译成英日韩三语
./auto-translate.sh ~/MyOpenClawWebsite/sites/my-page "en-US,ja-JP,ko-KR"

方法 2：翻译并自动部署

翻译完成后自动推送到 Vercel：

./translate-and-deploy.sh ~/MyOpenClawWebsite/sites/你的页面

方法 3：翻译成所有语言

一次生成 6 种语言版本：

./translate-all.sh ~/你的网页路径

🌍 支持的语言

代码 语言 常用场景
en-US 英语 必备
ja-JP 日语 亚洲市场
ko-KR 韩语 亚洲市场
es-ES 西班牙语 欧美市场
fr-FR 法语 欧洲市场
de-DE 德语 欧洲市场

💡 实际案例

AI 咨询指南（4 语言版本）

命令：

./auto-translate.sh ~/MyOpenClawWebsite/sites/2026-03-05-ai-consulting-guide "en-US,ja-JP,ko-KR"

结果：

统计：

📊 翻译日志

每次翻译后，日志会自动保存到 i18n/logs/translate-YYYYMMDD-HHMMSS.json：

{
  "timestamp": "2026-03-17T08:25:23.326316",
  "duration_seconds": 3.43,
  "total_texts": 30,
  "translated_texts": 30,
  "failed_texts": 0,
  "api_calls": 3,
  "estimated_tokens": 1500,
  "target_languages": ["en-US", "ja-JP", "ko-KR"]
}
查看日志
ls -lt ~/你的项目/i18n/logs/
cat ~/你的项目/i18n/logs/translate-*.json | jq

🎨 语言切换器

翻译后的页面会自动添加右上角的语言切换按钮：

🔧 工作原理

1
提取阶段（Extract）

扫描 HTML 文件，找到所有中文文本，替换为 token（如 __I18N__k_abc123__），生成字典文件。

2
翻译阶段（Translate）

使用 Gemini API 批量翻译字典文件，生成多语言版本的字典。

3
应用阶段（Apply）

用翻译字典替换 token，生成多语言版本的 HTML 文件。

4
切换器阶段（Embed Switch）

在页面中嵌入所有语言的字典、语言切换 UI 和切换逻辑。

📚 更多资源

GitHub 仓库 完整文档 README

🐛 常见问题

Q: 翻译失败怎么办？

A: 检查以下几点：

  1. GEMINI_API_KEY 是否设置正确
  2. 网络连接是否正常
  3. 查看日志文件了解具体错误

Q: 翻译质量不好怎么办？

A: 可以手动编辑字典文件：

vim ~/你的项目/i18n/en-US.json

然后重新生成：

python3 main.py apply --root ~/你的项目 --lang en-US --out-dir ~/输出目录

Q: 如何调整批量大小？

A: 使用 --batch-size 参数：

python3 translate.py --root ~/你的项目 --targets "en-US" --batch-size 10

🙏 致谢