--- title: "Проекты и настройки" id: "1995" type: "page" slug: "projects" published_at: "2026-09-20T16:13:20+00:00" modified_at: "2026-09-28T14:59:36+00:00" url: "https://pastukhov.com/agents/test/docs/projects" markdown_url: "https://pastukhov.com/agents/test/docs/projects.md" excerpt: "Проект — это один проверяемый сайт или приложение. Все настройки проекта лежат обычными файлами в…" --- # Проекты и настройки [https://pastukhov.com/agents/test/docs/projects.md](https://pastukhov.com/agents/test/docs/projects.md) Проект — это один проверяемый сайт или приложение. Все настройки проекта лежат обычными файлами в отдельной папке: их видят инструменты разработки, их можно перенести на другой сервер простым копированием и по ним видно историю правок. Ниже — что именно лежит в папке, что хранится в базе и как завести новый проект. ## Проект — это папка Один сайт — один проект — одна папка. В папке лежит всё, что описывает ваши проверки, и ничего лишнего: файлы настроек и небольшие скрипты. Папку проектов можно скопировать на другой сервер целиком и продолжить работу там — никакого экспорта и переноса базы для этого не нужно. | Что в папке | Зачем это | | --- | --- | | project.yml | Название, базовый адрес сайта, описание, часовой пояс, модель ИИ-агента для этого проекта и блок visual: с настройками визуальных проверок | | project.yml → visual: | Пресет, пороги сравнения, стабилизация съёмки, ветки, бюджеты ИИ, уведомления и политика непрерывной сборки — подробнее в разделе Настройки визуального тестирования | | screen-types.yml | Типы экранов: «вход», «оплата», «кабинет» — с образцом адреса, по которому тип определяется | | rules/ | Сами проверки — по одному небольшому файлу на правило | | actions/ | Записанные и написанные агентом сценарии работы с интерфейсом | | tests/ | Тесты: последовательности шагов, которые запускаются вместе | | skills/ | Знания для агента: validator.md (что агент уже понял про ваш интерфейс) и navigation.md (как по нему ходить) | | comments/ | Замечания к экранам — обычный текст, по файлу на экран | Все эти файлы удобно держать под контролем версий — так называют программу, которая запоминает историю изменений файлов (например, git). Тогда у каждой правки есть автор и время, а любую неудачную правку можно откатить. **Изменения в историю записывает человек**: сервер сам не записывает изменения в историю, чтобы в истории не появлялись служебные записи без вашего ведома. ## Что хранится в базе Часть данных живёт не в папке, а в базе продукта: снимки экранов и визуальных сборок, сравнения и картинки отличий, эталоны с их версиями и вариациями, запуски с их шагами и результатами, проблемы, расписания, разборы замечаний и падений, кампании починки тестов, покрытие и карта приложения, общие ссылки, учётные данные и ключи API. Причина простая: этого добра много, оно меняется каждый день, и хранить его в папке проекта было бы неудобно и для истории правок, и для самого продукта. Настройки и скрипты, наоборот, меняются редко и важны как документ — поэтому они в файлах. Снимки экранов хранятся прямо в базе, а не отдельными картинками на диске. Из этого следует приятная для владельца вещь: база и папка проектов — это всё, что нужно сохранить, чтобы ничего не потерять. Отдельно — учётные данные для разных стендов: они лежат в базе в зашифрованном виде, а ключ шифрования — отдельным файлом в папке данных сервера (`keys/visual-creds.key`). В файлы проекта секреты не попадают, поэтому папку можно безопасно держать в истории версий и переносить между серверами. ## Создание проекта - **Название** — как проект будет называться в интерфейсе. Пишите по-человечески: «Магазин», «Личный кабинет». - **Адрес папки** — из названия предлагается автоматически: строчные латинские буквы, цифры и дефисы, от 3 до 63 знаков. Именно эта папка появится на диске. - **Базовый адрес** — адрес сайта, который проверяем. По нему панель в браузере сама понимает, к какому проекту относится открытая страница. - **Описание** — пара слов для себя и для агента: что это за система. - **Часовой пояс** — по нему считаются расписания. Если ошибиться, запуски будут приходить в неправильное время, поэтому неверное значение продукт не примет и покажет ошибку у поля. - **Модель агента** — какую модель использовать для разбора замечаний именно в этом проекте. Проекты разные, и требования к модели у них тоже разные. - **Чек-лист и цель покрытия** — сразу после создания открывается чек-лист настройки визуальных проверок из восьми шагов. Цель покрытия — сколько поверхностей и состояний вы хотите защитить — задаётся в настройках визуальных проверок, а виден прогресс к ней в разделе «Покрытие». После создания продукт сразу заводит папку со всеми файлами, карточка проекта появляется в списке без перезагрузки страницы, а на экран выходит чек-лист настройки визуальных проверок. ## Как менять настройки Название, базовый адрес, часовой пояс и модель агента меняются на вкладке «Настройки проекта» в обычной форме — файлы настроек переписываются аккуратно, и неверное значение никогда не оставит файл в половинчатом состоянии. Правила, действия и тесты можно посмотреть и поправить через диалог «Файлы проекта»: если файл изменён на диске, список в интерфейсе сразу это покажет, потому что он читается из файлов, а не из памяти продукта. Настройки визуальных проверок собраны в отдельной вкладке настроек проекта: общие (цель покрытия, таблица лидеров), съёмка, стабилизация, проверки (слои), ветки, ИИ и бюджеты, уведомления, среды, учётные данные, переменные, подготовка и очистка, ключи API, пользователи и пресеты. Значения сохраняются с проверкой: неверное число или неизвестная роль не запишутся. Панель «Действующая конфигурация» показывает итог — то, что реально применяется с учётом значений по умолчанию, и позволяет скопировать его одним нажатием. ## Среды и доступ Проверять обычно приходится не один адрес, а несколько: тестовый стенд и рабочий, а иногда ещё и промежуточный. Каждый такой стенд описывается как **среда** со своим базовым адресом, а одна из сред может быть помечена защищённой — рабочей. Так продукт отличает безопасный стенд от продакшна и не даёт случайно обойти защиту. Подробнее — в разделе [Среды, учётные данные и переменные](/agents/test/docs/environments) . Логины и пароли для входов хранятся в учётных данных в зашифрованном виде и подставляются в шаги в момент выполнения, а не лежат в файлах проекта. Наборы переменных избавляют от повторения одних и тех же значений в разных тестах. А кто из пользователей что может — определяют роли: от наблюдателя, которому доступно только чтение, до владельца. Об этом — в разделе [Пользователи и роли](/agents/test/docs/users) . ## Изоляция проектов Проекты не видят друг друга: списки экранов, правила и проблемы одного проекта никогда не попадут в другой. Это важно, когда проверяете сразу несколько систем — например, клиентский сайт и внутреннюю программу. ## Удаление проекта При удалении проекта папка удаляется целиком вместе с правилами, действиями и тестами; из базы уходят и данные проекта — снимки и сборки, эталоны с их версиями, покрытие и карта приложения, кампании починки и общие ссылки. Отменить это нельзя — восстанавливать придётся из вашей истории версий, если вы её ведёте. Если проект нужно просто приостановить, удалять его не стоит: снимите галочку с расписаний, и запусков не будет, а накопленные проверки останутся на месте. Дальше: как установить дополнение Chrome и что в его панели — в разделе [Дополнение Chrome](/agents/test/docs/addon) . [← Оглавление документации](/agents/test/docs)