> 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/v2-breaking-update-notice.md).

# 破壞性更新提示

V2 唔係普通嘅覆蓋更新。佢換咗數據結構，亦都調整咗助手、Agent、知識庫、網絡搜尋同檔案等功能嘅入口同行為。

{% hint style="danger" %}
V1 數據只可以單向遷移去 V2。V2 入面新增嘅會話、Agent、設定同檔案唔會同步返去 V1，V1 同 V2 嘅備份亦都唔可以互相恢復。
{% endhint %}

## 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 數據唔會遷入。         |

{% hint style="danger" %}
正常升級 V2.0.2 唔需要撳【重新遷移】。呢個操作會永久刪除而家嘅 V2 數據，再由原始 V1 數據重新導入；除非之前 V1 遷移失敗或者漏咗數據，否則一定唔好撳。
{% endhint %}

## 升級前必須完成

1. 將 V1 更新到 1.9.13，並且至少正常啟動一次。
2. 關閉【精簡備份】，建立 V1 完整備份。
3. 完全退出 Cherry Studio，再複製成個 V1 數據目錄。
4. 使用自訂目錄或者外置磁碟時，確認路徑已掛載而且可以讀寫。

遷移嚮導會讀取而家嘅 V1 數據目錄，唔會讀備份 ZIP。備份係用嚟意外恢復，唔可以代替原數據目錄參與遷移。

## 【重新遷移】唔係數據合併

V2.0.2 喺【設定】→【數據】入面新增咗【重新遷移】。佢只用嚟修復之前 V1 遷移失敗或者漏咗數據嘅情況。

操作前會要求確認以下事項：

* 而家嘅 V2 數據將會永久刪除，而且無法撤銷。
* 原始 V1 數據會保留，並喺重新啟動後重新導入。
* 必須先為而家嘅 V2 建立完整備份。

完整備份唔會令 V1 同 V2 數據自動合併。需要保留嘅 V2 新內容，請先單獨匯出或者保留完整備份。

{% hint style="danger" %}
【設定】→【數據】→【清除緩存】入面嘅【v1 版本遺留數據】會刪除【重新遷移】所需嘅原始 V1 數據。確認遷移結果完整同保留獨立備份之前，唔好清理呢一項。
{% endhint %}

## 升級後重點檢查

* 模型服務、API Key 同預設模型；Anthropic OAuth 唔會遷移，需要改用 API Key。
* 助手分組、提示詞順序、Agent 工具權限同知識庫綁定。
* 知識庫失敗來源、網絡搜尋嘅關鍵字搜尋同網址讀取服務。
* 自訂 CSS、側欄收藏同缺失檔案。

完整對照見 [【功能差異】](/docs/zhong-wen-fan-ti/cherry-studio/installation/v1-v2-feature-differences.md)。

## 遷移失敗或者需要回退

* 優先使用【重試】，修復數據目錄、磁碟或者數據問題之後再繼續。
* 【保存問題資訊】只會儲存到本地；檔案可能包含路徑、內容或者憑據，只提供俾 Cherry Studio 支援團隊。
* 【忽略並使用預設值】會由預設配置開始，V1 數據唔會遷入。
* 正常返去 V1 唔需要刪除資料庫，亦都唔好將 V2 備份恢復到 V1。

{% hint style="danger" %}
唔好自己刪除或者替換資料庫。誤操作、無法確認數據目錄，或者需要重新遷移時，請先保留所有備份同數據目錄，再聯絡 Cherry Studio 支援團隊。
{% 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/c68a0ed9b79b90e86505a360d5c5ccc6c9e9d284">/pages/c68a0ed9b79b90e86505a360d5c5ccc6c9e9d284</a></td></tr><tr><td><strong>V1 升級到 V2</strong></td><td>按正確版本順序完成備份、遷移同驗證。</td><td><a href="/pages/cb474829a9ddc12f506a547da9e5d9618f5ae990">/pages/cb474829a9ddc12f506a547da9e5d9618f5ae990</a></td></tr><tr><td><strong>V2 降級到 V1</strong></td><td>了解回退、備份同資料庫處理注意事項。</td><td><a href="/pages/79a35a7153ecc1b7cca5d982a4b6526d99066ab3">/pages/79a35a7153ecc1b7cca5d982a4b6526d99066ab3</a></td></tr></tbody></table>

## 下載入口

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


---

# 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/v2-breaking-update-notice.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.