docs: обновлены результаты PoC по PrivateBytes
ci / smoke (pull_request) Successful in 3s

Окно 155,3 МБ PB — цель 150 не достигнута ~на 5 МБ; покой 2,0 МБ
и открытие ~0,58 с — с запасом. Добавлены замечания ревизии:
решающая метрика PB, prevent_exit при code.is_none().

Refs: 1.8.1, 1.8.2
This commit is contained in:
TMSH committed 2026-11-09 23:21:21 +03:00
1 parent 82eb829851
commit 457a7d8b71
4 files changed
+70 -47

No files matched your search

@@ -13,24 +13,26 @@ author: Frontend
# [1.8] PoC Помощника: Tauri только с иконкой в трее
## Сделано
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` от завершения по закрытию последнего окна. Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke (capability только `core:default` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log`, скрипт снимает private working set дерева процессов по отметкам.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой **1,6 МБ**, окно **97,3 МБ**, после закрытия **3,6 МБ**, открытие **583/564 мс**. Все цели выполнены. Таблица и выводы — `docs/research/helper-tray-poc.md`.
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` только при `code.is_none()` (иначе `app.exit(0)` блокируется). Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke после двойного rAF (capability с пустым `permissions` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log` (рядом с exe или в `%TEMP%`), скрипт снимает **PrivateBytes** и WorkingSetPrivate дерева процессов.
- Замеры 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/`.
## Решения
- Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным.
- Команды приложения в 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`).
- Замеры нужны для ADR-0005 (#1.8.3) — решение принимаем вместе, сам по себе PoC технологию не выбирает.
## Проверка
- `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit` проходит.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, метрики записаны.
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию.
- `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit`, `cargo clippy`, `cargo fmt --check` проходят.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, приложение завершается само во всех прогонах (`app.exit(0)` не блокируется).
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию. Предупреждение о postMessage-запасном IPC проверить в devtools можно только вручную — на Windows IPC идёт через `window.ipc.postMessage` и не зависит от `connect-src`.
## Осталось
- [ ] Замер на Astra 1.8 — Максим, VM #1.12.5.