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

# 機能差分

V2ではデータ構造と複数の機能入口が調整されました。アップグレード前に再設定が必要な項目を確認してください。具体的な手順は [【V1からV2へアップグレード】](/docs/jp/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を使用し、埋め込みモデルがある場合はハイブリッド検索を使用；サイトマップは通常のURLとして扱う | 埋め込みモデルと再ランキングモデルを確認；失敗したソースを再構築してください。                |
| ネット検索             | アシスタントまたは入力欄でサービスを選択可能；ローカル検索、RAG圧縮、購読ブラックリストを含む | 【設定】→【ネット検索】でキーワード検索とURL読み取りをそれぞれ設定；関連する旧オプションは削除                 | 2つの既定サービスを再選択し、認証情報を確認してください。                          |
| MCP               | 追加済みサービスとサードパーティ発見マーケットが共存                       | 追加済みサービスは引き続き移行；旧サードパーティ発見マーケットは提供されなくなりました                       | サービス状態を確認してください；新しいサービスは現在のマーケットまたはJSONから追加します。        |
| モデルサービス           | AnthropicはOAuth認証情報を保存可能                         | AnthropicのOAuthは移行されません；AWS Bedrockのリージョンは保持されます；新規追加サービスは既定で無効   | AnthropicのAPIキーを再入力し、必要に応じてサービスを有効化してください。             |
| ファイル              | ファイルの複製と業務オブジェクトの参照関係は弱い                         | 管理対象ファイルは参照で管理される；最後の参照が削除された後、管理対象コピーは遅延削除される                    | 長期保存するファイルは【ファイル】に入れるかエクスポートしてください；ユーザーの元ファイルは削除されません。 |
| 描画、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の両方のエラーパスに対応する必要があります。
* 定時タスクAPIの引数が変更され、過去の実行記録は移行されません。

</details>

## 参考資料

* [V1 を V2 にアップグレード](/docs/jp/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/jp/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.