Контрольные точки

Qwen Code включает функцию контрольных точек, которая автоматически сохраняет снимок состояния вашего проекта перед любыми изменениями файлов, вносимыми инструментами на базе ИИ. Это позволяет безопасно экспериментировать и применять изменения кода, зная, что вы всегда можете мгновенно вернуться к состоянию до запуска инструмента.

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

Когда вы подтверждаете выполнение инструмента, изменяющего файловую систему (например, write_file или edit), CLI автоматически создает «контрольную точку». Эта контрольная точка включает:

Git-снимок: В специальном теневом Git-репозитории, расположенном в вашем домашнем каталоге (~/.qwen/history/<project_hash>), создается коммит. Этот снимок фиксирует полное состояние файлов вашего проекта на данный момент. Он не влияет на основной Git-репозиторий вашего проекта.
История диалога: Сохраняется весь диалог с агентом, который велся до этого момента.
Вызов инструмента: Также сохраняется конкретный вызов инструмента, который должен был быть выполнен.

Если вы хотите отменить изменения или просто вернуться назад, используйте команду /restore. Восстановление контрольной точки выполнит следующие действия:

Откатит все файлы в проекте до состояния, зафиксированного в снимке.
Восстановит историю диалога в CLI.
Повторно предложит исходный вызов инструмента, что позволит вам выполнить его снова, изменить или просто проигнорировать.

Все данные контрольных точек, включая Git-снимок и историю диалога, хранятся локально на вашем компьютере. Git-снимок сохраняется в теневом репозитории, а история диалога и вызовы инструментов записываются в JSON-файл во временном каталоге проекта, который обычно находится по пути ~/.qwen/tmp/<project_hash>/checkpoints.

Включение функции

Функция контрольных точек отключена по умолчанию. Чтобы включить её, используйте флаг командной строки или отредактируйте файл settings.json.

Использование флага командной строки

Вы можете включить создание контрольных точек для текущей сессии, добавив флаг --checkpointing при запуске Qwen Code:


qwen --checkpointing

Использование файла `settings.json`

Чтобы включить создание контрольных точек по умолчанию для всех сессий, отредактируйте файл settings.json.

Добавьте следующий ключ в ваш settings.json:


{
  "general": {
    "checkpointing": {
      "enabled": true
    }
  }
}

Использование команды `/restore`

После включения контрольные точки создаются автоматически. Для управления ими используйте команду /restore.

Просмотр доступных контрольных точек

Чтобы увидеть список всех сохраненных контрольных точек для текущего проекта, просто выполните:


/restore

CLI отобразит список доступных файлов контрольных точек. Имена этих файлов обычно состоят из временной метки, имени изменяемого файла и имени инструмента, который должен был быть запущен (например, 2025-06-22T10-00-00_000Z-my-file.txt-write_file).

Восстановление конкретной контрольной точки

Чтобы восстановить проект до конкретной контрольной точки, укажите соответствующий файл из списка:


/restore <checkpoint_file>

Например:


/restore 2025-06-22T10-00-00_000Z-my-file.txt-write_file

После выполнения команды ваши файлы и диалог будут мгновенно восстановлены до состояния на момент создания контрольной точки, а исходный запрос к инструменту появится снова.