機能の違い

V1とV2の主要機能、データ処理方法、アップグレード後の確認項目を比較します。

V2ではデータ構造と複数の機能入口が調整されました。アップグレード前に再設定が必要な項目を確認してください。具体的な手順は 【V1からV2へアップグレード】。

V2.0.2 移行の変更点

状況	V2.0.2の処理方法	注意事項
V1からの初回移行	V1.9.13から直接V2.0.2をインストールできます	先にV2.0.0をインストールする必要はなくなりました。
通常のV2アップグレード	直接アップグレードして現在のV2データを引き続き使用	【再移行】をクリックしないでください。
V1を再移行	【設定】→【データ】で【再移行】を選択	現在のV2データは完全に削除され、以前の移行で失敗または漏れたデータにのみ使用されます。

【再移行】はV1データを現在のV2に補充・統合するものではありません。まず現在のV2データを削除し、その後保持されているV1データから再インポートします。V1の移行失敗や漏れデータでない場合は、絶対にクリックしないでください。

データの扱い

処理方法	データ範囲	アップグレード後に行うこと
自動移行	設定、モデルサービスとモデル、アシスタントとグループ、会話とメッセージ、Agentと会話、MCP、ナレッジベースおよび有効なインデックス、ファイル、描画、翻訳、ノート、プロンプト、使用量記録	よく使う項目が正常に開けるかを抜き取り確認してください。
再確認が必要	Anthropicの認証情報、ネット検索の既定サービス、Agentツール権限とナレッジベースのバインド、プロンプト順序、ナレッジベースの失敗項目、カスタムCSS、サイドバーのお気に入り、欠落ファイル	下表に従って再確認してください。
継承されません	Agentの定時タスク履歴、旧版サイトマップの展開結果、一部の一時画像参照、ノートの現在の開閉状態、削除済み機能の設定	必要に応じて再作成してください。

移行ではV1の元データは削除されません。V2の新データはV1に同期されず、両バージョンのバックアップも相互に復元できません。

主な違い

機能	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を使用してください。

開発者向け互換性

APIと外部連携にはどのような変更がありますか？

• API Gatewayのモデル識別子は provider::model から provider:model。
• Knowledge APIの返却項目はV2フィールドを使用します。
• MCP-over-HTTPエンドポイントは削除されましたが、アプリ内MCPには影響しません。
• SSEの起動失敗では通常のHTTPエラーが直接返される場合があり、クライアントはHTTPとSSEの両方のエラーパスに対応する必要があります。
• 定時タスクAPIの引数が変更され、過去の実行記録は移行されません。

参考資料

• V1 を V2 にアップグレード
• Cherry Studio V2 公式ダウンロード
• V2.0.2 リリースページ：GitCode · GitHub