Skip to content

Latest commit

 

History

History
166 lines (138 loc) · 8.94 KB

README_ZH.md

File metadata and controls

166 lines (138 loc) · 8.94 KB

Booru tag autocompletion for A1111

GitHub release (latest SemVer)

English Document

功能概述

本脚本为 AUTOMATIC1111 web UI的自定义脚本,能在输入Tag时提供booru风格（如Danbooru）的TAG自动补全。因为有一些模型是基于这种TAG风格训练的（例如Waifu Diffusion），因此使用这些Tag能获得较为精确的效果。

这个脚本的创建是为了减少因复制Tag在Web UI和 booru网站的反复切换。 你可以按照以下方法下载或拷贝文件，也可以使用Releases中打包好的文件。

常见问题 & 已知缺陷:

  • 浏览器可能因为缓存无法更新脚本、设置、embedding/wildcard列表，尝试使用CRTL+F5清空浏览器缓存并重新加载
  • 当replaceUnderscores选项开启时, 脚本只会替换Tag的一部分如果Tag包含多个单词,比如将atago (azur lane)修改atago为taihou并使用自动补全时.会得到 taihou (azur lane), lane)的结果, 因为脚本没有把后面的部分认为成同一个Tag。

Wildcard & Embedding 支持

自动补全同样适用于 Wildcard中所述的通配符文件(后面有演示视频)。这将使你能够插入Wildcard脚本需要的通配符，更进一步的，你还可以插入通配符文件内的某个具体Tag。

当输入__字符时，/scripts/wildcards文件夹下的通配符文件会列出到自动补全，当你选择某个具体通配符文件时,会列出其中的所有的具体Tag,但如果你仅需要选择某个通配符，请按下空格。

当输入<字符时，embeddings文件夹下的.pt和.bin文件会列出到自动完成。需要注意的是，一些颜文字也会包含<(比如>_<),所以它们也会出现在结果中。

现在这项功能默认是启用的，并会自动扫描/embeddings和/scripts/wildcards文件夹，不再需要使用tags/wildcardNames.txt文件了，早期版本的用户可以将它删除。

演示与截图

演示视频(使用了键盘导航):

autocomplete_demo.mp4

Wildcard支持演示:

wildcards.mp4

深浅色主题支持,包括Tag的颜色:

tagtypes tagtypes_light

安装

只需要将javascript，scripts和tags文件夹复制到你的Web UI安装根目录下.下次启动Web UI时它将自动启动。

tags文件夹下包含config.json（用于设置）和Tag数据（.csv格式）。默认情况下，Tag数据包括Danbooru.csv和e621.csv。

在扫描过/embeddings和/scripts/wildcards后，会将列表存放在tags/temp文件夹下。删除该文件夹不会有任何影响，下次启动时它会重新创建。

注意:

本脚本的允许需要全部的三个文件夹。

配置文件

配置文件（config.json）的默认值如下：

{
	"tagFile": "danbooru.csv",
	"activeIn": {
		"txt2img": true,
		"img2img": true,
		"negativePrompts": true
	},
	"maxResults": 5,
	"showAllResults": false,
	"replaceUnderscores": true,
	"escapeParentheses": true,
	"useWildcards": true,
	"useEmbeddings": true,
	"translation": {
		"searchByTranslation": true,
		"onlyShowTranslation": false
	},
	"extra": {
		"extraFile": "",
		"onlyTranslationExtraFile": false
	},
	"colors": {
		"danbooru": {
			"0": ["lightblue", "dodgerblue"],
			"1": ["indianred", "firebrick"],
			"3": ["violet", "darkorchid"],
			"4": ["lightgreen", "darkgreen"],
			"5": ["orange", "darkorange"]
		},
		"e621": {
			"-1": ["red", "maroon"],
			"0": ["lightblue", "dodgerblue"],
			"1": ["gold", "goldenrod"],
			"3": ["violet", "darkorchid"],
			"4": ["lightgreen", "darkgreen"],
			"5": ["tomato", "darksalmon"],
			"6": ["red", "maroon"],
			"7": ["whitesmoke", "black"],
			"8": ["seagreen", "darkseagreen"]
		}
	}
}
设置 描述
tagFile 指定要使用的标记文件。您可以提供您喜欢的自定义标签数据库，但由于该脚本是在考虑 Danbooru 标签的情况下开发的，因此它可能无法与其他配置一起正常工作。
activeIn 允许有选择地（取消）激活 txt2img、img2img 和两者的否定提示的脚本。
maxResults 最多显示多少个结果。对于默认标记集，结果按出现次数排序。对于嵌入和通配符，它​​将在可滚动列表中显示所有结果。
showAllResults 如果为真，将忽略 maxResults 并在可滚动列表中显示所有结果。 **警告：**对于长列表，您的浏览器可能会滞后。
replaceUnderscores 如果为 true，则在单击标签时将取消划线替换为空格。对于某些型号可能会更好。
escapeParentheses 如果为 true，则转义包含 () 的标签，因此它们不会对 Web UI 的提示权重功能做出贡献。
useWildcards 用于切换通配符完成功能。
useEmbeddings 用于切换嵌入完成功能。
translation 用于翻译标签的选项。更多信息在下面的部分。
extras 附加标签文件/翻译的选项。更多信息在下面的部分。
colors 包含标签类型的可自定义颜色，您可以在此处为自定义标签文件添加新颜色（与文件名相同，不带 .csv）。第一个值是暗模式，第二个值是亮模式。颜色名称和十六进制代码都应该有效。

翻译&新增Tag

通过最近的更新，现在可以为标签添加翻译。这些将根据 config.json 中的设置可搜索/显示：

  • searchByTranslation - 是同时搜索翻译词还是仅搜索英文标签。
  • onlyShowTranslation - 如果有英文标签，则用其翻译替换它。仅用于显示，最后插入的文本仍然是英文标签。

完整和部分中文标签集的示例：

translation translation_mixed

可以通过多种方式添加翻译，这就是额外文件发挥作用的地方。

  1. 直接在主标签文件中。只需添加第三个值，用逗号分隔，包含该行中标签的翻译。
  2. 作为仅包含已翻译标签行的额外文件（因此仍包括英文标签名称和标签类型）。将根据名称和类型与主文件中的英文标签匹配，因此对于大型翻译文件可能会很慢。
  3. 作为 onlyTranslationExtraFile 为 true 的额外文件。使用此配置，额外文件必须包含仅翻译本身。这意味着它完全基于索引，将翻译分配给主要标签非常快，但也需要匹配行（包括空行）。如果主文件中的顺序或数量发生变化，则翻译可能不再匹配。

因此，对于每种方法，您的 CSV 值将如下所示：

1 2 3
Main file tag,0,translation tag,0 tag,0
Extra file - tag,0,translation translation

方法 1 和 2 也可以混合使用，在这种情况下，如果它们翻译相同的标签，额外文件中的翻译将优先于主文件中的翻译。 如果 onlyTranslationExtraFile 为 false，额外文件也可用于添加未包含在主集中的新/自定义标签。 如果额外的标签与任何现有标签都不匹配，它将作为新标签添加到列表中。

CSV tag data

本脚本的Tag文件格式如下，你可以安装这个格式制作自己的Tag文件:

1girl,0
solo,0
highres,5
long_hair,0

值得注意的是，它不希望第一行中有列名。 第一个值需要是标签名称，而第二个值指定标签类型。 编号系统遵循 Danbooru 的 tag API docs:

Value Description
0 General
1 Artist
3 Copyright
4 Character
5 Meta

or of e621:

Value Description
-1 Invalid
0 General
1 Artist
3 Copyright
4 Character
5 Species
6 Invalid
7 Meta
8 Lore

标记类型用于为结果列表中的条目着色.