Wildcards Matrix(wildcardsPromptMatrix)

描述

Wildcards Matrix（类 wildcardsPromptMatrix）是 EasyUse/Prompt 类别中的一个提示词构建节点。它可将包含通配符占位符的提示词模板展开为一个或多个具体的提示词字符串。两个 COMBO 输入作为便捷选择器，用于插入 LoRA 引用和通配符令牌，而 offset 和 output_limit 则控制生成哪些组合。

输入

text

• 类型： STRING
• 必填： 是
• 默认值： ""

主提示词模板。通配符占位符和普通提示词文本都放在此处。该文本将被展开为最终的提示词输出。

Select to add LoRA

• 类型： COMBO
• 必填： 是

可用 LoRA 的下拉列表。选择某个条目会将一个 LoRA 引用插入到正在构建的提示词中。

Select to add Wildcard

• 类型： COMBO
• 必填： 是

可用通配符的下拉列表。选择某个条目会将一个通配符令牌插入到正在构建的提示词中。

offset

• 类型： INT
• 必填： 是
• 默认值： 0
• 最小值： 0
• 步长： 1

展开后的通配符矩阵中的起始索引。使用此参数可跳过较早的组合，或从上一个批处理继续。

output_limit

• 类型： INT
• 必填： 否
• 默认值： 1
• 最小值： -1
• 步长： 1
• UI 工具提示：“输出所有可能性”

要生成的已展开提示词结果的最大数量。使用默认值 1 时，节点仅返回当前 offset 处的提示词。增大此值可生成更多结果，或将其设为 -1 以输出全部可能性。UI 中的工具提示将此描述为“输出所有可能性”。

输出

该节点有三个按位置区分的输出：

• STRING：从当前矩阵位置生成的已展开提示词文本。
• INT：生成结果在当前矩阵内的索引/偏移量。
• INT：给定提示词模板可展开的总数量。

使用说明

• 将 offset 保持为 0、将 output_limit 设为 1，可从矩阵开头生成单个提示词。
• 将 output_limit 设为 -1 可生成全部通配符组合。
• 要分块处理矩阵，可增大 offset，并使用第一个 INT 输出作为下一次执行的进度标记。
• COMBO 输入是编辑辅助工具；如果 text 中已经包含所需的通配符或 LoRA 语法，则它们并非展开所必需。