Extensions/TS Nodes Wizard
ComfyUI Extension

TS Nodes Wizard

Client-side Russian reference for ComfyUI nodes

By AlexYez·Created 2 months ago·Updated 7 days ago· 1
AlexYez/comfyui-ts-nodes-vizard
Nodes—
On cloudLocal install
Stars1
Updated7 days ago
Readme

TS Nodes Wizard

TS Nodes Wizard — встроенный русскоязычный справочник по нодам ComfyUI. Расширение добавляет пункт «Открыть в TS Nodes Wizard» в контекстное меню ноды и показывает связанную с ней статью: назначение, входы и выходы, практические замечания, примеры и готовые фрагменты workflow.

Версия пакета — 0.3.2, редакционный статус каталога — alpha. Каталог содержит 666 статей о серверных нодах для локальной работы, четыре системные frontend-only ноды, 82 действующие ноды comfyui-timesaver 12.12.3 и 11 архивных статей Image Studio, 7 нод comfyui-ts-cosyvoice и frontend-расширение comfyui-artius-browser — всего 771 статья. API- и dev-only ноды исключены из редакционного охвата. Человеческое утверждение и полное исполнение примеров ещё нужны.

На 3 октября 2026 сверена чистая установка ComfyUI 0.38.0 / frontend 1.53.6. Добавлены Ming Image Edit и четыре новые ноды TimeSaver; удалённая Image Studio сохранена в архиве. Переписаны 29 статей по изменениям и найденным неточностям. Структура, связи и подбор материалов проверены во всех 771 статьях, но это не полная ручная вычитка примерно 450 тысяч слов: оставшиеся тексты отмечены для последовательной редактуры. Схемы старых статей не подменяются свежими без проверки; панель продолжает предупреждать о расхождениях. Границы октябрьской проверки, проверка сентябрьских статей.

До первого открытия справочника загружается только небольшой скрипт регистрации меню. Каталог, React и схемы нод загружаются по запросу; разбор данных и поиск выполняются в Web Workers. Закрытие панели отменяет незавершённую загрузку, завершает поисковый worker и убирает содержимое панели из DOM. Каталог и история сохраняются в памяти для повторного открытия. Список статей выводится по 40 записей. Расширение не подписывается на отрисовку холста и изменение графа.

Браузерная проверка: npm run build, npx playwright install chromium, npm run test:browser. Она использует полный каталог и снимок /object_info с минимальным стендом ComfyUI: проверяет отложенную загрузку, поиск, освобождение workers, прокрутку и повторное открытие. Это проверка расширения, а не замер FPS реального workflow.

Как устроен проект

Расширение работает на стороне браузера. Python-файл регистрирует каталог web в ComfyUI, но не добавляет исполняемых нод и не участвует в обработке workflow.

  • ui/src/ — React/TypeScript-интерфейс, интеграция с меню ComfyUI, поиск и просмотр статей.
  • content/ — редактируемые статьи, реестр идентификаторов и зафиксированные снимки метаданных ComfyUI.
  • tools/catalog.py — проверка схемы, семантических связей и сборка каталога.
  • web/ — готовый браузерный bundle и собранные данные, которые загружает ComfyUI.
  • __init__.py — минимальная точка входа с пустым NODE_CLASS_MAPPINGS и WEB_DIRECTORY = "./web".

Связь статьи с нодой строится по устойчивому node_id из реестра ComfyUI, а не по видимому названию или позиции в меню. Алиасы и замены хранятся отдельно: это позволяет отметить переименование, устаревание или преемника, не теряя историю статьи. Снимок /object_info служит входом для инвентаризации, но не считается готовым редакционным материалом.

Совместимость

Базовая версия — ComfyUI >=0.32.0. Клиентская часть опирается на frontend API ComfyUI, поэтому перед релизом её проверяют как минимум на базовой и текущей стабильной версиях. Изменение внутренних API ComfyUI может потребовать адаптера даже без смены Python-контракта.

Расширение не заменяет встроенную документацию ComfyUI и не связано с проектом ComfyUI официально.

Границы alpha

Редакционный реестр содержит 665 статей о серверных нодах для локальной работы и четыре статьи о системных frontend-only нодах. API-ноды не входят в текущую очередь. Каталог ещё не готов к выпуску 1.0: все материалы остаются черновиками до человеческого утверждения, а часть примеров прошла только проверку схемы или безопасные изолированные пробы без моделей.

Фрагмент workflow можно безопасно скопировать или скачать. Вставка в текущий граф одной отменяемой операцией ещё не реализована. Полный workflow открывается только в новой временной вкладке; если совместимый API ComfyUI недоступен, Wizard скачивает JSON и не меняет текущий граф.

Удалённое обновление catalog.json реализовано, но намеренно выключено до настройки реального HTTPS URL и публичного ключа. Установка архивов с локальными ресурсами, полный frontend inventory, автоматический E2E на реальном ComfyUI и матрица платформ остаются условиями следующего релизного этапа. Команда release-gate не позволяет принять нынешний каталог за stable.

Установка

Через Manager

Найдите TS Nodes Wizard (идентификатор comfyui-ts-nodes-vizard, publisher timesaver), установите пакет и перезапустите ComfyUI. Обновите страницу браузера без кеша. Node.js, npm и дополнительные Python-зависимости для работы расширения не нужны.

В версиях 0.2.0-alpha.* обнаружена несовместимость номера версии с парсером некоторых версий Manager. Поэтому начиная с 0.3.0 используется обычный номер из трёх чисел; это не означает, что каталог уже прошёл утверждение для 1.0. Если Manager не распознаёт старую установку, сначала обновите Manager и сохраните лог ошибки. Не устанавливайте одновременно две копии Wizard в разные папки.

Через Git

  1. Перейдите в каталог ComfyUI/custom_nodes.
  2. Клонируйте этот репозиторий в отдельную папку.
  3. Перезапустите ComfyUI и обновите страницу браузера без кеша.

Готовый каталог web уже включён в репозиторий и Registry-архив. npm ci и npm run build нужны только разработчику при изменении интерфейса. Если установка не проходит, приложите версию ComfyUI и Manager, способ установки и полный фрагмент ошибки из консоли; один и тот же симптом может быть вызван сетью, правами доступа или конкретной версией Manager.

После запуска откройте справочник через меню Extensions или команду TS Nodes Wizard. Для выбранной ноды также доступен пункт «Открыть в TS Nodes Wizard» (Open in TS Nodes Wizard в английском интерфейсе).

Разработка

Нужны Python 3.10+, Node.js 20.19+ и установленный рядом ComfyUI для ручной проверки интеграции.

npm ci
npm run typecheck
npm run test -- --run
python tools/catalog.py ci
npm run build

npm run dev запускает Vite на 127.0.0.1:5173. Сам ComfyUI по умолчанию ожидается на 127.0.0.1:8188; режим разработки использует его модули /scripts/app.js и /scripts/api.js.

Сборка создаёт web/nodes-wizard.js и копирует сгенерированный каталог в web/data. Не редактируйте эти файлы вручную: меняйте исходники в ui/src или content, затем пересобирайте проект.

Обновление статей и инвентаря

Обычная редакторская правка проходит так:

  1. Найдите запись по node_id и проверьте, к какой версии и источнику ComfyUI она относится.
  2. Измените исходную статью, сохранив сведения об авторе, источнике и лицензии примера.
  3. Выполните python tools/catalog.py validate.
  4. Обновите собранный каталог командой python tools/catalog.py build.
  5. Убедитесь, что повторная сборка не меняет результат: python tools/catalog.py build --check.
  6. Проверьте статью в интерфейсе, включая поиск, прямое открытие и состояние «статья не найдена».

Для нового снимка ComfyUI сначала сохраните /object_info как отдельный входной файл. Команда python tools/catalog.py diff --before <старый.json> --after <новый.json> показывает добавленные, удалённые и изменившиеся определения. Она не публикует статьи автоматически: редактор решает, является ли изменение переименованием, заменой или реальным удалением.

Полные правила и чек-лист находятся в CONTRIBUTING.md.

Границы безопасности

  • Справочник не должен отправлять workflow, prompts, модели, пути и пользовательские статьи во внешние сервисы.
  • Каталог поставляется вместе с расширением. Alpha-механизм обновления остаётся выключенным, пока сопровождающий не задаст URL манифеста и открытый ключ релиза. После настройки текущий клиент проверяет подпись манифеста, размер, SHA-256 и полную схему catalog.json, показывает изменения и применяет файл только после явного согласия пользователя. Обновление архива с локальными ресурсами относится к следующему этапу и пока не включено.
  • Markdown считается недоверенным вводом. Рендерер обязан запрещать исполняемый HTML, javascript:-ссылки и небезопасные URL.
  • Примеры workflow — данные для просмотра или явного импорта, а не команды. Расширение не загружает модели и не запускает очередь само.
  • Снимки /object_info могут раскрывать названия установленных custom nodes. Не добавляйте в репозиторий приватный инвентарь без проверки.

Порядок сообщения об уязвимостях описан в SECURITY.md.

Лицензии

Исходный код распространяется по GNU GPL v3. Редакционные статьи, схемы, собственные примеры и прочий материал каталога — по CC BY-SA 4.0, если рядом с конкретным материалом не указана другая лицензия. Сторонние названия, цитаты, изображения и workflow сохраняют права своих авторов; одной ссылки на источник недостаточно, если лицензия не разрешает повторное использование.

Метаданные Registry настроены для издателя timesaver. Публикация выполняется workflow Publish to ComfyUI Registry: вручную либо по тегу, который точно совпадает с версией из pyproject.toml (v0.2.0-alpha.2 для текущей версии). Перед отправкой workflow повторяет проверки каталога, упаковки, frontend и браузерного поведения. Для публикации владелец репозитория должен добавить отдельный ключ ComfyUI Registry в GitHub Actions secret REGISTRY_ACCESS_TOKEN.