> 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/upgrade-downgrade.md).

# アップグレードとダウングレード

現在のバージョンと目的に応じて該当する説明を選択してください。V1 と V2 は異なるデータ構造を使用するため、大きなバージョンをまたいで切り替える前に必ずバックアップしてください。

{% hint style="danger" %}
V1 と V2 のデータおよびバックアップ形式は互換性がありません。V2 で追加された会話、Agent、設定、ファイルは自動的に V1 へ書き戻されません。
{% endhint %}

## V2.0.2 へのアップグレードと移行

{% hint style="warning" %}
V1 データを保持したい場合の正しい手順は次のとおりです：**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 データは取り込まれません。                             |

{% hint style="danger" %}
【再移行】は現在の V2 データを完全に削除し、その後元の V1 データから再インポートします。両方のデータを統合したり保持したりはしません。以前の V1 移行が失敗した、またはデータが欠落している場合を除き、絶対にクリックしないでください。
{% 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/b17a82d2a381bb6748a625bf4dbed1278c5799b6">/pages/b17a82d2a381bb6748a625bf4dbed1278c5799b6</a></td></tr><tr><td><strong>機能の違い</strong></td><td>画面、Agent、ナレッジベースなどの変更点と、アップグレード後に再確認が必要な項目を把握してください。</td><td><a href="/pages/456f2211b0b0b06d6631afcb8259bf9a96a0d5a5">/pages/456f2211b0b0b06d6631afcb8259bf9a96a0d5a5</a></td></tr><tr><td><strong>V1 を V2 にアップグレード</strong></td><td>V1 データをバックアップし、V2.0.2 を直接使用して移行を完了します。</td><td><a href="/pages/f36d7d684457217cd49f02f8548435098d65fdac">/pages/f36d7d684457217cd49f02f8548435098d65fdac</a></td></tr><tr><td><strong>V2 を V1 にダウングレード</strong></td><td>元の V1 データに戻し、V2 データベースをいつ処理する必要があるのかを確認します。</td><td><a href="/pages/a10251392329ad4be4ad1e68882647b5c8ca9604">/pages/a10251392329ad4be4ad1e68882647b5c8ca9604</a></td></tr></tbody></table>

## 切り替え前の準備

1. 実行中の会話、Agent、ナレッジベースの取り込み、ファイル処理タスクを終了してください。
2. 現在のバージョンの新しい完全バックアップを作成し、アプリケーションデータディレクトリの外に保存してください。
3. 現在のアプリケーションデータディレクトリを記録してください。カスタムディレクトリや外付けディスクを使用している場合は、パスへ正常にアクセスできることを確認してください。

{% hint style="warning" %}
「完全アンインストール」のためにアプリケーションデータを手動で削除しないでください。データベースの処理は、すべての V2 データを明確に破棄する場合、または再移行する場合にのみ適用されます。詳細は [【V2 を V1 にダウングレード】](/docs/jp/cherry-studio/installation/v2-to-v1-downgrade.md)。
{% endhint %}

## ダウンロード入口

* [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)


---

# 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/upgrade-downgrade.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.