stable-diffusion-prompt-reader

拖入图片，秒读 Stable Diffusion 提示词，无需开 WebUI

这是一个独立的桌面工具，用于读取 Stable Diffusion 生成图片中嵌入的提示词（prompt）及相关参数，无需启动 WebUI。它基于 Python 和 tkinter 构建，支持 Windows 和 macOS 平台，通过解析 PNG 的元数据（如 text 块）提取生成信息，并以简洁界面展示。核心能力包括：拖拽或选择图片文件快速查看提示词、负面提示词、采样器、种子、CFG 等参数；支持复制提示词到剪贴板，方便二次创作；可批量处理文件夹中的图片，导出提示词列表。解决了用户在不启动重型 WebUI 的情况下，快速查看和管理生成图片元数据的痛点，适合整理图库、复现生成效果或学习他人作品。项目轻量、启动快，界面简单，但功能聚焦，不涉及图像编辑或生成。

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1342

维护状态低维护

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队receyuki

所属国家

官网地址

GitHubhttps://github.com/receyuki/stable-diffusion-prompt-reader

定价模式free

价格说明开源免费，MIT 许可证，本地部署使用，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,image-generation,macos,prompt-engineering,prompt-toolkit,python,stable-diffusion,stable-diffusion-webui,tkinter,windows

GitHub 星标★ 1342

30天Star增速

HF 下载量

上线时间2023-03-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：本地安装 8 步

环境要求

Python 环境（可使用 pip 或 pipx 安装）
macOS 用户可选装 Homebrew 以使用 cask 安装
桌面环境（GUI 基于 tkinter，需图形界面）
支持 macOS、Windows 和 Linux

安装与启动步骤

1pip 安装

最通用的安装方式，安装后在终端输入 sd-prompt-reader 即可启动 GUI。
```
pip install sd-prompt-reader
```
2pipx 安装

希望把工具隔离在独立环境时使用 pipx，启动命令与 pip 安装相同。
```
pipx install sd-prompt-reader
```
3macOS 用 Homebrew

macOS 用户可用 cask 安装；因应用未签名，需加 --no-quarantine 避免被拦截。
```
brew install --no-quarantine receyuki/sd-prompt-reader/sd-prompt-reader
```
4克隆源码仓库

想从源码运行或二次开发时，先把仓库克隆到本地，也可直接下载 zip 包。
```
git clone https://github.com/receyuki/stable-diffusion-prompt-reader.git
```
5安装源码依赖

进入仓库目录后按 requirements.txt 安装依赖。
```
cd stable-diffusion-prompt-reader
pip install -r requirements.txt
```
6启动 GUI

pip/pipx 安装后，在终端输入该命令即可打开图形界面查看提示词。
```
sd-prompt-reader
```
7源码方式启动

未通过包安装时，可在仓库目录下以模块方式直接运行 GUI。
```
python -m sd_prompt_reader.app
```
8启动命令行版

需要脚本化处理时使用 CLI 版本，适合批量读取图片中的提示词信息。
```
sd-prompt-reader-cli
```

如何确认成功

终端执行 sd-prompt-reader 能弹出图形界面，或执行 sd-prompt-reader-cli 能输出图片提示词信息，即为成功。

常见问题

Q：macOS 提示“app 已损坏，无法打开”怎么办？

A：该应用目前未签名，会被系统隔离。使用 Homebrew 安装时加 --no-quarantine 参数，或按 README 指引手动解除隔离后重试。

Q：GUI 和 CLI 分别用什么命令启动？

A：图形界面用 sd-prompt-reader；命令行用 sd-prompt-reader-cli。两者由同一个包 sd-prompt-reader 提供。

Q：修改提示词后原图会被覆盖吗？

A：默认不会。未指定输出路径时，修改后的图片会保存在当前目录，并在原文件名后加后缀；若想覆盖原文件，把输出路径设为输入路径即可。

Q：可以批量写入修改吗？

A：不可以。写模式只支持修改单张图片，批量操作请以读取/查看为主。

注意事项

Homebrew 安装需带 --no-quarantine，因为应用当前未签名。
写入修改仅支持单张图片，不指定输出路径时结果保存在当前目录并追加后缀。
除桌面版外还提供 ComfyUI 节点，可在 ComfyUI 中直接读取提示词。
项目同时支持 macOS、Windows 和 Linux。

核心亮点

独立运行，无需启动 WebUI，资源占用低
支持拖拽和批量处理，快速提取图片中的提示词和参数
跨平台（Windows/macOS），基于 tkinter 界面简洁易用

不足之处

仅支持读取 PNG 元数据，对 JPEG 等格式兼容性有限
功能单一，不支持提示词编辑或图像预览增强
文档/社区待观察

适用场景

整理本地 SD 生成图片，快速查找提示词
复现他人作品时提取生成参数
批量导出图片提示词用于归档或分享

替代项目

Stable Diffusion WebUI 自带图片信息读取功能、InvokeAI 的提示词查看工具、ComfyUI 的元数据查看节点

项目介绍

stable-diffusion-prompt-reader 是图像领域的开源项目，由 receyuki 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,342）位列前 30%，在图像分类的 839 个项目里位列前 13%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。开源免费，MIT 许可证，本地部署使用，无付费版本。

它主要面向的使用场景是：整理本地SD生成图片，快速查找提示词。同类可对比的替代方案包括 Stable Diffusion WebUI 自带图片信息读取功能、InvokeAI 的提示词查看工具、ComfyUI 的元数据查看节点。

上一篇：PITI

下一篇：lecam-gan