@intlayer/docs 5.5.11 → 5.6.0

package/docs/ru/intlayer_cli.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2025-07-11
 title: CLI
-description: Узнайте, как использовать Intlayer CLI для управления вашим многоязычным сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить проект за несколько минут.
+description: Узнайте, как использовать Intlayer CLI для управления вашим многоязычным сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить ваш проект за несколько минут.
 keywords:
   - CLI
-  - Командная строка
+  - Интерфейс командной строки
   - Интернационализация
   - Документация
   - Intlayer
@@ -59,49 +59,7 @@ Intlayer поддерживает несколько форматов конфи
 
 Чтобы узнать, как настроить доступные локали или другие параметры, обратитесь к [документации по конфигурации здесь](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
-## CLI SDK
-
-CLI SDK — это библиотека, которая позволяет использовать Intlayer CLI в вашем собственном коде.
-
-```bash packageManager="npm"
-npm install @intlayer/cli -D
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/cli -D
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/cli -D
-```
-
-Пример использования:
-
-```ts
-import {
-  push,
-  pull,
-  fill,
-  build,
-  docTranslate,
-  docReview,
-} from "@intlayer/cli";
-
-push();
-// ...
-pull();
-// ...
-fill();
-// ...
-build();
-// ...
-docTranslate();
-// ...
-docReview();
-// ...
-```
-
-## Выполнение команд intlayer
+## Запуск команд intlayer
 
 ### Сборка словарей
 
@@ -117,7 +75,7 @@ npx intlayer build
 npx intlayer build --watch
 ```
 
-Эта команда по умолчанию найдет ваши файлы с декларациями контента по пути `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` и соберет словари в директории `.intlayer`.
+Эта команда по умолчанию найдет ваши файлы объявлений контента, соответствующие шаблону `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`, и соберет словари в директории `.intlayer`.
 
 ##### Псевдонимы:
 
@@ -131,7 +89,7 @@ npx intlayer build --watch
 npx intlayer dictionary push
 ```
 
-Если установлен [редактор intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), вы также можете отправлять словари в редактор. Эта команда позволит сделать словари доступными в [редакторе](https://intlayer.org/dashboard). Таким образом, вы можете делиться своими словарями с командой и редактировать контент без изменения кода вашего приложения.
+Если установлен [редактор intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md), вы также можете отправлять словари в редактор. Эта команда позволит сделать словари доступными в [редакторе](https://intlayer.org/dashboard). Таким образом, вы можете делиться своими словарями с командой и редактировать содержимое без изменения кода вашего приложения.
 
 ##### Псевдонимы:
 
@@ -141,24 +99,59 @@ npx intlayer dictionary push
 
 ##### Аргументы:
 
-- `-d`, `--dictionaries`: идентификаторы словарей для отправки. Если не указано, будут отправлены все словари.
+**Опции словаря:**
+
+- **`-d`, `--dictionaries`**: идентификаторы словарей для отправки. Если не указано, будут отправлены все словари.
+
   > Пример: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
-- `-r`, `--deleteLocaleDictionary`: Пропустить вопрос об удалении каталогов локалей после отправки словарей и удалить их. По умолчанию, если словарь определён локально, он перезапишет содержимое удалённых словарей.
+
+**Опции конфигурации:**
+
+- **`--base-dir`**: Укажите базовый каталог проекта. Для получения конфигурации intlayer команда будет искать файл `intlayer.config.{ts,js,json,cjs,mjs}` в базовом каталоге.
+
+  > Пример: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Опции переменных окружения:**
+
+- **`--env`**: Укажите окружение (например, `development`, `production`). Полезно, если вы используете переменные окружения в вашем конфигурационном файле intlayer.
+- **`--env-file`**: Укажите пользовательский файл окружения для загрузки переменных. Полезно, если вы используете переменные окружения в вашем конфигурационном файле intlayer.
+
+  > Пример: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Пример: `npx intlayer dictionary push --env production`
+
+**Опции вывода:**
+
+- **`-r`, `--delete-locale-dictionary`**: Пропустить вопрос о удалении каталогов локалей после загрузки словарей и удалить их. По умолчанию, если словарь определён локально, он перезапишет содержимое удалённых словарей.
+
   > Пример: `npx intlayer dictionary push -r`
-- `-k`, `--keepLocaleDictionary`: Пропустить вопрос об удалении каталогов локалей после отправки словарей и сохранить их. По умолчанию, если словарь определён локально, он перезапишет содержимое удалённых словарей.
+
+  > Пример: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: Пропустить вопрос о удалении каталогов локалей после загрузки словарей и сохранить их. По умолчанию, если словарь определён локально, он перезапишет содержимое удалённых словарей.
+
   > Пример: `npx intlayer dictionary push -k`
-- `--env`: Указать окружение (например, `development`, `production`).
-- `--env-file`: Указать пользовательский файл окружения для загрузки переменных.
-- `--base-dir`: Указать базовый каталог проекта.
-- `--verbose`: Включить подробное логирование для отладки.
-- `--git-diff`: Запускать только для словарей, которые содержат изменения от базы (по умолчанию `origin/main`) до текущей ветки (по умолчанию: `HEAD`).
-- `--git-diff-base`: Указать базовую ссылку для git diff (по умолчанию `origin/main`).
-- `--git-diff-current`: Указать текущую ссылку для git diff (по умолчанию `HEAD`).
-- `--uncommitted`: Включить незафиксированные изменения.
-- `--unpushed`: Включить неотправленные изменения.
-- `--untracked`: Включить неотслеживаемые файлы.
-
-### Получение удалённых словарей
+
+  > Пример: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Опции логирования:**
+
+- **`--verbose`**: Включить подробное логирование для отладки.
+
+**Опции Git:**
+
+- **`--git-diff`**: Запускать только для словарей, которые содержат изменения от базовой ветки (по умолчанию `origin/main`) до текущей ветки (по умолчанию: `HEAD`).
+- **`--git-diff-base`**: Указать базовую ссылку для git diff (по умолчанию `origin/main`).
+- **`--git-diff-current`**: Указать текущую ссылку для git diff (по умолчанию `HEAD`).
+- **`--uncommitted`**: Включить незафиксированные изменения.
+- **`--unpushed`**: Включить неотправленные изменения.
+- **`--untracked`**: Включить неотслеживаемые файлы.
+
+  > Пример: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Пример: `npx intlayer dictionary push --uncommitted --unpushed --untracked`
+
+### Загрузка удалённых словарей
 
 ```bash
 npx intlayer pull
@@ -174,13 +167,35 @@ npx intlayer pull
 
 ##### Аргументы:
 
-- `-d, --dictionaries`: Идентификаторы словарей для загрузки. Если не указано, будут загружены все словари.
+**Опции словаря:**
+
+- **`-d, --dictionaries`**: Идентификаторы словарей для загрузки. Если не указано, будут загружены все словари.
+
   > Пример: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
-- `--newDictionariesPath` : Путь к директории, в которую будут сохранены новые словари. Если не указано, новые словари будут сохранены в директории `./intlayer-dictionaries` проекта. Если в содержимом вашего словаря указано поле `filePath`, словари не будут учитывать этот аргумент и будут сохранены в указанной директории `filePath`.
-- `--env`: Указать окружение (например, `development`, `production`).
-- `--env-file`: Указать пользовательский файл окружения для загрузки переменных.
-- `--base-dir`: Указать базовую директорию проекта.
-- `--verbose`: Включить подробное логирование для отладки.
+
+**Опции конфигурации:**
+
+- **`--base-dir`**: Укажите базовый каталог для проекта. Для получения конфигурации intlayer команда будет искать файл `intlayer.config.{ts,js,json,cjs,mjs}` в базовом каталоге.
+
+  > Пример: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Опции переменных окружения:**
+
+- **`--env`**: Укажите окружение (например, `development`, `production`).
+- **`--env-file`**: Укажите пользовательский файл окружения для загрузки переменных.
+- **`--base-dir`**: Укажите базовый каталог для проекта. Для получения конфигурации intlayer команда будет искать файл `intlayer.config.{ts,js,json,cjs,mjs}` в базовом каталоге.
+
+  > Пример: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Пример: `npx intlayer dictionary push --env production`
+
+**Опции вывода:**
+
+- **`--new-dictionaries-path`**: Путь к каталогу, в который будут сохранены новые словари. Если не указано, новые словари будут сохранены в каталоге `./intlayer-dictionaries` проекта. Если в содержимом вашего словаря указано поле `filePath`, словари не будут учитывать этот аргумент и будут сохранены в указанном каталоге `filePath`.
+
+**Опции логирования:**
+
+- **`--verbose`**: Включить подробное логирование для отладки.
 
 ##### Пример:
 
@@ -188,7 +203,7 @@ npx intlayer pull
 npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
 ```
 
-### Заполнить / проверить / перевести словари
+### Заполнение / аудит / перевод словарей
 
 ```bash
 npx intlayer fill
@@ -204,77 +219,74 @@ npx intlayer fill
 
 ##### Аргументы:
 
-- `-f, --file [files...]`
-  Список конкретных файлов декларации контента для проверки. Если не указано, будут проверены все обнаруженные файлы с расширениями `*.content.{ts,js,mjs,cjs,tsx,jsx,json}`.
+**Опции списка файлов:**
+
+- **`-f, --file [files...]`**: Список конкретных файлов декларации контента для аудита. Если не указано, будут проверены все обнаруженные файлы с расширениями `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` на основе вашей конфигурации.
+
+  > Пример: `npx intlayer dictionary fill -f src/home/app.content.ts`
 
-- `--exclude [excludedGlobs...]`
-  Шаблоны glob для исключения из проверки (например, `--exclude "src/test/**"`).
+- **`-k, --keys [keys...]`**: Фильтрация словарей по ключам. Если не указано, будут проверены все словари.
 
-- `--source-locale [sourceLocale]`
-  Исходная локаль для перевода. Если не указано, будет использована локаль по умолчанию из вашей конфигурации.
+  > Пример: `npx intlayer dictionary fill -k key1 key2`
 
-- `--output-locales [outputLocales...]`
-  Целевые локали для перевода. Если не указано, будут использованы все локали из вашей конфигурации, кроме исходной локали.
+- **`--excluded-keys [excludedKeys...]`**: Исключение словарей по ключам. Если не указано, будут проверены все словари.
 
-- `--mode [mode]`
-  Режим перевода: 'complete' (полный), 'review' (проверка) или 'missing-only' (только отсутствующие). По умолчанию — 'missing-only'.
+  > Пример: `npx intlayer dictionary fill --excluded-keys key1 key2`
 
-- `--git-diff`
-  Фильтрует словари, которые содержат изменения от базы (по умолчанию `origin/main`) до текущей ветки (по умолчанию: `HEAD`).
+- **`--path-filter [pathFilters...]`**: Фильтрация словарей по шаблону glob для путей к файлам.
 
-- `--git-diff-base`
-  Указывает базовую ссылку для git diff (по умолчанию `origin/main`).
+  > Пример: `npx intlayer dictionary fill --path-filter "src/home/**"`
 
-- `--git-diff-current`
-  Указывает текущую ссылку для git diff (по умолчанию `HEAD`).
+**Опции вывода записей:**
 
-- `--uncommitted`
-  Фильтрует словари, которые содержат неподтверждённые изменения.
+- **`--source-locale [sourceLocale]`**: Исходная локаль для перевода. Если не указано, будет использована локаль по умолчанию из вашей конфигурации.
 
-- `--unpushed`
+- **`--output-locales [outputLocales...]`**: Целевые локали для перевода. Если не указано, будут использованы все локали из вашей конфигурации, кроме исходной локали.
 
-Фильтрует словари, которые содержат непушенные изменения.
+- **`--mode [mode]`**: Режим перевода: 'complete' (полный), 'review' (проверка) или 'missing-only' (только отсутствующие). По умолчанию — 'missing-only'.
 
-- `--untracked`
-  Фильтрует словари, которые содержат неотслеживаемые файлы.
+**Опции Git:**
 
-- `--keys [keys...]`
-  Фильтрует словари на основе указанных ключей.
+- **`--git-diff`**: Запускать только для словарей, которые содержат изменения от базы (по умолчанию `origin/main`) до текущей ветки (по умолчанию: `HEAD`).
+- **`--git-diff-base`**: Указать базовую ссылку для git diff (по умолчанию `origin/main`).
+- **`--git-diff-current`**: Указать текущую ссылку для git diff (по умолчанию `HEAD`).
+- **`--uncommitted`**: Включать неподтверждённые изменения.
+- **`--unpushed`**: Включать непушенные изменения.
+- **`--untracked`**: Включать неотслеживаемые файлы.
 
-- `--excluded-keys [excludedKeys...]`
-  Исключает словари на основе указанных ключей.
+  > Пример: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
 
-- `--path-filter [pathFilters...]`
-  Фильтрует словари на основе глобального шаблона для путей файлов.
+  > Пример: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
-- `--model [model]`
-  Модель ИИ, используемая для перевода (например, `gpt-3.5-turbo`).
+**Опции ИИ:**
 
-- `--provider [provider]`
-  Провайдер ИИ, используемый для перевода.
+- **`--model [model]`**: Модель ИИ для использования при переводе (например, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Провайдер ИИ для использования при переводе.
+- **`--temperature [temperature]`**: Параметр температуры для модели ИИ.
+- **`--api-key [apiKey]`**: Укажите собственный API-ключ для сервиса ИИ.
+- **`--custom-prompt [prompt]`**: Укажите пользовательский запрос для инструкций по переводу.
+- **`--application-context [applicationContext]`**: Предоставьте дополнительный контекст для перевода ИИ.
+
+  > Пример: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Моё приложение — магазин для кошек"`
 
-- `--temperature [temperature]`
-  Настройка температуры для модели ИИ.
+**Опции переменных окружения:**
 
-- `--api-key [apiKey]`
-  Предоставьте собственный API-ключ для сервиса ИИ.
+- **`--env`**: Указать окружение (например, `development`, `production`).
+- **`--env-file [envFile]`**: Указать пользовательский файл окружения для загрузки переменных.
 
-- `--custom-prompt [prompt]`
-  Предоставьте пользовательский запрос для инструкций по переводу.
-- `--application-context [applicationContext]`
-  Предоставляет дополнительный контекст для перевода ИИ.
+  > Пример: `npx intlayer fill --env-file .env.production.local`
 
-- `--env`
-  Указывает окружение (например, `development`, `production`).
+  > Пример: `npx intlayer fill --env production`
 
-- `--env-file [envFile]`
-  Указывает пользовательский файл окружения для загрузки переменных.
+**Опции конфигурации:**
 
-- `--base-dir`
-  Указывает базовую директорию проекта.
+- **`--base-dir`**: Указать базовую директорию проекта.
 
-- `--verbose`
-  Включает подробное логирование для отладки.
+  > Пример: `npx intlayer fill --base-dir ./src`
+
+**Опции логирования:**
+
+- **`--verbose`**: Включить подробное логирование для отладки.
 
 ##### Пример:
 
@@ -282,13 +294,13 @@ npx intlayer fill
 npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
 ```
 
-Эта команда переведет содержимое с английского на французский и испанский для всех файлов деклараций контента в директории `src/home/` с использованием модели GPT-3.5 Turbo.
+Эта команда переведёт содержимое с английского на французский и испанский для всех файлов декларации контента в директории `src/home/`, используя модель GPT-3.5 Turbo.
 
 ### Управление конфигурацией
 
 #### Получить конфигурацию
 
-Команда `configuration get` получает текущую конфигурацию для Intlayer, в частности настройки локалей. Это полезно для проверки вашей настройки.
+Команда `configuration get` извлекает текущую конфигурацию Intlayer, в частности настройки локалей. Это полезно для проверки вашей настройки.
 
 ```bash
 npx intlayer configuration get
@@ -301,17 +313,16 @@ npx intlayer configuration get
 
 ##### Аргументы:
 
-- **`--env`**: Укажите окружение (например, `development`, `production`).
-- **`--env-file`**: Укажите пользовательский файл окружения для загрузки переменных.
-- **`--base-dir`**: Укажите базовую директорию проекта.
-- **`--verbose`**: Включите подробное логирование для отладки.
+- **`--env`**: Указать окружение (например, `development`, `production`).
+- **`--env-file`**: Указать пользовательский файл окружения для загрузки переменных.
+- **`--base-dir`**: Указать базовый каталог проекта.
+- **`--verbose`**: Включить подробное логирование для отладки.
 
 #### Отправка конфигурации
 
-Команда `configuration push` загружает вашу конфигурацию в Intlayer CMS и редактор. Этот шаг необходим для использования удалённых словарей в Intlayer Visual Editor.
+Команда `configuration push` загружает вашу конфигурацию в Intlayer CMS и редактор. Этот шаг необходим для использования удалённых словарей в визуальном редакторе Intlayer.
 
 ```bash
-bash
 npx intlayer configuration push
 ```
 
@@ -322,12 +333,12 @@ npx intlayer configuration push
 
 ##### Аргументы:
 
-- **`--env`**: Укажите окружение (например, `development`, `production`).
-- **`--env-file`**: Укажите пользовательский файл окружения для загрузки переменных.
-- **`--base-dir`**: Укажите базовую директорию проекта.
-- **`--verbose`**: Включите подробное логирование для отладки.
+- **`--env`**: Указать окружение (например, `development`, `production`).
+- **`--env-file`**: Указать пользовательский файл окружения для загрузки переменных.
+- **`--base-dir`**: Указать базовый каталог проекта.
+- **`--verbose`**: Включить подробное логирование для отладки.
 
-При отправке конфигурации ваш проект полностью интегрируется с Intlayer CMS, что обеспечивает бесшовное управление словарями в командах.
+Отправляя конфигурацию, ваш проект полностью интегрируется с Intlayer CMS, что обеспечивает бесшовное управление словарями в командах.
 
 ### Управление документацией
 
@@ -335,7 +346,7 @@ npx intlayer configuration push
 
 #### Перевод документации
 
-Команда `doc translate` автоматически переводит файлы документации с базового языка на целевые языки с использованием сервисов AI-перевода.
+Команда `doc translate` автоматически переводит файлы документации с базовой локали на целевые локали с использованием сервисов AI-перевода.
 
 ```bash
 npx intlayer doc translate
@@ -343,69 +354,130 @@ npx intlayer doc translate
 
 ##### Аргументы:
 
+**Опции списка файлов:**
+
 - **`--doc-pattern [docPattern...]`**: Глобальные шаблоны для выбора файлов документации для перевода.
+
   > Пример: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
 - **`--excluded-glob-pattern [excludedGlobPattern...]`**: Глобальные шаблоны для исключения файлов из перевода.
+
   > Пример: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
-- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Количество файлов, обрабатываемых одновременно для перевода.
-  > Пример: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
-- **`--locales [locales...]`**: Целевые языки для перевода документации.
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Пропустить файл, если он был изменён до указанного времени.
+
+  - Может быть абсолютным временем, например "2025-12-05" (строка или объект Date)
+  - Может быть относительным временем в миллисекундах `1 * 60 * 60 * 1000` (1 час)
+  - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
+
+  > Пример: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Пропустить файл, если он был изменён в течение указанного времени.
+
+  - Может быть абсолютным временем, например "2025-12-05" (строка или объект Date)
+  - Может быть относительным временем в миллисекундах `1 * 60 * 60 * 1000` (1 час)
+  - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
+
+  > Пример: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+**Опции вывода:**
+
+- **`--locales [locales...]`**: Целевые локали для перевода документации.
+
   > Пример: `npx intlayer doc translate --locales fr es de`
-- **`--base-locale [baseLocale]`**: Исходный язык для перевода.
+
+- **`--base-locale [baseLocale]`**: Исходная локаль для перевода.
+
   > Пример: `npx intlayer doc translate --base-locale en`
+
+**Опции обработки файлов:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Количество файлов, обрабатываемых одновременно для перевода.
+
+  > Пример: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**Опции ИИ:**
+
 - **`--model [model]`**: Модель ИИ, используемая для перевода (например, `gpt-3.5-turbo`).
 - **`--provider [provider]`**: Провайдер ИИ, используемый для перевода.
 - **`--temperature [temperature]`**: Параметр температуры для модели ИИ.
-- **`--api-key [apiKey]`**: Предоставьте свой собственный API-ключ для сервиса ИИ.
-- **`--custom-prompt [prompt]`**: Предоставьте пользовательский запрос для инструкций по переводу.
+- **`--api-key [apiKey]`**: Предоставьте собственный API-ключ для сервиса ИИ.
 - **`--application-context [applicationContext]`**: Предоставьте дополнительный контекст для перевода ИИ.
-- **`--env`**: Укажите окружение (например, `development`, `production`).
-- **`--env-file [envFile]`**: Укажите пользовательский файл окружения для загрузки переменных.
-- **`--base-dir`**: Укажите базовый каталог проекта.
-- **`--verbose`**: Включите подробное логирование для отладки.
-- **`--custom-instructions [customInstructions]`**: Пользовательские инструкции, добавляемые в подсказку. Полезно для применения специфических правил форматирования, перевода URL и т.д.
+- **`--custom-prompt [prompt]`**: Настроить базовый запрос, используемый для перевода. (Примечание: для большинства случаев рекомендуется использовать опцию `--custom-instructions`, так как она обеспечивает лучший контроль над поведением перевода.)
 
-##### Пример:
+  > Пример: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Моё приложение — магазин для кошек"`
 
-```bash
-npx intlayer doc translate
-  --doc-pattern "docs/ru/**/*.md"
-  --base-locale en --locales fr es
-  --model chatgpt-4o-latest
-  --custom-instructions "$(cat ./instructions.md)"
-```
+**Опции переменных окружения:**
+
+- **`--env`**: Указать окружение (например, `development`, `production`).
+- **`--env-file [envFile]`**: Указать пользовательский файл окружения для загрузки переменных.
+- **`--base-dir`**: Указать базовую директорию проекта.
+
+  > Пример: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Опции логирования:**
+
+- **`--verbose`**: Включить подробное логирование для отладки.
+
+  > Пример: `npx intlayer doc translate --verbose`
+
+**Опции пользовательских инструкций:**
+
+- **`--custom-instructions [customInstructions]`**: Пользовательские инструкции, добавляемые в запрос. Полезно для применения специфических правил по форматированию, переводу URL и т.д.
 
-> Обратите внимание, что путь к выходному файлу будет определяться заменой следующих шаблонов
+  - Может быть абсолютное время, например "2025-12-05" (строка или объект Date)
+  - Может быть относительное время в миллисекундах `1 * 60 * 60 * 1000` (1 час)
+  - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
+
+  > Пример: `npx intlayer doc translate --custom-instructions "Избегайте перевода URL и сохраняйте формат markdown"`
+
+  > Пример: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Опции Git:**
+
+- **`--git-diff`**: Запускать только для словарей, которые содержат изменения от базы (по умолчанию `origin/main`) до текущей ветки (по умолчанию: `HEAD`).
+- **`--git-diff-base`**: Указать базовую ссылку для git diff (по умолчанию `origin/main`).
+- **`--git-diff-current`**: Указать текущую ссылку для git diff (по умолчанию `HEAD`).
+- **`--uncommitted`**: Включать незафиксированные изменения.
+- **`--unpushed`**: Включать неотправленные изменения.
+- **`--untracked`**: Включать неотслеживаемые файлы.
+
+  > Пример: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Пример: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Обратите внимание, что путь выходного файла будет определяться заменой следующих шаблонов
 >
-> - `/{{baseLocale}}/` на `/{{locale}}/` (Unix)
-> - `\{{baseLocale}}\` на `\{{locale}}\` (Windows)
-> - `_{{baseLocale}}.` на `_{{locale}}.`
-> - `{{baseLocale}}_` на `{{locale}}_`
-> - `.{{baseLocaleName}}.` на `.{{localeName}}.`
+> - `/{{baseLocale}}/` заменяется на `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` заменяется на `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` заменяется на `_{{locale}}.`
+> - `{{baseLocale}}_` заменяется на `{{locale}}_`
+> - `.{{baseLocaleName}}.` заменяется на `.{{localeName}}.`
 >
-> Если шаблон не найден, в имени выходного файла будет добавлено `.{{locale}}` перед расширением. Например, `./my/file.md` будет переведён в `./my/file.ru.md` для русского языка.
+> Если шаблон не найден, к расширению файла будет добавлено `.{{locale}}`. Например, `./my/file.md` будет переведён в `./my/file.fr.md` для французской локали.
 
 #### Проверка документации
 
-Команда `doc review` анализирует файлы документации на качество, согласованность и полноту для разных локалей.
+Команда `doc review` анализирует файлы документации на качество, согласованность и полноту между разными локалями.
 
 ```bash
 npx intlayer doc review
 ```
 
-##### Аргументы:
+Её можно использовать для проверки уже переведённых файлов и для проверки корректности перевода.
 
-Команда `doc review` принимает те же аргументы, что и `doc translate`, позволяя проверять конкретные файлы документации и применять проверки качества.
+В большинстве случаев,
 
-##### Пример:
+- предпочтительно использовать `doc translate`, когда переведённая версия этого файла недоступна.
+- предпочтительно использовать `doc review`, когда переведённая версия этого файла уже существует.
 
-```bash
-npx intlayer doc review
- --doc-pattern "docs/ru/**/*.md"
- --locales fr es de
- --model chatgpt-4o-latest
- --custom-instructions "$(cat ./instructions.md)"
-```
+> Обратите внимание, что процесс проверки (review) потребляет больше входных токенов, чем процесс перевода (translate) для полной проверки одного и того же файла. Однако процесс проверки оптимизирует проверяемые части (чанки) и пропускает неизменённые участки.
+
+##### Аргументы:
+
+Команда `doc review` принимает те же аргументы, что и `doc translate`, позволяя вам проверять конкретные файлы документации и применять проверки качества.
+
+Если вы активировали одну из опций git, команда будет проверять только ту часть файлов, которая изменяется. Скрипт будет обрабатывать файл по частям (чанкам) и проверять каждый чанк. Если в чанке нет изменений, скрипт пропустит его, чтобы ускорить процесс проверки и снизить стоимость использования API AI-провайдера.
 
 ## Использование команд intlayer в вашем `package.json`
 
@@ -421,6 +493,48 @@ npx intlayer doc review
 }
 ```
 
+## CLI SDK
+
+CLI SDK — это библиотека, которая позволяет использовать Intlayer CLI в вашем собственном коде.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+Пример использования:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  docTranslate,
+  docReview,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+```
+
 ## Отладка команды intlayer
 
 ### 1. **Убедитесь, что используете последнюю версию**
@@ -453,4 +567,7 @@ npx clear-npx-cache
 
 ## История документации
 
-- 5.5.10 - 2025-06-29: Инициализация истории
+| Версия | Дата       | Изменения                                    |
+| ------ | ---------- | -------------------------------------------- |
+| 5.5.11 | 2025-07-11 | Обновлена документация параметров команд CLI |
+| 5.5.10 | 2025-06-29 | Инициализация истории                        |

package/docs/ru/intlayer_visual_editor.md

@@ -15,6 +15,7 @@ slugs:
   - doc
   - concept
   - editor
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Документация по Intlayer Visual Editor