Агент изменил интерфейс. Пользовательский сценарий всё ещё работает?

FlowCheck проверяет страницу или повторяет JSON-сценарий в Chromium, сохраняет результат, скриншоты, Playwright trace и JUnit XML. Работает самостоятельно из терминала и через MCP с Claude Code, Codex и другими совместимыми клиентами. Аккаунт FlowCheck, API-ключ и подписка на AI для запуска проверок не нужны.

Попробовать одной командой

Нужен Node.js 22.18+ на macOS или Linux:

npx --yes @kadessovb/flowcheck demo

Команда скачает готовый пакет, при необходимости установит Chromium, запустит встроенное приложение на свободном порту и проверит создание workspace. Клонировать репозиторий и собирать TypeScript не нужно. Результаты сохраняются в .flowcheck/runs/ в текущей папке. Пакет и браузер кешируются.

При первом запуске нужны интернет и место для Chromium. На минимальной Linux-системе могут понадобиться системные библиотеки: замените demo на setup --with-deps. Эта явная команда может потребовать права администратора; обычная проверка системные пакеты не устанавливает.

Для ежедневной работы

Все команды ниже работают без установки в проект. Если хотите закрепить версию в зависимостях проекта:

npm install --save-dev @kadessovb/flowcheck

После установки можно использовать короткий вариант npx flowcheck. Пакет доступен в npm, архивы версий — в GitHub Releases.

Без AI-агента

Запустите своё приложение, затем:

npx @kadessovb/flowcheck check http://localhost:3000
npx @kadessovb/flowcheck check http://localhost:3000/login --text "Sign in"

Проверяются загрузка без HTTP-ошибки и видимость страницы. --text добавляет проверку ожидаемого текста. Это smoke-проверка страницы, а не проверка всех функций приложения. Для заполнения форм и других действий используйте сценарий.

--headed показывает браузер, --json возвращает машинный отчёт. Коды завершения: 0 — успех, 1 — провал проверки, 2 — ошибка ввода или запуска.

С Claude Code или Codex

Из папки своего проекта выполните команду для нужного клиента:

npx @kadessovb/flowcheck connect claude

npx @kadessovb/flowcheck connect codex

FlowCheck подготовит Chromium и зарегистрирует MCP-сервер через установленный CLI клиента. Команды claude или codex должны быть доступны в PATH. Регистрация получает отдельное имя для каждого проекта: подключение второго проекта не заменяет первое. Codex сохраняет её в пользовательской конфигурации, Claude Code — в локальной области проекта. Перезапустите сессию клиента после подключения.

Теперь можно попросить агента:

Проверь через FlowCheck приложение на http://localhost:3000. Составь сценарий регистрации по реальным полям из кода, провалидируй и запусти его. Если проверка упадёт, покажи шаг и доказательства ошибки.

Агент видит схему сценария в инструментах MCP и может передать его прямо в вызове — вручную писать JSON-файл не требуется. Полезный сценарий можно сохранить в проект, чтобы повторять его после следующих изменений.

Для другого клиента с поддержкой локального stdio MCP выполните npx @kadessovb/flowcheck config и перенесите полученную запись в его настройки. Клиенты, поддерживающие только удалённые HTTP-серверы, этим способом не подключаются.

Агент с доступом к терминалу может использовать обычный CLI с --json, без MCP.

Повторяемый сценарий

npx @kadessovb/flowcheck init --url http://localhost:3000

Отредактируйте шаги в flowcheck.scenario.json, затем:

npx @kadessovb/flowcheck validate flowcheck.scenario.json
npx @kadessovb/flowcheck run --headed

Пример и справка: английский README, формат сценариев. Поддерживаются переходы, клики, заполнение, выбор, checkbox, клавиши, ожидания и проверки текста, URL и видимости.

Посмотрите, как находится ошибка

npx @kadessovb/flowcheck demo --broken

В этом режиме demo-приложение выдаёт ошибку создания workspace. Проверки остаются прежними: шаг confirmation падает, следующие шаги не выполняются, сохраняются скриншот и trace. FAILED и код 1 здесь ожидаемы.

Без --broken сценарий проходит. Добавьте --headed, чтобы увидеть браузер.

Результаты и ограничения

В .flowcheck/runs/ сохраняются report.json, junit.xml, а также trace и скриншоты согласно настройкам. Другую папку можно выбрать через --output. Не добавляйте .flowcheck/ в Git.

Это ранняя предварительная версия, поддерживающая Chromium на macOS и Linux. FlowCheck использует Playwright и подходит для небольших повторяемых проверок. Полноценный набор Playwright Test с фикстурами и разными браузерами переносить не требуется.

Проверяйте только системы, на тестирование которых есть разрешение. Маски скриншотов не очищают trace-файлы, URL и сообщения об ошибках. Телеметрии FlowCheck нет; загрузка пакета и браузера обращается к серверам их распространения. Политика безопасности.

Если браузер не скачался, выполните npx @kadessovb/flowcheck setup. Для подготовленного офлайн-окружения FLOWCHECK_SKIP_BROWSER_INSTALL=1 запрещает автоматическую загрузку Chromium; сам npm-пакет также должен быть установлен или закеширован.

Помочь проекту

Попробуйте реальный сценарий и расскажите, что не получилось. Для разработки из исходников — CONTRIBUTING.md. Если инструмент полезен, поставьте звезду, чтобы другим было проще его найти.

Лицензия: Apache-2.0.