Autocomplete+++
Autocomplete+++：兼容 Node 2.0 的 ComfyUI 中文提示词助手。具备最新的 ffdkj 中文词库，支持词库更新、标签与模型补全、排序分页、关联标签、滚轮调权和完成提示音。 Chinese tag autocomplete for ComfyUI with an updatable ffdkj dictionary, sorting, pagination, candidate weights, related tags, and completion sounds.
Nodes (4)
Pin your prompt randomness to the workflow
Make the right tag dictionary travel with the workflow
Stop your prompt editor from fighting your prompt style
LoRA filenames vs LoRA paths, decided per workflow
Autocomplete+++
ComfyUI 中文提示词助手
标签补全 · 模型与触发词 · 动态提示词 · 通配符 · 提示词编辑
<img src="assets/comfy/banner.png" alt="Autocomplete+++" width="760"> </div>Autocomplete+++ 在 ComfyUI 的提示词输入框中提供标签搜索、中文名称、LoRA / Embedding 补全，以及提示词展开和编辑工具。支持经典 LiteGraph 与 Node 2.0。
项目是 Autocomplete++ 的 Fork，在原有功能上加入中文 UI、双排序、完整分页、类别筛选、可调补全布局和本地关联标签。新安装默认使用 ffdkj 中文词库，附带 332,385 条标签的可用快照，支持手动和每日自动更新。旧合并词库仍保留，其数据截止至 2026.10.12。
v1.1.1 更新
- 修复关闭 Node 2.0 后，点击相关标签无法插入提示词的问题。更新后按
Ctrl + F5刷新页面。
快速开始
安装
通过 ComfyUI-Manager 安装
GitHub 当前版本为 v1.1.1。Comfy Registry 单独发布，此次 GitHub 发布不会自动同步到 Manager；暂未显示新版时，可使用下方 ZIP 安装。
Comfy Registry 项目页可查看版本及检查状态。发布流程说明。
- 打开 Manager → Custom Nodes Manager（安装自定义节点）。
- 搜索
Autocomplete+++，也可尝试完整名称comfyui-autocomplete-plus-plus-plus。 - 核对项目名称为 Autocomplete+++、发布者为 twinklestar，点击 Install（安装）。
- 安装完成后重启 ComfyUI，再按
Ctrl + F5刷新浏览器。
手动安装 ZIP
- 从 Releases 下载
comfyui-autocomplete-plus-plus-plus-v1.1.1.zip，解压到ComfyUI/custom_nodes/comfyui-autocomplete-plus-plus-plus/。 - 确认该目录下直接包含
__init__.py，重启 ComfyUI 后端，再按Ctrl + F5刷新浏览器。
安装后，将 ComfyUI 语言设为中文，在设置中搜索 Autocomplete+++。
插件使用 ComfyUI 现有 Python 环境，没有额外声明的 Python 依赖。LoRA Manager 为可选集成。
<details> <summary>从 Autocomplete++ 或已有安装升级</summary>备份自定义词库、通配符和 data/user_data.json，再更新插件文件。原目录名为 comfyui-autocomplete-plus-plus 时，可改为 comfyui-autocomplete-plus-plus-plus。
仅保留一个生效版本，避免重复注册节点与接口。内部设置 ID、节点类型和本地 API 标识保持兼容，已有设置、常用记录及工作流可以继续使用。
ComfyUI-Manager 中的 Autocomplete++ 条目对应原项目。本项目请选择 Autocomplete+++（发布者：twinklestar）；索引尚未同步时，可使用上方的 ZIP 安装方式。
启用中文词库
| 设置 | 推荐值 |
| --- | --- |
| 主标签文件 | danbooru_ffdkj.csv（新安装默认） |
| 标签翻译文件 | 无，使用主词库内嵌译名 |
| 按翻译 / 中文名称搜索 | 开启 |
| 在补全候选中显示翻译 | 开启 |
安装包已附带 ffdkj 中文快照，无需联网下载即可搜索。升级会保留原有词库选择；想改用新默认词库时，在此选择 danbooru_ffdkj.csv，或在下方更新面板点击「使用此词库」。工作流中的「词典控制器」可覆盖全局选择，应设为跟随全局或选择相同文件。
配置后可以输入 long hair、长发 或 yui 试用补全。选中候选后，按 Enter 或点击插入对应英文标签；Tab 默认切换排序。
ffdkj 词库与更新
在 Autocomplete+++ → 标签与词典 → ffdkj 中文词库 中检查版本、安装更新、重新下载或切换主词库。随包快照来自上游 v2026-10-11 Release，转换为 UTF-8 无 BOM 的五列 CSV，并补入旧合并词库中的同名别名。
每日自动更新默认关闭，图中为已开启的本机配置。开启后，在 ComfyUI 页面打开期间每 24 小时最多检查一次；更新后直接重载补全数据，下载失败继续使用已有词库。数据跟随 ffdkj 的最新 GitHub Release CSV，与每日更新的 SQLite 数据库可能有时间差。更新与数据格式。
功能介绍
以下均为 Autocomplete+++ 在本地 ComfyUI 中的实际界面。新版交互图使用独立演示输入框，补全与关联面板由插件实际生成；对比图由真实截图裁剪、拼接，图外标题用于说明操作。为展示分页，部分截图将每页候选数设为 8；模型名称、候选数量和译名取决于本地文件与词库；早期示例保留了旧合并词库的译名。
| 查找与选择 | 模型与展开 | 编辑与配置 | | --- | --- | --- | | 中文与别名搜索 | LoRA / Embedding | 权重、换位与整理 | | 排序、类别与分页 | 触发词与模型详情 | 常用标签 | | 窗口与翻译布局 | Anima 画师 | 工作流控制器 | | 本地关联标签 | 动态提示词 | 节点菜单与兼容 | | 通配符文件与行浏览 | 展开模式与 PNG 恢复 | 中文设置与词库 |
标签补全与中文搜索
支持搜索 Danbooru / e621 标签、别名和译名。加载词库后先预处理搜索文本；输入时分批搜索，并取消过时查询，中文组词确认后再显示结果。所有匹配项仍可分页浏览。输入英文原名或中文名称，选中后按 Enter 或点击插入英文标签；候选同时显示译名、投稿数和词库来源。提示词中已有的标签会灰显，正在编辑的当前词条不计入重复。点击「百科」或按 F1 可查阅标签 Wiki。
Tab 可在「匹配优先 / 投稿数优先」之间切换；也可在设置中改为插入候选或关闭。悬停词条时按住 Shift 滚动鼠标，可预览本次插入权重，上滚增加、下滚减少，确认插入时生效。此功能默认开启，滚轮步进默认 0.05，可独立调整。
下图中提示词已有 (blue hair:1.2)，因此 blue_hair 灰显；悬停调权后显示 ×1.05。普通补全仍按原有方式插入，灰显不禁用选择。
在旧合并词库中输入「平沢唯」，可找到 hirasawa_yui；原有译名与别名 平沢唯,ゆいあず,yuihirasawa 保留在同一词条中。
除了点击类别按钮，也可输入 /character yui、/artist artist_name 或 /danbooru /artist artist_name 限定搜索范围。查看搜索语法。
排序、筛选与完整分页
弹窗左上角可随时切换两种排序。下面使用相同的 yui 查询和「角色」筛选，对比首屏结果：
- 投稿数优先：完全匹配优先，其余按词库投稿数降序排列，
hirasawa_yui等常见角色更容易找到。 - 匹配优先：综合原名、译名与别名的匹配程度排列，前缀匹配通常更靠前。
类别按钮同时提供筛选和颜色图例。点击「角色」「作品」等缩小范围，再点当前类别或「全部」取消筛选。
<details> <summary>类别颜色代表什么？</summary>| 颜色 | 类别 | 常见内容 | | --- | --- | --- | | 蓝色 | 一般 | 发色、服装、动作、构图 | | 红色 | 画师 | 画师、创作者 | | 紫色 | 作品 | 动画、游戏、系列 | | 绿色 | 角色 | 角色名称 | | 黄色 | 元信息 | 图片和制作方式等元数据 |
这组含义对应 Danbooru。e621 还包含物种、设定和无效标签，详见类别说明。
</details>每页 5–50 项，全部结果均可翻页浏览。 按钮和 PageUp / PageDown 切换整页，上下方向键也可跨页；单页数量不会截断总结果。
翻页、排序和筛选复用当前结果，只绘制当前页，不重新读取 CSV 或重做全词库搜索。新查询的耗时仍取决于词库大小与设备。
</details>窗口宽度与翻译布局
原名与译名支持 左右分栏、行内显示、上下排列。长译名可以自动换行，设置页提供随选项更新的显示预览。
窗口可在设置中调整为 280–1600 px，也可拖动右下角调宽并保存，实际宽度不超过可用视口。关闭换行后，可悬停查看被截断的文字。
LoRA 与 Embedding 补全
输入 <lora: 查找本地 LoRA，输入 embedding: 或 emb: 查找 Embedding。选择模型时可显示本地缩略图；预览卡片位置和动画播放方式均可配置。
LoRA 支持「自动」「仅文件名」「完整路径」三种路径补全方式。自动模式会在遇到重名模型时使用相对路径。模型与路径说明。
</details>触发词、预设与模型详情
安装并启用可选的 ComfyUI-Lora-Manager 后，输入 <trigger: 可检索 当前工作流已加载 LoRA 的触发词。预览中可逐项选择，也可点击「插入整组」使用完整提示词预设。
选中触发词后按 F1 或点击信息按钮，可查看模型信息、推荐强度、CLIP 参数、触发词、预设和图库。触发词与预设支持复制，图片支持查看可用的生成参数；底部可跳转到 LoRA Manager。
具体内容取决于 LoRA Manager 版本和模型已有元数据。多个模型共用触发词时，会先显示模型选择菜单。集成说明。
</details>Anima 画师补全
Anima 模式生效时，输入 @ 可搜索画师；从普通标签搜索选择画师，也会自动添加 @ 前缀。
默认自动检测工作流模型，也可在「Anima 艺术家前缀模式」中强制启用或关闭。图中演示的是启用模式后的 @torino 查询。
动态提示词与实际展开
在文本中写入备选项，展开引擎会在运行前按所选模式解析。支持随机选择、权重、多项抽取和自定义分隔符：
| 写法 | 作用 |
| --- | --- |
| {red hair \| blue hair \| green hair} | 抽取一个选项 |
| {3::sunny \| 1::rainy} | 按 3:1 的权重抽取 |
| {2$$red ribbons \| blue ribbons \| green hairband} | 抽取两个不同选项 |
| {1-3$$ and $$apples \| bananas \| oranges} | 抽取 1–3 项，用 and 连接 |
下图上方为输入，下方为 同次实际运行的展开结果；最后一行同时演示了从通配符文件取出 forest。
截图使用 Text (Multiline) 与 Show Text 🐍 节点查看文本结果，后者是演示环境中的辅助节点，不是本插件新增节点。完整语法。
通配符文件与逐行浏览
输入 __ 浏览通配符文件与目录。文件名后追加 /，例如 __autocomplete_demo/scenery/，可直接查看其中每一行；选择完整的 __autocomplete_demo/scenery__ 则保留为运行时抽取。
通配符使用 UTF-8 .txt，每行一个候选。支持本插件的 wildcards/、ComfyUI/wildcards/ 及其他自定义节点的 wildcards/，也可以嵌套进动态表达式。
复现截图可将 scenery.txt 放到 ComfyUI/wildcards/autocomplete_demo/scenery.txt。
展开模式与 PNG 恢复
全局设置和画布控制器都可选择展开模式。同一次生成中的多次处理会复用一致选择，便于分阶段处理或细节修复。
| 模式 | 行为 | | --- | --- | | 随机 | 每次生成重新抽取 | | 跟随种子 | 按生成种子决定选择 | | 保持上次选择 | 主种子不变时沿用上次选择 | | 按顺序 | 依次使用文件行，仅适用于通配符 |
<details> <summary>查看模式菜单和实验性 PNG 恢复入口</summary>
「导入 PNG 时恢复上次选择」为默认关闭的实验功能。在「保持上次选择」模式下，可从含所需元数据的 PNG 恢复动态选择及本地通配符选项，需要本地存在对应通配符。
此图展示设置入口。普通 JSON 工作流、缺少所需元数据的 PNG 不支持恢复；恢复选择也不保证跨设备生成的图片完全一致。适用条件与监听模式。
</details>提示词编辑与自动整理
Ctrl + ↑ / ↓ 调整完整标签、Embedding 或 LoRA 的权重；Ctrl + ← / → 按标签移动，Alt + ← / → 交换相邻标签。
离开输入框时可自动整理逗号和空格、转换下划线，并保护模型、通配符等语法。花括号支持自动闭合、包裹选区、成对删除，以及跳过已有右括号。
标签 / Embedding 与 LoRA 有独立权重步长；逗号、行末处理和下划线转换可分别开关，也可配置保留下划线的标签。编辑与格式化规则。
常用标签与个人记录
达到个人使用次数阈值后，候选会显示「常用」徽标。开启常用优先时，最多 3 个常用标签可置顶；它与词库投稿数排序是独立设置。
最少使用次数、有效期、历史容量和清除历史均可配置；有效期为 0 表示永不过期。备份个人记录时保留 data/user_data.json。
本地关联标签
点击提示词中的 Danbooru 标签，或按 Ctrl + Shift + Space，查看共现关系推荐。选择候选可插入到当前标签后，已有标签会灰显并支持定位。
下图从 scenery 打开面板。提示词已有 (cloud:1.2)，对灰色 cloud 上滚一步后预览 ×1.25；确认会更新原词条，可用 Ctrl + Z 撤销。未调权时点击灰色词条仍会定位原位置。
工具栏可切换横向 / 纵向布局，以及「关联度 / 投稿数」排序；Tab 默认切换排序。可配置显示 5–100 项，先对全部关联结果排序，再取显示数量，且限于当前加载的 Danbooru 词库。部分标签没有关联记录。
关联窗口也支持 Shift＋滚轮 预览权重。已有的灰色词条未调权时点击定位；预览新权重后确认，会更新已有词条，避免重复插入。
此功能需要本地关联索引；如果下载包未包含索引，可按构建说明生成。
</details>四种工作流控制器
四种控制器直接放在画布上即可为当前工作流覆盖设置，无须连线：
| 控制器 | 可覆盖的内容 | | --- | --- | | 通配符与动态提示词 | 展开开关、抽取模式 | | 格式整理 | 逗号、下划线、括号、Anima 画师前缀 | | 插件集成 | LoRA / Embedding、路径和 LoRA Manager | | 词典 | 主词库、附加词库、翻译文件 |
选择「默认（跟随全局设置）」即可继续使用全局值。同类控制器并存时，最后修改的优先；Node 2.0 会显示生效状态，点击未生效徽标可切换控制权。静音或绕过控制器会让出控制权。
控制器还提供可选直通端口，供工作流整理使用。控制器与优先级。
</details>节点菜单与画布兼容
经典画布的节点右键菜单提供 Autocomplete+++ 子菜单，可以忽略某类节点、强制接管某类节点，或只对当前节点禁用补全。原生 Note 节点默认不启用补全。
插件支持经典 LiteGraph 与 Node 2.0 文本输入框。前文多数截图为 Node 2.0，下图为经典画布。
中文设置与词库组合
在 ComfyUI 设置中打开 Autocomplete+++，可分别选择主标签、附加词库和翻译文件，独立控制中文搜索与译名显示。支持 Danbooru、e621 和自定义 CSV。
词库文件选择和更新入口见上方的 ffdkj 词库与更新。
danbooru_ffdkj.csv 与 danbooru_merged_zh.csv 均已内嵌译名，翻译文件可选「无」。额外选择 danbooru_zh.csv 等翻译文件时，其非空译名会覆盖内嵌译名；工作流中的词典控制器也可覆盖全局文件选择。
工作流完成提示音
每个队列任务成功完成后提醒一次，包括全部使用缓存的任务；失败或手动中断不播放。支持清亮双音、柔和钟声、完成琶音和电子三连音，可调音量、独立开关并试听。
在「设置 → Autocomplete+++ → 工作流提醒」中调整，默认开启、音量为 35%（截图使用本机自定义音量 100%）。声音由浏览器本地合成；打开或刷新页面后，先点击页面或按键允许播放，并保持页面打开且未静音。使用说明。
常用快捷键
| 按键 | 操作 |
| --- | --- |
| ↑ / ↓ | 选择候选，可跨页 |
| Enter / 点击 | 插入选中候选，Enter 可在设置中关闭 |
| Tab | 切换排序，可在设置中改为插入或关闭 |
| Shift＋滚轮 | 悬停候选时预览本次权重，确认后生效 |
| PageUp / PageDown | 上一页 / 下一页 |
| F1 | 打开标签百科或 LoRA 详情 |
| Ctrl + Shift + Space | 打开关联标签 |
| Ctrl + ↑ / ↓ | 调整权重 |
| Ctrl + ← / → | 按标签移动光标 |
| Alt + ← / → | 交换标签位置 |
| Esc | 关闭弹窗或面板 |
常见问题
<details> <summary>界面还是英文，或词条没有中文？</summary>将 ComfyUI 语言设为中文，重启后端并按 Ctrl + F5。词条译名还需要选择中文主词库，并开启翻译显示；界面语言与词库译名是两个独立设置。
ffdkj 和旧合并词库的第五列已经包含译名。「无」表示不加载额外的覆盖翻译。可以分别关闭译名显示或中文搜索。
</details> <details> <summary>搜索结果多，或常见角色排得靠后？</summary>尝试「角色」筛选和「投稿数优先」，再浏览后续页面。启用常用置顶时，最多 3 个个人常用标签仍可排在前面；需要比较纯排序时可关闭该设置。
缺少投稿数的数据以 0 参与排序。若词库选择没有生效，请检查工作流中的词典控制器。
关联面板需要本地索引和当前加载的 Danbooru 词库，其数据覆盖范围小于普通词库，部分标签没有共现记录。
重复弹窗通常来自多个补全扩展同时接管同一输入框，可在 ComfyUI 扩展管理中停用重复的补全前端。
</details>文档与词库
- 完整使用指南：模型与触发词、Anima、动态语法、格式化、控制器和设置。
- 词库与关联索引：CSV 格式、合并来源、翻译保留规则及索引构建。
- 发布说明：上传 GitHub 时的数据文件和项目元数据处理。
内置合并词库截止至 2026.10.12，使用当日的 tagdb-updater 来源快照，编码为 UTF-8 无 BOM。已有译名与别名原样保留，只有新增词条补充机器翻译，未全部人工校订。这份旧快照保持固定；默认 ffdkj 词库有独立的上游版本，支持自动和手动更新。
项目来源与致谢
本分支以 Autocomplete++ 1.3.0 为改造基础。上游提供补全、动态展开、格式化与控制器，本分支增加中文界面和词库、双排序、完整分页、类别筛选、可调布局及本地关联标签。
| 项目 | 来源与贡献 | | --- | --- | | michikora / Autocomplete++ | 本分支上游 | | newtextdoc1111 / Autocomplete-Plus | 原始补全项目、已有词库及关联标签参考 | | ffdkj / Danbooru 中英文对照表 | 可更新的中文标签词库（MIT） | | Aaalice233 / ComfyUI-Autocomplete-Aaalice | ffdkj 词库独立下载、状态展示与更新流程参考 | | PYU224 / tagdb-updater | 标签、分类、投稿数和日文名称 | | boorutan / booru-japanese-tag | 上游数据使用的部分日文词库 | | DominikDoom / tagcomplete | 上游功能的灵感与参考 | | ComfyUI | 运行平台 |
代码采用 MIT License，保留原作者版权声明。第三方词库、共现数据和图片按各自来源说明使用。