Знайти й заповнити відсутні ключі react-i18next
Німецький common.json, що відстав від англійського, не ламає збірку. i18next підставляє англійський текст або виводить ключ, і ніхто цього не помічає, доки не помітить користувач. Нижче одна команда знаходить пропуски, інша їх заповнює.
KAERIS переклав цю сторінку та перевірив кожен рядок зворотним перекладом. Носій мови ще не переглядав її. Оригінал англійською
Приклад проєкту
Невеликий проєкт на react-i18next: англійський вихідний файл і німецький, що відстав. Команди нижче запускалися саме на цих файлах.
{
"header": {
"greeting": "Hi, {{name}}!",
"signOut": "Sign out"
},
"cart": {
"items_one": "{{count}} item in your cart",
"items_other": "{{count}} items in your cart",
"checkout": "Go to checkout",
"terms": "By paying you accept the <1>terms</1>."
}
}
{
"header": {
"greeting": "Hallo, {{name}}!",
"signOut": "Abmelden"
},
"cart": {
"items_one": "{{count}} Artikel im Warenkorb",
"checkout": "Zur Kasse",
"terms": "Mit der Zahlung akzeptieren Sie die AGB."
}
}
1. Знайти, чого бракує
kaeris check порівнює кожен переклад із вихідним файлом. Він працює офлайн, без ключа й акаунта, і завершується з кодом 1, якщо знаходить проблему, тож завдання CI може на ньому зупинитися.
$ npx kaeris check --source public/locales/en/common.json --langs de
✗ de: 1 missing key(s): cart.items_other
✗ de: 2 translation fault(s):
cart.terms: lost inline tag </1>
cart.terms: lost inline tag <1>
✗ 1 missing key, 2 translation faults
2. Перекласти лише відсутні ключі
--only-new надсилає лише ключі, яких немає в німецькому файлі, і вписує їх туди. Рядки, що вже є у файлі, лишаються як були, зламані теж. Команда входить до пакета Python: pip install kaeris.
$ kaeris translate public/locales/en/common.json --langs de --only-new
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
→ de: 1 new key(s) to translate
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 1 strings · 4.4s
28 charged
✓ Translation QA: no placeholder loss, no overflow risks
✓ de: merged 1 key(s) → public/locales/de/common.json
→ 5 key(s) already exist in de but nothing in kaeris.lock vouches for them, so they were left alone AND left unlocked. If the source changed after those files were made, those edits are NOT translated. Re-run once with --no-only-new to rebuild them, or with --assume-current if the files are known to match.
{
"header": {
"greeting": "Hallo, {{name}}!",
"signOut": "Abmelden"
},
"cart": {
"items_one": "{{count}} Artikel im Warenkorb",
"checkout": "Zur Kasse",
"terms": "Mit der Zahlung akzeptieren Sie die AGB.",
"items_other": "{{count}} Artikel in Ihrem Warenkorb"
}
}
3. Перевірити ще раз
Відсутні ключі заповнено. Лишилося те, що було зламано до цього запуску: виправте ці рядки вручну або перекладіть увесь файл заново з --no-only-new.
$ npx kaeris check --source public/locales/en/common.json --langs de
✗ de: 2 translation fault(s):
cart.terms: lost inline tag </1>
cart.terms: lost inline tag <1>
✗ 2 translation faults
Запуск 2 листопада 2026 року на безкоштовному тарифі, без ключа: npx kaeris 0.2.42 для перевірки, kaeris 0.2.42 з PyPI для перекладу. Вивід як надруковано, крім рядків прогресу й локального шляху до теки.
Що kaeris check ловить у react-i18next
Відсутні ключі, разом із суфіксами плюралів
Ключ, який є у вихідному файлі й якого немає в перекладі, наприклад
cart.items_other, коли скопіювали лише_one.Загублений або перейменований
{{name}}Інтерполяції порівнюються рядок за рядком.
{{Name}}замість{{name}}рахується як одна загублена й одна вигадана.Теги
<Trans>Нумеровані теги на кшталт
<1>terms</1>мають повернутися, інакше посилання всередині фрази зникне.Поки не перевіряється
Ключі плюралів, потрібні мові, яких немає в англійській, наприклад польські
_fewі_many.
Скільки це коштує
kaeris checkбезкоштовнийПрацює на вашій машині: без ключа, без акаунта, без ліміту.
Переклад можна почати безкоштовно
Без ключа: 10 000 символів на файл, 300 000 на день, до 8 мов за запуск. Безкоштовний ключ підіймає ліміт до 50 000 символів на файл і 1,5 млн на місяць. Обсяг рахує символи по разу на кожну цільову мову.
Понад безкоштовний тариф
Lifetime коштує $79 один раз і працює на вашому ключі OpenRouter, тож модель оплачується окремо. Pro коштує $19 на місяць або $190 на рік, 12 млн символів на місяць. Ціни
Запитання
Чи знаходить він ключі, які є в коді, але відсутні у файлах?
Ні. kaeris check порівнює файли локалей між собою. Спершу запустіть екстрактор, наприклад i18next-cli, щоб в англійському файлі були всі ключі; далі працює перевірка.
Які структури тек підходять?
locales/en/common.json поряд із locales/de/common.json або en.json поряд із de.json. Перевірка шукає там, куди пише translate.
Чи може він працювати в CI?
Так. npx kaeris check завершується з кодом 1, якщо знаходить проблему. Рецепти: GitHub Actions, GitLab CI, pre-commit.
Продовжуйте
Довідка з check · Довідка з CLI · Безкоштовна перевірка в браузері · Переклад у браузері