升級同降級

揀版本切換路徑，並喺操作前保護好 V1 同 V2 數據。

請根據而家版本同目標揀返對應說明。V1 同 V2 用唔同嘅數據結構，跨大版本切換前一定要先備份。

V1 同 V2 嘅數據同備份格式唔互通。V2 入面新增嘅會話、Agent、設定同文件唔會自動回寫返去 V1。

V2.0.2 升級同遷移

如果要保留 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 數據唔會遷入。

【重新遷移】會永久刪除而家嘅 V2 數據，再由原始 V1 數據重新匯入，唔會合併或者保留兩邊嘅數據。除非之前 V1 遷移失敗或者漏咗數據，否則千祈唔好撳。

揀選路徑

破壞性更新提醒

先確認數據唔互通、重新遷移同回退限制。

功能差異

了解介面、Agent、知識庫等變化，同埋升級後需要覆核嘅項目。

V1 升級到 V2

備份 V1 數據，直接用 V2.0.2 完成遷移。

V2 降級到 V1

返去原本嘅 V1 數據，並了解幾時先需要處理 V2 數據庫。

切換前準備

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

唔好為咗「徹底卸載」而手動刪除應用數據。數據庫處理只適用於明確放棄全部 V2 數據或者重新遷移嘅情況，詳見 【V2 降級到 V1】。

下載入口

• Cherry Studio V2 官方下載
• Cherry Studio V1 官方下載
• V2.0.2 發佈頁：GitCode · GitHub