Wildcard Gallery - Extension
详情
下载文件
模型描述
通配符图库 V2 [Github]
这是什么
此 Automatic1111 扩展主要为通配符新增了一个额外网络图库，附带预览缩略图及其他功能，以提升通配符管理与用户体验。
安装
将本仓库
git clone到你的 Web UI 安装目录下的extensions文件夹，或将其链接粘贴到 WebUI 的extensions/Install from URL选项卡中如果你之前安装过旧版通配符图库 V1，建议在安装新版前将其卸载（这是对 V1 的全面重构，推荐全新安装）
- 如果你已存在
metadata和cards文件夹，请先备份，安装完成后将它们复制回新扩展的文件夹中
- 如果你已存在
依赖
此扩展基于通配符功能构建，因此你必须已在 WebUI 环境中安装了 sd-dynamic-prompts 扩展；若未安装，请先安装它。
此扩展基于 Gradio 3.x 开发，更高版本可能存在兼容性问题。
设置
若要限制索引仅针对特定通配符分支，可将父级激活路径通配符添加至白名单（默认行为）
重要！ 除非你在 WebUI 设置中将通配符的文件名添加到白名单并重启，否则图库中将不会显示任何通配符
若要排除某些通配符的索引，可将其激活路径添加到黑名单
你可以开启“缩小预览图”选项，以压缩生成的预览图，显著减少磁盘占用
通配符筛选标签页
概述
通配符筛选标签页是通配符图库 V2 最显著的新增功能。突破了旧版“额外网络”子标签页的限制，该标签页引入了诸多强大功能，包括：
更高级的卡片筛选选项
更简洁、资源效率更高的查看器
实时预览通道切换
卡片标签支持
实时卡片选择以执行操作（如导出、生成预览、编辑标签）
直接在 WebUI 中创建通配符
标签页布局
布局刻意简化，包含以下部分：
筛选选项
用于创建和执行筛选查询。
卡片查看器
以卡片形式分页显示筛选结果（默认每页 25 张）。
支持卡片选择以供后续操作
支持创建新卡片
包含查看器选项子区域，用于控制标签可见性、预览轮播和卡片分组
操作区域
包含针对所选卡片或整个通配符字典的批量操作命令。
术语说明
预览通道：一个命名配置文件，包含通配符字典中不同的一组预览图像，用于可视化通配符在各种提示场景下的表现。
标签组：逻辑上归类的标签集合，共享显示属性（例如颜色、遮罩行为）。
通配符序列：位于共同父级下的一组有序通配符，按链式方式执行，专为特定场景设计（如基于提示的叙事）。
筛选模式
模式：通配符
最简单的模式，显示字典中所有通配符的可搜索下拉列表。
可选择一张或多张卡片。
可选地将筛选范围扩展为包含所选卡片的所有同级父节点卡片。
模式：选择器文本
使用选择器格式输入（例如
__parentA/parentB/exampleCard__）来筛选结果。可直接定位通配符，或使用通配符通配：
__parentA/parentB/*__将显示parentB下的所有卡片。
支持多个以逗号分隔的选择器（例如
__x/y/*__, __z/card__）。
模式：标签
根据用户自定义标签筛选卡片。
支持包含逻辑：
AND：卡片必须包含所有指定标签。OR：卡片只需包含任一指定标签。
在“排除”下拉菜单中设置的标签将用于过滤掉含有这些标签的卡片。
模式：提示搜索
最具体、最专业的模式。
根据卡片内部的提示文本进行筛选。支持包含和排除的逗号分隔关键词（无序）。
卡片查看器
此处以卡片形式交互浏览筛选结果。
使用分页机制，即使数据量庞大也能保证性能。
默认选择模式为堆叠，可通过查看器右上角更改为单选。
查看器选项
可通过查看器上方的折叠区域访问额外功能：
卡片堆叠层级
根据父级层级对卡片进行分组。例如，设置堆叠层级为 3，则
parentA/parentB/parentC/Card1和.../Card2将归类到共享的parentC/*堆叠中。选择一个堆叠将同时选中其中所有卡片。
更改堆叠层级不会重置当前选中的卡片。
标签遮罩
根据标签组设置，隐藏或简化卡片上的标签显示。选定预览通道
可根据所选通道，在每张卡片上循环切换不同的预览图像。
卡片详情面板
选中卡片后，左侧面板将显示详细信息和操作选项。
操作（适用于单张或多张卡片）： 
复制到剪贴板：复制通配符激活文本，用于手动输入提示。
编辑卡片标签：
通过下拉菜单或输入新标签添加/删除标签。
“添加标签”为卡片绑定标签；“移除标签”解除绑定。
收藏：将卡片添加至收藏列表。
删除：目前禁用，待完整卡片编辑功能实现后启用。
信息： 
标签：卡片的完整标签列表（忽略遮罩设置）。
卡片路径：卡片在字典中的虚拟路径。
提示：嵌入在通配符中的原始提示文本。
文件：通配符文件的物理位置。
受保护：指示卡片是否受保护（该功能尚未实现）。
通道：列出包含此卡片的所有预览通道。
操作区域
导入通配符包：将通配符包 ZIP 文件导入字典（包含所有元数据与预览图）
导出为通配符包：将所选卡片（或所有筛选结果）导出为有效的通配符包
标签组：创建新标签组或编辑现有标签组，添加成员标签并设置标签颜色
其他操作
重建通配符字典：重新扫描文件系统，构建最新的通配符字典（相当于刷新）
收集冗余缩略图文件：整理
USER_OUTPUT/STRAY_RESOURCES文件夹中所有无对应条目的图像文件收集缩略图：从当前活动通道中收集所选卡片的缩略图副本至
USER_OUTPUT文件夹清空缩略图：将所选卡片在当前通道中的缩略图设为空，以跳过批量预览生成
删除缩略图：清除所选卡片在当前通道中的缩略图
通配符预览工具
这是一个与通配符筛选标签页配合使用的 txt2img 脚本，用于自动化生成和部署字典中多个通配符的预览图。根据所选脚本模式，还提供其他功能。
[.jpg)](https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/tr (2).jpg)
[.jpg)](https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/tr (1).jpg)
禁用：跳过脚本逻辑，正常生成图像。
批量提示：使用通配符筛选标签页中选定（或筛选）的通配符，为每个通配符单独生成图像。
- 将提示使用模式设为“合并卡片”时，将使用所有选定通配符生成一张组合图像。
序列生成：按正确顺序生成序列型通配符的所有图像。
- 仅需选择序列中的任意一个通配符，系统将自动生成整个序列。
预览生成：为选定（或筛选）的通配符生成并分配预览图像。
请确保切换至你希望保存生成图像的目标通道。
启用覆盖现有预览将强制为所有选定通配符重新生成并替换已有预览（即使其已在所选通道中存在）。
简化使用步骤：
- 在通配符筛选标签页中选择所需卡片。
- 添加用于生成图像的基础正向和负向提示。
激活通配符预览工具脚本，选择预览生成，并设定期望的输出通道。
- 可点击“统计所选卡片数”查看队列中包含的卡片数量。
点击生成，等待生成队列完成。
返回通配符筛选标签页，切换至对应通道确认预览已分配。
- （有时需取消选择再重新选择卡片以刷新信息。）
