命令行
一个没有依赖项的 Python 包。没有密钥时，它作为免费演示运行：每个文件 10,000 个字符，每次运行最多 8 种语言。
运行
pip install kaeris kaeris translate en.json --langs de,ja
输出（已缩短）
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer → Translating en.json → de, ja ✓ Wrote 2 file(s) to /home/you/app /home/you/app/de.json /home/you/app/ja.json ✓ Translation QA: no placeholder loss, no overflow risks
后续命令
| 命令 | 作用 |
|---|---|
kaeris init | 写入 kaeris.json 文件，包含您的源文件、语言和输出文件夹，以便 kaeris translate 命令无需任何标志即可运行。--preset 可为 i18next、react-i18next、next-intl、react-intl、vue-i18n 或 flutter-arb 填充该文件。 |
kaeris translate --only-new | 仅翻译新添加和已编辑的键。kaeris.lock 文件位于源文件旁边，用于记录已完成的操作。支持 JSON 和 ARB 格式。 |
kaeris check | 在您的本地计算机上查找损坏的翻译，无需密钥。不用 Python：npx kaeris check（Node 18+）。检查详情。 |
kaeris languages | 打印出 46 个语言代码。 |
kaeris quota | 显示您本月密钥剩余的额度。 |
常用标志
| 标志 | 含义 |
|---|---|
--langs de,ja | 目标语言，用逗号分隔。短形式为 -l。 |
--out locales | 写入文件的位置。默认：与源文件并排。 |
--verify | 将所有结果翻译回英语并写入 verify.json 文件，以便您可以检查含义。 |
--keep 'KAERIS,GitHub' | 在所有语言中保持原样的单词，例如品牌名称。 |
--context 'a bank app' | 关于您的应用程序的一句话。有助于处理具有两种含义的单词。 |
--tone formal | neutral（中性）、formal（正式）或 casual（随意）。 |
--model openai/gpt-4.1 | Lifetime：用于翻译的 OpenRouter 模型。按语言分别指定：kaeris.json 中的 models。其他套餐会拒绝该请求并说明原因。 |
--key | 您的 API 密钥。或者设置 KAERIS_API_KEY 环境变量，这样更安全：在 --key 之后输入的密钥会保留在您的 shell 历史记录中，并在进程列表中显示。 |
--source-lang en | 源文件的语言。默认为 en；也支持 locales/<lang>/<namespace>.json 布局。 |
--back-lang en | --verify 标志翻译回的目标语言。默认为 en。 |
--lock PATH | kaeris.lock 文件所在位置。默认：与源文件同目录。 |
--assume-current | 首次对已翻译项目运行 --only-new：信任已有翻译，而不是重新翻译全部内容。 |
--tm PATH | 翻译记忆文件，默认与源文件同目录为 kaeris-tm.json。它通过文本重用翻译，因此重命名的键或新克隆的项目不会重复计费。--no-tm 可关闭此功能。 |
--receipt run.json | 写入运行记录：模型、套餐、交付的语言、计费和重用的字符数。仅含计数，不含字符串。 |
支持的文件：.json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx。未知的语言代码在发送任何内容之前就会被拒绝：kaeris languages 列出有效代码。translate 的退出码：0 完成，1 错误，3 部分语言返回时未翻译。完整列表：kaeris translate --help。
按格式的指南: JSON · YAML · PO · XLIFF · ARB · .strings · .xcstrings · Fluent · .properties · .resx · CSV · Markdown · Android XML
CI recipes (in English): GitHub Actions · GitLab CI · pre-commit · Make and npm scripts
KAERIS 翻译了此页面，并通过回译检查了每一行。尚未经过母语人士审阅。 英文原文