> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/cherry-studio/installation/v1-to-v2-migration.md).

# Обновление с V1 до V2

{% hint style="danger" %}
Миграция односторонняя: данные V1 могут быть перенесены в V2, но новые данные V2 не будут синхронизироваться обратно в V1. Перед обновлением обязательно сохраните полную резервную копию V1 и весь каталог данных V1, скопированный после полного выхода из приложения.
{% endhint %}

{% hint style="warning" %}
Правильный путь для сохранения данных:**V1.9.13 → V2.0.2 (прямое завершение миграции данных)**. Больше не нужно сначала устанавливать V2.0.0.
{% endhint %}

## Выберите в зависимости от текущей ситуации

| Текущая ситуация                                       | Действие                                                                                                                                     |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| По-прежнему на V1, нужно сохранить данные              | Обновите V1 до 1.9.13 и по шагам на этой странице сразу установите V2.0.2.                                                                   |
| Уже используете V2                                     | Обычным образом обновите до V2.0.2 и продолжайте использовать текущие данные V2; не нажимайте \[Перемигрировать].                            |
| Ранее миграция V1 не удалась или данные были пропущены | Только после полной резервной копии текущей V2 можно использовать \[Перемигрировать] и начать заново с V1.                                   |
| Данные V1 не нужны                                     | Можно выбрать \[Игнорировать и использовать значения по умолчанию], чтобы начать с конфигурации по умолчанию; данные V1 не будут перенесены. |

## Проверка перед обновлением

* V1 не ниже 1.9.12; рекомендуется сначала обновиться до финальной версии 1.9.13 и хотя бы один раз запустить её.
* При первой миграции можно сразу использовать V2.0.2.
* Пользовательский каталог данных или внешний диск должны нормально читаться и записываться.
* Диалоги, Agent, импорт базы знаний и задачи обработки файлов должны быть завершены.

{% hint style="warning" %}
Мастер миграции читает текущий каталог данных V1, а не ZIP-архив резервной копии V1. Резервная копия нужна для аварийного восстановления и не может заменить исходный каталог данных при миграции.
{% endhint %}

## Шаги операции

{% stepper %}
{% step %}

### Обновите и сделайте резервную копию V1

Обновите V1 до 1.9.13. На странице резервного копирования данных отключите \[Упрощённое резервное копирование], создайте полную резервную копию и сохраните её вне каталога данных приложения.
{% endstep %}

{% step %}

### Скопируйте весь каталог данных V1

В настройках данных V1 подтвердите расположение каталога, полностью выйдите из Cherry Studio и затем скопируйте весь каталог. Не копируйте только файл базы данных.
{% endstep %}

{% step %}

### Проверьте пользовательский каталог

При использовании внешнего диска, сетевого тома или другого пользовательского расположения убедитесь, что путь смонтирован и доступен для чтения и записи. Если путь недоступен, не переключайтесь на каталог по умолчанию и не продолжайте миграцию.
{% endstep %}

{% step %}

### Первый запуск V2.0.2

из [Официальная загрузка V2](https://cherryai.com.cn/download) Получите установочный пакет V2.0.2, соответствующий системе и чипу; также можно использовать [страницу релизов GitCode](https://gitcode.com/CherryHQ/cherry-studio/releases/v2.0.2) или [страницу релизов GitHub](https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.2). Полностью выйдите из V1, затем установите и запустите.
{% endstep %}

{% step %}

### Завершите \[Мастер миграции данных]

Сверьте расположение данных, показанное мастером, затем выберите \[Начать миграцию]. Во время миграции не закрывайте приложение, не перемещайте каталог данных и не отключайте внешний диск.
{% endstep %}

{% step %}

### Проверьте результат и перезапустите

После завершения миграции сначала разверните предупреждающую информацию, затем выберите \[Перезапустить приложение].
{% endstep %}
{% endstepper %}

## Проверка после обновления

* Проверьте часто используемые сервисы моделей, API Key и модель по умолчанию.
* Проверьте группы помощников, промпты, права Agent и привязку базы знаний.
* Откройте часто используемые чаты, базы знаний и файлы; заново создавайте только те источники знаний, которые отображаются как неудачные.
* В \[Настройки] → \[Поиск в интернете] заново проверьте поиск по ключевым словам и сервисы чтения URL.
* Проверьте избранное в боковой панели и пользовательский CSS.
* В \[Настройки] → \[Данные] создайте новую полную резервную копию V2.

Подробнее об изменениях входных точек см. в [\[Различия в функциях\]](/docs/russian/cherry-studio/installation/v1-v2-feature-differences.md).

## Используйте \[Перемигрировать] только при сбое миграции

Если ранее миграция V1 не удалась или данные были пропущены, в V2.0.2 можно в \[Настройки] → \[Данные] выбрать \[Перемигрировать]. Это действие перезапустит приложение и заново выполнит миграцию из сохранённых данных V1.

{% hint style="danger" %}
\[Перемигрировать] навсегда удалит текущие данные V2 и не объединит данные V1 и V2. Ни в коем случае не нажимайте её, если только ранее миграция V1 не была неудачной или данные не были пропущены. Перед операцией обязательно создайте полную резервную копию текущей V2; новые данные V2, которые нужно сохранить, также следует экспортировать отдельно.
{% endhint %}

## При сбое миграции

| Параметр                                             | Когда использовать                                                   | Примечания                                                                                                                                                  |
| ---------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \[Повторить]                                         | После исправления проблем с каталогом, диском или временными данными | Предпочтительный выбор, не выходит из процесса миграции.                                                                                                    |
| \[Сохранить информацию о проблеме]                   | Повторная попытка всё ещё не удалась, нужна помощь                   | Файл сохраняется только локально, может содержать путь, содержимое или учетные данные; предоставляйте его только команде поддержки Cherry Studio.           |
| \[Игнорировать и использовать значения по умолчанию] | Явно отказаться от импорта данных V1                                 | Очистить часть данных V2, уже записанных в этот раз, и начать с конфигурации по умолчанию; после этого миграция больше не будет предлагаться автоматически. |
| \[Продолжить использовать V1]                        | Временно невозможно выполнить миграцию, нужно восстановить работу    | Переустановите V1 и продолжайте использовать исходный каталог данных V1.                                                                                    |

{% hint style="danger" %}
Если миграция не удалась или по ошибке выбрано \[Игнорировать и использовать значения по умолчанию], не удаляйте базу данных самостоятельно и не выполняйте повторную установку поверх. Сохраните исходные данные и резервные копии V1 и свяжитесь с командой поддержки Cherry Studio.
{% endhint %}

## Часто задаваемые вопросы

<details>

<summary>Можно ли выполнить миграцию только с ZIP-резервной копией V1?</summary>

Нет. Сначала восстановите данные в совместимой V1 и убедитесь, что всё в порядке, затем сохраните полный каталог данных и только после этого запускайте миграцию V2.

</details>

<details>

<summary>Нужно ли перестраивать индекс у всех баз знаний?</summary>

Нет. Действующие индексы будут перенесены; обрабатывать нужно только источники, которые отображаются как неудачные, не имеют модели эмбеддингов или не могут быть прочитаны.

</details>

## Справочные материалы

* [Официальная загрузка Cherry Studio V2](https://cherryai.com.cn/download)
* [Официальная загрузка Cherry Studio V1](https://cherryai.com.cn/download/v1)
* Страница релиза V2.0.2:[GitCode](https://gitcode.com/CherryHQ/cherry-studio/releases/v2.0.2) · [GitHub](https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.2)
* [Официальное описание дизайна миграции](https://github.com/CherryHQ/cherry-studio/blob/main/src/main/data/migration/v2/README.md#version-compatibility-gate)
* [Сообщить о проблеме и предложить функцию](/docs/russian/question-contact/suggestions.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/russian/cherry-studio/installation/v1-to-v2-migration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.