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에서 직접 가져온 것이며, 추가적인 추측은 포함되지 않았습니다.