[1.8] PoC Помощника: трей и замеры на Windows #8

Merged
TMSH merged 5 commits from feat/1.8-helper-tray-poc into main 2026-11-10 21:42:07 +00:00
4 changed files with 70 additions and 47 deletions
Showing only changes of commit 457a7d8b71 - Show all commits

No files matched your search

@@ -13,24 +13,26 @@ author: Frontend
# [1.8] PoC Помощника: Tauri только с иконкой в трее # [1.8] PoC Помощника: Tauri только с иконкой в трее
## Сделано ## Сделано
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` от завершения по закрытию последнего окна. Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки). - `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` только при `code.is_none()` (иначе `app.exit(0)` блокируется). Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke (capability только `core:default` на `win-*`). - Замер времени открытия — команда `first_paint` по invoke после двойного rAF (capability с пустым `permissions` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log`, скрипт снимает private working set дерева процессов по отметкам. - `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log` (рядом с exe или в `%TEMP%`), скрипт снимает **PrivateBytes** и WorkingSetPrivate дерева процессов.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой **1,6 МБ**, окно **97,3 МБ**, после закрытия **3,6 МБ**, открытие **583/564 мс**. Все цели выполнены. Таблица и выводы — `docs/research/helper-tray-poc.md`. - Замеры Windows 11 (release, 5 прогонов, медиана): покой **2,0 МБ PB**, окно **155,3 МБ PB** (цель 150 — не дотянуто ~5 МБ), после закрытия **5,2 МБ PB**, открытие **580/555 мс**. Таблица и выводы — `docs/research/helper-tray-poc.md`.
- `AGENTS.md` раздел 5: добавлена строка про `poc/`. - `AGENTS.md` раздел 5: добавлена строка про `poc/`.
## Решения ## Решения
- Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным. - Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным.
- Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, минимальный capability — `core:default`. - Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, capability окон с пустым `permissions`.
- Решающая метрика ОЗУ — PrivateBytes: WorkingSetPrivate у простаивающих процессов занижен Windows.
- CSP: `connect-src ipc: http://ipc.localhost` — иначе на Linux/macOS IPC уходит в postMessage-запасной режим.
## Для другой стороны ## Для другой стороны
- Максиму: повторить замер на Astra 1.8, когда будет VM (#1.12.5). Инструкция — `docs/research/helper-tray-poc.md` (measure.ps1 Windows-only, для Linux PSS/`smem`). - Максиму: повторить замер на Astra 1.8, когда будет VM (#1.12.5). Инструкция — `docs/research/helper-tray-poc.md` (measure.ps1 Windows-only, для Linux PSS/`smem`).
- Замеры нужны для ADR-0005 (#1.8.3) — решение принимаем вместе, сам по себе PoC технологию не выбирает. - Замеры нужны для ADR-0005 (#1.8.3) — решение принимаем вместе, сам по себе PoC технологию не выбирает.
## Проверка ## Проверка
- `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit` проходит. - `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit`, `cargo clippy`, `cargo fmt --check` проходят.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, метрики записаны. - `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, приложение завершается само во всех прогонах (`app.exit(0)` не блокируется).
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию. - Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию. Предупреждение о postMessage-запасном IPC проверить в devtools можно только вручную — на Windows IPC идёт через `window.ipc.postMessage` и не зависит от `connect-src`.
## Осталось ## Осталось
- [ ] Замер на Astra 1.8 — Максим, VM #1.12.5. - [ ] Замер на Astra 1.8 — Максим, VM #1.12.5.
+57 -36
View File
@@ -20,30 +20,38 @@ WebView не запускается; окно создаётся по клику
## Как устроен PoC ## Как устроен PoC
- `src-tauri/tauri.conf.json`: `app.windows: []` — окна при старте нет; строгий CSP - `src-tauri/tauri.conf.json`: `app.windows: []` — окна при старте нет; строгий CSP
(`default-src 'self'; style-src 'self' 'unsafe-inline'`); identifier `ru.tbsoft.shtil.helper.poc`. (`default-src 'self'; style-src 'self' 'unsafe-inline'; connect-src ipc: http://ipc.localhost`
— последнее нужно IPC по кастомному протоколу на Linux/macOS, иначе Tauri
переходит на postMessage-запасной вариант); identifier `ru.tbsoft.shtil.helper.poc`.
- `src-tauri/src/lib.rs`: - `src-tauri/src/lib.rs`:
- трей (`tray-icon`) с меню «Сообщить о проблеме» / «Мои обращения» / «О программе»; - трей (`tray-icon`) с меню «Сообщить о проблеме» / «Мои обращения» / «О программе»;
пункт «Выход» есть только в debug-сборке (`cfg!(debug_assertions)`); пункт «Выход» есть только в debug-сборке (`cfg!(debug_assertions)`);
- каждый пункт создаёт окно через `WebviewWindowBuilder` с меткой `win-<view>-<n>`; - каждый пункт создаёт окно через `WebviewWindowBuilder` с меткой `win-<view>-<n>`;
закрытие окна уничтожает его (не `hide`), повторный клик — новое окно; закрытие окна уничтожает его (не `hide`), повторный клик — новое окно;
- `RunEvent::ExitRequested` → `prevent_exit()`, иначе закрытие последнего окна - `RunEvent::ExitRequested` → `prevent_exit()` только при `code.is_none()`:
завершает приложение, живущее в трее; закрытие последнего окна не завершает приложение в трее, а программный
`app.exit(0)` (сценарий замера, «Выход (debug)») работает;
- замер времени открытия: `Instant` перед `build()` окна → фронтенд после - замер времени открытия: `Instant` перед `build()` окна → фронтенд после
`mounted` + `requestAnimationFrame` вызывает команду `first_paint` → разница `mounted` + двойной `requestAnimationFrame` (вторая рамка = первая уже
в мс пишется в лог. Команда приложения — не событие и не плагин, поэтому отрисована) вызывает команду `first_paint` → разница в мс пишется в лог.
capability содержит только `core:default` на окна `win-*`; Команды приложения не входят в ACL, плагинов нет — capability окон `win-*`
имеет пустой `permissions`;
- флаг `--measure-scenario` (только для замера): приложение по таймеру делает - флаг `--measure-scenario` (только для замера): приложение по таймеру делает
30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно → 30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно →
10 с → закрывает и завершается. Отметки этапов пишутся в 10 с → закрывает и завершается. Отметки этапов пишутся в
`helper-tray-poc.measure.log` рядом с exe за ~1,5 с до действия, чтобы `helper-tray-poc.measure.log` (рядом с exe, при недоступности — в `%TEMP%`)
скрипт успел снять ОЗУ. за ~1,5 с до действия, чтобы скрипт успел снять ОЗУ.
- `src/App.vue`: форма по прототипу — кнопки-категории, поле описания, кнопка - `src/App.vue`: форма по прототипу — кнопки-категории, поле описания, кнопка
«Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки. «Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки.
- `measure.ps1`: запускает exe с `--measure-scenario`, читает отметки из лога, - `measure.ps1`: запускает exe с `--measure-scenario`, читает отметки из лога,
снимает **private working set** (`WorkingSetPrivate`, снимает два счётчика дерева процессов (приложение + все дочерние
`Win32_PerfFormattedData_PerfProc_Process`) по дереву процессов — приложение + `msedgewebview2.exe`, по цепочке родителей и по user-data-dir в командной
все дочерние `msedgewebview2.exe` (по цепочке родителей и по user-data-dir строке) из `Win32_PerfFormattedData_PerfProc_Process`:
в командной строке). 5 прогонов, медиана и разброс. - **PrivateBytes** — committed private memory. **Решение принимаем по ней:**
Windows урезает рабочий набор у простаивающих процессов, поэтому
WorkingSetPrivate для покоя занижен;
- **WorkingSetPrivate** — private working set, для справки.
5 прогонов, медиана и разброс.
## Сборка и запуск ## Сборка и запуск
@@ -81,44 +89,57 @@ pnpm tauri build # release-сборка: exe и установщики в
- ОЗУ с открытым окном — через 10 с после открытия. - ОЗУ с открытым окном — через 10 с после открытия.
- ОЗУ после закрытия окна — через 10 с (проверка освобождения). - ОЗУ после закрытия окна — через 10 с (проверка освобождения).
- Время открытия — холодное (первое окно) и тёплое (повторное), из лога. - Время открытия — холодное (первое окно) и тёплое (повторное), из лога.
- ОЗУ — private working set всего дерева процессов (обычный working set - ОЗУ — **PrivateBytes** всего дерева процессов (решающая метрика) и
завышает цифру на общую память WebView2). WorkingSetPrivate для справки. Обычный working set завышает цифру на общую
память WebView2, а private working set занижает её для простаивающих
процессов — Windows вытесняет их страницы.
## Результаты ## Результаты
ОС: Windows 11 · машина Frontend-разработчика · дата: 2026-11-09 · сборка release. ОС: Windows 11 · машина Frontend-разработчика · дата: 2026-11-09 · сборка release.
PB — PrivateBytes (решающая метрика), WS — WorkingSetPrivate (для справки).
| Метрика | Цель | Медиана (5 прогонов) | Разброс | Итог | | Метрика | Цель | Медиана (5 прогонов) | Разброс | Итог |
|---|---|---|---|---| |---|---|---|---|---|
| ОЗУ в покое | ≤ 40 МБ | 1,6 МБ | 1,6 – 1,6 | ✅ | | ОЗУ в покое, PB | ≤ 40 МБ | 2,0 МБ | 2,0 – 2,0 | ✅ |
| ОЗУ с открытым окном | ≤ 150 МБ | 97,3 МБ | 96,8 – 97,6 | ✅ | | ОЗУ в покое, WS | — | 1,5 МБ | 1,5 – 1,5 | — |
| ОЗУ после закрытия | освобождение | 3,6 МБ | 3,5 – 29,0 | ✅ | | ОЗУ с окном, PB | ≤ 150 МБ | 155,3 МБ | 154,9 – 158,3 | ⚠ +4 % к цели |
| Открытие окна, холодное | ≤ 1 с | 583 мс | 577 – 702 | ✅ | | ОЗУ с окном, WS | — | 97,3 МБ | 96,9 – 100,3 | — |
| Открытие окна, тёплое | ≤ 1 с | 564 мс | 524 – 665 | ✅ | | ОЗУ после закрытия, PB | освобождение | 5,2 МБ | 5,0 – 5,2 | ✅ |
| ОЗУ повторно открытого окна | — | 97,8 МБ | 97,6 – 122,7 | — | | ОЗУ после закрытия, WS | — | 3,6 МБ | 3,5 – 3,6 | — |
| Открытие окна, холодное | ≤ 1 с | 580 мс | 570 – 622 | ✅ |
| Открытие окна, тёплое | ≤ 1 с | 555 мс | 540 – 648 | ✅ |
| ОЗУ повторного окна, PB | — | 157,4 МБ | 155,6 – 160 | — |
| ОС | Покой | Окно | После закрытия | Открытие хол./тёпл. | Дата | | ОС | Покой, PB | Окно, PB | После закрытия, PB | Открытие хол./тёпл. | Дата |
|---|---|---|---|---|---| |---|---|---|---|---|---|
| Windows 11 | 1,6 МБ | 97,3 МБ | 3,6 МБ | 583 / 564 мс | 2026-11-09 | | Windows 11 | 2,0 МБ | 155,3 МБ | 5,2 МБ | 580 / 555 мс | 2026-11-09 |
| Astra 1.8 | — ждём VM #1.12.5 — | | | | | | Astra 1.8 | — ждём VM #1.12.5 — | | | | |
## Выводы ## Выводы
- Все три цели на Windows 11 выполнены с большим запасом: покой **1,6 МБ** - Покой и скорость открытия — с большим запасом: **2,0 МБ PB** (цель ≤ 40),
(цель ≤ 40), окно **~97 МБ** (цель ≤ 150), открытие **~0,58 с** (цель ≤ 1 с). открытие **~0,58 с** (цель ≤ 1 с). «Только трей» реально не запускает
- «Только трей» реально не запускает WebView2 до первого окна: в покое живёт WebView2 до первого окна — 2 МБ это весь процесс.
только Rust-процесс с иконкой (1,6 МБ private working set). - Окно по решающей метрике **155,3 МБ PB — на ~4 % выше цели 150 МБ**
- `destroy()` при закрытии полностью освобождает память — через 10 с остаётся (по WorkingSetPrivate — 97 МБ и цель формально выполнена). Это честный
~3,6 МБ самого процесса. В одном прогоне замер поймал 29 МБ — процессы предел WebView2 на Windows 11: private bytes включают зарезервированную,
WebView2 завершаются не мгновенно; медиана подтверждает освобождение. но не вытянутую память рендерера. Обсуждение того, насколько цель жёсткая
- Холодное и тёплое открытие почти не различаются (~0,6 с): WebView2 runtime и считаем ли проходом, — в #1.8.3.
стартует быстро даже первый раз. - `destroy()` при закрытии освобождает память полностью — через 10 с остаётся
- Для ADR-0005: на Windows 11 вариант «Tauri только трей» удовлетворяет целям. ~5,2 МБ PB самого процесса.
Решающий фактор — повторение замера на Astra 1.8 (WebKitGTK может дать - Холодное и тёплое открытие почти не различаются (~0,6 с); повторное окно по
другие цифры и потребует AppIndicator): Максим, после появления VM #1.12.5. памяти такое же (~157 МБ PB).
- Для ADR-0005: на Windows 11 режим «Tauri только трей» выполняет цели по
покою и скорости и не дотягивает ~5 МБ по окну. Запасной вариант «трей на
Go + окно Tauri» по памяти окна ничего не даст — окно в обоих вариантах на
Tauri/WebView2, выигрыш был бы только в покое, а там уже 2 МБ.
Решающий фактор — повторение замера на Astra 1.8 (WebKitGTK): Максим, после
появления VM #1.12.5.
- Что переносить в Помощник при выборе Tauri: паттерн `app.windows: []` + - Что переносить в Помощник при выборе Tauri: паттерн `app.windows: []` +
`prevent_exit`, фабрика окон с `destroy`, замер `first_paint`, минимальные `prevent_exit` при `code.is_none()`, фабрика окон с `destroy`, замер
capabilities и строгий CSP, меню трея без «Выход». `first_paint` (двойной rAF → invoke), пустой `permissions` у capability,
строгий CSP с `connect-src ipc: http://ipc.localhost`, меню без «Выход».
## Что PoC не делает (вне задания) ## Что PoC не делает (вне задания)
+2 -2
View File
@@ -11,7 +11,7 @@
## Сделано в текущем шаге ## Сделано в текущем шаге
- #1.2 правила git, шаблон PR, хуки, личные заметки `docs/private/`. - #1.2 правила git, шаблон PR, хуки, личные заметки `docs/private/`.
- #1.3 версии инструментов; hello world Tauri и Go на Windows (#1.3.9, часть Frontend/Windows). - #1.3 версии инструментов; hello world Tauri и Go на Windows (#1.3.9, часть Frontend/Windows).
- #1.8.1–1.8.2 PoC трея Помощника (`poc/helper-tray/`): покой 1,6 МБ, окно 97 МБ, открытие ~0,58 с — цели выполнены. Замеры — `docs/research/helper-tray-poc.md`. - #1.8.1–1.8.2 PoC трея Помощника (`poc/helper-tray/`): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 не дотянута ~5 МБ), открытие ~0,58 с. Замеры — `docs/research/helper-tray-poc.md`.
## В работе ## В работе
<!-- - #ID · ветка · что осталось --> <!-- - #ID · ветка · что осталось -->
@@ -26,5 +26,5 @@
- Информационная архитектура и макеты (#1.11). - Информационная архитектура и макеты (#1.11).
## Известные проблемы и долги ## Известные проблемы и долги
- Замер рабочего набора hello world (~337 МБ) оказался завышенным на общую память — честный private working set с окном в PoC ~97 МБ, цель ≤150 подтверждена. - Замер рабочего набора hello world (~337 МБ) оказался завышенным на общую память — PrivateBytes окна в PoC ~155 МБ (WS ~97 МБ).
- `poc/` временная, удаляется после ADR-0005. - `poc/` временная, удаляется после ADR-0005.
+1 -1
View File
@@ -27,7 +27,7 @@
<!-- Формат: - YYYY-MM-DD · зона → зона · что готово · где (путь, эндпоинт, ADR) --> <!-- Формат: - YYYY-MM-DD · зона → зона · что готово · где (путь, эндпоинт, ADR) -->
- 2026-11-08 · frontend → backend · правила git (`docs/contributing.md`), шаблон PR, хуки lefthook: после `git pull` выполнить `mise install && lefthook install` - 2026-11-08 · frontend → backend · правила git (`docs/contributing.md`), шаблон PR, хуки lefthook: после `git pull` выполнить `mise install && lefthook install`
- 2026-11-08 · frontend → backend · версии инструментов зафиксированы: `git pull`, `mise trust && mise install` по `docs/environment.md` - 2026-11-08 · frontend → backend · версии инструментов зафиксированы: `git pull`, `mise trust && mise install` по `docs/environment.md`
- 2026-11-09 · frontend → backend · PoC трея Помощника (#1.8.1–1.8.2): на Windows 11 цели подтверждены (покой 1,6 МБ, окно 97 МБ, открытие ~0,58 с). Методика и как повторить на Astra 1.8 — `docs/research/helper-tray-poc.md`; нужен замер Максима для ADR-0005 (#1.8.3) - 2026-11-09 · frontend → backend · PoC трея Помощника (#1.8.1–1.8.2): на Windows 11 по PrivateBytes покой 2,0 МБ (≤40 ✅), окно 155,3 МБ (цель 150 — не дотянуто ~5 МБ), открытие ~0,58 с ✅. Методика и как повторить на Astra 1.8 — `docs/research/helper-tray-poc.md`; нужен замер Максима для ADR-0005 (#1.8.3)
## Запросы между зонами ## Запросы между зонами
<!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID --> <!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID -->