Покой 1,6 МБ, окно 97,3 МБ, открытие 583/564 мс — цели #1.8 подтверждены на Windows 11. В AGENTS.md добавлена папка poc/. Refs: 1.8.1, 1.8.2
9.1 KiB
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'); identifierru.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 — по этим замерам.