> 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-to-v2-migration.md).

# V1 から V2 へアップグレード

{% hint style="danger" %}
移行は一方向です。V1 のデータは V2 に入れられますが、V2 の新しいデータは V1 に同期されません。アップグレード前に、V1 の完全バックアップと、アプリを完全終了した後にコピーした V1 データディレクトリ全体の両方を保持してください。
{% endhint %}

{% hint style="warning" %}
データを保持する正しい手順は：**V1.9.13 → V2.0.2（データ移行を直接完了）**。V2.0.0 を先にインストールする必要はなくなりました。
{% endhint %}

## 現在の状況に応じて選択

| 現在の状況                     | 操作                                                                |
| ------------------------- | ----------------------------------------------------------------- |
| まだ V1 を使用中で、データを保持したい     | V1 を 1.9.13 に更新し、このページの手順に従って V2.0.2 を直接インストールしてください。             |
| すでに V2 を使用している            | V2.0.2 を通常どおりアップグレードし、現在の V2 データをそのまま使用してください。【再移行】はクリックしないでください。 |
| 以前の V1 移行が失敗した、またはデータが漏れた | 現在の V2 を完全バックアップした後でのみ、【再移行】を使って V1 からやり直せます。                     |
| V1 データは不要                 | 【無視して既定値を使用】を選択して、既定の設定から開始できます。V1 のデータは移行されません。                  |

## アップグレード前の確認

* V1 が 1.9.12 未満ではないこと。可能であればまず最終版の 1.9.13 に更新し、少なくとも 1 回起動してください。
* 初回の移行では V2.0.2 を直接使用できます。
* カスタムデータディレクトリや外付けディスクは通常どおり読み書きできること。
* 会話、Agent、知識ベースのインポート、ファイル処理タスクはいずれも完了していること。

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

## 操作手順

{% stepper %}
{% step %}

### V1 を更新してバックアップする

V1 を 1.9.13 に更新します。データバックアップページで【簡易バックアップ】をオフにし、完全バックアップを作成して、アプリのデータディレクトリ以外に保存してください。
{% endstep %}

{% step %}

### V1 のデータディレクトリ全体をコピーする

V1 のデータ設定でディレクトリの場所を確認し、Cherry Studio を完全に終了してからディレクトリ全体をコピーしてください。データベースファイルだけをコピーしないでください。
{% endstep %}

{% step %}

### カスタムディレクトリを確認する

外付けハードディスク、ネットワークボリューム、その他のカスタム位置を使う場合は、パスがマウントされ、読み書き可能であることを確認してください。パスにアクセスできない場合、既定ディレクトリに切り替えて移行を続けないでください。
{% endstep %}

{% step %}

### V2.0.2 を初回起動する

から [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)V1 を完全に終了してからインストールし、起動してください。
{% endstep %}

{% step %}

### 【データ移行ウィザード】を完了する

ウィザードに表示されたデータ位置を確認し、【移行を開始】を選択してください。移行中はアプリを閉じたり、データディレクトリを移動したり、外付けディスクを取り外したりしないでください。
{% endstep %}

{% step %}

### 結果を確認して再起動する

移行完了後、まず警告情報を展開し、その後【アプリを再起動】を選択してください。
{% endstep %}
{% endstepper %}

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

* よく使うモデルサービス、API Key、既定モデルを確認します。
* アシスタントグループ、プロンプト、Agent 権限、知識ベースの紐付けを確認します。
* よく使う会話、知識ベース、ファイルを開き、表示に失敗した知識ソースだけを再構築します。
* 【設定】→【ネット検索】で、キーワード検索と URL 読み取りサービスを再確認します。
* サイドバーのお気に入りとカスタム CSS を確認します。
* 【設定】→【データ】で新しい V2 の完全バックアップを作成します。

その他の入口の変更は [【機能の違い】](/docs/jp/cherry-studio/installation/v1-v2-feature-differences.md)を参照してください。

## 移行が失敗した場合のみ【再移行】を使用する

以前の V1 移行が失敗した、またはデータが漏れた場合、V2.0.2 では【設定】→【データ】から【再移行】を選択できます。この操作によりアプリが再起動し、保持している V1 データから移行をやり直します。

{% hint style="danger" %}
【再移行】は現在の V2 データを永久に削除し、V1 と V2 のデータを統合しません。以前の V1 移行が失敗した、またはデータが漏れた場合を除き、絶対にクリックしないでください。操作前には現在の V2 の完全バックアップを作成する必要があります。保持したい V2 の新しい内容は、別途エクスポートしてください。
{% endhint %}

## 移行失敗時

| 選択肢          | 使用するタイミング                     | 注意事項                                                                        |
| ------------ | ----------------------------- | --------------------------------------------------------------------------- |
| 【再試行】        | ディレクトリ、ディスク、または一時データの問題を修正した後 | 優先的に選択します。移行フローは終了しません。                                                     |
| 【問題情報を保存】    | 再試行しても失敗し、 सहायताが必要          | ファイルはローカルにのみ保存され、パス、内容、認証情報が含まれる可能性があります。Cherry Studio のサポートチームにのみ提供してください。 |
| 【無視して既定値を使用】 | V1 データの取り込みを明確に放棄する           | 今回書き込まれた V2 データの一部を消去し、既定の設定から開始します。その後は移行の案内が自動で再表示されません。                  |
| 【V1 を継続使用】   | 今は移行できないため、作業を再開する必要がある       | V1 を再インストールし、元の V1 データディレクトリをそのまま使用してください。                                  |

{% hint style="danger" %}
移行に失敗した場合、または誤って【無視して既定値を使用】を選んだ場合は、自分でデータベースを削除したり、何度も上書きインストールしたりしないでください。V1 の元データとバックアップを保持し、Cherry Studio サポートチームに連絡してください。
{% endhint %}

## よくある質問

<details>

<summary>V1 のバックアップ ZIP だけで直接移行できますか？</summary>

できません。まず互換性のある V1 で復元してデータが正常であることを確認し、その後で完全なデータディレクトリを保持してから V2 の移行を開始してください。

</details>

<details>

<summary>知識ベースはすべて再インデックスが必要ですか？</summary>

必要ありません。有効なインデックスは移行されます。失敗と表示されるもの、埋め込みモデルがないもの、または読み取れないソースのみを処理します。

</details>

## 参考資料

* [Cherry Studio V2 公式ダウンロード](https://cherryai.com.cn/download)
* [Cherry Studio 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)
* [公式移行設計書](https://github.com/CherryHQ/cherry-studio/blob/main/src/main/data/migration/v2/README.md#version-compatibility-gate)
* [問題報告と機能提案](/docs/jp/question-contact/suggestions.md)


---

# 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-to-v2-migration.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.