627 lines
22 KiB
Markdown
627 lines
22 KiB
Markdown
# 标签预览图功能
|
||
|
||
## 功能概述
|
||
|
||
在标签管理界面（Tag Manager）中，每个标签卡片新增 120×120 的预览图显示区域。使用 ComfyUI 内部队列 API 进行文生图生成，支持单个生成、重新生成和一键批量生成。
|
||
|
||
---
|
||
|
||
# 特别关注！
|
||
##### 一定要进群！一定要进群！一定要进群！
|
||
官方 QQ 群： `905656521` (由于旧的群聊`1018231382`已被封请更换新群聊!)
|
||
|
||
---
|
||
|
||
# 注意！
|
||
##### 如果你需要使用或不了解又或者想要沟通交流都可以加入QQ群进行了解！
|
||
本插件还是在内测中，目前已经趋于稳定状态！如果要使用请进官方 QQ 群了解详情！
|
||
|
||
## 配套使用说明 - 旧插件提示词迁移到新插件
|
||
插件有专门的独立后台面板，可以把你的旧版的提示词转换成新版本插件的提示词以及便携式的离线修改Tag，项目入口 [WeiLin-Comfyui-Tools-panel
|
||
](https://github.com/weilin9999/WeiLin-Comfyui-Tools-panel)
|
||
|
||
## 插件的云Tag和Danbooru数据库仓库
|
||
仓库位置：[WeiLin-Comfyui-Tools-Prompt](https://github.com/weilin9999/WeiLin-Comfyui-Tools-Prompt)，如果你感兴趣可以查看一起协作
|
||
|
||
# 作者声明
|
||
|
||
由于个人时间有限，更新插件的频率并不会很高，偶尔有空或许会更新一次，每次更新尽量满足所提出的需求，一般没有大的 BUG 基本上更新频率不高，一个月 2~5 更，感谢你对本插件的使用与支持，有需求可以提交 Issue 或者你可以提交你的 Request 帮助本插件更新。
|
||
|
||
|
||
## 功能列表（0.0.77版本开始支持，由[PR#75-Dali8029](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/75)实现）
|
||
|
||
- **预览图缩略图**：每个标签卡片顶部显示 120×120 预览图
|
||
- **单个生成**：点击未生成标签的缩略图区域，弹出参数配置对话框
|
||
- **重新生成**：已有预览图的标签，鼠标悬停时显示刷新按钮，可删除旧图重新生成
|
||
- **一键批量生成**：为当前分组所有标签批量生成预览图，带实时进度条
|
||
- **浮窗预览**：鼠标悬停缩略图 200ms 后显示原尺寸大图
|
||
- **中止生成**：一键取消所有排队中和生成中的任务
|
||
- **参数持久化**：生成参数自动保存到本地，下次打开无需重新设置
|
||
- **异步队列**：后台顺序执行生成任务，页面刷新后自动恢复轮询状态
|
||
|
||
|
||
## 使用说明
|
||
|
||
### 基本操作
|
||
|
||
1. 打开标签管理界面，选择任意分组
|
||
2. 点击标签卡片的缩略图区域（"生成"按钮），弹出参数配置对话框
|
||
3. 设置模型、尺寸、采样器等参数，点击"生成"
|
||
4. 等待生成完成，缩略图自动刷新显示
|
||
5. 鼠标悬停缩略图 200ms 查看原尺寸大图
|
||
|
||
### 重新生成
|
||
|
||
1. 鼠标悬停在已有预览图的缩略图上
|
||
2. 右上角出现刷新图标，点击弹出配置对话框
|
||
3. 修改参数后点击"重新生成"，旧图会被删除并重新生成
|
||
|
||
### 一键批量生成
|
||
|
||
1. 点击标签列表上方的"一键生成"按钮
|
||
2. 在弹出的对话框中配置生成参数
|
||
3. 对话框标题显示待生成的标签数量
|
||
4. 点击"开始生成"，实时进度条显示当前进度
|
||
|
||
|
||
# 版本更新介绍
|
||
|
||
> 最新更新：2026-06-27
|
||
|
||
> 0.0.77/0.0.78/0.0.79 公测版本介绍 如果你要使用本插件请务必进我们的官方 QQ 群（905656521）！
|
||
>
|
||
> 1. **新增功能：标签预览图生成** —— 在标签管理界面中，每个标签卡片新增 120×120 的预览图显示区域
|
||
> - 使用 ComfyUI 内部队列 API 进行文生图生成
|
||
> - 支持单个标签生成、重新生成（删除旧图再生成）
|
||
> - 支持一键批量生成当前分组下所有标签的预览图
|
||
> - 鼠标悬停缩略图 200ms 后显示原尺寸浮窗预览
|
||
> - 生成任务在后台异步队列中顺序执行
|
||
> - 页面刷新后自动恢复轮询状态
|
||
>
|
||
> 2. **生成参数配置对话框** —— 单个生成和批量生成均提供完整参数配置
|
||
> - 模型选择（自动扫描 ComfyUI checkpoints 目录）
|
||
> - 图片尺寸预设（512×512、768×512、512×768 等）
|
||
> - 采样器（K采样器）+ 调度器选择
|
||
> - 步数、CFG、种子 可调节
|
||
> - 正向/负向提示词可编辑
|
||
> - 参数自动保存到本地，下次打开无需重新设置
|
||
>
|
||
> 3. **批量生成进度条** —— 一键生成对话框显示实时进度（已完成/总数）
|
||
>
|
||
> 4. **中止生成按钮** —— 一键取消所有排队中和生成中的任务
|
||
>
|
||
> 5. 合并PR [#75](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/75) 感谢各位小伙伴的帮助
|
||
>
|
||
> 6. 合并PR [#76](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/76) 感谢各位小伙伴的帮助
|
||
>
|
||
> 7. 合并PR [#79](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/79) 感谢各位小伙伴的帮助
|
||
>
|
||
> 8. 修复提示词隐藏之后修改提示词会导致隐藏提示词位置变动的BUG
|
||
>
|
||
> 9. 修复自动补全BUG，如果提示词是隐藏的输入同样的提示词补全的时候会把隐藏的提示词位置变到自动补全的位置上
|
||
>
|
||
|
||
<details>
|
||
<summary>点击查看往期更多更新内容</summary>
|
||
|
||
|
||
> 0.0.76 公测版本介绍 2026-06-06
|
||
>
|
||
> 1. 合并PR [#71](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/71) 感谢各位小伙伴的帮助
|
||
>
|
||
> 2. 合并PR [#72](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/72) 感谢各位小伙伴的帮助
|
||
>
|
||
> 3. 合并PR [#74](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/74) 感谢各位小伙伴的帮助
|
||
>
|
||
>
|
||
|
||
> 0.0.75 公测版本介绍 2026-05-09
|
||
>
|
||
> 1. 合并PR [#71](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/71) 感谢各位小伙伴的帮助
|
||
>
|
||
> 2. 合并PR [#72](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/72) 感谢各位小伙伴的帮助
|
||
>
|
||
|
||
> 0.0.74 公测版本介绍 2026-04-18
|
||
>
|
||
> 1. 合并PR [#62](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/62) 感谢各位小伙伴的帮助
|
||
>
|
||
> 2. 合并PR [#65](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/65) 感谢各位小伙伴的帮助
|
||
>
|
||
> 3. 合并PR [#70](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/70) 感谢各位小伙伴的帮助
|
||
>
|
||
|
||
> 0.0.73 公测版本介绍 2026-03-21
|
||
>
|
||
> 1. 合并PR [#63](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/63) 感谢各位小伙伴的帮助
|
||
>
|
||
> 2. 修改了一些逻辑代码
|
||
>
|
||
|
||
> 0.0.72 公测版本介绍 2025-12-21
|
||
>
|
||
> 1. API翻译模式回归，现在翻译接口重写目前只支持 阿里巴巴翻译接口、Bing翻译接口、有道翻译接口（该接口有请求限制不建议使用），目前这三个接口都是免费，后续会写付费的翻译接口对接
|
||
>
|
||
> 2. 修改了硅基AI和OpenAI翻译的问题，回归成原有的模式
|
||
>
|
||
> 3. 合并PR [#57](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/57) 感谢各位小伙伴的帮助
|
||
>
|
||
|
||
|
||
> 0.0.71 公测版本介绍 2025-12-20
|
||
>
|
||
> 1. API翻译模式回归，现在翻译接口重写目前只支持 阿里巴巴翻译接口、Bing翻译接口、有道翻译接口（该接口有请求限制不建议使用），目前这三个接口都是免费，后续会写付费的翻译接口对接
|
||
>
|
||
> 2. 修改了硅基AI和OpenAI翻译的问题，回归成原有的模式
|
||
>
|
||
|
||
> 0.0.70 公测版本介绍 2025-12-19
|
||
>
|
||
> 1. API翻译模式回归，现在翻译接口重写目前只支持 阿里巴巴翻译接口、Bing翻译接口、有道翻译接口（该接口有请求限制不建议使用），目前这三个接口都是免费，后续会写付费的翻译接口对接
|
||
>
|
||
|
||
> 0.0.69 公测版本介绍 2025-12-06
|
||
>
|
||
> 1. 合并PR [#50](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/50) 感谢各位小伙伴的帮助
|
||
>
|
||
> 2. 合并PR [#52](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/52) 感谢各位小伙伴的帮助
|
||
>
|
||
|
||
> 0.0.68 公测版本介绍 2025-11-08
|
||
>
|
||
> 1. 修复悬浮球功能菜单样式丢失问题
|
||
>
|
||
> 2. 修复一些已知的BUG（Lora堆最后一个删除不了的问题，Tag提示词清空问题，Tag权重负数问题）
|
||
>
|
||
> 3. 新增功能：一键清空功能，能清空所有的内容
|
||
>
|
||
|
||
> 0.0.67 公测版本介绍 2025-10-26
|
||
>
|
||
> 1. 修复一键翻译不全的问题
|
||
>
|
||
> 2. 合并PR [#46](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/46) 感谢各位小伙伴的帮助
|
||
>
|
||
> 3. 新增功能：在Tag中的右侧添加了一个删除按钮，方便删除Tag
|
||
>
|
||
|
||
> 0.0.66 公测版本介绍 2025-10-12
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 合并PR [#44](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/44) 感谢各位小伙伴的帮助
|
||
>
|
||
> 3. 新增功能：在Tag的控制栏中可以一键收藏Tag，还添加了添加换行符的功能
|
||
>
|
||
> 4. 翻译大修改！本次更新将翻译功能全部重改了，使用AI进行翻译，对接硅基AI进行调用API翻译，如果你想要对接其它的AI平台你可以进群提交建议，后续更新会添加新的平台
|
||
>
|
||
|
||
> 0.0.65 公测版本介绍 2025-09-23
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 合并PR [#40](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/40) 感谢各位小伙伴的帮助
|
||
>
|
||
> 3. 合并PR [#43](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/43) 感谢各位小伙伴的帮助
|
||
>
|
||
|
||
> 0.0.64 公测版本介绍 2025-09-14
|
||
>
|
||
> 1. 修复了已知BUG（Comfyui中执行栏拖拽图标错位问题）
|
||
>
|
||
> 2. 修改部分UI问题
|
||
>
|
||
> 3. 合并PR [#38](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/38) 感谢各位小伙伴的帮助
|
||
>
|
||
> 4. 下午5点30分：侧边标签增加收纳功能
|
||
|
||
> 0.0.62 公测版本介绍 2025-09-13
|
||
>
|
||
> 1. 修复了已知BUG（Tag分享问题）
|
||
>
|
||
> 2. 修改部分UI（设置、弹窗）
|
||
>
|
||
> 3. 增加Tag二级目录的分享功能
|
||
>
|
||
> 4. 合并PR [#37](https://github.com/weilin9999/WeiLin-Comfyui-Tools/pull/37) 感谢各位小伙伴的帮助
|
||
>
|
||
> 5. 修复节点不使用加载问题，如果节点不连接或者不使用请关闭节点上的随机提示词开关！
|
||
>
|
||
|
||
> 0.0.61 公测版本介绍 2025-08-06
|
||
>
|
||
> 1. 修复了已知BUG（节点不加载时运行流程也会导致节点加载）(随机tag加载问题)
|
||
>
|
||
> 2. 修复在部分情况下打开弹窗的错误问题
|
||
>
|
||
> 3. 增加了Tag分组的大小调节功能
|
||
>
|
||
> 4. 增加了更新弹窗不再提示功能
|
||
>
|
||
|
||
> 0.0.60 公测版本介绍 2025-07-11
|
||
>
|
||
> 1. 修复了已知BUG（节点不加载时运行流程也会导致节点加载）
|
||
>
|
||
> 2. 新增功能：Danbooru管理器，可以快捷管理Danbooru的数据更加方便
|
||
>
|
||
|
||
|
||
> 0.0.59 公测版本介绍 2025-05-08
|
||
>
|
||
> 1. 修复了已知BUG
|
||
>
|
||
> 2. 新增功能（测试）：Lora可以以Tag形式加载（仅全能提示词编辑器生效）在编辑器下方的Lora管理器点击添加Tag即可我们插件识别的方式为```<wlr:Lora名称:模型权重:文本权重>```
|
||
>
|
||
> 3. 修复了Lora管理器二级目录加载的问题
|
||
>
|
||
> 4. 修复了Tag管理器Tag点击排序的bug问题
|
||
|
||
> 0.0.58 公测版本介绍 2025-05-07
|
||
>
|
||
> 1. 修复了已知BUG
|
||
>
|
||
> 2. 修改Lora悬浮卡片的大小了位置
|
||
>
|
||
> 3. 功能升级：悬浮球可自定义皮肤和颜色
|
||
>
|
||
> 4. 功能优化：历史记录信息简化显示
|
||
>
|
||
> 5. 新增功能：随机Tag功能，可以设定模板，一键随机Tag
|
||
>
|
||
> 6. 功能优化：Tag管理器的分类栏可以修改顺序和位置
|
||
>
|
||
> 7. 功能优化：Tag管理器搜索的匹配结果更精确
|
||
>
|
||
> 8. 小功能：输入框左下角添加了Token长度显示
|
||
>
|
||
> 9. 修复输入框记录高度小概率触发高度变成很矮的情况
|
||
>
|
||
> 10. 插件有新版本时窗口左下角会提示更新
|
||
>
|
||
> 11. 节点新增功能：自动随机Tag，设置好了模板即可使用，每个节点的随机模板都是不同的可以自定义化
|
||
>
|
||
> 12. 修改了Lora管理器，新增了二级目录显示全部的功能，修改了目录栏的高度问题
|
||
>
|
||
|
||
> 0.0.53 公测版本介绍 2025-04-30
|
||
>
|
||
> 1. 功能优化：修复了在日间模式下的Lora详细内容的按钮样式看不到问题
|
||
>
|
||
> 2. 修复了issues [#14](https://github.com/weilin9999/WeiLin-Comfyui-Tools/issues/14#issuecomment-2840561525) 当第一行只有一个Tag的时候会触发换行不添加末尾逗号
|
||
>
|
||
|
||
> 0.0.52 公测版本介绍 2025-04-28
|
||
>
|
||
> 1. 新增功能：Lora详细界面内可以自定义自己的字段
|
||
>
|
||
> 2. 新增功能：在插件（非节点）UI内鼠标悬浮在Lora卡片上能显示Lora的基本信息
|
||
>
|
||
> 3. 修复了已知的BUG
|
||
>
|
||
> 4. Lora获取C站数据的时候可以一并获取封面了
|
||
>
|
||
|
||
> 0.0.48 公测版本介绍 2025-04-25
|
||
>
|
||
> 1. 新增辅助功能，限制了窗口的移动范围防止超出可视范围，以及悬浮球也限制了移动范围
|
||
>
|
||
|
||
> 0.0.46 公测版本介绍 2025-04-24
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 优化功能：补全提示词，详情：
|
||
> * 在设置中可以设置显示条数以及设置补全框的大小
|
||
> * 补全框现在可以跟着输入的位置移动了
|
||
>
|
||
|
||
> 0.0.45 公测版本介绍 2025-04-22
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 新增功能：批量导入Tag功能（修改了一些逻辑问题和优化一些新的功能）
|
||
>
|
||
> 3. 新增：记录输入框的高度，每次打开都会保持到上一次的状态高度
|
||
>
|
||
> 4. 修复Lora管理器加载不全问题
|
||
>
|
||
|
||
> 0.0.42 公测版本介绍 2025-04-22
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 新增功能：批量导入Tag功能
|
||
>
|
||
> 3. 新增功能：分享Tag和批量分享的功能
|
||
>
|
||
|
||
> 0.0.41 公测版本介绍 2025-04-16
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
|
||
|
||
> 0.0.40 公测版本介绍 2025-04-15
|
||
>
|
||
> 1. 修复了节点运行报错问题，修复了一些已知的BUG
|
||
>
|
||
> 2. 修改Lora堆节点，可以直接在节点操作Lora堆
|
||
>
|
||
|
||
> 0.0.38 公测版本介绍 2025-04-14
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 新增节点 仅Lora堆 节点
|
||
>
|
||
> 3. 优化Lora管理器，在UI主界面增加Lora管理器的快捷窗口
|
||
>
|
||
> 4. 在节点中增加了Lora堆的快捷按钮，点击即可直接显示节点的Lora堆信息可以快捷修改
|
||
>
|
||
|
||
> 0.0.37 公测版本介绍 2025-04-13
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 优化了Lora管理器卡顿问题
|
||
>
|
||
> 3. Lora详情中增加了基础模型显示和Lora Raw数据显示
|
||
>
|
||
> 4. 增加了Tag操作提示
|
||
>
|
||
> 5. 在悬浮球增加了图片转换功能
|
||
>
|
||
|
||
> 0.0.36 公测版本介绍 2025-04-08
|
||
>
|
||
> 1. 修复了一些已知的BUG
|
||
>
|
||
> 2. 优化了补全功能的精准度
|
||
>
|
||
|
||
> 0.0.35 公测版本介绍 2025-04-07
|
||
>
|
||
> 1. 新增功能可以隐藏Lora和隐藏Tag的功能，可以临时屏蔽你想要的Lora和Tag
|
||
>
|
||
|
||
> 0.0.34 公测版本介绍 2025-04-06
|
||
>
|
||
> 1. 修复了历史记录不会记录的问题
|
||
>
|
||
|
||
> 0.0.33 公测版本介绍 2025-04-04
|
||
>
|
||
> 1. 修复收藏和历史记录的请求错误问题
|
||
>
|
||
|
||
> 0.0.32 公测版本介绍 2025-04-03
|
||
>
|
||
> 1. **再次修复该问题-问题已被解决** 修复旧数据迁移不会将自己加的数据迁入问题，大家可以去```user_data_old```这个目录将数据文件名称修改成```userdatas_zh_CN.db```再返回文件夹```user_data```将该文件夹文件都删除，然后将修改名称为```userdatas_zh_CN.db```粘贴到此文件夹启动Comfyui即可再次迁移数据！
|
||
>
|
||
|
||
|
||
> 0.0.31 公测版本介绍 2025-04-02
|
||
>
|
||
> 1. 新增换行符显示，以及换行之后Tag显示也会跟着换行
|
||
>
|
||
> 2. 修复旧数据迁移不会将自己加的数据迁入问题，大家可以去```user_data_old```这个目录将数据文件名称修改成```userdatas_zh_CN.db```再返回文件夹```user_data```将该文件夹文件都删除，然后将修改名称为```userdatas_zh_CN.db```粘贴到此文件夹启动Comfyui即可再次迁移数据！
|
||
>
|
||
|
||
> 0.0.30 公测版本介绍 2025-04-01
|
||
>
|
||
> 1. 修复Tag在编辑的时候移动问题
|
||
>
|
||
> 2. 新增了云仓库！大家可以使用云仓库动态获取提示词或者更新Danbooru了，在UI界面“共享云数据”中打开！
|
||
>
|
||
> 3. 优化性能问题
|
||
>
|
||
> 4. 修复了一些已知的BUG
|
||
|
||
> 0.0.28 公测版本介绍 2025-03-31
|
||
>
|
||
> 1. 修改了全新的数据库拉取方式已经公开了仓库：[WeiLin-Comfyui-Tools-Prompt](https://github.com/weilin9999/WeiLin-Comfyui-Tools-Prompt)，有兴趣的伙伴可以查看怎么添加自己的tag或者danbooru
|
||
>
|
||
> 2. 优化了自动补全的功能
|
||
|
||
> 0.0.27 公测版本介绍 2025-03-30
|
||
>
|
||
> 1. 搜索Tag时有高亮，同时可以选择自动添加搜索的Tag到提示词中
|
||
>
|
||
> 2. 修改Lora详细页面中的提示词增加了隐藏和展开的功能
|
||
>
|
||
> 3. 修改Tag编辑的操作无处的方法，增加了一个编辑模式选择
|
||
|
||
> 0.0.26 公测版本介绍：2025-03-27
|
||
>
|
||
> 1. 修改了提示词默认自动加入逗号
|
||
>
|
||
> 2. 修改测试翻译错误的提示，以免误导
|
||
>
|
||
> 3. 隐藏Lora框，让节点更干净
|
||
|
||
> 0.0.24 2025-03-25 公测版本介绍
|
||
>
|
||
> 1. 在UI设置中添加了翻译库功能，可以替换三方翻译使用翻译库功能，需要安装翻译库点击安装即可，使用方便翻译功能完善 -- v0.0.23 2025-03-24
|
||
>
|
||
> 2. 新增节点：不加载Lora，此节点没有Lora的信息框可以减小节点的大小 -- v0.0.23 2025-03-24
|
||
>
|
||
> 3. 修复历史记录不记录问题，修改收藏的名称不显示的问题 -- v0.0.23 2025-03-24
|
||
>
|
||
> 4. 修复Lora堆最后一个不删除问题 -- v0.0.23 2025-03-24
|
||
>
|
||
> 5. 优化Tag过多导致翻译超时或获取本地数据超时的问题 -- v0.0.23 2025-03-24
|
||
>
|
||
> 6. 修复悬浮球会跳动问题 -- v0.0.23 2025-03-24
|
||
>
|
||
> 7. 调整：悬浮最小大小为6，大小上线999999，悬浮球最大个数上限调整至100 -- v0.0.23 2025-03-24
|
||
>
|
||
> 8. 修复在Comfyui版本v0.3.27中插件无法正常使用问题 -- v0.0.24 2025-03-25
|
||
|
||
> 0.0.20 2025-03-18 公测版本介绍
|
||
>
|
||
> 1.修复已知的BUG
|
||
|
||
> 0.0.19 2025-03-17 公测版本介绍
|
||
>
|
||
> 1.拆分节点提示词和Lora的文本，更加直观
|
||
>
|
||
>2.新增Lora支持搜索的功能，更快找到自己想要的Lora
|
||
|
||
> 0.0.18 2025-03-03 公测版本介绍
|
||
>
|
||
> 1.新增节点列表（悬浮球中打开），可以快捷打开本节点所有的Node，不需要再放大节点找
|
||
|
||
|
||
> 0.0.17 公测版本介绍 2025-02-22
|
||
>
|
||
> 1.修复权重添加会删除其它括号类型的BUG
|
||
|
||
> 0.0.16 2025-02-14 公测版本介绍
|
||
>
|
||
> 1.节点修改，新增了clip节点输出
|
||
>
|
||
> 2.节点修改，新增了string内容输入合并
|
||
>
|
||
> 3.修复了已知BUG
|
||
>
|
||
> 4.修改了Tag的控制栏的括号加减问题
|
||
|
||
|
||
> 0.0.15 公测版本介绍
|
||
>
|
||
> 1.节点修改，新增了clip节点输出
|
||
>
|
||
> 2.节点修改，新增了string内容输入合并
|
||
|
||
|
||
> 0.0.13 公测版本介绍
|
||
>
|
||
> 1.修复了已知 BUG
|
||
>
|
||
> 2.新增功能-Lora 支持一键缓存所有 Lora 文件
|
||
>
|
||
> 3.新增功能-支持加载 Lora 的时候同时加载对应的 Lora 提示词（需要给 Lora 设置提示词才可生效！）
|
||
|
||
> 0.0.12 公测版本介绍
|
||
>
|
||
> 1.修复了已知 BUG
|
||
|
||
> 0.0.0.3 内测版本介绍
|
||
>
|
||
> 1.更新了 AI 对话功能
|
||
>
|
||
> 2.更新了 Danbooru 词库到 2024-11-30
|
||
>
|
||
> 3.将所有 tag 和词库都写入到数据库中，我们不再使用 json 文件来存储我们的 tag 和词库，因为数据太多检索起来太慢了
|
||
>
|
||
> 4.优化了性能
|
||
|
||
> 0.0.0.1 版本介绍 （由于本人工作原因空闲时间才有时间更新插件，见谅！在此非常感谢大家对本插件的支持！）
|
||
>
|
||
> 1. 上传插件 0.0.0.1 版本
|
||
|
||
</details>
|
||
|
||
# 概要说明
|
||
|
||
本项目可以让你在 ComfyUI 中快捷的使用提示词工具
|
||
如果你对本项目有兴趣赏一个 Star 吧！
|
||
|
||
## 标签预览图功能使用说明
|
||
=======
|
||
## 使用说明
|
||
>>>>>>> ae99690 (docs: rewrite README for tag preview image feature)
|
||
|
||
### 基本操作
|
||
|
||
1. 打开标签管理界面，选择任意分组
|
||
2. 点击标签卡片的缩略图区域（"生成"按钮），弹出参数配置对话框
|
||
3. 设置模型、尺寸、采样器等参数，点击"生成"
|
||
4. 等待生成完成，缩略图自动刷新显示
|
||
5. 鼠标悬停缩略图 200ms 查看原尺寸大图
|
||
|
||
### 重新生成
|
||
|
||
1. 鼠标悬停在已有预览图的缩略图上
|
||
2. 右上角出现刷新图标，点击弹出配置对话框
|
||
3. 修改参数后点击"重新生成"，旧图会被删除并重新生成
|
||
|
||
### 一键批量生成
|
||
|
||
1. 点击标签列表上方的"一键生成"按钮
|
||
2. 在弹出的对话框中配置生成参数
|
||
3. 对话框标题显示待生成的标签数量
|
||
4. 点击"开始生成"，实时进度条显示当前进度
|
||
5. 如需取消，点击"中止生成"按钮
|
||
|
||
### 生成参数
|
||
|
||
| 参数 | 说明 | 默认值 |
|
||
|------|------|--------|
|
||
| 模型 | 自动扫描 ComfyUI `models/checkpoints` 目录 | 第一个可用模型 |
|
||
| 尺寸 | 512×512 / 768×512 / 512×768 / 768×768 / 1024×1024 | 512×512 |
|
||
| 采样器 | KSampler 采样器 | euler |
|
||
| 调度器 | KSampler 调度器 | normal |
|
||
| 步数 | 1-50 | 20 |
|
||
| CFG | 1-20 | 7.0 |
|
||
| 种子 | -1 为随机 | -1 |
|
||
| 正向提示词 | 单张：`{标签文本}, masterpiece, best quality`；批量：`{text}` 模板替换 | - |
|
||
| 负向提示词 | 可自定义 | worst quality, low quality, nsfw |
|
||
|
||
## 技术架构
|
||
|
||
### 新增文件
|
||
|
||
```
|
||
app/server/prompt_api/
|
||
├── tag_image_manager.py # 标签预览图 CRUD（增删改查）
|
||
├── comfyui_workflow.py # ComfyUI 工作流构建、提交、轮询、下载
|
||
└── tag_image_queue.py # 异步任务队列（单 worker 顺序执行）
|
||
|
||
src/src/view/tag_manager/components/
|
||
├── GenerateImageDialog.vue # 单张生成/重新生成参数配置对话框
|
||
└── BatchGenerateDialog.vue # 批量生成参数配置对话框（含进度条）
|
||
```
|
||
|
||
### 修改文件
|
||
|
||
| 文件 | 变更内容 |
|
||
|------|----------|
|
||
| `app/server/dao/dao.py` | DB 迁移 V4：`tag_tags` 表新增 `image_path`、`image_status` 列 |
|
||
| `app/server/prompt_server.py` | 新增 8 个 API 路由 |
|
||
| `app/server/prompt_api/tags_manager.py` | `get_tag_tags` 返回 `t_uuid`、`image_path`、`image_status` |
|
||
| `src/src/api/tags.js` | 新增 7 个前端 API 方法 |
|
||
| `src/src/view/tag_manager/tag_index.vue` | 缩略图显示、悬停大图、生成/批量生成/中止按钮 |
|
||
|
||
### API 路由
|
||
|
||
| 方法 | 路由 | 说明 |
|
||
|------|------|------|
|
||
| POST | `/tag_image/options` | 获取生成选项（模型列表、采样器、调度器、尺寸预设） |
|
||
| POST | `/tag_image/generate` | 提交单个生成任务（支持 `regenerate` 标志） |
|
||
| POST | `/tag_image/batch_generate` | 批量提交生成任务 |
|
||
| POST | `/tag_image/cancel_all` | 取消所有任务 |
|
||
| POST | `/tag_image/status` | 按 task_id 查询任务状态 |
|
||
| GET | `/tag_image/status/{t_uuid}` | 按标签 UUID 查询任务状态（页面刷新恢复用） |
|
||
| GET | `/tag_image/{t_uuid}` | 获取预览图原图 |
|
||
| GET | `/tag_thumb/{t_uuid}` | 获取缩略图（120×120 WebP） |
|
||
|
||
### 存储结构
|
||
|
||
```
|
||
user_data/
|
||
├── tag_images/ # 原图（PNG/WebP）
|
||
└── tag_thumbs/ # 缩略图（120×120 WebP）
|
||
```
|
||
|
||
### 工作流程
|
||
|
||
```
|
||
用户点击生成 → API 入队 → Worker 出队 → 构建 Workflow → 提交 ComfyUI
|
||
→ 轮询 /api/history → 下载结果 → 保存原图+缩略图 → 更新 DB 状态
|
||
```
|
||
|
||
#### 提交代码
|
||
请克隆完整的仓库代码，提交代码时请测试一遍随后提交代码，等待我的审核确认后即可合并代码
|