JSON 文件翻译助手
翻译 JSON 文件中的指定字段（默认为 description），支持多种语言互译，并保持原始 JSON 结构完整。
核心功能
- 智能字段识别：自动查找 JSON 中的目标字段（默认
description），支持自定义指定多个字段 - 多语言支持：支持中文、英文、日文、韩文四种语言的互译
- 真实翻译 API：集成 MyMemory 和 LibreTranslate 两个在线翻译服务
- 进度反馈：显示翻译进度和当前处理的字段内容
- 结构保持：只翻译目标字段，保持 JSON 结构和其他字段不变
- 错误处理：翻译失败时保留原文并添加标记，不会中断整个翻译过程
- 文件导出：提供翻译后的 JSON 文件下载和结果展示
工作流程
1. 读取用户需求
先理解用户需要翻译的内容：
- JSON 文件的路径
- 需要翻译的字段名（默认
description，可指定多个逗号分隔） - 源语言和目标语言
- 是否需要查看翻译结果或直接下载文件
2. 调用翻译脚本
使用技能目录中的 scripts/translate_json.py 脚本进行翻译：
python scripts/translate_json.py <输入文件> --target-language <语言代码> [选项]
脚本参数
| 参数 | 说明 | 示例 |
|---|---|---|
--target-language | 目标语言代码 | zh, en, ja, ko |
--source-language | 源语言代码（可选，默认 auto） | zh, en, ja, ko 或 auto |
--fields | 要翻译的字段名（逗号分隔，可选） | name,description |
--output | 输出文件路径（可选） | output.json |
支持的语言代码
| 语言代码 | 语言名称 |
|---|---|
zh | 中文（简体） |
en | 英文 |
ja | 日文 |
ko | 韩文 |
3. 查看翻译结果
脚本执行后会显示：
- 翻译进度（当前/总数）
- 原文和译文预览
- 翻译统计信息
- 输出文件路径
4. 下载翻译后的文件
翻译完成后：
- 控制台会显示输出文件路径
- 用户可以下载该文件查看完整内容
- 可以选择性地将结果返回给用户
使用示例
示例 1：翻译 description 字段到中文
用户说： "帮我翻译这个 JSON 文件的 description 字段到中文"
python scripts/translate_json.py data.json --target-language zh
示例 2：翻译多个字段到英文
用户说： "把这个 JSON 文件的 name 和 description 字段翻译成英文"
python scripts/translate_json.py data.json --target-language en --fields name,description
示例 3：指定源语言翻译
用户说： "将这个文件从中文翻译成日文"
python scripts/translate_json.py data.json --target-language ja --source-language zh
示例 4：指定输出文件
用户说： "翻译这个文件，输出到 translation.json"
python scripts/translate_json.py data.json --target-language en --output translation.json
输出说明
控制台输出
脚本执行时会在控制台显示：
[当前/总数]- 翻译进度- 字段路径 - 当前正在翻译的字段位置
- 原文预览 - 50个字符
- 译文预览 - 50个字符
- 完成信息 - 翻译成功/失败统计
文件输出
- 默认文件名格式：
{原文件名}_translated.json - 用户也可以通过
--output参数指定输出路径 - JSON 文件保持原始缩进格式，使用 UTF-8 编码
错误处理
脚本会处理以下错误情况：
- JSON 文件格式错误 - 显示错误信息并退出
- 文件不存在 - 提示文件路径错误
- 字段不存在 - 显示警告信息但继续处理
- 翻译失败 - 保留原文并添加错误标记
注意事项
- API 限流：脚本会自动在每次翻译之间添加 0.1 秒延迟，避免 API 限流
- 大文件处理：建议 JSON 文件大小不超过 10MB
- 网络要求：需要能够访问 MyMemory API (
https://api.mymemory.translated.net) - 字段存在性：如果指定的字段在 JSON 中不存在，会提示缺失字段但继续处理其他字段
- 结构保持：只翻译目标字段，其他字段和 JSON 结构完全保持不变
- 依赖：需要安装
requests库（脚本会自动处理，如果未安装会提示）
技术实现
翻译服务
脚本使用 MyMemory 作为主要翻译服务，LibreTranslate 作为备用服务：
- MyMemory：免费在线翻译 API，主要翻译服务
- LibreTranslate：开源机器翻译 API，作为备用服务
- 自动降级：主服务失败时自动切换到备用服务
- 错误处理：API 失败时保留原文并添加标记
字段查找
脚本使用深度递归算法查找 JSON 中的目标字段：
- 递归遍历所有对象和数组
- 识别指定字段名
- 记录字段路径和值
- 保持原始 JSON 结构
进度反馈
脚本提供实时翻译进度：
- 显示当前翻译的字段编号
- 显示字段路径和内容预览
- 显示翻译状态（成功/失败）
- 显示完成统计信息