Skip to content

Latest commit

 

History

History
362 lines (241 loc) · 17.8 KB

File metadata and controls

362 lines (241 loc) · 17.8 KB

ComfyUI Prompt Assistant ✨ 프롬프트 어시스턴트 V2.0

GitHub Repo stars bilibili weChat bug

🎉🎉 새로운 버전의 프롬프트 어시스턴트가 출시되었습니다! 기능은 강력해지고 응답은 더 빨라졌습니다! ComfyUI Node 2.0 지원! 🎉🎉

클라우드 대규모 모델 API 및 로컬 Ollama 모델 호출을 지원합니다. 프롬프트 노드, Markdown 노드, 노드 문서 번역; 프롬프트 최적화, 이미지 및 비디오 캡션; 자주 사용하는 태그 즐겨찾기, 히스토리 기록 등 기능을 제공합니다. 올인원 프롬프트 어시스턴트 플러그인입니다!

📣 업데이트

[2026-04-21] 🔥 V2.0.6

변경 사항:

  • V3 아키텍처 업그레이드: 노드 백엔드를 ComfyUI V3 API 표준에 맞춰 완전히 리팩토링하여 안정성과 성능을 향상시켰습니다.

수정 사항:

  • 비디오 역추론 오류 수정: 일부 모델(예: Qwen3.5-Plus)이 다중 이미지 분석을 지원하지 않는 것으로 오해받던 오류 수정. 지능형 프레임 제한 추론 및 자동 절단 기능 추가.
  • Ollama 요청 최적화 및 수정: Ollama 요청 로직을 최적화하여 스마트 라우팅(base_url/v1이 없으면 네이티브 API, 있으면 OpenAI 호환 API)을 지원합니다. 또한 스트리밍 필터링 로직으로 인해 일부 모델이 빈 내용을 반환하여 충돌하는 오류를 수정했습니다.
  • 서브그래프 마운트 최적화: Node 2.0 (Vue) 및 LiteGraph 모드에서 서브그래프 노드의 어시스턴트 안정성 문제 수정.
V2.0.5

Changes:

  • 노드 랜덤 시드: 모든 노드에 통합된 랜덤 시드 위젯을 추가하여 노드 실행의 반복성을 구현했습니다. 기존의 트리거 키워드 "[R]" 실행 방식은 제거되었습니다.

  • 프론트엔드 UI 다국어 지원 강화: @rafek1241님께 감사드립니다. ui-i18n 기능을 추가하여 현재 (중국어, 영어, 일본어, 한국어, 프랑스어, 스페인어, 러시아어, 독일어 등)를 지원합니다.

Fixes:

  • Ollama 요청 최적화 및 수정: Ollama 요청 로직을 최적화하여 스마트 라우팅(base_url/v1이 없으면 네이티브 API, 있으면 OpenAI 호환 API)을 지원합니다. 또한 스트리밍 필터링 로직으로 인해 일부 모델이 빈 내용을 반환하여 충돌하는 오류를 수정했습니다.
V2.0.4
  • 버그 수정: 태그 및 기록 기능을 사용할 수 없던 문제를 수정했습니다.
V2.0.3
  • 어시스턴트 UI: 서브그래프에서 어시스턴트 생성의 불안정함과 이미지 노드에 이미지가 없을 때 생성되지 않던 문제를 수정했습니다.

  • Ollama: 프록시 설정으로 인한 HTTP 502 오류를 수정했습니다.

V2.0.2
  • 태그 모듈: 포맷 문제를 수정하여 자유롭게 카테고리를 생성하고 태그를 관리할 수 있게 되었습니다. 프리셋 생성 및 마이그레이션 오류를 수정했습니다.

  • 어시스턴트 UI: Node 2.0 마운트 방식을 최적화하고, 서브그래프 생성 및 불안정성 문제를 해결하여 성능을 향상시켰습니다.

  • 상호작용 최적화: 요청 중 스트리밍 입력 효과를 추가하고 UI 세부 사항을 개선했습니다.

  • 번역 모듈: 혼합 언어 번역 규칙 매개변수(기본 중국어/영어 설정)를 추가하고 노드 문서 번역을 개편했습니다.

  • 내장 규칙: 일부 규칙에서 발생하는 중/영 혼합 문제와 Kontext 출력 번역 누락 등을 수정했습니다.

  • API 요청: Gemini-1.5-Pro 요청 문제 및 Ollama 404 오류를 수정했습니다.

  • 노드 최적화: 비디오 캡션 노드를 개선했습니다.

  • 콘솔 로그: 로그 출력을 최적화하고 진행 로그 무한 루프 버그를 수정했습니다.

V2.0.0
  • 핵심 리팩토링: 어시스턴트의 API 및 Ollama 호출 안정성과 응답 속도를 대폭 개선했습니다.

  • UI 개선: 프론트엔드 구성 요소를 재구축하여 안정성을 높였으며, Node 2.0 모드를 지원하여 위치 커스텀 및 버튼 정렬이 가능해졌습니다.

  • 태그 모듈 최적화: 새로운 CSV 기반 태그 방식. 여러 CSV 간 전환과 즐겨찾기 기능을 지원합니다.

  • 규칙 모듈 최적화: 새로운 설정 창, 카테고리화, 규칙 표시 위치 설정 등을 지원하며 다양한 프리셋 규칙을 추가했습니다.

  • API 서비스 최적화: 새로운 API 설정 UI. 커스텀 서비스와 멀티 모델 백업을 지원합니다. 최적화, 번역, 캡션 작업에 독립적으로 서비스를 지정할 수 있습니다.

  • 노드 리뉴얼: 모든 노드를 다국어 지원으로 재구축했습니다. 비디오 캡션 노드(Beta)를 추가했습니다.

  • 마이그레이션: 사용자 구성을 \user\default\prompt-assistant로 이동하여 재설치 시 데이터 손실을 방지했습니다.

  • 신규 기능: 노드 문서 번역 및 Markdown 노드 번역 추가.

V1.x.x
V1.2.x
[2025-11-12] V1.2.3
  • Ollama 및 사용자 지정 서비스 사용 시 빈 결과가 반환되는 문제를 수정했습니다.
  • Ollama는 qwen3vl 지원을 개선하기 위해 네이티브 API를 사용합니다.
  • 요청 예외를 방지하기 위해 HTTP API 폴백을 추가했습니다.
[2025-10-14] V1.2.2
  • 호환성 코드를 제거했으며, ComfyUI 0.3.27 미만 버전은 더 이상 지원되지 않습니다.
  • 302.ai 서비스로 프롬프트 확장 및 번역 시 발생하는 오류와 Ollama의 자동 언로드 실패 문제를 수정했습니다.
  • 모든 노드에 독립적인 Ollama 언로드 옵션을 추가했습니다.
  • 드문 요청 오류를 방지하기 위해 LLM/VLM에 대한 강제 직접 연결 파라미터를 제거하고, 설정에 직접 연결 옵션을 추가했습니다.
  • 콘솔 로그 출력 형식을 보다 직관적으로 최적화했습니다.
[2025-10-14] V1.2.1
  • 어시스턴트 UI 반응 속도를 향상했습니다.
  • API 요청 재시도 메커니즘을 강화했습니다.
  • 구두점 번역, 불필요한 공백/연속 마침표 자동 제거, 줄바꿈 유지 옵션을 설정에 추가했습니다.
  • 태그 창 크기, 마지막 선택 카테고리, 태그 바 스크롤 위치를 기억하도록 개선했습니다.
  • API 설정 화면에 모델 목록 자동 가져오기 기능을 추가했습니다.
  • Ollama 자동 VRAM 언로드 옵션을 추가했습니다.
  • 리스트 뷰에서 노드를 미리 볼 때 각 텍스트 상자에 어시스턴트를 생성할 수 없던 버그를 수정했습니다.
[2025-09-16] V1.2.0
  • 프롬프트 확장 노드를 추가했습니다.
  • 302.AI 및 Ollama 서비스를 추가했습니다.
  • 태그 패널에 메모리 기능을 추가했습니다.
  • 우클릭 메뉴를 통한 빠른 서비스 전환 기능을 추가했습니다.
  • 일부 주류 모델에서 CoT(생각의 사슬) 비활성화를 지원합니다.
  • 캡션 및 번역 노드를 최적화했습니다.
  • 커뮤니티 피드백 배지를 추가했습니다.
  • 드롭다운 메뉴 버그를 수정했습니다.
  • 검색된 태그를 패널에서 삽입할 수 없던 버그를 수정했습니다.
  • 간혹 요청 오류를 일으키던 base_url 자르기 오류를 수정했습니다.
V1.1.x
[2025-08-28] V1.1.3
  • 스크롤바를 자동으로 피하여 우발적인 터치 중복을 방지하도록 UI를 최적화했습니다.
  • 태그 팝업에 스크롤바가 생기지 않아 내용이 잘리던 문제를 수정했습니다.
[2025-08-23] V1.1.2
  • 실행 중 다중 대기열 및 중복 실행 문제를 해결하기 위해 노드를 리팩터링했습니다.
  • API 설정 화면에 모델 파라미터를 추가했습니다 (최대 토큰 수를 조절하여 일부 오류를 해결할 수 있습니다).
  • 이미지 캡션 워크플로를 간소화하여 속도를 높였습니다.
  • 태그 지연 로딩 시 로딩되지 않은 태그를 검색할 수 없던 문제를 수정했습니다.
[2025-08-10] V1.1.1
  • 이미지 캡션 노드 오류를 수정했습니다.
[2025-08-10] V1.1.0
  • UI 상호 작용을 수정했습니다.
  • OpenAI SDK 호환 API를 모두 지원합니다.
  • 사용자 지정 규칙을 추가했습니다.
  • 사용자 지정 태그를 추가했습니다.
  • 이미지 캡션, Kontext 프리셋 및 번역 노드를 추가했습니다.
V1.0.x
[2025-06-24] V1.0.6
  • 몇 가지 UI 버그를 수정했습니다.
[2025-06-24] V1.0.5
  • 선택 도구 모음으로 Kontext 노드 생성 시 어시스턴트 UI 이상을 수정했습니다.
  • 네트워크 문제로 인한 Zhipu 서비스 장애를 수정했습니다.
  • 인스턴스 지우기 오류로 인한 워크플로 로드 실패를 수정했습니다.
  • AIGODLIKE-COMFYUI-TRANSLATION 플러그인과 충돌하여 태그 일시 정지 현상을 수정했습니다.
  • 크기 조절이 가능한 태그 패널을 추가했습니다.
  • UI 리소스 로드 메커니즘을 최적화했습니다.
[2025-06-24] V1.0.3
  • API 키가 노출되는 것을 방지하기 위해 API 서비스를 리팩터링했습니다.
  • 설정이 저장되지 않던 문제를 해결하기 위해 저장/로드 메커니즘을 수정했습니다.
  • 사소한 버그를 수정했습니다.
[2025-06-21] V1.0.2
  • 사소한 버그를 수정했습니다.
[2025-06-15] V1.0.0
  • 원클릭 태그 삽입.
  • LLM 프롬프트 확장 지원.
  • Baidu 번역과 LLM 번역 전환 지원.
  • 이미지 캡션 기능.
  • 기록, 실행 취소, 다시 실행.

✨ 기능 소개

💡 프롬프트 최적화 + 번역

다양한 프롬프트 최적화 규칙(Expand, Qwen-edit 명령, Kontext 최적화 및 번역 등) 지원 목표 언어 설정 불필요. 국/영 자동 상호 번역 및 번역 캐싱 기능으로 원문 변질 방지.

번역최적화

🖼 이미지 캡션

이미지 노드에서 이미지를 프롬프트로 빠르게 추출. 중/영 지원 및 다양한 스타일(자연어, 태그 방식 등) 선택 가능.

캡션

🔖 태그, 문구 프리셋 및 즐겨찾기

자주 사용하는 태그, 문구, Lora 트리거를 수집하여 빠르게 삽입. 즐겨찾기, 커스텀 정렬, 멀티 세트 전환 지원.

태그기능

🕐 히스토리, 실행 취소, 다시 실행

문장 단위 기록(입력창 포커스 아웃 시 기록). 실행 취소/다시 실행 및 노드 간 히스토리 조회 지원.

히스토리

📜 Markdown 및 노드 문서 번역

Note 노드와 Markdown 노드의 서식을 유지하며 번역.

Markdown 노드 문서 번역 지원 (Beta: 영어 문서가 있는 노드에만 번역 버튼 노출).

NodeDoc

📒 노드 소개

카테고리: ✨Prompt Assistant

🔹 번역 노드

✨Prompt Assistant → 프롬프트 번역 번역 노드

🔹 프롬프트 최적화 노드

✨Prompt Assistant → 프롬프트 최적화 최적화 노드

🔹 이미지 캡션 노드

✨Prompt Assistant → 이미지 캡션 프롬프트 이미지를 분석하여 캡션을 생성하고 비각 모델을 연동하여 편집 지침을 최적화합니다. 이미지 캡션 노드 시각 지원 편집 모델

🔹 비디오 캡션 노드

✨Prompt Assistant → 비디오 캡션 프롬프트 비디오 캡션 노드 프레임 피커 도구

📦 설치 방법

⚠️ 기존 버전 마이그레이션 안내

Prompt Assistant V2.0.0 이전 버전을 사용 중이신 경우, API 설정, 커스텀 규칙, 태그 데이터 유실 방지를 위해 기존 플러그인 폴더의 'config' 폴더를 반드시 백업해 주세요.

Manager를 통해 설치하신 경우 바로 업데이트하시면 됩니다. 수동 설치의 경우 기존 폴더 삭제 후(config 백업 필수!!), 새 폴더를 custom_nodes에 넣고 config 파일을 복구하는 것을 권장합니다.

ComfyUI Manager를 통한 설치

Manager에서 Prompt Assistant를 검색하여 Install을 클릭하세요.

설치

저장소 복제

  1. ComfyUI 커스텀 노드 폴더로 이동:
    cd ComfyUI/custom_nodes
  2. 저장소 복제:
    git clone https://github.com/yawiii/ComfyUI-Prompt-Assistant.git
  3. ComfyUI 재시작.

Zip 다운로드

  1. 릴리스에서 최신 버전 다운로드
  2. ComfyUI/custom_nodes에 압축 해제 ⚠️ 참고: ComfyUI 표준에 맞게 폴더 이름을 "prompt-assistant"로 변경하는 것을 권장합니다.
GiHub 설치

데이터 자동 마이그레이션

새 버전은 API 설정, 커스텀 규칙, 태그를 자동으로 마이그레이션합니다. 마이그레이션할 파일을 prompt-assistant/config에 넣어주세요. 설정 파일은 ComfyUI\user\default\prompt-assistant에 저장됩니다.

마이그레이션

⚙️ 설정 안내

API 키 및 모델 설정

설정 페이지 API 창

서비스 설명

커스텀 제공업체를 추가하거나 내장 서비스 중에서 선택할 수 있습니다. ⚠️ 면책 조항: 본 플러그인은 API 호출 도구만을 제공하며, 제3자 서비스에 대한 책임은 지지 않습니다. 사용자 설정은 로컬에 저장됩니다.

  • Baidu Translate (MT): Baidu 번역 신청 속도는 빠르나 품질은 보통입니다. 네트워크 환경에 따라 오류가 발생할 수 있습니다 (월 500만 자 무료).
  • Zhipu (LLM): Zhipu API 신청 고속 및 무제한 할당량; 참고: 엄격한 검열로 인해 빈 결과가 반환될 수 있습니다.
  • xFlow-API Aggregation: xFlow API 신청 다양한 모델(Gemini, Grok, ChatGPT...)을 단일 API 키로 이용 가능하며 네트워크 이슈로부터 자유롭습니다.

🎀 도움을 주신 분들

V2.0.0 규칙 템플릿에 도움을 주신 커뮤니티 분들께 감사드립니다: Adan, CJL, Normandy