Files
shtil/docs/research/helper-tray-poc.md
T
TMSH 4abe485e73 docs: добавлены результаты замеров PoC Помощника
Покой 1,6 МБ, окно 97,3 МБ, открытие 583/564 мс — цели #1.8
подтверждены на Windows 11. В AGENTS.md добавлена папка poc/.

Refs: 1.8.1, 1.8.2
2026-11-09 22:53:43 +03:00

9.1 KiB
Raw Blame History

PoC «Штиль Помощник»: Tauri только с иконкой в трее

Задачи #1.8.1–1.8.2, задел для решения ADR-0005 (выбор технологии Помощника — #1.8.3). Код — poc/helper-tray/. Папка poc/ временная: после принятия ADR-0005 удаляется.

Что проверяем

Рекомендация карты: Tauri 2 в режиме «только трей» — при старте окно не создаётся, WebView не запускается; окно создаётся по клику и уничтожается при закрытии. Цели из дорожной карты:

Метрика Цель
ОЗУ в покое (только трей) ≤ 40 МБ
ОЗУ с открытым окном ≤ 150 МБ
Время открытия окна ≤ 1 с

Если цели не достигаются — запасной вариант: трей на Go + окно Tauri по запросу.

Как устроен PoC

  • src-tauri/tauri.conf.json: app.windows: [] — окна при старте нет; строгий CSP (default-src 'self'; style-src 'self' 'unsafe-inline'); identifier ru.tbsoft.shtil.helper.poc.
  • src-tauri/src/lib.rs:
    • трей (tray-icon) с меню «Сообщить о проблеме» / «Мои обращения» / «О программе»; пункт «Выход» есть только в debug-сборке (cfg!(debug_assertions));
    • каждый пункт создаёт окно через WebviewWindowBuilder с меткой win-<view>-<n>; закрытие окна уничтожает его (не hide), повторный клик — новое окно;
    • RunEvent::ExitRequested → prevent_exit(), иначе закрытие последнего окна завершает приложение, живущее в трее;
    • замер времени открытия: Instant перед build() окна → фронтенд после mounted + requestAnimationFrame вызывает команду first_paint → разница в мс пишется в лог. Команда приложения — не событие и не плагин, поэтому capability содержит только core:default на окна win-*;
    • флаг --measure-scenario (только для замера): приложение по таймеру делает 30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно → 10 с → закрывает и завершается. Отметки этапов пишутся в helper-tray-poc.measure.log рядом с exe за ~1,5 с до действия, чтобы скрипт успел снять ОЗУ.
  • src/App.vue: форма по прототипу — кнопки-категории, поле описания, кнопка «Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки.
  • measure.ps1: запускает exe с --measure-scenario, читает отметки из лога, снимает private working set (WorkingSetPrivate, Win32_PerfFormattedData_PerfProc_Process) по дереву процессов — приложение + все дочерние msedgewebview2.exe (по цепочке родителей и по user-data-dir в командной строке). 5 прогонов, медиана и разброс.

Сборка и запуск

Версии инструментов — docs/environment.md.

cd poc/helper-tray
pnpm install
pnpm tauri build        # release-сборка: exe и установщики в src-tauri/target/release/
# без установщиков быстрее: pnpm tauri build --no-bundle

Запуск: src-tauri/target/release/helper-tray.exe — появляется только иконка в трее, окна нет. В release-режиме выхода из меню нет: завершение — через диспетчер задач или taskkill /IM helper-tray.exe /F.

Разработка: pnpm tauri dev (в debug-сборке есть пункт «Выход (debug)»).

Linux (Astra 1.8 / Debian 12)

Зависимости из docs/environment.md (включая libayatana-appindicator3-dev). Дальше те же pnpm install и pnpm tauri build. Примечания:

  • иконка в трее требует работающего AppIndicator/StatusNotifier (в Astra — через расширение трея, если трей пустой — это ограничение среды, не PoC);
  • measure.ps1 — только Windows. Для Linux замер вручную: запуск с --measure-scenario, в моменты отметок лога снять PSS дерева процессов (smem -P <pid> или сумма Private_* из /proc/<pid>/smaps_rollup по дереву pstree -p <pid>). Строку для результатов см. в таблице.

Методика замера (как в задании)

  • Только release-сборка. Каждый замер — 5 прогонов сценария, в отчёт — медиана и разброс (min–max).
  • ОЗУ в покое — через 30 с после старта, до первого окна.
  • ОЗУ с открытым окном — через 10 с после открытия.
  • ОЗУ после закрытия окна — через 10 с (проверка освобождения).
  • Время открытия — холодное (первое окно) и тёплое (повторное), из лога.
  • ОЗУ — private working set всего дерева процессов (обычный working set завышает цифру на общую память WebView2).

Результаты

ОС: Windows 11 · машина Frontend-разработчика · дата: 2026-11-09 · сборка release.

Метрика Цель Медиана (5 прогонов) Разброс Итог
ОЗУ в покое ≤ 40 МБ 1,6 МБ 1,6 – 1,6 ✅
ОЗУ с открытым окном ≤ 150 МБ 97,3 МБ 96,8 – 97,6 ✅
ОЗУ после закрытия освобождение 3,6 МБ 3,5 – 29,0 ✅
Открытие окна, холодное ≤ 1 с 583 мс 577 – 702 ✅
Открытие окна, тёплое ≤ 1 с 564 мс 524 – 665 ✅
ОЗУ повторно открытого окна — 97,8 МБ 97,6 – 122,7 —
ОС Покой Окно После закрытия Открытие хол./тёпл. Дата
Windows 11 1,6 МБ 97,3 МБ 3,6 МБ 583 / 564 мс 2026-11-09
Astra 1.8 — ждём VM #1.12.5 —

Выводы

  • Все три цели на Windows 11 выполнены с большим запасом: покой 1,6 МБ (цель ≤ 40), окно ~97 МБ (цель ≤ 150), открытие ~0,58 с (цель ≤ 1 с).
  • «Только трей» реально не запускает WebView2 до первого окна: в покое живёт только Rust-процесс с иконкой (1,6 МБ private working set).
  • destroy() при закрытии полностью освобождает память — через 10 с остаётся ~3,6 МБ самого процесса. В одном прогоне замер поймал 29 МБ — процессы WebView2 завершаются не мгновенно; медиана подтверждает освобождение.
  • Холодное и тёплое открытие почти не различаются (~0,6 с): WebView2 runtime стартует быстро даже первый раз.
  • Для ADR-0005: на Windows 11 вариант «Tauri только трей» удовлетворяет целям. Решающий фактор — повторение замера на Astra 1.8 (WebKitGTK может дать другие цифры и потребует AppIndicator): Максим, после появления VM #1.12.5.
  • Что переносить в Помощник при выборе Tauri: паттерн app.windows: [] + prevent_exit, фабрика окон с destroy, замер first_paint, минимальные capabilities и строгий CSP, меню трея без «Выход».

Что PoC не делает (вне задания)

Нет IPC с агентом, отправки обращений, уведомлений, i18n, дизайн-системы, автозапуска, установщика-поставки. Решение по технологии Помощника принимается в #1.8.3 совместно с Backend — по этим замерам.