# gt: General Translation CLI tool: Сохранение локальных правок
URL: https://generaltranslation.com/ru/docs/cli/save-local.mdx
---
title: Сохранение локальных правок
description: Как сохранить изменения в локальных файлах переводов
---

## Использование

```bash
npx gt save-local
```

<Callout type="info">
  Для этой команды требуется API-ключ. Получить его можно на
  [платформе](https://generaltranslation.com/dashboard).
</Callout>


## Обзор

Команда `gt save-local` сохраняет все локальные правки, которые вы внесли в файлы переводов, обратно на платформу General Translation. Для этого она:

1. Считывает указанные в `gt.config.json` файлы
2. Определяет информацию о текущей ветке git
3. Сравнивает ваши локальные файлы переводов с последними загруженными версиями с сервера
4. Вычисляет диффы для всех внесённых вами изменений
5. Отправляет эти диффы на платформу General Translation

Эта команда **не ставит в очередь новые переводы**. Она только синхронизирует ваши локальные правки с платформой.

<Callout type="info">
  Это полезно, если вы или ваша команда вручную редактировали файлы переводов
  локально и хотите, чтобы эти изменения отразились на платформе. Например, если
  переводчик внёс исправления непосредственно в JSON-файлы.
</Callout>

## Как это работает

CLI отслеживает, какие переводы были загружены, в lock-файле. Когда вы запускаете `save-local`, команда:

1. Определяет файлы, изменившиеся с момента последней загрузки, сравнивая хэши содержимого
2. Получает для этих файлов исходное содержимое с сервера
3. Создаёт унифицированные diff’ы между версией на сервере и вашей локальной версией
4. Отправляет diff’ы на платформу

Обрабатываются только те файлы, которые действительно изменились.

***

## Флаги

| Параметр       | Описание                          | Тип      | Необязательный | По умолчанию       |
| -------------- | --------------------------------- | -------- | -------------- | ------------------ |
| `--api-key`    | API-ключ для General Translation  | `string` | `true`         |                    |
| `--project-id` | ID проекта General Translation    | `string` | `true`         |                    |
| `-c, --config` | Путь к конфигурационному файлу GT | `string` | `true`         | `"gt.config.json"` |
| `--publish`    | Опубликовать переводы в CDN       | `flag`   | `true`         | `false`            |

Все эти параметры необязательны, если они заданы через переменные окружения или в вашем `gt.config.json`.

<Callout type="warn">
  Не добавляйте API-ключ в файл `gt.config.json`! Вместо этого задайте его через
  переменную окружения. CLI автоматически считает `GT_API_KEY`, если эта
  переменная установлена.
</Callout>

## Связанные команды

* [`gt translate`](/docs/cli/translate) - Переведите проект и скачайте переводы
* [`gt translate --save-local`](/docs/cli/translate) - Сохраните локальные правки перед переводом (объединяет обе операции)