> 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/zhong-wen-fan-ti/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/95cf89c36b4afc416c36689c984fb6e0c1a1f52d">/pages/95cf89c36b4afc416c36689c984fb6e0c1a1f52d</a></td></tr><tr><td><strong>功能差異</strong></td><td>了解介面、Agent、知識庫等變化，同埋升級後需要覆核嘅項目。</td><td><a href="/pages/c68a0ed9b79b90e86505a360d5c5ccc6c9e9d284">/pages/c68a0ed9b79b90e86505a360d5c5ccc6c9e9d284</a></td></tr><tr><td><strong>V1 升級到 V2</strong></td><td>備份 V1 數據，直接用 V2.0.2 完成遷移。</td><td><a href="/pages/cb474829a9ddc12f506a547da9e5d9618f5ae990">/pages/cb474829a9ddc12f506a547da9e5d9618f5ae990</a></td></tr><tr><td><strong>V2 降級到 V1</strong></td><td>返去原本嘅 V1 數據，並了解幾時先需要處理 V2 數據庫。</td><td><a href="/pages/79a35a7153ecc1b7cca5d982a4b6526d99066ab3">/pages/79a35a7153ecc1b7cca5d982a4b6526d99066ab3</a></td></tr></tbody></table>

## 切換前準備

1. 結束緊運行嘅對話、Agent、知識庫匯入同文件處理任務。
2. 為而家版本建立一份新嘅完整備份，並存喺應用數據目錄以外。
3. 記錄而家嘅應用數據目錄；使用自訂目錄或者外置磁碟時，確認路徑可以正常存取。

{% hint style="warning" %}
唔好為咗「徹底卸載」而手動刪除應用數據。數據庫處理只適用於明確放棄全部 V2 數據或者重新遷移嘅情況，詳見 [【V2 降級到 V1】](/docs/zhong-wen-fan-ti/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/docs/zhong-wen-fan-ti/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.