Files
shtil/docs/journal/2026-11-09-frontend-1.8-helper-tray-poc.md
T
TMSH 22d1698764
ci / smoke (push) Successful in 3s
[1.8] PoC Помощника: трей и замеры на Windows (#8)
**Задача:** #1.8
**Пункты:** 1.8.1, 1.8.2

## Что сделано
- PoC в poc/helper-tray/: Tauri 2 только с иконкой в трее (окна при старте нет), меню из трёх пунктов, окно создаётся по клику и уничтожается при закрытии.
- Форма «Сообщить о проблеме» по прототипу; «Выход» только в debug-сборке.
- Замер времени открытия — команда first_paint (invoke после двойного rAF); сценарий --measure-scenario + measure.ps1: PrivateBytes и WorkingSetPrivate дерева процессов по отметкам этапов в логе.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 — не дотянуто ~5 МБ), после закрытия 5,2 МБ, открытие 580/555 мс. Выводы и методика — docs/research/helper-tray-poc.md.
- AGENTS.md: добавлена временная папка poc/ (удаляется после ADR-0005).

## Как проверить
1. cd poc/helper-tray && pnpm install && pnpm tauri build
2. Запустить src-tauri/target/release/helper-tray.exe — только трей, без окна.
3. powershell -ExecutionPolicy Bypass -File measure.ps1 — 5 прогонов, таблица.
4. На Linux: сборка по docs/research/helper-tray-poc.md, замер через PSS.

## Чек-лист
- [x] Коммиты и название PR по-русски, в каждом коммите есть Refs:
- [x] Ветка свежая: git rebase origin/main, конфликтов нет
- [x] Секретов и персональных данных в коде, логах и документах нет
- [x] Документация обновлена: запись журнала, docs/status/, docs/research/
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте
<!-- Прочие пункты шаблона неприменимы: нет запросов к БД, прав, миграций, флагов -->

Reviewed-on: #8
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-10 21:42:07 +00:00

3.9 KiB
Raw Blame History

date, zone, task, items, branch, pr, impact, status, author
date zone task items branch pr impact status author
2026-11-09 frontend 1.8
1.8.1
1.8.2
feat/1.8-helper-tray-poc — shared на проверке 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/ удалить.