> 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/v2-breaking-update-notice.md).

# Предупреждение о разрушительном обновлении

V2 — это не обычное обновление поверх существующей версии. Оно заменило структуру данных и также изменило точки входа и поведение функций, таких как помощник, Agent, база знаний, веб-поиск и файлы.

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

## V2.0.2 может напрямую перенести V1

Если нужно сохранить данные V1, выполните **V1.9.13 → V2.0.2 (прямое завершение миграции данных)** операцию, промежуточный переход через V2.0.0 больше не требуется.

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

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

## Перед обновлением обязательно выполните

1. Обновите V1 до 1.9.13 и запустите его как минимум один раз.
2. Отключите \[Упрощённое резервное копирование] и создайте полную резервную копию V1.
3. Полностью выйдите из Cherry Studio, затем скопируйте весь каталог данных V1.
4. При использовании пользовательского каталога или внешнего диска убедитесь, что путь смонтирован и доступен для чтения и записи.

Мастер миграции читает текущий каталог данных V1, а не ZIP-архив резервной копии. Резервная копия нужна для аварийного восстановления и не может заменять исходный каталог данных при миграции.

## \[Повторная миграция] — это не объединение данных

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

Перед выполнением операции потребуется подтвердить следующее:

* Текущие данные V2 будут навсегда удалены, и это нельзя отменить.
* Исходные данные V1 будут сохранены и после перезапуска будут повторно импортированы.
* Сначала необходимо создать полную резервную копию текущего V2.

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

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

## На что обратить особое внимание после обновления

* Служба моделей, API Key и модель по умолчанию; Anthropic OAuth не будет перенесён, нужно перейти на API Key.
* Группы помощников, порядок промптов, права инструментов Agent и привязки базы знаний.
* Источники сбоев базы знаний, а также службы поиска по ключевым словам и чтения URL в веб-поиске.
* Пользовательский CSS, избранное на боковой панели и отсутствующие файлы.

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

## Сбой миграции или необходимость отката

* В первую очередь используйте \[Повторить], а после исправления проблем с каталогом данных, диском или данными продолжите.
* \[Сохранить информацию о проблеме] сохранит данные только локально; файлы могут содержать пути, содержимое или учётные данные — предоставляйте их только команде поддержки Cherry Studio.
* \[Игнорировать и использовать значения по умолчанию] начнёт с конфигурации по умолчанию, данные V1 не будут перенесены.
* При обычном возврате к V1 не нужно удалять базу данных, и не следует восстанавливать резервную копию V2 в V1.

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

## Продолжить чтение

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Различия в функциональности</strong></td><td>Смотрите, какие данные будут перенесены автоматически, что нужно проверить вручную и что не будет унаследовано.</td><td><a href="/pages/ee4df790a64a4e0f3eeb6c174e4705e97c3f9836">/pages/ee4df790a64a4e0f3eeb6c174e4705e97c3f9836</a></td></tr><tr><td><strong>Обновление с V1 до V2</strong></td><td>Выполните резервное копирование, миграцию и проверку в правильной последовательности версий.</td><td><a href="/pages/3af0f47eb84103113dc79791f8b378429b94cf1d">/pages/3af0f47eb84103113dc79791f8b378429b94cf1d</a></td></tr><tr><td><strong>Понижение с V2 до V1</strong></td><td>Узнайте о мерах предосторожности при откате, резервном копировании и работе с базой данных.</td><td><a href="/pages/f4e740a52544b411ec7a15e880c282a5d9b96f04">/pages/f4e740a52544b411ec7a15e880c282a5d9b96f04</a></td></tr></tbody></table>

## Ссылка для загрузки

* [Официальная загрузка 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)
* [Официальная загрузка V2](https://cherryai.com.cn/download)


---

# 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/v2-breaking-update-notice.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.