ИРУ — Инструкция по подключению

Что понадобится

• Компьютер Windows 10/11 или Linux для агента;
• токен доступа пользователя;
• доступ к Web UI: irumode.ru или локальный адрес сервера.

Шаг 3: первичная настройка агента

1. Введите серверный адрес и токен доступа.
2. Дождитесь статуса подключения.
3. На Windows агент работает как tray-first приложение; в headless режиме он пишет логи локально.

Шаг 4: войдите в Web UI

1. Откройте irumode.ru или адрес вашего сервера.
2. Войдите с тем же токеном.
3. Выберите устройство в списке.
4. Откройте Device Passport и проверьте подключение.

Шаг 5: подготовьте устройство

• Активация: нажмите «Активировать» или попросите ИРУ активировать устройство. Используется `device.activate`.
• Python runtime: нажмите «Подготовить Python» или попросите ИРУ подготовить runtime. Используется `device.prepare_runtime`.
• Снимок состояния: нажмите «Проверить состояние». Используется `device.refresh_state`.

Что должно быть видно

• Device Passport: activation, runtime, Python, pip, health, identity, snapshot source;
• used tools в ответах ИРУ;
• для GUI-задач — `app.launch` и `window.verify` / `app.verify_launch`;
• для записи текстовых файлов — `write_content`, а не shell fallback.

Примеры запросов

• Активируй это устройство
• Подготовь managed Python runtime
• Проверь состояние устройства и покажи CPU/RAM/GPU
• Создай файл на рабочем столе с текстом "проверка ИРУ"
• Проверь, открыт ли Блокнот
• Запусти PyQt-приложение и проверь, что окно видно

Локальные данные агента

Основное состояние агента хранится в %LOCALAPPDATA%\IRU на Windows и ~/.iru на Linux. Там находятся receipts, runtime, state snapshot, passport cache, logs, traces и artifacts.

Частые проблемы

Агент не подключается

• Проверьте адрес сервера и токен.
• Проверьте интернет-соединение и доступность WebSocket.
• Откройте диагностику агента из трея и посмотрите последний статус.

Device Passport пустой или stale

• Нажмите «Проверить состояние».
• Если агент reconnect только что произошёл, дождитесь registration payload.
• Если устройство offline, сервер не может прочитать локальный cache до reconnect агента.