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

# 版本升級同降級

喺 V1、V2 之間切換時，請先揀返相應說明：

* [功能差異](/docs/zhong-wen-fan-ti/cherry-studio/installation/v1-v2-feature-differences.md)
* [V1 升級到 V2](/docs/zhong-wen-fan-ti/cherry-studio/installation/v1-to-v2-migration.md)
* [V2 降級到 V1](/docs/zhong-wen-fan-ti/cherry-studio/installation/v2-to-v1-downgrade.md)

{% hint style="danger" %}
切換版本前，先喺應用程式內建立完整備份，再完全退出 Cherry Studio 並複製成個資料目錄。V1 同 V2 嘅備份唔可以互相還原。
{% endhint %}

## V1 資料遷移到 V2

V2.0.2 已支援由 V1.9.13 直接遷移，唔再需要 V2.0.0 中轉。

| 而家情況             | 應該點做                                |
| ---------------- | ----------------------------------- |
| 仲喺 V1，需要保留資料     | 先將 V1 更新到 1.9.13，再直接安裝 V2.0.2 完成遷移。 |
| 已經喺度用緊 V2        | 正常升級 V2.0.2，繼續使用而家嘅 V2 資料。          |
| 之前遷移 V1 失敗或者漏咗資料 | 完整備份而家嘅 V2 之後，先可以使用【重新遷移】。          |
| 唔需要 V1 資料        | 可以揀【忽略並使用預設值】，但 V1 數據唔會遷入。          |

{% hint style="danger" %}
【設定】→【資料】入面嘅【重新遷移】會永久刪除而家嘅 V2 資料，再由原始 V1 資料重新匯入。佢唔會合併兩邊嘅資料；如果唔係 V1 遷移失敗或者漏咗資料，千祈唔好撳。
{% endhint %}

## 下載入口

* [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)
* [V2 官方下載](https://cherryai.com.cn/download)

更多備份、遷移失敗同資料庫注意事項見 [【升級與降級】](/docs/zhong-wen-fan-ti/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/zhong-wen-fan-ti/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.