ComfyUI Prompt Assistant ✨ Помощник по промптам V2.0
[简体中文](README.md) | [English](README.en.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [繁體中文](README.zh-TW.md)
🎉🎉 Новая версия Помощника по промптам запущена! Больше функций, быстрее отклик! Оптимизировано для 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:
```bash
cd ComfyUI/custom_nodes
```
2. Клонируйте репозиторий:
```bash
git clone https://github.com/yawiii/ComfyUI-Prompt-Assistant.git
```
3. Перезапустите ComfyUI.
#### **Загрузка Zip-архива**
1. Скачайте последнюю версию из [Релизов](https://github.com/yawiii/comfyui_prompt_assistant/releases)
2. Распакуйте в `ComfyUI/custom_nodes`
`⚠️ Примечание: рекомендуется переименовать папку в "prompt-assistant" для совместимости с ComfyUI.`
### Миграция данных
Новая версия автоматически обновляет и переносит API-конфиги, кастомные правила и теги. Вы можете поместить файлы для переноса в `prompt-assistant/config`. Новые конфиги хранятся в `ComfyUI\user\default\prompt-assistant`.
## **⚙️ Настройка**
### Настройка API-ключей и моделей
### Описание сервисов
Вы можете добавить своих провайдеров или использовать встроенных.
`⚠️ Отказ от ответственности: Этот плагин является инструментом для API-вызовов; ответственность за сторонние сервисы лежит на их владельцах. Конфиги пользователей хранятся локально.`
* **Baidu Translate (MT)**: [Портал Baidu Translate](https://fanyi-api.baidu.com/product/11)
`Быстро, но качество среднее. Может потребоваться специальная настройка сети; 5 млн знаков бесплатно в месяц.`
* **Zhipu (LLM)**: [Портал Zhipu API](https://www.bigmodel.cn/invite?icode=Wz1tQAT40T9M8vwp%2F1db7nHEaazDlIZGj9HxftzTbt4%3D)
`Высокая скорость и отсутствие лимитов; Примечание: строгая цензура может приводить к пустым результатам.`
* **xFlow-API Aggregation**: [Портал xFlow API](https://api.xflow.cc/register?aff=Z063)
`Агрегирует различные модели (Gemini, Grok, ChatGPT...) с единым API-ключом; нет проблем с сетевым доступом.`
## **🎀 Благодарности**
Особая благодарность нашему сообществу за шаблоны правил V2.0.0: Adan, CJL, Normandy
