Answer42
Answer42 — MCP-инструмент для интерактивного управления UI 1С:Предприятия через клиент тестирования. Он позволяет AI-агенту открывать формы 1С, нажимать кнопки, заполнять поля, выбирать ссылки из форм выбора, работать с таблицами, динамическими списками и табличными документами.
The Answer to Life, Universe, and 1C — UI Driver
Проект даёт AI-агенту четыре способности:
- Интерактивное управление UI 1С — открыть форму, кликнуть кнопку, активировать поле, заполнить значение, выбрать строку, провести сценарий через
/TESTMANAGER+/TESTCLIENT. - Живые веб-страницы в HTML-полях — читать и менять DOM страниц, которые рисуются скриптами (чаты, SPA), и видеть ошибки их консоли, на Windows- и Linux-клиентах 1С.
- Доказательная запись клиентского тестирования — собирать PDF-отчёт: обложка, ход проверки, страница на каждый шаг со скриншотом окна 1С и описанием простыми словами; технические детали (MCP method/request/response) вынесены в приложение в конце.
- RAG-индекс метаданных — локальный SQLite/FTS индекс конфигураций 1С (EDT, XML-выгрузка Конфигуратора, base + extensions), включая подсказки для
ui_treeи dynamic-list settings.
Быстрый старт
# Рекомендуется для обычной установки из PyPI
pipx install 'answer42[screenshot,linux-window-control]'
# Альтернатива без pipx
python3 -m venv .venv
. .venv/bin/activate
pip install 'answer42[screenshot,linux-window-control]'
# Разработка из git checkout
pip install -e '.[screenshot,dev,linux-window-control]'
# Windows: запускать из интерактивной пользовательской сессии, не как service
# pipx install "answer42[screenshot,windows-window-control]"
# pip install "answer42[screenshot,windows-window-control]"
# Запуск MCP-сервера (transport: stdio)
answer42 --ws-host 127.0.0.1 --ws-port 8765
Запуск сессии и подключение тестируемой базы выполняются одним MCP-вызовом:
start_session(
session_id="my-session",
base_url="<TARGET_INFOBASE_URL>",
idle_timeout_minutes=60,
execute="/path/to/external.epf", # опционально: /Execute
command_parameter="InitScenario" # опционально: /C
)
start_session определяет версию 1С по base_url, поднимает инфраструктуру Answer42 (на Linux — Xvfb, если нужен headless; на Windows — интерактивная desktop-сессия), свободные порты, WebSocket bridge, файловую базу менеджера и test-manager. Если доступны серверные компоненты 1С (ibsrv), менеджер и встроенная тестовая база публикуются через автономный сервер; если доступен только тонкий клиент и ibcmd, Answer42 автоматически использует fallback file-direct (/F) для файловых баз менеджера и клиента. После idle_timeout_minutes минут неактивности сессия автоматически завершается; значение по умолчанию — 60 минут. Для запуска клиента можно передать extra_args, execute (параметр командной строки /Execute) и command_parameter (параметр /C); если /C уже указан в extra_args, значения склеиваются через ;.
Логин/пароль рекомендуется не передавать явно: start_session умеет брать их из локального credentials-файла по base_url. Параметры username/password остаются в API для разовых сценариев и обратной совместимости, но при передаче в MCP-вызове они видны вызывающему агенту в аргументах tool-call.
Профили и форматы ui_tree
ui_tree оптимизирован для диагностики структуры формы. Профиль по умолчанию profile="navigation" возвращает компактное дерево видимых элементов без представлений данных, обогащения из RAG и поддеревьев командных панелей. Глубина дерева не ограничивается.
Полезные режимы:
ui_tree(parent_name=...)сериализует только поддерево известного родительского элемента — удобно для больших и сложных форм.ui_tree(name=.../title=.../type=...)возвращает плоский списокobjectsвместо дерева; на актуальных менеджерах фильтрация выполняется на стороне 1С, а простые точные запросы поname/typeмогут идти быстрым путём платформы до перехода к плоскому обходу.profile="diagnostic"включает командные панели без дорогого чтения данных.profile="data"включает представления данных узлов; если данные нужны не для многих узлов, лучше точечныеfield_info,table_rows,tabular_documents(name=...)илиtabular_document_save.profile="full"даёт результат, ближайший к прежнему подробному.fields="minimal|navigation|diagnostic|data|full"(или свой список полей через запятую) управляет содержимым узлов без обрезки дерева.command_panels="include|exclude|only"явно управляет сериализацией командных панелей;onlyвозвращает плоский список без повторов.group_mode="include|flatten|flatten_layout|exclude|exclude_empty|pages_only"определяет, сохраняются ли узлы групп, поднимаются ли их элементы на уровень выше или группы опускаются.format="outline|json|yaml|yml": по умолчаниюoutline— одна строка с отступом на узел,Тип Имя — Заголовок [состояние] ключ=значение. В состоянии перечисляется только отличие от обычного (not_visible,not_available,read_only,current…), остальные поля узла идут парамиключ=значение, так что outline несёт те же сведения, что и JSON, но обходится в разы дешевле.jsonвозвращает вложенные объекты. Неверные значения профиля, группировки, командных панелей и формата отклоняются;tree_summaryсодержит число узлов и разбивку по точному типу клиента тестирования 1С (нулевые счётчики опускаются), а замеры времени и размера (metrics) возвращаются только сinclude_timings=true.
Большие снимки ui_tree как ресурсы
По умолчанию delivery="auto" возвращает небольшие результаты прямо в ответе, а большие автоматически сохраняет как ресурс, когда оценка числа токенов превышает ONEC_MCP_UI_TREE_RESOURCE_AUTO_THRESHOLD_TOKENS (по умолчанию 50 тысяч).
delivery="inline" принудительно возвращает выбранный JSON/outline/yaml в ответе, delivery="resource" — принудительно сохраняет большую диагностику в ресурс:
r = ui_tree(profile="full", include_hidden=true, delivery="resource")
Когда auto переключается на ресурс или delivery="resource" задан явно, ответ содержит только resource_uri, snapshot_id, сводку, метрики, размер в байтах, оценку токенов, причину срабатывания порога и небольшой фрагмент. Полный JSON-снимок сохраняется в каталоге данных Answer42 и регистрируется как MCP-ресурс (answer42://ui-tree/<session>/<snapshot_id>). Не загружайте весь ресурс в контекст агента без необходимости — для работы со снимком есть точечные инструменты:
ui_tree_resource_search(resource_uri=..., name/title/type/text=...)— найти несколько элементов в сохранённом снимке и получить ихpath/index_path.ui_tree_resource_get_node(resource_uri=..., index_path=...)— прочитать ровно один узел.ui_tree_resource_children(resource_uri=..., index_path=..., depth=1|2)— прочитать небольшое поддерево.ui_tree_diff(before_resource_uri=..., after_resource_uri=...)— сравнить снимки до и после действия в интерфейсе.ui_tree_resource_action(resource_uri=..., index_path=..., action="focus|click_button|activate_field|field_value_text|field_info")— использовать селектор узла из снимка и выполнить соответствующий инструмент на живой форме.
index_path — предпочтительный стабильный адрес внутри одного снимка. path читаем человеком и удобен для отчётов, но менее надёжен, когда у нескольких элементов одинаковые заголовки.
Встроенные рекомендации для агентов
Answer42 больше не поставляет и не устанавливает встроенные skills. Рекомендации по автоматизации интерфейса, RAG, Универсальному отчёту и выгрузке табличных документов находятся в описаниях соответствующих MCP-инструментов и во встроенных MCP prompts.
Команды answer42 install-skills и answer42 skills-install сохранены для совместимости:
они ничего не копируют и выводят сообщение о новой схеме.
Инструкция для AI-агентов
Если вы AI-агент и пользователь просит установить Answer42, используйте отдельную инструкцию: docs/agent-installation.md.
Коротко:
- установите пакет через
pipxили virtualenv; - подготовьте
ONEC_MCP_CREDENTIALS_FILEвне репозитория; - зарегистрируйте MCP-сервер в агентском клиенте;
- проверьте установку через
credentials_check, затем пробной сессиейstart_session→active_window→stop_session.
Дисплей на Linux
На Linux start_session использует живую X11-сессию, если процесс Answer42 унаследовал непустой DISPLAY: test manager и test client запускаются на этом дисплее, поэтому их окна и скриншоты видны на desktop.
Если DISPLAY не задан (headless service, SSH без X11 forwarding и т. п.), Answer42 поднимает два собственных изолированных Xvfb-дисплея: один для test manager и второй для test client. В этом режиме пакет xvfb обязателен:
# Debian / Ubuntu
sudo apt install xvfb
# Fedora / RHEL
sudo dnf install xorg-x11-server-Xvfb
Если не задан ни доступный DISPLAY, ни Xvfb, start_session завершается до создания ресурсов с понятной подсказкой по установке. Чтобы desktop-сервис видел живой X11, его launcher/service должен передать корректный DISPLAY и права доступа к X server (обычно через XAUTHORITY).
Скриншоты: stdio и StreamableHTTP
screenshot сохраняет PNG на MCP-хосте и больше не помещает его base64-представление в результат tool-call.
- В stdio возвращаются только
path, размер и диагностические поля. Агентский хост при необходимости прикладывает файл по пути. - В StreamableHTTP добавляется непрозрачная одноразовая ссылка
urlна PNG. Она действует один час по умолчанию (ONEC_MCP_SCREENSHOT_URL_TTL_SECONDS), исчезает после первого скачивания и существует не дольше процесса сервера. Для внешнего reverse proxy укажите публичный base URL черезONEC_MCP_SCREENSHOT_URL_BASE.
Транспорты: stdio и StreamableHTTP
По умолчанию Answer42 использует транспорт MCP stdio (MCP-хост запускает его как дочерний процесс). Для удалённого развёртывания есть режим StreamableHTTP с авторизацией MCP:
answer42 --http --http-host 0.0.0.0 --http-port 8080 \
--http-token "static-secret-token" \
--http-account-id "tenant-42"
Переменные окружения:
export ONEC_MCP_HTTP=1
export ONEC_MCP_HTTP_HOST=0.0.0.0
export ONEC_MCP_HTTP_PORT=8080
export ONEC_MCP_HTTP_TOKEN="static-secret-token"
export ONEC_MCP_ACCOUNT_ID="tenant-42"
answer42
- Каждый MCP-запрос должен содержать заголовок
Authorization: Bearer <token>. account_idопределяет namespace для credentials. Если не задан, вычисляется как стабильный хеш токена (token-<16hex>).- Режим по умолчанию stateless (
ONEC_MCP_HTTP_STATELESSdefault1).--http-stateful(илиONEC_MCP_HTTP_STATELESS=0) включает сессии MCP (Mcp-Session-Id): тогда сервер помнит включённые клиентом группы инструментов и присылает емуtools/list_changed. - Один HTTP-сервер обслуживает всех клиентов, поэтому неявной сессии по умолчанию нет:
start_sessionбезsession_idсоздаёт сессию с уникальным id и возвращает его, а инструменты, работающие с сессией, без явногоsession_idвозвращают ошибку. Список сессий —sessions_list.
Группы инструментов
Клиент по умолчанию видит только группу core (~36 инструментов: сессии, окна, навигация, кнопки, поля, основные операции с таблицами и отчётами). Остальные группы подключаются, когда нужны:
| Группа | Что внутри |
|---|---|
forms |
фокус и обход элементов, ожидания, группы и страницы, декорации, HTML-поля через API тест-клиента, диалог выбора файла, пакетный ввод полей |
tables |
перемещение по таблице, ячейки, выделение, копирование и пометка удаления, режим редактирования |
lists |
настройки динамических списков: отборы, сортировка, поиск, вывод списка |
commands |
командный интерфейс, командные панели и контекстные меню |
ui_snapshots |
работа с сохранённым большим ui_tree (включается сама, когда ui_tree сохранил результат в ресурс) |
metadata |
метаданные конфигурации из живого интерфейса |
rag |
RAG по исходникам конфигурации — только пока RAG активен: сервер запущен с --enable-rag (по умолчанию RAG выключен) и сессия начата с start_session(rag_enabled=true) |
html |
живые веб-страницы в HTML-полях: текст, поиск элементов, клик, ввод, ожидание, ошибки консоли (включается сама после start_session); произвольный JavaScript html_eval — только с --dev-tools |
recording |
запись доказательств (скриншоты, слайды, PDF) |
credentials |
сохранённые учётные данные баз |
Как подключить группы:
- на ходу — инструментом
tool_groups(action="enable", groups="lists,commands"); клиент получаетtools/list_changedи перечитывает список. Выбор запоминается за клиентом: в stdio — за процессом, в stateful HTTP — заMcp-Session-Id, у клиентов без сессии (протокол MCP 2026-07-28, stateless HTTP) — за?client=<имя>/X-Answer42-Client, а если его нет — за учётной записью токена; - для клиента HTTP-сервера — параметром адреса:
http://127.0.0.1:8742/mcp?tools=lists,commands(или заголовкомX-Answer42-Tools); - для сервера целиком —
--tool-profile/ONEC_MCP_TOOL_PROFILE(напримерcore,listsилиfull). Старые имена профилей (ui,dynamic,tabular,sessions,windows) продолжают работать.
Старый режим (статический список). --tool-groups off или ONEC_MCP_TOOL_GROUPS=off выключает группы: клиент сразу видит весь список профиля (по умолчанию full), инструмента tool_groups нет, RAG-инструменты не скрываются. Отдельному клиенту полный список можно дать и без выключения групп — ?tools=full.
HTML-поля и живые веб-страницы
Поле HTML-документа 1С может показывать как статический HTML, так и полноценное веб-приложение (чат, SPA), которое рисует себя скриптами.
Статический HTML — инструменты группы forms через API клиента тестирования: html_field_content (HTML поля в том виде, в каком страница загрузилась, и её видимый текст), html_field_click_link, html_field_input.
Живые страницы — группа html. Способ доступа к встроенному WebKit клиента выбирает параметр start_session(html_mode=...) (значение по умолчанию можно задать переменной ONEC_MCP_HTML_MODE):
html_mode |
Где | Как |
|---|---|---|
auto (по умолчанию) |
везде | Linux — remote; Windows — patched, если в Web Inspector платформы установлен актуальный мост, иначе console |
console |
Windows | горячая клавиша инспектора и короткий загрузчик, введённый в его консоль |
patched |
Windows, Linux | мост, встроенный в интерфейс инспектора: на Windows — в Web Inspector платформы (сначала answer42 webkit-inspector install, см. ниже), на Linux — подставляется для сессии, ничего устанавливать не нужно |
remote |
Linux | удалённый отладчик WebKitGTK (WEBKIT_INSPECTOR_SERVER) |
disabled |
везде | мост не запускается, инструменты html_* недоступны |
Явно выбранный режим не подменяется другим: если он недоступен (patched без моста в платформе, режим другой ОС), start_session сразу возвращает ошибку с подсказкой. Мост ничего не делает, пока не вызван инструмент html_*: на Windows инспектор открывается только при первом вызове, на Linux клиент запускается со встроенным сервером отладки.
| Инструмент | Что делает |
|---|---|
html_pages |
список живых страниц HTML-полей; подключает новые |
html_text |
текст страницы или элементов по CSS-селектору |
html_query |
элементы по селектору или тексту: тег, id, класс, value, атрибуты, видимость |
html_click |
нажать элемент |
html_type |
ввести значение в поле (submit=true — отправить Enter) |
html_wait |
дождаться появления или исчезновения текста / элемента |
html_eval |
выполнить произвольный JavaScript в странице — только с --dev-tools (см. ниже) |
html_console |
ошибки и предупреждения консоли страницы и скрипты, которые эта сборка WebKit не разбирает (например ?.) |
html_download |
скачать файл по ссылке страницы изнутри страницы (с её cookie и сеансом) и сохранить в каталог сессии: путь, размер, тип, HTTP-статус |
html_inspector_patch |
Windows: встроить мост в Web Inspector установленных платформ 1С или убрать его (необязательно, см. ниже) |
Если живых страниц несколько, нужная выбирается параметром page (id из html_pages или часть URL / заголовка).
Произвольный код. Инструменты, которые выполняют произвольный код, по умолчанию не регистрируются: html_eval (JavaScript в странице HTML-поля) и dev_eval (выражение BSL в менеджере тестирования). Их включают флагом answer42 --dev-tools или переменной ONEC_MCP_DEV_TOOLS=1; тогда html_eval видна вместе с группой html. Остальные инструменты html_* выполняют в странице только фиксированные операции Answer42.
Как это устроено:
- Windows. Встроенный WebKit клиента 1С не имеет сервера удалённой отладки, но его Web Inspector открывается по Ctrl+Alt+Shift+F12. При первом вызове
html_*Answer42 открывает инспектор поля (он встраивается в нижнюю часть формы), переключает его на вкладку Console и вводит в консоль короткий загрузчик. Загрузчик подключается к локальному WebSocket Answer42 по одноразовому токену, получает мост и выполняет операции в странице. Подключение к странице занимает около 2–3 секунд. После перезагрузки страницы загрузчик вводится заново. Платформа используется как установлена. - Windows, мост в инспекторе платформы (
html_mode=patched).answer42 webkit-inspector install(или инструментhtml_inspector_patch(action="install")) встраивает мост в Web Inspector установленной платформы:bin\WebKit.resources\WebInspectorUI\Main.htmlподключаетAnswer42Bridge.js. Каталог платформы доступен на запись только администратору, поэтому команда сама запрашивает права через UAC — одно подтверждение на все выбранные платформы — и разрешает текущему пользователю менять файл с портом сессии; сессиям права администратора больше не нужны. Если процесс Answer42 запущен из среды, которая не может показать запрос UAC (например, из песочницы агента), через 90 секунд команда вернёт ошибку с готовой командой для PowerShell, запущенного от имени администратора. После этого интерфейс инспектора подключается к Answer42 сам: в консоль ничего не вводится, мост переживает перезагрузку страницы, аhtml_consoleвидит сообщения с момента её загрузки. Если инспектор открывает человек, мост ничего не делает.answer42 webkit-inspector statusпоказывает состояние платформ,uninstallвозвращает исходные файлы. После обновления Answer42 или платформы мост нужно поставить заново:html_mode=patchedс устаревшим мостом не запускается. Ключ--versionвыбирает платформу, без него — все установленные. - Linux,
remote(по умолчанию). HTML-поля рисует системный WebKitGTK. Answer42 запускает тест-клиент сWEBKIT_INSPECTOR_SERVER=127.0.0.1:<порт>и подключается к удалённому отладчику WebKitGTK напрямую: окна инспектора и ввода с клавиатуры нет. - Linux,
patched. Инспектор WebKitGTK в 1С открывается той же клавишей Ctrl+Alt+Shift+F12 и встраивается в форму. Интерфейс инспектора вшит в системнуюlibwebkit2gtk, поэтому Answer42 его не меняет: переменная GLibG_RESOURCE_OVERLAYSподставляет тест-клиенту из каталога сессии один файл инспектора (localizedStrings.js) с мостом. Answer42 ставит фокус в HTML-поле средствами клиента тестирования и отправляет клавишу черезxdotool, после чего интерфейс инспектора подключается сам (около 1 с). Нуженxdotool; на живом дисплее горячая клавиша уходит в окно 1С. - Linux,
consoleне поддерживается: встроенный инспектор WebKitGTK не отдельное окно X11, поэтому клавиши уходят в элемент с фокусом — в саму страницу. В проверке набранный загрузчик попал в поле ввода чата и был отправлен как сообщение.
Клиент тестирования в браузере. start_session(client_mode="browser", base_url=<веб-публикация>) (или ONEC_MCP_CLIENT_MODE=browser) запускает не тонкий клиент, а веб-клиент 1С в Chrome/Edge (путь: browser_path или ONEC_MCP_BROWSER_PATH, иначе ищется установленный; browser_headless — без окна). Страница открывается с ключами веб-клиента TESTCLIENT и TESTCLIENTID, Answer42 входит в систему и просит менеджер тестирования подключиться к клиенту по идентификатору. Браузер запущен с портом DevTools, поэтому инструменты html_* (html_text, html_query, html_click, html_type, html_wait, html_console, html_download, html_eval с --dev-tools) работают со всей страницей клиента как с сайтом, а browser_screenshot, browser_press_key и browser_navigate дополняют их. Если менеджер не смог связаться с браузерным клиентом, сессия остаётся: в test_client будут connected: false и attach_error, инструменты форм и таблиц недоступны, DOM-инструменты работают.
Внешний браузер на Linux. Ссылки и файлы, которые 1С открывает «снаружи» (например, «Скачать» в HTML-поле или ЗапуститьПриложение), платформа открывает через xdg-open и ждёт его завершения, а xdg-open ждёт браузер, который ему пришлось запустить. Без Answer42 клиент 1С висел, пока не закроют Chrome, а с ним вставали мост тест-клиента и инструменты html_*. Поэтому тест-клиент получает в PATH обёртку xdg-open от Answer42: она записывает адрес и сразу возвращает управление, а на настоящем дисплее открывает адрес в браузере отдельно от клиента. Записанные адреса видны в external_opens ответов html_field_click_link и session_status; файл по такому адресу скачивает html_download. ONEC_MCP_EXTERNAL_OPEN: auto (по умолчанию: на собственном Xvfb Answer42 только записывать, на настоящем дисплее ещё и открывать), open, record, off (без обёртки).
Ограничения: на Windows инспектор остаётся встроенным в форму и попадает на скриншоты. html_console на Linux и с мостом в инспекторе платформы отдаёт сообщения с момента загрузки страницы, а с загрузчиком в консоли — с момента подключения (collected_since); неподдержанный синтаксис в скриптах страницы находит проверка скриптов (check_scripts). Встроенный WebKit Windows-клиента 1С не поддерживает часть современного JavaScript (например ?.), а WebKitGTK на Linux — поддерживает: одна и та же страница может работать в одном клиенте и ломаться в другом.
Безопасное хранение логинов и паролей
Чтобы креды были доступны MCP-серверу, но не попадали в чат и аргументы tool-call, храните их в локальном файле за пределами репозитория и передайте путь в окружение процесса Answer42:
export ONEC_MCP_CREDENTIALS_FILE=/secure/path/credentials.json
Если переменная окружения не задана, MCP-сервер читает файл по умолчанию:
~/.answer42-credentials.json
Формат файла v2 (аккаунт-bound):
{
"version": 2,
"accounts": {
"tenant-42": {
"entries": [
{
"url": "https://example.invalid/infobase",
"username": "<USERNAME>",
"password": "<PASSWORD>",
"title": "dev-example",
"aliases": ["dev42"]
},
{
"url": "https://*.example.invalid/*",
"username": "<WILDCARD_USERNAME>",
"password": "<WILDCARD_PASSWORD>",
"title": "wildcard-example",
"aliases": ["we"]
}
]
}
}
}
Устаревший формат v1 (плоский список entries) автоматически загружается в аккаунт legacy и переводится в v2 при следующем сохранении. Рекомендуется явно задать account_id (через claim авторизации HTTP или ONEC_MCP_ACCOUNT_ID в stdio) и перенести записи в нужный аккаунт.
Рекомендуемые права на файл: 0600.
Правила матчинга внутри аккаунта: сначала точное совпадение url, затем wildcard (*, ?) через fnmatch; первое совпадение побеждает. Пароли не логируются и не возвращаются наружу.
Без агента запись добавляется из командной строки. Пароль запрашивается интерактивно (или читается из первой строки stdin с --password-stdin) и в аргументы команды не попадает:
answer42 credentials add --url "<TARGET_INFOBASE_URL>" --username "<USERNAME>" [--title dev-01] [--alias dev01]
answer42 credentials list
answer42 credentials remove --url "<TARGET_INFOBASE_URL>"
Аккаунт по умолчанию — ONEC_MCP_ACCOUNT_ID или default; для HTTP-режима без явного account_id передайте --token <Bearer-токен> (аккаунт вычисляется так же, как на сервере) или --account. Файл — ONEC_MCP_CREDENTIALS_FILE или --file. Запущенный сервер перечитывает файл при следующем обращении к кредам, если файл изменился, перезапуск не нужен.
Для сохранения или обновления записи можно использовать MCP-tool:
credentials_save(
url="<TARGET_INFOBASE_URL>",
username="<USERNAME>",
password="<PASSWORD>"
)
Для удаления записи:
credentials_remove(url="<TARGET_INFOBASE_URL>")
Для проверки, что для адреса есть сохранённые креды, используйте MCP-tool:
credentials_check(base_url="<TARGET_INFOBASE_URL>")
Ответы этих tools содержат только факт наличия/изменения/удаления записи и URL; логины и пароли не возвращаются. credentials_list() дополнительно показывает статус проверки (verified / verification_status): новые или изменённые записи сохраняются как unverified, после успешного start_session с этой учёткой помечаются как verified, а unverified запись удаляется при ошибке авторизации. Tool credentials_list() оставлен в коде для локальной диагностики, но в OpenClaw-конфигурации его рекомендуется скрывать через toolFilter.exclude, чтобы агент не мог получить список URL-шаблонов.
Остановка сессии:
stop_session(session_id="my-session", clean_data=False)
Данные сессии лежат в <временная папка>/answer42/sessions/<session_id> (переопределяется ONEC_MCP_DATA_DIR). При остановке без clean_data сохраняется только служебная база менеджера (для быстрого повторного старта), а кэши автономного сервера (ibsrv-data*/session-data, temp, perf-data, ~640 МБ на сессию) удаляются. Сервер раз в час убирает папки, которые не использует ни одна живая сессия: не менявшиеся дольше ONEC_MCP_SESSION_DATA_TTL_HOURS часов (по умолчанию 24) удаляются целиком, у остальных удаляются кэши; 0 отключает удаление папок целиком. Та же зачистка (раз в час и при старте сервера) охватывает общие автономные серверы <временная папка>/answer42/shared-file-servers (кэши остановленного сервера удаляются сразу при освобождении последним владельцем, запущенные серверы не трогаются) и служебные папки без владельца (ib-build-cf, html-inspector от старых версий).
Требования
- Python 3.11+
- 1С:Предприятие 8.3.27+ или 8.5+
- Пакеты Python:
mcp,websockets,pydantic; для скриншотов —mss - Linux/X11:
python-xlib/wmctrl/xdotool, GUI/Xvfb для headless-сервера; OS-слой допускается для подготовки геометрии окна (resize/maximize), но не для ввода/кликов/автоматизации 1С - Windows: интерактивная пользовательская desktop-сессия; window-control и screenshots работают через WinAPI/
mss, ввод/клики/автоматизация 1С выполняются только через API клиента тестирования
Проверяйте наличие платформы 1С в стандартных каталогах: Linux /opt/1cv8/x86_64/<version>/ и /opt/1cv8/i386/<version>/; Windows C:\Program Files\1cv8\<version>\bin\ и C:\Program Files (x86)\1cv8\<version>\bin\; macOS /Applications/1cv8/<version>/ или /opt/1cv8/<version>/. Для штатной работы нужны 1cv8c и ibcmd; ibsrv желателен, но при его отсутствии Answer42 может использовать fallback /F. Если автоопределение ошиблось, задайте ONEC_PLATFORM_DIR. Для очень медленного старта web-клиента можно увеличить ONEC_MCP_TEST_CLIENT_READY_TIMEOUT и timeout MCP-клиента; по умолчанию Answer42 ждёт открытия -TPort 55 секунд и затем отдаёт явную ошибку с логами клиента.
Безопасность стендов и учётных данных
В репозитории не должно быть реальных URL стендов, логинов или паролей. Для штатного запуска передавайте только base_url, а логин/пароль храните в локальном credentials-файле, доступном процессу Answer42 через ONEC_MCP_CREDENTIALS_FILE.
start_session всё ещё принимает username и password напрямую для разовых сценариев и обратной совместимости. Используйте это только когда осознанно готовы раскрыть значения вызывающему агенту: параметры MCP-вызова могут попасть в историю чата, логи клиента или отладочный вывод. Если вместо реального пароля передан редактированный плейсхолдер из звёздочек (***, ******** и т.п.), Answer42 остановит запуск с явной ошибкой: нужно указать настоящий пароль или сохранить корректные креды через credentials_save().
Примеры в документации используют только плейсхолдеры (<TARGET_INFOBASE_URL>, <USERNAME>, <PASSWORD>). Перед публикацией артефактов проверяйте, что параметры вызовов заредактированы: recorder маскирует ключи вроде password, но URL и логин тоже не должны попадать в публичные материалы.
Архитектура
Поток выполнения:
- MCP-клиент вызывает tools через stdio MCP.
- Answer42 принимает MCP-вызовы и передаёт команды в WebSocket bridge.
- 1С test manager подключается к bridge и выполняет BSL-dispatch.
- Test manager управляет 1С test client через API
ТестируемоеПриложение. - Test client выполняет интерактивные операции в целевой информационной базе.
Подробнее: docs/architecture.md.
Сборка конфигураций 1С
Конфигурация менеджера тестирования собирается из XML-исходников src/cf/ через временную файловую ИБ: ibcmd infobase config import и затем ibcmd config save (приоритетный способ). Такой путь создаёт переносимый .cf с режимом совместимости XML-исходников; если ibcmd нет, используется Конфигуратор (DESIGNER):
python scripts/build_cf.py src/cf build/MCPTestManager.cf
PowerShell:
python scripts/build_cf.py src/cf build/MCPTestManager.cf
Тестовая конфигурация для E2E собирается из XML-исходников src/client_cf/:
python scripts/build_cf.py src/client_cf build/MCPTestClient.cf
PowerShell:
python scripts/build_cf.py src/client_cf build/MCPTestClient.cf
В Git хранятся только XML-исходники; CF — генерируемые артефакты. start_session использует build/MCPTestManager.cf только при точном совпадении content fingerprint с src/cf/; иначе автоматически пересобирает его локальной выбранной платформой. Встроенный demo-клиент аналогично работает с build/MCPTestClient.cf и src/client_cf/. Релизный wheel получает оба CF из GitLab CI, где они собираются закреплённой платформой 1С 8.3.27.2342.
E2E можно запускать целиком или по независимым сценариям:
python3 scripts/e2e_stable.py # full
E2E_SCENARIO=smoke python3 scripts/e2e_stable.py # быстрый smoke
E2E_SCENARIO=dynamic python3 scripts/e2e_stable.py # legacy: таблицы/dynamic-list/отчёт
E2E_SCENARIO=dynamic-tables python3 scripts/e2e_stable.py
E2E_SCENARIO=dynamic-lists python3 scripts/e2e_stable.py
E2E_SCENARIO=dynamic-reports python3 scripts/e2e_stable.py
E2E_SCENARIO=coverage python3 scripts/e2e_stable.py # diagnostic/negative tools
Для реального распараллеливания сценарий умеет сам запустить пять разные сессий (smoke, dynamic-tables, dynamic-lists, dynamic-reports, coverage), а не копии одного и того же теста. Встроенная тестовая файловая база публикуется через один общий ibsrv, когда серверные компоненты доступны; без ibsrv demo-клиент запускается через file-direct (/F):
E2E_PARALLEL=1 E2E_SESSION_ID=e2e-split python3 scripts/e2e_stable.py
start_session также переиспользует общий автономный сервер для одинаковой файловой базы. Последний stop_session освобождает refcount и завершает shared ibsrv.
Ограничения
- Форма пользовательской настройки «Изменить форму» частично недоступна для надёжной автоматизации через API клиента тестирования. В частности, команда «Добавить поля» в верхней панели формы настройки может быть видна на скриншоте и в диагностическом тексте, но не нажиматься как обычная
ТестируемаяКнопкаФормы:click_buttonможет не находить её, аfocus_objectможет вернуть успешную фокусировку без открытия диалога добавления полей.
Лицензия
MIT
Copyright
Copyright (c) 2026 Kosolapov Stanislav aka proDOOMman prodoomman@gmail.com, Marvin (AI Assistant), 42Clouds, and contributors.
Распространяется по лицензии MIT.
Metadata
Release files for answer42 0.11.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| answer42-0.11.9.tar.gz | 941.3 kB | Without provenance | Details for answer42-0.11.9.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| answer42-0.11.9-py3-none-any.whl | Python 3 | none | any | Details for answer42-0.11.9-py3-none-any.whl |
Total release size: 1.4 MB
Release files / answer42-0.11.9.tar.gz
| Download URL | answer42-0.11.9.tar.gz |
|---|---|
| Size | 941.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f1bee21761cf278671f83052b06dea0c95ee5b08a755d3ff3cf1ffb9663e9d19
|
|
BLAKE2b-256 checksum How to use checksums |
5273428803547ddeea3d465cf3e90792bd9ad32776732be8a2d249b5cf9e140d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.18
|
Release files / answer42-0.11.9-py3-none-any.whl
| Download URL | answer42-0.11.9-py3-none-any.whl |
|---|---|
| Size | 423.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1bcb914ecf53501c50e452f47c7bdb7693a3f9f3ad92408eafc5526c71c58b79
|
|
BLAKE2b-256 checksum How to use checksums |
c9e532ff1c535ad25c66e4e9b1183134203d022c2c617f6f23e97316ff82ee27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.18
|
Security for answer42 0.11.9
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.