weilin9999/WeiLin-Comfyui-Tools

WeiLin‑ComfyUI‑Tools – 用于 ComfyUI 的标签管理扩展功能

功能说明

• 为 ComfyUI Tag Manager 中的每个标签卡片添加 120 × 120 的缩略图预览。
• 使用 ComfyUI 的内部队列 API 按需生成预览图（单个标签、重新生成或批量生成整个群组）。
• 鼠标悬停时会在浮动窗口中显示缩略图的大图，并允许取消所有待处理任务。
• 所有生成参数（模型、尺寸、采样器、步数、CFG、种子、正向/负向提示词）均会本地存储，无需每次重新输入。

运作原理

1. 前端 – Vue 组件（GenerateImageDialog.vue、BatchGenerateDialog.vue）让您配置生成设置并启动任务。
2. 后端 – 新的 API 路由（/tag_image/*）接收生成请求，将其放入异步队列（tag_image_queue.py），并驱动 ComfyUI 工作流（comfyui_workflow.py）。
3. 队列 – 单工作线程队列按顺序处理任务，轮询 ComfyUI 获取结果，下载输出图片，并将全尺寸图片与 120 × 120 WebP 缩略图存储至 user_data/tag_images/ 与 user_data/tag_thumbs/。
4. 数据库 – tag_tags 数据表现在包含 image_path 与 image_status 字段，以便 UI 显示当前的缩略图状态。
5. 恢复 – 若刷新页面，UI 会查询 /tag_image/status/{t_uuid} 以恢复队列状态。

主要特色

• 单标签生成 – 点击标签的空白缩略图，设置参数并生成。
• 重新生成 – 悬停于现有缩略图，点击刷新图标，调整设置并替换图片。
• 批量生成 – 一键生成群组内所有标签，并附带实时进度条。
• 全部取消 – 中止所有已排队或执行中的任务。
• 持久化设置 – 生成选项会自动本地存储。
• 浮动预览 – 悬停 200 ms 即可查看全尺寸图片。

适用对象 在 ComfyUI 中整理大量标签，并希望在不离开 UI 的情况下快速获取每个标签视觉提示的艺术家与提示词工程师。

安装注意事项

• 该插件目前处于内部测试阶段；作者建议加入官方 QQ 群（ID 905656521）以获取支持与更新。
• 适用于标准 ComfyUI 目录结构（模型位于 models/checkpoints）。
• 配套面板仓库（WeiLin‑Comfyui‑Tools‑panel）有助于从旧版本迁移提示词。

路线图 / 社区

• 持续的错误修复（通常每月 2‑5 次发布）。
• 开源提示词与 Danbooru 标签数据库托管于独立仓库（WeiLin‑Comfyui‑Tools‑Prompt）。
• 用户可直接在 GitHub 上提交问题或功能请求。

---

以上所有细节均直接取自仓库的 README；未添加任何额外推测。