diff --git a/es/installation/desktop/usage/migrate.mdx b/es/installation/desktop/usage/migrate.mdx index 80da69263e..20e88fa07d 100644 --- a/es/installation/desktop/usage/migrate.mdx +++ b/es/installation/desktop/usage/migrate.mdx @@ -3,16 +3,18 @@ title: "Migrar desde Legacy Desktop" description: "Aprende a migrar tu instalación de Legacy Desktop a Comfy Desktop" icon: "arrow-right" sidebarTitle: "Migrar" -translationSourceHash: 5f3f3100 +translationSourceHash: 61722fce translationFrom: installation/desktop/usage/migrate.mdx translationBlockHashes: "_intro": 14240c76 - "What Gets Migrated": 91f931e9 - "What Changes After Migration": 1f09d2db + "What Gets Migrated": 765895d5 + "What Migration Backs Up": ee11ab03 + "What Happens While Migration Runs": 250e4c95 + "What Changes After Migration": eae3f0a4 "Does My Old Link Still Work?": 528b3e43 - "Step-by-Step Migration": d15dfd28 - "Migrate from the Chooser": 9517089b - "Troubleshooting": a6cd9f9b + "Step-by-Step Migration": 0097aff9 + "Migrate from the Chooser": 384ed466 + "Troubleshooting": 787c900c --- @@ -32,25 +34,67 @@ Si ya tienes Legacy Desktop instalado, Comfy Desktop puede detectarlo y migrarlo Legacy Desktop era una aplicación de instalación única. Comfy Desktop es un administrador de múltiples instalaciones. Cuando migras: - **Flujos de trabajo y configuraciones**: se reutilizan en el mismo lugar, por lo que la nueva instancia conserva los mismos datos de usuario. -- **Nodos personalizados**: se escanean y se reinstalan en el nuevo entorno. -- **Modelos**: tu carpeta de modelos existente se agrega como un directorio compartido, por lo que los archivos permanecen donde están. +- **Nodos personalizados**: se quedan en tu carpeta `custom_nodes` existente. La instalación migrada usa tu carpeta de datos de Legacy Desktop como directorio base, así que carga los mismos nodos, y sus paquetes permanecen en el entorno de Python que se reutiliza. +- **Modelos**: tu carpeta de modelos existente se agrega a los directorios de modelos compartidos, para que todas las instalaciones puedan leer esos archivos donde ya están. - **Archivos de entrada y salidas**: se reutilizan en el mismo lugar desde las carpetas existentes. -- **Entorno de Python**: tu entorno existente se valida y se reutiliza, con los paquetes que ComfyUI necesita instalados en él. +- **Entorno de Python**: tu entorno existente se valida y luego se reutiliza. Comfy Desktop comprueba que puede importar torch y después instala en él los requisitos propios de ComfyUI sin reemplazar tus paquetes de PyTorch. - **Versión de ComfyUI**: la fuente de ComfyUI se prepara en un nuevo directorio administrado, de modo que Comfy Desktop administra las actualizaciones a partir de entonces. -La aplicación Legacy Desktop permanece instalada, y Comfy Desktop hace una copia de seguridad de tu estado de Legacy Desktop antes de iniciarse. La migración reutiliza esa configuración en el mismo lugar en vez de copiarla, por lo que la carpeta de datos compartida y el entorno de Python no son una copia intacta. Si necesitas una copia original sin modificar de tu configuración de Legacy Desktop, haz una copia de seguridad por tu cuenta antes de migrar. +La migración reutiliza tu carpeta de datos y tu entorno de Python de Legacy Desktop en el mismo lugar en vez de copiarlos, así que acabas con un único entorno en uso y no con una segunda copia. Si necesitas una copia original sin modificar de tu configuración de Legacy Desktop, haz una copia de seguridad por tu cuenta antes de migrar. + +## Qué se incluye en la copia de seguridad + +Antes de cambiar nada, Comfy Desktop copia los archivos de configuración de Legacy Desktop en una carpeta con fecha dentro de la carpeta de configuración de Legacy Desktop: + +- macOS: `~/Library/Application Support/ComfyUI/legacy-backup//` +- Windows: `%APPDATA%\ComfyUI\legacy-backup\\` + +Solo se copian los archivos que existen: + +- `config.json`: la configuración de la aplicación Legacy Desktop, incluida la carpeta de datos que usaba. +- `comfy.settings.json`: la configuración del frontend de ComfyUI guardada en tu carpeta de usuario de Legacy Desktop. +- `extra_models_config.yaml`: las rutas de modelos adicionales que configuraste en Legacy Desktop. +- `window.json`: el tamaño y la posición de la ventana guardados. + +La copia contiene solo configuración. Los modelos, flujos de trabajo, nodos personalizados, archivos de entrada y salidas no se copian en ella, porque la instalación migrada sigue usándolos donde están. La migración también escribe una instantánea del entorno de Legacy Desktop, con sus nodos personalizados y paquetes instalados, en `.snapshots/` dentro de tu carpeta de datos de Legacy Desktop. + +Si un archivo no se puede copiar, la migración lo anota en el registro y continúa, así que un fallo de la copia no detiene la migración. + +## Qué ocurre durante la migración + +La migración muestra su propia pantalla de progreso y avanza por estos pasos: + +1. **Back up legacy state** +2. **Check folder access** (solo macOS) +3. **Validate Python environment** +4. **Capture snapshot** +5. **Allocate install folder** +6. **Stage ComfyUI source code** +7. **Install requirements** +8. **Carry over settings** +9. **Register installation** + +Algunos pasos se detienen a esperar una respuesta: + +- **Folder access needed** (macOS): macOS bloqueó el acceso a la carpeta de Legacy Desktop. Concede a Comfy Desktop el acceso a todo el disco en Ajustes del Sistema → Privacidad y seguridad y vuelve a iniciar la migración. +- **Python environment looks broken**: el entorno de Legacy Desktop no pudo importar torch. Selecciona **Adopt anyway** para seguir con ese entorno o **Cancel** para detenerte. +- **ComfyUI source code unavailable**: no se pudo obtener el código fuente de ComfyUI para la nueva instalación. Selecciona **Retry**, o **Cancel** y crea una instalación nueva desde el panel. + +La pantalla guarda la salida de cada paso en un panel **View logs** que se abre solo cuando un paso falla. Copia el texto con el botón de copiar del panel, o lee la misma salida en el registro de la aplicación de Desktop. Un fallo al instalar los requisitos se registra como aviso y no detiene la migración. ## Qué cambia después de la migración Una vez que se completa la migración, tu nueva instalación Standalone funciona como cualquier otra instalación de Comfy Desktop: - **Inicio**: haz clic en el botón Reproducir de la tarjeta de la nueva instalación en la vista Selector para iniciar ComfyUI. -- **Puerto**: Legacy Desktop usaba el puerto `8000` de forma predeterminada. La nueva instalación conserva esta configuración de puerto (y cualquier otro argumento de inicio personalizado que tuvieras). +- **Puerto**: el puerto y cualquier otro argumento de inicio personalizado de tu configuración de Legacy Desktop se conservan. - **Administrar**: usa el panel Administrar para actualizar, tomar instantáneas y configurar la instalación. - **Actualizaciones**: las instalaciones Standalone se pueden actualizar de forma independiente a través del panel Administrar. A diferencia de Legacy Desktop, ya no necesitas descargar una nueva compilación para cada actualización. - **Varias instancias**: puedes tener varias instalaciones Standalone en paralelo, cada una con su propia versión de ComfyUI y su propia configuración. - **Almacenamiento compartido**: los modelos se comparten entre todas las instalaciones Standalone de forma predeterminada. Los directorios de entrada y salida están fijados al espacio de trabajo de Legacy Desktop adoptado, para que tus archivos existentes permanezcan donde están. +Una instancia migrada no actualiza ComfyUI por su cuenta. Usa la [pestaña Actualizar](/es/installation/desktop/usage/manage#pestaña-actualizar) del panel Administrar cuando quieras una versión de ComfyUI más reciente. + ## ¿Mi enlace anterior sigue funcionando? Legacy Desktop se ejecutaba en el puerto `8000` de forma predeterminada. La nueva instalación **conserva el puerto** de tu configuración de Legacy Desktop, así que `http://localhost:8000` debería seguir funcionando. Si tenías argumentos de CLI personalizados configurados (por ejemplo, `--port 8188`), esos también se conservan. @@ -71,14 +115,11 @@ Cuando abras Comfy Desktop por primera vez, la configuración inicial detecta cu -Selecciona **Continuar** y luego confirma **Migrar Legacy Desktop a Standalone** con **Iniciar migración**. Comfy Desktop hará lo siguiente: +Selecciona **Continuar** y luego confirma **Migrar a Standalone** con **Iniciar migración**. Comfy Desktop hará lo siguiente: -1. Analizar tu instalación existente (nodos personalizados, modelos, flujos de trabajo) -2. Reutilizar tu carpeta de datos y tu entorno de Python existentes en su lugar, y preparar el código fuente de ComfyUI en un nuevo directorio gestionado para que las actualizaciones funcionen con normalidad -3. Reutilizar tus flujos de trabajo, configuraciones y otros datos de usuario en su lugar -4. Reutilizar tus archivos de entrada y tus salidas en su lugar -5. Agregar tu carpeta de modelos como directorio compartido -6. Instalar los nodos personalizados en el nuevo entorno +1. Reutilizar tus flujos de trabajo, configuraciones, nodos personalizados, entradas y salidas en su lugar +2. Reutilizar tu entorno de Python y preparar el código fuente de ComfyUI en un nuevo directorio gestionado para que las actualizaciones funcionen con normalidad +3. Agregar tu carpeta de modelos como directorio compartido e instalar los requisitos de ComfyUI en el entorno reutilizado Al finalizar, la nueva tarjeta de instalación Standalone aparece en la vista del selector. @@ -108,7 +149,7 @@ Si ya finalizaste la configuración inicial, o la instalación de Legacy Desktop ![Confirmación para migrar Legacy Desktop a Standalone con Start Migration](/images/desktop/usage/migrate_04_confirm.png) -Una instalación de Legacy Desktop se adopta en su ubicación actual, por lo que la instancia que aparece es tu configuración existente bajo la gestión de Comfy Desktop. En cambio, migrar una instalación registrada de Git o portable crea una nueva instancia Standalone y deja la instalación registrada en su lugar. En ambos casos, la aplicación no copia los archivos de modelo; los lee desde donde ya están. +Una instalación de Legacy Desktop se adopta en su ubicación actual, por lo que la instancia que aparece es tu configuración existente bajo la gestión de Comfy Desktop. En cambio, migrar una instalación registrada de Git o portable crea una nueva instancia Standalone y deja la instalación registrada en su lugar. Una actualización pendiente tiene prioridad en esas tarjetas: muestran el distintivo de actualización en lugar de **Migrate**. @@ -123,14 +164,18 @@ La fuente Legacy Desktop es solo para migración y no aparece en el selector de ### La migración falla -- **Revisa los registros** en la pestaña Terminal del panel Administrar para ver los detalles del error -- **Asegúrate de que tu instalación de Legacy Desktop esté intacta**: la migración lee desde tu instalación existente -- **Inténtalo de nuevo**: los problemas de red pueden resolverse en un segundo intento +- **Revisa el registro**: selecciona **View logs** en la pantalla de migración, o abre el registro de la aplicación de Desktop (`app.log`) en `~/Library/Logs/Comfy Desktop` (macOS) o `%APPDATA%\Comfy Desktop\logs` (Windows). +- **Comprueba que la instalación de Legacy Desktop está completa**: la migración lee modelos, flujos de trabajo y nodos personalizados de la carpeta existente, así que una carpeta movida o eliminada la detiene. +- **Inténtalo de nuevo**: un problema de red puede detener el paso de preparación del código fuente, y un segundo intento puede funcionar. + +### La migración se detuvo antes de terminar + +Si seleccionas **Cancel** en uno de los avisos, la ejecución se detiene, y lo mismo ocurre si un paso falla de forma clara. Un aviso de instalación de requisitos no la detiene. Una ejecución detenida no agrega una instancia al Selector, así que inicia la migración otra vez desde el distintivo **Migrate** de la tarjeta. Tu carpeta de Legacy Desktop no se elimina. ### Modelos faltantes después de la migración -Los modelos se agregan como una ruta de directorio compartida (no se copian). Si los modelos no aparecen: +Los modelos se agregan a los directorios de modelos compartidos, no se copian. Si los modelos no aparecen: -1. Abre el panel **Administrar** de la instalación migrada -2. Ve a la pestaña **Almacenamiento** y abre **Directorios de modelos** -3. Comprueba si tu carpeta de modelos antigua aparece en la lista. Si no es así, agrégala manualmente. +1. Abre [Desktop Settings → Storage](/es/installation/desktop/usage/settings#almacenamiento) +2. Comprueba que tu carpeta de modelos anterior y las rutas de modelos adicionales indicadas en el `extra_models_config.yaml` de Legacy Desktop están en los directorios compartidos. Si falta alguna, selecciona **+ Add Shared Directory** y elígela. +3. En el panel Administrar de la instancia migrada, abre la pestaña **Almacenamiento** y asegúrate de que **Include Shared Directories** está activado. diff --git a/installation/desktop/usage/migrate.mdx b/installation/desktop/usage/migrate.mdx index da8f1b65f7..a23096864a 100644 --- a/installation/desktop/usage/migrate.mdx +++ b/installation/desktop/usage/migrate.mdx @@ -22,25 +22,67 @@ 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**: 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, so the files stay where they are. +- **Custom nodes**: kept in your existing `custom_nodes` folder. The migrated instance uses your Legacy Desktop data folder as its base directory, so it loads the same nodes, and their packages stay in the Python environment that is reused. +- **Models**: your existing model folder is added to the shared model directories, so every instance can read those files where they already 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. +- **Python environment**: your existing environment is checked and then reused. Comfy Desktop verifies that it can import torch, then installs ComfyUI's requirements into it without replacing your PyTorch packages. - **ComfyUI version**: the ComfyUI source is staged into a new managed directory, so Comfy Desktop manages updates from then on. -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. +The migration reuses your Legacy Desktop data folder and Python environment in place rather than copying them, so you end up with one working setup rather than a second copy. If you need a pristine copy of your Legacy Desktop setup, back it up yourself before migrating. + +## What Migration Backs Up + +Before it changes anything, Comfy Desktop copies the Legacy Desktop settings files into a dated folder inside the legacy config folder: + +- macOS: `~/Library/Application Support/ComfyUI/legacy-backup//` +- Windows: `%APPDATA%\ComfyUI\legacy-backup\\` + +Each file is copied only if it exists: + +- `config.json`: the Legacy Desktop app settings, including the data folder it used. +- `comfy.settings.json`: the ComfyUI frontend settings stored in your legacy user folder. +- `extra_models_config.yaml`: any extra model paths you configured in Legacy Desktop. +- `window.json`: the saved window size and position. + +The backup holds settings only. Models, workflows, custom nodes, input files, and outputs are not copied into it, because the migrated instance keeps using them where they are. The migration also writes a snapshot of the legacy environment, with its custom nodes and installed packages, to `.snapshots/` inside your legacy data folder. + +If a file cannot be copied, the migration notes it in the log and continues, so a failed backup does not stop the migration. + +## What Happens While Migration Runs + +The migration shows its own progress screen and moves through these steps: + +1. **Back up legacy state** +2. **Check folder access** (macOS only) +3. **Validate Python environment** +4. **Capture snapshot** +5. **Allocate install folder** +6. **Stage ComfyUI source code** +7. **Install requirements** +8. **Carry over settings** +9. **Register installation** + +A step can stop and wait for an answer: + +- **Folder access needed** (macOS): macOS blocked access to the Legacy Desktop folder. Grant Comfy Desktop Full Disk Access in System Settings → Privacy & Security, then start the migration again. +- **Python environment looks broken**: the legacy environment could not import torch. Select **Adopt anyway** to keep that environment, or **Cancel** to stop. +- **ComfyUI source code unavailable**: the ComfyUI source for the new instance could not be obtained. Select **Retry**, or **Cancel** and create a new instance from the dashboard instead. + +The screen keeps the output of every step in a **View logs** panel that opens by itself when a step fails. Copy the text with the copy button there, or read the same output in the Desktop app log. A failed requirements install is reported as a warning and does not stop the migration. ## What Changes After Migration Once migration completes, your new Standalone installation works like any other Comfy Desktop installation: - **Startup** — click the play button on the new installation card in the Chooser view to launch ComfyUI. -- **Port** — Legacy Desktop used port `8000` by default. The new installation carries over this port setting (and any other custom startup arguments you had). +- **Port** — the port and any other custom startup arguments from your legacy config are carried over. - **Manage** — use the Manage panel to update, snapshot, and configure the installation. - **Updates** — Standalone installations can be updated independently via the Manage panel. Unlike Legacy Desktop, you no longer need to download a new build for each update. - **Multiple instances** — you can have multiple Standalone installations side by side, each with its own ComfyUI version and configuration. - **Shared storage** — models are shared across all Standalone installations by default. Input and output directories are pinned to the adopted legacy workspace so your existing files stay where they are. +A migrated instance does not update ComfyUI on its own. Use the Manage panel's [Update tab](/installation/desktop/usage/manage#update-tab) when you want a newer ComfyUI version. + ## Does My Old Link Still Work? Legacy Desktop ran on port `8000` by default. The new installation **carries over the port** from your legacy config, so `http://localhost:8000` should still work. If you had custom CLI arguments configured (e.g. `--port 8188`), those are carried over too. @@ -61,14 +103,11 @@ When you first open Comfy Desktop, the first-run setup detects any Legacy Deskto -Select **Continue**, then confirm **Migrate Legacy Desktop to Standalone** with **Start Migration**. Comfy Desktop will: +Select **Continue**, then confirm **Migrate to Standalone** with **Start Migration**. Comfy Desktop will: -1. Scan your existing installation (custom nodes, models, workflows) -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 +1. Reuse your workflows, settings, custom nodes, inputs, and outputs in place +2. Reuse your Python environment and stage the ComfyUI source into a new managed directory so updates work normally +3. Add your model folder as a shared directory and install ComfyUI's requirements into the reused environment After completion, the new Standalone installation card appears in the Chooser view. @@ -98,7 +137,7 @@ If you have already finished the first-run setup, or the Legacy Desktop installa ![Migrate Legacy Desktop to Standalone confirmation with Start Migration](/images/desktop/usage/migrate_04_confirm.png) -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 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. A pending update takes priority on those cards: they show the update pill instead of **Migrate**. @@ -113,14 +152,18 @@ The Legacy Desktop source is migration-only and is not listed in the New Instanc ### Migration fails -- **Check logs** in the Manage panel's Terminal tab for error details -- **Ensure your Legacy installation is intact**: migration reads from your existing install -- **Try again**: network issues may resolve on a second attempt +- **Read the log**: select **View logs** in the migration window, or open the Desktop app log (`app.log`) in `~/Library/Logs/Comfy Desktop` on macOS or `%APPDATA%\Comfy Desktop\logs` on Windows. +- **Check the Legacy installation**: the migration reads models, workflows, and custom nodes from the existing folder, so a folder that was moved or deleted stops it. +- **Try again**: a network problem can stop the source staging step, and a second attempt may succeed. + +### The migration stopped before it finished + +Selecting **Cancel** in one of the prompts stops the run, and so does a step that fails outright. A requirements warning does not stop it. A stopped run does not add an instance to the Chooser, so start the migration again from the card's **Migrate** pill. Your Legacy Desktop folder is not deleted. ### Models missing after migration -Models are added as a shared directory path (not copied). If models don't appear: +Models are added to the shared model directories, not copied. If models do not show: -1. Open the migrated installation's **Manage** panel -2. Go to the **Storage** tab and open **Model Directories** -3. Check if your old model folder is listed. If not, add it manually. +1. Open [Desktop Settings → Storage](/installation/desktop/usage/settings#storage) +2. Check that your legacy models folder and any extra model paths listed in your Legacy Desktop `extra_models_config.yaml` are in the shared directories. If one is missing, select **+ Add Shared Directory** and pick it. +3. In the migrated instance's Manage panel, open the **Storage** tab and make sure **Include Shared Directories** is on. diff --git a/ja/installation/desktop/usage/migrate.mdx b/ja/installation/desktop/usage/migrate.mdx index f357e8dc98..aa521d9e30 100644 --- a/ja/installation/desktop/usage/migrate.mdx +++ b/ja/installation/desktop/usage/migrate.mdx @@ -3,16 +3,18 @@ title: "Legacy Desktop からの移行" description: "Legacy Desktop インストールを Comfy Desktop に移行する方法" icon: "arrow-right" sidebarTitle: "移行" -translationSourceHash: 5f3f3100 +translationSourceHash: 61722fce translationFrom: installation/desktop/usage/migrate.mdx translationBlockHashes: "_intro": 14240c76 - "What Gets Migrated": 91f931e9 - "What Changes After Migration": 1f09d2db + "What Gets Migrated": 765895d5 + "What Migration Backs Up": ee11ab03 + "What Happens While Migration Runs": 250e4c95 + "What Changes After Migration": eae3f0a4 "Does My Old Link Still Work?": 528b3e43 - "Step-by-Step Migration": d15dfd28 - "Migrate from the Chooser": 9517089b - "Troubleshooting": a6cd9f9b + "Step-by-Step Migration": 0097aff9 + "Migrate from the Chooser": 384ed466 + "Troubleshooting": 787c900c --- @@ -32,25 +34,67 @@ Legacy Desktop をすでにインストールしている場合、Comfy Desktop Legacy Desktop はシングルインストールのアプリです。Comfy Desktop はマルチインストールマネージャーです。移行時: - **ワークフローと設定**:その場で再利用され、新しいインストールが同じユーザーデータを引き継ぎます。 -- **カスタムノード**:スキャン後、新しい環境で再インストール -- **モデル**:既存のモデルフォルダが共有ディレクトリとして追加され、ファイルは元の場所に残ります。 +- **カスタムノード**:既存の `custom_nodes` フォルダにそのまま残ります。移行後のインストールは Legacy Desktop のデータフォルダをベースディレクトリとして実行されるため、同じノードが読み込まれ、そのパッケージも再利用される Python 環境に残ります。 +- **モデル**:既存のモデルフォルダが共有モデルディレクトリに追加され、すべてのインストールが元の場所にあるファイルを読み取れます。 - **入力ファイルと出力結果**:既存のフォルダからその場で再利用されます。 -- **Python 環境**:既存の環境を検証して再利用し、その中に ComfyUI が必要とするパッケージをインストールします。 +- **Python 環境**:既存の環境を検証してから再利用します。Comfy Desktop は torch をインポートできることを確認し、その後 ComfyUI 自体の依存関係をその環境にインストールします。既存の PyTorch パッケージは置き換えません。 - **ComfyUI バージョン**:ComfyUI のソースは新しい管理ディレクトリにステージングされ、以降の更新は Comfy Desktop が管理します。 -Legacy Desktop アプリ自体はインストールされたまま残り、Comfy Desktop は開始前にレガシー状態をバックアップします。移行はコピーではなくその場での再利用であるため、共有されるデータフォルダと Python 環境は未変更のコピーではありません。完全なコピーが必要な場合は、移行前にご自身でバックアップしてください。 +移行は Legacy Desktop のデータフォルダと Python 環境をコピーせずにその場で再利用するため、2 つ目のコピーではなく 1 つの動作中の環境が残ります。完全なコピーが必要な場合は、移行前にご自身でバックアップしてください。 + +## 移行時にバックアップされる内容 + +変更を加える前に、Comfy Desktop は Legacy Desktop の設定ファイルを、レガシー設定フォルダ内の日時付きフォルダにコピーします: + +- macOS:`~/Library/Application Support/ComfyUI/legacy-backup//` +- Windows:`%APPDATA%\ComfyUI\legacy-backup\\` + +コピーされるのは、その時点で存在するファイルのみです: + +- `config.json`:使用していたデータフォルダを含む Legacy Desktop アプリの設定。 +- `comfy.settings.json`:レガシーのユーザーフォルダに保存されている ComfyUI フロントエンド設定。 +- `extra_models_config.yaml`:Legacy Desktop で設定した追加のモデルパス。 +- `window.json`:保存されたウィンドウサイズと位置。 + +このバックアップに含まれるのは設定のみです。モデル、ワークフロー、カスタムノード、入力ファイル、出力結果はコピーされません。移行後のインストールがそれらを元の場所で使い続けるためです。また移行では、レガシー環境のスナップショット(カスタムノードとインストール済みパッケージ)をレガシーデータフォルダ内の `.snapshots/` に書き出します。 + +ファイルをコピーできなかった場合、移行はログに記録して続行します。バックアップの失敗で移行が止まることはありません。 + +## 移行中に表示されるもの + +移行は専用の進行画面を表示し、次の順でステップを進めます: + +1. **Back up legacy state** +2. **Check folder access**(macOS のみ) +3. **Validate Python environment** +4. **Capture snapshot** +5. **Allocate install folder** +6. **Stage ComfyUI source code** +7. **Install requirements** +8. **Carry over settings** +9. **Register installation** + +途中で確認を求めて止まる場合があります: + +- **Folder access needed**(macOS):macOS が Legacy Desktop フォルダへのアクセスをブロックしました。システム設定 → プライバシーとセキュリティで Comfy Desktop にフルディスクアクセスを許可し、移行をやり直してください。 +- **Python environment looks broken**:レガシー環境が torch をインポートできませんでした。その環境のまま続行するには **Adopt anyway**、停止するには **Cancel** を選択します。 +- **ComfyUI source code unavailable**:新しいインストール用の ComfyUI ソースを取得できませんでした。**Retry** を選択するか、**Cancel** を選んでダッシュボードから新しいインストールを作成してください。 + +進行画面では各ステップの出力が **View logs** パネルに残り、ステップが失敗すると自動で開きます。パネル内のコピーボタンでテキストをコピーできるほか、同じ出力は Desktop のアプリログにも書き込まれます。依存関係のインストールに失敗した場合は警告として記録され、移行は停止しません。 ## 移行後の変化 移行完了後、新しい Standalone インストールは他の Comfy Desktop インストールと同様に動作します: - **起動方法**:Chooser ビューで新しいインストールカードの再生ボタンをクリックして起動。 -- **ポート**:Legacy Desktop はデフォルトでポート `8000` を使用。移行時にはこのポート設定(およびその他のカスタム起動引数)が引き継がれます。 +- **ポート**:旧版の設定からポートとその他のカスタム起動引数が引き継がれます。 - **管理方法**:Manage パネルで更新、スナップショット、設定を管理。 - **更新方法**:Manage パネルで直接更新可能。Legacy Desktop のように更新のたびに新規ダウンロードする必要はありません。 - **マルチインスタンス**:複数の Standalone インストールを同時に持ち、それぞれ異なる ComfyUI バージョンと設定を使用可能。 - **共有ストレージ**:モデルはデフォルトですべての Standalone インストール間で共有。入力/出力ディレクトリは従来の Legacy ワークスペースに固定されるため、既存ファイルの位置は変わりません。 +移行したインストールでは、ComfyUI が自動で更新されることはありません。新しい ComfyUI バージョンが必要なときは、Manage パネルの[更新タブ](/ja/installation/desktop/usage/manage#更新タブ)を使用します。 + ## 以前のリンクは使えますか? Legacy Desktop はデフォルトでポート `8000` で動作していました。新しいインストールは**このポートを引き継ぐ**ため、`http://localhost:8000` はそのまま使えるはずです。 @@ -75,12 +119,9 @@ URL短縮サービスやブックマーク、外部連携で Legacy Desktop ア **Continue** を選択し、確認ダイアログで **Start Migration** を選びます。Comfy Desktop は次の処理を行います: -1. 既存のインストールをスキャン(カスタムノード、モデル、ワークフロー) -2. 既存のデータフォルダと Python 環境をその場で再利用し、ComfyUI のソースを新しい管理ディレクトリにステージングして更新が正常に機能するようにします -3. ワークフロー、設定、その他のユーザーデータをその場で再利用します -4. 入力ファイルと出力結果をその場で再利用します -5. モデルフォルダを共有ディレクトリとして追加 -6. 新しい環境にカスタムノードをインストール +1. ワークフロー、設定、カスタムノード、入力ファイル、出力結果をその場で再利用します +2. Python 環境を再利用し、ComfyUI のソースを新しい管理ディレクトリにステージングして更新が正常に機能するようにします +3. モデルフォルダを共有ディレクトリとして追加し、ComfyUI の依存関係を再利用する環境にインストールします 完了後、新しい Standalone インストールカードが Chooser ビューに表示されます。 @@ -110,7 +151,7 @@ URL短縮サービスやブックマーク、外部連携で Legacy Desktop ア ![Migrate Legacy Desktop to Standalone の確認ダイアログと Start Migration ボタン](/images/desktop/usage/migrate_04_confirm.png) -Legacy Desktop インストールはその場で採用され、Chooser に表示されるインスタンスは既存の環境を Comfy Desktop で管理するものになります。追跡中の Git および portable インストールの場合は代わりに新しい Standalone インストールが作成され、追跡元のインストールはそのまま残ります。どちらの場合もモデルファイルはコピーされず、元の場所から読み込まれます。 +Legacy Desktop インストールはその場で採用され、Chooser に表示されるインスタンスは既存の環境を Comfy Desktop で管理するものになります。追跡中の Git および portable インストールの場合は代わりに新しい Standalone インストールが作成され、追跡元のインストールはそのまま残ります。 更新が保留中の場合は更新ピルが優先され、**Migrate** は表示されません。 @@ -125,14 +166,18 @@ Legacy Desktop ソースは移行専用で、**新しいインスタンス** ピ ### 移行に失敗する -- **ログを確認**:Manage パネルの Terminal タブでエラー詳細を確認 -- **Legacy インストールが完全であることを確認**:移行は既存インストールを読み込みます -- **再試行**:ネットワークの問題は再試行で解決する場合があります +- **ログを確認**:移行画面で **View logs** を選ぶか、Desktop のアプリログ(`app.log`)を開きます。macOS は `~/Library/Logs/Comfy Desktop`、Windows は `%APPDATA%\Comfy Desktop\logs` にあります。 +- **Legacy インストールが完全であることを確認**:移行は既存フォルダからモデル、ワークフロー、カスタムノードを読み取るため、フォルダが移動・削除されていると停止します。 +- **再試行**:ネットワークの問題でソースのステージングが失敗することがあり、2 回目の試行で成功する場合があります。 + +### 移行が途中で止まった場合 + +いずれかの確認で **Cancel** を選ぶと実行は停止し、ステップが明確に失敗した場合も同様です(依存関係インストールの警告では停止しません)。停止した実行は Chooser にインスタンスを追加しないため、カードの **Migrate** ピルから移行をやり直してください。Legacy Desktop のフォルダが削除されることはありません。 ### 移行後、モデルが見つからない -モデルは共有ディレクトリパスとして追加されます(コピーされません)。モデルが表示されない場合: +モデルは共有モデルディレクトリに追加されるのであり、コピーされるわけではありません。モデルが表示されない場合: -1. 移行したインストールの **Manage** パネルを開く -2. **ストレージ** タブを開き **モデルディレクトリ** を確認 -3. 古いモデルフォルダがリストにあるか確認。ない場合は手動で追加。 +1. [Desktop Settings → Storage](/ja/installation/desktop/usage/settings#ストレージ) を開きます +2. 旧モデルフォルダと、Legacy Desktop の `extra_models_config.yaml` に記載された追加のモデルパスが共有ディレクトリにあるか確認します。欠けているものがあれば **+ Add Shared Directory** を選んでそのフォルダを指定します。 +3. 移行したインストールの Manage パネルで**ストレージタブ**を開き、**Include Shared Directories** がオンになっていることを確認します。 diff --git a/ko/installation/desktop/usage/migrate.mdx b/ko/installation/desktop/usage/migrate.mdx index d89e08fa88..151d8df33d 100644 --- a/ko/installation/desktop/usage/migrate.mdx +++ b/ko/installation/desktop/usage/migrate.mdx @@ -3,16 +3,18 @@ title: "Legacy Desktop에서 마이그레이션" description: "Legacy Desktop 설치를 Comfy Desktop으로 마이그레이션하는 방법을 알아봅니다." icon: "arrow-right" sidebarTitle: "마이그레이션" -translationSourceHash: 5f3f3100 +translationSourceHash: 61722fce translationFrom: installation/desktop/usage/migrate.mdx translationBlockHashes: "_intro": 14240c76 - "What Gets Migrated": 91f931e9 - "What Changes After Migration": 1f09d2db + "What Gets Migrated": 765895d5 + "What Migration Backs Up": ee11ab03 + "What Happens While Migration Runs": 250e4c95 + "What Changes After Migration": eae3f0a4 "Does My Old Link Still Work?": 528b3e43 - "Step-by-Step Migration": d15dfd28 - "Migrate from the Chooser": 9517089b - "Troubleshooting": a6cd9f9b + "Step-by-Step Migration": 0097aff9 + "Migrate from the Chooser": 384ed466 + "Troubleshooting": 787c900c --- @@ -32,25 +34,67 @@ Legacy Desktop이 이미 설치되어 있다면 Comfy Desktop이 이를 감지 Legacy Desktop은 단일 설치 앱이었습니다. Comfy Desktop은 다중 설치 관리자입니다. 마이그레이션하면: - **워크플로와 설정**: 기존 위치에서 그대로 재사용되어 새 인스턴스가 같은 사용자 데이터를 이어받습니다. -- **커스텀 노드** — 검사되어 새로운 환경에 재설치됩니다. -- **모델**: 기존 모델 폴더가 공유 디렉터리로 추가되어 파일은 그대로 유지됩니다. +- **커스텀 노드**: 기존 `custom_nodes` 폴더에 그대로 남습니다. 마이그레이션된 설치는 Legacy Desktop 데이터 폴더를 기본 디렉터리로 실행되므로 같은 노드가 로드되고, 그 패키지도 재사용되는 Python 환경에 남습니다. +- **모델**: 기존 모델 폴더가 공유 모델 디렉터리에 추가되어 모든 설치가 원래 위치에 있는 파일을 읽을 수 있습니다. - **입력 파일 및 출력**: 기존 폴더에서 그대로 재사용됩니다. -- **Python 환경**: 기존 환경을 검증해 재사용하고, 그 안에 ComfyUI에 필요한 패키지를 설치합니다. +- **Python 환경**: 기존 환경을 검증한 뒤 재사용합니다. Comfy Desktop은 torch를 임포트할 수 있는지 확인하고, 그다음 ComfyUI 자체의 요구 사항을 그 환경에 설치합니다. 기존 PyTorch 패키지는 교체하지 않습니다. - **ComfyUI 버전**: ComfyUI 소스가 새 관리 디렉터리에 스테이징되며, 이후 업데이트는 Comfy Desktop이 관리합니다. -Legacy Desktop 앱 자체는 설치된 상태로 남고, Comfy Desktop은 시작 전에 기존 상태를 백업합니다. 마이그레이션은 복사가 아니라 기존 환경을 그대로 재사용하므로, 공유되는 데이터 폴더와 Python 환경은 변경되지 않은 사본이 아닙니다. 온전한 사본이 필요하다면 마이그레이션 전에 직접 백업하세요. +마이그레이션은 Legacy Desktop 데이터 폴더와 Python 환경을 복사하지 않고 그대로 재사용하므로, 두 번째 사본이 아니라 하나의 작동 중인 환경이 남습니다. 온전한 사본이 필요하다면 마이그레이션 전에 직접 백업하세요. + +## 마이그레이션 시 백업되는 항목 + +변경을 시작하기 전에 Comfy Desktop은 Legacy Desktop 설정 파일을 레거시 구성 폴더 안의 날짜가 붙은 폴더로 복사합니다: + +- macOS: `~/Library/Application Support/ComfyUI/legacy-backup//` +- Windows: `%APPDATA%\ComfyUI\legacy-backup\\` + +존재하는 파일만 복사됩니다: + +- `config.json`: 사용하던 데이터 폴더를 포함한 Legacy Desktop 앱 설정. +- `comfy.settings.json`: 레거시 사용자 폴더에 저장된 ComfyUI 프런트엔드 설정. +- `extra_models_config.yaml`: Legacy Desktop에서 구성한 추가 모델 경로. +- `window.json`: 저장된 창 크기와 위치. + +이 백업에는 설정만 들어갑니다. 모델, 워크플로, 커스텀 노드, 입력 파일, 출력은 복사되지 않습니다. 마이그레이션된 설치가 원래 위치에서 계속 사용하기 때문입니다. 마이그레이션은 또한 레거시 환경의 스냅샷(커스텀 노드와 설치된 패키지)을 레거시 데이터 폴더의 `.snapshots/`에 기록합니다. + +파일을 복사할 수 없으면 마이그레이션은 로그에 남기고 계속 진행하므로, 백업 실패로 마이그레이션이 중단되지는 않습니다. + +## 마이그레이션 중 진행 과정 + +마이그레이션은 자체 진행 화면을 표시하며 다음 단계를 순서대로 진행합니다: + +1. **Back up legacy state** +2. **Check folder access** (macOS만 해당) +3. **Validate Python environment** +4. **Capture snapshot** +5. **Allocate install folder** +6. **Stage ComfyUI source code** +7. **Install requirements** +8. **Carry over settings** +9. **Register installation** + +중간에 확인을 요청하며 멈출 수 있습니다: + +- **Folder access needed**(macOS): macOS가 Legacy Desktop 폴더 접근을 차단했습니다. 시스템 설정 → 개인정보 보호 및 보안에서 Comfy Desktop에 전체 디스크 접근 권한을 부여한 뒤 마이그레이션을 다시 시작하세요. +- **Python environment looks broken**: 레거시 환경이 torch를 임포트하지 못했습니다. 해당 환경을 그대로 사용하려면 **Adopt anyway**, 중단하려면 **Cancel**을 선택합니다. +- **ComfyUI source code unavailable**: 새 설치에 필요한 ComfyUI 소스를 가져오지 못했습니다. **Retry**를 선택하거나, **Cancel**을 선택하고 대시보드에서 새 설치를 만드세요. + +진행 화면은 모든 단계의 출력을 **View logs** 패널에 유지하며, 단계가 실패하면 이 패널이 자동으로 열립니다. 패널의 복사 버튼으로 텍스트를 복사할 수 있고, 같은 출력은 Desktop 앱 로그에도 기록됩니다. 요구 사항 설치가 실패하면 경고로 기록될 뿐 마이그레이션은 중단되지 않습니다. ## 마이그레이션 후 변경 사항 마이그레이션이 완료되면 새 Standalone 설치는 다른 Comfy Desktop 설치와 동일하게 작동합니다. - **실행** — Chooser 뷰에서 새 설치 카드의 재생 버튼을 클릭하여 ComfyUI를 시작합니다. -- **포트** — Legacy Desktop은 기본적으로 `8000` 포트를 사용했습니다. 새 설치도 이 포트 설정(및 기타 커스텀 시작 인자)을 이어받습니다. +- **포트** — 레거시 구성의 포트와 기타 커스텀 시작 인자가 이어집니다. - **관리** — Manage 패널을 사용하여 설치를 업데이트, 스냅샷, 구성합니다. - **업데이트** — Standalone 설치는 Manage 패널을 통해 독립적으로 업데이트할 수 있습니다. Legacy Desktop과 달리 업데이트할 때마다 새 빌드를 다운로드할 필요가 없습니다. - **다중 인스턴스** — 각각 고유한 ComfyUI 버전과 구성으로 여러 개의 Standalone 설치를 나란히 운영할 수 있습니다. - **공유 저장소** — 기본적으로 모델은 모든 Standalone 설치에서 공유됩니다. 입력 및 출력 디렉터리는 기존 legacy 작업 공간을 가리키도록 고정되어 기존 파일이 그대로 유지됩니다. +마이그레이션된 인스턴스에서는 ComfyUI가 자동으로 업데이트되지 않습니다. 새 ComfyUI 버전이 필요하면 Manage 패널의 [업데이트 탭](/ko/installation/desktop/usage/manage#업데이트-탭)을 사용하세요. + ## 이전 링크가 여전히 작동하나요? Legacy Desktop은 기본적으로 `8000` 포트에서 실행되었습니다. 새 설치도 legacy 구성에서 **포트를 이어받기** 때문에 `http://localhost:8000`이 여전히 작동할 것입니다. `--port 8188`과 같은 커스텀 CLI 인자가 구성되어 있었다면 이것도 이어받습니다. @@ -73,12 +117,9 @@ Comfy Desktop을 처음 열면 초기 설정이 시스템의 Legacy Desktop 설 **Continue**를 선택한 뒤 확인 대화상자에서 **Start Migration**을 선택합니다. Comfy Desktop이 다음을 수행합니다: -1. 기존 설치 검사(커스텀 노드, 모델, 워크플로) -2. 기존 데이터 폴더와 Python 환경을 그대로 재사용하고, ComfyUI 소스를 새 관리 디렉터리에 스테이징하여 업데이트가 정상 동작하도록 합니다 -3. 워크플로, 설정 및 기타 사용자 데이터를 그대로 재사용합니다 -4. 입력 파일과 출력을 그대로 재사용합니다 -5. 모델 폴더를 공유 디렉터리로 추가 -6. 새 환경에 커스텀 노드 설치 +1. 워크플로, 설정, 커스텀 노드, 입력 파일, 출력을 그대로 재사용합니다 +2. Python 환경을 재사용하고 ComfyUI 소스를 새 관리 디렉터리에 스테이징하여 업데이트가 정상 동작하도록 합니다 +3. 모델 폴더를 공유 디렉터리로 추가하고 ComfyUI 요구 사항을 재사용하는 환경에 설치합니다 완료 후 Chooser 뷰에 새 Standalone 설치 카드가 나타납니다. @@ -108,7 +149,7 @@ Comfy Desktop을 처음 열면 초기 설정이 시스템의 Legacy Desktop 설 ![Migrate Legacy Desktop to Standalone 확인 대화상자와 Start Migration 버튼](/images/desktop/usage/migrate_04_confirm.png) -Legacy Desktop 설치는 기존 위치에서 그대로 인수되며, Chooser에 표시되는 인스턴스는 기존 환경을 Comfy Desktop에서 관리하는 형태가 됩니다. 추적 중인 Git 및 portable 인스턴스는 대신 새 Standalone 설치가 만들어지고 추적 대상 설치는 그대로 남습니다. 두 경우 모두 모델 파일은 복사되지 않고 원래 위치에서 읽습니다. +Legacy Desktop 설치는 기존 위치에서 그대로 인수되며, Chooser에 표시되는 인스턴스는 기존 환경을 Comfy Desktop에서 관리하는 형태가 됩니다. 추적 중인 Git 및 portable 인스턴스는 대신 새 Standalone 설치가 만들어지고 추적 대상 설치는 그대로 남습니다. 업데이트가 대기 중이면 업데이트 알약이 우선 표시되며 **Migrate**는 표시되지 않습니다. @@ -123,14 +164,18 @@ Legacy Desktop 소스는 마이그레이션 전용이며 **새 인스턴스** ### 마이그레이션 실패 -- Manage 패널의 Terminal 탭에서 **로그를 확인**하여 오류 내용을 확인합니다. -- **Legacy 설치가 손상되지 않았는지 확인**합니다: 마이그레이션은 기존 설치에서 읽어옵니다. -- **다시 시도**합니다: 네트워크 문제는 두 번째 시도에서 해결될 수 있습니다. +- **로그 확인**: 마이그레이션 화면에서 **View logs**를 선택하거나 Desktop 앱 로그(`app.log`)를 엽니다. macOS는 `~/Library/Logs/Comfy Desktop`, Windows는 `%APPDATA%\Comfy Desktop\logs`에 있습니다. +- **Legacy 설치가 온전한지 확인**: 마이그레이션은 기존 폴더에서 모델, 워크플로, 커스텀 노드를 읽으므로 폴더가 이동되거나 삭제되면 중단됩니다. +- **다시 시도**: 네트워크 문제로 소스 스테이징 단계가 실패할 수 있으며, 두 번째 시도에서 성공할 수 있습니다. + +### 마이그레이션이 중간에 멈춘 경우 + +프롬프트에서 **Cancel**을 선택하면 실행이 중지되며, 단계가 확실히 실패한 경우에도 마찬가지입니다(요구 사항 설치 경고로는 중지되지 않습니다). 중지된 실행은 Chooser에 인스턴스를 추가하지 않으므로 카드의 **Migrate** 알약에서 마이그레이션을 다시 시작하세요. Legacy Desktop 폴더는 삭제되지 않습니다. ### 마이그레이션 후 모델이 누락된 경우 -모델은 공유 디렉터리 경로로 추가됩니다(복사되지 않음). 모델이 나타나지 않으면: +모델은 공유 모델 디렉터리에 추가되는 것이며 복사되지 않습니다. 모델이 나타나지 않으면: -1. 마이그레이션된 설치의 **Manage** 패널을 엽니다. -2. **저장소** 탭으로 이동하여 **모델 디렉터리**를 확인합니다. -3. 이전 모델 폴더가 나열되어 있는지 확인합니다. 없으면 수동으로 추가합니다. +1. [Desktop Settings → Storage](/ko/installation/desktop/usage/settings#저장소)를 엽니다. +2. 기존 모델 폴더와 Legacy Desktop의 `extra_models_config.yaml`에 나열된 추가 모델 경로가 공유 디렉터리에 있는지 확인합니다. 빠진 항목이 있으면 **+ Add Shared Directory**를 선택해 해당 폴더를 지정합니다. +3. 마이그레이션된 설치의 Manage 패널에서 **저장소 탭**을 열고 **Include Shared Directories**가 켜져 있는지 확인합니다. diff --git a/zh/installation/desktop/usage/migrate.mdx b/zh/installation/desktop/usage/migrate.mdx index 2288ed6d58..a6a26a80aa 100644 --- a/zh/installation/desktop/usage/migrate.mdx +++ b/zh/installation/desktop/usage/migrate.mdx @@ -3,16 +3,18 @@ title: "从 Legacy Desktop 迁移" description: "了解如何将您的 Legacy Desktop 安装迁移到 Comfy Desktop" icon: "arrow-right" sidebarTitle: "迁移" -translationSourceHash: 5f3f3100 +translationSourceHash: 61722fce translationFrom: installation/desktop/usage/migrate.mdx translationBlockHashes: "_intro": 14240c76 - "What Gets Migrated": 91f931e9 - "What Changes After Migration": 1f09d2db + "What Gets Migrated": 765895d5 + "What Migration Backs Up": ee11ab03 + "What Happens While Migration Runs": 250e4c95 + "What Changes After Migration": eae3f0a4 "Does My Old Link Still Work?": 528b3e43 - "Step-by-Step Migration": d15dfd28 - "Migrate from the Chooser": 9517089b - "Troubleshooting": a6cd9f9b + "Step-by-Step Migration": 0097aff9 + "Migrate from the Chooser": 384ed466 + "Troubleshooting": 787c900c --- @@ -32,25 +34,67 @@ translationBlockHashes: Legacy Desktop 是单实例应用。Comfy Desktop 是多实例管理器。迁移时: - **工作流和设置**:就地复用,新实例沿用同一份用户数据。 -- **自定义节点** — 扫描后在新环境中重新安装 -- **模型**:您原有的模型文件夹被添加为共享目录,文件保留在原位置。 +- **自定义节点**:保留在您现有的 `custom_nodes` 文件夹中。迁移后的实例以 Legacy Desktop 数据文件夹作为基础目录运行,因此加载的是同一批节点,它们的依赖包也留在被复用的 Python 环境里。 +- **模型**:您原有的模型文件夹会被加入共享模型目录,所有实例都能直接读取原位置的文件。 - **输入文件和输出**:就地复用现有目录中的文件。 -- **Python 环境**:验证并复用您现有的环境,并在其中安装 ComfyUI 所需的依赖包。 -- **ComfyUI 版本**:ComfyUI 源码会被暂存到新的托管目录中,之后由 Comfy Desktop 管理更新。 +- **Python 环境**:先检查再复用您现有的环境。Comfy Desktop 会确认它能导入 torch,然后把 ComfyUI 自身的依赖安装进去,不会替换您现有的 PyTorch 包。 +- **ComfyUI 版本**:ComfyUI 源码会被暂存到新的托管目录,之后由 Comfy Desktop 管理更新。 -Legacy Desktop 应用本身会保留在系统中,Comfy Desktop 会在迁移开始前先备份旧版状态。迁移是就地复用这套环境而不是复制,因此共享的数据文件夹和 Python 环境并不是一份未被改动的副本。如果需要保留一份完整的旧版副本,请在迁移前自行备份。 +迁移会就地复用您的 Legacy Desktop 数据文件夹和 Python 环境,而不是复制它们,因此您得到的是一个正在使用的环境,而不是第二份副本。如果需要保留一份完整的旧版副本,请在迁移前自行备份。 + +## 迁移会备份什么 + +在改动任何内容之前,Comfy Desktop 会把 Legacy Desktop 的设置文件复制到旧版配置文件夹下按时间命名的目录中: + +- macOS:`~/Library/Application Support/ComfyUI/legacy-backup//` +- Windows:`%APPDATA%\ComfyUI\legacy-backup\\` + +只有实际存在的文件会被复制: + +- `config.json`:Legacy Desktop 应用设置,包括它使用的数据文件夹。 +- `comfy.settings.json`:存放在旧版用户文件夹中的 ComfyUI 前端设置。 +- `extra_models_config.yaml`:您在 Legacy Desktop 中配置的额外模型路径。 +- `window.json`:保存的窗口大小和位置。 + +这份备份只包含设置。模型、工作流、自定义节点、输入文件和输出都不会被复制进去,因为迁移后的实例会继续在原位置使用它们。迁移还会把旧版环境的快照(包含其自定义节点和已安装的依赖包)写入旧版数据文件夹下的 `.snapshots/`。 + +如果某个文件无法复制,迁移会在日志中记录并继续,因此备份失败不会中断迁移。 + +## 迁移运行时会发生什么 + +迁移会显示独立的进度界面,依次经过以下步骤: + +1. **备份旧版状态** +2. **检查文件夹访问权限**(仅 macOS) +3. **验证 Python 环境** +4. **捕获快照** +5. **分配安装文件夹** +6. **暂存 ComfyUI 源码** +7. **安装需求** +8. **迁移设置** +9. **注册安装** + +某些步骤会停下来等待您回答: + +- **需要文件夹访问权限**(macOS):macOS 阻止了对 Legacy Desktop 文件夹的访问。请在系统设置 → 隐私与安全性中为 Comfy Desktop 授予完全磁盘访问权限,然后重新开始迁移。 +- **Python 环境似乎已损坏**:旧版环境无法导入 torch。选择**仍然接管**以继续使用该环境,或选择**取消**停止迁移。 +- **ComfyUI 源码不可用**:无法获取新实例所需的 ComfyUI 源码。选择**重试**,或选择**取消**并改为从仪表板创建新实例。 + +进度界面会把所有步骤的输出保存在**查看日志**面板中,某一步失败时该面板会自动展开。可以用其中的复制按钮复制文本,同样的输出也会写入 Desktop 应用日志。依赖安装失败只会作为警告记录,不会中断迁移。 ## 迁移后的变化 迁移完成后,您的新 Standalone 安装与其他 Comfy Desktop 安装一样工作: - **启动** — 在 Chooser 视图中点击新安装卡片的播放按钮即可启动 ComfyUI。 -- **端口** — Legacy Desktop 默认使用端口 `8000`。新安装会继承此端口设置(以及您曾有的任何其他自定义启动参数)。 +- **端口** — 旧版配置中的端口以及其他自定义启动参数会一并继承。 - **管理** — 使用 Manage 面板更新、创建快照和配置安装。 - **更新** — Standalone 安装可以通过 Manage 面板独立更新。与 Legacy Desktop 不同,您不再需要为每次更新下载新构建版本。 - **多实例** — 您可以拥有多个并行的 Standalone 安装,每个都有自己的 ComfyUI 版本和配置。 - **共享存储** — 模型默认在所有 Standalone 安装之间共享。输入和输出目录固定到被采用的 Legacy 工作区,因此您现有的文件位置不变。 +迁移后的实例不会自行更新 ComfyUI。需要新的 ComfyUI 版本时,使用 Manage 面板的[更新选项卡](/zh/installation/desktop/usage/manage#更新选项卡)。 + ## 我的旧链接还能用吗? Legacy Desktop 默认在端口 `8000` 上运行。新安装会**继承端口**设置,因此 `http://localhost:8000` 应该仍然可用。如果您配置过自定义 CLI 参数(例如 `--port 8188`),这些参数也会一并继承。 @@ -73,12 +117,9 @@ Legacy Desktop 默认在端口 `8000` 上运行。新安装会**继承端口** 点击**继续**,然后在确认对话框中选择**开始迁移**。Comfy Desktop 将: -1. 扫描现有安装(自定义节点、模型、工作流) -2. 就地复用您现有的数据文件夹和 Python 环境,并把 ComfyUI 源码暂存到新的托管目录,以便更新正常工作 -3. 就地复用您的工作流、设置和其他用户数据 -4. 就地复用您的输入文件和输出 -5. 将模型文件夹添加为共享目录 -6. 在新环境中安装自定义节点 +1. 就地复用您的工作流、设置、自定义节点、输入文件和输出 +2. 复用您的 Python 环境,并把 ComfyUI 源码暂存到新的托管目录,以便更新正常工作 +3. 将模型文件夹添加为共享目录,并把 ComfyUI 的依赖安装到被复用的环境中 完成后,新的 Standalone 安装卡片会出现在 Chooser 视图中。 @@ -108,7 +149,7 @@ Legacy Desktop 默认在端口 `8000` 上运行。新安装会**继承端口** ![Migrate Legacy Desktop to Standalone 确认弹窗,右下角为 Start Migration 按钮](/images/desktop/usage/migrate_04_confirm.png) -Legacy Desktop 安装会被就地接管,出现在 Chooser 中的实例就是您现有环境在 Comfy Desktop 下的托管版本。已跟踪的 Git 和 portable 实例则不同,迁移会新建一个 Standalone 安装,原跟踪安装保持原样。两种情况都不会复制模型文件,而是直接从原位置读取。 +Legacy Desktop 安装会被就地接管,出现在 Chooser 中的实例就是您现有环境在 Comfy Desktop 下的托管版本。已跟踪的 Git 和 portable 实例则不同,迁移会新建一个 Standalone 安装,原跟踪安装保持原样。 待更新状态优先:这类卡片会显示更新胶囊按钮,而不是**迁移**。 @@ -123,14 +164,18 @@ Legacy Desktop 源仅用于迁移,不会出现在**新建实例**选择器中 ### 迁移失败 -- **查看日志**:在 Manage 面板的 Terminal 选项卡中查看错误详情 -- **确保 Legacy 安装完整**:迁移需要从现有安装读取数据 -- **重试**:网络问题可能在二次尝试后解决 +- **查看日志**:在迁移界面选择**查看日志**,或打开 Desktop 应用日志(`app.log`):macOS 位于 `~/Library/Logs/Comfy Desktop`,Windows 位于 `%APPDATA%\Comfy Desktop\logs`。 +- **检查 Legacy 安装是否完整**:迁移会从现有文件夹读取模型、工作流和自定义节点,文件夹被移动或删除会导致迁移中断。 +- **重试**:网络问题可能让源码暂存步骤失败,第二次尝试可能会成功。 + +### 迁移中途停止 + +在任一提示中选择**取消**会停止本次迁移,某一步直接失败也会如此(依赖安装的警告不算)。停止的迁移不会向 Chooser 添加实例,请从卡片上的**迁移**胶囊按钮重新发起。您的 Legacy Desktop 文件夹不会被删除。 ### 迁移后模型丢失 -模型是作为共享目录路径添加的(不是复制)。如果模型未显示: +模型是加入共享模型目录,而不是复制。如果模型没有显示: -1. 打开迁移后安装的 **Manage** 面板 -2. 进入 **存储** 标签页并打开 **模型目录** -3. 检查旧模型文件夹是否在列表中。如果没有,请手动添加。 +1. 打开 [桌面设置 → 存储](/zh/installation/desktop/usage/settings#存储) +2. 确认旧模型文件夹以及 Legacy Desktop `extra_models_config.yaml` 中列出的额外模型路径都已加入共享目录。如果有缺失,选择 **+ 添加共享目录** 并选中它。 +3. 在迁移后实例的 Manage 面板中打开**存储标签页**,确认**包含共享目录**已开启。