diff --git a/interface/settings/3d.mdx b/interface/settings/3d.mdx index 974f5388b..70adf5bac 100644 --- a/interface/settings/3d.mdx +++ b/interface/settings/3d.mdx @@ -55,13 +55,6 @@ The light settings in this section are used to set the default lighting settings Change the background color, which can also be adjusted in the canvas. ![Initial Background Color vs Modified](/images/interface/setting/3d/background_color.jpg) -### Initial Preview Visibility -- **Function**: Controls whether the preview screen is displayed by default when creating new 3D components. This default setting can still be toggled individually for each component after creation -- **Default Value**: true (enabled) - -![Preview vs hide preview](/images/interface/setting/3d/hide_preview.jpg) - - ### Initial Grid Visibility - **Function**: Controls whether the grid is displayed by default when creating new 3D components. This default setting can still be toggled individually for each component after creation - **Default Value**: true (enabled) @@ -69,3 +62,19 @@ Change the background color, which can also be adjusted in the canvas. Hide or show the grid on initialization ![Show grid vs hide grid](/images/interface/setting/3d/hide_grid.jpg) + + +## 3D Viewer + +### Enable 3D Viewer (Beta) +- **Setting ID**: `Comfy.Load3D.3DViewerEnable` +- **Type**: boolean +- **Default Value**: false (disabled) +- **Function**: Controls whether the 3D Viewer (Beta) is enabled. When enabled, a button will appear on 3D component nodes that can be clicked to open a full-size 3D viewer + +### PLY Engine +- **Setting ID**: `Comfy.Load3D.PLYEngine` +- **Type**: combo +- **Options**: `threejs`, `fastply`, `sparkjs` +- **Default Value**: `threejs` +- **Function**: Selects the engine used to load PLY files. `threejs` uses the native Three.js PLYLoader (best for mesh PLY files), `fastply` uses a loader optimized for ASCII point cloud PLY files, and `sparkjs` uses Spark.js to load 3D Gaussian Splatting PLY files diff --git a/interface/settings/about.mdx b/interface/settings/about.mdx index 1ed596ecc..2246011c2 100644 --- a/interface/settings/about.mdx +++ b/interface/settings/about.mdx @@ -17,10 +17,20 @@ The About page is an information display panel in the ComfyUI settings system, u The About page displays the following core version information: -- **ComfyUI Version**: Shows the backend ComfyUI version number, linked to the official GitHub repository +- **ComfyUI Version**: Shows the backend ComfyUI version. The format depends on the distribution: + - **OSS (Open Source)**: Displays `ComfyUI `, linked to the main [GitHub repository](https://github.com/Comfy-Org/ComfyUI) + - **Desktop**: Displays `ComfyUI v`, linked to the same GitHub repository + - **Cloud**: Displays `ComfyUI `, linked to [comfy.org](https://www.comfy.org) with a cloud icon - **ComfyUI_frontend Version**: Shows the frontend interface version number, linked to the frontend GitHub repository +- **Templates Version**: If `systemStats.system.installed_templates_version` is available, a Templates badge is displayed: + - Label: `Templates v` + - Link: [https://pypi.org/project/comfyui-workflow-templates/](https://pypi.org/project/comfyui-workflow-templates/) + - Icon: `pi pi-book` + - If the installed version differs from the required version, the badge appears with a **danger** severity level (red) - **Discord Community**: Provides a link to the ComfyOrg Discord server -- **Official Website**: Links to the ComfyOrg official website +- **ComfyOrg**: Links to the ComfyOrg official website + +The badges are displayed in the following order: ComfyUI → Frontend → Templates (if installed) → Discord → ComfyOrg. Since the version information here mainly corresponds to stable version information, if you are using the nightly version, the corresponding commit hash will not be displayed here. If you are using the nightly version, you can use the `git log` command in the corresponding ComfyUI main directory to view the corresponding commit hash and other information. @@ -33,10 +43,35 @@ If custom nodes are installed, the About page will also display additional badge ### System Info -The bottom of the page displays detailed system statistics, including: -- Hardware configuration information -- Software environment information -- System performance data +The bottom of the page displays detailed system statistics, which vary depending on the distribution: + +**OSS / General Version:** +- **OS**: Operating system identifier +- **Python Version**: Installed Python version +- **Embedded Python**: Embedded Python details (if applicable) +- **Pytorch Version**: PyTorch framework version +- **Arguments (argv)**: Command-line arguments used to launch ComfyUI +- **RAM Total**: Total available system RAM +- **RAM Free**: Currently free system RAM +- **Templates Version**: Shown with danger styling if the installed version is outdated + +**Cloud Version:** +- **Cloud Version**: Cloud platform version +- **ComfyUI Version**: Backend ComfyUI version +- **Frontend Version**: Frontend interface version +- **Templates Version**: Workflow templates version + +**Devices** (displayed when compatible hardware is detected): +- Device name and type (e.g. GPU model) +- **VRAM Total / VRAM Free**: Graphics memory statistics +- **Torch VRAM Total / Torch VRAM Free**: PyTorch-managed VRAM statistics +- Multiple devices are presented in a **TabView**, one tab per device + +A **Copy System Info** button is provided at the bottom, which copies all system information in a formatted text block to the clipboard for easy sharing when reporting issues. + +### Version Update Notifications + +The `ShowVersionUpdates` setting (found under Comfy → Notification Preferences) controls whether version update notifications are shown on the About page and elsewhere in the interface. ## Extension Developer Guide diff --git a/interface/settings/comfy-desktop.mdx b/interface/settings/comfy-desktop.mdx index 55f98f4dc..dce2e2033 100644 --- a/interface/settings/comfy-desktop.mdx +++ b/interface/settings/comfy-desktop.mdx @@ -1,6 +1,6 @@ --- title: "Comfy Desktop General Settings" -description: "Detailed description of ComfyUI Desktop general setting options" +description: "Detailed description of ComfyUI Desktop specific setting options" icon: "desktop" sidebarTitle: "Comfy Desktop" --- @@ -9,31 +9,78 @@ import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx" +The Comfy Desktop settings section contains settings that are specific to the ComfyUI Desktop application (Electron-based). These settings are registered by the `Comfy.ElectronAdapter` extension and only appear when running ComfyUI Desktop. Changes to several of these settings require restarting the application to take effect. + ## General ### Window Style -**Function**: Controls the title bar style of the application window +- **Setting ID**: `Comfy-Desktop.WindowStyle` +- **Type**: combo +- **Options**: `default`, `custom` +- **Default Value**: `default` +- **Experimental**: Yes +- **Function**: Controls the title bar style of the application window. The `custom` option replaces the system title bar with ComfyUI's built-in Top menu. ### Automatically check for updates -**Function**: Automatically checks for ComfyUI Desktop updates and will remind you to update when updates are available - +- **Setting ID**: `Comfy-Desktop.AutoUpdate` +- **Type**: boolean +- **Default Value**: true (enabled) +- **Function**: Automatically checks for ComfyUI Desktop updates and will notify you when updates are available. Changes require a restart to take effect. + ### Send anonymous usage metrics -**Function**: Sends anonymous usage statistics to help improve the software. Changes to this setting require a restart to take effect +- **Setting ID**: `Comfy-Desktop.SendStatistics` +- **Type**: boolean +- **Default Value**: true (enabled) +- **Function**: Sends anonymous usage statistics to help improve the software. Changes require a restart to take effect. + +## UV (Mirror Settings) -## UV +The UV section provides mirror configuration for users in China and other regions where default download sources may be slow or inaccessible. Use this section to configure alternative download mirrors for Python distributions, pip packages, and PyTorch packages. + +All UV settings are of type `url` and support: +- HTTP/HTTPS URLs for remote mirrors +- `file://` URLs for local directory distribution packages +- Automatic reachability validation -This section is mainly for users in China, because many of the original mirrors used by Desktop are outside of China, so access may not be friendly for domestic users. You can set your own mirror sources here to improve access speed and ensure that corresponding packages can be accessed and downloaded normally. - ### Python Install Mirror -**Function**: - - Managed Python installation packages are downloaded from the Astral python-build-standalone project - - Can set mirror URL to use different Python installation sources - - The provided URL will replace the default GitHub download address - - Supports using file:// protocol to read distribution packages from local directories -**Validation**: Automatically checks mirror reachability - +- **Setting ID**: `Comfy-Desktop.UV.PythonInstallMirror` +- **Type**: url +- **Default Value**: empty string (uses default GitHub source) +- **Tooltip**: Managed Python installations are downloaded from the Astral python-build-standalone project. This variable can be set to a mirror URL to use a different source for Python installations. The provided URL will replace `https://github.com/astral-sh/python-build-standalone/releases/download` in distribution URLs. Distributions can be read from a local directory by using the `file://` URL scheme. +- **Validation**: Automatically checks mirror reachability with a ping suffix + ### Pypi Install Mirror -**Function**: Default pip package installation mirror source - +- **Setting ID**: `Comfy-Desktop.UV.PypiInstallMirror` +- **Type**: url +- **Default Value**: empty string (uses default pip source) +- **Function**: Default pip package installation mirror source +- **Tooltip**: Default pip install mirror +- **Validation**: Automatically checks mirror reachability + ### Torch Install Mirror - **Function**: PyTorch-specific pip installation mirror source +- **Setting ID**: `Comfy-Desktop.UV.TorchInstallMirror` +- **Type**: url +- **Default Value**: empty string (uses default PyTorch source) +- **Function**: PyTorch-specific pip installation mirror source +- **Tooltip**: Pip install mirror for pytorch +- **Validation**: Automatically checks mirror reachability + +## Available Commands + +In addition to settings, Desktop users have access to the following commands (accessible from the Help menu): + +### Open Folders +- **Open Logs Folder** — Opens the ComfyUI Desktop logs folder +- **Open Models Folder** — Opens the models directory +- **Open Outputs Folder** — Opens the outputs directory +- **Open Inputs Folder** — Opens the inputs directory +- **Open Custom Nodes Folder** — Opens the custom nodes directory +- **Open extra_model_paths.yaml** — Opens the model configuration file + +### Application Commands +- **Check for Updates** — Manually check for ComfyUI Desktop updates +- **Reinstall** — Reinstall ComfyUI Desktop +- **Restart** — Restart the application +- **Quit** — Quit the application +- **Open DevTools** — Open Chrome Developer Tools +- **Desktop User Guide** — Open the Desktop user guide in a browser diff --git a/interface/settings/comfy.mdx b/interface/settings/comfy.mdx index 3b8d93aad..a9356e72a 100644 --- a/interface/settings/comfy.mdx +++ b/interface/settings/comfy.mdx @@ -19,27 +19,56 @@ import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx" > For more information about Partner Nodes, please refer to [Partner Nodes](/tutorials/partner-nodes/overview) +## Appearance + +### Disable animations +- **Default Value**: Follows system `prefers-reduced-motion` setting +- **Function**: Turns off most CSS animations and transitions. Speeds up inference when the display GPU is also used for generation. + +### Tab Bar Layout +- **Options**: Default, Legacy +- **Default Value**: Default +- **Function**: Controls the elements contained in the integrated tab bar. + ## Dev Mode ### Enable dev mode options (API save, etc.) - **Default Value**: Disabled - **Function**: Enables development mode options (such as API save, etc.) - ## Edit Token Weight ### Ctrl+up/down precision -- **Default Value**: 0.01 +- **Default Value**: 0.05 +- **Range**: 0.01 - 0.50 - **Function**: When using CLIPTextEncode type nodes or text input node widgets, use Ctrl+up/down to quickly adjust weights. This option changes the weight value for each adjustment +## Error System + +### Show errors tab in side panel +- **Default Value**: Enabled +- **Experimental**: Yes +- **Function**: When enabled, an errors tab is displayed in the right side panel to show workflow execution errors at a glance. + +## Execution + +### Live preview method +- **Default Value**: default +- **Options**: default, none, auto, latent2rgb, taesd +- **Function**: Live preview method during image generation. "default" uses the server CLI setting. + - `none`: No preview images displayed, only shows progress bar during generation + - `auto`: Automatically selects the most suitable preview method + - `latent2rgb`: Directly converts latent space data to RGB images for preview + - `taesd`: Uses lightweight TAESD model for preview + ## Locale ### Language -- **Options**: English, 中文 (Chinese),日本語 (Japanese), 한국어 (Korean), Русский (Russian), Español (Spanish), Français (French) +- **Options**: English, 中文 (Chinese), 繁體中文 (Traditional Chinese), 日本語 (Japanese), 한국어 (Korean), Русский (Russian), Español (Spanish), Français (French), Português (BR), Türkçe (Turkish), عربي (Arabic), فارسی (Persian) - **Default Value**: Auto-detect browser language - **Function**: Modify the display language of ComfyUI interface @@ -47,17 +76,14 @@ import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx" ### Use new menu - **Default Value**: Top -- **Function**: Select menu interface and position, currently only supports Top, Bottom, Disabled +- **Options**: Top, Disabled +- **Function**: Select menu interface and position. The menu interface will be displayed at the top of the workspace ![Top Menu](/images/interface/setting/comfy/UseNewMenu_top.jpg) - - The menu bar interface will be displayed at the bottom of the workspace - ![Bottom Menu](/images/interface/setting/comfy/UseNewMenu_bottom.jpg) - If you prefer the early legacy menu, you can try this option. @@ -75,7 +101,8 @@ Model Library refers to the model management function in the ComfyUI sidebar men ### What name to display in the model library tree view - **Default Value**: title -- **Function**: Select the name format to display in the model library tree view, currently only supports filename and title +- **Options**: filename, title +- **Function**: Select the name format to display in the model library tree view. ### Automatically load all model folders - **Default Value**: Disabled @@ -91,83 +118,99 @@ During the iteration process of ComfyUI, we will adjust some nodes and enable so ![Show deprecated nodes in search](/images/interface/setting/comfy/depr_node.jpg) - ### Show experimental nodes in search - **Default Value**: Enabled - **Function**: Controls whether to display experimental nodes in search. Experimental nodes are some new feature support, but are not fully stable and may change or be removed in future versions. ![Show experimental nodes in search](/images/interface/setting/comfy/beta_node.jpg) +### Enable node replacement suggestions +- **Default Value**: Enabled +- **Function**: When enabled, missing nodes with known replacements will be shown as replaceable in the missing nodes dialog, allowing you to review and apply replacements. -## Node Search Box +### Always show advanced widgets on all nodes +- **Default Value**: Disabled +- **Function**: When enabled, advanced widgets are always visible on all nodes without needing to expand them individually. -### Number of nodes suggestions -- **Default Value**: 5 -- **Function**: Used to modify the number of recommended nodes in the related node context menu. The larger the value, the more related recommended nodes are displayed. +## Node Library -![Number of nodes suggestions](/images/interface/setting/comfy/node_suggestions.jpg) +### New Node Library Design +- **Default Value**: Enabled +- **Experimental**: Yes +- **Function**: Enable the redesigned node library sidebar with tabs (Essential, All, Custom), improved search, and hover previews. -### Show node frequency in search results -- **Default Value**: Disabled -- **Function**: Controls whether to display node usage frequency in search results +## Node Search Box -![Show node frequency in search results](/images/interface/setting/comfy/node_frequency.png) +### Node search box implementation +- **Options**: default, v1 (legacy), litegraph (legacy) +- **Default Value**: default +- **Function**: Select the implementation method of the node search box. `default` is the latest implementation. `v1 (legacy)` and `litegraph (legacy)` switch to earlier versions of the ComfyUI search box. + +### Show node category in search results +- **Default Value**: Enabled +- **Function**: Controls whether to display node categories in search results. Only applies to v1 (legacy) implementation. ### Show node id name in search results - **Default Value**: Disabled -- **Function**: Controls whether to display node ID names in search results - -![Show node id name in search results](/images/interface/setting/comfy/node_id_name.jpg) +- **Function**: Controls whether to display node ID names in search results. Does not apply to litegraph (legacy). +### Show node frequency in search results +- **Default Value**: Disabled +- **Function**: Controls whether to display node usage frequency in search results. Only applies to v1 (legacy). -### Show node category in search results +### Node preview - **Default Value**: Enabled -- **Function**: Controls whether to display node categories in search results, helping users understand node classification information +- **Function**: Controls whether to display node previews in search results. Only applies to the default implementation. -### Node preview +### Added nodes follow the cursor - **Default Value**: Enabled -- **Function**: Controls whether to display node previews in search results, making it convenient for you to quickly preview nodes +- **Function**: When enabled, nodes added from the search box follow the cursor until clicked to place. Only applies to the default implementation. -### Node search box implementation -- **Default Value**: default -- **Function**: Select the implementation method of the node search box (experimental feature). If you select `litegraph (legacy)`, it will switch to the early ComfyUI search box +## Notification Preferences + +### Show version updates +- **Default Value**: Enabled +- **Function**: Show updates for new models, and major new features. ## Node Widget ### Widget control mode - **Options**: before, after -- **Function**: Controls whether the timing of node widget value updates is before or after workflow execution, such as updating seed values +- **Default Value**: after +- **Function**: Controls whether the timing of node widget value updates is before or after workflow execution, such as updating seed values. ### Textarea widget spellcheck - **Default Value**: Disabled -- **Function**: Controls whether text area widgets enable spellcheck, providing spellcheck functionality during text input. This functionality is implemented through the browser's spellcheck attribute +- **Function**: Controls whether text area widgets enable spellcheck, providing spellcheck functionality during text input. This functionality is implemented through the browser's spellcheck attribute. + +### Textarea widget font size +- **Default Value**: 10 +- **Range**: 8 - 24 +- **Function**: Set the font size in textarea widgets. Adjusts the text display size in text input boxes to improve readability. ## Queue ### Queue history size -- **Default Value**: 100 -- **Function**: Controls the queue history size recorded in the sidebar queue history panel. The larger the value, the more queue history is recorded. When the number is large, loading the page will also consume more memory +- **Default Value**: 64 +- **Range**: 2 - 256 +- **Function**: Controls the queue history size recorded in the sidebar queue history panel. The larger the value, the more queue history is recorded. + +### Docked job history/queue panel +- **Default Value**: Disabled (enabled in nightly builds) +- **Experimental**: Yes +- **Function**: Replaces the floating job queue panel with an equivalent job queue embedded in the job history side panel. You can disable this to return to the floating panel layout. ## Queue Button ### Batch count limit - **Default Value**: 100 -- **Function**: Sets the maximum number of tasks added to the queue in a single click, preventing accidentally adding too many tasks to the queue +- **Function**: Sets the maximum number of tasks added to the queue in a single click, preventing accidentally adding too many tasks to the queue. ## Validation -### Validate node definitions (slow) -- **Default Value**: Disabled -- **Function**: Controls whether to validate all node definitions at startup (slow). Only recommended for node developers. When enabled, the system will use Zod schemas to strictly validate each node definition. This functionality will consume more memory and time -- **Error Handling**: Failed node definitions will be skipped and warning information will be output to the console - - - Since detailed schema validation needs to be performed on all node definitions, this feature will significantly increase startup time, so it is disabled by default and only recommended for node developers - - ### Validate workflows -- **Default Value**: Enabled -- **Function**: Ensures the structural and connection correctness of workflows. If enabled, the system will call `useWorkflowValidation().validateWorkflow()` to validate workflow data +- **Default Value**: Disabled +- **Function**: Ensures the structural and connection correctness of workflows when loading. - **Validation Process**: The validation process includes two steps: - Schema validation: Use Zod schemas to validate workflow structure - Link repair: Check and repair connection issues between nodes @@ -177,55 +220,56 @@ During the iteration process of ComfyUI, we will adjust some nodes and enable so ### Show confirmation when closing window - **Default Value**: Enabled -- **Function**: When there are modified but unsaved workflows, controls whether to display confirmation when closing the browser window or tab, preventing accidental window closure that leads to loss of unsaved workflows +- **Function**: When there are modified but unsaved workflows, controls whether to display confirmation when closing the browser window or tab, preventing accidental window closure that leads to loss of unsaved workflows. ## Workflow ### Persist workflow state and restore on page (re)load - **Default Value**: Enabled -- **Function**: Controls whether to restore workflow state on page (re)load, maintaining workflow content after page refresh +- **Function**: Controls whether to restore workflow state on page (re)load, maintaining workflow content after page refresh. ### Auto Save +- **Options**: off, after delay - **Default Value**: off -- **Function**: Controls the auto-save behavior of workflows, automatically saving workflow changes to avoid data loss +- **Function**: Controls the auto-save behavior of workflows, automatically saving workflow changes to avoid data loss. ### Auto Save Delay (ms) - **Default Value**: 1000 -- **Function**: Sets the delay time for auto-save, only effective when auto-save is set to "after delay" +- **Function**: Sets the delay time for auto-save, only effective when auto-save is set to "after delay". ### Show confirmation when deleting workflows - **Default Value**: Enabled -- **Function**: Controls whether to display a confirmation dialog when deleting workflows in the sidebar, preventing accidental deletion of important workflows +- **Function**: Controls whether to display a confirmation dialog when deleting workflows in the sidebar, preventing accidental deletion of important workflows. ### Save and restore canvas position and zoom level in workflows - **Default Value**: Enabled -- **Function**: Controls whether to save and restore canvas position and zoom level in workflows, restoring the previous view state when reopening workflows +- **Function**: Controls whether to save and restore canvas position and zoom level in workflows, restoring the previous view state when reopening workflows. ### Opened workflows position -- **Options**: Sidebar, Topbar, Topbar (Second Row) +- **Options**: Sidebar, Topbar - **Default Value**: Topbar -- **Function**: Controls the display position of opened workflow tabs, currently only supports Sidebar, Topbar, Topbar (Second Row) +- **Function**: Controls the display position of opened workflow tabs. ### Prompt for filename when saving workflow - **Default Value**: Enabled -- **Function**: Controls whether to prompt for filename input when saving workflows, allowing users to customize workflow filenames +- **Function**: Controls whether to prompt for filename input when saving workflows, allowing users to customize workflow filenames. ### Sort node IDs when saving workflow - **Default Value**: Disabled -- **Function**: Determines whether to sort node IDs when saving workflows, making workflow file format more standardized and convenient for version control - -### Show missing nodes warning -- **Default Value**: Enabled -- **Function**: Controls whether to display warnings for missing nodes in workflows, helping users identify unavailable nodes in workflows +- **Function**: Determines whether to sort node IDs when saving workflows, making workflow file format more standardized and convenient for version control. ### Show missing models warning +- **Default Value**: Enabled (disabled on Comfy Cloud) +- **Function**: We support adding model link information to widget values in workflow files for prompts when loading model files. When enabled, if you don't have the corresponding model files locally, warnings for missing models in workflows will be displayed. + +### Show missing nodes warning (replaced by node replacement suggestions) - **Default Value**: Enabled -- **Function**: We support adding model link information to widget values in workflow files for prompts when loading model files. When enabled, if you don't have the corresponding model files locally, warnings for missing models in workflows will be displayed +- **Function**: Controls whether to display warnings for missing nodes in workflows, helping users identify unavailable nodes in workflows. This functionality has been superseded by the [Enable node replacement suggestions](#enable-node-replacement-suggestions) setting, which provides more useful replaceable suggestions instead of just warnings. ### Require confirmation when clearing workflow - **Default Value**: Enabled -- **Function**: Controls whether to display a confirmation dialog when clearing workflows, preventing accidental clearing of workflow content +- **Function**: Controls whether to display a confirmation dialog when clearing workflows, preventing accidental clearing of workflow content. -### Save node IDs to workflow +### Require confirmation to overwrite an existing subgraph blueprint - **Default Value**: Enabled -- **Function**: Controls whether to save node IDs when saving workflows, making workflow file format more standardized and convenient for version control \ No newline at end of file +- **Function**: Controls whether to show a confirmation dialog when you are about to overwrite an existing subgraph blueprint with a new one. diff --git a/interface/settings/extension.mdx b/interface/settings/extension.mdx index 4b4299593..f61fde3b9 100644 --- a/interface/settings/extension.mdx +++ b/interface/settings/extension.mdx @@ -11,7 +11,7 @@ import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx" The Extension settings panel is a special management panel in the ComfyUI frontend settings system, specifically used to manage the enable/disable status of frontend extension plugins. Unlike Custom Nodes, this panel is only used to manage frontend extensions registered by custom nodes, not to disable custom nodes themselves. -![extension](/images/interface/setting/extension/extension.jpg) + These frontend extension plugins are used to enhance the ComfyUI experience, such as providing shortcuts, settings, UI components, menu items, and other features. @@ -19,23 +19,39 @@ Extension status changes require a page reload to take effect: ## Extension Settings Panel Features -### 1. Extension List Management +### 1. Extension Filter +A SelectButton filter at the top allows you to narrow down the displayed extensions: +- **All** — Shows all registered extensions +- **Core** — Shows only core extensions +- **Custom** — Shows only third-party extensions + +### 2. Extension List Management Displays all registered extensions, including: - Extension Name -- Core extension identification (displays "Core" label) -- Enable/disable status - -### 2. Search Functionality -Provides a search box to quickly find specific extensions: - -### 3. Enable/Disable Control -Each extension has an independent toggle switch: - -### 4. Batch Operations -Provides right-click menu for batch operations: -- Enable All extensions -- Disable All extensions -- Disable 3rd Party extensions (keep core extensions) +- Extension labels — Core extensions display a **"Core"** tag, third-party (non-core) extensions display a **"Custom"** (severity="info") tag +- Enable/disable status toggle +- Multi-selection checkbox column for batch operations + +### 3. Search Functionality +Provides a search box to quickly find specific extensions. + +### 4. Enable/Disable Control +Each extension has an independent toggle switch. + +### 5. Batch Operations +Provides a right-click context menu for batch operations: +- **Enable Selected** — Enable the checked extensions +- **Disable Selected** — Disable the checked extensions +- **────** +- **Enable All** — Enable all extensions +- **Disable All** — Disable all extensions +- **Disable 3rd Party** — Disable all third-party extensions (keep core extensions enabled) + +### 6. Change Notification +When toggle switches are changed, an info message appears at the bottom of the panel listing all changed extensions: +- Extensions toggled **on** (disabled → enabled) are prefixed with **[+]** +- Extensions toggled **off** (enabled → disabled) are prefixed with **[-]** +- A **"Reload to apply changes"** button lets you reload the page immediately ## Notes diff --git a/interface/settings/lite-graph.mdx b/interface/settings/lite-graph.mdx index d6ae393cd..d3fd3de72 100644 --- a/interface/settings/lite-graph.mdx +++ b/interface/settings/lite-graph.mdx @@ -19,12 +19,13 @@ LiteGraph is the underlying graphics rendering engine of ComfyUI. The settings i ![Show selection toolbox](/images/interface/setting/lite-graph/selection-toolbox.jpg) -### Low quality rendering zoom threshold -- **Default Value**: 0.6 -- **Range**: 0.1 - 1.0 -- **Function**: When rendering the interface, especially when the workflow is particularly complex and the entire canvas is particularly large, the frontend rendering of corresponding elements will consume a lot of memory and cause lag. By lowering this threshold, you can control elements to enter low quality rendering mode when scaled to a specific percentage, thereby reducing memory consumption. The corresponding different rendering modes are shown below +### Zoom Node Level of Detail - font size threshold +- **Default Value**: 8 +- **Range**: 0 - 24 +- **Function**: Controls when the nodes switch to low quality LOD (Level of Detail) rendering. Uses font size in pixels to determine when to switch. Set to 0 to disable. Higher values (24px) = switch nodes to simplified rendering sooner when zooming out. Lower values (1px) = maintain full node quality longer. +- **Replaces**: The deprecated "Low quality rendering zoom threshold" setting -![Low quality rendering](/images/interface/setting/lite-graph/render-mode.jpg) +![Zoom Node Level of Detail](/images/interface/setting/lite-graph/render-mode.jpg) ### Maximum FPS - **Default Value**: 0 (use screen refresh rate) @@ -40,8 +41,9 @@ LiteGraph is the underlying graphics rendering engine of ComfyUI. The settings i ### Snap to grid size +- **Default Value**: 10 - **Range**: 1 - 500 -- **Function**: When auto-snap is enabled or when moving nodes while holding the `Shift` key, this parameter determines the grid size for snapping. The default value is 10, and you can adjust it according to your needs. +- **Function**: When auto-snap is enabled or when moving nodes while holding the `Shift` key, this parameter determines the grid size for snapping. ### Enable fast-zoom shortcut (Ctrl + Shift + Drag) - **Default Value**: Enabled @@ -64,16 +66,53 @@ The canvas menu is located in the bottom right corner of the entire ComfyUI inte - **Range**: 1.01 - 2.5 - **Function**: Controls the speed of canvas zooming, adjusts the sensitivity of mouse wheel zooming +### Auto-pan speed +- **Default Value**: 15 +- **Range**: 0 - 30 +- **Function**: Maximum speed when auto-panning by dragging to the canvas edge. Set to 0 to disable auto-panning. + ### Show canvas info on bottom left corner (fps, etc.) - **Default Value**: Enabled - **Function**: Controls whether to display canvas information in the bottom left corner, showing performance metrics like FPS ![Canvas info](/images/interface/setting/lite-graph/canvas-info.jpg) +### Navigation Mode +- **Default Value**: legacy +- **Options**: + - **Standard (New)**: Left-click selects nodes, mouse wheel scrolls the canvas + - **Drag Navigation**: Left-click drags the canvas (legacy behavior) + - **Custom**: Manually configure left-click behavior and mouse wheel behavior below +- **Function**: Controls the overall navigation mode of the canvas. Changing this setting automatically adjusts the [Left Mouse Click Behavior](#left-mouse-click-behavior) and [Mouse Wheel Scroll](#mouse-wheel-scroll) settings accordingly. + +### Left Mouse Click Behavior +- **Default Value**: panning +- **Options**: Panning, Select +- **Function**: Controls the behavior of left-click on the canvas background. + - **Panning**: Left-click and drag on the canvas background to pan the view. + - **Select**: Left-click to select nodes, drag to create a selection rectangle. Use middle mouse button or right-click to pan. + +### Mouse Wheel Scroll +- **Default Value**: zoom +- **Options**: Panning, Zoom in/out +- **Function**: Controls the behavior of the mouse wheel on the canvas. + - **Panning**: Mouse wheel scrolls the canvas vertically. + - **Zoom in/out**: Mouse wheel zooms the canvas in and out. + +### Enable trackpad gestures +- **Default Value**: Enabled (in Standard navigation mode) +- **Function**: This setting enables trackpad mode for the canvas, allowing two-finger pinch zoom and drag. + +![Enable trackpad gestures](/images/interface/setting/lite-graph/canvas-menu.jpg) + +### Live selection +- **Default Value**: Disabled +- **Function**: When enabled, nodes are selected/deselected in real-time as you drag the selection rectangle, similar to other design tools. + ## Context Menu ### Scale node combo widget menus (lists) when zoomed in -- **Default Value**: Enabled +- **Default Value**: Disabled - **Function**: Controls whether to scale node combo widget menus (lists) when zoomed in, allowing users to select node combo widgets ## Graph @@ -100,6 +139,10 @@ This section of settings is mainly related to node group functionality - **Range**: 0 - 100 - **Function**: Sets the inner padding when grouping selected nodes, controlling the spacing between the group frame and nodes, marked as the arrow annotation part `2` in the image +### Select group children on click +- **Default Value**: Disabled +- **Function**: When enabled, clicking a group selects all nodes and items inside it. + ## Link ### Link midpoint markers @@ -124,19 +167,19 @@ This menu section currently mainly controls related operations when link connect ### Action on link release (Shift) -- **Default Value**: search box - **Options**: context menu, search box, no action +- **Default Value**: search box - **Function**: Sets the action when releasing links while holding the Shift key, special behavior when releasing links while holding Shift ### Action on link release (No modifier) -- **Default Value**: context menu - **Options**: context menu, search box, no action +- **Default Value**: context menu - **Function**: Sets the default action when releasing links, controls the behavior after dragging and releasing links ## Node ### Always shrink new nodes -- **Default Value**: Enabled +- **Default Value**: Disabled - **Function**: Controls whether to automatically shrink when creating new nodes, so nodes can always display the minimum size, but may cause some text display to be truncated when adding, requiring manual adjustment of node size ### Enable DOM element clipping (enabling may reduce performance) @@ -173,24 +216,28 @@ This menu section currently mainly controls related operations when link connect ### Tooltip Delay - **Default Value**: 500 +- **Range**: 100 - 3000 - **Function**: Controls the delay time for tooltips, in milliseconds. Setting to 0 means displaying tooltips immediately ### Node life cycle badge mode - **Default Value**: Show all -- **Function**: Controls the display of node lifecycle markers, showing node status information +- **Options**: None, Show all +- **Function**: Controls the display of node lifecycle markers, showing node status information (deprecated, experimental, etc.) ### Node ID badge mode -- **Default Value**: Show all +- **Default Value**: None +- **Options**: None, Show all - **Function**: Controls the display of node ID markers, showing node unique identifiers ![Node ID badge mode](/images/interface/setting/lite-graph/node-id-badge.jpg) ### Node source badge mode - **Options**: - - None - - Hide built-in - - Show all -- **Function**: Controls the display mode of node source markers, showing node source information. The corresponding display effect is shown in the image below. If show all is selected, it will display labels for both custom nodes and built-in nodes, making it convenient for you to determine the corresponding node source. The corresponding fox logo represents ComfyUI built-in nodes + - None: Hide all source badges + - Hide built-in: Only show badges for custom nodes + - Show all: Show badges for both built-in and custom nodes +- **Default Value**: Hide built-in +- **Function**: Controls the display mode of node source markers, showing node source information. The fox logo represents ComfyUI built-in nodes ![Node source badge mode](/images/interface/setting/lite-graph/node-source-badge.jpg) @@ -225,26 +272,40 @@ This menu section currently mainly controls related operations when link connect ## Pointer -### Enable trackpad gestures -- **Default Value**: Enabled -- **Function**: This setting enables trackpad mode for the canvas, allowing two-finger pinch zoom and drag. - ### Double click interval (maximum) - **Default Value**: 300 +- **Range**: 100 - 1000 - **Function**: Maximum time (milliseconds) between two clicks of a double-click. Increasing this value helps solve issues where double-clicks are sometimes not recognized. ### Pointer click drift delay -- **Default Value**: 150 -- **Function**: Maximum time (milliseconds) to ignore pointer movement after pressing the pointer button. Helps prevent accidental mouse movement when clicking. +- **Default Value**: 32 +- **Range**: 0 - 1000 +- **Experimental**: Yes +- **Function**: After pressing a pointer button down, this is the maximum time (in milliseconds) that pointer movement can be ignored for. Helps prevent accidental mouse movement when clicking. ### Pointer click drift (maximum distance) - **Default Value**: 6 +- **Range**: 0 - 20 +- **Experimental**: Yes - **Function**: If the pointer moves more than this distance while holding the button, it is considered a drag (rather than a click). Helps prevent accidental mouse movement when clicking. ## Reroute ### Reroute spline offset - **Default Value**: 20 +- **Range**: 0 - 400 - **Function**: Used to determine the smoothness of curves on both sides of reroute nodes. Larger values make curves smoother, smaller values make curves sharper. -![Reroute spline offset](/images/interface/setting/lite-graph/reroute-spline-offset.jpg) \ No newline at end of file +![Reroute spline offset](/images/interface/setting/lite-graph/reroute-spline-offset.jpg) + +## Nodes 2.0 (VueNodes) + +### Modern Node Design (Nodes 2.0) +- **Default Value**: Disabled (enabled on Comfy Cloud and Desktop by default for new installs) +- **Experimental**: Yes +- **Function**: Modern: DOM-based rendering with enhanced interactivity, native browser features, and updated visual design. Classic: Traditional canvas rendering. + +### Auto-scale layout (Nodes 2.0) +- **Default Value**: Enabled +- **Experimental**: Yes +- **Function**: Automatically scale node positions when switching to Nodes 2.0 rendering to prevent overlap. diff --git a/interface/settings/overview.mdx b/interface/settings/overview.mdx index b68ce0afc..d03c9b5d8 100644 --- a/interface/settings/overview.mdx +++ b/interface/settings/overview.mdx @@ -5,13 +5,66 @@ icon: "book" sidebarTitle: "Overview" --- +import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx" + + + This section covers detailed setting descriptions in the ComfyUI frontend settings menu. All user settings are automatically saved to the `ComfyUI/user/default/comfy.settings.json` file. You can use the `Ctrl + ,` keyboard shortcut to open the settings panel, then click on the corresponding setting options to configure them. -Since custom nodes can also register corresponding setting categories in the menu, our official documentation currently only includes native setting content. Additionally, some setting options are **only effective for ComfyUI Desktop**, which we have noted on the corresponding pages. +Since custom nodes can also register corresponding setting categories in the menu, our official documentation currently only includes native ComfyUI setting content. Additionally, some setting options are **only effective for ComfyUI Desktop**. + +## Settings Menu Structure + +The settings panel is organized as a sidebar with three main groups. The structure depends on whether team workspaces are enabled. + +### When team workspaces are enabled: + +1. **Workspace** + - Workspace settings (if available) + - Credits + +2. **General** + - User / Profile + - **Comfy** — Core ComfyUI settings (interface, queue, nodes, workflows, etc.) + - Secrets + - **Lite Graph** — Canvas rendering, nodes, links, groups, etc. + - **Appearance** — Themes, sidebar position, backgrounds, etc. + - **3D** — 3D node initialization settings + - **Mask Editor** — Mask editor preferences + - Keybinding + - Extension + - About + - Server Config (Desktop only) + +3. **Other** — Settings registered by third-party custom nodes (only shown when present) + +### When team workspaces are disabled (legacy): + +1. **Account** + - User / Profile + - Subscription + - Secrets + - Credits + +2. **Application Settings** — All core settings categories: + - **Comfy** + - **Lite Graph** + - **Appearance** + - **3D** + - **Mask Editor** + - **Other** (uncategorized settings) + +3. **Special Settings** + - Keybinding + - Extension + - About + - Server Config (Desktop only) -## ComfyUI Settings Menu +## Settings by Category + +The following sections cover the native ComfyUI settings in detail: @@ -21,33 +74,46 @@ Since custom nodes can also register corresponding setting categories in the men Entry for purchasing credits and credit balance history, only visible after logging into ComfyUI account - Detailed description of ComfyUI core setting options + Core ComfyUI settings: interface, queue, nodes, search, localization, etc. - Detailed description of Canvas (Lite Graph) setting options in ComfyUI + Canvas rendering, nodes, links, connection behavior, and visual settings - Modify ComfyUI appearance options such as themes, background colors, sidebar position, etc. - - - Manage the enable/disable status of frontend extension plugins in ComfyUI + Theme selection, color palettes, sidebar position, node opacity, background images - Some setting options for 3D node initialization - - - Desktop update settings, mirror settings, etc. (only effective for ComfyUI Desktop) + Default lighting, camera position, background color, and PLY engine settings for 3D nodes - Adjust mask editor usage preferences + Mask editor usage preferences and behavior + + + Manage enable/disable status of frontend extension plugins - Modify ComfyUI keyboard shortcut settings + ComfyUI keyboard shortcut configuration - Learn about current ComfyUI version information, device runtime information, etc., which is very useful for daily feedback + Version information, system info, version update notifications - Modify ComfyUI configuration file, this setting is only effective for ComfyUI Desktop + Server-side configuration for Desktop users (VRAM, preview, cache, etc.) - \ No newline at end of file + + +## Desktop-Only Settings + +The following settings are only available in ComfyUI Desktop: + +- **Server Config** — Access and modify server configuration settings +- **Comfy Desktop general settings** — Update preferences, window style, mirror sources + +## Cloud-Only Panels + +Some panels only appear when logged into a ComfyUI account: + +- **Credits** — Purchase credits and view credit balance history +- **Secrets** — Manage API keys and secrets +- **Workspace** — Team workspace configuration +- **Subscription** — Manage subscription plan diff --git a/interface/settings/server-config.mdx b/interface/settings/server-config.mdx index 96ae5c627..540722f19 100644 --- a/interface/settings/server-config.mdx +++ b/interface/settings/server-config.mdx @@ -100,6 +100,7 @@ Currently the `Server Config` settings menu only exists in the Desktop version, ### VRAM management mode **Options**: - `auto`: Automatically manages VRAM, allocating VRAM based on model size and requirements +- `gpu-only`: GPU-only mode, keeps models on GPU without offloading to CPU - `lowvram`: Low VRAM mode, uses minimal VRAM, may affect generation quality - `normalvram`: Standard VRAM mode, balances VRAM usage and performance - `highvram`: High VRAM mode, uses more VRAM for better performance @@ -117,8 +118,10 @@ Currently the `Server Config` settings menu only exists in the Desktop version, ## Preview ### Method used for latent previews +- **Default**: `none` + **Options**: -- `none`: No preview images displayed, only shows progress bar during generation +- `none` (Default): No preview images displayed, only shows progress bar during generation - `auto`: Automatically selects the most suitable preview method, dynamically adjusts based on system performance and VRAM - `latent2rgb`: Directly converts latent space data to RGB images for preview, faster but average quality - `taesd`: Uses lightweight TAESD model for preview, balances speed and quality @@ -126,6 +129,9 @@ Currently the `Server Config` settings menu only exists in the Desktop version, **Function**: Controls how to preview intermediate results during generation. Different preview methods affect preview quality and performance consumption. Choosing the right preview method can find a balance between preview effects and system resource usage. ### Size of preview images +- **Default**: `512` +- **Range**: `128` - `2048` (step `128`) + **Function**: Sets the resolution of preview images, affects preview clarity and performance. Larger sizes provide higher preview quality but also consume more VRAM ## Cache @@ -189,6 +195,16 @@ Currently the `Server Config` settings menu only exists in the Desktop version, **Function**: Sets the hash algorithm for model file verification, used to verify file integrity. Different hash algorithms have different trade-offs between computation speed and security. Usually recommended to use sha256 as the default option, which achieves a good balance between security and performance. +### Enable legacy Manager UI +- **Default**: `false` +- **Type**: boolean + +**Function**: Uses the old ComfyUI-Manager UI instead of the new one. Enable this if you prefer the classic Manager interface or encounter compatibility issues with the new UI. + +**Note**: Requires a restart to take effect. + + + ### Make pytorch use slower deterministic algorithms when it can **Function**: Forces PyTorch to use deterministic algorithms when possible to improve result reproducibility. diff --git a/ja/interface/settings/about.mdx b/ja/interface/settings/about.mdx index e315407a2..81df078b4 100644 --- a/ja/interface/settings/about.mdx +++ b/ja/interface/settings/about.mdx @@ -4,7 +4,7 @@ description: "ComfyUI 設定システムの『About』ページについての icon: "info" sidebarTitle: "バージョン情報" translationSourceHash: 71a32b30 -translationFrom: interface/settings/about.mdx, zh/interface/settings/about.mdx +translationFrom: interface/settings/about.mdx --- import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.mdx" @@ -19,10 +19,20 @@ About ページは、ComfyUI 設定システム内の情報表示パネルであ About ページには、以下の核心的なバージョン情報が表示されます： -- **ComfyUI バージョン**：バックエンドの ComfyUI バージョン番号を表示し、公式 GitHub リポジトリにリンクしています -- **ComfyUI_frontend バージョン**：フロントエンドインターフェースのバージョン番号を表示し、フロントエンドの GitHub リポジトリにリンクしています -- **Discord コミュニティ**：ComfyOrg Discord サーバーへのリンクを提供します -- **公式サイト**：ComfyOrg 公式サイトへのリンクです +- **ComfyUI バージョン**：バックエンドの ComfyUI バージョン番号を表示。表示形式は配布方式によって異なります： + - **OSS（オープンソース版）**：`ComfyUI ` を表示、[GitHub メインリポジトリ](https://github.com/Comfy-Org/ComfyUI) にリンク + - **Desktop**：`ComfyUI v<バージョン>` を表示、同じ GitHub リポジトリにリンク + - **Cloud**：`ComfyUI ` を表示、クラウドアイコン付きで [comfy.org](https://www.comfy.org) にリンク +- **ComfyUI_frontend バージョン**：フロントエンドインターフェースのバージョン番号を表示、フロントエンドの GitHub リポジトリにリンク +- **Templates バージョン**：`systemStats.system.installed_templates_version` が利用可能な場合、Templates バッジが表示されます： + - ラベル：`Templates v<バージョン>` + - リンク：[https://pypi.org/project/comfyui-workflow-templates/](https://pypi.org/project/comfyui-workflow-templates/) + - アイコン：`pi pi-book` + - インストール済みバージョンが必要バージョンと異なる場合、バッジは **danger** 重大度レベル（赤色）で表示されます +- **Discord コミュニティ**：ComfyOrg Discord サーバーへのリンクを提供 +- **ComfyOrg**：ComfyOrg 公式サイトにリンク + +バッジの表示順序は次のとおりです：ComfyUI → Frontend → Templates（インストールされている場合）→ Discord → ComfyOrg。 ここでのバージョン情報は主に安定版に対応しているため、Nightly 版を使用している場合、対応するコミットハッシュはここには表示されません。Nightly 版を使用している場合は、ComfyUI のメインディレクトリで `git log` コマンドを使用し、対応するコミットハッシュなどの情報を確認できます。 @@ -35,10 +45,35 @@ About ページには、以下の核心的なバージョン情報が表示さ ### システム統計情報 -ページ下部には詳細なシステム統計情報が表示されます。これには以下が含まれます： -- ハードウェア構成情報 -- ソフトウェア環境情報 -- システムパフォーマンスデータ +ページ下部には詳細なシステム統計情報が表示されます。配布方式によって内容が異なります： + +**OSS / 一般バージョン：** +- **OS**：オペレーティングシステム識別子 +- **Python バージョン**：インストールされている Python バージョン +- **Embedded Python**：組み込み Python の詳細（該当する場合） +- **Pytorch バージョン**：PyTorch フレームワークのバージョン +- **起動引数 (argv)**：ComfyUI 起動時に使用されたコマンドライン引数 +- **RAM 合計**：システムの利用可能な総 RAM +- **RAM 空き**：現在の空き RAM +- **Templates バージョン**：インストール済みバージョンが古い場合、danger スタイルで表示 + +**Cloud バージョン：** +- **Cloud バージョン**：クラウドプラットフォームのバージョン +- **ComfyUI バージョン**：バックエンドの ComfyUI バージョン +- **フロントエンドバージョン**：フロントエンドインターフェースのバージョン +- **Templates バージョン**：ワークフローテンプレートのバージョン + +**デバイス情報**（互換性のあるハードウェアが検出された場合に表示）： +- デバイス名とタイプ（例：GPU モデル） +- **VRAM 合計 / VRAM 空き**：グラフィックスメモリ統計 +- **Torch VRAM 合計 / Torch VRAM 空き**：PyTorch 管理下の VRAM 統計 +- 複数デバイスは **TabView** で表示、デバイスごとに 1 タブ + +下部に **システム情報をコピー** ボタンがあり、すべてのシステム情報をフォーマットされたテキストブロックとしてクリップボードにコピーでき、問題報告時に便利です。 + +### バージョン更新通知 + +`ShowVersionUpdates` 設定（Comfy → 通知設定の下にあります）は、About ページおよびインターフェースの他の場所でバージョン更新通知を表示するかどうかを制御します。 ## 拡張機能開発者ガイド @@ -54,4 +89,5 @@ app.registerExtension({ icon: 'pi pi-github' } ] -}) \ No newline at end of file +}) +``` diff --git a/ja/interface/settings/comfy.mdx b/ja/interface/settings/comfy.mdx index d1498d3dc..da4101653 100644 --- a/ja/interface/settings/comfy.mdx +++ b/ja/interface/settings/comfy.mdx @@ -3,10 +3,6 @@ title: "Comfy 設定" description: "ComfyUI コア設定オプションの詳細説明" icon: "sliders" sidebarTitle: "Comfy" -translationSourceHash: 5ea4ef3d -translationFrom: interface/settings/comfy.mdx, zh/interface/settings/comfy.mdx -translationMismatches: - - "EN \"Queue Button\" vs ZH \"执行按钮\" (Execute Button). EN \"Validation\" vs ZH \"验证和开发者设置\" (Validation and Developer Settings). ZH image alt for experimental nodes incorrectly references deprecated nodes." --- import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.mdx" @@ -23,27 +19,56 @@ import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.md > API ノードの詳細については、[API ノード](/tutorials/partner-nodes/overview) を参照してください +## 外観 + +### アニメーションを無効化 +- **デフォルト値**: システムの `prefers-reduced-motion` 設定に従う +- **機能**: ほとんどの CSS アニメーションとトランジションをオフにします。表示用 GPU が生成にも使用されている場合、推論を高速化できます。 + +### タブバーレイアウト +- **オプション**: デフォルト、レガシー +- **デフォルト値**: デフォルト +- **機能**: 統合タブバーに含まれる要素を制御します。 + ## 開発者モード ### 開発者モードオプションを有効化 (API 保存など) - **デフォルト値**: 無効 - **機能**: 開発者モードオプション（API 保存など）を有効にします - ## トークン重みの編集 ### Ctrl+ 上/下 の精度 -- **デフォルト値**: 0.01 +- **デフォルト値**: 0.05 +- **範囲**: 0.01 - 0.50 - **機能**: CLIPTextEncode タイプのノードまたはテキスト入力ノードウィジェットを使用する際、Ctrl+ 上/下 で重みを素早く調整できます。このオプションは調整ごとの重み値を変更します +## エラーシステム + +### サイドパネルにエラータブを表示 +- **デフォルト値**: 有効 +- **実験的**: はい +- **機能**: 有効にすると、右側のサイドパネルにエラータブが表示され、ワークフロー実行エラーを一目で確認できます。 + +## 実行 + +### ライブプレビュー方法 +- **デフォルト値**: デフォルト +- **オプション**: デフォルト、なし、自動、latent2rgb、taesd +- **機能**: 画像生成時のライブプレビュー方法。「デフォルト」はサーバーの CLI 設定を使用します。 + - `なし`: プレビュー画像を表示せず、進行状況バーのみ表示 + - `自動`: 最適なプレビュー方法を自動選択 + - `latent2rgb`: 潜在空間データを直接 RGB 画像に変換してプレビュー + - `taesd`: 軽量 TAESD モデルを使用してプレビュー + ## 言語設定 ### 言語 -- **オプション**: 英語、中文 (中国語)、日本語、한국어 (韓国語)、Русский (ロシア語)、Español (スペイン語)、Français (フランス語) +- **オプション**: English、中文 (中国語)、繁體中文 (繁体字中国語)、日本語、한국어 (韓国語)、Русский (ロシア語)、Español (スペイン語)、Français (フランス語)、Português (BR)、Türkçe (トルコ語)、عربي (アラビア語)、فارسی (ペルシア語) - **デフォルト値**: ブラウザの言語を自動検出 - **機能**: ComfyUI インターフェースの表示言語を変更します @@ -51,17 +76,14 @@ import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.md ### 新しいメニューを使用 - **デフォルト値**: 上部 -- **機能**: メニューインターフェースと位置を選択します。現在、上部、下部、無効のみサポートされています +- **オプション**: 上部、無効 +- **機能**: メニューインターフェースと位置を選択します。 メニューインターフェースはワークスペースの上部に表示されます ![上部メニュー](/images/interface/setting/comfy/UseNewMenu_top.jpg) - - メニューバーインターフェースはワークスペースの下部に表示されます - ![下部メニュー](/images/interface/setting/comfy/UseNewMenu_bottom.jpg) - 早期のレガシーメニューを好む場合は、このオプションを試すことができます。 @@ -79,7 +101,8 @@ import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.md ### モデルライブラリツリービューに表示する名前 - **デフォルト値**: タイトル -- **機能**: モデルライブラリツリービューに表示する名前形式を選択します。現在、ファイル名とタイトルのみサポートされています +- **オプション**: ファイル名、タイトル +- **機能**: モデルライブラリツリービューに表示する名前形式を選択します。 ### すべてのモデルフォルダーを自動的に読み込む - **デフォルト値**: 無効 @@ -95,62 +118,87 @@ ComfyUI のイテレーションプロセス中、一部のノードを調整し ![検索で非推奨ノードを表示](/images/interface/setting/comfy/depr_node.jpg) - ### 検索で実験的ノードを表示 - **デフォルト値**: 有効 - **機能**: 検索で実験的ノードを表示するかどうかを制御します。実験的ノードは一部の新しい機能サポートですが、完全に安定しておらず、将来のバージョンで変更または削除される可能性があります。 ![検索で実験的ノードを表示](/images/interface/setting/comfy/beta_node.jpg) +### ノード置換提案を有効化 +- **デフォルト値**: 有効 +- **機能**: 有効にすると、既知の置換がある欠落ノードが欠落ノードダイアログで置換可能として表示され、置換を確認して適用できます。 -## ノード検索ボックス +### すべてのノードで高度なウィジェットを常に表示 +- **デフォルト値**: 無効 +- **機能**: 有効にすると、すべてのノードで高度なウィジェットが常に表示され、個別に展開する必要がありません。 -### ノード提案数 -- **デフォルト値**: 5 -- **機能**: 関連ノードのコンテキストメニューで推奨されるノードの数を変更するために使用されます。値が大きいほど、より多くの関連推奨ノードが表示されます。 +## ノードライブラリ -![ノード提案数](/images/interface/setting/comfy/node_suggestions.jpg) +### 新しいノードライブラリデザイン +- **デフォルト値**: 有効 +- **実験的**: はい +- **機能**: タブ（基本、すべて、カスタム）、改善された検索、ホバープレビューを備えた再設計されたノードライブラリサイドバーを有効にします。 -### 検索結果にノード頻度を表示 -- **デフォルト値**: 無効 -- **機能**: 検索結果にノードの使用頻度を表示するかどうかを制御します +## ノード検索ボックス + +### ノード検索ボックスの実装 +- **デフォルト値**: デフォルト +- **オプション**: デフォルト、v1（レガシー）、litegraph（レガシー） +- **機能**: ノード検索ボックスの実装方法を選択します。`デフォルト` が最新の実装です。`v1（レガシー）` と `litegraph（レガシー）` は以前のバージョンに切り替わります。 -![検索結果にノード頻度を表示](/images/interface/setting/comfy/node_frequency.png) +### 検索結果にノードカテゴリを表示 +- **デフォルト値**: 有効 +- **機能**: 検索結果にノードカテゴリを表示するかどうかを制御します。v1（レガシー）実装にのみ適用されます。 ### 検索結果にノード ID 名を表示 - **デフォルト値**: 無効 -- **機能**: 検索結果にノード ID 名を表示するかどうかを制御します - -![検索結果にノード ID 名を表示](/images/interface/setting/comfy/node_id_name.jpg) +- **機能**: 検索結果にノード ID 名を表示するかどうかを制御します。litegraph（レガシー）には適用されません。 +### 検索結果にノード頻度を表示 +- **デフォルト値**: 無効 +- **機能**: 検索結果にノードの使用頻度を表示するかどうかを制御します。v1（レガシー）にのみ適用されます。 -### 検索結果にノードカテゴリを表示 +### ノードプレビュー - **デフォルト値**: 有効 -- **機能**: 検索結果にノードカテゴリを表示するかどうかを制御し、ユーザーがノード分類情報を理解するのに役立ちます +- **機能**: 検索結果にノードプレビューを表示するかどうかを制御します。デフォルトの実装にのみ適用されます。 -### ノードプレビュー +### 追加されたノードがカーソルに追従 - **デフォルト値**: 有効 -- **機能**: 検索結果にノードプレビューを表示するかどうかを制御し、ノードを素早くプレビューするのに便利です +- **機能**: 有効にすると、検索ボックスから追加されたノードがクリックして配置するまでカーソルに追従します。デフォルトの実装にのみ適用されます。 -### ノード検索ボックスの実装 -- **デフォルト値**: デフォルト -- **機能**: ノード検索ボックスの実装方法を選択します（実験的機能）。`litegraph (旧版)` を選択すると、早期の ComfyUI 検索ボックスに切り替わります +## 通知設定 + +### バージョンアップデートを表示 +- **デフォルト値**: 有効 +- **機能**: 新しいモデルや重要な新機能のアップデートを表示します。 ## ノードウィジェット ### ウィジェット制御モード - **オプション**: 前、後 +- **デフォルト値**: 後 - **機能**: ノードウィジェット値の更新タイミングがワークフロー実行の前か後かを制御します（例：seed 値の更新） ### テキストエリアウィジェットのスペルチェック - **デフォルト値**: 無効 - **機能**: テキストエリアウィジェットがスペルチェックを有効にするかどうかを制御し、テキスト入力中にスペルチェック機能を提供します。この機能はブラウザの spellcheck 属性を通じて実装されています +### テキストエリアウィジェットのフォントサイズ +- **デフォルト値**: 10 +- **範囲**: 8 - 24 +- **機能**: テキストエリアウィジェットのフォントサイズを設定します。テキスト入力ボックスの表示サイズを調整して可読性を向上します。 + ## キュー ### キュー履歴サイズ -- **デフォルト値**: 100 -- **機能**: サイドバーのキュー履歴パネルに記録されるキュー履歴サイズを制御します。値が大きいほど、より多くのキュー履歴が記録されます。数が多い場合、ページ読み込み時により多くのメモリを消費します +- **デフォルト値**: 64 +- **範囲**: 2 - 256 +- **機能**: サイドバーのキュー履歴パネルに記録されるキュー履歴サイズを制御します。値が大きいほど、より多くのキュー履歴が記録されます。 + +### ドッキングされたジョブ履歴/キューパネル +- **デフォルト値**: 無効（ナイトリービルドでは有効） +- **実験的**: はい +- **機能**: フローティングジョブキューパネルを、ジョブ履歴サイドパネルに埋め込まれた同等のキューに置き換えます。無効にするとフローティングパネルレイアウトに戻ります。 ## キューボタン @@ -160,18 +208,9 @@ ComfyUI のイテレーションプロセス中、一部のノードを調整し ## 検証 -### ノード定義を検証する（低速） -- **デフォルト値**: 無効 -- **機能**: 起動時にすべてのノード定義を検証するかどうかを制御します（低速）。ノード開発者のみ推奨されます。有効にすると、システムは Zod スキーマを使用して各ノード定義を厳密に検証します。この機能はより多くのメモリと時間を消費します -- **エラー処理**: 検証に失敗したノード定義はスキップされ、警告情報がコンソールに出力されます - - - すべてのノード定義に対して詳細なスキーマ検証を実行する必要があるため、この機能は起動時間を大幅に増加させるため、デフォルト無効であり、ノード開発者のみ推奨されます - - ### ワークフローを検証する -- **デフォルト値**: 有効 -- **機能**: ワークフローの構造と接続の正確性を確保します。有効にすると、システムは `useWorkflowValidation().validateWorkflow()` を呼び出してワークフローデータを検証します +- **デフォルト値**: 無効 +- **機能**: 読み込み時にワークフローの構造と接続の正確性を確保します。 - **検証プロセス**: 検証プロセスには 2 つのステップが含まれます： - スキーマ検証：Zod スキーマを使用してワークフロー構造を検証します - リンク修復：ノード間の接続問題を確認し、修復します @@ -190,6 +229,7 @@ ComfyUI のイテレーションプロセス中、一部のノードを調整し - **機能**: ページ（再）読み込み時にワークフロー状態を復元するかどうかを制御し、ページ刷新後にワークフロー内容を維持します ### 自動保存 +- **オプション**: オフ、遅延後 - **デフォルト値**: オフ - **機能**: ワークフローの自動保存動作を制御し、ワークフローの変更を自動的に保存してデータ損失を防ぎます @@ -206,9 +246,9 @@ ComfyUI のイテレーションプロセス中、一部のノードを調整し - **機能**: ワークフロー内のキャンバス位置とズームレベルを保存および復元するかどうかを制御し、ワークフローを再度開くときに以前のビュー状態を復元します ### 開かれたワークフローの位置 -- **オプション**: サイドバー、トップバー、トップバー（2 段目） +- **オプション**: サイドバー、トップバー - **デフォルト値**: トップバー -- **機能**: 開かれたワークフロータブの表示位置を制御します。現在、サイドバー、トップバー、トップバー（2 段目）のみサポートされています +- **機能**: 開かれたワークフロータブの表示位置を制御します。 ### ワークフロー保存時にファイル名をプロンプト - **デフォルト値**: 有効 @@ -218,18 +258,18 @@ ComfyUI のイテレーションプロセス中、一部のノードを調整し - **デフォルト値**: 無効 - **機能**: ワークフロー保存時にノード ID をソートするかどうかを決定し、ワークフローファイル形式をより標準化し、バージョン管理に便利にします -### 欠落ノード警告を表示 -- **デフォルト値**: 有効 -- **機能**: ワークフロー内の欠落ノードの警告を表示するかどうかを制御し、ユーザーがワークフロー内の利用不可ノードを識別するのに役立ちます - ### 欠落モデル警告を表示 -- **デフォルト値**: 有効 +- **デフォルト値**: 有効（Comfy Cloud では無効） - **機能**: ワークフローファイル内のウィジェット値にモデルリンク情報を追加して、モデルファイル読み込み時のプロンプトに使用することをサポートしています。有効にすると、ローカルに対応するモデルファイルがない場合、ワークフロー内の欠落モデルの警告が表示されます +### 欠落ノード警告を表示（ノード置換提案に置き換えられました） +- **デフォルト値**: 有効 +- **機能**: ワークフロー内の欠落ノードの警告を表示するかどうかを制御し、ユーザーがワークフロー内の利用不可ノードを識別するのに役立ちます。この機能は[ノード置換提案を有効化](#ノード置換提案を有効化)設定に置き換えられました。後者は単なる警告よりも有用な置換提案を提供します。 + ### ワークフロークリア時に確認を要求 - **デフォルト値**: 有効 - **機能**: ワークフローをクリアする際に確認ダイアログを表示するかどうかを制御し、ワークフロー内容の誤クリアを防ぎます -### ノード ID をワークフローに保存 +### 既存のサブグラフブループリント上書き時に確認を要求 - **デフォルト値**: 有効 -- **機能**: ワークフロー保存時にノード ID を保存するかどうかを制御し、ワークフローファイル形式をより標準化し、バージョン管理に便利にします \ No newline at end of file +- **機能**: 新しいサブグラフで既存のサブグラフブループリントを上書きしようとする際に確認ダイアログを表示するかどうかを制御します diff --git a/ja/interface/settings/lite-graph.mdx b/ja/interface/settings/lite-graph.mdx index 597a6a142..ad4d9fd93 100644 --- a/ja/interface/settings/lite-graph.mdx +++ b/ja/interface/settings/lite-graph.mdx @@ -1,39 +1,36 @@ --- title: "ComfyUI LiteGraph (キャンバス) 設定" -description: "ComfyUI 图形渲染エンジン LiteGraph の設定オプションの詳細説明" +description: "ComfyUI グラフィックレンダリングエンジン LiteGraph の設定オプションの詳細説明" icon: "diagram-project" sidebarTitle: "Lite Graph 設定" -translationSourceHash: b6d75344 -translationFrom: interface/settings/lite-graph.mdx, zh/interface/settings/lite-graph.mdx -translationMismatches: - - "Node ID badge mode Default Value (EN: Show all vs ZH: None), Image Alt Texts (Canvas info, Link midpoint) differ between EN and ZH" --- import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.mdx" -LiteGraph は ComfyUI の基盤となる图形レンダリングエンジンです。このカテゴリの設定は、キャンバス、ノード、リンクなどのグラフィカルインターフェースの動作と外観を主に制御します。 +LiteGraph は ComfyUI の基盤となるグラフィックレンダリングエンジンです。このカテゴリの設定は、キャンバス、ノード、リンクなどのグラフィカルインターフェースの動作と外観を主に制御します。 ## キャンバス ### 選択ツールボックスを表示 - **デフォルト値**: 有効 -- **機能**: 選択ツールボックスは、ノードを選択した後にノード上に浮动表示されるクイックアクションツールバーで、部分的な実行、ピン留め、削除、色の変更などの一般的なクイック操作を提供します。 +- **機能**: 選択ツールボックスは、ノードを選択した後にノード上に浮動表示されるクイックアクションツールバーで、部分的な実行、ピン留め、削除、色の変更などの一般的なクイック操作を提供します。 ![選択ツールボックスを表示](/images/interface/setting/lite-graph/selection-toolbox.jpg) -### 低品質レンダリングズーム閾値 -- **デフォルト値**: 0.6 -- **範囲**: 0.1 - 1.0 -- **機能**: インターフェースをレンダリングする際、特にワークフローが非常に複雑でキャンバス全体が非常に大きい場合、対応する要素のフロントエンドレンダリングは多くのメモリを消費し、ラグを引き起こす可能性があります。この閾値を下げることにより、要素が特定のパーセンテージに縮小されたときに低品質レンダリングモードに入るように制御し、メモリ消費を削減できます。対応する異なるレンダリングモードは以下の通りです。 +### ズームノード詳細度 - フォントサイズ閾値 +- **デフォルト値**: 8 +- **範囲**: 0 - 24 +- **機能**: ノードが低品質 LOD（詳細度）レンダリングに切り替わるタイミングを制御します。フォントサイズ（ピクセル）を使用して切り替えタイミングを決定します。0 に設定すると無効になります。値が大きい（24px）ほど、ズームアウト時にノードがより早く簡略化レンダリングに切り替わります。値が小さい（1px）ほど、完全なノード品質をより長く維持します。 +- **置き換え**: 非推奨の「低品質レンダリングズーム閾値」設定 -![低品質レンダリング](/images/interface/setting/lite-graph/render-mode.jpg) +![ズームノード詳細度](/images/interface/setting/lite-graph/render-mode.jpg) ### 最大 FPS - **デフォルト値**: 0（画面リフレッシュレートを使用） - **範囲**: 0 - 120 -- **機能**: キャンバスのレンダリングフレームレートを制限します。0 は画面のリフレッシュレートを使用することを意味します。FPS が高いほどキャンバスのレンダリングは滑らかになりますが、より多くのパフォーマンスを消費します。値が低すぎると、より顕著なスタッター（卡顿）が発生します。 +- **機能**: キャンバスのレンダリングフレームレートを制限します。0 は画面のリフレッシュレートを使用することを意味します。FPS が高いほどキャンバスのレンダリングは滑らかになりますが、より多くのパフォーマンスを消費します。値が低すぎると、より顕著なスタッターが発生します。 ### 常にグリッドにスナップ - **デフォルト値**: 無効 @@ -44,12 +41,13 @@ LiteGraph は ComfyUI の基盤となる图形レンダリングエンジンで ### グリッドスナップサイズ +- **デフォルト値**: 10 - **範囲**: 1 - 500 -- **機能**: 自動スナップが有効な場合、または `Shift` キーを押しながらノードを移動する場合、このパラメータはスナップ用のグリッドサイズを決定します。デフォルト値は 10 で、必要に応じて調整できます。 +- **機能**: 自動スナップが有効な場合、または `Shift` キーを押しながらノードを移動する場合、このパラメータはスナップ用のグリッドサイズを決定します。 -### 快速ズームショートカットを有効化 (Ctrl + Shift + Drag) +### 高速ズームショートカットを有効化（Ctrl + Shift + ドラッグ） - **デフォルト値**: 有効 -- **機能**: `Ctrl + Shift + 左マウスボタンドラッグ` による快速ズーム機能を有効にし、より高速なズーム操作方法を提供します。 +- **機能**: `Ctrl + Shift + 左マウスボタンドラッグ` による高速ズーム機能を有効にし、より高速なズーム操作方法を提供します。 ### 吸附网格大小 +- **默认值**：10 - **范围**：1 - 500 -- **功能**：在启用自动吸附或者按住 `Shift` 键进行节点的移动时，这个参数会决定吸附的网格大小，默认值为 10，你可以根据你的需求进行调整。 +- **功能**：在启用自动吸附或者按住 `Shift` 键进行节点的移动时，这个参数会决定吸附的网格大小。 -### 启用快速缩放快捷键 +### 启用快速缩放快捷键（Ctrl + Shift + 拖拽） - **默认值**：启用 -- **功能**：启用 `Ctrl + Shift + 鼠标左键拖拽` 的快速缩放功能，提供更快速的缩放操作方式 +- **功能**：启用 `Ctrl + Shift + 鼠标左键拖拽` 的快速缩放功能，提供更快速的缩放操作方式 ### 链接释放动作（Shift键） -- **默认值**： 搜索框 -- **选项**： 上下文菜单、搜索框、无操作 +- **默认值**：搜索框 +- **选项**：上下文菜单、搜索框、无操作 - **功能**：设置按住Shift键释放链接时的动作，按住Shift释放链接时的特殊行为 ### 链接释放动作（无修饰键） -- **默认值**： 上下文菜单 -- **选项**： 上下文菜单、搜索框、无操作 +- **默认值**：上下文菜单 +- **选项**：上下文菜单、搜索框、无操作 - **功能**：设置释放链接时的默认动作，控制拖拽链接后释放时的行为 ## 节点 ### 始终收缩新节点 -- **默认值**：启用 +- **默认值**：禁用 - **功能**：控制是否在创建新节点时自动收缩，从而让节点能够始终显示最小的尺寸，但可能会导致添加时有些文本显示会被截断，需要手动调整节点大小 ### 启用DOM元素裁剪（启用可能会降低性能） - **默认值**：启用 -- **功能**：启用DOM元素裁剪（可能影响性能），优化渲染但可能降低性能 +- **功能**：启用DOM元素裁剪（可能影响性能），优化渲染但可能降低性能 ### 中键单击创建新的转接点 - **默认值**：启用 -- **功能**：中键点击时创建新的重路由节点，快速创建用于整理连线的重路由节点 +- **功能**：中键点击时创建新的重路由节点，快速创建用于整理连线的重路由节点 ### 删除节点时保留连线 - **默认值**：启用 @@ -153,13 +194,13 @@ LiteGraph 是 ComfyUI 的底层图形渲染引擎，这个分类下的设置主 ### 吸附高亮节点 - **默认值**：启用 -- **功能**：拖拽链接到节点时高亮显示节点，提供视觉反馈，显示可连接的节点,启用后效果如下图，对应链接的一侧会显示高亮的样式 +- **功能**：拖拽链接到节点时高亮显示节点，提供视觉反馈，显示可连接的节点，启用后效果如下图，对应链接的一侧会显示高亮的样式 ![吸附高亮节点](/images/interface/setting/lite-graph/highlights-node.jpg) ### 连线自动吸附到节点接口 - **默认值**：启用 -- **功能**：拖拽链接到节点上时自动吸附到可用插槽，简化连接操作，自动找到合适的输入插槽 +- **功能**：拖拽链接到节点上时自动吸附到可用插槽，简化连接操作，自动找到合适的输入插槽