> 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/cherry-studio/installation/upgrade-downgrade.md).

# 升级与降级

根据当前版本和目标选择对应说明。V1 与 V2 使用不同的数据结构，跨大版本切换前必须先备份。

{% hint style="danger" %}
V1 与 V2 的数据和备份格式不互通。V2 中新增的会话、Agent、设置和文件不会自动回写到 V1。
{% endhint %}

## V2.0.2 升级与迁移

{% hint style="warning" %}
需要保留 V1 数据时，正确路径是：**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 数据不会迁入。          |

{% hint style="danger" %}
【重新迁移】会永久删除当前 V2 数据，再从原始 V1 数据重新导入，不会合并或保留两边的数据。除非此前 V1 迁移失败或遗漏数据，否则一定不要点击。
{% 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/opEK8co0YaWHnK1hShUh">/pages/opEK8co0YaWHnK1hShUh</a></td></tr><tr><td><strong>功能差异</strong></td><td>了解界面、Agent、知识库等变化和升级后需要复核的项目。</td><td><a href="/pages/eQUWilDj13ym7JDot7DO">/pages/eQUWilDj13ym7JDot7DO</a></td></tr><tr><td><strong>V1 升级到 V2</strong></td><td>备份 V1 数据，直接使用 V2.0.2 完成迁移。</td><td><a href="/pages/1tnxeEnLtQaps6elvKea">/pages/1tnxeEnLtQaps6elvKea</a></td></tr><tr><td><strong>V2 降级到 V1</strong></td><td>返回原 V1 数据，并了解什么时候才需要处理 V2 数据库。</td><td><a href="/pages/u2aveaHlLFm4ogXvNeCi">/pages/u2aveaHlLFm4ogXvNeCi</a></td></tr></tbody></table>

## 切换前准备

1. 结束正在运行的对话、Agent、知识库导入和文件处理任务。
2. 为当前版本创建一份新的完整备份，并保存在应用数据目录之外。
3. 记录当前应用数据目录；使用自定义目录或外置磁盘时，确认路径可以正常访问。

{% hint style="warning" %}
不要为了“彻底卸载”手动删除应用数据。数据库处理只适用于明确放弃全部 V2 数据或重新迁移的情况，详见 [【V2 降级到 V1】](/cherry-studio/installation/v2-to-v1-downgrade.md)。
{% endhint %}

## 下载入口

* [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)


---

# 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/cherry-studio/installation/upgrade-downgrade.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.