README.ru.md

ComfyUI Prompt Assistant ✨ Помощник по промптам V2.0

简体中文 | English | 日本語 | 한국어 | Русский | 繁體中文

🎉🎉 Новая версия Помощника по промптам запущена! Больше функций, быстрее отклик! Оптимизировано для ComfyUI Node 2.0! 🎉🎉

Поддерживает вызов облачных API больших моделей и локальных моделей Ollama. Позволяет переводить промпты, Markdown-узлы и документацию узлов; включает функции улучшения промптов, описание изображений и видео, коллекции популярных тегов и историю. Универсальный плагин «все в одном»!

• Оптимизация и исправление запросов Ollama: Оптимизирована логика запросов Ollama с поддержкой интеллектуальной маршрутизации (base_url без /v1 использует Native API, с /v1 — OpenAI-совместимый API). Исправлены ошибки, при которых некоторые модели возвращали пустой контент из-за логики фильтрации потока.

📣 Обновления

[2026-04-21] 🔥 V2.0.6

Изменения:

• Обновление архитектуры V3: Полностью переработан бэкенд узлов для соответствия стандартам ComfyUI V3 API, что повысило стабильность и производительность.

Исправления:

• Исправление Video Caption: Исправлена проблема, при которой некоторые модели (например, Qwen3.5-Plus) ошибочно считались не поддерживающими анализ нескольких изображений. Добавлена интеллектуальная обрезка кадров.
• Оптимизация и исправление запросов Ollama: Оптимизирована логика запросов Ollama с поддержкой интеллектуальной маршрутизации (base_url без /v1 использует Native API, с /v1 — OpenAI-совместимый API). Исправлены ошибки, при которых некоторые модели возвращали пустой контент из-за логики фильтрации потока.
• Оптимизация регистрации в подграфах: Исправлена стабильность ассистента в узлах подграфов в режимах Node 2.0 (Vue) и LiteGraph.

V2.0.5

Изменения:

• Случайное зерно (Random Seed) узла: Добавлен единый виджет случайного зерна для всех узлов для реализации повторного выполнения, заменяющий старый механизм ключевого слова "[R]".

• Расширенная поддержка многоязычности интерфейса: Благодарим @rafek1241. Добавлена функция ui-i18n, в настоящее время поддерживаются (китайский, английский, японский, корейский, французский, испанский, русский, немецкий и др.).

Исправления:

• Блокировка ширины узла: Исправлена проблема в Node 2.0, из-за которой невозможно было изменить ширину узла.

• Отключение поля baseUrl для стандартных провайдеров: Предотвращено случайное изменение URL встроенных сервисов во избежание сбоев запросов.

• Ошибки сетевого исключения: Исправлен баг сетевого исключения для запросов через прокси (например, xflow), вызванный логикой принудительного прямого соединения.

• Иконка ✨ узла изображения перемещена: Иконка перемещена на правую сторону для предотвращения перекрытия с ID узла в Node 2.0.

V2.0.4

• Исправление багов: Исправлены проблемы, из-за которых функции тегов и истории были недоступны.

V2.0.3

• Интерфейс помощника: Исправлена нестабильность создания помощника в подграфах и случаи, когда помощник не появлялся на узлах изображений при отсутствии картинки.

• Ollama: Исправлены ошибки HTTP 502, вызванные настройками прокси.

V2.0.2

• Модуль тегов: Исправлены проблемы с форматированием; теперь можно свободно создавать категории и управлять тегами. Исправлены ошибки создания и переноса пресетов.

• Интерфейс помощника: Оптимизированы методы монтирования в Node 2.0, исправлены проблемы со стабильностью в подграфах и повышена производительность.

• Взаимодействие: Добавлены эффекты потокового ввода и улучшены детали интерфейса.

• Перевод: Добавлены параметры правил перевода для смешанных языков (по умолчанию китайский/английский) и улучшен перевод документации узлов.

• Встроенные правила: Исправлены проблемы со смешанным выводом китайского/английского и отсутствием перевода Kontext.

• API-запросы: Исправлены проблемы с запросами Gemini-1.5-Pro и ошибки Ollama 404.

• Оптимизация узлов: Улучшен узел описания видео (Video Caption).

• Логи консоли: Оптимизированы логи и исправлен баг бесконечного цикла в логах прогресса.

V2.0.0

• Полное переосмысление: Помощник полностью переписан для повышения стабильности и скорости отклика при работе с API/Ollama.

• Обновление UI: Переписаны фронтенд-компоненты для лучшей стабильности и поддержки Node 2.0, включая настраиваемые позиции и сортировку кнопок.

• Модуль тегов: Новый механизм тегов на базе CSV с возможностью переключения «на лету» и функцией коллекций.

• Модуль правил: Новое окно конфигурации с поддержкой категорий и кастомным отображением правил; добавлено множество встроенных правил.

• API-сервис: Новый UI конфигурации API с поддержкой кастомных провайдеров и возможностью отката на несколько моделей. Независимый выбор сервиса для улучшения, перевода и описания.

• Переработка узлов: Все узлы переписаны с поддержкой многоязычности. Добавлен узел описания видео (Beta).

• Миграция: Конфиги пользователей перенесены в \user\default\prompt-assistant для предотвращения потери данных при переустановке.

• Новые функции: Перевод документации узлов и перевод узлов Markdown.

V1.x.x

V1.2.x

[12.11.2025] V1.2.3

• Исправлена проблема пустого результата при использовании Ollama и пользовательских сервисов.
• Ollama теперь использует нативный API для поддержки qwen3vl.
• Добавлен HTTP API как резервный вариант.

[14.10.2025] V1.2.2

• Удален код совместимости; версии ComfyUI < 0.3.27 больше не поддерживаются во избежание проблем с UI.
• Исправлены ошибки при расширении промптов/переводе через 302.ai и сбои автовыгрузки Ollama.
• Добавлены независимые опции выгрузки Ollama для узлов.
• Убран принудительный прямой коннект для LLM/VLM во избежание ошибок; опция добавлена в настройки.
• Оптимизирован формат логирования в консоли.

[14.10.2025] V1.2.1

• Улучшена скорость отклика интерфейса.
• Усилен механизм повторных API запросов.
• Добавлены настройки: перевод пунктуации, удаление лишних пробелов/точек.
• Окно тегов теперь запоминает размер, последнюю категорию и позицию прокрутки.
• В окне настроек API появилась функция автополучения списка моделей.
• Опция автоматической выгрузки VRAM для Ollama.
• Исправлен баг, из-за которого помощники не создавались в режиме списка.

[16.09.2025] V1.2.0

• Добавлен узел Prompt Expand (Расширение промптов).
• Добавлена поддержка 302.AI и Ollama.
• Панель тегов обзавелась функцией памяти.
• Меню по правому клику для быстрого переключения сервисов.
• Выключение CoT для популярных моделей.
• Оптимизированы узлы распознавания и перевода.
• Появился значок обратной связи.
• Исправлены баги с меню.
• Ошибка вырезания base_url.

V1.1.x

[28.08.2025] V1.1.3

• Оптимизирован UI: автоматическое избегание полос прокрутки.
• Исправлена проблема с прокруткой в окне тегов.

[23.08.2025] V1.1.2

• Рефакторинг узлов.
• Добавлены параметры моделей в окно API.
• Упрощен процесс распознавания изображений.
• Ошибка поиска не загруженных тегов.

[10.08.2025] V1.1.1

• Исправлены ошибки в узле распознавания изображений.

[10.08.2025] V1.1.0

• Изменения в UI.
• Поддержка совместимых API.
• Поддержка пользовательских правил и тегов.
• Узлы: Распознавание, контекст, перевод.

V1.0.x

[24.06.2025] V1.0.6

• Исправлены баги.

[24.06.2025] V1.0.5

• Исправлены графические глитчи помощника.
• Ошибка 500 для Zhipu.
• Сбои загрузки воркфлоу.
• Ошибка зависания с AIGODLIKE-COMFYUI-TRANSLATION.
• Изменяемый размер панели.
• Оптимизация загрузки UI.

[24.06.2025] V1.0.3

• Рефакторинг сервиса API.
• Изменен механизм сохранения настроек.
• Мелкие баги.

[21.06.2025] V1.0.2

• Мелкие баги.

[15.06.2025] V1.0.0

• Вставка тега в один клик.
• Расширение через LLM.
• Переключение Baidu и LLM.
• Перевод изображения в промпт.
• История, отмена и повтор.

✨ Возможности

💡 Оптимизация промптов + Перевод

Поддержка нескольких наборов правил (улучшение, команды qwen-edit, kontext и др.) Автоматический перевод между китайским и английским без необходимости выбора целевого языка. Встроенное кэширование для точности смысла.

🖼 Описание изображений

Быстрое получение промпта из изображения прямо в узле. Поддержка китайского/английского и различных стилей (Natural, Tag и др.).

🔖 Теги, пресеты фраз и коллекции

Сбор популярных тегов, фраз и триггеров Lora для быстрой вставки. Поддержка коллекций, кастомной сортировки и переключения между наборами.

🕐 История, Отмена, Повтор

Запись изменений по предложениям (срабатывает при потере фокуса). Поддержка отмены/повтора и просмотр истории между узлами.

📜 Перевод Markdown и документации узлов

Перевод узлов Note и Markdown с сохранением форматирования.

Перевод документации узлов (Beta: кнопка появляется только для узлов с документацией на английском).

📒 Руководство по узлам

Категория: ✨Prompt Assistant

🔹 Узел перевода

✨Prompt Assistant → Prompt Translation

🔹 Узел оптимизации промптов

✨Prompt Assistant → Prompt Optimization

🔹 Узел описания изображений

✨Prompt Assistant → Image Caption Prompt Описывает изображения и оптимизирует инструкции для редактирования с помощью визуальных моделей.

🔹 Узел описания видео

✨Prompt Assistant → Video Caption Prompt

📦 Установка

⚠️ Предупреждение о миграции

Если вы устанавливали Prompt Assistant версии ниже V2.0.0, пожалуйста, сделайте бэкап папки "config" в директории плагина во избежание потери API-ключей, кастомных правил и тегов!

Если вы устанавливали через Manager, просто обновитесь. Для ручной установки рекомендуется удалить старую папку плагина (сначала бэкап "config"!!), поместить новую папку в custom_nodes и восстановить файлы конфигурации.

Установка через ComfyUI 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 ⚠️ Примечание: рекомендуется переименовать папку в "prompt-assistant" для совместимости с ComfyUI.

Миграция данных

Новая версия автоматически обновляет и переносит API-конфиги, кастомные правила и теги. Вы можете поместить файлы для переноса в prompt-assistant/config. Новые конфиги хранятся в ComfyUI\user\default\prompt-assistant.

⚙️ Настройка

Настройка API-ключей и моделей

Описание сервисов

Вы можете добавить своих провайдеров или использовать встроенных. ⚠️ Отказ от ответственности: Этот плагин является инструментом для API-вызовов; ответственность за сторонние сервисы лежит на их владельцах. Конфиги пользователей хранятся локально.

• Baidu Translate (MT): Портал Baidu Translate Быстро, но качество среднее. Может потребоваться специальная настройка сети; 5 млн знаков бесплатно в месяц.
• Zhipu (LLM): Портал Zhipu API Высокая скорость и отсутствие лимитов; Примечание: строгая цензура может приводить к пустым результатам.
• xFlow-API Aggregation: Портал xFlow API Агрегирует различные модели (Gemini, Grok, ChatGPT...) с единым API-ключом; нет проблем с сетевым доступом.

🎀 Благодарности

Особая благодарность нашему сообществу за шаблоны правил V2.0.0: Adan, CJL, Normandy