> 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/en-us/question-contact/version-switching.md).

# Version Upgrade and Downgrade

When switching between V1 and V2, please first choose the corresponding instructions:

* [Feature differences](/docs/en-us/cherry-studio/installation/v1-v2-feature-differences.md)
* [Upgrade V1 to V2](/docs/en-us/cherry-studio/installation/v1-to-v2-migration.md)
* [Downgrade V2 to V1](/docs/en-us/cherry-studio/installation/v2-to-v1-downgrade.md)

{% hint style="danger" %}
Before switching versions, create a full backup in the app, then completely quit Cherry Studio and copy the entire data directory. Backups from V1 and V2 cannot be restored to each other.
{% endhint %}

## Migrate V1 data to V2

V2.0.2 now supports direct migration from V1.9.13, so V2.0.0 is no longer required as an intermediary.

| Current situation                                   | What to do                                                                         |
| --------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Still on V1 and need to keep data                   | Update V1 to 1.9.13, then install V2.0.2 directly to complete the migration.       |
| Already using V2                                    | Upgrade to V2.0.2 normally and continue using the current V2 data.                 |
| Previously failed to migrate V1 or missed some data | Only after fully backing up the current V2 can you use \[Remigrate].               |
| Do not need V1 data                                 | You can choose \[Ignore and use default values], but V1 data will not be migrated. |

{% hint style="danger" %}
The \[Remigrate] option under \[Settings] → \[Data] will permanently delete the current V2 data and then re-import from the original V1 data. It does not merge data from both sides; if V1 migration did not fail or data was not missing, do not click it.
{% endhint %}

## Download entry

* [Official V1 download](https://cherryai.com.cn/download/v1)
* V2.0.2 release page:[GitCode](https://gitcode.com/CherryHQ/cherry-studio/releases/v2.0.2) · [GitHub](https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.2)
* [V2 official download](https://cherryai.com.cn/download)

For more on backups, migration failures, and database notes, see [\[Upgrade and Downgrade\]](/docs/en-us/cherry-studio/installation/upgrade-downgrade.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/en-us/question-contact/version-switching.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.