diff --git a/docs.json b/docs.json
index 3277231d36..cbf4179480 100644
--- a/docs.json
+++ b/docs.json
@@ -55,6 +55,7 @@
"installation/desktop/usage/downloads",
"installation/desktop/usage/manage",
"installation/desktop/usage/settings",
+ "installation/desktop/usage/performance-tests",
"installation/desktop/usage/migrate"
]
},
@@ -3973,6 +3974,7 @@
"zh/installation/desktop/usage/downloads",
"zh/installation/desktop/usage/manage",
"zh/installation/desktop/usage/settings",
+ "zh/installation/desktop/usage/performance-tests",
"zh/installation/desktop/usage/migrate"
]
},
@@ -7912,6 +7914,7 @@
"ja/installation/desktop/usage/downloads",
"ja/installation/desktop/usage/manage",
"ja/installation/desktop/usage/settings",
+ "ja/installation/desktop/usage/performance-tests",
"ja/installation/desktop/usage/migrate"
]
},
@@ -11864,6 +11867,7 @@
"ko/installation/desktop/usage/downloads",
"ko/installation/desktop/usage/manage",
"ko/installation/desktop/usage/settings",
+ "ko/installation/desktop/usage/performance-tests",
"ko/installation/desktop/usage/migrate"
]
},
diff --git a/images/desktop/interface/interface_desktop_dashboard.png b/images/desktop/interface/interface_desktop_dashboard.png
index fdc160e199..e969a9a0e5 100644
Binary files a/images/desktop/interface/interface_desktop_dashboard.png and b/images/desktop/interface/interface_desktop_dashboard.png differ
diff --git a/images/desktop/interface/interface_instance_menu.png b/images/desktop/interface/interface_instance_menu.png
index b5c13f21a0..6d50863afc 100644
Binary files a/images/desktop/interface/interface_instance_menu.png and b/images/desktop/interface/interface_instance_menu.png differ
diff --git a/images/desktop/usage/01-homepage.png b/images/desktop/usage/01-homepage.png
index 1932caee04..e969a9a0e5 100644
Binary files a/images/desktop/usage/01-homepage.png and b/images/desktop/usage/01-homepage.png differ
diff --git a/images/desktop/usage/benchmarks_01_runs_library.png b/images/desktop/usage/benchmarks_01_runs_library.png
new file mode 100644
index 0000000000..5a8a85e48d
Binary files /dev/null and b/images/desktop/usage/benchmarks_01_runs_library.png differ
diff --git a/images/desktop/usage/benchmarks_02_relative_speed.png b/images/desktop/usage/benchmarks_02_relative_speed.png
new file mode 100644
index 0000000000..228700fe52
Binary files /dev/null and b/images/desktop/usage/benchmarks_02_relative_speed.png differ
diff --git a/images/desktop/usage/comfy_desktop_app_menu.png b/images/desktop/usage/comfy_desktop_app_menu.png
new file mode 100644
index 0000000000..ae8e636a5a
Binary files /dev/null and b/images/desktop/usage/comfy_desktop_app_menu.png differ
diff --git a/images/desktop/usage/comfy_desktop_settings_00_menu.png b/images/desktop/usage/comfy_desktop_settings_00_menu.png
index d5de77783c..7163deb2ea 100644
Binary files a/images/desktop/usage/comfy_desktop_settings_00_menu.png and b/images/desktop/usage/comfy_desktop_settings_00_menu.png differ
diff --git a/images/desktop/usage/comfy_desktop_settings_01_preferences.png b/images/desktop/usage/comfy_desktop_settings_01_preferences.png
index f4698d04fb..1c7598e7e0 100644
Binary files a/images/desktop/usage/comfy_desktop_settings_01_preferences.png and b/images/desktop/usage/comfy_desktop_settings_01_preferences.png differ
diff --git a/images/desktop/usage/comfy_desktop_settings_02_updates.png b/images/desktop/usage/comfy_desktop_settings_02_updates.png
index 149af16517..b298c03cef 100644
Binary files a/images/desktop/usage/comfy_desktop_settings_02_updates.png and b/images/desktop/usage/comfy_desktop_settings_02_updates.png differ
diff --git a/images/desktop/usage/comfy_desktop_settings_03-2_storage.png b/images/desktop/usage/comfy_desktop_settings_03-2_storage.png
index 0f98eb8602..8d34f30ec5 100644
Binary files a/images/desktop/usage/comfy_desktop_settings_03-2_storage.png and b/images/desktop/usage/comfy_desktop_settings_03-2_storage.png differ
diff --git a/images/desktop/usage/comfy_desktop_settings_03_storage.png b/images/desktop/usage/comfy_desktop_settings_03_storage.png
index cf538b780c..28f46c4003 100644
Binary files a/images/desktop/usage/comfy_desktop_settings_03_storage.png and b/images/desktop/usage/comfy_desktop_settings_03_storage.png differ
diff --git a/images/desktop/usage/comfy_desktop_settings_04_advanced.png b/images/desktop/usage/comfy_desktop_settings_04_advanced.png
index 2ae9ea53be..26f4ed037e 100644
Binary files a/images/desktop/usage/comfy_desktop_settings_04_advanced.png and b/images/desktop/usage/comfy_desktop_settings_04_advanced.png differ
diff --git a/images/desktop/usage/first_run_cloud_local.png b/images/desktop/usage/first_run_cloud_local.png
new file mode 100644
index 0000000000..94417103cf
Binary files /dev/null and b/images/desktop/usage/first_run_cloud_local.png differ
diff --git a/images/desktop/usage/first_run_local_selected.png b/images/desktop/usage/first_run_local_selected.png
new file mode 100644
index 0000000000..0044ef02e8
Binary files /dev/null and b/images/desktop/usage/first_run_local_selected.png differ
diff --git a/images/desktop/usage/instance_settings_00.png b/images/desktop/usage/instance_settings_00.png
index a305909ed7..7d43c6bfde 100644
Binary files a/images/desktop/usage/instance_settings_00.png and b/images/desktop/usage/instance_settings_00.png differ
diff --git a/images/desktop/usage/instance_settings_01_update.png b/images/desktop/usage/instance_settings_01_update.png
index 38ec0ea6c0..7184308a64 100644
Binary files a/images/desktop/usage/instance_settings_01_update.png and b/images/desktop/usage/instance_settings_01_update.png differ
diff --git a/images/desktop/usage/instance_settings_02_startup_args.png b/images/desktop/usage/instance_settings_02_startup_args.png
index 07949ba47e..f9d7144460 100644
Binary files a/images/desktop/usage/instance_settings_02_startup_args.png and b/images/desktop/usage/instance_settings_02_startup_args.png differ
diff --git a/images/desktop/usage/instance_settings_03_snapshots.png b/images/desktop/usage/instance_settings_03_snapshots.png
index 88918d7c11..6666350e36 100644
Binary files a/images/desktop/usage/instance_settings_03_snapshots.png and b/images/desktop/usage/instance_settings_03_snapshots.png differ
diff --git a/images/desktop/usage/instance_settings_04_storage.png b/images/desktop/usage/instance_settings_04_storage.png
index e9adb2477e..c7b2bf0747 100644
Binary files a/images/desktop/usage/instance_settings_04_storage.png and b/images/desktop/usage/instance_settings_04_storage.png differ
diff --git a/images/desktop/usage/instance_settings_05_about.png b/images/desktop/usage/instance_settings_05_about.png
index 979700ddf8..05b86765d2 100644
Binary files a/images/desktop/usage/instance_settings_05_about.png and b/images/desktop/usage/instance_settings_05_about.png differ
diff --git a/images/desktop/usage/instance_settings_05_console.png b/images/desktop/usage/instance_settings_05_console.png
index 54238b8324..5b33ddae69 100644
Binary files a/images/desktop/usage/instance_settings_05_console.png and b/images/desktop/usage/instance_settings_05_console.png differ
diff --git a/images/desktop/usage/low_disk_space_dialog.png b/images/desktop/usage/low_disk_space_dialog.png
new file mode 100644
index 0000000000..1f092d6671
Binary files /dev/null and b/images/desktop/usage/low_disk_space_dialog.png differ
diff --git a/images/desktop/usage/new_install_01_settings_linux.png b/images/desktop/usage/new_install_01_settings_linux.png
new file mode 100644
index 0000000000..1bd9f5a4b6
Binary files /dev/null and b/images/desktop/usage/new_install_01_settings_linux.png differ
diff --git a/images/desktop/usage/new_install_02_installing.png b/images/desktop/usage/new_install_02_installing.png
index 3dff6e1bf6..fd2ad534bf 100644
Binary files a/images/desktop/usage/new_install_02_installing.png and b/images/desktop/usage/new_install_02_installing.png differ
diff --git a/images/desktop/usage/new_install_03_interface_template.png b/images/desktop/usage/new_install_03_interface_template.png
index 6f872bba47..4e1e0bce44 100644
Binary files a/images/desktop/usage/new_install_03_interface_template.png and b/images/desktop/usage/new_install_03_interface_template.png differ
diff --git a/images/desktop/usage/performance_tests_01_panel.png b/images/desktop/usage/performance_tests_01_panel.png
new file mode 100644
index 0000000000..386af08c45
Binary files /dev/null and b/images/desktop/usage/performance_tests_01_panel.png differ
diff --git a/images/desktop/usage/performance_tests_02_example_workflows.png b/images/desktop/usage/performance_tests_02_example_workflows.png
new file mode 100644
index 0000000000..986bfd7990
Binary files /dev/null and b/images/desktop/usage/performance_tests_02_example_workflows.png differ
diff --git a/images/desktop/usage/performance_tests_menu_entry.png b/images/desktop/usage/performance_tests_menu_entry.png
new file mode 100644
index 0000000000..ac9fdf19a1
Binary files /dev/null and b/images/desktop/usage/performance_tests_menu_entry.png differ
diff --git a/images/desktop/usage/title_bar_trailing.png b/images/desktop/usage/title_bar_trailing.png
new file mode 100644
index 0000000000..68aa197500
Binary files /dev/null and b/images/desktop/usage/title_bar_trailing.png differ
diff --git a/installation/desktop/faq.mdx b/installation/desktop/faq.mdx
index 132b9a78ce..1ef4ae86fc 100644
--- a/installation/desktop/faq.mdx
+++ b/installation/desktop/faq.mdx
@@ -17,6 +17,16 @@ Yes. The source is on [GitHub](https://github.com/Comfy-Org/Comfy-Desktop). Comf
Comfy Desktop is one of several installation options. You can still use the **Portable (Windows)** install, **Manual Install**, or **Comfy Cloud** depending on your needs. Desktop is recommended for most users due to its ease of use and features like one-click updates and snapshot management.
+
+No. Comfy Desktop checks for a new version shortly after it launches and then every 10 minutes, and that check has no off switch. The only update setting is **Automatically install Desktop updates** in **Desktop Settings → Updates**, and it is on by default.
+
+- **On**: a new version downloads in the background and installs without asking. The title bar shows **Downloading update…** while it downloads, then **Desktop Update Ready** when the update is ready to apply.
+- **Off**: Comfy Desktop still checks and still tells you, but it stops downloading on its own. The title bar shows a **Desktop Update** pill instead, and clicking it downloads the update and offers to restart.
+
+The ComfyUI version inside an instance is updated separately. Use the instance's **Update** tab and pick the **Stable** or **Latest on GitHub** channel there.
+
+On Linux, the in-app updater does not apply to `.deb` installs. Download the new package with the [universal download link](https://dl.todesktop.com/241130tqe9q3y) and install it with `sudo apt install ./*.deb`.
+
## Installation & Setup
@@ -115,6 +125,11 @@ Look for `app.log`. Previous sessions rotate to timestamped `app.log_*.log` file
For ComfyUI process output (not the Desktop app itself), open the instance **Manage** panel and use the **Terminal** tab. See [Manage](/installation/desktop/usage/manage).
+
+ComfyUI does not natively integrate with [Ollama](https://ollama.ai) for diffusion model backends. However, you can use Ollama-served LLMs for prompt generation and text processing through **custom nodes** available in the ComfyUI Manager registry.
+
+For connecting ComfyUI to LLM services, see [Install Custom Nodes](/installation/install_custom_node).
+
Comfy Desktop and its installations are separate on disk. To uninstall the app and its installations:
diff --git a/installation/desktop/overview.mdx b/installation/desktop/overview.mdx
index bbc7d7f9ec..3a27364d58 100644
--- a/installation/desktop/overview.mdx
+++ b/installation/desktop/overview.mdx
@@ -9,7 +9,7 @@ sidebarTitle: "Overview"
To put it simply: **Comfy Desktop** is the app that manages and launches **ComfyUI**, the node-based engine for generative AI. You don't install ComfyUI separately — Comfy Desktop handles the installation, Python environment, and dependencies for you. Each ComfyUI instance runs independently with its own version, custom nodes, and settings.
-
+
Comfy Desktop runs on **Windows 10+**, **macOS 13+ (Apple Silicon)**, and **Linux** (official `.deb` and AppImage packages). Each standalone installation requires at least **4.85 GB** of disk space and **8 GB RAM (16 GB recommended)**. Check the platform-specific pages for full details.
@@ -31,6 +31,54 @@ Choose your platform to begin:
+## First Launch
+
+The first time you open Comfy Desktop, a full-screen setup asks **How do you want to run Comfy?** and collects the choices it needs before anything is installed. The window stays in this setup until you finish it: if you close the app partway through, the same screen comes back on the next launch.
+
+### Cloud or Local
+
+
+
+Two cards cover the two ways to run ComfyUI:
+
+- **Cloud** runs ComfyUI on Comfy Cloud GPUs. Nothing is installed on your machine and there is nothing to download. The card carries a **TRY FREE** pill while free Cloud runs are available.
+- **Local** installs ComfyUI on this machine. You control the ComfyUI version, custom nodes, and startup arguments, and it runs offline.
+
+If Comfy Desktop detects that this machine's GPU is not powerful enough for most workflows, the Cloud card carries a **Recommended for your hardware** badge and neither card is preselected, so the choice is deliberate rather than a default. **Continue** stays disabled until a card is selected.
+
+### Terms and data sharing
+
+Three checkboxes sit below the cards:
+
+- **I agree to the EULA and Terms of Service**: required. The links open the EULA, the Terms of Service, and the Privacy Policy. **Continue** does not proceed until this box is ticked, every time the setup runs.
+- **Help improve Comfy by sharing anonymous usage data**: optional and ticked by default. Comfy Desktop sends anonymous usage data and never collects workflow contents, prompts, generated media, or personal information. You can change this later in [Desktop Settings](/installation/desktop/usage/settings).
+- **Opt in to beta features and help test what ships next**: optional and ticked by default, and available only while data sharing is on. Clearing data sharing also clears this box.
+
+### Express Install
+
+
+
+When **Local** is selected, an **Express Install with recommended settings** checkbox appears. It is cleared by default, so the install wizard shows the ComfyUI version, install location, and startup options before anything is written to disk. Tick it to skip that step and install a Standalone instance with the recommended settings. Comfy Desktop then names the hardware it detected under the checkbox, so you can clear it if the detected GPU is not the one you want to use.
+
+### Migrating an existing install
+
+If Comfy Desktop finds a Legacy Desktop installation on the machine, a **Migrate existing instance** checkbox appears next to Express Install, ticked by default. Leave it ticked to bring your workflows, models, and settings over when you continue, see [Migrate from Legacy Desktop](/installation/desktop/usage/migrate) for what moves. Clear it to install a fresh instance instead. With both checkboxes cleared, Comfy Desktop asks once more before the install starts: select **Migrate** to bring the Legacy Desktop install over, or **Start Fresh** to install a clean instance and leave the existing projects in place.
+
+### Chinese mirrors
+
+When the app runs in Chinese, the setup adds one question after **Continue**: **Enable Chinese Mirrors?** Select **Enable Mirrors** to clone Git repositories from `gitcode.com` and fetch PyPI packages from Aliyun and Tencent mirrors instead of `github.com` and `pypi.org`, which is faster in mainland China. Select **Not now** to keep the defaults. Either answer is stored as the **Use Chinese Mirrors (Git & PyPI)** setting, so you can change it later.
+
+### After setup
+
+**Continue** saves your choices and shows a short **Preparing your install…** step.
+
+- **Cloud**: Comfy Desktop closes the setup and launches Comfy Cloud.
+- **Local**: the install wizard runs unless Express Install is on, the install shows its progress, and the finished instance appears on the dashboard.
+
+If Comfy Desktop already has a standalone, tracked, or remote installation, it skips the Cloud or Local choice and takes you straight to the dashboard once the terms are accepted. Consenting is required every time the setup runs.
+
+The setup is a full-screen takeover: the title bar is locked while it is open, and once you leave the consent step the app menu (☰) is reduced to a single **Skip Onboarding** item, which closes the setup and drops you on the dashboard without installing anything.
+
## Usage Guide
Once installed, learn how to use Comfy Desktop:
diff --git a/installation/desktop/usage/downloads.mdx b/installation/desktop/usage/downloads.mdx
index facaf46535..7a9ff2e088 100644
--- a/installation/desktop/usage/downloads.mdx
+++ b/installation/desktop/usage/downloads.mdx
@@ -43,6 +43,6 @@ The footer counts the active and completed downloads currently listed.
## Where downloads are saved
-Model files are written to the instance's primary model directory: the shared model directory marked **Primary** when the instance includes shared model directories, otherwise the instance's own `models` folder. Shared directories are configured in [Desktop Settings](/installation/desktop/usage/settings#storage), and each instance can opt out of them in its **Manage** panel [Storage tab](/installation/desktop/usage/manage#storage-tab).
+Model files are written to the instance's model download directory: the shared model directory marked **DOWNLOADS** (set with **Use for Model Downloads**) when the instance includes shared model directories, otherwise the instance's own `models` folder. Shared directories are configured in [Desktop Settings](/installation/desktop/usage/settings#storage), and each instance can opt out of them in its **Manage** panel [Storage tab](/installation/desktop/usage/manage#storage-tab).
Outputs downloaded from a remote instance go to the shared output folder when the instance uses it, otherwise to the instance's own output folder. A remote instance can turn automatic output downloads off with **Auto-Download Outputs** in its storage settings.
diff --git a/installation/desktop/usage/instance-management.mdx b/installation/desktop/usage/instance-management.mdx
index 02e1040817..696494e069 100644
--- a/installation/desktop/usage/instance-management.mdx
+++ b/installation/desktop/usage/instance-management.mdx
@@ -22,7 +22,7 @@ Comfy Desktop supports four types of instances. Each type displays a distinct ic
The image below labels the key actions available for each instance card:
-
+
1. **New Instance**: Create a brand new ComfyUI instance. See [Creating a New Instance](#creating-a-new-instance). You can also [create an instance from a snapshot file](/installation/desktop/usage/snapshots#create-an-instance-from-a-snapshot-file).
2. **⋮ Menu**: Click the three-dot icon to open the action menu for an instance.
@@ -48,6 +48,9 @@ Click the **+** card (top-left) in the Chooser view to add a new ComfyUI instanc

+
+ 
+
1. **Name**: The name of your instance. The default is "ComfyUI".
@@ -58,17 +61,19 @@ Click the **+** card (top-left) in the Chooser view to add a new ComfyUI instanc
If free space looks low, the wizard shows a **Low Disk Space** dialog. Choose **Continue Anyway**, or cancel and pick another path.
+
+
-
+
Comfy Desktop will handle the rest: downloading Python, setting up the environment, and installing ComfyUI. The progress screen shows the current step.
-
+
Once the installation is complete, Comfy Desktop opens the template library where you can pick a workflow template to get started.
@@ -126,6 +131,41 @@ The key difference between a **Tracked** (Add Existing Instance) installation an
> **Note:** Tracked installations use `launchMode: 'external'`. Comfy Desktop launches the existing ComfyUI process without managing it internally. Snapshots are currently supported for Standalone instances only.
+## Launching, Stopping, and Restarting an Instance
+
+[↩ Back to overview](#overview)
+
+### Launching an Instance
+
+Click an instance card in the Chooser to launch it. While ComfyUI starts, the window shows the startup progress, then the ComfyUI interface once the server is ready.
+
+### Launching While Another Instance Is Running
+
+When you launch a local instance while another local instance is running or starting, Comfy Desktop shows an **An instance is already running** dialog that lists the instances it would stop:
+
+- **Close & Launch**: stops the listed instances, then launches the one you picked.
+- **Run All**: launches the new instance alongside the running ones.
+
+Dismiss the dialog to cancel the launch. Restarting an instance never shows this dialog. To stop seeing it, turn off **Warn before running multiple instances** in [Desktop Settings → Preferences](/installation/desktop/usage/settings#preferences).
+
+### Stopping an Instance
+
+Select **Stop** from the instance card's ⋮ menu. The ComfyUI server stops and the window stays open with a **ComfyUI is stopped** card. Select **Relaunch ComfyUI** to start the server again, or **Return to Dashboard** to go back to the Chooser.
+
+### Restarting After a Crash
+
+If ComfyUI fails to start or exits unexpectedly, the window stays open with a card describing what happened:
+
+- **ComfyUI could not start**: the instance did not start.
+- **ComfyUI exited unexpectedly**: the process stopped. When Comfy Desktop can read it, the card also shows the exit code, or the signal that ended the process.
+
+On Windows, a crash can report a memory access violation and note that some Microsoft Visual C++ Redistributable files appear to be missing. Expand the card's logs for details, then select **Restart ComfyUI** to launch again, or **Back** to return to the dashboard.
+
+If ComfyUI stops because it cannot open the asset database it keeps inside the installation, the error it stops with explains the reason instead of only reporting an exit code:
+
+- **Another ComfyUI is using this installation's database**: close that ComfyUI (or the app that started it), or give one of them its own database location with the `--database-url` startup argument.
+- **Any other database failure**, from one locked by another program to one written by a newer version of ComfyUI or impossible to create in that folder: the message names the file and the fix, and ends with the option to start the instance without the asset system, by adding `--disable-assets` to its startup arguments.
+
## Uninstalling an Instance
[↩ Back to overview](#overview)
diff --git a/installation/desktop/usage/manage.mdx b/installation/desktop/usage/manage.mdx
index 3a367dc2d7..36c0b241a8 100644
--- a/installation/desktop/usage/manage.mdx
+++ b/installation/desktop/usage/manage.mdx
@@ -11,7 +11,7 @@ The Manage panel content varies by instance type. The screenshots on this page s
Select **Manage** on an installation to open the settings panel.
-
+
- Open the **Chooser** view (the home screen showing all your instances)
- Click the ⋮ icon on an instance card
@@ -21,7 +21,7 @@ The panel has six tabs:
### Update Tab
-
+
This tab shows the current version, lets you check for updates, and configure the update channel.
@@ -34,11 +34,11 @@ This tab shows the current version, lets you check for updates, and configure th
### Startup Args Tab
-
+
Configure startup CLI arguments, Manager policy, launch mode, browser cache sharing, port conflict behavior, and environment variables.
-- **Startup Arguments**: Custom CLI arguments for ComfyUI (e.g. `--listen`). Click the gear icon for categorized flags.
+- **Startup Arguments**: Custom CLI arguments for ComfyUI (e.g. `--listen`). Click the gear icon for categorized flags. When beta features are enabled, a **+N beta** pill next to the field lists the beta arguments Comfy Desktop added for the running session, or the ones the next launch is eligible for.
- **Manager Security Level**: Controls which node packs ComfyUI-Manager can install for this instance. Applies the next time you launch.
- **Strict**: Blocks all node pack installs, updates, and uninstalls. Manager is read-only.
- **Standard (recommended)**: Allows registered node packs. Blocks installs from unregistered sources (for example arbitrary git URLs).
@@ -62,7 +62,7 @@ Configure startup CLI arguments, Manager policy, launch mode, browser cache shar
### Snapshots Tab
-
+
View, import, export, and create snapshots. Each entry shows version changes and package statistics.
@@ -85,7 +85,7 @@ View, import, export, and create snapshots. Each entry shows version changes and
### Storage Tab
-
+
Configure whether this instance uses the global shared folders, and add extra model directories that apply only to this instance.
@@ -97,7 +97,7 @@ Configure whether this instance uses the global shared folders, and add extra mo
### Terminal Tab
-
+
An interactive shell in this instance's folder. It works whether ComfyUI is running or stopped.
@@ -106,7 +106,7 @@ An interactive shell in this instance's folder. It works whether ComfyUI is runn
### About Tab
-
+
View installation details: ComfyUI version, hardware, Python and PyTorch versions, disk path, and usage.
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/installation/desktop/usage/overview.mdx b/installation/desktop/usage/overview.mdx
index 990e878f50..41807ed050 100644
--- a/installation/desktop/usage/overview.mdx
+++ b/installation/desktop/usage/overview.mdx
@@ -24,21 +24,40 @@ This guide covers how to use these features.
Comfy Desktop window is divided into several key areas. The image below labels the main parts of the Dashboard:
-
+
### App Menu
-The hamburger menu (☰) in the top-left corner opens the application menu (File / Edit / View / Window / Help). Use it to open a new window, access **Desktop Settings**, **Log in** to your Comfy account, quit the app, or find other desktop-level controls.
+The hamburger menu (☰) in the top-left corner opens the application menu, which holds every app-level action:
-
+
+
+- **Open Dashboard**: opens the Dashboard in a new window. Instances that are running keep running.
+- **New Instance** and **Add Existing Instance**: create a new instance, or track a ComfyUI installation you already have.
+- **Load Snapshot**: create an instance from a snapshot file someone shared with you.
+- **Log in**: sign in to your Comfy account. This entry only appears while you are signed out.
+- **Performance Tests**: run timed workflows against an instance. See [Performance Tests and Benchmarks](/installation/desktop/usage/performance-tests).
+- **Benchmarks**: compare saved performance test results across hardware, workflows, and instances.
+- **Desktop Settings**: global settings for auto-updates, proxy/mirror, shared storage, and data locations.
+- **Send Feedback**: open the feedback panel.
+- **Close Window** and **Quit Desktop**: close the current window, or quit the app. Closing an instance window stops the ComfyUI instance it runs, and closing the last window quits Comfy Desktop.
+
+Two entries appear only in context: **Reset Zoom (N%)** once the ComfyUI view is zoomed, and **Skip Onboarding** during the first-run setup. While the first-run setup is on screen, **Skip Onboarding** is the only entry in the menu.
+
+On macOS the app also keeps a system menu bar with the standard app, Edit, and Window menus. Windows and Linux builds have no system menu bar.
+
+
Global settings: auto-updates, proxy/mirror, shared storage, and data locations.
+
+ Measure workflow speed on an instance, then compare runs across hardware.
+
### Instance Switcher
-The center pill shows the name of your active ComfyUI instance. Click it to open the **Instance Picker**, a popover that lists every installed instance, shows their running status, and lets you switch between them or launch a new one.
+The center pill shows the name of your active ComfyUI instance. Click it to open the **Instance Picker**, a popover that lists every installed instance, shows their running status, and lets you switch between them or launch a new one. When a new ComfyUI version is available for that instance, the pill also carries an **Update** chip; click the chip to update the instance without opening the picker.
@@ -48,11 +67,15 @@ The center pill shows the name of your active ComfyUI instance. Click it to open
### Trailing Buttons
-The buttons grouped on the right side of the title bar provide quick access to:
+
+
+The controls grouped on the right side of the title bar provide quick access to:
-- **Desktop Update**:when a new version of Comfy Desktop is available, a pill appears here. Click to download and apply the update.
-- **Feedback**:send feedback to the Comfy Desktop team.
-- **Downloads**:opens the downloads tray showing active and recent downloads.
+- **Desktop Update**: when a new version of Comfy Desktop is available, a pill appears here. Click to download and apply the update.
+- **Reset Zoom**: a pill showing the current zoom percentage appears while the ComfyUI view is zoomed away from 100%. Click it to return to 100%.
+- **What's new**: opens the announcements panel. Announcements cover new ComfyUI features and Comfy product launches, with a short video, highlights, and links out for details. The bell shows a dot while there is an announcement you have not opened, and the dot clears once you open the panel.
+- **Feedback**: send feedback to the Comfy Desktop team.
+- **Downloads**: opens the downloads tray. The badge shows how many downloads are running, and flags failed and unopened downloads. The tray lets you retry a failed download or cancel one that is running; select **View All Downloads** for the full list, where downloads can also be paused and resumed.
### Search
diff --git a/installation/desktop/usage/performance-tests.mdx b/installation/desktop/usage/performance-tests.mdx
new file mode 100644
index 0000000000..6ceb13a032
--- /dev/null
+++ b/installation/desktop/usage/performance-tests.mdx
@@ -0,0 +1,148 @@
+---
+title: "Performance Tests and Benchmarks"
+description: "Measure ComfyUI workflow speed with Performance Tests, then compare runs across GPUs, workflows, and instances with Benchmarks in Comfy Desktop"
+icon: "gauge"
+sidebarTitle: "Performance Tests"
+---
+
+**Performance Tests** measures how long a ComfyUI workflow takes to run on one of your instances. You pick an instance, load a workflow, and Comfy Desktop runs it a set number of times, timing every measured run and reporting the fastest, slowest, average, and median duration together with the hardware and software the numbers came from.
+
+**Benchmarks** compares those recorded results. It lists every saved run, filters them by workspace, instance, hardware, or workflow, and lines up selected runs side by side with a relative speed factor, so you can see how much faster one GPU, workflow, or instance is than another.
+
+Both panels open from the hamburger menu (☰) in the top-left corner of the Dashboard title bar, not from a left sidebar. Click the ☰ button (1), then choose **Performance Tests** (2), or **Benchmarks** just below it:
+
+
+
+
+Performance Tests runs a real workflow on a real instance, so a test takes roughly as long as the workflow itself multiplied by the number of runs. Workflows you import have to be exported in [API format](/development/api-development/workflow-api-format) first. The example workflows that ship with Comfy Desktop are already in that format.
+
+
+## Running a Performance Test
+
+The panel is laid out as three numbered steps side by side. They stack vertically on narrow windows.
+
+
+
+### 1. Select an instance
+
+Choose the **Workspace** and the **Instance** to test. The instance and its hardware are recorded with the results, which is what makes later comparisons meaningful: runs from different GPUs stay distinguishable.
+
+When you start a test, Comfy Desktop stops that instance's previous performance test session if one is still running, then launches the instance in a console session. Comfy Desktop refuses to start a test while any other local ComfyUI is running, still starting, or stopping, and names the instances in the way. Stop them, or wait for them to finish starting or stopping, then run the test again. Comfy Cloud and remote instances run elsewhere and never block a test. Other work that keeps the GPU busy, such as a game or a video export, still affects the numbers, so stop it before you run a test.
+
+### 2. Choose a workflow
+
+You can pick an example workflow that ships with Comfy Desktop, or bring your own.
+
+**Example workflows** are ready to run, and their models are downloaded for you. Click **Choose an example workflow** to open the picker. It groups the examples into modality tabs (Video, Image, 3D, and Audio; only modalities that have examples get a tab), and each card shows the example's name, task, and how much its models download. Click **Use workflow** to select one. Comfy Desktop then downloads any models the workflow is still missing, and the drop zone shows the download progress until it finishes. To pick an example, the instance has to be fully installed and you have to be online; if the models would not fit in the free disk space, the picker blocks the selection. Example workflows are tied to an instance: switching to another instance drops the example prepared for the first one, unless that example's session already recorded results.
+
+**Your own workflow** has to be exported in [API format](/development/api-development/workflow-api-format). Drop the `.json` file onto the drop zone, or click the zone to browse for one.
+
+
+
+Either way, Comfy Desktop copies the workflow into the test session folder, so the test still runs after you move or edit the original file.
+
+### 3. Set measurement settings
+
+| Setting | Range | Default | What it does |
+|---------|-------|---------|--------------|
+| **Warm-up runs** | 1 to 5 | 1 | Runs executed first to load models and warm up caches. They are not included in the results. |
+| **Measured runs** | 1 to 100 | 5 | Runs timed after the warm-up runs. Their durations are used to calculate the results. |
+
+Every run advances the workflow's numeric seed inputs by one, so the measured runs do not repeat an identical cached result.
+
+Once the three steps are set, click **Run** to start the test. The **Stop** button next to it cancels a test that is in progress.
+
+### Read the results
+
+While the test runs, the panel shows how many runs have finished and the instance logs. When every run finishes, the instance is stopped and the results appear:
+
+- **Fastest run**, **Slowest run**, **Average run**, and **Median run**, in seconds
+- **Measured runs** and **Failed runs**: how many runs produced a duration and how many did not
+- **Run duration aggregates**: a bar chart comparing the four aggregates (fastest, slowest, average, and median)
+- **System information**: compute device, VRAM, RAM, PyTorch version, xFormers version, CPU, CPU cores, operating system, and architecture
+
+A run's duration is the time ComfyUI spent executing the job on the server, not the time you waited for it. Failed runs are counted separately and left out of the statistics.
+
+Two buttons sit with the results: **Open folder** opens the session folder, and **Export results** saves the summary and charts as a PNG image.
+
+## Comparing Runs with Benchmarks
+
+Benchmarks reads the results that Performance Tests saved, so it has nothing to show until at least one test has finished.
+
+### Runs library
+
+The **Runs library** lists every saved run in the results folder, newest first. Its toolbar gives you:
+
+- **Select folder**: point the panel at a different results folder, for example a folder on a shared drive. The default is the folder Performance Tests writes to, see [Where results are stored](#where-results-are-stored).
+- **Refresh sessions**: reload the folder after a test finished elsewhere.
+- **Search runs**: filter the list by text.
+- Dropdown filters for workspace, instance, hardware, and workflow.
+- **Properties**: choose which columns the library shows (session, date and time, workflow, instance, workspace, run count, GPU and hardware).
+
+
+
+### Compare runs
+
+Select two or more runs with the checkboxes, or use **Select all visible runs**. The three newest runs are selected for you when the library loads. A selection opens the **Comparison** section below the library.
+
+Comparison puts one column per selected run next to a set of metric rows: fastest, average, median, and slowest duration, plus the measured run count. One run is the **baseline**. By default it is the first column shown. In the **Speed** view, click a column heading to make that run the baseline instead.
+
+### Relative speed
+
+The comparison has two views, **Duration** and **Speed**, which you switch between in the comparison toolbar. Relative speed belongs to the **Speed** view, and the baseline is chosen there too.
+
+**Relative speed** is the baseline duration divided by a run's duration:
+
+- **1.00×** means the run is the same speed as the baseline
+- A factor above 1.00× means the run is **faster** than the baseline
+- A factor below 1.00× means the run is **slower** than the baseline
+
+The **Speed** view plots each run on a logarithmic axis with **Slower** to the left and **Faster** to the right, so a 2x and a 4x difference stay readable on the same chart. The **Duration** view draws each run's fastest and slowest result as a line with the average marked. Runs without a usable duration are labelled unavailable.
+
+
+
+### Sort and export
+
+- **Sort comparison** orders the columns by relative speed. **Manual sort** lets you drag columns into your own order, or press Alt+Left / Alt+Right on a focused column.
+- **Export results** saves the whole comparison as a PNG image, the quickest way to attach a result to an issue or a chat message.
+
+### Manage sessions
+
+Each test is stored as a session. From the library you can rename a session (**Edit session**) or delete one (**Delete**). Deleting removes every file recorded for that session.
+
+## Where results are stored
+
+Performance Tests creates a session folder when you add a workflow to the panel, named with that moment's timestamp (`YYYYMMDDHHMMSS`):
+
+```
+📂 ComfyUI-Shared/
+└── 📂 benchmarks/
+ ├── 📂 20260930141522/
+ │ ├── my_workflow.json
+ │ ├── jobs.json
+ │ ├── results.json
+ │ └── logs.txt
+ └── 📂 20260930163005/
+ └── ...
+```
+
+| Platform | Default results folder |
+|----------|------------------------|
+| Windows | `%LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared\benchmarks` |
+| macOS / Linux | `~/ComfyUI-Shared/benchmarks` |
+
+Each session folder contains:
+
+- the workflow file the panel used
+- `jobs.json`: the raw job response from the instance
+- `results.json`: the summary the Benchmarks panel reads
+- `logs.txt`: the instance console output from the run
+
+Because Benchmarks reads `results.json` from every session folder it finds, copying session folders into the folder Benchmarks points at is enough to compare results from another machine.
+
+Running the same imported workflow again writes into the same session folder and overwrites the results already stored there. To keep a result for comparison, add the workflow to the panel again before the next test.
+
+## Requirements
+
+- A standalone, tracked, or remote instance that Comfy Desktop can launch. The test needs a working ComfyUI instance, so it cannot run against a Cloud instance.
+- A workflow the instance can execute, including any models and custom nodes it needs. A workflow you import has to be in API format; the example workflows already are, and Comfy Desktop downloads their models. If the instance rejects the workflow, the test stops and the error appears in the logs. Runs the instance accepts but that fail during execution are counted as failed runs and left out of the duration statistics.
diff --git a/installation/desktop/usage/settings.mdx b/installation/desktop/usage/settings.mdx
index 74b49f62ad..30bc49ac50 100644
--- a/installation/desktop/usage/settings.mdx
+++ b/installation/desktop/usage/settings.mdx
@@ -7,25 +7,39 @@ sidebarTitle: "Settings"
Click the ☰ menu (1) in the top-left corner and select **Desktop Settings** (2) to open the global settings panel.
-
+
The settings panel is organized into five tabs. Click a tab in the sidebar to switch views.
## Preferences
-
+
+
+The Preferences tab opens with a **Language** picker, then groups the rest of its controls into three sections.
- **Language**: Choose the display language. **English** and **中文** are available.
+
+### App Behavior
+
- **Auto-launch on startup**: Pick which instance to start when Comfy Desktop opens. **None (show dashboard)** is the default. You can also choose **Last used instance**, or a specific install.
- **Confirm before closing a window**: Ask for confirmation before closing a window that is running a local install.
- **Warn before running multiple instances**: Show a warning before launching another local ComfyUI instance while one is already running or starting.
- **Hide Cloud from the Instance Picker**: Hide the Cloud row from the Dashboard. Cloud still works if you re-enable this later.
+
+### Privacy
+
- **Share anonymous usage telemetry**: Send anonymous usage data to help improve Comfy Desktop.
-- **Comfy Desktop**: Link to the [Comfy Desktop GitHub repository](https://github.com/Comfy-Org/Comfy-Desktop).
+- **Opt-in to beta features**: Let Comfy Desktop turn on early Core features for your instances. The switch stays disabled until you confirm data sharing with **Share anonymous usage telemetry**, even when telemetry is already on.
+
+Beta features arrive as extra startup arguments, added on top of the ones you set yourself: Comfy Desktop never removes or replaces your own arguments. When a beta feature turns on for an instance, a card headed **A beta feature is on** appears in the title bar. **Got it** dismisses it, and **Settings** opens this panel on the opt-in switch. You can see which arguments a beta feature added in the instance's Startup Args tab, behind the **+N beta** pill next to **Startup Arguments**.
+
+### Community
+
+- **Comfy Desktop**: A card linking to the [Comfy Desktop GitHub repository](https://github.com/Comfy-Org/Comfy-Desktop), with a star count.
## Updates
-
+
- **Status**: Shows whether Comfy Desktop is up to date, the installed version, and the last check time.
- **Check for updates**: Manually check for a new version. Button changes to **Download** then **Install** when an update is available.
@@ -35,14 +49,14 @@ The settings panel is organized into five tabs. Click a tab in the sidebar to sw
The Storage tab is where you configure where Comfy Desktop finds and stores files. The key concept is **sharing**: instead of each instance having its own isolated models, inputs, and outputs, you set up shared directories accessible to all instances.
-
+
-- **Shared Models**: Each directory listed here is scanned for models by every instance. The directory marked **Primary** is where new models are saved by default.
+- **Shared Models**: Each directory listed here is scanned for models by every instance. New models download to the directory marked with the **DOWNLOADS** badge.
- 
+ 
- Click the folder icon to open a directory in your file manager.
- - Click the **...** menu (1) on a directory, then select **Make primary** (2) to change which directory new models save to.
+ - Click the **...** menu (1) on a directory, then select **Use for Model Downloads** (2) to make that directory the download target.
- Click **+ Add Shared Directory** to add more model directories.
- **Shared Input**: A shared path where all instances look for input files (images, videos, etc.).
- **Shared Output**: A shared path where all instances save generated outputs. Customizing this lets you keep all results in one place.
@@ -52,7 +66,7 @@ Per-instance overrides (include shared dirs, split input/output, extra model fol
## Advanced
-
+
- **Default Install Location**: Where new standalone instances are created. Click the folder icon to change it.
- **Use hardware acceleration**: Use the GPU to render Comfy Desktop. Restart Comfy Desktop for changes to take effect.
diff --git a/installation/desktop/windows.mdx b/installation/desktop/windows.mdx
index eb9c129c39..a730b2f4e1 100644
--- a/installation/desktop/windows.mdx
+++ b/installation/desktop/windows.mdx
@@ -26,7 +26,7 @@ import UpdateGuide from '/snippets/desktop/update.mdx'
Run the downloaded `.exe` installer (NSIS installer) and follow the prompts. After installation, launch Comfy Desktop from the Start Menu or desktop shortcut.

-When you first open the app, you'll see the **Welcome** screen where you can create your first installation.
+When you first open the app, the first-run setup asks how you want to run Comfy: on Comfy Cloud, or installed locally on this machine. See [First Launch](/installation/desktop/overview#first-launch) for the choices it collects.
diff --git a/ja/installation/desktop/faq.mdx b/ja/installation/desktop/faq.mdx
index 9a403a3388..198dc6b4a3 100644
--- a/ja/installation/desktop/faq.mdx
+++ b/ja/installation/desktop/faq.mdx
@@ -2,13 +2,13 @@
title: "Comfy Desktop FAQ"
description: "Comfy Desktop に関するよくある質問とトラブルシューティング"
sidebarTitle: "FAQ"
-translationSourceHash: d746efac
+translationSourceHash: 4acea027
translationFrom: installation/desktop/faq.mdx
translationBlockHashes:
- "General Questions": 3de4ef1d
+ "General Questions": 9176b487
"Installation & Setup": b5578878
"Usage": 7a9bf578
- "Troubleshooting": 3c763877
+ "Troubleshooting": e89f60c3
---
## 一般質問
@@ -24,6 +24,16 @@ Comfy Desktop は完全に書き直された**マルチインストレーショ
Comfy Desktop は複数のインストール方法の一つです。**Portable(Windows)**、**手動インストール**、または **Comfy Cloud** も引き続き利用できます。Desktop は使いやすさとワンクリックアップデート、スナップショット管理などの機能から、ほとんどのユーザーに推奨されています。
+
+いいえ。Comfy Desktop は起動直後と、その後 10 分ごとに新しいバージョンを確認し、この確認はオフにできません。唯一のアップデート設定は **Desktop Settings → Updates** の **Automatically install Desktop updates** で、既定でオンになっています。
+
+- **オンの場合**:新しいバージョンはバックグラウンドでダウンロードされ、確認なしでインストールされます。ダウンロード中はタイトルバーに **Downloading update…**、適用の準備ができると **Desktop Update Ready** が表示されます。
+- **オフの場合**:Comfy Desktop は引き続き確認して知らせますが、自動ではダウンロードしません。代わりにタイトルバーに **Desktop Update** ピルが表示され、クリックすると更新がダウンロードされ、再起動を促されます。
+
+インスタンス内の ComfyUI バージョンは別に更新します。インスタンスの **Update** タブで **Stable** または **Latest on GitHub** チャンネルを選んで更新してください。
+
+Linux では、アプリ内アップデーターは `.deb` インストールには適用されません。[共通ダウンロードリンク](https://dl.todesktop.com/241130tqe9q3y)から新しいパッケージをダウンロードし、`sudo apt install ./*.deb` でインストールしてください。
+
## インストールとセットアップ
@@ -125,6 +135,11 @@ Desktop アプリはローテーションする `app.log` ファイルに書き
ComfyUI プロセスの出力(Desktop アプリ本体ではない)を確認するには、インスタンスの **管理** パネルを開き、**ターミナル** タブを使用してください。[管理](/ja/installation/desktop/usage/manage) を参照。
+
+ComfyUI は拡散モデルのバックエンドとして [Ollama](https://ollama.ai) をネイティブ統合していません。ただし、ComfyUI Manager レジストリの**カスタムノード**を通じて、Ollama が提供する LLM をプロンプト生成やテキスト処理に利用できます。
+
+LLM サービスへの接続については、[カスタムノードのインストール](/ja/installation/install_custom_node)を参照してください。
+
Comfy Desktop とそのインストールはディスク上で分離されています。アプリとインストールをアンインストールするには:
diff --git a/ja/installation/desktop/overview.mdx b/ja/installation/desktop/overview.mdx
index 271012080e..d1fea345a4 100644
--- a/ja/installation/desktop/overview.mdx
+++ b/ja/installation/desktop/overview.mdx
@@ -3,8 +3,15 @@ title: "Comfy Desktop 概要"
description: "Comfy Desktop の概要:生成 AI 向けノードベースエンジンである ComfyUI の複数インスタンスをインストール・管理・起動するデスクトップアプリ。"
icon: "desktop"
sidebarTitle: "概要"
-translationSourceHash: f1e6d02d
+translationSourceHash: 41336356
translationFrom: installation/desktop/overview.mdx
+translationBlockHashes:
+ "_intro": 7b398eef
+ "Get Started": 5c67594c
+ "First Launch": 9b929553
+ "Usage Guide": 676a0e69
+ "Migrate from Legacy Desktop": 3004732b
+ "Open Source": 52e2900a
---
**Comfy Desktop** は、一つのランチャーから複数の ComfyUI インスタンスをインストール、管理、起動できるデスクトップアプリケーションです。
@@ -33,6 +40,54 @@ Comfy Desktop は **Windows 10+**、**macOS 13+(Apple Silicon)**、**Linux**
+## 初回起動
+
+Comfy Desktop を初めて開くと、全画面の初回セットアップが表示され、**How do you want to run Comfy?** を尋ね、何かをインストールする前に必要な選択を集めます。完了するまでウィンドウはこのセットアップのままです。途中でアプリを閉じた場合は、次回起動時に同じ画面が再び表示されます。
+
+### クラウドかローカルか
+
+
+
+ComfyUI を実行する 2 つの方法が 2 枚のカードで示されます:
+
+- **クラウド**:ComfyUI は Comfy Cloud の GPU 上で実行されます。ローカルには何もインストールされず、ダウンロードも不要です。無料の Cloud 実行回数が利用できる間は、カードに **TRY FREE** ピルが表示されます。
+- **ローカル**:このマシンに ComfyUI をインストールします。ComfyUI のバージョン、カスタムノード、起動引数を自分で管理でき、オフラインでも動作します。
+
+このマシンの GPU がほとんどのワークフローを動かすには十分でないと Comfy Desktop が判断した場合、クラウドのカードに **Recommended for your hardware** バッジが付き、どちらのカードも事前選択されません。既定値に頼らず、意図的に選ぶ形になります。カードを選ぶまで **Continue** は押せません。
+
+### 利用規約とデータ共有
+
+カードの下に 3 つのチェックボックスがあります:
+
+- **I agree to the EULA and Terms of Service**:必須です。リンクから EULA、利用規約、プライバシーポリシーを開けます。このセットアップを実行するたびに、チェックを入れるまで **Continue** は先に進みません。
+- **Help improve Comfy by sharing anonymous usage data**:任意で、既定でオンです。Comfy Desktop が送信するのは匿名の利用データのみで、ワークフローの内容、プロンプト、生成されたメディア、個人情報は収集しません。後から [デスクトップ設定](/ja/installation/desktop/usage/settings) で変更できます。
+- **Opt in to beta features and help test what ships next**:任意で、既定でオンです。データ共有がオンの間だけ利用できます。データ共有をオフにすると、このチェックも外れます。
+
+### クイックインストール(Express Install)
+
+
+
+**ローカル** を選ぶと、**Express Install with recommended settings** チェックボックスが表示されます。既定ではオフなので、ディスクに何かを書き込む前に、インストールウィザードが ComfyUI バージョン、インストール先、起動オプションを表示します。チェックを入れるとその手順を省略し、推奨設定で Standalone インスタンスを直接インストールします。チェックを入れると、検出したハードウェアがチェックボックスの下に表示されるので、検出された GPU が使いたいものと違う場合はチェックを外してください。
+
+### 既存インストールの移行
+
+マシン上に Legacy Desktop のインストールが見つかると、Express Install の隣に **Migrate existing instance** チェックボックスが表示され、既定でオンになります。オンのまま続行すると、ワークフロー、モデル、設定が引き継がれます。移行される内容は [Legacy Desktop からの移行](/ja/installation/desktop/usage/migrate) を参照してください。チェックを外すと新しいインスタンスをインストールします。両方のチェックを外すと、インストールを開始する前に改めて確認されます。**Migrate** を選ぶと Legacy Desktop のインストールを引き継ぎ、**Start Fresh** を選ぶと既存のプロジェクトをそのままにクリーンなインスタンスをインストールします。
+
+### 中国ミラー
+
+アプリが中国語で動作している場合、**Continue** の後に質問が 1 つ追加されます:**Enable Chinese Mirrors?** **Enable Mirrors** を選ぶと、Git リポジトリを `gitcode.com` からクローンし、PyPI パッケージを Aliyun と Tencent のミラーから取得します(`github.com` と `pypi.org` の代わり)。中国本土ではこちらが高速です。**Not now** を選ぶと既定のままです。どちらを選んでも **Use Chinese Mirrors (Git & PyPI)** 設定として保存されるため、後から変更できます。
+
+### セットアップ完了後
+
+**Continue** は選択内容を保存し、短く **Preparing your install…** を表示します。
+
+- **クラウド**:Comfy Desktop はセットアップを閉じて Comfy Cloud を起動します。
+- **ローカル**:Express Install がオンの場合を除きインストールウィザードが実行され、進行状況が表示されます。完了したインスタンスはダッシュボードに表示されます。
+
+Comfy Desktop にすでにスタンドアロン、追跡、リモートのいずれかのインストールがある場合、クラウドかローカルかの選択は省略され、利用規約に同意するとそのままダッシュボードに進みます。利用規約への同意は、セットアップを実行するたびに必要です。
+
+このセットアップは全画面表示で、開いている間はタイトルバーがロックされます。同意ステップを抜けると、アプリメニュー(☰)は **Skip Onboarding** の 1 項目だけになり、これを選ぶと何もインストールせずにセットアップを閉じてダッシュボードに移動します。
+
## 使い方ガイド
インストール後は、以下のガイドをご覧ください:
@@ -55,4 +110,4 @@ Comfy Desktop は **Windows 10+**、**macOS 13+(Apple Silicon)**、**Linux**
## オープンソース
-Comfy Desktop のソースコードは [GitHub](https://github.com/Comfy-Org/Comfy-Desktop) にあります。ライセンスはデュアルライセンスです:AGPL-3.0-or-later、または Comfy Org の商用ライセンスです。
\ No newline at end of file
+Comfy Desktop のソースコードは [GitHub](https://github.com/Comfy-Org/Comfy-Desktop) にあります。ライセンスはデュアルライセンスです:AGPL-3.0-or-later、または Comfy Org の商用ライセンスです。
diff --git a/ja/installation/desktop/usage/downloads.mdx b/ja/installation/desktop/usage/downloads.mdx
index 9bc4d06243..57a6458ee3 100644
--- a/ja/installation/desktop/usage/downloads.mdx
+++ b/ja/installation/desktop/usage/downloads.mdx
@@ -3,14 +3,14 @@ title: "Comfy Desktop のモデルダウンロード"
description: "Comfy Desktop でモデルと出力のダウンロードを追跡し、進行状況の確認、再試行、一時停止、保存先の確認ができます。"
icon: "download"
sidebarTitle: "ダウンロード"
-translationSourceHash: e46f0fe2
+translationSourceHash: dbab8907
translationFrom: installation/desktop/usage/downloads.mdx
translationBlockHashes:
"_intro": b76dd6b3
"What appears in the downloads list": c70b88e8
"The Downloads tray": d7e19e28
"The full downloads view": 8c2018ce
- "Where downloads are saved": ffbe39a3
+ "Where downloads are saved": 1cf62540
---
Comfy Desktop はインスタンス用のモデルをダウンロードし、すべての転送を 1 か所で追跡します。ComfyUI インスタンスがまだディスク上にないモデルを要求すると、Comfy Desktop がダウンロードを処理し、そのファイルをインスタンスのモデルディレクトリに保存します。手動で配置する必要はありません。
@@ -51,6 +51,6 @@ Comfy Desktop はインスタンス用のモデルをダウンロードし、す
## ダウンロードの保存先
-モデルファイルはインスタンスのプライマリモデルディレクトリに書き込まれます。インスタンスが共有モデルディレクトリを含む場合は**プライマリ**とマークされた共有モデルディレクトリ、含まない場合はインスタンス自身の `models` フォルダーです。共有ディレクトリは [Desktop Settings](/ja/installation/desktop/usage/settings#ストレージ) で設定し、各インスタンスは **Manage** パネルの[ストレージタブ](/ja/installation/desktop/usage/manage#ストレージタブ)で共有ディレクトリを含めないようにできます。
+モデルファイルはインスタンスのモデルダウンロード先ディレクトリに書き込まれます。インスタンスが共有モデルディレクトリを含む場合は **DOWNLOADS** バッジ(**Use for Model Downloads** で設定)の付いた共有モデルディレクトリ、含まない場合はインスタンス自身の `models` フォルダーです。共有ディレクトリは [Desktop Settings](/ja/installation/desktop/usage/settings#ストレージ) で設定し、各インスタンスは **Manage** パネルの[ストレージタブ](/ja/installation/desktop/usage/manage#ストレージタブ)で共有ディレクトリを含めないようにできます。
リモートインスタンスからダウンロードした出力は、インスタンスが共有出力フォルダーを使用している場合はそこに、そうでなければインスタンス自身の出力フォルダーに保存されます。リモートインスタンスでは、ストレージ設定の **Auto-Download Outputs** で出力の自動ダウンロードをオフにできます。
diff --git a/ja/installation/desktop/usage/instance-management.mdx b/ja/installation/desktop/usage/instance-management.mdx
index 22e495794c..1df83f03d6 100644
--- a/ja/installation/desktop/usage/instance-management.mdx
+++ b/ja/installation/desktop/usage/instance-management.mdx
@@ -3,12 +3,13 @@ title: "インスタンス管理"
description: "Comfy Desktop で ComfyUI インスタンスの作成、編集、名前変更、削除を行う"
icon: "plus"
sidebarTitle: "インスタンス"
-translationSourceHash: f55298e4
+translationSourceHash: 992d3d91
translationFrom: installation/desktop/usage/instance-management.mdx
translationBlockHashes:
- "_intro": 88d901c8
- "Creating a New Instance": b161e6b2
+ "_intro": eb7803d3
+ "Creating a New Instance": 1df7f4d4
"Tracking an Existing Installation": 488339c2
+ "Launching, Stopping, and Restarting an Instance": 95513898
"Uninstalling an Instance": 9196aa8c
"Copying an Installation": 6131deee
"Editing an Instance": cc4950f9
@@ -59,6 +60,9 @@ Chooser ビューで左上の **+** カードをクリックして新しい Comf

+
+ 
+
1. **名前**:インスタンスの名前。デフォルトは "ComfyUI" です。
@@ -72,6 +76,8 @@ Chooser ビューで左上の **+** カードをクリックして新しい Comf
+
+

Comfy Desktop が残りの作業(Python のダウンロード、環境構築、ComfyUI のインストール)を自動的に行います。進捗画面に現在のステップが表示されます。
@@ -137,6 +143,41 @@ Comfy Desktop が残りの作業(Python のダウンロード、環境構築
> **注意:** 追跡インストールは `launchMode: 'external'` モードを使用します。Comfy Desktop は既存の ComfyUI プロセスを起動しますが、内部管理は行いません。現在スナップショットは Standalone インスタンスのみでサポートされています。
+## インスタンスの起動・停止・再起動
+
+[↩ 概要に戻る](#overview)
+
+### インスタンスを起動する
+
+Chooser でインスタンスのカードをクリックすると起動します。ComfyUI の起動中はウィンドウに起動の進行状況が表示され、サーバーの準備が整うと ComfyUI の画面に切り替わります。
+
+### 別のインスタンスの実行中に起動する
+
+ローカルインスタンスが実行中または起動中のときに別のローカルインスタンスを起動すると、Comfy Desktop は **An instance is already running** ダイアログを表示し、停止されるインスタンスを一覧で示します:
+
+- **Close & Launch**:一覧のインスタンスを停止してから、選択したインスタンスを起動します。
+- **Run All**:新しいインスタンスを、実行中のインスタンスと同時に起動します。
+
+ダイアログを閉じると起動はキャンセルされます。インスタンスの再起動時にこのダイアログは表示されません。表示しないようにするには、[デスクトップ設定 → 環境設定](/ja/installation/desktop/usage/settings#環境設定)で **Warn before running multiple instances** をオフにします。
+
+### インスタンスを停止する
+
+インスタンスカードの三点メニューで **Stop** を選択します。ComfyUI サーバーが停止し、ウィンドウは開いたまま **ComfyUI is stopped** カードが表示されます。**Relaunch ComfyUI** でサーバーを再度起動するか、**Return to Dashboard** で Chooser に戻ります。
+
+### クラッシュ後の再起動
+
+ComfyUI が起動に失敗した場合や予期せず終了した場合、ウィンドウは開いたまま、状況を説明するカードが表示されます:
+
+- **ComfyUI could not start**:インスタンスが起動しませんでした。
+- **ComfyUI exited unexpectedly**:プロセスが終了しました。Comfy Desktop が読み取れる場合、カードには終了コードまたは終了シグナルも表示されます。
+
+Windows では、クラッシュ時にメモリアクセス違反として報告され、Microsoft Visual C++ 再頒布可能パッケージの一部が不足している可能性が示されることがあります。カード内のログを展開して詳細を確認し、**Restart ComfyUI** で再度起動するか、**Back** でダッシュボードに戻ります。
+
+ComfyUI がインストール内に保持しているアセットデータベースを開けずに停止した場合、停止時のエラーには終了コードだけでなく原因が示されます:
+
+- **別の ComfyUI がこのインストールのデータベースを使用している場合**:その ComfyUI(またはそれを起動したアプリ)を終了するか、`--database-url` 起動引数でどちらか一方に専用のデータベース位置を指定します。
+- **その他のデータベース障害**(別のプログラムによるロック、新しいバージョンの ComfyUI が書き込んだデータベース、そのフォルダーに作成できない場合):メッセージにデータベースのファイルと対処方法が示され、最後に起動引数へ `--disable-assets` を追加してアセットシステムなしで起動する選択肢が示されます。
+
## インスタンスのアンインストール
[↩ 概要に戻る](#overview)
diff --git a/ja/installation/desktop/usage/manage.mdx b/ja/installation/desktop/usage/manage.mdx
index d07362b0d9..437078a904 100644
--- a/ja/installation/desktop/usage/manage.mdx
+++ b/ja/installation/desktop/usage/manage.mdx
@@ -3,10 +3,10 @@ title: "インストール管理"
description: "ComfyUI インスタンスの起動、更新、スナップショット、管理"
icon: "sliders"
sidebarTitle: "インストール管理"
-translationSourceHash: 89b2392a
+translationSourceHash: 838d9683
translationFrom: installation/desktop/usage/manage.mdx
translationBlockHashes:
- "The Manage Panel": 49a42092
+ "The Manage Panel": 7944c50d
"Installation Actions": 3bf198ca
---
@@ -43,7 +43,7 @@ translationBlockHashes:
スタートアップCLI引数、マネージャーポリシー、起動モード、ブラウザキャッシュの共有、ポート競合時の動作、環境変数を設定します。
-- **スタートアップ引数**: ComfyUIのカスタムCLI引数(例: `--listen`)。歯車アイコンをクリックすると、カテゴリ別のフラグが表示されます。
+- **スタートアップ引数**: ComfyUIのカスタムCLI引数(例: `--listen`)。歯車アイコンをクリックすると、カテゴリ別のフラグが表示されます。ベータ機能が有効な場合、フィールドの隣の **+N beta** ピルに、Comfyデスクトップが実行中のセッションに追加したベータ引数、または次回の起動で適用される引数が表示されます。
- **マネージャーのセキュリティレベル**: このインスタンスに対してComfyUI-Managerがインストールできるノードパックを制御します。次回の起動時に適用されます。
- **厳格**: すべてのノードパックのインストール、更新、アンインストールをブロックします。マネージャーは読み取り専用になります。
- **スタンダード(推奨)**: 登録済みのノードパックを許可します。未登録ソース(任意のgit URLなど)からのインストールをブロックします。
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/ja/installation/desktop/usage/overview.mdx b/ja/installation/desktop/usage/overview.mdx
index 35eceb7d4b..f02b5fe688 100644
--- a/ja/installation/desktop/usage/overview.mdx
+++ b/ja/installation/desktop/usage/overview.mdx
@@ -3,11 +3,11 @@ title: "Comfy Desktop の使い方"
description: "Comfy Desktop の使用概要 — 新規インストール、インスタンス管理など"
icon: "book-open"
sidebarTitle: "概要"
-translationSourceHash: 651b33ae
+translationSourceHash: ebaea3ac
translationFrom: installation/desktop/usage/overview.mdx
translationBlockHashes:
"_intro": d96e3242
- "Dashboard Overview": 60e63628
+ "Dashboard Overview": 0cc8797c
"Feedback and Issues": 9304f358
---
@@ -34,17 +34,36 @@ Comfy Desktop ウィンドウはいくつかの主要エリアに分かれてい
### アプリケーションメニュー
-左上のハンバーガーメニュー(☰)からアプリケーションメニュー(File / Edit / View / Window / Help)を開きます。新しいウィンドウの表示、**デスクトップ設定**へのアクセス、Comfy アカウントへの**ログイン**、アプリの終了など、その他のデスクトップレベルの操作も行えます。
+
-
+左上のハンバーガーメニュー(☰)からアプリケーションメニューを開きます。アプリレベルの操作はすべてここにあります:
+
+- **Open Dashboard**:Dashboard を新しいウィンドウで開きます。実行中のインスタンスはそのまま動作し続けます。
+- **New Instance** と **Add Existing Instance**:新しいインスタンスを作成するか、既存の ComfyUI インストールを登録します。
+- **Load Snapshot**:他のユーザーが共有したスナップショットファイルからインスタンスを作成します。
+- **Log in**:Comfy アカウントにサインインします。この項目は未サインインのときだけ表示されます。
+- **Performance Tests**:インスタンスに対して計測付きのワークフローを実行します。詳しくは[パフォーマンステストとベンチマーク](/ja/installation/desktop/usage/performance-tests)を参照してください。
+- **Benchmarks**:保存されたパフォーマンステストの結果を、ハードウェア、ワークフロー、インスタンスごとに比較します。
+- **Desktop Settings**:自動更新、プロキシ/ミラー、共有ストレージ、データの保存場所に関するグローバル設定です。
+- **Send Feedback**:フィードバックパネルを開きます。
+- **Close Window** と **Quit Desktop**:現在のウィンドウを閉じるか、アプリを終了します。インスタンスのウィンドウを閉じるとそのウィンドウが実行している ComfyUI インスタンスが停止し、最後のウィンドウを閉じると Comfy Desktop が終了します。
+
+状況に応じてのみ表示される項目が 2 つあります:ComfyUI ビューがズームされているときの **Reset Zoom (N%)** と、初回セットアップ中の **Skip Onboarding** です。初回セットアップが表示されている間は、**Skip Onboarding** がメニュー内の唯一の項目です。
+
+macOS では、アプリケーションメニューと編集、ウインドウの各メニューを含むシステムメニューバーも維持されます。Windows と Linux のビルドにはシステムメニューバーがありません。
+
+
グローバル設定:自動更新、プロキシ/ミラー、共有ストレージ、データの保存場所。
+
+ インスタンス上でワークフローの速度を測定し、ハードウェアごとに実行結果を比較します。
+
### インスタンス切り替え
-中央のピルには、現在アクティブな ComfyUI インスタンスの名前が表示されます。クリックすると**インスタンスピッカー**が開きます。このポップオーバーには、インストール済みのすべてのインスタンスとその実行状態が一覧表示され、インスタンスの切り替えや新規起動ができます。
+中央のピルには、現在アクティブな ComfyUI インスタンスの名前が表示されます。クリックすると**インスタンスピッカー**が開きます。このポップオーバーには、インストール済みのすべてのインスタンスとその実行状態が一覧表示され、インスタンスの切り替えや新規起動ができます。そのインスタンスで新しい ComfyUI バージョンが利用可能になると、ピルに **Update** チップが表示され、クリックするとピッカーを開かずに更新できます。
@@ -54,11 +73,15 @@ Comfy Desktop ウィンドウはいくつかの主要エリアに分かれてい
### 右側のボタン
-タイトルバー右側に配置されたボタン群は、次の操作へのクイックアクセスを提供します:
+
+
+タイトルバー右側のコントロールから、次の操作へ素早くアクセスできます:
- **Desktop Update**:Comfy Desktop の新しいバージョンが利用可能になると、ここにピルが表示されます。クリックして更新をダウンロードし、適用します。
+- **Reset Zoom**:ComfyUI ビューのズームが 100% 以外のとき、現在のズーム率を示すピルが表示されます。クリックすると 100% に戻ります。
+- **What's new**:お知らせパネルを開きます。お知らせでは、ComfyUI の新機能や Comfy 製品のリリースを、短い動画、ハイライト、詳細へのリンクとともに紹介します。未確認のお知らせがあるとベルにドットが表示され、パネルを開くとドットが消えます。
- **Feedback**:Comfy Desktop チームにフィードバックを送信します。
-- **Downloads**:ダウンロードトレイを開き、進行中および最近のダウンロードを確認します。
+- **Downloads**:ダウンロードトレイを開きます。バッジは実行中のダウンロード数を示し、失敗したダウンロードや未確認のダウンロードを強調します。トレイでは失敗したダウンロードの再試行や、実行中のダウンロードのキャンセルができます。**View All Downloads** で一覧を開くと、一時停止と再開もできます。
### 検索ボックス
diff --git a/ja/installation/desktop/usage/performance-tests.mdx b/ja/installation/desktop/usage/performance-tests.mdx
new file mode 100644
index 0000000000..4e3456a4da
--- /dev/null
+++ b/ja/installation/desktop/usage/performance-tests.mdx
@@ -0,0 +1,155 @@
+---
+title: "パフォーマンステストとベンチマーク"
+description: "Comfy Desktop のパフォーマンステストで ComfyUI ワークフローの速度を測定し、ベンチマークで GPU、ワークフロー、インスタンスごとに実行結果を比較できます"
+icon: "gauge"
+sidebarTitle: "パフォーマンステスト"
+translationSourceHash: 429915c2
+translationFrom: installation/desktop/usage/performance-tests.mdx
+translationBlockHashes:
+ "_intro": 7a65e6d8
+ "Running a Performance Test": d3b8adb1
+ "Comparing Runs with Benchmarks": b85e9c09
+ "Where results are stored": afbb1b95
+ "Requirements": f8a3cde3
+---
+**Performance Tests** は、ComfyUI ワークフローがお使いのインスタンスの 1 つで実行されるのにかかる時間を測定します。インスタンスを選択し、ワークフローを読み込むと、Comfy Desktop がそれを指定した実行回数だけ実行し、測定対象の各実行を計測して、最速、最遅、平均、中央値の所要時間を、その数値の基になったハードウェアとソフトウェアとともに報告します。
+
+**Benchmarks** は、記録されたこれらの結果を比較します。保存されたすべての実行を一覧表示し、ワークスペース、インスタンス、ハードウェア、またはワークフローでフィルタリングし、選択済みの実行を相対速度係数とともに並べて表示するので、ある GPU、ワークフロー、インスタンスが別のものよりどれだけ速いかを確認できます。
+
+どちらのパネルもアプリメニューから開きます。左上隅の ☰ メニューをクリックし、**Performance Tests** または **Benchmarks** を選択します。
+
+
+
+
+Performance Tests は実際のインスタンスで実際のワークフローを実行するため、テストにかかる時間は、ワークフロー自体の時間に実行回数を掛けた程度になります。インポートするワークフローは、事前に [API 形式](/ja/development/api-development/workflow-api-format) でエクスポートしておく必要があります。Comfy Desktop に同梱のサンプルワークフローは、すでにこの形式です。
+
+
+## パフォーマンステストの実行
+
+パネルは3つの番号付きステップが横並びで構成されています。ウィンドウが狭いときは縦に積み重なります。
+
+
+
+### 1. インスタンスを選択
+
+テストする**ワークスペース**と**インスタンス**を選択します。インスタンスとそのハードウェアは結果とともに記録されるため、後で比較する際に意味を持ちます。異なるGPUでの実行を区別したまま保てます。
+
+テストを開始すると、Comfy Desktop はそのインスタンスの前回のパフォーマンステストセッションがまだ実行中であれば停止し、そのインスタンスをコンソールセッションで起動します。他のローカル ComfyUI が実行中、起動中、または停止中である間はテストの開始を拒否し、妨げになっているインスタンスを通知に表示します。それらを停止するか、起動または停止が完了するのを待ってから、もう一度テストを実行してください。Comfy Cloud やリモートのインスタンスは別の場所で実行されるため、テストを妨げません。ゲームや動画の書き出しなど、GPU を占有する他の作業は測定値に影響するため、テストを実行する前に停止してください。
+
+### 2. ワークフローを選択
+
+Comfy Desktop に同梱のサンプルワークフローを選ぶか、自分のワークフローを持ち込むかを選べます。
+
+**サンプルワークフロー**はすぐに実行でき、必要なモデルは自動でダウンロードされます。**Choose an example workflow** をクリックするとピッカーが開きます。ピッカーはサンプルをモダリティ別のタブ(Video、Image、3D、Audio。例があるモダリティにのみタブが表示されます)に分類し、各カードにはサンプルの名前、タスク、モデルのダウンロードサイズが表示されます。**Use workflow** をクリックして 1 つ選択します。その後 Comfy Desktop がワークフローに不足しているモデルをダウンロードし、ドロップゾーンに完了までの進行状況が表示されます。サンプルを使うには、インスタンスのインストールが完了していて、オンラインである必要があります。モデルが空きディスク容量に収まらない場合、ピッカーは選択をブロックします。サンプルワークフローはインスタンスに紐づきます。別のインスタンスに切り替えると、前のインスタンス用に準備したサンプルは破棄されます。ただし、そのサンプルのセッションにすでに結果が記録されている場合は残ります。
+
+**自分のワークフロー**を使う場合は、あらかじめ [API フォーマット](/ja/development/api-development/workflow-api-format) でエクスポートしておく必要があります。`.json` ファイルをドロップゾーンにドロップするか、ゾーンをクリックしてファイルを選択します。
+
+
+
+どちらの方法でも、Comfy Desktop はワークフローをテストセッションフォルダーにコピーするため、オリジナルのファイルを移動したり編集した後でもテストは実行されます。
+
+### 3. 測定設定を行う
+
+| 設定 | 範囲 | デフォルト | 内容 |
+|---------|-------|---------|--------------|
+| **ウォームアップ実行** | 1〜5 | 1 | 最初に実行され、モデルをロードしてキャッシュをウォームアップする実行。結果には含まれません。 |
+| **測定実行** | 1〜100 | 5 | ウォームアップ実行の後に計測される実行。その所要時間が結果の計算に使用されます。 |
+
+各実行はワークフローの数値シード入力を1ずつ進めるため、測定実行で同一のキャッシュ結果が繰り返されることはありません。
+
+3つのステップを設定したら、**Run** をクリックしてテストを開始します。隣の **Stop** ボタンで進行中のテストを中止できます。
+
+### 結果を確認する
+
+テストの実行中、パネルには完了した実行数とインスタンスのログが表示されます。すべての実行が完了すると、インスタンスは停止し、結果が表示されます。
+
+- **最速実行**、**最遅実行**、**平均実行**、**中央値実行**(秒単位)
+- **測定実行**と**失敗実行**: 所要時間が得られた実行数と、得られなかった実行数
+- **実行所要時間の集計**: 4つの集計値(最速、最も遅い、平均、中央値)を比較する棒グラフ
+- **システム情報**: コンピュートデバイス、VRAM、RAM、PyTorchバージョン、xFormersバージョン、CPU、CPUコア数、オペレーティングシステム、アーキテクチャ
+
+実行の所要時間とは、ComfyUI がサーバー上でジョブを実行するのに費やした時間であり、あなたが待った時間ではありません。失敗した実行は別途カウントされ、統計からは除外されます。
+
+結果とともに2つのボタンが表示されます。**フォルダーを開く**はセッションフォルダーを開き、**結果をエクスポート**はサマリーとチャートをPNG画像として保存します。
+
+## ベンチマークで実行結果を比較する
+
+ベンチマークはパフォーマンステストが保存した結果を読み込むため、少なくとも1つのテストが完了するまで表示する内容はありません。
+
+### 実行ライブラリ
+
+**実行ライブラリ**には、結果フォルダーに保存されたすべての実行が新しい順に一覧表示されます。ツールバーには次のものがあります:
+
+- **フォルダーを選択**:パネルの参照先を別の結果フォルダー(たとえば共有ドライブ上のフォルダー)に変更します。既定では、パフォーマンステストが書き込むフォルダーです。詳しくは[結果の保存場所](#結果の保存場所)を参照してください。
+- **セッションを更新**:別の場所でテストが完了した後にフォルダーを再読み込みします。
+- **実行を検索**:テキストで一覧を絞り込みます。
+- ワークスペース、インスタンス、ハードウェア、ワークフローで絞り込むドロップダウンフィルター。
+- **プロパティ**:ライブラリに表示する列(セッション、日付と時間、ワークフロー、インスタンス、ワークスペース、実行回数、GPUとハードウェア)を選択します。
+
+
+
+### 実行を比較する
+
+チェックボックスで2つ以上の実行を選択するか、**表示中のすべての実行を選択**を使用します。ライブラリの読み込み時には、最新の3つの実行が自動的に選択されます。選択すると、ライブラリの下に**比較**セクションが開きます。
+
+比較では、選択した実行ごとに1つの列が、メトリクスの行と並べて表示されます。行には最速、平均、中央値、最も遅い所要時間、および測定された実行回数があります。1つの実行が**ベースライン**になります。既定では、最初に表示される列がベースラインです。**速度**ビューで列見出しをクリックすると、代わりにその実行をベースラインにできます。
+
+### 相対速度
+
+比較には**所要時間**と**速度**の 2 つのビューがあり、比較ツールバーで切り替えます。相対速度は**速度**ビューに属し、ベースラインもこのビューで選択します。
+
+**相対速度**は、ベースラインの所要時間をその実行の所要時間で割った値です:
+
+- **1.00×** は、その実行がベースラインと同じ速度であることを意味します
+- 1.00× より大きい係数は、その実行がベースラインより**高速**であることを意味します
+- 1.00× より小さい係数は、その実行がベースラインより**低速**であることを意味します
+
+**速度**ビューは各実行を対数軸上にプロットし、左に**低速**、右に**高速**が来るようにするため、2xと4xの差も同じチャート上で読み取れます。**所要時間**ビューでは、各実行の最速と最も遅い結果が線として描画され、平均がマークされます。有効な所要時間がない実行は利用不可と表示されます。
+
+
+
+### 並び替えとエクスポート
+
+- **比較を並び替え**は、列を相対速度順に並べます。**手動並び替え**では、列をドラッグして任意の順序にできます。または、フォーカスした列で Alt+Left / Alt+Right を押します。
+- **結果をエクスポート**は、比較全体をPNG画像として保存します。結果をIssueやチャットメッセージに添付する最短の方法です。
+
+### セッションの管理
+
+各テストはセッションとして保存されます。ライブラリから、セッションの名前を変更したり(**セッションを編集**)、削除したり(**削除**)できます。削除すると、そのセッションに記録されたすべてのファイルが削除されます。
+
+## 結果の保存場所
+
+Performance Tests は、ワークフローをパネルに追加したときにセッションフォルダーを作成し、その時点のタイムスタンプ(`YYYYMMDDHHMMSS`)を名前として付けます。
+
+```
+📂 ComfyUI-Shared/
+└── 📂 benchmarks/
+ ├── 📂 20260930141522/
+ │ ├── my_workflow.json
+ │ ├── jobs.json
+ │ ├── results.json
+ │ └── logs.txt
+ └── 📂 20260930163005/
+ └── ...
+```
+
+| プラットフォーム | デフォルトの結果フォルダー |
+|----------|------------------------|
+| Windows | `%LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared\benchmarks` |
+| macOS / Linux | `~/ComfyUI-Shared/benchmarks` |
+
+各セッションフォルダーには次のものが含まれます。
+
+- パネルが使用したワークフローファイル
+- `jobs.json`: インスタンスから返された生のジョブ応答
+- `results.json`: Benchmarks パネルが読み取るサマリー
+- `logs.txt`: 実行時のインスタンスのコンソール出力
+
+Benchmarks は見つけたすべてのセッションフォルダーから `results.json` を読み取るため、セッションフォルダーを Benchmarks が参照するフォルダーにコピーするだけで、別のマシンの結果と比較できます。
+
+同じインポート済みワークフローをもう一度実行すると、結果は同じセッションフォルダーに書き込まれ、そこに保存されている結果が上書きされます。比較用に結果を残したい場合は、次のテストの前にワークフローをもう一度パネルに追加してください。
+
+## 要件
+
+- Comfy Desktop が起動できるスタンドアロン、追跡対象、またはリモートのインスタンス。テストには動作する ComfyUI インスタンスが必要なため、クラウドインスタンスに対して実行することはできません。
+- インスタンスが実行できるワークフロー。必要なモデルやカスタムノードも含みます。インポートするワークフローは API 形式である必要があります。サンプルワークフローはすでにその形式で、Comfy Desktop がモデルをダウンロードします。インスタンスがワークフローを拒否した場合、テストは停止し、エラーはログに表示されます。インスタンスが受け付けたものの実行中に失敗した実行は、失敗実行としてカウントされ、所要時間の統計から除外されます。
diff --git a/ja/installation/desktop/usage/settings.mdx b/ja/installation/desktop/usage/settings.mdx
index 77282f7a27..376b8cd175 100644
--- a/ja/installation/desktop/usage/settings.mdx
+++ b/ja/installation/desktop/usage/settings.mdx
@@ -3,14 +3,14 @@ title: "Comfy Desktop 設定"
description: "グローバル設定、テーマ、プロキシ/ミラー設定、データ保存場所"
icon: "cog"
sidebarTitle: "設定"
-translationSourceHash: 3c7fcc26
+translationSourceHash: e50dd605
translationFrom: installation/desktop/usage/settings.mdx
translationBlockHashes:
- "_intro": 21793e96
- "Preferences": e123ee00
- "Updates": b6db1add
- "Storage": 4bb5eadb
- "Advanced": 448c3a49
+ "_intro": 423ec831
+ "Preferences": ba98a2b9
+ "Updates": 60392d09
+ "Storage": 52d0d5f6
+ "Advanced": f4ef9849
"Logs": f8e4484f
"Data Locations": 12e5d644
"Keyboard Shortcuts": d36c977e
@@ -28,13 +28,27 @@ translationBlockHashes:

+環境設定タブはまず **言語** ピッカーで始まり、残りのコントロールは 3 つのセクションに分かれています。
+
- **言語**:表示言語を選択します。**English** と **中文** が利用できます。
+
+### アプリの動作
+
- **起動時の自動起動**:Comfyデスクトップを開いたときに起動するインスタンスを選択します。デフォルトは **なし(ダッシュボードを表示)** です。**最後に使用したインスタンス** または特定のインストールを選択することもできます。
- **ウィンドウを閉じる前に確認**:ローカルインストールを実行中のウィンドウを閉じる前に確認を求めます。
- **複数インスタンスの実行前に警告**:ローカルの ComfyUI インスタンスがすでに実行中または起動中のときに、別のインスタンスを起動する前に警告を表示します。
- **インスタンスピッカーからクラウドを非表示**:ダッシュボードからクラウドの行を非表示にします。後でこれを再度有効にすると、クラウドは引き続き機能します。
+
+### プライバシー
+
- **匿名利用テレメトリーを共有**:匿名の使用データを送信して、Comfyデスクトップの改善に役立てます。
-- **Comfyデスクトップ**:[Comfyデスクトップ GitHub リポジトリ](https://github.com/Comfy-Org/Comfy-Desktop) へのリンク。
+- **Opt-in to beta features**:Comfyデスクトップがインスタンスの Core 機能を先行して有効にできるようにします。**匿名利用テレメトリーを共有** でデータ共有を確認するまで、このスイッチは無効のままです。テレメトリーがすでに有効な場合でも同じです。
+
+ベータ機能は、自分で設定した起動引数の上に追加される形で渡されます。Comfyデスクトップが自分の引数を削除したり置き換えたりすることはありません。インスタンスでベータ機能が有効になると、タイトルバーに **A beta feature is on** というカードが表示されます。**Got it** で閉じ、**Settings** を選ぶとこのパネルのオプトインスイッチが開きます。ベータ機能が追加した引数は、そのインスタンスのスタートアップ引数タブで **スタートアップ引数** の隣にある **+N beta** ピルから確認できます。
+
+### コミュニティ
+
+- **Comfyデスクトップ**:[Comfyデスクトップ GitHub リポジトリ](https://github.com/Comfy-Org/Comfy-Desktop) へのリンクカードで、スター数を表示します。
## アップデート
@@ -50,12 +64,12 @@ translationBlockHashes:

-- **共有モデル**:ここにリストされた各ディレクトリは、すべてのインスタンスによってスキャンされます。**プライマリ**とマークされたディレクトリに、新しいモデルがデフォルトで保存されます。
+- **共有モデル**:ここにリストされた各ディレクトリは、すべてのインスタンスによってスキャンされます。**DOWNLOADS** バッジの付いたディレクトリに、新しいモデルがダウンロードされます。
- 
+ 
- フォルダアイコンでファイルマネージャーで開く。
- - ディレクトリの **...** メニュー(1)をクリックし **Make primary**(2)を選択するとプライマリを変更できます。
+ - ディレクトリの **...** メニュー(1)をクリックし **Use for Model Downloads**(2)を選択すると、そのディレクトリをダウンロード先にできます。
- **+ 共有ディレクトリを追加**でモデルディレクトリを追加。
- **共有入力**:すべてのインスタンスが入力ファイル(画像、動画など)を検索する共有パス。
- **共有出力**:すべてのインスタンスが生成結果を保存する共有パス。カスタマイズして出力を一元管理。
diff --git a/ja/installation/desktop/windows.mdx b/ja/installation/desktop/windows.mdx
index e2315ef813..11e47c0874 100644
--- a/ja/installation/desktop/windows.mdx
+++ b/ja/installation/desktop/windows.mdx
@@ -3,12 +3,12 @@ title: "Windows 向け Comfy Desktop"
description: "Windows に Comfy Desktop をインストール:システム要件、セットアップ手順、アップデート、Windows 10 以降で ComfyUI をローカル実行するためのクリーンなアンインストール。"
icon: "windows"
sidebarTitle: "Windows"
-translationSourceHash: 56205b32
+translationSourceHash: 592ccfc9
translationFrom: installation/desktop/windows.mdx
translationBlockHashes:
"_intro": 27d36d8f
"System Requirements": ceeec5a6
- "Installation": be718ecf
+ "Installation": 955f804c
"Updating Comfy Desktop": b0efe5cd
"Uninstalling": 4b80edaa
---
@@ -33,7 +33,7 @@ import UpdateGuide from "/snippets/ja/desktop/update.mdx"
ダウンロードした `.exe` インストーラー(NSIS インストーラー)を実行し、指示に従ってください。インストール後、スタートメニューまたはデスクトップのショートカットから Comfy Desktop を起動します。

-アプリを初めて開くと、最初のインストールを作成できる **Welcome** 画面が表示されます。
+アプリを初めて開くと、初回セットアップが Comfy の実行方法(Comfy Cloud か、このマシンへのローカルインストールか)を尋ねます。収集される選択の内容は [初回起動](/ja/installation/desktop/overview#初回起動) を参照してください。
diff --git a/ko/installation/desktop/faq.mdx b/ko/installation/desktop/faq.mdx
index adf2b0d712..03e988c972 100644
--- a/ko/installation/desktop/faq.mdx
+++ b/ko/installation/desktop/faq.mdx
@@ -2,13 +2,13 @@
title: "Comfy Desktop 자주 묻는 질문"
description: "Comfy Desktop에 대한 일반적인 질문과 문제 해결 팁"
sidebarTitle: "자주 묻는 질문"
-translationSourceHash: d746efac
+translationSourceHash: 4acea027
translationFrom: installation/desktop/faq.mdx
translationBlockHashes:
- "General Questions": 3de4ef1d
+ "General Questions": 9176b487
"Installation & Setup": b5578878
"Usage": 7a9bf578
- "Troubleshooting": 3c763877
+ "Troubleshooting": e89f60c3
---
## 일반 질문
@@ -24,6 +24,16 @@ Comfy Desktop은 **멀티 설치 관리자** 역할을 하는 완전히 새로
Comfy Desktop은 여러 설치 옵션 중 하나입니다. 필요에 따라 **Portable (Windows)** 설치, **Manual Install** 또는 **Comfy Cloud**를 계속 사용할 수 있습니다. Desktop은 사용 편의성과 원클릭 업데이트, 스냅샷 관리 같은 기능으로 인해 대부분의 사용자에게 권장됩니다.
+
+아니요. Comfy Desktop은 시작 직후와 이후 10분마다 새 버전을 확인하며, 이 확인은 끌 수 없습니다. 유일한 업데이트 설정은 **Desktop Settings → Updates**의 **Automatically install Desktop updates**이며, 기본값은 켜짐입니다.
+
+- **켜짐**: 새 버전이 백그라운드에서 다운로드되어 별도 확인 없이 설치됩니다. 다운로드 중에는 제목 표시줄에 **Downloading update…**가, 적용할 준비가 되면 **Desktop Update Ready**가 표시됩니다.
+- **꺼짐**: Comfy Desktop은 계속 확인하고 알려주지만, 자동으로 다운로드하지는 않습니다. 대신 제목 표시줄에 **Desktop Update** 알약이 표시되며, 이를 클릭하면 업데이트가 다운로드되고 다시 시작하라는 안내가 나옵니다.
+
+인스턴스 내부의 ComfyUI 버전은 별도로 업데이트합니다. 인스턴스의 **Update** 탭에서 **Stable** 또는 **Latest on GitHub** 채널을 선택해 업데이트하세요.
+
+Linux에서는 앱 내 업데이터가 `.deb` 설치에는 적용되지 않습니다. [범용 다운로드 링크](https://dl.todesktop.com/241130tqe9q3y)에서 새 패키지를 내려받아 `sudo apt install ./*.deb`로 설치하세요.
+
## 설치 및 설정
@@ -124,6 +134,11 @@ Desktop 앱은 순환되는 `app.log` 파일에 기록합니다. 가장 빠른
ComfyUI 프로세스 출력(Desktop 앱 자체가 아님)을 확인하려면 인스턴스의 **관리** 패널에서 **터미널** 탭을 사용하세요. [관리](/ko/installation/desktop/usage/manage)를 참조하세요.
+
+ComfyUI는 확산 모델 백엔드로 [Ollama](https://ollama.ai)를 네이티브로 통합하지 않습니다. 다만 ComfyUI Manager 레지스트리의 **커스텀 노드**를 통해 Ollama가 제공하는 LLM으로 프롬프트 생성과 텍스트 처리를 할 수 있습니다.
+
+LLM 서비스 연결은 [커스텀 노드 설치](/ko/installation/install_custom_node)를 참조하세요.
+
Comfy Desktop과 설치는 디스크에서 분리되어 있습니다. 앱과 설치를 제거하려면:
diff --git a/ko/installation/desktop/overview.mdx b/ko/installation/desktop/overview.mdx
index 04a049ba17..b75b867ace 100644
--- a/ko/installation/desktop/overview.mdx
+++ b/ko/installation/desktop/overview.mdx
@@ -3,8 +3,15 @@ title: "Comfy Desktop 개요"
description: "Comfy Desktop 개요: 생성형 AI를 위한 노드 기반 엔진인 ComfyUI의 여러 인스턴스를 설치, 관리, 실행하는 데스크톱 앱."
icon: "desktop"
sidebarTitle: "개요"
-translationSourceHash: f1e6d02d
+translationSourceHash: 41336356
translationFrom: installation/desktop/overview.mdx
+translationBlockHashes:
+ "_intro": 7b398eef
+ "Get Started": 5c67594c
+ "First Launch": 9b929553
+ "Usage Guide": 676a0e69
+ "Migrate from Legacy Desktop": 3004732b
+ "Open Source": 52e2900a
---
**Comfy Desktop**은 하나의 런처에서 여러 ComfyUI 인스턴스를 설치, 관리 및 실행할 수 있는 데스크톱 애플리케이션입니다.
@@ -33,6 +40,54 @@ Comfy Desktop은 **Windows 10 이상**, **macOS 13 이상 (Apple Silicon)**, **L
+## 첫 실행
+
+Comfy Desktop을 처음 열면 전체 화면 설정 화면이 나타나 **How do you want to run Comfy?** 를 묻고, 설치를 시작하기 전에 필요한 선택을 수집합니다. 완료할 때까지 창은 이 설정 화면에 머뭅니다. 중간에 앱을 닫으면 다음 실행 때 같은 화면이 다시 표시됩니다.
+
+### 클라우드 또는 로컬
+
+
+
+ComfyUI를 실행하는 두 가지 방식이 카드 두 장으로 표시됩니다.
+
+- **클라우드**: ComfyUI가 Comfy Cloud의 GPU에서 실행됩니다. 로컬에는 아무것도 설치되지 않고 다운로드도 필요하지 않습니다. 무료 Cloud 실행 횟수가 남아 있는 동안 카드에 **TRY FREE** 배지가 표시됩니다.
+- **로컬**: 이 컴퓨터에 ComfyUI를 설치합니다. ComfyUI 버전, 사용자 정의 노드, 시작 인수를 직접 관리할 수 있고 오프라인에서도 동작합니다.
+
+이 컴퓨터의 GPU가 대부분의 워크플로를 실행하기에 충분하지 않다고 Comfy Desktop이 판단하면 클라우드 카드에 **Recommended for your hardware** 배지가 붙고 어느 카드도 미리 선택되지 않습니다. 즉 기본값이 아니라 사용자가 직접 선택하게 됩니다. 카드를 선택하기 전까지 **Continue** 는 사용할 수 없습니다.
+
+### 약관 및 데이터 공유
+
+카드 아래에 체크박스 세 개가 있습니다.
+
+- **I agree to the EULA and Terms of Service**: 필수입니다. 링크에서 EULA, 이용약관, 개인정보 처리방침을 열 수 있습니다. 이 설정 화면을 실행할 때마다 체크해야 **Continue** 가 진행됩니다.
+- **Help improve Comfy by sharing anonymous usage data**: 선택 사항이며 기본적으로 켜져 있습니다. Comfy Desktop은 익명 사용 데이터만 전송하며 워크플로 내용, 프롬프트, 생성된 미디어, 개인 정보는 수집하지 않습니다. 나중에 [데스크톱 설정](/ko/installation/desktop/usage/settings) 에서 변경할 수 있습니다.
+- **Opt in to beta features and help test what ships next**: 선택 사항이며 기본적으로 켜져 있고, 데이터 공유가 켜져 있을 때만 사용할 수 있습니다. 데이터 공유를 끄면 이 체크도 해제됩니다.
+
+### 빠른 설치(Express Install)
+
+
+
+**로컬** 을 선택하면 **Express Install with recommended settings** 체크박스가 나타납니다. 기본값은 해제이므로, 디스크에 아무것도 쓰기 전에 설치 마법사가 ComfyUI 버전, 설치 위치, 시작 옵션을 먼저 보여줍니다. 체크하면 이 단계를 건너뛰고 권장 설정으로 Standalone 인스턴스를 바로 설치합니다. 체크하면 감지된 하드웨어가 체크박스 아래에 표시되므로, 감지된 GPU가 사용하려는 것이 아니면 체크를 해제하세요.
+
+### 기존 설치 마이그레이션
+
+컴퓨터에 Legacy Desktop 설치가 있으면 Express Install 옆에 **Migrate existing instance** 체크박스가 나타나며 기본적으로 켜져 있습니다. 켜 둔 상태로 계속하면 워크플로, 모델, 설정이 함께 넘어옵니다. 무엇이 이동하는지는 [Desktop Legacy에서 마이그레이션](/ko/installation/desktop/usage/migrate) 을 참조하세요. 해제하면 새 인스턴스를 설치합니다. 두 체크박스를 모두 해제하면 설치를 시작하기 전에 다시 한 번 묻습니다. **Migrate** 를 선택하면 Legacy Desktop 설치를 그대로 가져오고, **Start Fresh** 를 선택하면 기존 프로젝트를 그대로 둔 채 깨끗한 인스턴스를 설치합니다.
+
+### 중국 미러
+
+앱이 중국어로 실행되면 **Continue** 후에 질문이 하나 추가됩니다. **Enable Chinese Mirrors?** 에서 **Enable Mirrors** 를 선택하면 Git 저장소를 `gitcode.com` 에서 클론하고 PyPI 패키지를 Aliyun과 Tencent 미러에서 가져옵니다(`github.com` 과 `pypi.org` 대신). 중국 본토에서는 이 방식이 더 빠릅니다. **Not now** 를 선택하면 기본값을 유지합니다. 어느 쪽을 선택하든 **Use Chinese Mirrors (Git & PyPI)** 설정으로 저장되므로 나중에 변경할 수 있습니다.
+
+### 설정 완료 후
+
+**Continue** 는 선택 내용을 저장하고 **Preparing your install…** 을 잠시 표시합니다.
+
+- **클라우드**: Comfy Desktop이 설정 화면을 닫고 Comfy Cloud를 실행합니다.
+- **로컬**: Express Install이 켜져 있지 않으면 설치 마법사가 실행되고 진행 상황이 표시되며, 완료된 인스턴스가 대시보드에 나타납니다.
+
+Comfy Desktop에 이미 Standalone, 추적형, 원격 설치가 있으면 클라우드 또는 로컬 선택을 건너뛰고, 약관에 동의하면 바로 대시보드로 이동합니다. 약관 동의는 설정 화면을 실행할 때마다 필요합니다.
+
+이 설정 화면은 전체 화면으로 표시되며, 열려 있는 동안에는 타이틀 바가 잠깁니다. 동의 단계를 벗어나면 앱 메뉴(☰)가 **Skip Onboarding** 한 항목만 남으며, 이를 선택하면 아무것도 설치하지 않고 설정 화면을 닫아 대시보드로 이동합니다.
+
## 사용 가이드
설치 후, Comfy Desktop 사용법을 익혀보세요:
@@ -55,4 +110,4 @@ Comfy Desktop은 **Windows 10 이상**, **macOS 13 이상 (Apple Silicon)**, **L
## 오픈 소스
-Comfy Desktop 소스는 [GitHub](https://github.com/Comfy-Org/Comfy-Desktop)에 있습니다. 이중 라이선스입니다: AGPL-3.0-or-later, 또는 Comfy Org의 상업용 라이선스.
\ No newline at end of file
+Comfy Desktop 소스는 [GitHub](https://github.com/Comfy-Org/Comfy-Desktop)에 있습니다. 이중 라이선스입니다: AGPL-3.0-or-later, 또는 Comfy Org의 상업용 라이선스.
diff --git a/ko/installation/desktop/usage/downloads.mdx b/ko/installation/desktop/usage/downloads.mdx
index 93001ad511..d184f25630 100644
--- a/ko/installation/desktop/usage/downloads.mdx
+++ b/ko/installation/desktop/usage/downloads.mdx
@@ -3,14 +3,14 @@ title: "Comfy Desktop의 모델 다운로드"
description: "Comfy Desktop에서 모델과 출력 다운로드를 추적하고, 진행 상황 확인, 재시도, 일시 중지, 저장 위치 확인을 할 수 있습니다."
icon: "download"
sidebarTitle: "다운로드"
-translationSourceHash: e46f0fe2
+translationSourceHash: dbab8907
translationFrom: installation/desktop/usage/downloads.mdx
translationBlockHashes:
"_intro": b76dd6b3
"What appears in the downloads list": c70b88e8
"The Downloads tray": d7e19e28
"The full downloads view": 8c2018ce
- "Where downloads are saved": ffbe39a3
+ "Where downloads are saved": 1cf62540
---
Comfy Desktop은 인스턴스용 모델을 다운로드하고 모든 전송을 한곳에서 추적합니다. ComfyUI 인스턴스가 아직 디스크에 없는 모델을 요청하면 Comfy Desktop이 다운로드를 처리하고 해당 파일을 인스턴스의 모델 디렉토리에 저장합니다. 직접 배치할 필요가 없습니다.
@@ -51,6 +51,6 @@ Comfy Desktop은 인스턴스용 모델을 다운로드하고 모든 전송을
## 다운로드 저장 위치
-모델 파일은 인스턴스의 기본 모델 디렉토리에 기록됩니다. 인스턴스가 공유 모델 디렉토리를 포함하면 **주**로 표시된 공유 모델 디렉토리에, 포함하지 않으면 인스턴스 자체의 `models` 폴더에 저장됩니다. 공유 디렉토리는 [Desktop Settings](/ko/installation/desktop/usage/settings#저장소)에서 설정하며, 각 인스턴스는 **Manage** 패널의[저장소 탭](/ko/installation/desktop/usage/manage#저장소-탭)에서 공유 디렉토리를 포함하지 않도록 선택할 수 있습니다.
+모델 파일은 인스턴스의 모델 다운로드 디렉토리에 기록됩니다. 인스턴스가 공유 모델 디렉토리를 포함하면 **DOWNLOADS** 배지(**Use for Model Downloads**로 설정)가 붙은 공유 모델 디렉토리에, 포함하지 않으면 인스턴스 자체의 `models` 폴더에 저장됩니다. 공유 디렉토리는 [Desktop Settings](/ko/installation/desktop/usage/settings#저장소)에서 설정하며, 각 인스턴스는 **Manage** 패널의[저장소 탭](/ko/installation/desktop/usage/manage#저장소-탭)에서 공유 디렉토리를 포함하지 않도록 선택할 수 있습니다.
원격 인스턴스에서 다운로드한 출력은 인스턴스가 공유 출력 폴더를 사용하면 그곳에, 그렇지 않으면 인스턴스 자체의 출력 폴더에 저장됩니다. 원격 인스턴스는 저장소 설정의 **Auto-Download Outputs**로 출력 자동 다운로드를 끌 수 있습니다.
diff --git a/ko/installation/desktop/usage/instance-management.mdx b/ko/installation/desktop/usage/instance-management.mdx
index 864c02bc1b..2ee9f01a1d 100644
--- a/ko/installation/desktop/usage/instance-management.mdx
+++ b/ko/installation/desktop/usage/instance-management.mdx
@@ -3,12 +3,13 @@ title: "인스턴스 관리"
description: "Comfy Desktop에서 ComfyUI 인스턴스를 생성, 편집, 이름 변경, 삭제합니다"
icon: "plus"
sidebarTitle: "인스턴스"
-translationSourceHash: f55298e4
+translationSourceHash: 992d3d91
translationFrom: installation/desktop/usage/instance-management.mdx
translationBlockHashes:
- "_intro": 88d901c8
- "Creating a New Instance": b161e6b2
+ "_intro": eb7803d3
+ "Creating a New Instance": 1df7f4d4
"Tracking an Existing Installation": 488339c2
+ "Launching, Stopping, and Restarting an Instance": 95513898
"Uninstalling an Instance": 9196aa8c
"Copying an Installation": 6131deee
"Editing an Instance": cc4950f9
@@ -59,6 +60,9 @@ Comfy Desktop은 네 가지 인스턴스 유형을 지원합니다. 각 유형

+
+ 
+
1. **이름**: 인스턴스의 이름입니다. 기본값은 "ComfyUI"입니다.
@@ -72,6 +76,8 @@ Comfy Desktop은 네 가지 인스턴스 유형을 지원합니다. 각 유형
+
+

Comfy Desktop이 나머지 작업을 처리합니다: Python 다운로드, 환경 설정, ComfyUI 설치. 진행 화면에 현재 단계가 표시됩니다.
@@ -137,6 +143,41 @@ Comfy Desktop이 나머지 작업을 처리합니다: Python 다운로드, 환
> **참고:** 추적형 설치는 `launchMode: 'external'`을 사용합니다. Comfy Desktop이 기존 ComfyUI 프로세스를 내부 관리 없이 시작합니다. 현재 스냅샷은 독립형 인스턴스에서만 지원됩니다.
+## 인스턴스 시작, 중지, 재시작하기
+
+[↩ 개요로 돌아가기](#overview)
+
+### 인스턴스 시작하기
+
+Chooser에서 인스턴스 카드를 클릭하면 시작됩니다. ComfyUI가 시작되는 동안 창에 시작 진행 상황이 표시되고, 서버가 준비되면 ComfyUI 화면으로 전환됩니다.
+
+### 다른 인스턴스가 실행 중일 때 시작하기
+
+로컬 인스턴스가 실행 중이거나 시작 중일 때 다른 로컬 인스턴스를 시작하면, Comfy Desktop은 **An instance is already running** 대화상자를 표시하고 중지될 인스턴스를 나열합니다:
+
+- **Close & Launch**: 나열된 인스턴스를 중지한 다음 선택한 인스턴스를 시작합니다.
+- **Run All**: 새 인스턴스를 실행 중인 인스턴스와 함께 시작합니다.
+
+대화상자를 닫으면 시작이 취소됩니다. 인스턴스를 재시작할 때는 이 대화상자가 표시되지 않습니다. 표시하지 않으려면 [데스크탑 설정 → 환경설정](/ko/installation/desktop/usage/settings#환경설정)에서 **Warn before running multiple instances**를 끄세요.
+
+### 인스턴스 중지하기
+
+인스턴스 카드의 세 점 메뉴에서 **Stop**을 선택합니다. ComfyUI 서버가 중지되고 창은 열린 상태로 **ComfyUI is stopped** 카드가 표시됩니다. **Relaunch ComfyUI**로 서버를 다시 시작하거나 **Return to Dashboard**로 Chooser로 돌아갑니다.
+
+### 크래시 후 재시작
+
+ComfyUI가 시작에 실패하거나 예기치 않게 종료되면, 창은 열린 상태로 상황을 설명하는 카드가 표시됩니다:
+
+- **ComfyUI could not start**: 인스턴스가 시작되지 않았습니다.
+- **ComfyUI exited unexpectedly**: 프로세스가 종료되었습니다. Comfy Desktop이 읽을 수 있으면 카드에 종료 코드 또는 종료 신호도 표시됩니다.
+
+Windows에서는 크래시가 메모리 액세스 위반으로 보고되고 Microsoft Visual C++ 재배포 가능 패키지 일부가 누락된 것으로 표시될 수 있습니다. 카드의 로그를 펼쳐 자세히 확인한 다음 **Restart ComfyUI**로 다시 시작하거나 **Back**으로 대시보드로 돌아갑니다.
+
+ComfyUI가 설치 폴더에 보관하는 에셋 데이터베이스를 열지 못해 중지되면, 중지 시점의 오류에 종료 코드만이 아니라 원인이 함께 표시됩니다:
+
+- **다른 ComfyUI가 이 설치의 데이터베이스를 사용 중인 경우**: 그 ComfyUI(또는 이를 실행한 앱)를 종료하거나 `--database-url` 시작 인수로 둘 중 하나에 별도의 데이터베이스 위치를 지정합니다.
+- **그 밖의 데이터베이스 오류**(다른 프로그램의 잠금, 더 새로운 버전의 ComfyUI가 기록한 데이터베이스, 해당 폴더에 만들 수 없는 경우): 메시지에 데이터베이스 파일과 해결 방법이 나오고, 마지막에 시작 인수에 `--disable-assets`를 추가해 에셋 시스템 없이 시작하는 선택지가 제시됩니다.
+
## 인스턴스 제거하기
[↩ 개요로 돌아가기](#overview)
diff --git a/ko/installation/desktop/usage/manage.mdx b/ko/installation/desktop/usage/manage.mdx
index 8bb6e5a108..36dea2c548 100644
--- a/ko/installation/desktop/usage/manage.mdx
+++ b/ko/installation/desktop/usage/manage.mdx
@@ -3,10 +3,10 @@ title: "설치 관리"
description: "ComfyUI 설치 실행, 업데이트, 스냅샷 및 관리"
icon: "sliders"
sidebarTitle: "관리"
-translationSourceHash: 89b2392a
+translationSourceHash: 838d9683
translationFrom: installation/desktop/usage/manage.mdx
translationBlockHashes:
- "The Manage Panel": 49a42092
+ "The Manage Panel": 7944c50d
"Installation Actions": 3bf198ca
---
@@ -43,7 +43,7 @@ translationBlockHashes:
시작 CLI 인자, 매니저 정책, 실행 모드, 브라우저 캐시 공유, 포트 충돌 동작, 환경 변수를 구성합니다.
-- **시작 인자**: ComfyUI용 사용자 지정 CLI 인자(예: `--listen`). 기어 아이콘을 클릭하면 분류된 플래그를 확인할 수 있습니다.
+- **시작 인자**: ComfyUI용 사용자 지정 CLI 인자(예: `--listen`). 기어 아이콘을 클릭하면 분류된 플래그를 확인할 수 있습니다. 베타 기능이 활성화되어 있으면 필드 옆의 **+N beta** 배지에 Comfy Desktop이 실행 중인 세션에 추가한 베타 인자 또는 다음 시작에 적용될 인자가 표시됩니다.
- **매니저 보안 수준**: 이 인스턴스에 ComfyUI-Manager가 설치할 수 있는 노드 팩을 제어합니다. 다음 시작 시 적용됩니다.
- **엄격(Strict)**: 모든 노드 팩 설치, 업데이트, 제거를 차단합니다. 매니저는 읽기 전용입니다.
- **표준(권장)**: 등록된 노드 팩을 허용합니다. 등록되지 않은 소스(예: 임의의 git URL)에서의 설치는 차단합니다.
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/ko/installation/desktop/usage/overview.mdx b/ko/installation/desktop/usage/overview.mdx
index 89f900e8ae..5c325d7ca7 100644
--- a/ko/installation/desktop/usage/overview.mdx
+++ b/ko/installation/desktop/usage/overview.mdx
@@ -3,11 +3,11 @@ title: "Comfy Desktop 사용하기"
description: "Comfy Desktop 개요: 새로운 설치 생성, 인스턴스 관리 등"
icon: "book-open"
sidebarTitle: "개요"
-translationSourceHash: 651b33ae
+translationSourceHash: ebaea3ac
translationFrom: installation/desktop/usage/overview.mdx
translationBlockHashes:
"_intro": d96e3242
- "Dashboard Overview": 60e63628
+ "Dashboard Overview": 0cc8797c
"Feedback and Issues": 9304f358
---
@@ -34,17 +34,36 @@ Comfy Desktop 창은 몇 가지 주요 영역으로 나뉩니다. 아래 이미
### 앱 메뉴
-좌측 상단의 햄버거 메뉴(☰)를 클릭하면 애플리케이션 메뉴(파일 / 편집 / 보기 / 창 / 도움말)가 열립니다. 이 메뉴를 사용하여 새 창을 열거나, **데스크탑 설정**에 액세스하거나, Comfy 계정에 **로그인**하거나, 앱을 종료하거나, 기타 데스크톱 수준의 제어 기능을 찾을 수 있습니다.
+
-
+좌측 상단의 햄버거 메뉴(☰)를 클릭하면 앱 메뉴가 열리며, 앱 수준의 모든 작업이 이곳에 있습니다:
+
+- **Open Dashboard**: Dashboard를 새 창에서 엽니다. 실행 중인 인스턴스는 계속 실행됩니다.
+- **New Instance** 및 **Add Existing Instance**: 새 인스턴스를 만들거나 이미 있는 ComfyUI 설치를 등록합니다.
+- **Load Snapshot**: 다른 사용자가 공유한 스냅샷 파일로 인스턴스를 만듭니다.
+- **Log in**: Comfy 계정에 로그인합니다. 이 항목은 로그아웃 상태일 때만 표시됩니다.
+- **Performance Tests**: 인스턴스에 대해 시간을 측정하는 워크플로를 실행합니다. 자세한 내용은 [성능 테스트 및 벤치마크](/ko/installation/desktop/usage/performance-tests)를 참고하세요.
+- **Benchmarks**: 저장된 성능 테스트 결과를 하드웨어, 워크플로, 인스턴스별로 비교합니다.
+- **Desktop Settings**: 자동 업데이트, 프록시/미러, 공유 저장소, 데이터 위치에 대한 전역 설정입니다.
+- **Send Feedback**: 피드백 패널을 엽니다.
+- **Close Window** 및 **Quit Desktop**: 현재 창을 닫거나 앱을 종료합니다. 인스턴스 창을 닫으면 해당 창이 실행하는 ComfyUI 인스턴스가 중지되고, 마지막 창을 닫으면 Comfy Desktop이 종료됩니다.
+
+상황에 따라 두 항목만 추가로 표시됩니다: ComfyUI 뷰가 확대 또는 축소된 경우 **Reset Zoom (N%)**, 최초 실행 설정 중에는 **Skip Onboarding**입니다. 최초 실행 설정이 화면에 있는 동안에는 **Skip Onboarding**이 메뉴의 유일한 항목입니다.
+
+macOS에서는 앱, 편집, 윈도우 메뉴를 포함한 시스템 메뉴 막대가 유지됩니다. Windows와 Linux 빌드에는 시스템 메뉴 막대가 없습니다.
+
+
- 글로벌 설정: 자동 업데이트, 프록시/미러, 공유 저장소, 데이터 저장 위치.
+ 글로벌 설정: 자동 업데이트, 프록시/미러, 공유 저장소, 데이터 위치.
+
+
+ 인스턴스에서 워크플로 속도를 측정하고 하드웨어별로 실행 결과를 비교합니다.
### 인스턴스 전환기
-중앙에 있는 알약 모양 버튼에는 현재 활성화된 ComfyUI 인스턴스의 이름이 표시됩니다. 버튼을 클릭하면 **인스턴스 선택기** 팝오버가 열리며, 여기에는 설치된 모든 인스턴스가 나열되고 실행 상태가 표시되며, 이들 사이를 전환하거나 새 인스턴스를 실행할 수 있습니다.
+중앙에 있는 알약 모양 버튼에는 현재 활성화된 ComfyUI 인스턴스의 이름이 표시됩니다. 버튼을 클릭하면 **인스턴스 선택기** 팝오버가 열리며, 여기에는 설치된 모든 인스턴스가 나열되고 실행 상태가 표시되며, 이들 사이를 전환하거나 새 인스턴스를 실행할 수 있습니다. 해당 인스턴스에 새 ComfyUI 버전이 있으면 알약 버튼에 **Update** 칩이 표시되며, 클릭하면 선택기를 열지 않고 인스턴스를 업데이트합니다.
@@ -54,11 +73,15 @@ Comfy Desktop 창은 몇 가지 주요 영역으로 나뉩니다. 아래 이미
### 우측 버튼 그룹
-제목 표시줄 오른쪽에 모인 버튼들은 다음 기능에 빠르게 접근할 수 있게 해줍니다:
+
+
+제목 표시줄 오른쪽의 컨트롤은 다음 기능에 빠르게 접근할 수 있게 해줍니다:
- **Desktop Update**:Comfy Desktop의 새 버전이 있을 때 여기에 알약 모양 버튼이 나타납니다. 클릭하면 업데이트를 다운로드하고 적용합니다.
+- **Reset Zoom**:ComfyUI 뷰의 확대/축소가 100%가 아닐 때 현재 배율을 보여주는 알약 버튼이 표시됩니다. 클릭하면 100%로 돌아갑니다.
+- **What's new**:공지 패널을 엽니다. 공지에서는 ComfyUI의 새 기능과 Comfy 제품 출시를 짧은 영상, 주요 내용, 자세히 보기 링크와 함께 소개합니다. 확인하지 않은 공지가 있으면 종 모양 아이콘에 점이 표시되고, 패널을 열면 점이 사라집니다.
- **Feedback**:Comfy Desktop 팀에 피드백을 보냅니다.
-- **Downloads**:다운로드 트레이를 열어 활성 및 최근 다운로드를 확인합니다.
+- **Downloads**:다운로드 트레이를 엽니다. 배지는 진행 중인 다운로드 수를 표시하고 실패했거나 확인하지 않은 다운로드를 강조합니다. 트레이에서는 실패한 다운로드를 재시도하거나 진행 중인 다운로드를 취소할 수 있습니다. **View All Downloads**로 전체 목록을 열면 일시정지와 재개도 할 수 있습니다.
### 검색
diff --git a/ko/installation/desktop/usage/performance-tests.mdx b/ko/installation/desktop/usage/performance-tests.mdx
new file mode 100644
index 0000000000..f2b8947234
--- /dev/null
+++ b/ko/installation/desktop/usage/performance-tests.mdx
@@ -0,0 +1,155 @@
+---
+title: "성능 테스트 및 벤치마크"
+description: "성능 테스트로 ComfyUI 워크플로 속도를 측정한 다음, Comfy Desktop의 벤치마크로 GPU, 워크플로, 인스턴스 전반에서 실행을 비교하세요"
+icon: "gauge"
+sidebarTitle: "성능 테스트"
+translationSourceHash: 429915c2
+translationFrom: installation/desktop/usage/performance-tests.mdx
+translationBlockHashes:
+ "_intro": 7a65e6d8
+ "Running a Performance Test": d3b8adb1
+ "Comparing Runs with Benchmarks": b85e9c09
+ "Where results are stored": afbb1b95
+ "Requirements": f8a3cde3
+---
+**Performance Tests**는 ComfyUI 워크플로가 사용자의 인스턴스 중 하나에서 실행되는 데 걸리는 시간을 측정합니다. 인스턴스를 선택하고 워크플로를 불러오면 Comfy Desktop이 이를 지정된 실행 횟수만큼 실행하면서 측정 대상인 각 실행의 시간을 재고, 가장 빠른 시간, 가장 느린 시간, 평균, 중앙값을 해당 수치가 나온 하드웨어 및 소프트웨어 정보와 함께 보고합니다.
+
+**Benchmarks**는 기록된 결과들을 비교합니다. 저장된 모든 실행을 나열하고 워크스페이스, 인스턴스, 하드웨어 또는 워크플로로 필터링하며, 선택한 실행들을 상대 속도 계수와 함께 나란히 정렬해 주므로 어떤 GPU, 워크플로 또는 인스턴스가 다른 것보다 얼마나 빠른지 확인할 수 있습니다.
+
+두 패널 모두 앱 메뉴에서 열 수 있습니다. 왼쪽 위 모서리의 ☰ 메뉴를 클릭한 다음 **Performance Tests** 또는 **Benchmarks**를 선택하세요.
+
+
+
+
+Performance Tests는 실제 인스턴스에서 실제 워크플로를 실행하므로, 테스트에는 대략 워크플로 자체에 걸리는 시간에 실행 횟수를 곱한 만큼의 시간이 소요됩니다. 가져오는 워크플로는 먼저 [API 형식](/ko/development/api-development/workflow-api-format)으로 내보내야 합니다. Comfy Desktop에 포함된 예제 워크플로는 이미 이 형식입니다.
+
+
+## 성능 테스트 실행하기
+
+이 패널은 세 개의 번호가 붙은 단계가 나란히 배치되어 있습니다. 창이 좁으면 세로로 쌓입니다.
+
+
+
+### 1. 인스턴스 선택
+
+테스트할 **워크스페이스**와 **인스턴스**를 선택합니다. 인스턴스와 해당 하드웨어 정보는 결과와 함께 기록되며, 이는 나중에 비교를 의미 있게 만드는 요소입니다. 서로 다른 GPU에서 실행한 결과를 구분할 수 있는 상태로 유지되기 때문입니다.
+
+테스트를 시작하면 Comfy Desktop은 해당 인스턴스의 이전 성능 테스트 세션이 아직 실행 중인 경우 이를 중지한 다음, 해당 인스턴스를 콘솔 세션으로 시작합니다. 다른 로컬 ComfyUI가 실행 중이거나 시작 중이거나 중지 중이면 테스트 시작을 거부하고 방해하는 인스턴스를 안내 메시지에 표시합니다. 해당 인스턴스를 중지하거나 시작 또는 중지가 끝날 때까지 기다린 후 테스트를 다시 실행하세요. Comfy Cloud 및 원격 인스턴스는 다른 곳에서 실행되므로 테스트를 막지 않습니다. 게임이나 동영상 내보내기처럼 GPU를 사용하는 다른 작업은 여전히 측정값에 영향을 주므로 테스트를 실행하기 전에 중지하세요.
+
+### 2. 워크플로 선택
+
+Comfy Desktop에 포함된 예제 워크플로를 고르거나 직접 워크플로를 가져올 수 있습니다.
+
+**예제 워크플로**는 바로 실행할 수 있으며 필요한 모델이 자동으로 다운로드됩니다. **Choose an example workflow**를 클릭하면 선택기가 열립니다. 선택기는 예제를 모달리티별 탭(Video, Image, 3D, Audio. 예제가 있는 모달리티에만 탭이 표시됩니다)으로 묶고, 각 카드에는 예제의 이름, 작업, 모델 다운로드 크기가 표시됩니다. **Use workflow**를 클릭해 하나를 선택하세요. 그러면 Comfy Desktop이 워크플로에 아직 없는 모델을 다운로드하고, 드롭 영역에 완료될 때까지 다운로드 진행률이 표시됩니다. 예제를 사용하려면 인스턴스 설치가 완료되어 있어야 하고 온라인 상태여야 합니다. 모델이 남은 디스크 공간에 들어가지 않으면 선택기가 선택을 막습니다. 예제 워크플로는 인스턴스에 종속됩니다. 다른 인스턴스로 전환하면 이전 인스턴스용으로 준비한 예제는 버려집니다. 단, 해당 예제의 세션에 이미 결과가 기록되어 있으면 유지됩니다.
+
+**직접 가져오는 워크플로**는 먼저 [API 형식](/ko/development/api-development/workflow-api-format)으로 내보내야 합니다. `.json` 파일을 드롭 영역에 놓거나, 영역을 클릭하여 파일을 찾아봅니다.
+
+
+
+어느 방법이든 Comfy Desktop은 워크플로를 테스트 세션 폴더로 복사하므로, 원본 파일을 이동하거나 편집한 이후에도 테스트가 계속 실행됩니다.
+
+### 3. 측정 설정 지정
+
+| 설정 | 범위 | 기본값 | 설명 |
+|---------|-------|---------|--------------|
+| **워밍업 실행** | 1 ~ 5 | 1 | 모델을 로드하고 캐시를 예열하기 위해 먼저 수행되는 실행입니다. 결과에는 포함되지 않습니다. |
+| **측정 실행** | 1 ~ 100 | 5 | 워밍업 실행 이후에 시간을 측정하는 실행입니다. 이 실행들의 실행 시간을 사용해 결과를 계산합니다. |
+
+모든 실행은 워크플로의 숫자 시드 입력을 1씩 증가시키므로, 측정 실행이 동일한 캐시 결과를 반복하지 않습니다.
+
+세 단계를 모두 설정한 뒤 **Run**을 클릭하면 테스트가 시작됩니다. 옆의 **Stop** 버튼으로 진행 중인 테스트를 취소할 수 있습니다.
+
+### 결과 확인
+
+테스트가 실행되는 동안 패널에는 완료된 실행 수와 인스턴스 로그가 표시됩니다. 모든 실행이 끝나면 인스턴스가 중지되고 결과가 나타납니다.
+
+- **가장 빠른 실행**, **가장 느린 실행**, **평균 실행**, **중앙값 실행** (초 단위)
+- **측정 실행** 및 **실패한 실행**: 실행 시간이 산출된 실행 수와 그렇지 않은 실행 수
+- **실행 시간 집계**: 네 가지 집계값(가장 빠름, 가장 느림, 평균, 중앙값)을 비교하는 막대 차트
+- **시스템 정보**: 연산 장치, VRAM, RAM, PyTorch 버전, xFormers 버전, CPU, CPU 코어, 운영 체제, 아키텍처
+
+실행 시간은 사용자가 기다린 시간이 아니라 ComfyUI가 서버에서 작업을 실행하는 데 소요한 시간입니다. 실패한 실행은 별도로 집계되며 통계에서 제외됩니다.
+
+결과와 함께 두 개의 버튼이 있습니다. **폴더 열기**는 세션 폴더를 열고, **결과 내보내기**는 요약과 차트를 PNG 이미지로 저장합니다.
+
+## Benchmarks로 실행 비교하기
+
+Benchmarks는 Performance Tests가 저장한 결과를 읽으므로, 테스트가 최소 한 개 완료되기 전에는 표시할 내용이 없습니다.
+
+### 실행 라이브러리
+
+**실행 라이브러리**는 결과 폴더에 저장된 모든 실행을 최신 순으로 나열합니다. 도구 모음에서 다음을 사용할 수 있습니다:
+
+- **폴더 선택**: 패널이 다른 결과 폴더를 가리키도록 지정합니다. 예를 들어 공유 드라이브의 폴더를 지정할 수 있습니다. 기본값은 Performance Tests가 기록하는 폴더입니다. 자세한 내용은 [결과가 저장되는 위치](#결과가-저장되는-위치)를 참고하세요.
+- **세션 새로 고침**: 다른 곳에서 테스트가 완료된 후 폴더를 다시 로드합니다.
+- **실행 검색**: 텍스트로 목록을 필터링합니다.
+- 워크스페이스, 인스턴스, 하드웨어, 워크플로로 필터링하는 드롭다운 필터입니다.
+- **속성**: 라이브러리에 표시할 열을 선택합니다(세션, 날짜 및 시간, 워크플로, 인스턴스, 워크스페이스, 실행 횟수, GPU 및 하드웨어).
+
+
+
+### 실행 비교
+
+체크박스로 두 개 이상의 실행을 선택하거나 **표시된 실행 모두 선택**을 사용하세요. 라이브러리가 로드되면 최신 실행 세 개가 자동으로 선택됩니다. 실행을 선택하면 라이브러리 아래에 **비교** 섹션이 열립니다.
+
+비교는 선택한 실행마다 하나의 열을 여러 지표 행 옆에 배치합니다. 지표 행은 가장 빠른 소요 시간, 평균, 중앙값, 가장 느린 소요 시간과 측정된 실행 횟수로 구성됩니다. 하나의 실행이 **기준**입니다. 기본적으로 표시된 첫 번째 열이 기준입니다. **속도** 보기에서 열 제목을 클릭하면 해당 실행이 대신 기준이 됩니다.
+
+### 상대 속도
+
+비교에는 **소요 시간**과 **속도** 두 가지 보기가 있으며, 비교 도구 모음에서 전환합니다. 상대 속도는 **속도** 보기에 속하며, 기준도 이 보기에서 선택합니다.
+
+**상대 속도**는 기준 소요 시간을 해당 실행의 소요 시간으로 나눈 값입니다:
+
+- **1.00×**는 해당 실행이 기준과 같은 속도임을 의미합니다
+- 1.00×보다 큰 값은 해당 실행이 기준보다 **빠름**을 의미합니다
+- 1.00×보다 작은 값은 해당 실행이 기준보다 **느림**을 의미합니다
+
+**속도** 보기는 각 실행을 로그 축에 표시하며 왼쪽이 **느림**, 오른쪽이 **빠름**이므로 2배와 4배 차이도 같은 차트에서 읽을 수 있습니다. **소요 시간** 보기는 각 실행의 가장 빠른 결과와 가장 느린 결과를 선으로 그리고 평균을 표시합니다. 사용할 수 있는 소요 시간이 없는 실행은 사용할 수 없음으로 표시됩니다.
+
+
+
+### 정렬 및 내보내기
+
+- **비교 정렬**은 상대 속도 순으로 열을 정렬합니다. **수동 정렬**을 사용하면 열을 직접 원하는 순서로 끌어 놓거나, 열에 포커스를 두고 Alt+Left / Alt+Right를 누를 수 있습니다.
+- **결과 내보내기**는 전체 비교를 PNG 이미지로 저장하며, 이슈나 채팅 메시지에 결과를 첨부하는 가장 빠른 방법입니다.
+
+### 세션 관리
+
+각 테스트는 세션으로 저장됩니다. 라이브러리에서 세션 이름을 바꾸거나(**세션 편집**) 삭제할 수 있습니다(**삭제**). 삭제하면 해당 세션에 기록된 모든 파일이 제거됩니다.
+
+## 결과가 저장되는 위치
+
+Performance Tests는 워크플로를 패널에 추가할 때 세션 폴더를 만들고, 그 시점의 타임스탬프(`YYYYMMDDHHMMSS`)를 이름으로 사용합니다:
+
+```
+📂 ComfyUI-Shared/
+└── 📂 benchmarks/
+ ├── 📂 20260930141522/
+ │ ├── my_workflow.json
+ │ ├── jobs.json
+ │ ├── results.json
+ │ └── logs.txt
+ └── 📂 20260930163005/
+ └── ...
+```
+
+| 플랫폼 | 기본 결과 폴더 |
+|----------|------------------------|
+| Windows | `%LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared\benchmarks` |
+| macOS / Linux | `~/ComfyUI-Shared/benchmarks` |
+
+각 세션 폴더에는 다음이 들어 있습니다:
+
+- 패널이 사용한 워크플로 파일
+- `jobs.json`: 인스턴스에서 받은 원시 작업 응답
+- `results.json`: Benchmarks 패널이 읽는 요약
+- `logs.txt`: 실행 중 인스턴스 콘솔 출력
+
+Benchmarks는 찾은 모든 세션 폴더에서 `results.json`을 읽으므로, 다른 머신의 결과와 비교하려면 세션 폴더를 Benchmarks가 가리키는 폴더에 복사하기만 하면 됩니다.
+
+같은 가져온 워크플로를 다시 실행하면 결과가 같은 세션 폴더에 기록되어 이미 저장된 결과를 덮어씁니다. 비교를 위해 결과를 남기려면 다음 테스트 전에 워크플로를 다시 패널에 추가하세요.
+
+## 요구 사항
+
+- Comfy Desktop에서 실행할 수 있는 독립 실행형, 추적된 또는 원격 인스턴스. 테스트에는 정상 작동하는 ComfyUI 인스턴스가 필요하므로 클라우드 인스턴스에서는 실행할 수 없습니다.
+- 인스턴스가 실행할 수 있는 워크플로. 여기에는 필요한 모든 모델과 커스텀 노드가 포함됩니다. 가져오는 워크플로는 API 형식이어야 합니다. 예제 워크플로는 이미 그 형식이며 Comfy Desktop이 모델을 다운로드합니다. 인스턴스가 워크플로를 거부하면 테스트가 중지되고 오류가 로그에 표시됩니다. 인스턴스가 수락했지만 실행 중 실패한 실행은 실패한 실행으로 집계되며 소요 시간 통계에서 제외됩니다.
diff --git a/ko/installation/desktop/usage/settings.mdx b/ko/installation/desktop/usage/settings.mdx
index 7104f7c219..9c65237412 100644
--- a/ko/installation/desktop/usage/settings.mdx
+++ b/ko/installation/desktop/usage/settings.mdx
@@ -3,14 +3,14 @@ title: "Comfy Desktop 설정"
description: "전역 설정, 테마, 프록시/미러 구성 및 데이터 위치"
icon: "cog"
sidebarTitle: "설정"
-translationSourceHash: 3c7fcc26
+translationSourceHash: e50dd605
translationFrom: installation/desktop/usage/settings.mdx
translationBlockHashes:
- "_intro": 21793e96
- "Preferences": e123ee00
- "Updates": b6db1add
- "Storage": 4bb5eadb
- "Advanced": 448c3a49
+ "_intro": 423ec831
+ "Preferences": ba98a2b9
+ "Updates": 60392d09
+ "Storage": 52d0d5f6
+ "Advanced": f4ef9849
"Logs": f8e4484f
"Data Locations": 12e5d644
"Keyboard Shortcuts": d36c977e
@@ -28,13 +28,27 @@ translationBlockHashes:

+환경설정 탭은 **언어** 선택기로 시작하고, 나머지 컨트롤은 세 개의 섹션으로 묶입니다.
+
- **언어**: 표시 언어를 선택합니다. **English** 및 **中文**을 사용할 수 있습니다.
+
+### 앱 동작
+
- **시작 시 자동 실행**: Comfy Desktop이 열릴 때 시작할 인스턴스를 선택합니다. 기본값은 **없음(대시보드 표시)**입니다. **마지막으로 사용한 인스턴스** 또는 특정 설치를 선택할 수도 있습니다.
- **창을 닫기 전에 확인**: 로컬 설치가 실행 중인 창을 닫기 전에 확인을 요청합니다.
- **여러 인스턴스 실행 전 경고**: 이미 실행 중이거나 시작 중인 로컬 ComfyUI 인스턴스가 있는 상태에서 다른 인스턴스를 실행하기 전에 경고를 표시합니다.
- **인스턴스 선택기에서 클라우드 숨기기**: 대시보드에서 클라우드 행을 숨깁니다. 나중에 이 옵션을 다시 활성화하면 클라우드는 계속 작동합니다.
+
+### 개인정보
+
- **익명 사용 데이터 공유**: 익명 사용 데이터를 전송하여 Comfy Desktop 개선에 도움을 줍니다.
-- **Comfy Desktop**: [Comfy Desktop GitHub 저장소](https://github.com/Comfy-Org/Comfy-Desktop) 링크입니다.
+- **Opt-in to beta features**: Comfy Desktop이 인스턴스의 Core 기능을 미리 켤 수 있도록 합니다. **익명 사용 데이터 공유**로 데이터 공유를 확인하기 전까지 이 스위치는 비활성화 상태로 유지되며, 텔레메트리가 이미 켜져 있어도 마찬가지입니다.
+
+베타 기능은 직접 설정한 시작 인자 위에 추가되는 형태로 전달됩니다. Comfy Desktop은 사용자의 인자를 삭제하거나 대체하지 않습니다. 인스턴스에서 베타 기능이 켜지면 제목 표시줄에 **A beta feature is on** 카드가 나타납니다. **Got it**으로 닫고, **Settings**를 선택하면 이 패널의 옵트인 스위치가 열립니다. 베타 기능이 추가한 인자는 해당 인스턴스의 시작 인자 탭에서 **시작 인자** 옆의 **+N beta** 배지로 확인할 수 있습니다.
+
+### 커뮤니티
+
+- **Comfy Desktop**: [Comfy Desktop GitHub 저장소](https://github.com/Comfy-Org/Comfy-Desktop)로 연결되는 카드이며, 스타 수를 표시합니다.
## 업데이트
@@ -50,12 +64,12 @@ translationBlockHashes:

-- **공유 모델**: 여기에 나열된 각 디렉토리는 모든 인스턴스가 모델을 검색합니다. **주**로 표시된 디렉토리가 기본적으로 새 모델을 저장하는 위치입니다.
+- **공유 모델**: 여기에 나열된 각 디렉토리는 모든 인스턴스가 모델을 검색합니다. **DOWNLOADS** 배지가 붙은 디렉토리에 새 모델이 다운로드됩니다.
- 
+ 
- 폴더 아이콘을 클릭하면 파일 관리자에서 디렉토리를 엽니다.
- - 디렉토리의 **...** 메뉴(1)를 클릭한 다음, **주로 설정**(2)을 선택하여 새 모델을 저장할 디렉토리를 변경합니다.
+ - 디렉토리의 **...** 메뉴(1)를 클릭한 다음, **Use for Model Downloads**(2)를 선택하면 해당 디렉토리가 모델 다운로드 위치가 됩니다.
- **+ 공유 디렉토리 추가**를 클릭하여 모델 디렉토리를 더 추가합니다.
- **공유 입력**: 모든 인스턴스가 입력 파일(이미지, 비디오 등)을 찾는 공유 경로입니다.
- **공유 출력**: 모든 인스턴스가 생성된 결과물을 저장하는 공유 경로입니다. 이 경로를 사용자 지정하면 모든 결과를 한 곳에 보관할 수 있습니다.
diff --git a/ko/installation/desktop/windows.mdx b/ko/installation/desktop/windows.mdx
index 3e0688f789..67dc7bdc5e 100644
--- a/ko/installation/desktop/windows.mdx
+++ b/ko/installation/desktop/windows.mdx
@@ -3,12 +3,12 @@ title: "Windows용 Comfy Desktop"
description: "Windows에 Comfy Desktop 설치: 시스템 요구 사항, 설정 단계, 업데이트, Windows 10 이상에서 ComfyUI를 로컬로 실행하기 위한 깔끔한 제거 방법."
icon: "windows"
sidebarTitle: "Windows"
-translationSourceHash: 56205b32
+translationSourceHash: 592ccfc9
translationFrom: installation/desktop/windows.mdx
translationBlockHashes:
"_intro": 27d36d8f
"System Requirements": ceeec5a6
- "Installation": be718ecf
+ "Installation": 955f804c
"Updating Comfy Desktop": b0efe5cd
"Uninstalling": 4b80edaa
---
@@ -33,7 +33,7 @@ import UpdateGuide from "/snippets/ko/desktop/update.mdx"
다운로드한 `.exe` 설치 프로그램(NSIS 설치 프로그램)을 실행하고 안내에 따라 진행하세요. 설치 후 Start Menu 또는 바탕화면 바로가기에서 Comfy Desktop을 실행하세요.

-앱을 처음 열면 첫 설치를 생성할 수 있는 **Welcome** 화면이 표시됩니다.
+앱을 처음 열면 첫 실행 설정에서 Comfy를 어떻게 실행할지 묻습니다. Comfy Cloud에서 실행하거나 이 컴퓨터에 로컬로 설치할 수 있습니다. 어떤 선택을 수집하는지는 [첫 실행](/ko/installation/desktop/overview#첫-실행) 을 참조하세요.
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/faq.mdx b/zh/installation/desktop/faq.mdx
index e8416163ad..9b300833cd 100644
--- a/zh/installation/desktop/faq.mdx
+++ b/zh/installation/desktop/faq.mdx
@@ -2,13 +2,13 @@
title: "Comfy Desktop 常见问题"
description: "Comfy Desktop 的常见问题与故障排除"
sidebarTitle: "常见问题"
-translationSourceHash: d746efac
+translationSourceHash: 4acea027
translationFrom: installation/desktop/faq.mdx
translationBlockHashes:
- "General Questions": 3de4ef1d
+ "General Questions": 9176b487
"Installation & Setup": b5578878
"Usage": 7a9bf578
- "Troubleshooting": 3c763877
+ "Troubleshooting": e89f60c3
---
## 常规问题
@@ -24,6 +24,16 @@ Comfy桌面版是全新重写的版本,是一个**多安装管理器**。与
Comfy桌面版是多种安装方式之一。你仍然可以根据需要选择**便携版(Windows)**、**手动安装**或 **Comfy Cloud**。对于大多数用户,推荐使用 Comfy桌面版,因为它易于使用,并提供一键更新和快照管理等特色功能。
+
+不可以。Comfy Desktop 启动后不久会检查一次新版本,之后每 10 分钟检查一次,这个检查无法关闭。唯一的更新设置是**桌面端设置 → 更新**里的**自动安装桌面端更新**,它默认开启。
+
+- **开启时**:新版本会在后台下载并自动安装。下载期间标题栏显示 **正在下载更新…**,更新可以应用时显示 **桌面端更新已就绪**。
+- **关闭时**:Comfy Desktop 仍会检查并通知你,但不再自行下载。标题栏改为显示 **桌面端更新** 胶囊按钮,点击它才会下载更新并提示重启。
+
+实例内部的 ComfyUI 版本是单独更新的。请在实例的**更新**标签页中选择 **Stable** 或 **Latest on GitHub** 渠道进行更新。
+
+在 Linux 上,应用内更新器不适用于 `.deb` 安装。请通过[通用下载链接](https://dl.todesktop.com/241130tqe9q3y)下载新的安装包,再使用 `sudo apt install ./*.deb` 安装。
+
## 安装与设置
@@ -124,6 +134,11 @@ Desktop 应用会写入轮转的 `app.log` 文件。最快的查找方式是 **
ComfyUI 进程输出(不是 Desktop 应用本身)请打开实例的 **管理** 面板,使用 **终端** 标签页。参见[安装管理](/zh/installation/desktop/usage/manage)。
+
+ComfyUI 不会原生把 [Ollama](https://ollama.ai) 当作扩散模型后端。不过你可以通过 ComfyUI Manager 注册表中的**自定义节点**,用 Ollama 提供的 LLM 做提示词生成和文本处理。
+
+关于把 ComfyUI 接到 LLM 服务,见[安装自定义节点](/zh/installation/install_custom_node)。
+
Comfy Desktop 和它的安装在磁盘上是分开的。要卸载应用及其安装:
diff --git a/zh/installation/desktop/overview.mdx b/zh/installation/desktop/overview.mdx
index dfcf94ae2f..6de02da594 100644
--- a/zh/installation/desktop/overview.mdx
+++ b/zh/installation/desktop/overview.mdx
@@ -3,8 +3,15 @@ title: "Comfy Desktop 概览"
description: "Comfy Desktop 概览:一个安装、管理和启动多个 ComfyUI 实例的桌面应用,ComfyUI 是生成式 AI 的基于节点的引擎。"
icon: "desktop"
sidebarTitle: "概览"
-translationSourceHash: f1e6d02d
+translationSourceHash: 41336356
translationFrom: installation/desktop/overview.mdx
+translationBlockHashes:
+ "_intro": 7b398eef
+ "Get Started": 5c67594c
+ "First Launch": 9b929553
+ "Usage Guide": 676a0e69
+ "Migrate from Legacy Desktop": 3004732b
+ "Open Source": 52e2900a
---
**Comfy Desktop** 是一个桌面应用,让你从一个启动器中安装、管理和启动多个 ComfyUI 安装。
@@ -33,6 +40,54 @@ Comfy Desktop 支持 **Windows 10+**、**macOS 13+(Apple Silicon)** 和 **Li
+## 首次启动
+
+首次打开 Comfy Desktop 时,会显示一个全屏初始化流程,询问**你想如何运行 Comfy?**,并在写入任何文件之前收集所需的选择。完成之前窗口会一直停留在这个流程中:如果你中途关闭应用,下次启动时会再次显示同一屏幕。
+
+### 云端还是本地
+
+
+
+两张卡片对应两种运行 ComfyUI 的方式:
+
+- **云端**:ComfyUI 运行在 Comfy Cloud 的 GPU 上。本机不安装任何内容,也无需下载。有免费 Cloud 运行次数可用时,卡片上会显示 **免费试用** 标签。
+- **本地**:在本机安装 ComfyUI。你可以控制 ComfyUI 版本、自定义节点和启动参数,并且可以离线运行。
+
+如果 Comfy Desktop 检测到本机 GPU 不足以流畅运行大多数工作流,云端卡片会显示 **推荐用于你的硬件** 标记,并且两张卡片都不会被默认选中,让选择由你主动做出。未选中卡片前,**继续** 按钮不可用。
+
+### 条款与数据共享
+
+卡片下方有三个复选框:
+
+- **我同意 EULA 和 服务条款**:必选。链接可打开 EULA、服务条款和隐私政策。每次运行此流程时都必须勾选此项,否则**继续**不会生效。
+- **通过分享匿名使用数据帮助改进 Comfy**:可选,默认勾选。Comfy Desktop 只发送匿名使用数据,绝不会收集工作流内容、提示词、生成的媒体或个人身份信息。之后可在 [桌面设置](/zh/installation/desktop/usage/settings) 中更改。
+- **加入 Beta 功能测试,帮助我们打磨新功能**:可选,默认勾选,仅在开启数据共享时可用。关闭数据共享会同时取消勾选此项。
+
+### 快速安装
+
+
+
+选择**本地**时,会出现 **使用推荐设置快速安装** 复选框。它默认未勾选,因此安装向导会先显示 ComfyUI 版本、安装位置和启动选项,再写入任何文件。勾选它可跳过该步骤,直接以推荐设置安装一个 Standalone 实例。勾选后 Comfy Desktop 会在复选框下方标出检测到的硬件,如果检测到的 GPU 不是你想要的,可以取消勾选。
+
+### 迁移已有安装
+
+如果 Comfy Desktop 在机器上发现 Legacy Desktop 安装,**迁移现有实例** 复选框会出现在快速安装旁边,并默认勾选。保持勾选即可在继续时把工作流、模型和设置一并迁移过来,迁移内容见 [从旧版迁移](/zh/installation/desktop/usage/migrate)。取消勾选则会全新安装一个实例。两个复选框都取消勾选时,Comfy Desktop 会在开始安装前再询问一次:选择 **迁移** 可以把 Legacy Desktop 安装迁移过来,选择 **全新开始** 则安装一个干净实例,原有项目留在原处。
+
+### 中国镜像
+
+当应用界面为中文时,此流程会在点击**继续**后追加一个问题:**启用中国镜像?** 选择 **启用镜像** 会让 Git 仓库从 `gitcode.com` 克隆、PyPI 包从阿里云和腾讯云镜像获取,而不是 `github.com` 和 `pypi.org`,在中国大陆速度更快。选择 **暂不** 则保留默认设置。无论选择哪一个,结果都会保存为 **使用中国镜像(Git 和 PyPI)** 设置,之后可以随时更改。
+
+### 完成之后
+
+**继续** 会保存你的选择,并短暂显示 **正在准备安装…**。
+
+- **云端**:Comfy Desktop 关闭此流程并启动 Comfy Cloud。
+- **本地**:除非勾选了快速安装,否则会进入安装向导;安装过程会显示进度,完成后实例会出现在 Dashboard 上。
+
+如果 Comfy Desktop 已有独立安装、追踪安装或远程安装,它会跳过云端与本地的选择,在你同意条款后直接进入 Dashboard。每次运行此流程都需要重新同意条款。
+
+此流程是全屏接管的:显示期间标题栏会被锁定;离开同意条款这一步后,应用菜单(☰)会缩减为唯一的 **跳过引导** 项,点击即可关闭引导并直接进入 Dashboard,不安装任何内容。
+
## 使用指南
安装完成后,了解如何使用 Comfy Desktop:
@@ -55,4 +110,4 @@ Comfy Desktop 支持 **Windows 10+**、**macOS 13+(Apple Silicon)** 和 **Li
## 开源
-Comfy Desktop 源码在 [GitHub](https://github.com/Comfy-Org/Comfy-Desktop)。采用双许可:AGPL-3.0-or-later,或 Comfy Org 的商业许可。
\ No newline at end of file
+Comfy Desktop 源码在 [GitHub](https://github.com/Comfy-Org/Comfy-Desktop)。采用双许可:AGPL-3.0-or-later,或 Comfy Org 的商业许可。
diff --git a/zh/installation/desktop/usage/downloads.mdx b/zh/installation/desktop/usage/downloads.mdx
index 8b2a41a181..61c71d96a1 100644
--- a/zh/installation/desktop/usage/downloads.mdx
+++ b/zh/installation/desktop/usage/downloads.mdx
@@ -3,14 +3,14 @@ title: "Comfy Desktop 的模型下载"
description: "在 Comfy Desktop 中跟踪模型与输出下载:查看进度、重试或暂停,并了解每个文件保存到哪里。"
icon: "download"
sidebarTitle: "下载"
-translationSourceHash: e46f0fe2
+translationSourceHash: dbab8907
translationFrom: installation/desktop/usage/downloads.mdx
translationBlockHashes:
"_intro": b76dd6b3
"What appears in the downloads list": c70b88e8
"The Downloads tray": d7e19e28
"The full downloads view": 8c2018ce
- "Where downloads are saved": ffbe39a3
+ "Where downloads are saved": 1cf62540
---
Comfy Desktop 会为你的实例下载模型,并集中跟踪所有传输。当 ComfyUI 实例需要本地还没有的模型时,Comfy Desktop 会接管下载,并把文件保存到该实例的模型目录,你不需要手动放置。
@@ -51,6 +51,6 @@ Comfy Desktop 会为你的实例下载模型,并集中跟踪所有传输。当
## 下载文件保存在哪里
-模型文件会写入该实例的主模型目录:当实例包含共享模型目录时,写入标记为**主要**的共享模型目录;否则写入实例自己的 `models` 文件夹。共享目录在[桌面设置 → 存储](/zh/installation/desktop/usage/settings#存储)中配置,每个实例也可以在管理面板的[存储标签页](/zh/installation/desktop/usage/manage#存储标签页)中选择不使用共享目录。
+模型文件会写入该实例的模型下载目录:当实例包含共享模型目录时,写入带 **DOWNLOADS** 角标(通过 **Use for Model Downloads** 设置)的共享模型目录;否则写入实例自己的 `models` 文件夹。共享目录在[桌面设置 → 存储](/zh/installation/desktop/usage/settings#存储)中配置,每个实例也可以在管理面板的[存储标签页](/zh/installation/desktop/usage/manage#存储标签页)中选择不使用共享目录。
从远程实例下载的输出会写入共享输出文件夹(当实例使用它时),否则写入实例自己的输出文件夹。远程实例可以在存储设置中通过 **自动下载输出** 关闭自动下载输出。
diff --git a/zh/installation/desktop/usage/instance-management.mdx b/zh/installation/desktop/usage/instance-management.mdx
index c4be1e5bbb..569aa489e6 100644
--- a/zh/installation/desktop/usage/instance-management.mdx
+++ b/zh/installation/desktop/usage/instance-management.mdx
@@ -3,12 +3,13 @@ title: "实例管理"
description: "在 Comfy Desktop 中创建、编辑、重命名和删除 ComfyUI 实例"
icon: "plus"
sidebarTitle: "实例"
-translationSourceHash: f55298e4
+translationSourceHash: 992d3d91
translationFrom: installation/desktop/usage/instance-management.mdx
translationBlockHashes:
- "_intro": 88d901c8
- "Creating a New Instance": b161e6b2
+ "_intro": eb7803d3
+ "Creating a New Instance": 1df7f4d4
"Tracking an Existing Installation": 488339c2
+ "Launching, Stopping, and Restarting an Instance": 95513898
"Uninstalling an Instance": 9196aa8c
"Copying an Installation": 6131deee
"Editing an Instance": cc4950f9
@@ -59,6 +60,9 @@ Comfy Desktop 支持四种类型的实例。每种类型在卡片和标题栏上

+
+ 
+
1. **名称**:实例的名称。默认值为 "ComfyUI"。
@@ -72,6 +76,8 @@ Comfy Desktop 支持四种类型的实例。每种类型在卡片和标题栏上
+
+

Comfy Desktop 将接管后续操作:下载 Python、搭建环境、安装 ComfyUI。进度界面会显示当前步骤。
@@ -137,6 +143,41 @@ Comfy Desktop 将接管后续操作:下载 Python、搭建环境、安装 Comf
> **注意:** 追踪安装使用 `launchMode: 'external'`。Comfy Desktop 启动现有的 ComfyUI 进程,但不进行内部管理。目前仅 Standalone 实例支持快照功能。
+## 启动、停止与重启实例
+
+[↩ 返回总览](#overview)
+
+### 启动实例
+
+在 Chooser 中点击实例卡片即可启动。ComfyUI 启动期间,窗口会显示启动进度,服务器就绪后随即显示 ComfyUI 界面。
+
+### 在其他实例运行时启动
+
+当已有本地实例正在运行或启动时,再启动另一个本地实例,Comfy Desktop 会弹出 **已有实例正在运行** 对话框,并列出将被停止的实例:
+
+- **关闭并启动**:先停止列出的实例,再启动你选择的实例。
+- **全部运行**:让新实例与正在运行的实例同时运行。
+
+关闭该对话框即取消启动。重启实例时不会出现此对话框。如果不想再看到它,请在[桌面版设置 → 偏好设置](/zh/installation/desktop/usage/settings#偏好设置)中关闭 **运行多个实例前发出警告**。
+
+### 停止实例
+
+在实例卡片的三点菜单(⋮)中选择 **停止**。ComfyUI 服务器停止后,窗口会保持打开并显示 **ComfyUI 已停止** 卡片。选择 **重新启动 ComfyUI** 可再次启动服务器,或选择 **返回仪表板** 回到 Chooser。
+
+### 崩溃后重启
+
+如果 ComfyUI 无法启动或意外退出,窗口会保持打开,并显示说明原因的卡片:
+
+- **ComfyUI 无法启动**:实例未能启动。
+- **ComfyUI 意外退出**:进程已停止。Comfy Desktop 能读取到信息时,卡片还会显示退出代码或终止进程的信号。
+
+在 Windows 上,崩溃可能报告内存访问冲突,并提示部分 Microsoft Visual C++ Redistributable 文件似乎缺失。展开卡片中的日志查看详情,然后选择 **重启 ComfyUI** 再次启动,或选择 **返回** 回到仪表板。
+
+如果 ComfyUI 因为无法打开安装目录内的资产数据库而停止,它停止时给出的错误会说明原因,而不只是报告退出代码:
+
+- **另一个 ComfyUI 正在使用此安装的数据库**:关闭那个 ComfyUI(或启动它的应用),或用 `--database-url` 启动参数为其中之一指定单独的数据库位置。
+- **其他数据库故障**,包括被其他程序锁定、由更新版本的 ComfyUI 写入、无法在该文件夹中创建:消息会给出数据库文件与处理办法,并在结尾提示可以选择不使用资产系统启动该实例:把 `--disable-assets` 加入它的启动参数。
+
## 卸载实例
[↩ 返回总览](#overview)
diff --git a/zh/installation/desktop/usage/manage.mdx b/zh/installation/desktop/usage/manage.mdx
index 88f796ca46..5c2e8b4e7a 100644
--- a/zh/installation/desktop/usage/manage.mdx
+++ b/zh/installation/desktop/usage/manage.mdx
@@ -3,10 +3,10 @@ title: "管理安装"
description: "启动、更新、快照和管理 ComfyUI 安装"
icon: "sliders"
sidebarTitle: "管理安装"
-translationSourceHash: 89b2392a
+translationSourceHash: 838d9683
translationFrom: installation/desktop/usage/manage.mdx
translationBlockHashes:
- "The Manage Panel": 49a42092
+ "The Manage Panel": 7944c50d
"Installation Actions": 3bf198ca
---
@@ -43,7 +43,7 @@ translationBlockHashes:
配置启动 CLI 参数、管理器策略、启动模式、浏览器缓存共享、端口冲突行为和环境变量。
-- **启动参数**:为 ComfyUI 配置自定义 CLI 参数(例如 `--listen`)。点击齿轮图标可查看分类的启动标志。
+- **启动参数**:为 ComfyUI 配置自定义 CLI 参数(例如 `--listen`)。点击齿轮图标可查看分类的启动标志。启用 Beta 功能后,字段旁边的 **+N beta** 标签会列出 Comfy桌面版 为当前会话添加的 Beta 参数,或下次启动将生效的参数。
- **管理器安全级别**:控制 ComfyUI-Manager 可以为该实例安装哪些节点包。该设置会在下次启动时生效。
- **严格**:阻止所有节点包的安装、更新和卸载。管理器处于只读状态。
- **标准(推荐)**:允许安装已注册的节点包。阻止从未注册来源(例如任意 git URL)安装。
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 后,通过卡片上的**迁移**胶囊按钮或 **⋮** 菜单中的**迁移到独立版**进行迁移。
### 迁移失败
diff --git a/zh/installation/desktop/usage/overview.mdx b/zh/installation/desktop/usage/overview.mdx
index 17f88e8d06..df534bc0cd 100644
--- a/zh/installation/desktop/usage/overview.mdx
+++ b/zh/installation/desktop/usage/overview.mdx
@@ -3,11 +3,11 @@ title: "Comfy Desktop 使用指南"
description: "Comfy Desktop 使用总览 — 创建新安装、管理实例等"
icon: "book-open"
sidebarTitle: "概述"
-translationSourceHash: 651b33ae
+translationSourceHash: ebaea3ac
translationFrom: installation/desktop/usage/overview.mdx
translationBlockHashes:
"_intro": d96e3242
- "Dashboard Overview": 60e63628
+ "Dashboard Overview": 0cc8797c
"Feedback and Issues": 9304f358
---
@@ -34,17 +34,36 @@ Comfy Desktop 窗口分为几个关键区域。下图标出了 Dashboard 的主
### 应用菜单
-左上角的汉堡菜单(☰)打开应用菜单(File / Edit / View / Window / Help)。使用它可以新开窗口、访问**桌面设置**、**登录**你的 Comfy 账户、退出应用,或进行其他桌面级操作。
+
-
+左上角的汉堡菜单(☰)打开应用菜单,应用层面的操作都在这里:
+
+- **Open Dashboard**:在新窗口中打开 Dashboard。正在运行的实例会继续运行。
+- **New Instance** 与 **Add Existing Instance**:新建实例,或将已有的 ComfyUI 安装纳入管理。
+- **Load Snapshot**:用他人分享的快照文件创建实例。
+- **Log in**:登录 Comfy 账户。仅在未登录时显示该条目。
+- **Performance Tests**:对某个实例运行计时工作流。详见[性能测试与基准测试](/zh/installation/desktop/usage/performance-tests)。
+- **Benchmarks**:跨硬件、工作流和实例对比已保存的性能测试结果。
+- **Desktop Settings**:全局设置,包括自动更新、代理/镜像、共享存储和数据位置。
+- **Send Feedback**:打开反馈面板。
+- **Close Window** 与 **Quit Desktop**:关闭当前窗口,或退出应用。关闭实例窗口会停止该窗口运行的 ComfyUI 实例,关闭最后一个窗口会退出 Comfy Desktop。
+
+有两个条目只在特定情况下出现:ComfyUI 视图被缩放后出现 **Reset Zoom (N%)**,首次运行设置期间出现 **Skip Onboarding**。首次运行设置显示时,**Skip Onboarding** 是该菜单里唯一的条目。
+
+macOS 上应用还会保留系统菜单栏,包含应用、编辑和窗口菜单。Windows 和 Linux 版本没有系统菜单栏。
+
+
全局设置:自动更新、代理/镜像、共享存储和数据位置。
+
+ 测量工作流在实例上的运行速度,并跨硬件对比运行结果。
+
### 实例切换器
-中间胶囊按钮显示当前激活的 ComfyUI 实例名称。点击它打开**实例选择器**弹窗,列出所有已安装的实例及其运行状态,方便切换或启动新实例。
+中间胶囊按钮显示当前激活的 ComfyUI 实例名称。点击它打开**实例选择器**弹窗,列出所有已安装的实例及其运行状态,方便切换或启动新实例。当该实例有新的 ComfyUI 版本可用时,胶囊按钮上会出现 **Update** 标签,点击即可更新实例,无需打开选择器。
@@ -54,11 +73,15 @@ Comfy Desktop 窗口分为几个关键区域。下图标出了 Dashboard 的主
### 右侧按钮
-标题栏右侧的按钮组提供快捷入口:
+
+
+标题栏右侧的控件提供以下快捷入口:
- **Desktop Update**:当 Comfy Desktop 有新版本可用时,这里会出现更新胶囊按钮。点击即可下载并应用更新。
+- **Reset Zoom**:当 ComfyUI 视图缩放比例不是 100% 时,会显示一个标注当前缩放比例的胶囊按钮。点击可恢复到 100%。
+- **What's new**:打开公告面板。公告介绍 ComfyUI 新功能和 Comfy 产品发布,包含短视频、要点说明和详情链接。有尚未查看的公告时,铃铛图标上会显示圆点,打开面板后圆点消失。
- **Feedback**:向 Comfy Desktop 团队提交反馈。
-- **Downloads**:打开下载托盘,查看进行中和最近的下载任务。
+- **Downloads**:打开下载托盘。徽标显示正在进行的下载数量,并标记失败和未查看的下载。在托盘中可以重试失败的下载,也可以取消正在进行的下载;点击 **View All Downloads** 可查看完整列表,完整列表中还可以暂停和继续下载。
### 搜索框
diff --git a/zh/installation/desktop/usage/performance-tests.mdx b/zh/installation/desktop/usage/performance-tests.mdx
new file mode 100644
index 0000000000..4bfb69e4a1
--- /dev/null
+++ b/zh/installation/desktop/usage/performance-tests.mdx
@@ -0,0 +1,155 @@
+---
+title: "性能测试与基准测试"
+description: "使用性能测试测量 ComfyUI 工作流速度,然后通过 Comfy Desktop 中的基准测试比较不同 GPU、工作流和实例上的运行结果"
+icon: "gauge"
+sidebarTitle: "性能测试"
+translationSourceHash: 429915c2
+translationFrom: installation/desktop/usage/performance-tests.mdx
+translationBlockHashes:
+ "_intro": 7a65e6d8
+ "Running a Performance Test": d3b8adb1
+ "Comparing Runs with Benchmarks": b85e9c09
+ "Where results are stored": afbb1b95
+ "Requirements": f8a3cde3
+---
+**性能测试** 用于测量 ComfyUI 工作流在您的某个实例上运行所需的时间。您可以选择一个实例、加载一个工作流,Comfy Desktop 会按指定的运行次数执行它,为每一次计时的运行记录耗时,并报告最快、最慢、平均和中位时长,同时说明这些数据来自哪套硬件和软件。
+
+**基准测试** 用于比较这些已记录的结果。它会列出每一次已保存的运行,按工作区、实例、硬件或工作流进行筛选,并将已选择的运行以相对速度系数的形式并排对比,让您看清某块 GPU、某个工作流或某个实例比其他快多少。
+
+这两个面板都从应用菜单打开:点击左上角的 ☰ 菜单,然后选择 **Performance Tests** 或 **Benchmarks**。
+
+
+
+
+性能测试会在真实实例上运行真实工作流,因此一次测试的耗时大致等于工作流本身的耗时乘以运行次数。你导入的工作流必须先以 [API 格式](/zh/development/api-development/workflow-api-format) 导出。Comfy Desktop 自带的示例工作流已经是该格式。
+
+
+## 运行性能测试
+
+该面板由三个编号步骤并排组成,窗口较窄时改为纵向排列。
+
+
+
+### 1. 选择实例
+
+选择要测试的**工作区**和**实例**。实例及其硬件信息会随结果一并记录,这正是后续比较有意义的原因:来自不同 GPU 的运行结果始终可以区分开。
+
+开始测试时,如果该实例上一次的性能测试会话仍在运行,Comfy Desktop 会先停止该会话,然后以控制台会话启动该实例。当有其他本地 ComfyUI 正在运行、正在启动或正在停止时,Comfy Desktop 会拒绝开始测试,并在提示中列出这些实例。请先停止它们,或等待其启动或停止完成,然后重新运行测试。Comfy Cloud 实例和远程实例在别处运行,不会阻止测试。其他占用 GPU 的任务(例如游戏或视频导出)仍会影响测量结果,运行测试前请先停止它们。
+
+### 2. 选择工作流
+
+你可以选择 Comfy Desktop 自带的示例工作流,也可以使用自己的工作流。
+
+**示例工作流**开箱即用,所需模型会自动下载。点击 **选择示例工作流** 打开选择器:它把示例按模态分成若干标签页(视频、图像、3D、音频;只有存在示例的模态才会显示标签页),每张卡片显示示例的名称、任务以及模型下载大小。点击 **使用工作流** 选定一个。随后 Comfy Desktop 会下载工作流仍缺少的模型,拖放区域会显示下载进度直到完成。使用示例工作流要求实例已完整安装且网络在线;如果模型体积超出剩余磁盘空间,选择器会阻止选择。示例工作流与实例绑定:切换到另一个实例时,会丢弃为前一个实例准备好的示例,除非该示例的会话已经记录了结果。
+
+**使用自己的工作流**时,必须先以 [API 格式](/zh/development/api-development/workflow-api-format) 导出,然后将 `.json` 文件拖放到拖放区域,或点击该区域浏览并选择文件。
+
+
+
+无论用哪种方式,Comfy Desktop 都会将工作流复制到测试会话文件夹中,因此即使你移动或修改原始文件,测试仍然可以正常运行。
+
+### 3. 配置测量设置
+
+| 设置 | 范围 | 默认值 | 作用 |
+|---------|-------|---------|--------------|
+| **预热运行** | 1 到 5 | 1 | 最先执行的运行,用于加载模型并预热缓存。它们不计入结果。 |
+| **测量运行** | 1 到 100 | 5 | 在预热运行之后计时的运行。它们的时长用于计算结果。 |
+
+每次运行都会将工作流的数值种子输入加一,因此各次测量运行不会重复完全相同的缓存结果。
+
+三步都设置好后,点击 **Run** 开始测试。旁边的 **Stop** 按钮可以取消正在进行的测试。
+
+### 查看结果
+
+测试运行期间,面板会显示已完成的运行数量以及实例日志。所有运行结束后,实例会被停止,随后显示结果:
+
+- **最快运行**、**最慢运行**、**平均运行**和**中位数运行**,单位为秒
+- **测量运行**和**失败运行**:有多少次运行产生了时长数据,有多少次没有
+- **运行时长汇总**:对比四项汇总值(最快、最慢、平均和中位数)的柱状图
+- **系统信息**:计算设备、显存、内存、PyTorch 版本、xFormers 版本、CPU、CPU 核心数、操作系统和架构
+
+一次运行的时长是 ComfyUI 在服务器上执行该任务所花费的时间,而不是你等待的时间。失败的运行会单独计数,并且不计入统计。
+
+结果旁边有两个按钮:**打开文件夹**会打开会话文件夹,**导出结果**会将摘要和图表保存为 PNG 图像。
+
+## 使用 Benchmarks 对比运行结果
+
+Benchmarks 会读取 Performance Tests 保存的结果,因此在至少一个测试完成之前,它没有任何内容可显示。
+
+### 运行记录库
+
+**运行记录库**按最新的排在最前的顺序,列出结果文件夹中保存的每一条运行记录。其工具栏提供以下功能:
+
+- **选择文件夹**:将面板指向另一个结果文件夹,例如共享驱动器上的文件夹。默认是 Performance Tests 写入的文件夹,参见[结果存储位置](#结果存储位置)。
+- **刷新会话**:在其他位置有测试完成之后重新加载该文件夹。
+- **搜索运行记录**:按文本过滤列表。
+- 用于按工作区、实例、硬件和工作流筛选的下拉菜单。
+- **属性**:选择库中显示的列(会话、日期和时间、工作流、实例、工作区、运行次数、GPU 和硬件)。
+
+
+
+### 对比运行记录
+
+使用复选框选择两条或更多运行记录,或使用**全选可见运行记录**。库加载时会自动选中最新的三条运行记录。一旦有选中项,库下方就会打开**对比**区域。
+
+对比会为每条选中的运行记录显示一列,旁边是一组指标行:最快、平均、中位数和最慢时长,以及实测的运行次数。其中一条运行记录是**基线**。默认情况下,它是显示的第一列。在**速度**视图中点击某一列的标题,即可改为将该运行记录作为基线。
+
+### 相对速度
+
+对比有两种视图:**时长**和**速度**,可在对比工具栏中切换。相对速度属于**速度**视图,基线也是在该视图中选择的。
+
+**相对速度**是基线时长除以某条运行记录的时长:
+
+- **1.00×** 表示该运行记录的速度与基线相同
+- 系数大于 1.00× 表示该运行记录比基线**更快**
+- 系数小于 1.00× 表示该运行记录比基线**更慢**
+
+**速度**视图在对数轴上绘制每条运行记录,**较慢**在左、**较快**在右,因此 2 倍与 4 倍的差异可以在同一张图表上保持可读。**时长**视图将每条运行记录的最快和最慢结果绘制为一条线,并标出平均值。没有可用时长的运行记录会标记为不可用。
+
+
+
+### 排序与导出
+
+- **排序对比**按相对速度对列进行排序。**手动排序**允许你拖动列来排列自己的顺序,或在聚焦的列上按 Alt+Left / Alt+Right。
+- **导出结果**会将整个对比保存为 PNG 图像,这是把结果附加到 issue 或聊天消息中最快捷的方式。
+
+### 管理会话
+
+每个测试都以会话的形式存储。你可以从库中重命名会话(**编辑会话**)或删除会话(**删除**)。删除会移除该会话记录的所有文件。
+
+## 结果存储位置
+
+Performance Tests 会在你把工作流添加到面板时创建一个会话文件夹,并以那一刻的时间戳(`YYYYMMDDHHMMSS`)命名:
+
+```
+📂 ComfyUI-Shared/
+└── 📂 benchmarks/
+ ├── 📂 20260930141522/
+ │ ├── my_workflow.json
+ │ ├── jobs.json
+ │ ├── results.json
+ │ └── logs.txt
+ └── 📂 20260930163005/
+ └── ...
+```
+
+| 平台 | 默认结果文件夹 |
+|----------|------------------------|
+| Windows | `%LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared\benchmarks` |
+| macOS / Linux | `~/ComfyUI-Shared/benchmarks` |
+
+每个会话文件夹包含:
+
+- 面板使用的工作流文件
+- `jobs.json`:实例返回的原始任务响应
+- `results.json`:Benchmarks 面板读取的摘要
+- `logs.txt`:本次运行中实例的控制台输出
+
+由于 Benchmarks 会读取它找到的每个会话文件夹中的 `results.json`,因此只要将会话文件夹复制到 Benchmarks 所指向的文件夹中,就足以比较来自另一台机器的结果。
+
+再次运行同一个已导入的工作流时,结果会写入同一个会话文件夹,并覆盖其中已有的结果。若想保留某次结果用于对比,请在下次测试前重新把工作流添加到面板。
+
+## 前提条件
+
+- 一个 Comfy Desktop 可以启动的独立、已跟踪或远程实例。测试需要一个可正常运行的 ComfyUI 实例,因此无法针对云端实例运行。
+- 一个该实例可执行的工作流,包括其所需的任何模型和自定义节点。你导入的工作流必须采用 API 格式;示例工作流已经是该格式,Comfy Desktop 会下载它们的模型。如果实例拒绝该工作流,测试会停止,错误会显示在日志中。实例接受但在执行阶段失败的运行会计入失败运行,并且不计入时长统计。
diff --git a/zh/installation/desktop/usage/settings.mdx b/zh/installation/desktop/usage/settings.mdx
index 045a6724e5..47c13e914f 100644
--- a/zh/installation/desktop/usage/settings.mdx
+++ b/zh/installation/desktop/usage/settings.mdx
@@ -3,14 +3,14 @@ title: "Comfy Desktop 设置"
description: "全局设置、主题、代理/镜像配置和数据位置"
icon: "cog"
sidebarTitle: "设置"
-translationSourceHash: 3c7fcc26
+translationSourceHash: e50dd605
translationFrom: installation/desktop/usage/settings.mdx
translationBlockHashes:
- "_intro": 21793e96
- "Preferences": e123ee00
- "Updates": b6db1add
- "Storage": 4bb5eadb
- "Advanced": 448c3a49
+ "_intro": 423ec831
+ "Preferences": ba98a2b9
+ "Updates": 60392d09
+ "Storage": 52d0d5f6
+ "Advanced": f4ef9849
"Logs": f8e4484f
"Data Locations": 12e5d644
"Keyboard Shortcuts": d36c977e
@@ -28,13 +28,27 @@ translationBlockHashes:

+偏好设置标签页首先是 **语言** 选择器,其余控件分为三个部分。
+
- **语言**:选择显示语言。支持 **English** 和 **中文**。
+
+### 应用行为
+
- **启动时自动启动**:选择打开 Comfy桌面版 时自动启动的实例。默认选项为 **无(显示仪表盘)**。你也可以选择 **上次使用的实例**,或某个特定的安装。
- **关闭窗口前确认**:关闭正在运行本地安装的窗口之前请求确认。
- **运行多个实例前警告**:当已有本地 ComfyUI 实例正在运行或正在启动时,在启动另一个本地 ComfyUI 实例之前显示警告。
- **从实例选择器中隐藏云端**:从仪表盘中隐藏云端行。如果稍后重新启用此选项,云端仍然可用。
+
+### 隐私
+
- **分享匿名使用遥测数据**:发送匿名使用数据,以帮助改进 Comfy桌面版。
-- **Comfy桌面版**:链接到 [Comfy桌面版 GitHub 仓库](https://github.com/Comfy-Org/Comfy-Desktop)。
+- **加入 Beta 功能测试**:让 Comfy桌面版 为你的实例提前开启 Core 功能。需要先用 **分享匿名使用遥测数据** 确认数据共享,否则该开关保持禁用,即使遥测已经开启也是如此。
+
+Beta 功能以额外的启动参数形式添加在你自己的参数之上:Comfy桌面版 绝不会删除或替换你自己的参数。当某个实例开启 Beta 功能时,标题栏会出现标题为 **已启用 Beta 功能** 的卡片。选择 **知道了** 关闭它,选择 **设置** 会在本面板中打开该开关。Beta 功能添加了哪些参数,可以在该实例的启动参数标签页中查看,位于 **启动参数** 旁边的 **+N beta** 标签内。
+
+### 社区
+
+- **Comfy桌面版**:一张链接到 [Comfy桌面版 GitHub 仓库](https://github.com/Comfy-Org/Comfy-Desktop) 的卡片,并显示 Star 数。
## 更新
@@ -50,12 +64,12 @@ translationBlockHashes:

-- **共享模型**:此处列出的每个目录都会被所有实例扫描以查找模型。标记为**主要**的目录是新模型默认保存的位置。
+- **共享模型**:此处列出的每个目录都会被所有实例扫描以查找模型。带 **DOWNLOADS** 角标的目录是新模型的下载位置。
- 
+ 
- 点击文件夹图标可在文件管理器中打开目录。
- - 点击目录上的 **...** 菜单(1),然后选择 **Make primary**(2)可更改新模型的默认保存目录。
+ - 点击目录上的 **...** 菜单(1),然后选择 **Use for Model Downloads**(2)即可把该目录设为模型下载位置。
- 点击 **+ 添加共享目录** 可添加更多模型目录。
- **共享输入**:所有实例查找输入文件(图像、视频等)的共享路径。
- **共享输出**:所有实例保存已生成输出的共享路径。自定义此路径可将所有结果集中存放在一处。
diff --git a/zh/installation/desktop/windows.mdx b/zh/installation/desktop/windows.mdx
index 24e2319951..59864589cc 100644
--- a/zh/installation/desktop/windows.mdx
+++ b/zh/installation/desktop/windows.mdx
@@ -3,12 +3,12 @@ title: "适用于 Windows 的 Comfy Desktop"
description: "在 Windows 上安装 Comfy Desktop:系统要求、安装步骤、更新,以及如何在 Windows 10 及更高版本上彻底卸载并本地运行 ComfyUI。"
icon: "windows"
sidebarTitle: "Windows"
-translationSourceHash: 56205b32
+translationSourceHash: 592ccfc9
translationFrom: installation/desktop/windows.mdx
translationBlockHashes:
"_intro": 27d36d8f
"System Requirements": ceeec5a6
- "Installation": be718ecf
+ "Installation": 955f804c
"Updating Comfy Desktop": b0efe5cd
"Uninstalling": 4b80edaa
---
@@ -33,7 +33,7 @@ import UpdateGuide from "/snippets/zh/desktop/update.mdx"
运行下载的 `.exe` 安装程序(NSIS 安装器),然后按照提示操作。安装之后,从开始菜单或桌面快捷方式启动 Comfy Desktop。

-当您首次打开应用时,您会看到**欢迎**屏幕,您可以在此创建您的第一个安装。
+首次打开应用时,初始设置流程会询问你希望如何运行 Comfy:使用 Comfy Cloud,或在本机安装。它会收集哪些选择,见[首次启动](/zh/installation/desktop/overview#首次启动)。