> 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/v1-v2-feature-differences.md).

# 功能差異

V2 調整咗數據結構同多項功能入口。升級前先睇下需要重新配置嘅項目；具體步驟見 [【V1 升級到 V2】](/docs/zhong-wen-fan-ti/cherry-studio/installation/v1-to-v2-migration.md)。

## V2.0.2 遷移變化

| 情況        | V2.0.2 嘅處理方式            | 注意事項                             |
| --------- | ----------------------- | -------------------------------- |
| 首次由 V1 遷移 | 可以由 V1.9.13 直接安裝 V2.0.2 | 唔再需要先安裝 V2.0.0。                  |
| 正常升級 V2   | 直接升級同繼續使用而家 V2 數據       | 唔好撳【重新遷移】。                       |
| 重新遷移 V1   | 喺【設定】→【數據】揀【重新遷移】       | 而家 V2 數據會被永久刪除，只用於之前遷移失敗或者漏咗嘅數據。 |

{% hint style="danger" %}
【重新遷移】唔會將 V1 數據補充合併到而家 V2。佢會先刪除而家 V2 數據，再由保留嘅 V1 數據重新導入。唔係 V1 遷移失敗或者漏咗數據時，千祈唔好撳。
{% endhint %}

## 數據點樣處理

| 處理方式 | 數據範圍                                                                 | 升級後要做乜          |
| ---- | -------------------------------------------------------------------- | --------------- |
| 自動遷移 | 設定、模型服務同模型、助手同分組、會話同消息、Agent 同會話、MCP、知識庫及有效索引、文件、繪畫、翻譯、筆記、提示詞、用量記錄   | 抽查常用項目可唔可以正常打開。 |
| 需要覆核 | Anthropic 憑據、網絡搜尋預設服務、Agent 工具權限同知識庫綁定、提示詞順序、知識庫失敗項、自訂 CSS、側欄收藏、缺失文件 | 按下表重新確認。        |
| 唔會繼承 | Agent 定時任務歷史記錄、舊版站點地圖展開結果、部分臨時圖片引用、筆記而家打開狀態、已移除功能嘅配置                 | 需要時重新建立。        |

{% hint style="info" %}
遷移唔會刪除 V1 原始數據。V2 新數據唔會同步返去 V1，兩個版本嘅備份亦都唔可以互相還原。
{% endhint %}

## 主要差異

| 功能              | V1                               | V2                                            | 升級後要做乜                           |
| --------------- | -------------------------------- | --------------------------------------------- | -------------------------------- |
| 助手同提示詞          | 獨立助手庫；快捷短語可同助手關聯                 | 助手喺聊天同 Agent 入面管理；快捷短語合併做全局提示詞                | 檢查助手分組同提示詞順序。                    |
| Agent           | 部分配置同工作區跟隨會話；舊授權可自動批准工具          | 身份、記憶同主要配置歸 Agent；會話建立後工作區固定；工具可能要重新請求授權      | 檢查模型、工作區、工具同權限。                  |
| Agent 知識庫       | 知識工具可能存取全局知識庫                    | 只存取明確綁定嘅知識庫                                   | 為每個 Agent 重新核對知識庫綁定。             |
| 知識庫檢索           | 可手動揀檢索模式同站點地圖來源                  | 冇嵌入模型時用 BM25，有嵌入模型時用混合檢索；站點地圖按普通網址處理          | 檢查嵌入同重排序模型；重建失敗來源。               |
| 網絡搜尋            | 可喺助手或者輸入區揀服務；包括本地搜尋、RAG 壓縮同訂閱黑名單 | 喺【設定】→【網絡搜尋】分別配置關鍵詞搜尋同網址讀取；相關舊選項移除            | 重新揀兩項預設服務同檢查憑據。                  |
| MCP             | 已添加服務同第三方發現市場並存                  | 已添加服務繼續遷移；舊第三方發現市場唔再提供                        | 檢查服務狀態；新服務由而家市場或者 JSON 添加。       |
| 模型服務            | Anthropic 可以保存 OAuth 憑據          | Anthropic OAuth 唔遷移；AWS Bedrock 區域保留；新增服務預設關閉 | 為 Anthropic 重新填 API Key，按需要啟用服務。 |
| 檔案              | 文件副本同業務對象嘅引用關係較弱                 | 託管文件按引用管理；最後一個引用刪除後會延遲清理託管副本                  | 長期保留嘅文件放入【文件】或者導出；用戶原文件唔會被刪除。    |
| 繪畫、Mini App 同側欄 | 參數同入口喺舊版區域                       | 繪畫參數移到提示詞工具欄；Mini App 喺頂部標籤欄；側欄收藏重置           | 熟悉新入口同重新設定收藏。                    |
| 自訂 CSS          | V1 選擇器直接生效                       | 內容保留，但遷移後預設停用                                 | 按 V2 選擇器適配後再啟用。                  |
| Code CLI        | 可選擇 iFlow                        | iFlow 由 Qoder 取代                              | 需要相關工作流時改用 Qoder。                |

## 開發者兼容性

<details>

<summary>API 同外部整合有咩變化？</summary>

* API Gateway 嘅模型標識由 `provider::model` 改做 `provider:model`。
* Knowledge API 返回條目使用 V2 字段。
* MCP-over-HTTP 端點已移除，唔影響應用內 MCP。
* SSE 啟動失敗可能直接返回普通 HTTP 錯誤，客戶端要同時兼容 HTTP 同 SSE 錯誤路徑。
* 定時任務接口參數已變，歷史運行記錄唔會遷移。

</details>

## 參考資料

* [V1 升級到 V2](/docs/zhong-wen-fan-ti/cherry-studio/installation/v1-to-v2-migration.md)
* [Cherry Studio V2 官方下載](https://cherryai.com.cn/download)
* 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/v1-v2-feature-differences.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.