支持

• 在 Twitter 上联系我 ，以便在 jsontt CLI 上宣传您的项目

✨ 由 fotogram.ai 赞助 - 使用 AI 将您的自拍转化为杰作 ✨

✨ https://fotogram.ai ✨

🚀 AI / 免费 JSON & YAML 翻译工具 🆓

本软件包可免费帮助您将 JSON/YAML 文件或 JSON 对象翻译成多种语言。

🥷 CLI 支持：

翻译模块	支持	免费
Google Translate	✅	✅ 免费
Google Translate 2	✅	✅ 免费
Microsoft Bing Translate	✅	✅ 免费
Libre Translate	✅	✅ 免费
Argos Translate	✅	✅ 免费
DeepL Translate	✅	需要 API KEY (DEEPL_API_KEY 作为环境变量)</br> 可选 API URL (DEEPL_API_URL 作为环境变量)
gpt-4o	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gpt-3.5-turbo	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gpt-4	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gpt-4o-mini	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gpt-5	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gpt-5-nano	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gpt-5-mini	✅	需要 API KEY (OPENAI_API_KEY 作为环境变量)
gemma-7b	✅	需要 API KEY (GROQ_API_KEY 作为环境变量)
gemma2-9b	✅	需要 API KEY (GROQ_API_KEY 作为环境变量)
mixtral-8x7b	✅	需要 API KEY (GROQ_API_KEY 作为环境变量)
llama3-8b	✅	需要 API KEY (GROQ_API_KEY 作为环境变量)
llama3-70b	✅	需要 API KEY (GROQ_API_KEY 作为环境变量)
llama-cpp	✅	✅ 免费

⏳ 包支持：

翻译模块	支持	免费
Google翻译	✅	✅ 免费
Google翻译 2	✅	✅ 免费
Microsoft必应翻译	✅	✅ 免费
Libre翻译	✅	✅ 免费
Argos翻译	✅	✅ 免费
DeepL翻译	✅	需要API密钥（DEEPL_API_KEY作为环境变量）</br>可选API地址（DEEPL_API_URL作为环境变量）
gpt-4o	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gpt-3.5-turbo	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gpt-4	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gpt-4o-mini	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gpt-5	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gpt-5-nano	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gpt-5-mini	✅	需要API密钥（OPENAI_API_KEY作为环境变量）
gemma-7b	✅	需要API密钥（GROQ_API_KEY作为环境变量）
gemma2-9b	✅	需要API密钥（GROQ_API_KEY作为环境变量）
mixtral-8x7b	✅	需要API密钥（GROQ_API_KEY作为环境变量）
llama3-8b	✅	需要API密钥（GROQ_API_KEY作为环境变量）
llama3-70b	✅	需要API密钥（GROQ_API_KEY作为环境变量）
llama-cpp	✅	✅ 免费

浏览器支持即将推出...

支持的语言

✅ 安装

npm i @parvineyvazov/json-translator

• 或者，你也可以全局安装（如果使用CLI）

npm i -g @parvineyvazov/json-translator

1. 💫 CLI 使用方法

jsontt <你的文件路径.json>
或
jsontt <你的文件路径.yaml/yml>

如何使用？（视频见下文）

参数

• [path]: 必需的 JSON/YAML 文件路径 <your/path/to/file.json>
• [path]: 可选的代理列表文本文件路径 <your/path/to/proxy_list.txt>

选项

  -V, --version                     输出版本号
  -m, --module <Module>             指定翻译模块
  -f, --from <Language>             原始语言
  -t, --to <Languages...>           目标语言
  -n, --name <string>               可选 ↵ | 输出文件名
  -fb, --fallback <string>          可选 ↵ | 失败回退逻辑，
                                    失败时尝试其他翻译模块 | 是，否 | 默认：否
  -cl, --concurrencylimit <number>  可选 ↵ | 设置最大并发限制
                                    （越高越快，但容易被封禁） | 默认：3
  -c, --cache                       可选 ↵ | 启用缓存 | 默认：否
  -h, --help                        显示命令帮助

示例

使用 Google 翻译转换一个 JSON 文件：

jsontt <你的文件路径.json> --module google --from en --to ar fr zh-CN

• 带输出名称

jsontt <你的文件路径.json> --module google --from en --to ar fr zh-CN --name myFiles

• 带失败回退逻辑（失败时尝试其他可能的翻译模块）

jsontt <你的文件路径.json> --module google --from en --to ar fr zh-CN --name myFiles --fallback yes

• 设置并发限制（越高越快，但越容易被封禁 | 默认：3）

jsontt <你的文件路径.json> --module google --from en --to ar fr zh-CN --name myFiles --fallback yes --concurrencylimit 10

其他使用示例

• 翻译（json/yaml）

jsontt file.json

jsontt folder/file.json

jsontt "folder\file.json"

jsontt "C:\folder1\folder\en.json"

• 使用代理（仅限 Google 翻译模块）

jsontt file.json proxy.txt

结果将与原始 JSON/YAML 文件位于同一文件夹中。

• 帮助

jsontt -h

jsontt --help

2. 💥 包使用方法

1. 翻译单词 | 句子

• 将库导入到你的代码中。

对于 JavaScript：

const translator = require('@parvineyvazov/json-translator');

对于 TypeScript：

import * as translator from '@parvineyvazov/json-translator';

// 让我们把“Home sweet home!”这句话从英语翻译成中文

const my_str = await translator.translateWord(
  'Home sweet home!',
  translator.languages.English,
  translator.languages.Chinese_Simplified
);

// my_str: 家，甜蜜的家！

---

2. 翻译 JSON 对象（支持深层对象）

• 将库导入到你的代码中

对于 JavaScript：

const translator = require('@parvineyvazov/json-translator');

对于 TypeScript：

import * as translator from '@parvineyvazov/json-translator';

/*
让我们将我们的深层对象从英语翻译成西班牙语
*/

const en_lang: translator.translatedObject = {
  login: {
    title: 'Login {{name}}',
    email: 'Please, enter your email',
    failure: 'Failed',
  },
  homepage: {
    welcoming: 'Welcome!',
    title: 'Live long, live healthily!',
  },
  profile: {
    edit_screen: {
      edit: 'Edit your informations',
      edit_age: 'Edit your age',
      number_editor: [
        {
          title: 'Edit number 1',
          button: 'Edit 1',
        },
        {
          title: 'Edit number 2',
          button: 'Edit 2',
        },
      ],
    },
  },
};

/*
对于 JavaScript，无需使用 translator.translatedObject（不需要声明类型）
*/

let es_lang = await translator.translateObject(
  en_lang,
  translator.languages.English,
  translator.languages.Spanish
);
/*
es_lang:
            {
              "login": {
                "title": "Acceso {{name}}",
                "email": "Por favor introduzca su correo electrónico",
                "failure": "Fallida"
              },
              "homepage": {
                "welcoming": "¡Bienvenidas!",
                "title": "¡Vive mucho tiempo, vivo saludable!"
              },
              "profile": {
                "edit_screen": {
                  "edit": "Edita tus informaciones",
                  "edit_age": "Editar tu edad",
                  "number_editor": [
                    {
                      "title": "Editar número 1",
                      "button": "Editar 1"
                    },
                    {
                      "title": "Editar número 2",
                      "button": "Editar 2"
                    }
                  ]
                }
              }
            }
*/

---

3. 将 JSON 对象翻译成多种语言（支持深层对象）

• 将库导入到你的代码中

对于 JavaScript：

const translator = require('@parvineyvazov/json-translator');

对于 TypeScript：

import * as translator from '@parvineyvazov/json-translator';

/*
让我们同时将我们的对象从英语翻译成法语、格鲁吉亚语和日语：
*/

const en_lang: translator.translatedObject = {
  login: {
    title: 'Login',
    email: 'Please, enter your email',
    failure: 'Failed',
  },
  edit_screen: {
    edit: 'Edit your informations',
    number_editor: [
      {
        title: 'Edit number 1',
        button: 'Edit 1',
      },
    ],
  },
};

/*
对于 JavaScript，无需使用 translator.translatedObject（不需要声明类型）
*/

const [french, georgian, japanese] = (await translator.translateObject(
  en_lang,
  translator.languages.Automatic,
  [
    translator.languages.French,
    translator.languages.Georgian,
    translator.languages.Japanese,
  ]
)) as Array<translator.translatedObject>; // 对于 JavaScript，你不需要指定类型
/*
french:
{
  "login": {
    "title": "Connexion",
    "email": "S'il vous plaît, entrez votre email",
    "failure": "Manquée"
  },
  "edit_screen": {
    "edit": "Modifier vos informations",
    "number_editor": [
      {
        "title": "Modifier le numéro 1",
        "button": "Éditer 1"
      }
    ]
  }
}

georgian:
{
  "login": {
    "title": "Შესვლა",
    "email": "გთხოვთ, შეიყვანეთ თქვენი ელ",
    "failure": "მცდელობა"
  },
  "edit_screen": {
    "edit": "თქვენი ინფორმაციათა რედაქტირება",
    "number_editor": [
      {
        "title": "რედაქტირების ნომერი 1",
        "button": "რედაქტირება 1"
      }
    ]
  }
}

japanese:
{
  "login": {
    "title": "ログイン",
    "email": "あなたのメールアドレスを入力してください",
    "failure": "失敗した"
  },
  "edit_screen": {
    "edit": "あなたの情報を編辑します",
    "number_editor": [
      {
        "title": "番号1を編集します",
        "button": "編集1を編輯します"
      }
    ]
  }
}
*/

4. 翻译 JSON 文件（支持深层对象）

• 将库导入到你的代码中。

对于 JavaScript：

const translator = require('@parvineyvazov/json-translator');

对于 TypeScript：

import * as translator from '@parvineyvazov/json-translator';

/*
让我们将我们的 json 文件翻译成另一种语言，并将其保存在与 en.json 相同的文件夹中
*/

let path = 'C:/files/en.json'; // 您的 JSON 文件路径（包含文件名）

await translator.translateFile(path, translator.languages.English, [
  translator.languages.German,
]);

── files
   ├── en.json
   └── de.json

---

5. 将 JSON 文件翻译成多种语言（支持深层对象）

• 将库导入到你的代码中。

对于 JavaScript：

const translator = require('@parvineyvazov/json-translator');

对于 TypeScript：

import * as translator from '@parvineyvazov/json-translator';

/*
让我们将我们的 json 文件翻译成多种语言，并将它们保存在与 en.json 相同的文件夹中
*/

let path = 'C:/files/en.json'; // 您的 JSON 文件路径（包含文件名）

await translator.translateFile(path, translator.languages.English, [
  translator.languages.Cebuano,
  translator.languages.French,
  translator.languages.German,
  translator.languages.Hungarian,
  translator.languages.Japanese,
]);

── files
   ├── en.json
   ├── ceb.json
   ├── fr.json
   ├── de.json
   ├── hu.json
   └── ja.json

6. 忽略单词

要在翻译时忽略单词，请在对象中使用 {{word}} 或 {word} 格式。

{
  "one": "Welcome {{name}}",
  "two": "Welcome {name}",
  "three": "I am {name} {{surname}}"
}

…翻译成西班牙语

{
  "one": "Bienvenido {{name}}",
  "two": "Bienvenido {name}",
  "three": "Soy {name} {{surname}}"
}

• jsontt 还会忽略文本中的 URL，这意味着有时在翻译字符串时，翻译可能会破坏其中的 URL。它通过在翻译时自动忽略字符串中的 URL 来防止这种情况发生。

  • 您无需特别做任何事情，它会自动忽略这些 URL。

{
  "text": "this is a puppy https://shorturl.at/lvPY5"
}

…翻译成德语

{
  "text": "das ist ein welpe https://shorturl.at/lvPY5"
}

如何贡献？

• 克隆项目

git clone https://github.com/mololab/json-translator.git

• 安装依赖（使用 Yarn - 如果没有安装，请先安装 Yarn）

yarn

• 展示你的魔法：

  • 更新 CLI

    前往文件 src/cli/cli.ts

  • 更新翻译逻辑

    前往文件 src/modules/functions.ts

  • 更新 JSON 操作（深度处理、发送翻译请求）

    前往文件 src/core/json_object.ts

  • 更新 JSON 文件的读写操作

    前往文件 src/core/json_file.ts

  • 更新翻译中忽略值的功能（映射/取消映射）

    前往文件 src/core/ignorer.ts

• 在本地测试 CLI

为了在本地测试 CLI，我们需要使用 npm link 将包链接到全局环境。

npm link

或者你也可以通过 make 命令直接运行所有步骤：

make run-only-cli

请确保在执行这些命令时，终端具有管理员权限，以避免权限问题。

🏞 路线图🏁

:heavy_check_mark: 翻译单词 | 句子

• 针对 JSON 对象

:heavy_check_mark: 翻译 JSON 对象

:heavy_check_mark: 翻译深层 JSON 对象

:heavy_check_mark: 多语言支持的 JSON 对象翻译

• 支持提取或过滤 JSON 对象中的部分字段进行翻译

• 针对 JSON 文件

:heavy_check_mark: 翻译 JSON 文件

:heavy_check_mark: 翻译深层 JSON 文件

:heavy_check_mark: 多语言支持的 JSON 文件翻译

• 支持提取或过滤 JSON 文件中的部分字段进行翻译

• 通用功能

:heavy_check_mark: CLI 支持

:heavy_check_mark: 安全翻译（检查未定义、过长或空值）

:heavy_check_mark: 大规模翻译任务的队列支持

:heavy_check_mark: 向用户反馈翻译进度（已完成数量、总行数等）

:heavy_check_mark: 支持在翻译中忽略特定值（如 {{name}} 或 {name}）

:heavy_check_mark: LibreTranslate 选项（CLI）

:heavy_check_mark: Argos Translate 选项（CLI）

:heavy_check_mark: Bing Translate 选项（CLI）

:heavy_check_mark: 忽略字符串中的 URL 翻译

:heavy_check_mark: CLI 中的语言及源语言选择选项

:heavy_check_mark: 支持在 CLI 中指定输出文件名（可选参数）

:heavy_check_mark: YAML 文件翻译

:heavy_check_mark: 回退翻译机制（失败时尝试其他模块）

:heavy_check_mark: 支持手动设置并发限制

• LibreTranslate 选项（集成到代码包中）

• Argos Translate 选项（集成到代码包中）

• Bing Translate 选项（集成到代码包中）

• Openrouter 翻译模块

• Cohere 翻译模块

• Anthropic/Claude 翻译模块

• Together AI 翻译模块

• llamacpp 翻译模块

• Google Gemini API 翻译模块

• Groq 支持 - 完整模型列表 作为新的翻译模块

:heavy_check_mark: ChatGPT 支持

• 同步翻译功能

• 浏览器端支持

• 支持使用自建 LibreTranslate 实例进行翻译

• 使 -- 标记可动态调整（用于标记未翻译的内容）

• 更新 CLI 中的 name -> prefix 参数 / 允许在 CLI 中传递空前缀（更适合自动化任务）

• 为 CLI 添加 --prettyPrint 参数，以美化打印 JSON 内容

许可证

@parvineyvazov/json-translator 将采用 MIT 许可证 开放使用。

返回顶部

json-translator 快速上手指南

json-translator 是一款免费且强大的 AI 驱动工具，支持将 JSON 或 YAML 文件及对象翻译成多种语言。它内置了 Google Translate、DeepL、OpenAI (GPT)、Groq 等多种翻译引擎，既支持命令行（CLI）操作，也提供 Node.js 库调用。

环境准备

• 运行时环境：Node.js (建议 v14 及以上版本)
• 包管理器：npm 或 yarn
• 前置依赖：无特殊系统依赖
• API Key (可选)：
  • 使用免费引擎（如 Google, Libre, Argos）无需配置。
  • 使用 DeepL 需设置环境变量 DEEPL_API_KEY。
  • 使用 OpenAI/Groq 模型需分别设置 OPENAI_API_KEY 或 GROQ_API_KEY。

💡 国内加速提示：如果 npm 安装缓慢，建议使用国内镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

你可以选择局部安装（用于项目依赖）或全局安装（用于命令行工具）。

1. 局部安装（推荐用于代码集成）

npm i @parvineyvazov/json-translator

2. 全局安装（推荐用于 CLI 命令行使用）

npm i -g @parvineyvazov/json-translator

基本使用

方式一：命令行 (CLI) 快速翻译文件

这是最简单的用法，直接指定文件路径即可进行翻译。默认使用免费引擎。

基础命令：

jsontt <your/path/to/file.json>

或者翻译 YAML 文件：

jsontt <your/path/to/file.yaml>

指定引擎与目标语言示例： 将 en.json 从英语翻译成中文简体、法语和阿拉伯语，使用 Google 翻译引擎：

jsontt ./locales/en.json --module google --from en --to zh-CN fr ar

常用参数说明：

• -m, --module: 指定翻译模块 (如 google, deepl, gpt-4o)
• -f, --from: 源语言代码 (如 en, zh-CN)
• -t, --to: 目标语言代码列表 (如 zh-CN fr)
• -n, --name: 自定义输出文件名
• --fallback yes: 启用故障转移（当前引擎失败时自动尝试其他引擎）

查看帮助文档：

jsontt -h

---

方式二：代码集成 (Node.js/TypeScript)

适用于在项目中动态翻译字符串或深层嵌套的 JSON 对象。

1. 引入库

JavaScript:

const translator = require('@parvineyvazov/json-translator');

TypeScript:

import * as translator from '@parvineyvazov/json-translator';

2. 翻译单个词句

// 将 "Home sweet home!" 从英语翻译成简体中文
const my_str = await translator.translateWord(
  'Home sweet home!',
  translator.languages.English,
  translator.languages.Chinese_Simplified
);

console.log(my_str); 
// 输出：家，甜蜜的家！

3. 翻译深层 JSON 对象

该工具能智能识别并翻译对象中的字符串值，保留键名和结构不变。

const en_lang = {
  login: {
    title: 'Login {{name}}',
    email: 'Please, enter your email',
  },
  profile: {
    edit_screen: {
      edit: 'Edit your informations',
    }
  }
};

// 执行翻译 (从英语到西班牙语)
const es_lang = await translator.translateObject(
  en_lang,
  translator.languages.English,
  translator.languages.Spanish
);

console.log(es_lang);
// 结果将包含翻译后的西班牙语文本，结构保持原样