127 lines
9.1 KiB
Markdown
127 lines
9.1 KiB
Markdown
# 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`.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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 — по этим замерам.
|