[!TIP] SD 提示词阅读器现在已作为 ComfyUI 节点提供。请查看 ComfyUI 提示词阅读器节点 以获取更多信息。

功能

• 支持 macOS、Windows 和 Linux。
• 提供图形界面和命令行界面。
• 简单的拖放交互。
• 可将提示词复制到剪贴板。
• 可从图像中移除提示词。
• 可将提示词导出为文本文件。
• 可编辑或导入提示词到图像中。
• 垂直方向显示及按字母顺序排序。
• 可检测生成工具。
• 支持多种格式。
• 支持深色和浅色模式。

支持的格式

	PNG	JPEG	WEBP	TXT*
A1111 的 webUI	✅	✅	✅	✅
Easy Diffusion	✅	✅	✅
StableSwarmUI*	✅	✅
StableSwarmUI（0.5.8-alpha 之前版本）*	✅	✅
Fooocus-MRE*	✅	✅
NovelAI（stealth pnginfo）	✅		✅
NovelAI（旧版）	✅
InvokeAI	✅
InvokeAI（2.3.5-post.2 之前版本）	✅
InvokeAI（1.15 之前版本）	✅
ComfyUI*	✅
Draw Things	✅
Naifu(4chan)	✅

* 存在限制。详情请参阅 格式限制。

[!NOTE] 如果您使用的工具或格式未在此列表中，请通过在 Issues 中上传由您的工具生成的原始文件来帮助我支持该格式，谢谢。

[!TIP] 对于 ComfyUI 用户，SD 提示词阅读器现在已作为 ComfyUI 节点提供。
ComfyUI 提示词阅读器节点 是本项目的子项目，建议在您的工作流中将 Prompt Saver 节点 嵌入到 ComfyUI 提示词阅读器节点 中，以确保最大程度的兼容性。

下载

对于 Windows 用户

从 GitHub Releases 下载可执行文件。

对于 macOS 用户

从 GitHub Releases 下载可执行文件。

通过 Homebrew Cask 安装

您也可以通过 Homebrew cask 安装 SD 提示词阅读器。

brew install --no-quarantine receyuki/sd-prompt-reader/sd-prompt-reader

参数 --no-quarantine 是因为 SD 提示词阅读器目前尚未签名，正如我在 这里 所提到的。

对于 Linux 用户（未定期测试）

我相当确定 Linux 用户无需可执行文件也能自行解决。

• Python 的最低要求版本是 3.10。
• 确保您的 Python 已安装 tkinter 包。
  如果未安装，请使用包管理器安装 python3-tk 包。
  例如，对于基于 Debian 的发行版：sudo apt-get install python3-tk

您可以选择使用 pip 安装或手动运行。

使用 pip 或 pipx 安装

pip install sd-prompt-reader

或者

pipx install sd-prompt-reader

要启动图形界面，只需在终端输入 sd-prompt-reader。
对于命令行界面，请使用 sd-prompt-reader-cli。

手动运行源代码

1. 克隆此仓库。

   git clone https://github.com/receyuki/stable-diffusion-prompt-reader.git
   

   或者下载仓库的 zip 文件。
2. 进入目录并安装依赖项。

   cd stable-diffusion-prompt-reader  
   pip install -r requirements.txt
   

3. 运行。

   python -m sd_prompt_reader.app
   

使用方法

读取提示词

• 打开可执行文件（.exe 或 .app），然后将图片拖放到窗口中。

或者

• 右键点击图片，选择“使用 SD 提示词阅读器打开”。

或者

• 直接将图片拖放到可执行文件（.exe 或 .app）上。

将提示词导出为文本文件

• 点击“导出”按钮，会在图片文件旁边生成一个 txt 文件。
• 若要保存到其他位置，点击展开箭头并选择“选择目录”。
  

从图片中移除提示词

• 点击“清除”按钮，会在原图片文件旁边生成一个带有 _data_removed 后缀的新图片文件。
• 若要保存到其他位置，点击展开箭头并选择“选择目录”。
• 若要覆盖原图片文件，点击展开箭头并选择“覆盖原图”。
  

编辑图片

[!注意] 编辑后的图片将以 A1111 格式保存，这意味着无论原始图片是什么格式，编辑后都会转换为 A1111 格式。

• 点击“编辑”进入编辑模式。
• 直接在文本框中编辑提示词，或导入 txt 格式的元数据文件。
• 点击“保存”按钮，会在原图片文件旁边生成一个带有 _edited 后缀的编辑后图片文件。
• 若要保存到其他位置，点击展开箭头并选择“选择目录”。
• 若要覆盖原图片文件，点击展开箭头并选择“覆盖原图”。
  

复制为单行提示词

复制图片的提示词和设置，格式可被 来自文件或文本框的提示词 识别。支持以下参数：

设置	参数
种子	--seed
变异种子强度	--subseed_strength
种子缩放起始高度	--seed_resize_from_h
种子缩放起始宽度	--seed_resize_from_w
采样器	--sampler_name
步数	--steps
CFG 比例	--cfg_scale
尺寸	--width
尺寸	--height
人脸修复	--restore_faces

• 点击展开箭头并选择“单行提示词”。
• 将其粘贴到 webui 脚本“来自文件或文本框的提示词”下方的文本框中。
  

ComfyUI SDXL 工作流

[!注意] SDXL 工作流不支持编辑。如有需要，请先从图片中移除提示词再进行编辑。

如果图片的工作流包含多组 SDXL 提示词，即 Clip G(text_g)、Clip L(text_l) 和 Refiner，SD 提示词阅读器会切换到多组提示词显示模式，如图所示。多组提示词显示模式有两种界面选项，可通过按钮切换。

命令行工具

提供了一个用于读取、修改和清除元数据的命令行工具。

平台

对于 Windows 用户

SD Prompt Reader CLI.exe 将作为单独的可执行文件包含在压缩包中。
示例： "SD Prompt Reader CLI.exe" -i example.png

对于 macOS 用户

可执行文件位于 SD Prompt Reader.app/Contents/MacOS/SD Prompt Reader。
示例： /Applications/SD\ Prompt\ Reader.app/Contents/MacOS/SD\ Prompt\ Reader -i example.png

对于 pip 用户

示例： sd-prompt-reader-cli -i example.png

模式与选项

模式

• 读取模式：通过 -r 或 --read 标志激活。
• 写入模式：通过 -w 或 --write 标志激活。
• 清除模式：通过 -c 或 --clear 标志激活。

通用选项

• -i, --input-path：输入图片文件或包含图片文件的目录路径，必填参数。
• -o, --output-path：输出文件或目录路径，用于保存处理后的文件。
• -l, --log-level：指定日志详细程度（例如 DEBUG、INFO、WARN、ERROR）。

读取选项

• -f, --format-type：指定输出元数据的格式，可选“TXT”或“JSON”。默认格式为“TXT”。

写入选项

• -m, --metadata：提供元数据文件以供写入。
• -p, --positive：提供正面提示词字符串以供写入。
• -n, --negative：提供负面提示词字符串以供写入。
• -s, --setting：提供设置字符串以供写入。

基本使用

• 如果未指定输出路径，修改后的图片将保存在当前目录，并在原文件名后添加后缀。
• 若要覆盖源文件，需将输出路径设置为与输入路径相同。
• 写入模式仅支持对单张图片的修改。

读取模式

• 从图片中读取元数据。
• 使用方法： sd-prompt-reader-cli [-r] -i <input_path> [--format-type <format>] [-o <output_path>]
• 示例： sd-prompt-reader-cli -i example.png
sd-prompt-reader-cli -i example.png -o metadata.txt
sd-prompt-reader-cli -r -i example.png -f TXT -o output_folder/
sd-prompt-reader-cli -r -i input_folder/ -f JSON -o output_folder/

写入模式

• 向图片中写入元数据。
• 使用方法： sd-prompt-reader-cli -w -i <input_path> -m <metadata_path> [-o <output_path>]
• 示例： sd-prompt-reader-cli -w -i example.png -m new_metadata.txt
sd-prompt-reader-cli -w -i example.png -m new_metadata.txt -o output.png
sd-prompt-reader-cli -w -i example.png -m new_metadata.json -o output_folder/

清除模式

• 从图片中移除所有元数据。
• 使用方法： sd-prompt-reader-cli -c -i <input_path> [-o <output_path>]
• 示例： sd-prompt-reader-cli -c -i example.png
sd-prompt-reader-cli -c -i example.png -o output.png
sd-prompt-reader-cli -c -i example.png -o output_folder/
sd-prompt-reader-cli -c -i input_folder/ -o output_folder/

格式限制

TXT

1. 仅在编辑模式下允许导入 txt 文件。
2. 仅支持 A1111 格式的 txt 文件。您可以使用 A1111 webui 生成的 txt 文件，或使用 SD 提示词阅读器从 A1111 图片中导出 txt。

StableSwarmUI

[!重要] StableSwarmUI 仍处于 Alpha 测试阶段，其格式未来可能会发生变化。我将持续关注 StableSwarmUI 的后续更新。

ComfyUI

[!重要] 当使用自定义节点或工作流变得过于复杂时，元数据很可能无法被正确读取。 这是因为ComfyUI并不存储元数据，而只保存完整的工作流。SD Prompt Reader仅能处理基础的工作流。 建议在您的工作流中将Prompt Saver节点嵌入到ComfyUI Prompt Reader节点中，以确保最大的兼容性。

1. 如果设置框中有多个数据集（seed、steps、CFG等），则表示流程图中存在多个KSampler节点。
2. 由于ComfyUI的特性，工作流中的所有节点和流程图都会被存储在图像中，包括未使用的部分。此外，一个流程图可以有多个分支、输入和输出。 （例如：在一个流程图中同时输出高分辨率修复后的图像和原始图像） SD Prompt Reader会遍历所有流程图和分支，并显示具有完整输入和输出的最长分支。
3. ComfyUI SDXL工作流

Easy Diffusion

默认情况下，Easy Diffusion不会将元数据写入图像。请将设置中的_元数据格式_更改为_embed_，以将元数据写入图像。

Fooocus-MRE

由于原始版本的Fooocus不支持将元数据写入图像文件， SD Prompt Reader仅支持由Fooocus MoonRide Edition生成的图像。

常见问题解答

恶意软件警告

[!警告] 部分杀毒软件报告的误报是由打包工具_pyinstaller_引起的，这是_pyinstaller_用户常见的问题。 我之前曾花费大量时间尝试解决Windows Defender的误报问题，但无法对所有杀毒软件都有效。 因此，您可以选择信任Windows Defender，或者按照针对Linux用户的说明来使用此应用。

“SD Prompt Reader.app”已损坏，无法打开。您应该将其移到废纸篓

[!重要] 这是macOS上运行未经签名的非App Store应用时非常常见的问题， 开发者需要每年向苹果支付99美元才能消除此问题。 您可以选择在安全性与隐私设置中启用允许任何来源的应用程序，但这可能存在风险。 我更倾向于移除隔离属性。

1. 从“应用程序”文件夹中打开终端。

2. 输入以下命令并按回车键。

   xattr -r -d com.apple.quarantine /path/to/app.app

   在我的例子中是：

   xattr -r -d com.apple.quarantine /Applications/SD\ Prompt\ Reader.app

如果仍然担心应用程序的安全性，可以参考针对Linux用户的说明来使用此应用。

待办事项

• 批量图像处理工具
• 图库/文件夹视图
• 用户偏好设置

致谢

• 灵感来源于Stable Diffusion Web UI
• 应用图标由Stable Diffusion结合IconsMI生成。
• 特别感谢Azusachan提供的SD服务器。
• NovelAI的隐蔽pnginfo解析器基于NovelAI官方元数据提取脚本。

Stable Diffusion Prompt Reader 快速上手指南

Stable Diffusion Prompt Reader 是一款独立的轻量级工具，用于查看、编辑、导出或清除由 Stable Diffusion 生成的图片中的提示词（Prompt）和元数据。它支持 Windows、macOS 和 Linux，提供图形界面（GUI）和命令行（CLI）两种模式。

环境准备

系统要求

• 操作系统：Windows, macOS, Linux
• Python 版本：若通过源码或 pip 运行，需 Python 3.10 或更高版本。

前置依赖

• Linux 用户：必须安装 tkinter 包以支持图形界面。

  # Debian/Ubuntu 系列
  sudo apt-get install python3-tk
  
  # CentOS/RHEL 系列
  sudo yum install python3-tkinter
  

• macOS 用户：推荐安装 Homebrew 以便使用 Cask 安装。

安装步骤

您可以根据操作系统选择以下任意一种安装方式：

方式一：下载可执行文件（推荐 Windows/macOS 用户）

直接访问 GitHub Releases 下载对应系统的安装包：

• Windows: 下载 .exe 文件。
• macOS: 下载 .app 文件或通过 Homebrew 安装：

  brew install --no-quarantine receyuki/sd-prompt-reader/sd-prompt-reader
  

  注意：--no-quarantine 参数用于绕过 macOS 对未签名应用的拦截。

方式二：通过 pip 安装（跨平台）

确保已安装 Python 3.10+，然后运行：

pip install sd-prompt-reader

国内用户如遇下载缓慢，可使用清华源加速：

pip install sd-prompt-reader -i https://pypi.tuna.tsinghua.edu.cn/simple

方式三：源码运行（高级用户）

git clone https://github.com/receyuki/stable-diffusion-prompt-reader.git
cd stable-diffusion-prompt-reader
pip install -r requirements.txt

基本使用

1. 图形界面模式 (GUI)

启动方法：

• 可执行文件：双击运行下载的 .exe 或 .app 文件，或在终端输入 sd-prompt-reader。
• 源码运行：

  python -m sd_prompt_reader.app
  

核心操作：

• 读取提示词：将 SD 生成的图片直接拖拽到软件窗口中，即可自动解析并显示正向提示词、负向提示词及生成参数。
• 复制提示词：点击界面上的复制按钮，可将提示词一键复制到剪贴板。
• 导出文本：点击 "Export" 按钮，将在图片同级目录生成包含元数据的 .txt 文件。
• 清除元数据：点击 "Clear" 按钮，生成一个移除所有提示词信息的新图片（后缀为 _data_removed）。
• 编辑图片：点击 "Edit" 进入编辑模式，修改提示词后点击 "Save"，生成带有新元数据的图片（后缀为 _edited，格式统一为 A1111 标准）。

2. 命令行模式 (CLI)

适用于批量处理或脚本集成。

启动命令：

• 可执行文件用户：运行 SD Prompt Reader CLI.exe (Windows) 或对应路径的二进制文件。
• pip 安装用户：直接在终端运行 sd-prompt-reader-cli。

常用示例：

• 读取图片元数据并输出为文本：

  sd-prompt-reader-cli -r -i example.png
  

• 读取元数据并保存为 JSON 格式：

  sd-prompt-reader-cli -r -f JSON -i example.png
  

• 清除图片中的元数据：

  sd-prompt-reader-cli -c -i example.png
  

• 写入新的提示词到图片（覆盖或生成新文件）：

  sd-prompt-reader-cli -w -p "your positive prompt" -n "your negative prompt" -i input.png -o output.png
  

CLI 参数速查：

• -r, --read: 读取模式
• -w, --write: 写入模式
• -c, --clear: 清除模式
• -i, --input-path: 输入图片或目录路径（必填）
• -o, --output-path: 输出路径（可选，不填则生成带后缀的新文件）
• -p, --positive: 指定正向提示词
• -n, --negative: 指定负向提示词