For the complete documentation index, see llms.txt. This page is also available as Markdown.

破壞性更新提醒

升級 V2 前必須了解嘅數據遷移、版本路徑同回退限制。

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

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

升級前必須完成

  1. 將 V1 更新到 1.9.13,並且至少正常啟動一次。

  2. 關閉【精簡備份】,建立 V1 完整備份。

  3. 完全退出 Cherry Studio,再複製成個 V1 數據目錄。

  4. 使用自訂目錄或者外置磁碟時,確認路徑已掛載而且可以讀寫。

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

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

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

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

  • 而家嘅 V2 數據將會永久刪除,而且無法撤銷。

  • 原始 V1 數據會保留,並喺重新啟動後重新導入。

  • 必須先為而家嘅 V2 建立完整備份。

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

升級後重點檢查

  • 模型服務、API Key 同預設模型;Anthropic OAuth 唔會遷移,需要改用 API Key。

  • 助手分組、提示詞順序、Agent 工具權限同知識庫綁定。

  • 知識庫失敗來源、網絡搜尋嘅關鍵字搜尋同網址讀取服務。

  • 自訂 CSS、側欄收藏同缺失檔案。

完整對照見 【功能差異】

遷移失敗或者需要回退

  • 優先使用【重試】,修復數據目錄、磁碟或者數據問題之後再繼續。

  • 【保存問題資訊】只會儲存到本地;檔案可能包含路徑、內容或者憑據,只提供俾 Cherry Studio 支援團隊。

  • 【忽略並使用預設值】會由預設配置開始,V1 數據唔會遷入。

  • 正常返去 V1 唔需要刪除資料庫,亦都唔好將 V2 備份恢復到 V1。

繼續閱讀

下載入口

最後更新

呢個有冇幫助?