设置面板

相关源文件

• extensions-builtin/extra-options-section/scripts/extra_options_section.py
• modules/config_states.py
• modules/extensions.py
• modules/scripts.py
• modules/shared_options.py
• modules/ui_common.py
• modules/ui_extensions.py
• modules/ui_settings.py

设置面板是Stable Diffusion Web UI中的一个全面配置界面，允许用户自定义应用程序行为的各个方面。本页将介绍设置面板的结构、组织和功能，以及设置的管理和扩展方式。

有关主界面组件的信息，请参阅 主界面组件。

概述

设置面板提供对数百个可配置选项的访问，这些选项被组织成逻辑类别。可以从Web UI的顶部导航栏访问它。一些常用的设置也作为“快速设置”显示在界面的顶部，以便于访问。

设置面板架构

来源

• modules/shared_options.py27-33
• modules/ui_settings.py58-71

设置组织

设置面板分为多个选项卡，每个选项卡包含相关的设置。这种分层组织使得在数百个可用设置中查找特定设置更加容易。

类别

设置分为以下主要类别

类别	描述
保存图像	配置生成图像的保存方式
Stable Diffusion	核心模型设置和生成参数
用户界面	自定义UI的外观和行为
系统	系统级设置，例如性能选项
后期处理	生成后图像增强的设置
训练	模型训练和微调的选项
回调函数	控制扩展回调的顺序

每个类别在设置面板中都有自己的选项卡。

来源

• modules/shared_options.py27-33

快速设置

快速设置是常用的选项，显示在界面的顶部以便于访问。用户可以自定义哪些设置出现在快速设置区域。

来源

• modules/ui_settings.py291-295
• modules/ui_settings.py128-129

关键设置类别

保存图像

控制图像的保存方式，包括

• 文件格式和质量
• 文件名模式
• 输出目录
• 元数据包含

示例设置包括

• samples_save：始终保存所有生成的图像
• samples_format：图像的文件格式（png、jpg等）
• grid_save：保存图像网格
• save_images_add_number：保存时向文件名添加编号

来源

• modules/shared_options.py34-77

Stable Diffusion 设置

影响模型行为和生成过程的核心设置

• 模型选择和管理
• 采样参数
• VAE配置
• 优化设置

主要设置包括

• sd_model_checkpoint：选择使用的模型
• CLIP_stop_at_last_layers：用于提示处理的Clip跳过设置
• enable_quantization：启用量化以获得更好的质量
• sd_vae：选择使用的VAE

来源

• modules/shared_options.py170-185
• modules/shared_options.py199-213

用户界面

自定义Web UI的外观和行为

• 主题选择
• 布局选项
• 组件可见性
• 定位

重要设置

• gradio_theme：选择界面的Gradio主题
• quicksettings_list：选择要在顶部显示的设置
• localization：设置界面语言
• compact_prompt_box：为提示使用更紧凑的布局

来源

• modules/shared_options.py331-344
• modules/shared_options.py319-329

系统设置

配置系统级行为

• 性能优化
• 内存使用
• 日志记录和调试
• API配置

重要设置

• memmon_poll_rate：VRAM使用情况轮询频率
• auto_launch_browser：启动时自动打开Web浏览器
• show_warnings：在控制台中显示警告
• api_enable_requests：允许API中的HTTP请求

来源

• modules/shared_options.py117-131
• modules/shared_options.py149-153

管理设置

保存设置

当通过UI更改设置时，它们会被保存在Web UI目录中的配置文件（config.json）中。通过单击设置面板顶部的“应用设置”按钮来应用更改。

某些设置需要重新加载UI才能生效，可以通过单击“重新加载UI”按钮来完成。

来源

• modules/ui_settings.py84-89
• modules/ui_settings.py251-256

配置状态

配置状态允许保存和恢复配置，这对于创建备份或管理不同用途的不同配置非常有用。

一个配置状态捕获

• Web UI版本和提交哈希
• 启用的/禁用的扩展
• 扩展版本
• 当前设置

系统允许恢复

• 仅扩展状态
• 仅Web UI状态
• 扩展和Web UI状态都恢复

来源

• modules/config_states.py46-78
• modules/config_states.py115-144
• modules/ui_extensions.py59-98

扩展设置

扩展设置

扩展可以添加自己的设置到设置面板。这些设置无缝集成到相应的类别选项卡中。

来源

• modules/scripts.py103-106

主UI中的附加选项

“附加选项部分”功能允许将选定的设置直接显示在txt2img和img2img选项卡中，从而更容易访问常用设置，而无需打开设置面板。

这可以通过以下方式管理

• extra_options_txt2img：要在txt2img选项卡中显示的设置
• extra_options_img2img：要在img2img选项卡中显示的设置
• extra_options_cols：显示附加选项的列数
• extra_options_accordion：是否将附加选项放在手风琴中

来源

• extensions-builtin/extra-options-section/scripts/extra_options_section.py8-70
• extensions-builtin/extra-options-section/scripts/extra_options_section.py72-80

设置实现

选项定义

设置使用OptionInfo类来定义，该类包含

• 默认值
• 标签
• 组件类型（例如，复选框、滑块、下拉列表）
• 组件参数
• 帮助文本
• 用于刷新依赖项的回调

选项使用options_section函数组织成节。

来源

• modules/shared_options.py34-77
• modules/shared_options.py170-185

UI生成

设置面板UI是根据选项定义动态生成的。该过程

1. 迭代所有已注册的选项
2. 按类别分组
3. 根据选项类型创建适当的Gradio组件
4. 设置事件处理程序以更改值
5. 处理特殊情况，例如快速设置

技术组件

设置面板组件结构

来源

• modules/ui_settings.py58-71
• modules/ui_settings.py105-203

常用任务

将设置添加到快速设置

1. 转到设置面板
2. 在“用户界面”下，找到“快速设置列表”
3. 将所需的设置名称添加到列表中
4. 应用并重新加载UI

从备份恢复设置

1. 转到“扩展”选项卡
2. 选择“配置状态”选项卡
3. 选择一个保存的配置状态
4. 选择恢复扩展、WebUI还是两者都恢复
5. 确认恢复

导出和导入设置

可以通过设置面板中的“默认设置”选项卡导出和导入设置

• 导出：将当前设置保存到文件
• 导入：从先前导出的文件加载设置

来源

• modules/ui_settings.py169-170

故障排除

如果设置未正确应用

1. 检查设置是否需要UI重新加载
2. 验证config.json文件是否可写
3. 查看控制台中的错误消息
4. 尝试完全重启应用程序

对于影响模型行为但似乎不起作用的设置，可能需要卸载并重新加载模型（可在“操作”选项卡中找到）。

来源

• modules/ui_settings.py183-196