---
title: "Дополнение Chrome"
id: "1996"
type: "page"
slug: "addon"
published_at: "2026-09-20T16:13:20+00:00"
modified_at: "2026-09-21T00:00:47+00:00"
url: "https://pastukhov.com/agents/ui/docs/addon"
markdown_url: "https://pastukhov.com/agents/ui/docs/addon.md"
excerpt: "Дополнение Chrome — та половина продукта, которая работает в браузере. Оно снимает экраны, выполняет проверки…"
---

# Дополнение Chrome

[https://pastukhov.com/agents/ui/docs/addon.md](https://pastukhov.com/agents/ui/docs/addon.md)

Дополнение Chrome — та половина продукта, которая работает в браузере. Оно снимает экраны, выполняет проверки прямо на открытой странице и запускает тесты. Без него продукт остаётся справочником: правила есть, но применить их к настоящей странице некому. Ниже — установка, панель и режим исполнителя.

## Зачем нужно дополнение

- **Снимает экран** — картинку страницы, её адрес, заголовок, размер окна и структуру: заголовки, кнопки, поля.
- **Выполняет проверки** — прогоняет правила на настоящей странице и показывает, что прошло, а что нет.
- **Запускает тесты** — в режиме исполнителя берёт из очереди готовый тест и проходит его шаг за шагом.

Дополнение приватное: в каталоге Chrome его нет. Так сделано нарочно — проверки у каждого проекта свои, и держать их на виду у всех не нужно. Продукт готовит папку с уже прописанной привязкой к вашему серверу, а Chrome просит только подключить эту папку.

## Установка в один клик

1. В продукте откройте **Настройки → Тестирование UI** и нажмите **Установка в один клик**.
2. Приложение создаст папку `ui-agent-addon` в выбранном вами каталоге. Внутри уже лежит адрес вашего сервера и ключ доступа — вписывать ничего не нужно.
3. Скопируйте адрес `chrome://extensions`, откройте его в новой вкладке и включите **режим разработчика** в правом верхнем углу.
4. Нажмите **Загрузить распакованное** и выберите созданную папку `ui-agent-addon`.

Как только дополнение подключится, в диалоге вместо списка шагов появится зелёная надпись «Дополнение подключено» — отдельно проверять связь не нужно. Если браузер не умеет писать папку сам, скачается готовый архив: распакуйте его и выберите папку так же.

Ручная привязка нужна только в редком случае — если дополнение уже установлено, а сервер другой. Тогда откройте страницу настроек дополнения и укажите адрес сервера и ключ доступа, затем нажмите **Проверить связь**: в ответ должен прийти список ваших проектов.

## Панель на странице

Нажмите на значок дополнения на панели браузера — на текущей странице откроется панель: небольшое окно поверх содержимого. Повторное нажатие или крестик прячут её. Окно можно перетаскивать за заголовок, и оно помнит своё место: в следующий раз откроется там же. Работает это только на обычных сайтах — на служебных страницах браузера значок мигнёт красным, потому что там проверять нечего.

- **Какой проект распознан** — определяется по адресу открытой страницы. Выбирать проект руками не нужно: панель сама находит подходящий по базовому адресу.
- **Съёмка экрана** — одна кнопка. Снимок сохраняется сразу, и тут же можно написать замечание словами.
- **Правила для этой страницы** — список подходящих проверок и кнопка «Проверка страницы»: она прогоняет их все и показывает результат.
- **Запись и запуск действий** — включить запись, поработать на сайте как обычно, остановить; потом запустить записанное и посмотреть, что получилось.
- **Спросить агента** — описать задачу словами, чтобы агент написал действие сам.
- **Последние снимки** — двадцать последних экранов проекта с быстрым замечанием и ссылкой на полный список в приложении.

Если сайт ещё не заведён, панель предложит создать проект: название подставится из адреса страницы, а адрес папки — сразу с проверкой, что он допустим.

## Панель в кадр не попадает

Снимок всегда показывает страницу без панели: на время съёмки она прячется и возвращается на своё место сразу после. Записанные действия тоже не замечают панель — перетаскивание окна и нажатия в нём в сценарий не попадают. Продукт никогда не снимает и не записывает сам себя.

## Режим исполнителя

У дополнения есть страница настроек. Там включается **режим исполнителя** — он включён сразу, и выключать его стоит только если это ваш личный браузер, где запускать тесты неудобно. Ещё на этой странице задаётся имя исполнителя: по нему видно, какой компьютер выполнял запуск.

Там же показано, когда дополнение последний раз связывалось с сервером. Надпись «связь была N секунд назад» означает, что всё живо; если счёт идёт на минуты, браузер закрыт, компьютер спит или сервер недоступен — в строке будет сказано, что именно.

## Честные ограничения

- **Дополнение приватное** — его нет в каталоге Chrome, установка идёт из папки, как описано выше. Обновление браузер сам не подтянет.
- **После обновления продукта дополнение обновляют руками** — снова нажмите «Установка в один клик» (папка перезапишется) и в `chrome://extensions` нажмите кнопку обновления у дополнения. Без этого Chrome продолжит работать со старой версией.
- **Один запуск на браузер** — тест занимает отдельную вкладку, и второй тест в этом же Chrome не начнётся, пока первый не закончится. Для частых расписаний держат отдельный компьютер-исполнитель.

Дальше: что такое экран и замечание — в разделе [Экраны и замечания](/agents/ui/docs/screens)
.

[← Оглавление документации](/agents/ui/docs)