> 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-v2-feature-differences.md).

# Различия в функциях

V2 изменила структуру данных и множество точек входа функций. Перед обновлением сначала посмотрите, какие элементы нужно перенастроить; подробные шаги см. в [【Обновление с V1 до V2】](/docs/russian/cherry-studio/installation/v1-to-v2-migration.md).

## Изменения миграции V2.0.2

| Ситуация              | Способ обработки в V2.0.2                                       | Примечания                                                                                                                    |
| --------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Первая миграция с V1  | Можно сразу установить V2.0.2 с V1.9.13                         | Больше не нужно сначала устанавливать V2.0.0.                                                                                 |
| Обычное обновление V2 | Обновиться напрямую и продолжить использовать текущие данные V2 | Не нажимайте【Повторная миграция】.                                                                                             |
| Повторная миграция V1 | В【Настройки】→【Данные】выберите【Повторная миграция】               | Текущие данные V2 будут безвозвратно удалены; это предназначено только для ранее неудавшейся миграции или пропущенных данных. |

{% hint style="danger" %}
【Повторная миграция】не добавит и не объединит данные V1 с текущими данными V2. Сначала она удалит текущие данные V2, а затем заново импортирует из сохранённых данных V1. Если это не неудавшаяся миграция V1 или не пропущенные данные, ни в коем случае не нажимайте.
{% endhint %}

## Как обрабатываются данные

| обработки при экспорте в Obsidian | Область данных                                                                                                                                                                                                                                | Что нужно сделать после обновления                         |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Автоматическая миграция           | Настройки, сервисы и модели, помощники и группы, сессии и сообщения, Agent и сессии, MCP, база знаний и действительные индексы, файлы, рисунки, перевод, заметки, подсказки, записи использования                                             | Проверочно открыть несколько часто используемых элементов. |
| Требует проверки                  | Учётные данные Anthropic, сервис поиска в интернете по умолчанию, права инструментов Agent и привязка к базе знаний, порядок подсказок, неудачные элементы базы знаний, пользовательский CSS, избранное в боковой панели, отсутствующие файлы | Повторно подтвердите по таблице ниже.                      |
| Не наследуется                    | История запланированных задач Agent, результаты раскрытия старой карты сайта, некоторые временные ссылки на изображения, текущее состояние открытой заметки, конфигурации удалённых функций                                                   | При необходимости создайте заново.                         |

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

## Основные различия

| Функция                              | V1                                                                                                                   | V2                                                                                                                                                                | Что нужно сделать после обновления                                                                                      |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Помощники и подсказки                | Отдельная библиотека помощников; быстрые фразы можно связывать с помощниками                                         | Помощники управляются в чате и Agent; быстрые фразы объединены в глобальные подсказки                                                                             | Проверьте группы помощников и порядок подсказок.                                                                        |
| Agent                                | Часть настроек и рабочее пространство следуют за сессией; старые разрешения могут автоматически одобрять инструменты | Идентичность, память и основные настройки относятся к Agent; после создания сессии рабочее пространство фиксируется; инструменты могут снова запросить разрешение | Проверьте модели, рабочее пространство, инструменты и права.                                                            |
| База знаний Agent                    | Инструмент знаний может обращаться к глобальной базе знаний                                                          | Доступ только к явно привязанной базе знаний                                                                                                                      | Для каждого Agent заново проверьте привязку к базе знаний.                                                              |
| Поиск по базе знаний                 | Можно вручную выбрать режим поиска и источник карты сайта                                                            | При отсутствии модели встраивания используется BM25, при наличии модели встраивания — гибридный поиск; карта сайта обрабатывается как обычный URL                 | Проверьте модели встраивания и переупорядочивания; перестройте неудачные источники.                                     |
| Поиск в интернете                    | Можно выбрать сервис в помощнике или в области ввода; включает локальный поиск, сжатие RAG и чёрный список подписок  | В【Настройки】→【Поиск в интернете】отдельно настройте поиск по ключевым словам и чтение URL; связанные старые опции удалены                                          | Заново выберите два сервиса по умолчанию и проверьте учётные данные.                                                    |
| MCP                                  | Добавленные сервисы и сторонняя площадка обнаружения сосуществуют                                                    | Добавленные сервисы продолжают мигрировать; старая сторонняя площадка обнаружения больше не предоставляется                                                       | Проверьте состояние сервисов; новые сервисы добавляйте из текущей площадки или JSON.                                    |
| Сервисы моделей                      | Anthropic может сохранять OAuth-учётные данные                                                                       | Anthropic OAuth не мигрирует; регион AWS Bedrock сохраняется; новые сервисы по умолчанию отключены                                                                | Снова введите API Key для Anthropic и при необходимости включите сервис.                                                |
| Файл                                 | Связь между копиями файлов и бизнес-объектами слабее                                                                 | Управляемые файлы ведутся по ссылке; после удаления последней ссылки удаление копии будет выполнено с задержкой                                                   | Файлы для долгосрочного хранения поместите в【Файлы】или экспортируйте; исходные пользовательские файлы не будут удалены. |
| Рисование, Mini App и боковая панель | Параметры и точки входа находятся в старой области                                                                   | Параметры рисования перенесены на панель инструментов подсказок; Mini App находятся на верхней панели вкладок; избранное боковой панели сброшено                  | Ознакомьтесь с новыми точками входа и заново настройте избранное.                                                       |
| Пользовательскому CSS                | Селектор V1 действует напрямую                                                                                       | Содержимое сохраняется, но после миграции по умолчанию отключено                                                                                                  | Сначала адаптируйте под селектор V2, затем включите.                                                                    |
| Code CLI                             | Можно выбрать iFlow                                                                                                  | iFlow заменён на Qoder                                                                                                                                            | Если нужен связанный рабочий процесс, используйте Qoder.                                                                |

## Совместимость для разработчиков

<details>

<summary>Какие изменения в API и внешних интеграциях?</summary>

* Идентификатор модели в API Gateway изменён с `provider::model` на `provider:model`.
* Записи, возвращаемые API Knowledge, используют поля V2.
* Точка MCP-over-HTTP удалена, на MCP внутри приложения это не влияет.
* При сбое запуска SSE может напрямую возвращаться обычная HTTP-ошибка; клиенту нужно поддерживать как HTTP-, так и SSE-пути ошибок.
* Параметры интерфейса планировщика задач изменились, история запусков не мигрирует.

</details>

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

* [Обновление с V1 до V2](/docs/russian/cherry-studio/installation/v1-to-v2-migration.md)
* [Официальная загрузка Cherry Studio 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)


---

# 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-v2-feature-differences.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.
