Устранение неполадок

Эта ошибка означает, что i1n CLI не установлен глобально или отсутствует в вашем PATH. Выполните команду npm install -g i1n для его установки. Если вы используете менеджер версий (nvm, fnm), убедитесь, что каталог глобальных бинарных файлов находится в вашем PATH.

В macOS/Linux вы можете проверить путь установки с помощью команды which i1n. Если вы используете bun, вместо этого выполните команду bun install -g i1n.

Это происходит, когда ключ API в i1n.config.json отсутствует, истек срок действия или является недействительным. Создайте новый ключ в настройках вашей организации на dashboard.i1n.ai и выполните команду i1n init для повторной настройки.

Убедитесь, что вы используете правильный ключ API для организации, которой принадлежит проект. Каждая организация имеет свои собственные ключи — ключ одной организации не может получить доступ к проектам другой.

Если i1n push сообщает об отсутствии ключей или пропуске файлов, убедитесь, что ваш каталог locales и формат файла соответствуют конфигурации в i1n.config.json. При необходимости запустите i1n init для перенастройки.

Распространенные причины включают неправильные шаблоны glob, несовпадающие форматы файлов (например, плоский JSON при настроенном вложенном JSON) или пустые файлы перевода.

Это обычно означает, что в проекте нет переводов на сервере. Сначала выполните команду i1n push, чтобы загрузить ваши исходные ключи, а затем i1n pull, чтобы скачать переводы.

Если вы отправили ключи, но при получении возвращаются пустые файлы, убедитесь, что целевые языки были добавлены в ваш проект с помощью i1n add-language или через панель управления.

Если ваша IDE показывает ошибки после извлечения, убедитесь, что i1n.d.ts включен в вашу компиляцию TypeScript. CLI автоматически обновляет tsconfig.json, но ручные конфигурации могут потребовать корректировки.

Никогда не изменяйте i1n.d.ts напрямую — он перегенерируется при каждом вызове i1n pull. Если файл выглядит поврежденным, удалите его и снова выполните i1n pull.