链接： 📣 公告 | 📘 手册 | ⏱ 更新日志 | 🎓 入门指南

👋 简介

Unprompted 是一种 强大的模板语言，也是 Stable Diffusion WebUI 的 瑞士军刀。

Unprompted 以 [短代码] 为核心构建，专为 自然语言的最大可读性 而设计。这使得它 易于学习和使用，即使是没有编程经验的人也能轻松上手。

现在也作为 ComfyUI 节点 提供。

📦 特性

• 免费
• 开箱即用包含 70 多个短代码 —— 包括 [if] 条件语句、强大的 [file] 文件导入、用于灵活通配符的 [choose] 块，以及提示爱好者可能需要的一切功能。
• 可通过 自定义短代码 轻松扩展。
• 拥有众多 Stable Diffusion 特性，例如 [txt2mask] 和 Bodysnatcher，这些功能仅在 Unprompted 中独有。
• 能够根据个人喜好将 .txt 模板组织成 文件夹和子文件夹。
• 作为 现代语言，Unprompted 支持递归、嵌套短代码、高级逻辑运算符、自定义配置等，几乎涵盖了 21 世纪应有的所有优秀特性。
• 您可以以编程方式 读取和写入 WebUI 暴露的任何 Stable Diffusion 变量，例如 negative_prompt 和 cfg_scale。
• 支持 自然语言处理功能，如自动复数形式、查找同义词，甚至动词变位。
• 包含不断增长的示例列表，展示了高级功能，例如 自定义选择列表的权重 和 对提示中随机部分应用强调。
• 全面且始终最新的文档。
• 由一个真实的人类开发。

🔧 安装

我们提供三种安装方法：

如何直接安装...（点击展开）

1. 打开 Automatic 的 WebUI 的 Extensions 选项卡。
2. 进入 Install from URL 子选项卡。
3. 将此仓库的 URL 粘贴到第一个字段中：https://github.com/ThereforeGames/unprompted
4. 点击 Install。

如何通过扩展索引安装...（点击展开）

1. 打开 Automatic 的 WebUI 的 Extensions 选项卡。
2. 进入 Available 子选项卡。
3. 取消勾选“ads”过滤器，然后点击 Load from 按钮。
4. 向下滚动找到 Unprompted，然后点击 Install 按钮。（或者使用 CTRL+F 更方便）

（新）如何通过 pip 单独安装...（点击展开）

1. 在终端中运行 pip install unprompted@git+https://github.com/ThereforeGames/unprompted
2. 有关在您自己的 Python 项目中实现 Unprompted 的详细信息，请参阅 unprompted_dry.py

无论采用哪种方法，请务必在安装后重启您的 WebUI。 这样 Unprompted 才能下载其 Python 依赖项。

📚 使用

首先，让我们通过尝试一个内置模板来验证安装是否成功。将以下内容添加到您的提示中：

[call common/examples/human/main]

这是一个简单的“人物生成器”，会自动选择诸如发色、种族和姿势等特征。

[call] 短代码会在 unprompted/templates 中查找指定的文本文件（因此在本例中为 unprompted/templates/common/examples/human/main.txt）。您无需输入文件扩展名。

示例输出：

🚀 下一步

现在您已经确认 Unprompted 已正确安装并运行，您可以选择以下两种方式之一：

1. 访问 🎓 指南 页面，按照我们的教程创建您自己的模板。
2. 浏览全面的 📘 手册，按照自己的节奏逐步探索。

---

🛒 高级模板

虽然 Unprompted 是 完全免费使用的，但我们仍提供 高级模板包，展示软件的一些更高级功能。

Beautiful Soul 模板

一款极具表现力的角色生成器，专为 A1111 WebUI 设计。拥有数千个通配符，并直接集成 ControlNet，这是我们迄今为止功能最强大的 Unprompted 模板。

DemonCrawl 头像生成器

使用这款定制的 Stable Diffusion 模型，以 DemonCrawl 风格生成像素艺术！该模型基于游戏中超过 50 张头像进行训练。即使您不是艺术家，也可以创作属于自己的角色肖像！

奇幻卡片模板

以奇幻卡片游戏的风格生成各种各样的生物和角色。非常适合英雄、动物、怪物，甚至是疯狂的混种生物。






_{注： 为了说明情况，我是一名独立开发者，与任何商业实体均无关联（除了我自己的有限责任公司），并且从未获得过该项目的资助。Unprompted 完全由我个人资金支持。您的慷慨有助于证明我为开发这款软件所投入的数百小时是值得的。❤️}

---

🙏 致谢

我们谨向以下库的作者表示感谢，这些库被 Unprompted 使用：

• Python Shortcodes 由 Darren Mulholland 编写
• Simple Eval 由 @danthedeckie 开发
• Casefy 由 @dmlls 维护
• CLIPseg 由 uddecke、Timo 和 Ecker, Alexander 共同开发
• CLIP Surgery 由 Yi Li、Hualiang Wang、Yiqun Duan 和 Xiaomeng Li 共同完成
• NLTK 由 Bird, S., Klein, E., & Loper, E. 出版，O'Reilly Media, Inc. 发行
• pattern 由 Tom De Smedt 和 Walter Daelemans 共同开发
• Moby Thesaurus II 由 Grady Ward 编撰
• Insightface 由 Jia Guo、Jiankang Deng、Xiang An、Jack Yu、Baris Gecer 共同维护
• Ghost 由 A. Groshev、A. Maltseva、D. Chesakov、A. Kuznetsov 和 D. Dimitrov 共同开发
• FaceFusion 由 Henry Ruhs 创建
• GPEN 由 Tao Yang、Peiran Ren、Xuansong Xie 和 Lei Zhang 共同研发
• IQA-Pytorch 由 Chaofeng Chen 和 Jiadi Mo 共同开发

---

🐛 发现了 bug？请提交一个问题。

💬 如需讨论或分享模板，请使用讨论区。

⭐ 喜欢我的工作吗？如果您愿意，可以为这个仓库点个“赞”，以提高它的可见度。

Unprompted 快速上手指南

Unprompted 是一款专为 Stable Diffusion WebUI (A1111) 设计的强大模板语言和“瑞士军刀”。它基于 [shortcodes]（短代码）构建，语法贴近自然语言，无需编程基础即可轻松上手，支持条件判断、文件导入、动态权重调整及高级逻辑运算。

环境准备

• 操作系统：Windows, Linux, macOS
• 核心依赖：
  • Stable Diffusion WebUI (推荐最新版本)
  • Python 3.10+ (WebUI 自带)
• 网络要求：安装过程中需访问 GitHub 以下载插件及 Python 依赖库。若国内访问受阻，建议配置全局代理或在终端设置 GIT_PROXY 环境变量。

安装步骤

推荐使用 Extensions 面板 进行安装，操作最简便。

方法一：通过 URL 直接安装（推荐）

1. 启动 Stable Diffusion WebUI。
2. 点击顶部标签页的 Extensions。
3. 选择 Install from URL 子标签页。
4. 在 "URL for extension's git repository" 输入框中粘贴以下地址：

   https://github.com/ThereforeGames/unprompted
   

5. 点击 Install 按钮。
6. 重要：安装完成后，必须重启 WebUI 以加载 Python 依赖。

方法二：通过扩展列表安装

1. 进入 Extensions > Available 标签页。
2. 取消勾选 "ads" 过滤器，点击 Load from: Extensions index 按钮。
3. 在列表中搜索 Unprompted（或使用 Ctrl+F）。
4. 点击对应的 Install 按钮。
5. 重启 WebUI。

方法三：独立使用 (pip 安装)

若需在非 WebUI 的 Python 项目中使用：

pip install unprompted@git+https://github.com/ThereforeGames/unprompted

基本使用

安装并重启 WebUI 后，即可在提示词（Prompt）区域使用 Unprompted 功能。

1. 验证安装

在正向提示词框中输入以下测试代码并生成图片：

[call common/examples/human/main]

• 原理：[call] 短代码会自动读取 unprompted/templates 目录下的对应文件（即 common/examples/human/main.txt），无需填写 .txt 后缀。
• 效果：该模板是一个人物生成器，会自动随机选择发色、种族、姿势等特征。

2. 基础语法示例

Unprompted 的核心是短代码，以下是几个常用基础用法：

• 条件判断：

  [if cfg_scale > 7]High detail[/if]
  

• 随机选择：

  [choose]cat|dog|bird[/choose]
  

• 调用外部文件：

  [file my_styles.txt]
  

3. 进阶学习

• 模板管理：您可以在 stable-diffusion-webui/extensions/unprompted/templates 目录下创建文件夹和 .txt 文件来组织自己的模板。
• 文档查阅：
  • 🎓 新手引导 (Starter Guide)：学习如何编写自定义模板。
  • 📘 完整手册 (Manual)：查阅所有支持的短代码和高级功能。