For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

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

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 не будут перенесены.

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

  1. Обновите V1 до 1.9.13 и запустите его как минимум один раз.

  2. Отключите [Упрощённое резервное копирование] и создайте полную резервную копию V1.

  3. Полностью выйдите из Cherry Studio, затем скопируйте весь каталог данных V1.

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

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

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

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

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

  • Текущие данные V2 будут навсегда удалены, и это нельзя отменить.

  • Исходные данные V1 будут сохранены и после перезапуска будут повторно импортированы.

  • Сначала необходимо создать полную резервную копию текущего V2.

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

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

  • Служба моделей, API Key и модель по умолчанию; Anthropic OAuth не будет перенесён, нужно перейти на API Key.

  • Группы помощников, порядок промптов, права инструментов Agent и привязки базы знаний.

  • Источники сбоев базы знаний, а также службы поиска по ключевым словам и чтения URL в веб-поиске.

  • Пользовательский CSS, избранное на боковой панели и отсутствующие файлы.

Полное сравнение см. в [Различия в функциях].

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

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

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

  • [Игнорировать и использовать значения по умолчанию] начнёт с конфигурации по умолчанию, данные V1 не будут перенесены.

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

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

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

Последнее обновление

Это было полезно?