> 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/v2-breaking-update-notice.md).

# 破壊的更新の注意

V2は通常の上書き更新ではありません。データ構造が変更され、アシスタント、Agent、ナレッジベース、Web検索、ファイルなどの機能の入口と動作も調整されています。

{% hint style="danger" %}
V1のデータはV2へ一方向にのみ移行できます。V2で新たに追加された会話、Agent、設定、ファイルはV1へ同期されず、V1とV2のバックアップも相互に復元できません。
{% endhint %}

## 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 データは取り込まれません。                 |

{% hint style="danger" %}
通常のV2.0.2へのアップグレードでは【再移行】をクリックする必要はありません。この操作は現在のV2データを永久に削除し、元のV1データから再インポートします。以前のV1移行が失敗したか、データが抜けている場合を除き、絶対にクリックしないでください。
{% endhint %}

## アップグレード前に必ず完了すること

1. V1を1.9.13に更新し、少なくとも1回は正常に起動してください。
2. 【簡易バックアップ】をオフにして、V1の完全バックアップを作成してください。
3. Cherry Studio を完全に終了してから、V1のデータディレクトリ全体をコピーしてください。
4. カスタムディレクトリや外付けディスクを使用する場合は、パスがマウントされており、読み書き可能であることを確認してください。

移行ウィザードは現在のV1データディレクトリを読み取り、バックアップZIPは読み取りません。バックアップは予期しない復元用であり、元のデータディレクトリの代わりとして移行に使用できません。

## 【再移行】はデータの統合ではありません

V2.0.2 では【設定】→【データ】に【再移行】が追加されました。これは、以前のV1移行で失敗したりデータが抜けたりした場合の修復専用です。

操作前に次の事項の確認を求められます：

* 現在のV2データは永久に削除され、元に戻せません。
* 元のV1データは保持され、再起動後に再度インポートされます。
* まず現在のV2の完全バックアップを作成する必要があります。

完全バックアップを作成しても、V1とV2のデータが自動的に統合されることはありません。保持したいV2の新しい内容は、先に個別にエクスポートするか、完全バックアップを保管してください。

{% hint style="danger" %}
【設定】→【データ】→【キャッシュをクリア】内の【v1版の残留データ】は、【再移行】に必要な元のV1データを削除します。移行結果が完全であることを確認し、個別バックアップを保管する前に、この項目を消去しないでください。
{% endhint %}

## アップグレード後の重点確認

* モデルサービス、API Key、デフォルトモデル。Anthropic OAuth は移行されないため、API Key に切り替える必要があります。
* アシスタントのグループ分け、プロンプトの順序、Agentのツール権限、ナレッジベースの紐付け。
* ナレッジベースの失敗元、Web検索のキーワード検索とURL読み取りサービス。
* カスタムCSS、サイドバーのお気に入り、欠落ファイル。

完全な対照は次を参照 [【機能の違い】](/docs/jp/cherry-studio/installation/v1-v2-feature-differences.md)。

## 移行に失敗した、またはロールバックが必要な場合

* まず【再試行】を使用し、データディレクトリ、ディスク、またはデータの問題を修正してから続行してください。
* 【問題情報を保存】はローカルにのみ保存されます。ファイルにはパス、内容、または認証情報が含まれる可能性があるため、Cherry Studioサポートチームのみに提供してください。
* 【無視してデフォルト値を使用】すると、デフォルト設定から開始され、V1データは移行されません。
* 通常のV1への復帰では、データベースを削除する必要はなく、V2のバックアップをV1に復元しないでください。

{% hint style="danger" %}
自分でデータベースを削除したり置き換えたりしないでください。誤操作した場合、データディレクトリを確認できない場合、または再移行が必要な場合は、まずすべてのバックアップとデータディレクトリを保持したうえで、Cherry Studioサポートチームに連絡してください。
{% endhint %}

## 続きを読む

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>機能の違い</strong></td><td>自動移行、要確認項目、継承されない内容を確認する。</td><td><a href="/pages/456f2211b0b0b06d6631afcb8259bf9a96a0d5a5">/pages/456f2211b0b0b06d6631afcb8259bf9a96a0d5a5</a></td></tr><tr><td><strong>V1 を V2 にアップグレード</strong></td><td>正しいバージョン順序に従って、バックアップ、移行、検証を完了してください。</td><td><a href="/pages/f36d7d684457217cd49f02f8548435098d65fdac">/pages/f36d7d684457217cd49f02f8548435098d65fdac</a></td></tr><tr><td><strong>V2 を V1 にダウングレード</strong></td><td>ロールバック、バックアップ、データベースの取り扱い上の注意を確認してください。</td><td><a href="/pages/a10251392329ad4be4ad1e68882647b5c8ca9604">/pages/a10251392329ad4be4ad1e68882647b5c8ca9604</a></td></tr></tbody></table>

## ダウンロード入口

* [V1 公式ダウンロード](https://cherryai.com.cn/download/v1)
* 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)
* [V2 公式ダウンロード](https://cherryai.com.cn/download)


---

# 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/v2-breaking-update-notice.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.