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

128 lines
9.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 — по этим замерам.