39 lines
3.9 KiB
Markdown
39 lines
3.9 KiB
Markdown
---
|
||||
|
|
date: 2026-11-09
|
|||
|
|
zone: frontend
|
|||
|
|
task: "1.8"
|
|||
|
|
items: ["1.8.1", "1.8.2"]
|
|||
|
|
branch: feat/1.8-helper-tray-poc
|
|||
|
|
pr: —
|
|||
|
|
impact: shared
|
|||
|
|
status: на проверке
|
|||
|
|
author: Frontend
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# [1.8] PoC Помощника: Tauri только с иконкой в трее
|
|||
|
|
|
|||
|
|
## Сделано
|
|||
|
|
- `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 окон с пустым `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`, `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.
|
|||
|
|
- [ ] После ADR-0005 папку `poc/` удалить.
|