Files
shtil/docs/adr/0005-agent-and-helper.md
T
TMSH 891dd7207c
ci / smoke (pull_request) Successful in 3s
docs: добавлены функции Помощника по фазам и черновик ADR-0005
- docs/architecture/helper.md: фаза 1 (обращения), фаза 2 (удалённый
  доступ, уведомления, захват экрана), границы, черновой список IPC
- docs/adr/0005-agent-and-helper.md: статус «Предложено», решение
  по технологии открыто до замера на Astra 1.8 (#1.8.3)

Refs: 1.8.4, 1.8.5
2026-11-11 00:54:05 +03:00

4.7 KiB

ADR-0005: ПО на устройстве — Агент и Помощник

  • Статус: Предложено
  • Дата: 2026-11-11
  • Задача: #1.8
  • Участники: Oleg, Максим
  • Зоны: shared

Контекст

Пользователю нужен интерфейс на ПК: сообщить о проблеме, видеть статус обращения, подтвердить удалённое подключение. Агент — служба в Session 0 (Windows) / systemd (Linux) и физически не может показывать окна. Значит на устройстве два компонента: служба-агент и «Штиль Помощник» в сессии пользователя. Оставалось выбрать технологию Помощника: критерии — в покое ≤ 40 МБ ОЗУ, с открытым окном ≤ 150 МБ, открытие ≤ 1 с, общий UI-стек с приложением, работа в изолированном контуре.

Решение

Черновик до решения #1.8.3: архитектура подтверждена, выбор технологии ждёт замер на Astra 1.8.

  • На устройстве два компонента: агент (служба, SYSTEM/root, единственный канал к серверу по mTLS) и Помощник (процесс в сессии пользователя, иконка в трее, без прав администратора).
  • Помощник общается только с агентом по IPC (named pipe / unix socket, Protobuf, proto/helper/v1); агент проверяет подлинность Помощника (путь, подпись бинарника, пользователь сессии).
  • Запуск: Windows — агент отслеживает входы и запускает Помощника в сессиях; Linux — XDG autostart, агент контролирует наличие. Пункта «Выход» нет, при падении агент перезапускает.
  • Один установщик «агент + Помощник»; на серверах Помощник по умолчанию выключен. Иконка и название переопределяются конфигом (white-label для MSP).
  • Технология (предложение): Tauri 2 в режиме «только трей»: окна нет при старте, форма создаётся по клику и уничтожается при закрытии. Подтверждено PoC (poc/helper-tray, docs/research/helper-tray-poc.md): Windows 11, release, медиана из 5 прогонов — покой 2,0 МБ PrivateBytes, открытие 580/555 мс, окно 155,3 МБ PrivateBytes (цель 150 — превышение ~5 МБ признано допустимым, т.к. расход даёт WebView2-движок, общий с приложением).
  • Функции Помощника по фазам — docs/architecture/helper.md.

Рассмотренные варианты

Вариант Плюсы Минусы
Tauri 2 трей + окно на WebView Общий UI-стек и дизайн-система с приложением, один язык для команды, WebView2 уже есть на Windows Окно ~155 МБ PB > цели 150; на Linux зависит от WebKitGTK 4.1
Трей на Go + окно Tauri по запросу Покой ещё ниже (~2–3 МБ и так 2 МБ) Окно всё равно на WebView — выигрыша по памяти с окном нет; второй стек IPC/сборки; выигрыш только в покое, который и так 20× ниже цели
Нативный трей + нативные окна (Go/Qt/winfrey) Минимум памяти Нет общего UI с приложением, два UI-стека, дороже поддержка — отклонено по трудозатратам

Последствия

  • Нужны proto/helper/v1 (черновик методов — docs/architecture/helper.md) и каркас apps/helper/ на следующих шагах.
  • Запасной путь при провале цели на Astra/РЕД ОС: трей на Go, окно Tauri по запросу.
  • Решение пересматривается, если замер на Astra 1.8 (#1.12.5) покажет окно значительно выше ~160 МБ или открытие > 1 с.
  • poc/ удаляется после принятия ADR.