ComfyUI 自定义节点：提示词列表 JSON

此仓库为 ComfyUI 提供了一个自定义节点，允许以结构化 JSON 格式管理正向和负向提示词。该节点支持创建新的提示词列表、随机选择提示词，并将提示词详情记录到控制台，便于无缝集成到您的工作流中。

功能

- 📂 基于 JSON 的提示词管理：提示词存储在独立的 JSON 文件中，便于编辑与检索。

- 🔄 添加或更新提示词：支持创建新列表、更新现有提示词，以及按需覆盖。

- 🎲 随机提示词选择：可轻松从现有列表中随机选取一条提示词。

- 🖥️ 控制台日志记录：可选地将提示词详情以格式化方式输出至控制台，便于调试或验证。

- 🛠️ 自动文件管理：自动创建所需目录和文件。

安装

1. 将本仓库克隆或下载至您的 ComfyUI 自定义节点目录：

   git clone https://github.com/TKRLAB/ComfyUI_Prompt_List_JSON.git

2. 重启 ComfyUI 以加载自定义节点。

替代方法

1. 使用 ComfyUI 管理器安装。

使用方法

节点输入

- 提示词列表：选择现有提示词列表或创建新列表。

- 新列表名称：指定新列表的名称（仅在创建新列表时使用）。

- 提示词名称（必填）：提示词的唯一名称。

- 正向提示词（新建提示词时必填）：提示词的正面描述。

- 负向提示词（可选）：提示词的负面描述。

- 随机（布尔值，默认 False）：启用从列表中随机选取提示词。

- 覆盖（布尔值，默认 False）：是否覆盖同名的已有提示词。

- 控制台日志（布尔值，默认 False）：将提示词详情输出至控制台，便于调试。

节点输出

- 正向提示词：保存或检索到的正向提示词。

- 负向提示词：保存或检索到的负向提示词。

- 完整列表：整个提示词列表的 JSON 字符串。

示例工作流

1. 使用以下输入添加或更新提示词：

- 提示词列表：test.json

- 新列表名称：test

- 提示词名称：girl on helmet

- 正向提示词：concept art Girl in black thin, oily latex, black motorcycle helmet, black glass on helmet, pours a bucket of yellow paint on himself, paint dripping down his body, yellow silk long scarf, sexy, dynamics. Black mirrors in the background, reflections. digital artwork, illustrative, painterly, matte painting, highly detailed

- 负向提示词：photo, photorealistic, realism, ugly

- 覆盖：True

- 控制台日志：True

- 随机：True

2. 提示词将保存至指定的 JSON 文件中，若启用了日志记录，其详情将显示在控制台中。

文件结构

提示词以如下格式存储在独立的 JSON 文件中：

{
    "SunsetScene": {
        "positive": "A breathtaking sunset over the mountains",
        "negative": "Low quality, blurry"
    }
}

编程方式添加提示词

您也可以以编程方式使用此节点。示例如下：

from your_module import ComfyUI_Prompt_JSON
manager = ComfyUI_Prompt_JSON()
positive, negative, full_list = manager.process(
    **{
        "Prompt List": "New List",
        "New List Name": "NaturePrompts",
        "Prompt Name": "SunsetScene",
        "Positive Prompt": "A breathtaking sunset over the mountains",
        "Negative Prompt": "Low quality, blurry",
        "Random": False,
        "Overwrite": True,
        "Console Log": True
    }
)

错误处理

- 如果缺少必需字段（例如 Prompt Name 或 Positive Prompt），将抛出 ValueError。

- 控制台中会显示详细的错误信息以辅助调试。

许可证

本项目采用 GNU 通用公共许可证 v3.0。详情请参阅 LICENSE

尽情享受在 ComfyUI 中使用 提示词列表 JSON 节点吧！🎨