368 lines
23 KiB
Markdown
368 lines
23 KiB
Markdown
<div align="center">
|
||
|
||
<h1 align="center">ComfyUI Prompt Assistant ✨ Помощник по промптам V2.0</h1>
|
||
|
||
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/yawiii/ComfyUI-Prompt-Assistant">
|
||
<a href="https://space.bilibili.com/520680644"><img alt="bilibili" src="https://img.shields.io/badge/Подробные видеоинструкции-blue?style=flat&logo=bilibili&logoColor=2300A5DC&labelColor=%23FFFFFF&color=%2307A3D7"></a>
|
||
<a href="https://data.xflow.cc/wechat.png"><img alt="weChat" src="https://img.shields.io/badge/Присоединиться к сообществу-blue?logo=wechat&logoColor=green&labelColor=%23FFFFFF&color=%2307A3D7"></a>
|
||
<a href="https://ycn58r88iss5.feishu.cn/share/base/form/shrcnJ1AzbUJCynW9qrNJ2zPugy"><img alt="bug" src="https://img.shields.io/badge/Баг-Обратная связь-orange"></a>
|
||
|
||
</div>
|
||
|
||
<div align="center">
|
||
|
||
[简体中文](README.md) | [English](README.en.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [繁體中文](README.zh-TW.md)
|
||
|
||
</div>
|
||
|
||
<h4 align="center">🎉🎉 Новая версия Помощника по промптам запущена! Больше функций, быстрее отклик! Оптимизировано для ComfyUI Node 2.0! 🎉🎉</h4>
|
||
|
||
> Поддерживает вызов облачных API больших моделей и локальных моделей Ollama. Позволяет переводить промпты, Markdown-узлы и документацию узлов; включает функции улучшения промптов, описание изображений и видео, коллекции популярных тегов и историю. Универсальный плагин «все в одном»!
|
||
|
||
* **Оптимизация и исправление запросов Ollama**: Оптимизирована логика запросов Ollama с поддержкой интеллектуальной маршрутизации (`base_url` без `/v1` использует Native API, с `/v1` — OpenAI-совместимый API). Исправлены ошибки, при которых некоторые модели возвращали пустой контент из-за логики фильтрации потока.
|
||
|
||
## **📣 Обновления**
|
||
|
||
<details open>
|
||
<summary><strong>[2026-04-21] 🔥 V2.0.6</strong></summary>
|
||
|
||
**Изменения:**
|
||
* **Обновление архитектуры V3**: Полностью переработан бэкенд узлов для соответствия стандартам ComfyUI V3 API, что повысило стабильность и производительность.
|
||
|
||
**Исправления:**
|
||
* **Исправление Video Caption**: Исправлена проблема, при которой некоторые модели (например, Qwen3.5-Plus) ошибочно считались не поддерживающими анализ нескольких изображений. Добавлена интеллектуальная обрезка кадров.
|
||
* **Оптимизация и исправление запросов Ollama**: Оптимизирована логика запросов Ollama с поддержкой интеллектуальной маршрутизации (`base_url` без `/v1` использует Native API, с `/v1` — OpenAI-совместимый API). Исправлены ошибки, при которых некоторые модели возвращали пустой контент из-за логики фильтрации потока.
|
||
* **Оптимизация регистрации в подграфах**: Исправлена стабильность ассистента в узлах подграфов в режимах Node 2.0 (Vue) и LiteGraph.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V2.0.5</strong></summary>
|
||
|
||
**Изменения:**
|
||
|
||
* **Случайное зерно (Random Seed) узла**: Добавлен единый виджет случайного зерна для всех узлов для реализации повторного выполнения, заменяющий старый механизм ключевого слова "[R]".
|
||
|
||
|
||
* **Расширенная поддержка многоязычности интерфейса**: Благодарим @rafek1241. Добавлена функция ui-i18n, в настоящее время поддерживаются (китайский, английский, японский, корейский, французский, испанский, русский, немецкий и др.).
|
||
|
||
**Исправления:**
|
||
* **Блокировка ширины узла**: Исправлена проблема в Node 2.0, из-за которой невозможно было изменить ширину узла.
|
||
|
||
* **Отключение поля baseUrl для стандартных провайдеров**: Предотвращено случайное изменение URL встроенных сервисов во избежание сбоев запросов.
|
||
|
||
* **Ошибки сетевого исключения**: Исправлен баг сетевого исключения для запросов через прокси (например, xflow), вызванный логикой принудительного прямого соединения.
|
||
* **Иконка ✨ узла изображения перемещена**: Иконка перемещена на правую сторону для предотвращения перекрытия с ID узла в Node 2.0.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V2.0.4</strong></summary>
|
||
|
||
* **Исправление багов**: Исправлены проблемы, из-за которых функции тегов и истории были недоступны.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V2.0.3</strong></summary>
|
||
|
||
* **Интерфейс помощника**: Исправлена нестабильность создания помощника в подграфах и случаи, когда помощник не появлялся на узлах изображений при отсутствии картинки.
|
||
|
||
* **Ollama**: Исправлены ошибки HTTP 502, вызванные настройками прокси.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V2.0.2</strong></summary>
|
||
|
||
* **Модуль тегов**: Исправлены проблемы с форматированием; теперь можно свободно создавать категории и управлять тегами. Исправлены ошибки создания и переноса пресетов.
|
||
|
||
* **Интерфейс помощника**: Оптимизированы методы монтирования в Node 2.0, исправлены проблемы со стабильностью в подграфах и повышена производительность.
|
||
|
||
* **Взаимодействие**: Добавлены эффекты потокового ввода и улучшены детали интерфейса.
|
||
|
||
* **Перевод**: Добавлены параметры правил перевода для смешанных языков (по умолчанию китайский/английский) и улучшен перевод документации узлов.
|
||
|
||
* **Встроенные правила**: Исправлены проблемы со смешанным выводом китайского/английского и отсутствием перевода Kontext.
|
||
|
||
* **API-запросы**: Исправлены проблемы с запросами Gemini-1.5-Pro и ошибки Ollama 404.
|
||
|
||
* **Оптимизация узлов**: Улучшен узел описания видео (Video Caption).
|
||
|
||
* **Логи консоли**: Оптимизированы логи и исправлен баг бесконечного цикла в логах прогресса.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V2.0.0</strong></summary>
|
||
|
||
* **Полное переосмысление**: Помощник полностью переписан для повышения стабильности и скорости отклика при работе с API/Ollama.
|
||
|
||
* **Обновление UI**: Переписаны фронтенд-компоненты для лучшей стабильности и поддержки **Node 2.0**, включая настраиваемые позиции и сортировку кнопок.
|
||
|
||
* **Модуль тегов**: Новый механизм тегов на базе CSV с возможностью переключения «на лету» и функцией коллекций.
|
||
* **Модуль правил**: Новое окно конфигурации с поддержкой категорий и кастомным отображением правил; добавлено множество встроенных правил.
|
||
* **API-сервис**: Новый UI конфигурации API с поддержкой кастомных провайдеров и возможностью отката на несколько моделей. Независимый выбор сервиса для улучшения, перевода и описания.
|
||
* **Переработка узлов**: Все узлы переписаны с поддержкой многоязычности. Добавлен узел описания видео (**Beta**).
|
||
* **Миграция**: Конфиги пользователей перенесены в `\user\default\prompt-assistant` для предотвращения потери данных при переустановке.
|
||
* **Новые функции**: Перевод документации узлов и перевод узлов Markdown.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V1.x.x</strong></summary>
|
||
|
||
<details>
|
||
<summary><strong>V1.2.x </strong></summary>
|
||
|
||
<details>
|
||
<summary>[12.11.2025] V1.2.3 </summary>
|
||
|
||
* Исправлена проблема пустого результата при использовании Ollama и пользовательских сервисов.
|
||
* Ollama теперь использует нативный API для поддержки qwen3vl.
|
||
* Добавлен HTTP API как резервный вариант.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[14.10.2025] V1.2.2 </summary>
|
||
|
||
* Удален код совместимости; версии ComfyUI < 0.3.27 больше не поддерживаются во избежание проблем с UI.
|
||
* Исправлены ошибки при расширении промптов/переводе через 302.ai и сбои автовыгрузки Ollama.
|
||
* Добавлены независимые опции выгрузки Ollama для узлов.
|
||
* Убран принудительный прямой коннект для LLM/VLM во избежание ошибок; опция добавлена в настройки.
|
||
* Оптимизирован формат логирования в консоли.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[14.10.2025] V1.2.1 </summary>
|
||
|
||
* Улучшена скорость отклика интерфейса.
|
||
* Усилен механизм повторных API запросов.
|
||
* Добавлены настройки: перевод пунктуации, удаление лишних пробелов/точек.
|
||
* Окно тегов теперь запоминает размер, последнюю категорию и позицию прокрутки.
|
||
* В окне настроек API появилась функция автополучения списка моделей.
|
||
* Опция автоматической выгрузки VRAM для Ollama.
|
||
* Исправлен баг, из-за которого помощники не создавались в режиме списка.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[16.09.2025] V1.2.0 </summary>
|
||
|
||
* Добавлен узел Prompt Expand (Расширение промптов).
|
||
* Добавлена поддержка 302.AI и Ollama.
|
||
* Панель тегов обзавелась функцией памяти.
|
||
* Меню по правому клику для быстрого переключения сервисов.
|
||
* Выключение CoT для популярных моделей.
|
||
* Оптимизированы узлы распознавания и перевода.
|
||
* Появился значок обратной связи.
|
||
* Исправлены баги с меню.
|
||
* Ошибка вырезания base_url.
|
||
|
||
</details>
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V1.1.x </strong></summary>
|
||
|
||
<details>
|
||
<summary>[28.08.2025] V1.1.3 </summary>
|
||
|
||
* Оптимизирован UI: автоматическое избегание полос прокрутки.
|
||
* Исправлена проблема с прокруткой в окне тегов.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[23.08.2025] V1.1.2 </summary>
|
||
|
||
* Рефакторинг узлов.
|
||
* Добавлены параметры моделей в окно API.
|
||
* Упрощен процесс распознавания изображений.
|
||
* Ошибка поиска не загруженных тегов.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[10.08.2025] V1.1.1 </summary>
|
||
|
||
* Исправлены ошибки в узле распознавания изображений.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[10.08.2025] V1.1.0 </summary>
|
||
|
||
* Изменения в UI.
|
||
* Поддержка совместимых API.
|
||
* Поддержка пользовательских правил и тегов.
|
||
* Узлы: Распознавание, контекст, перевод.
|
||
|
||
</details>
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong>V1.0.x</strong> </summary>
|
||
|
||
<details>
|
||
<summary>[24.06.2025] V1.0.6</summary>
|
||
|
||
* Исправлены баги.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[24.06.2025] V1.0.5</summary>
|
||
|
||
* Исправлены графические глитчи помощника.
|
||
* Ошибка 500 для Zhipu.
|
||
* Сбои загрузки воркфлоу.
|
||
* Ошибка зависания с AIGODLIKE-COMFYUI-TRANSLATION.
|
||
* Изменяемый размер панели.
|
||
* Оптимизация загрузки UI.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[24.06.2025] V1.0.3</summary>
|
||
|
||
* Рефакторинг сервиса API.
|
||
* Изменен механизм сохранения настроек.
|
||
* Мелкие баги.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[21.06.2025] V1.0.2</summary>
|
||
|
||
* Мелкие баги.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>[15.06.2025] V1.0.0</summary>
|
||
|
||
* Вставка тега в один клик.
|
||
* Расширение через LLM.
|
||
* Переключение Baidu и LLM.
|
||
* Перевод изображения в промпт.
|
||
* История, отмена и повтор.
|
||
|
||
</details>
|
||
|
||
</details>
|
||
|
||
</details>
|
||
|
||
## **✨ Возможности**
|
||
|
||
#### 💡 Оптимизация промптов + Перевод
|
||
`Поддержка нескольких наборов правил (улучшение, команды qwen-edit, kontext и др.)`
|
||
`Автоматический перевод между китайским и английским без необходимости выбора целевого языка. Встроенное кэширование для точности смысла.`
|
||
|
||
|
||
|
||
#### 🖼 Описание изображений
|
||
`Быстрое получение промпта из изображения прямо в узле. Поддержка китайского/английского и различных стилей (Natural, Tag и др.).`
|
||
|
||
|
||
|
||
#### 🔖 Теги, пресеты фраз и коллекции
|
||
`Сбор популярных тегов, фраз и триггеров Lora для быстрой вставки. Поддержка коллекций, кастомной сортировки и переключения между наборами.`
|
||
|
||
|
||
|
||
#### 🕐 История, Отмена, Повтор
|
||
`Запись изменений по предложениям (срабатывает при потере фокуса). Поддержка отмены/повтора и просмотр истории между узлами.`
|
||
|
||
|
||
|
||
#### 📜 Перевод Markdown и документации узлов
|
||
`Перевод узлов Note и Markdown с сохранением форматирования.`
|
||
|
||
|
||
`Перевод документации узлов (Beta: кнопка появляется только для узлов с документацией на английском).`
|
||
|
||
|
||
|
||
### 📒 Руководство по узлам
|
||
Категория: `✨Prompt Assistant`
|
||
|
||
#### **🔹 Узел перевода**
|
||
`✨Prompt Assistant → Prompt Translation`
|
||
<img width="1700" height="700" alt="Узел перевода" src="https://github.com/user-attachments/assets/9dbc9fc9-1b91-43b6-822e-d598b2c8168f" />
|
||
|
||
#### **🔹 Узел оптимизации промптов**
|
||
`✨Prompt Assistant → Prompt Optimization`
|
||
<img width="1700" height="911" alt="Узел улучшения" src="https://github.com/user-attachments/assets/ea821506-d684-4526-9119-621bb0467ddf" />
|
||
|
||
#### **🔹 Узел описания изображений**
|
||
`✨Prompt Assistant → Image Caption Prompt`
|
||
`Описывает изображения и оптимизирует инструкции для редактирования с помощью визуальных моделей.`
|
||
<img width="1700" height="800" alt="Узел описания изображений" src="https://github.com/user-attachments/assets/8ff3ac96-724a-48d0-8e15-23fe0b28bec1" />
|
||
<img width="1700" height="800" alt="Инструкции VLM" src="https://github.com/user-attachments/assets/a95dc0f4-1d46-438f-a242-4087f6e8361a" />
|
||
|
||
#### **🔹 Узел описания видео**
|
||
`✨Prompt Assistant → Video Caption Prompt`
|
||
<img width="1700" height="1080" alt="Узел описания видео" src="https://github.com/user-attachments/assets/0143096b-24d5-4308-82ff-e0a99144db0b" />
|
||
<img width="1700" height="1102" alt="Инструмент выбора кадров" src="https://github.com/user-attachments/assets/96c2bd08-b26c-4df1-b32c-be8e20328c97" />
|
||
|
||
## **📦 Установка**
|
||
|
||
### ⚠️ Предупреждение о миграции
|
||
`Если вы устанавливали Prompt Assistant версии ниже V2.0.0, пожалуйста, сделайте бэкап папки "config" в директории плагина во избежание потери API-ключей, кастомных правил и тегов!`
|
||
|
||
Если вы устанавливали через **Manager**, просто обновитесь. Для ручной установки рекомендуется удалить старую папку плагина (сначала бэкап "config"!!), поместить новую папку в `custom_nodes` и восстановить файлы конфигурации.
|
||
|
||
#### **Установка через ComfyUI Manager**
|
||
Найдите `Prompt Assistant` в менеджере и нажмите `Install`.
|
||
|
||
<img width="1800" height="1098" alt="Установка" src="https://github.com/user-attachments/assets/167eb467-a77d-4a37-a95b-e935ca354284" />
|
||
|
||
#### **Клонирование репозитория**
|
||
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.`
|
||
|
||
<img width="600" height="276" alt="Установка с GitHub" src="https://github.com/user-attachments/assets/99783a78-6e0b-42aa-8f9e-7146ebcef5fd" />
|
||
|
||
### Миграция данных
|
||
Новая версия автоматически обновляет и переносит API-конфиги, кастомные правила и теги. Вы можете поместить файлы для переноса в `prompt-assistant/config`. Новые конфиги хранятся в `ComfyUI\user\default\prompt-assistant`.
|
||
|
||
<img width="600" height="419" alt="Миграция" src="https://github.com/user-attachments/assets/90b8f90f-51df-4537-b735-ae07c3cdff7f" />
|
||
|
||
## **⚙️ Настройка**
|
||
|
||
### Настройка API-ключей и моделей
|
||
<img width="1593" height="1119" alt="Страница конфигурации" src="https://github.com/user-attachments/assets/ea01c0bc-fe0f-40be-991c-d7833965213a" />
|
||
<img width="1569" height="1137" alt="Окно API" src="https://github.com/user-attachments/assets/9d982773-2939-480b-a691-bb89a227a9ff" />
|
||
|
||
### Описание сервисов
|
||
Вы можете добавить своих провайдеров или использовать встроенных.
|
||
`⚠️ Отказ от ответственности: Этот плагин является инструментом для 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
|