Сохранение контрольных точек

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.

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

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


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 <имя_файла_контрольной_точки>

Например:


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

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