JSON 文件翻译助手#

翻译 JSON 文件中的指定字段（默认为 description），支持多种语言互译，并保持原始 JSON 结构完整。

核心功能#

• 智能字段识别：自动查找 JSON 中的目标字段（默认 description），支持自定义指定多个字段
• 多语言支持：支持中文、英文、日文、韩文四种语言的互译
• 真实翻译 API：集成 MyMemory 和 LibreTranslate 两个在线翻译服务
• 进度反馈：显示翻译进度和当前处理的字段内容
• 结构保持：只翻译目标字段，保持 JSON 结构和其他字段不变
• 错误处理：翻译失败时保留原文并添加标记，不会中断整个翻译过程
• 文件导出：提供翻译后的 JSON 文件下载和结果展示

工作流程#

1. 读取用户需求#

先理解用户需要翻译的内容：

• JSON 文件的路径
• 需要翻译的字段名（默认 description，可指定多个逗号分隔）
• 源语言和目标语言
• 是否需要查看翻译结果或直接下载文件

2. 调用翻译脚本#

使用技能目录中的 scripts/translate_json.py 脚本进行翻译：

bash

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 字段到中文"

bash

python scripts/translate_json.py data.json --target-language zh

示例 2：翻译多个字段到英文#

用户说： "把这个 JSON 文件的 name 和 description 字段翻译成英文"

bash

python scripts/translate_json.py data.json --target-language en --fields name,description

示例 3：指定源语言翻译#

用户说： "将这个文件从中文翻译成日文"

bash

python scripts/translate_json.py data.json --target-language ja --source-language zh

示例 4：指定输出文件#

用户说： "翻译这个文件，输出到 translation.json"

bash

python scripts/translate_json.py data.json --target-language en --output translation.json

输出说明#

控制台输出#

脚本执行时会在控制台显示：

• [当前/总数] - 翻译进度
• 字段路径 - 当前正在翻译的字段位置
• 原文预览 - 50个字符
• 译文预览 - 50个字符
• 完成信息 - 翻译成功/失败统计

文件输出#

• 默认文件名格式： {原文件名}_translated.json
• 用户也可以通过 --output 参数指定输出路径
• JSON 文件保持原始缩进格式，使用 UTF-8 编码

错误处理#

脚本会处理以下错误情况：

• JSON 文件格式错误 - 显示错误信息并退出
• 文件不存在 - 提示文件路径错误
• 字段不存在 - 显示警告信息但继续处理
• 翻译失败 - 保留原文并添加错误标记

注意事项#

1. API 限流：脚本会自动在每次翻译之间添加 0.1 秒延迟，避免 API 限流
2. 大文件处理：建议 JSON 文件大小不超过 10MB
3. 网络要求：需要能够访问 MyMemory API ( https://api.mymemory.translated.net)
4. 字段存在性：如果指定的字段在 JSON 中不存在，会提示缺失字段但继续处理其他字段
5. 结构保持：只翻译目标字段，其他字段和 JSON 结构完全保持不变
6. 依赖：需要安装 requests 库（脚本会自动处理，如果未安装会提示）

技术实现#

翻译服务#

脚本使用 MyMemory 作为主要翻译服务， LibreTranslate 作为备用服务：

• MyMemory：免费在线翻译 API，主要翻译服务
• LibreTranslate：开源机器翻译 API，作为备用服务
• 自动降级：主服务失败时自动切换到备用服务
• 错误处理：API 失败时保留原文并添加标记

字段查找#

脚本使用深度递归算法查找 JSON 中的目标字段：

• 递归遍历所有对象和数组
• 识别指定字段名
• 记录字段路径和值
• 保持原始 JSON 结构

进度反馈#

脚本提供实时翻译进度：

• 显示当前翻译的字段编号
• 显示字段路径和内容预览
• 显示翻译状态（成功/失败）
• 显示完成统计信息