diff --git a/installation/desktop/usage/migrate.mdx b/installation/desktop/usage/migrate.mdx
index 2f38bf13f7..861d1e0c26 100644
--- a/installation/desktop/usage/migrate.mdx
+++ b/installation/desktop/usage/migrate.mdx
@@ -21,14 +21,14 @@ If you already have Legacy Desktop installed, Comfy Desktop can detect and migra
Legacy Desktop was a single-install app. Comfy Desktop is a multi-installation manager. When you migrate:
-- **Workflows and settings** — copied to the new Standalone installation
+- **Workflows and settings**: reused in place, so the new instance keeps the same user data.
- **Custom nodes** — scanned and re-installed in the new environment
-- **Models** — your existing model folder is added as a shared directory (files stay where they are)
-- **Input files and outputs** — copied to the new installation's shared directories
-- **Python environment** — a fresh Python environment is created (Legacy's bundled Python is not reused)
-- **ComfyUI version** — the latest version is installed in the new Standalone
+- **Models**: your existing model folder is added as a shared directory, so the files stay where they are.
+- **Input files and outputs**: reused in place from the existing folders.
+- **Python environment**: your existing environment is validated and reused, with the packages ComfyUI needs installed into it.
+- **ComfyUI version**: the ComfyUI source is staged into a new managed directory, so Comfy Desktop manages updates from then on.
-The Legacy Desktop installation itself is **not modified** during migration. It remains on your system as a backup.
+The Legacy Desktop app itself stays installed, and Comfy Desktop backs up your legacy state before it starts. The migration reuses that setup in place rather than copying it, so the shared data folder and Python environment are not an untouched copy. If you need a pristine copy of your Legacy Desktop setup, back it up yourself before migrating.
## What Changes After Migration
@@ -55,16 +55,16 @@ Download and install Comfy Desktop from the [official download page](https://com
-When you first open Comfy Desktop, it automatically detects any Legacy Desktop installation on your system and shows a migration prompt.
+When you first open Comfy Desktop, the first-run setup detects any Legacy Desktop installation on your system. Choose **Local**, and the setup shows **Migrate existing instance**, already selected, so your existing setup is brought over when you continue.
-Click **Migrate Now** to proceed. Comfy Desktop will:
+Select **Continue**, then confirm **Migrate Legacy Desktop to Standalone** with **Start Migration**. Comfy Desktop will:
1. Scan your existing installation (custom nodes, models, workflows)
-2. Create a new Standalone installation with a fresh Python environment and the latest ComfyUI
-3. Copy your user data (workflows, settings, etc.)
-4. Copy your input files and outputs
+2. Reuse your existing data folder and Python environment in place, and stage the ComfyUI source into a new managed directory so updates work normally
+3. Reuse your workflows, settings, and other user data in place
+4. Reuse your input files and outputs in place
5. Add your model folder as a shared directory
6. Install custom nodes in the new environment
@@ -80,17 +80,26 @@ Launch your new installation and confirm:
+## Migrate from the Chooser
+
+If you have already finished the first-run setup, or the Legacy Desktop installation is already listed in the Chooser, start the migration from the instance card:
+
+1. Find the Legacy Desktop instance card. It carries a **Migrate** pill.
+2. Click the pill, or open the card's **⋮** menu and select **Migrate to Standalone**.
+3. Review the confirmation, then select **Start Migration**.
+
+A Legacy Desktop install is adopted in place, so the instance that appears is your existing setup under Comfy Desktop management. Migrating a tracked Git or portable install instead creates a new Standalone instance and leaves the tracked install in place. In both cases the model files are not copied, they are read from where they already are.
+
+A pending update takes priority on those cards: they show the update pill instead of **Migrate**.
+
## Troubleshooting
### Legacy Desktop not detected automatically
-If the migration prompt doesn't appear, you can migrate manually:
-
-1. Click the **+** card in the Chooser view
-2. Select **Legacy Desktop**
-3. Choose your Legacy Desktop installation and follow the prompts
+The Legacy Desktop source is migration-only and is not listed in the New Instance picker, so it cannot be added by hand. If Comfy Desktop did not detect your Legacy Desktop installation:
-If your existing installation wasn't detected by the Chooser at all, you can also add it directly via the Manage panel. See [**Tracking an existing installation**](/installation/desktop/usage/instance-management#tracking-an-existing-installation) for instructions.
+1. Add the installation as a tracked instance. See [**Tracking an existing installation**](/installation/desktop/usage/instance-management#tracking-an-existing-installation).
+2. Once it appears in the Chooser, migrate it with its **Migrate** pill, or with **Migrate to Standalone** in the **⋮** menu.
### Migration fails
diff --git a/ja/installation/desktop/usage/migrate.mdx b/ja/installation/desktop/usage/migrate.mdx
index 9f40f17b03..299496af11 100644
--- a/ja/installation/desktop/usage/migrate.mdx
+++ b/ja/installation/desktop/usage/migrate.mdx
@@ -3,15 +3,16 @@ title: "Legacy Desktop からの移行"
description: "Legacy Desktop インストールを Comfy Desktop に移行する方法"
icon: "arrow-right"
sidebarTitle: "移行"
-translationSourceHash: b8c702d3
+translationSourceHash: b47dc646
translationFrom: installation/desktop/usage/migrate.mdx
translationBlockHashes:
"_intro": 14240c76
- "What Gets Migrated": 756473d1
+ "What Gets Migrated": 91f931e9
"What Changes After Migration": 1f09d2db
"Does My Old Link Still Work?": 528b3e43
- "Step-by-Step Migration": 61e3ac66
- "Troubleshooting": b48dfa6f
+ "Step-by-Step Migration": 8ea40634
+ "Migrate from the Chooser": 497be978
+ "Troubleshooting": a6cd9f9b
---
@@ -30,14 +31,14 @@ Legacy Desktop をすでにインストールしている場合、Comfy Desktop
Legacy Desktop はシングルインストールのアプリです。Comfy Desktop はマルチインストールマネージャーです。移行時:
-- **ワークフローと設定**:新しい Standalone インストールにコピー
+- **ワークフローと設定**:その場で再利用され、新しいインストールが同じユーザーデータを引き継ぎます。
- **カスタムノード**:スキャン後、新しい環境で再インストール
-- **モデル**:既存のモデルフォルダが共有ディレクトリとして追加(ファイルは元の場所に残る)
-- **入力ファイルと出力結果**:新しいインストールの共有ディレクトリにコピー
-- **Python 環境**:新しい Python 環境を作成(Legacy のバンドル Python は再利用しません)
-- **ComfyUI バージョン**:新しい Standalone に最新版をインストール
+- **モデル**:既存のモデルフォルダが共有ディレクトリとして追加され、ファイルは元の場所に残ります。
+- **入力ファイルと出力結果**:既存のフォルダからその場で再利用されます。
+- **Python 環境**:既存の環境を検証して再利用し、その中に ComfyUI が必要とするパッケージをインストールします。
+- **ComfyUI バージョン**:ComfyUI のソースは新しい管理ディレクトリにステージングされ、以降の更新は Comfy Desktop が管理します。
-Legacy Desktop インストール自体は**変更されません**。システムにバックアップとして残ります。
+Legacy Desktop アプリ自体はインストールされたまま残り、Comfy Desktop は開始前にレガシー状態をバックアップします。移行はコピーではなくその場での再利用であるため、共有されるデータフォルダと Python 環境は未変更のコピーではありません。完全なコピーが必要な場合は、移行前にご自身でバックアップしてください。
## 移行後の変化
@@ -66,16 +67,16 @@ URL短縮サービスやブックマーク、外部連携で Legacy Desktop ア
-初めて Comfy Desktop を開くと、Legacy Desktop インストールを自動検出して移行を促します。
+初めて Comfy Desktop を開くと、初回セットアップがシステム上の Legacy Desktop インストールを自動検出します。**Local** を選択すると **Migrate existing instance** が選択済みの状態で表示され、続行すると既存の環境が引き継がれます。
-**Migrate Now** をクリックして移行を開始します:
+**Continue** を選択し、確認ダイアログで **Start Migration** を選びます。Comfy Desktop は次の処理を行います:
1. 既存のインストールをスキャン(カスタムノード、モデル、ワークフロー)
-2. 新しい Standalone インストールを作成(新規 Python 環境 + 最新 ComfyUI)
-3. ユーザーデータ(ワークフロー、設定など)をコピー
-4. 入力ファイルと出力結果をコピー
+2. 既存のデータフォルダと Python 環境をその場で再利用し、ComfyUI のソースを新しい管理ディレクトリにステージングして更新が正常に機能するようにします
+3. ワークフロー、設定、その他のユーザーデータをその場で再利用します
+4. 入力ファイルと出力結果をその場で再利用します
5. モデルフォルダを共有ディレクトリとして追加
6. 新しい環境にカスタムノードをインストール
@@ -91,17 +92,26 @@ URL短縮サービスやブックマーク、外部連携で Legacy Desktop ア
+## Chooser から移行する
+
+初回セットアップを完了済みの場合、または Legacy Desktop インストールがすでに Chooser に表示されている場合は、インスタンスカードから移行を開始できます:
+
+1. Legacy Desktop のインスタンスカードを探します。カードには **Migrate** ピルが表示されます。
+2. ピルをクリックするか、カードの **⋮** メニューから **Migrate to Standalone** を選択します。
+3. 確認ダイアログの内容を確認し、**Start Migration** を選択します。
+
+Legacy Desktop インストールはその場で採用され、Chooser に表示されるインスタンスは既存の環境を Comfy Desktop で管理するものになります。追跡中の Git および portable インストールの場合は代わりに新しい Standalone インストールが作成され、追跡元のインストールはそのまま残ります。どちらの場合もモデルファイルはコピーされず、元の場所から読み込まれます。
+
+更新が保留中の場合は更新ピルが優先され、**Migrate** は表示されません。
+
## トラブルシューティング
### Legacy Desktop が自動検出されない
-移行プロンプトが表示されない場合、手動で移行できます:
-
-1. Chooser ビューで **+** カードをクリック
-2. **Legacy Desktop** を選択
-3. Legacy Desktop インストールを選んでプロンプトに従う
+Legacy Desktop ソースは移行専用で、**新しいインスタンス** ピッカーに表示されないため手動で追加することはできません。Comfy Desktop が Legacy Desktop インストールを検出しなかった場合:
-既存のインストールが Chooser でまったく検出されない場合は、Manage パネルから直接追加することもできます。[**既存のインストールを追跡する**](/ja/installation/desktop/usage/instance-management#既存インストールの追跡) を参照してください。
+1. そのインストールを追跡インストールとして追加します。手順は [**既存のインストールを追跡する**](/ja/installation/desktop/usage/instance-management#既存インストールの追跡) を参照してください。
+2. Chooser に表示されたら、カードの **Migrate** ピル、または **⋮** メニューの **Migrate to Standalone** で移行します。
### 移行に失敗する
diff --git a/ko/installation/desktop/usage/migrate.mdx b/ko/installation/desktop/usage/migrate.mdx
index 75fb0cb623..aacde6c727 100644
--- a/ko/installation/desktop/usage/migrate.mdx
+++ b/ko/installation/desktop/usage/migrate.mdx
@@ -3,15 +3,16 @@ title: "Legacy Desktop에서 마이그레이션"
description: "Legacy Desktop 설치를 Comfy Desktop으로 마이그레이션하는 방법을 알아봅니다."
icon: "arrow-right"
sidebarTitle: "마이그레이션"
-translationSourceHash: b8c702d3
+translationSourceHash: b47dc646
translationFrom: installation/desktop/usage/migrate.mdx
translationBlockHashes:
"_intro": 14240c76
- "What Gets Migrated": 756473d1
+ "What Gets Migrated": 91f931e9
"What Changes After Migration": 1f09d2db
"Does My Old Link Still Work?": 528b3e43
- "Step-by-Step Migration": 61e3ac66
- "Troubleshooting": b48dfa6f
+ "Step-by-Step Migration": 8ea40634
+ "Migrate from the Chooser": 497be978
+ "Troubleshooting": a6cd9f9b
---
@@ -30,14 +31,14 @@ Legacy Desktop이 이미 설치되어 있다면 Comfy Desktop이 이를 감지
Legacy Desktop은 단일 설치 앱이었습니다. Comfy Desktop은 다중 설치 관리자입니다. 마이그레이션하면:
-- **워크플로와 설정** — 새로운 Standalone 설치로 복사됩니다.
+- **워크플로와 설정**: 기존 위치에서 그대로 재사용되어 새 인스턴스가 같은 사용자 데이터를 이어받습니다.
- **커스텀 노드** — 검사되어 새로운 환경에 재설치됩니다.
-- **모델** — 기존 모델 폴더가 공유 디렉터리로 추가됩니다(파일은 그대로 유지).
-- **입력 파일 및 출력** — 새로운 설치의 공유 디렉터리로 복사됩니다.
-- **Python 환경** — 새 Python 환경이 생성됩니다(Legacy의 번들 Python은 재사용되지 않음).
-- **ComfyUI 버전** — 최신 버전이 새 Standalone에 설치됩니다.
+- **모델**: 기존 모델 폴더가 공유 디렉터리로 추가되어 파일은 그대로 유지됩니다.
+- **입력 파일 및 출력**: 기존 폴더에서 그대로 재사용됩니다.
+- **Python 환경**: 기존 환경을 검증해 재사용하고, 그 안에 ComfyUI에 필요한 패키지를 설치합니다.
+- **ComfyUI 버전**: ComfyUI 소스가 새 관리 디렉터리에 스테이징되며, 이후 업데이트는 Comfy Desktop이 관리합니다.
-Legacy Desktop 설치 자체는 마이그레이션 중에 **수정되지 않습니다**. 백업으로 시스템에 남아 있습니다.
+Legacy Desktop 앱 자체는 설치된 상태로 남고, Comfy Desktop은 시작 전에 기존 상태를 백업합니다. 마이그레이션은 복사가 아니라 기존 환경을 그대로 재사용하므로, 공유되는 데이터 폴더와 Python 환경은 변경되지 않은 사본이 아닙니다. 온전한 사본이 필요하다면 마이그레이션 전에 직접 백업하세요.
## 마이그레이션 후 변경 사항
@@ -64,16 +65,16 @@ URL 단축기, 북마크, 또는 다른 주소로 Legacy Desktop 앱을 참조
-Comfy Desktop을 처음 열면 시스템의 Legacy Desktop 설치를 자동으로 감지하고 마이그레이션 프롬프트를 표시합니다.
+Comfy Desktop을 처음 열면 초기 설정이 시스템의 Legacy Desktop 설치를 자동으로 감지합니다. **Local**을 선택하면 **Migrate existing instance**가 기본 선택된 상태로 표시되며, 계속하면 기존 환경이 이전됩니다.
-**지금 마이그레이션**을 클릭하여 진행합니다. Comfy Desktop이 다음을 수행합니다:
+**Continue**를 선택한 뒤 확인 대화상자에서 **Start Migration**을 선택합니다. Comfy Desktop이 다음을 수행합니다:
1. 기존 설치 검사(커스텀 노드, 모델, 워크플로)
-2. 새 Python 환경과 최신 ComfyUI로 새로운 Standalone 설치 생성
-3. 사용자 데이터(워크플로, 설정 등) 복사
-4. 입력 파일 및 출력 복사
+2. 기존 데이터 폴더와 Python 환경을 그대로 재사용하고, ComfyUI 소스를 새 관리 디렉터리에 스테이징하여 업데이트가 정상 동작하도록 합니다
+3. 워크플로, 설정 및 기타 사용자 데이터를 그대로 재사용합니다
+4. 입력 파일과 출력을 그대로 재사용합니다
5. 모델 폴더를 공유 디렉터리로 추가
6. 새 환경에 커스텀 노드 설치
@@ -89,17 +90,26 @@ Comfy Desktop을 처음 열면 시스템의 Legacy Desktop 설치를 자동으
+## Chooser에서 마이그레이션하기
+
+초기 설정을 이미 완료했거나 Legacy Desktop 설치가 Chooser에 이미 표시되어 있다면 인스턴스 카드에서 마이그레이션을 시작할 수 있습니다:
+
+1. Legacy Desktop 인스턴스 카드를 찾습니다. 카드에 **Migrate** 알약이 표시됩니다.
+2. 알약을 클릭하거나 카드의 **⋮** 메뉴에서 **Migrate to Standalone**을 선택합니다.
+3. 확인 대화상자의 내용을 검토한 뒤 **Start Migration**을 선택합니다.
+
+Legacy Desktop 설치는 기존 위치에서 그대로 인수되며, Chooser에 표시되는 인스턴스는 기존 환경을 Comfy Desktop에서 관리하는 형태가 됩니다. 추적 중인 Git 및 portable 인스턴스는 대신 새 Standalone 설치가 만들어지고 추적 대상 설치는 그대로 남습니다. 두 경우 모두 모델 파일은 복사되지 않고 원래 위치에서 읽습니다.
+
+업데이트가 대기 중이면 업데이트 알약이 우선 표시되며 **Migrate**는 표시되지 않습니다.
+
## 문제 해결
### Legacy Desktop이 자동으로 감지되지 않는 경우
-마이그레이션 프롬프트가 나타나지 않으면 수동으로 마이그레이션할 수 있습니다:
-
-1. Chooser 뷰에서 **+** 카드를 클릭합니다.
-2. **Legacy Desktop**을 선택합니다.
-3. Legacy Desktop 설치를 선택하고 안내를 따릅니다.
+Legacy Desktop 소스는 마이그레이션 전용이며 **새 인스턴스** 선택기에 표시되지 않으므로 직접 추가할 수 없습니다. Comfy Desktop이 Legacy Desktop 설치를 감지하지 못한 경우:
-Chooser에서 기존 설치가 전혀 감지되지 않은 경우 Manage 패널을 통해 직접 추가할 수도 있습니다. 자세한 내용은 [**기존 설치 추적**](/ko/installation/desktop/usage/instance-management#기존-설치-추적하기)을 참조하세요.
+1. 해당 설치를 추적 인스턴스로 추가합니다. 자세한 내용은 [**기존 설치 추적**](/ko/installation/desktop/usage/instance-management#기존-설치-추적하기)을 참조하세요.
+2. Chooser에 표시되면 카드의 **Migrate** 알약 또는 **⋮** 메뉴의 **Migrate to Standalone**으로 마이그레이션합니다.
### 마이그레이션 실패
diff --git a/snippets/desktop/migrate.mdx b/snippets/desktop/migrate.mdx
index 9c707ac978..f10d5e5b6f 100644
--- a/snippets/desktop/migrate.mdx
+++ b/snippets/desktop/migrate.mdx
@@ -1,5 +1,5 @@
-**Already using Legacy Desktop?** Comfy Desktop can automatically detect and migrate your existing installation. Your custom nodes, workflows, models, and settings are carried over — nothing is lost. The legacy installation is kept untouched as a backup.
+**Already using Legacy Desktop?** Comfy Desktop can automatically detect and migrate your existing installation. Your custom nodes, workflows, models, and settings are carried over, and Comfy Desktop backs up your legacy state before it starts. The migration reuses your existing data folder and Python environment in place, so back them up yourself if you need a pristine copy.
Learn more in the [Migrate from Legacy](/installation/desktop/usage/migrate) guide.
diff --git a/snippets/ja/desktop/migrate.mdx b/snippets/ja/desktop/migrate.mdx
index 41b24a010f..7210594c60 100644
--- a/snippets/ja/desktop/migrate.mdx
+++ b/snippets/ja/desktop/migrate.mdx
@@ -1,6 +1,6 @@
-{/* translationSourceHash: 6fdf6c24 */}
+{/* translationSourceHash: f0a3c3d9 */}
-**すでに Desktop Legacy をお使いですか?** Comfy Desktop は既存のインストールを自動検出して移行できます。カスタムノード、ワークフロー、モデル、設定はすべて引き継がれます。レガシーインストールはバックアップとしてそのまま残ります。
+**すでに Legacy Desktop をお使いですか?** Comfy Desktop は既存のインストールを自動検出して移行できます。カスタムノード、ワークフロー、モデル、設定はすべて引き継がれ、Comfy Desktop が開始前にレガシー状態をバックアップします。移行では既存のデータフォルダと Python 環境をその場で再利用するため、完全なコピーが必要な場合は事前にご自身でバックアップしてください。
詳細は[レガシーからの移行](/ja/installation/desktop/usage/migrate)ガイドをご覧ください。
\ No newline at end of file
diff --git a/snippets/ko/desktop/migrate.mdx b/snippets/ko/desktop/migrate.mdx
index 2e422376e4..e137eeae6e 100644
--- a/snippets/ko/desktop/migrate.mdx
+++ b/snippets/ko/desktop/migrate.mdx
@@ -1,6 +1,6 @@
-{/* translationSourceHash: 6fdf6c24 */}
+{/* translationSourceHash: f0a3c3d9 */}
-**이미 Legacy Desktop을 사용 중이신가요?** Comfy Desktop은 기존 설치를 자동으로 감지하고 마이그레이션할 수 있습니다. 커스텀 노드, 워크플로, 모델, 설정이 모두 이전되며 아무것도 손실되지 않습니다. 레거시 설치는 백업으로 그대로 유지됩니다.
+**이미 Legacy Desktop을 사용 중이신가요?** Comfy Desktop은 기존 설치를 자동으로 감지하고 마이그레이션할 수 있습니다. 커스텀 노드, 워크플로, 모델, 설정이 모두 이전되며, Comfy Desktop이 시작 전에 레거시 상태를 백업합니다. 마이그레이션은 기존 데이터 폴더와 Python 환경을 그대로 재사용하므로, 온전한 사본이 필요하다면 미리 직접 백업하세요.
자세한 내용은 [레거시에서 마이그레이션](/ko/installation/desktop/usage/migrate) 가이드를 참고하세요.
\ No newline at end of file
diff --git a/snippets/zh/desktop/migrate.mdx b/snippets/zh/desktop/migrate.mdx
index 5c8cea9723..8644aaf5bd 100644
--- a/snippets/zh/desktop/migrate.mdx
+++ b/snippets/zh/desktop/migrate.mdx
@@ -1,6 +1,6 @@
-{/* translationSourceHash: 6fdf6c24 */}
+{/* translationSourceHash: f0a3c3d9 */}
-**已经在用 Desktop Legacy?** Comfy Desktop 可以自动检测并迁移你现有的安装。自定义节点、工作流、模型和设置都会一并纳入——不会有任何丢失。旧版安装会保留不变作为备份。
+**已经在用 Legacy Desktop?** Comfy Desktop 可以自动检测并迁移你现有的安装。自定义节点、工作流、模型和设置都会一并纳入,Comfy Desktop 也会在开始前备份旧版状态。迁移会就地复用你现有的数据文件夹和 Python 环境,如果需要保留一份完整副本,请自行提前备份。
了解更多,请查阅[从旧版迁移](/zh/installation/desktop/usage/migrate)指南。
\ No newline at end of file
diff --git a/zh/installation/desktop/usage/migrate.mdx b/zh/installation/desktop/usage/migrate.mdx
index cdbe0e5e65..c77c44b3ba 100644
--- a/zh/installation/desktop/usage/migrate.mdx
+++ b/zh/installation/desktop/usage/migrate.mdx
@@ -3,15 +3,16 @@ title: "从 Legacy Desktop 迁移"
description: "了解如何将您的 Legacy Desktop 安装迁移到 Comfy Desktop"
icon: "arrow-right"
sidebarTitle: "迁移"
-translationSourceHash: b8c702d3
+translationSourceHash: b47dc646
translationFrom: installation/desktop/usage/migrate.mdx
translationBlockHashes:
"_intro": 14240c76
- "What Gets Migrated": 756473d1
+ "What Gets Migrated": 91f931e9
"What Changes After Migration": 1f09d2db
"Does My Old Link Still Work?": 528b3e43
- "Step-by-Step Migration": 61e3ac66
- "Troubleshooting": b48dfa6f
+ "Step-by-Step Migration": 8ea40634
+ "Migrate from the Chooser": 497be978
+ "Troubleshooting": a6cd9f9b
---
@@ -30,14 +31,14 @@ translationBlockHashes:
Legacy Desktop 是单实例应用。Comfy Desktop 是多实例管理器。迁移时:
-- **工作流和设置** — 复制到新的 Standalone 安装
+- **工作流和设置**:就地复用,新实例沿用同一份用户数据。
- **自定义节点** — 扫描后在新环境中重新安装
-- **模型** — 您原有的模型文件夹被添加为共享目录(文件保留在原位置)
-- **输入文件和输出** — 复制到新安装的共享目录
-- **Python 环境** — 创建全新的 Python 环境(Legacy 自带的 Python 不会被重复使用)
-- **ComfyUI 版本** — 新 Standalone 中安装最新版本
+- **模型**:您原有的模型文件夹被添加为共享目录,文件保留在原位置。
+- **输入文件和输出**:就地复用现有目录中的文件。
+- **Python 环境**:验证并复用您现有的环境,并在其中安装 ComfyUI 所需的依赖包。
+- **ComfyUI 版本**:ComfyUI 源码会被暂存到新的托管目录中,之后由 Comfy Desktop 管理更新。
-Legacy Desktop 安装本身在迁移过程中**不会被修改**。它保留在您的系统中作为备份。
+Legacy Desktop 应用本身会保留在系统中,Comfy Desktop 会在迁移开始前先备份旧版状态。迁移是就地复用这套环境而不是复制,因此共享的数据文件夹和 Python 环境并不是一份未被改动的副本。如果需要保留一份完整的旧版副本,请在迁移前自行备份。
## 迁移后的变化
@@ -64,16 +65,16 @@ Legacy Desktop 默认在端口 `8000` 上运行。新安装会**继承端口**
-首次打开 Comfy Desktop 时,它会自动检测您系统中的 Legacy Desktop 安装并显示迁移提示。
+首次打开 Comfy Desktop 时,首次运行设置会自动检测系统中的 Legacy Desktop 安装。选择**本地**后,设置中会显示**迁移现有实例**并默认选中,继续后即可迁移您现有的环境。
-点击 **Migrate Now** 继续。Comfy Desktop 将:
+点击**继续**,然后在确认对话框中选择**开始迁移**。Comfy Desktop 将:
1. 扫描现有安装(自定义节点、模型、工作流)
-2. 创建新的 Standalone 安装,包含全新的 Python 环境和最新 ComfyUI
-3. 复制用户数据(工作流、设置等)
-4. 复制输入文件和输出
+2. 就地复用您现有的数据文件夹和 Python 环境,并把 ComfyUI 源码暂存到新的托管目录,以便更新正常工作
+3. 就地复用您的工作流、设置和其他用户数据
+4. 就地复用您的输入文件和输出
5. 将模型文件夹添加为共享目录
6. 在新环境中安装自定义节点
@@ -89,17 +90,26 @@ Legacy Desktop 默认在端口 `8000` 上运行。新安装会**继承端口**
+## 从 Chooser 中迁移
+
+如果您已经完成首次运行设置,或 Legacy Desktop 安装已出现在 Chooser 中,可以直接从实例卡片发起迁移:
+
+1. 找到 Legacy Desktop 实例卡片,卡片上带有**迁移**胶囊按钮。
+2. 点击该胶囊按钮,或打开卡片的 **⋮** 菜单并选择**迁移到独立版**。
+3. 确认弹窗中的改动后,点击**开始迁移**。
+
+Legacy Desktop 安装会被就地接管,出现在 Chooser 中的实例就是您现有环境在 Comfy Desktop 下的托管版本。已跟踪的 Git 和 portable 实例则不同,迁移会新建一个 Standalone 安装,原跟踪安装保持原样。两种情况都不会复制模型文件,而是直接从原位置读取。
+
+待更新状态优先:这类卡片会显示更新胶囊按钮,而不是**迁移**。
+
## 故障排查
### Legacy Desktop 未自动检测到
-如果未出现迁移提示,您可以手动迁移:
-
-1. 在 Chooser 视图中点击 **+** 卡片
-2. 选择 **Legacy Desktop**
-3. 选择您的 Legacy Desktop 安装并按照提示操作
+Legacy Desktop 源仅用于迁移,不会出现在**新建实例**选择器中,因此无法手动添加。如果 Comfy Desktop 没有检测到您的 Legacy Desktop 安装:
-如果您的现有安装完全未被 Chooser 检测到,您也可以通过 Manage 面板直接添加。有关说明,请参阅 [**追踪已有安装**](/zh/installation/desktop/usage/instance-management#追踪已有安装)。
+1. 将该安装作为已跟踪实例添加。参见 [**追踪已有安装**](/zh/installation/desktop/usage/instance-management#追踪已有安装)。
+2. 实例出现在 Chooser 后,通过卡片上的**迁移**胶囊按钮或 **⋮** 菜单中的**迁移到独立版**进行迁移。
### 迁移失败