gui-control

Управление GUI 1С через X11

Назначение

Навык учит агента управлять графическим интерфейсом 1С в окружениях с виртуальным X11-дисплеем (Xvfb). Используется когда стандартные инструменты (ЖР, ТЖ) недоступны или недостаточны — например, база «зависла» на диалоге ошибки и не завершается корректно.

Стек:

Xvfb :99 (виртуальный фреймбуфер)
    ├── python-xlib   → читает метаданные окон (заголовки, геометрия), симулирует ввод
    └── PIL ImageGrab → читает пиксели фреймбуфера → скриншот

Принцип: X11-управление — это action, не диагностика. Использовать только когда детектирован GUI-диалог, блокирующий нормальное завершение базы. Диагностику причин — через ЖР (event-log-analysis).

Когда применять

Настройка окружения

import os
os.environ['DISPLAY'] = ':99'

Переменная должна быть установлена до импорта Xlib и PIL.

Сценарии использования

Сценарий 1: Детектировать диалог ошибки 1С

Цель: проверить, не завис ли GUI на диалоге ошибки, не читая ЖР.

import os
os.environ['DISPLAY'] = ':99'
from Xlib import display

d = display.Display()
root = d.screen().root

error_windows = []
for win in root.query_tree().children:
    name = win.get_wm_name()
    wm_class = win.get_wm_class()
    if wm_class and '1cv8' in wm_class:
        if name and any(kw in name for kw in ['Ошибка', 'Предупреждение', 'Error']):
            error_windows.append({'id': win.id, 'name': name})

print(error_windows)

Интерпретация:

Сценарий 2: Закрыть диалог ошибки и завершить базу

Цель: закрыть базу «естественным путём» после обнаруженного диалога ошибки, чтобы затем анализировать ЖР.

Последовательность клавиш:

1. Enter — закрыть диалог ошибки.
2. Escape — инициировать закрытие приложения.
3. Enter — подтвердить закрытие.

import os, time
os.environ['DISPLAY'] = ':99'
from Xlib import display, X
from Xlib.ext.xtest import fake_input

def send_key(d, keycode, delay=0.3):
    fake_input(d, X.KeyPress, keycode)
    d.flush()
    time.sleep(delay)
    fake_input(d, X.KeyRelease, keycode)
    d.flush()
    time.sleep(delay)

d = display.Display()
ENTER  = d.keysym_to_keycode(0xFF0D)
ESCAPE = d.keysym_to_keycode(0xFF1B)

send_key(d, ENTER)   # закрыть диалог ошибки
time.sleep(1)
send_key(d, ESCAPE)  # инициировать закрытие
time.sleep(1)
send_key(d, ENTER)   # подтвердить закрытие

Важно: после выполнения подождать 2–3 секунды и проверить через сценарий 1, что окон 1С больше нет.

Сценарий 3: Скриншот для лога

Цель: зафиксировать состояние экрана перед закрытием диалога ошибки.

Когда нужен: только для лога или ручной отладки. В автоматическом пайплайне — опционально, перед шагом 2.

import os
os.environ['DISPLAY'] = ':99'
from PIL import ImageGrab
from Xlib import display

d = display.Display()
root = d.screen().root

for win in root.query_tree().children:
    name = win.get_wm_name()
    wm_class = win.get_wm_class()
    if wm_class and '1cv8' in wm_class:
        geom = win.get_geometry()
        img = ImageGrab.grab(bbox=(
            geom.x, geom.y,
            geom.x + geom.width,
            geom.y + geom.height
        ))
        path = f'/tmp/onec_{win.id}.png'
        img.save(path)
        print(f'Скриншот сохранён: {path}')

Типичный пайплайн: тесты завершились, база не закрылась

1. search_event_log(from=test_start_time, limit=20)
       │
       ├── есть события, нет Error → база работает, ждать
       ├── есть Error              → скриншот (сценарий 3) → закрыть (сценарий 2) → анализ ЖР
       └── нет событий             → детектировать окна (сценарий 1)
                                          │
                                          ├── окно с ошибкой → скриншот → закрыть
                                          └── нет окон       → база не запустилась

Безопасность

Типичные ошибки

Capabilities

Связанные навыки

depends_on: []