**Задача:** #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>
This commit was merged in pull request #8.
This commit is contained in:
1 parent
9547fa7076
commit
22d1698764
42 files changed
+6074
-6
No files matched your search
@@ -0,0 +1,39 @@
|
||||
---
|
||||
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/` удалить.
|
||||
@@ -0,0 +1,148 @@
|
||||
# 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'; connect-src ipc: http://ipc.localhost`
|
||||
— последнее нужно IPC по кастомному протоколу на Linux/macOS, иначе Tauri
|
||||
переходит на postMessage-запасной вариант); 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()` только при `code.is_none()`:
|
||||
закрытие последнего окна не завершает приложение в трее, а программный
|
||||
`app.exit(0)` (сценарий замера, «Выход (debug)») работает;
|
||||
- замер времени открытия: `Instant` перед `build()` окна → фронтенд после
|
||||
`mounted` + двойной `requestAnimationFrame` (вторая рамка = первая уже
|
||||
отрисована) вызывает команду `first_paint` → разница в мс пишется в лог.
|
||||
Команды приложения не входят в ACL, плагинов нет — capability окон `win-*`
|
||||
имеет пустой `permissions`;
|
||||
- флаг `--measure-scenario` (только для замера): приложение по таймеру делает
|
||||
30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно →
|
||||
10 с → закрывает и завершается. Отметки этапов пишутся в
|
||||
`helper-tray-poc.measure.log` (рядом с exe, при недоступности — в `%TEMP%`)
|
||||
за ~1,5 с до действия, чтобы скрипт успел снять ОЗУ.
|
||||
- `src/App.vue`: форма по прототипу — кнопки-категории, поле описания, кнопка
|
||||
«Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки.
|
||||
- `measure.ps1`: запускает exe с `--measure-scenario`, читает отметки из лога,
|
||||
снимает два счётчика дерева процессов (приложение + все дочерние
|
||||
`msedgewebview2.exe`, по цепочке родителей и по user-data-dir в командной
|
||||
строке) из `Win32_PerfFormattedData_PerfProc_Process`:
|
||||
- **PrivateBytes** — committed private memory. **Решение принимаем по ней:**
|
||||
Windows урезает рабочий набор у простаивающих процессов, поэтому
|
||||
WorkingSetPrivate для покоя занижен;
|
||||
- **WorkingSetPrivate** — private working set, для справки.
|
||||
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 с (проверка освобождения).
|
||||
- Время открытия — холодное (первое окно) и тёплое (повторное), из лога.
|
||||
- ОЗУ — **PrivateBytes** всего дерева процессов (решающая метрика) и
|
||||
WorkingSetPrivate для справки. Обычный working set завышает цифру на общую
|
||||
память WebView2, а private working set занижает её для простаивающих
|
||||
процессов — Windows вытесняет их страницы.
|
||||
|
||||
## Результаты
|
||||
|
||||
ОС: Windows 11 · машина Frontend-разработчика · дата: 2026-11-09 · сборка release.
|
||||
PB — PrivateBytes (решающая метрика), WS — WorkingSetPrivate (для справки).
|
||||
|
||||
| Метрика | Цель | Медиана (5 прогонов) | Разброс | Итог |
|
||||
|---|---|---|---|---|
|
||||
| ОЗУ в покое, PB | ≤ 40 МБ | 2,0 МБ | 2,0 – 2,0 | ✅ |
|
||||
| ОЗУ в покое, WS | — | 1,5 МБ | 1,5 – 1,5 | — |
|
||||
| ОЗУ с окном, PB | ≤ 150 МБ | 155,3 МБ | 154,9 – 158,3 | ⚠ +4 % к цели |
|
||||
| ОЗУ с окном, WS | — | 97,3 МБ | 96,9 – 100,3 | — |
|
||||
| ОЗУ после закрытия, PB | освобождение | 5,2 МБ | 5,0 – 5,2 | ✅ |
|
||||
| ОЗУ после закрытия, 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 | 2,0 МБ | 155,3 МБ | 5,2 МБ | 580 / 555 мс | 2026-11-09 |
|
||||
| Astra 1.8 | — ждём VM #1.12.5 — | | | | |
|
||||
|
||||
## Выводы
|
||||
|
||||
- Покой и скорость открытия — с большим запасом: **2,0 МБ PB** (цель ≤ 40),
|
||||
открытие **~0,58 с** (цель ≤ 1 с). «Только трей» реально не запускает
|
||||
WebView2 до первого окна — 2 МБ это весь процесс.
|
||||
- Окно по решающей метрике **155,3 МБ PB — на ~4 % выше цели 150 МБ**
|
||||
(по WorkingSetPrivate — 97 МБ и цель формально выполнена). Это честный
|
||||
предел WebView2 на Windows 11: private bytes включают зарезервированную,
|
||||
но не вытянутую память рендерера. Обсуждение того, насколько цель жёсткая
|
||||
и считаем ли проходом, — в #1.8.3.
|
||||
- `destroy()` при закрытии освобождает память полностью — через 10 с остаётся
|
||||
~5,2 МБ PB самого процесса.
|
||||
- Холодное и тёплое открытие почти не различаются (~0,6 с); повторное окно по
|
||||
памяти такое же (~157 МБ PB).
|
||||
- Для ADR-0005: на Windows 11 режим «Tauri только трей» выполняет цели по
|
||||
покою и скорости и не дотягивает ~5 МБ по окну. Запасной вариант «трей на
|
||||
Go + окно Tauri» по памяти окна ничего не даст — окно в обоих вариантах на
|
||||
Tauri/WebView2, выигрыш был бы только в покое, а там уже 2 МБ.
|
||||
Решающий фактор — повторение замера на Astra 1.8 (WebKitGTK): Максим, после
|
||||
появления VM #1.12.5.
|
||||
- Что переносить в Помощник при выборе Tauri: паттерн `app.windows: []` +
|
||||
`prevent_exit` при `code.is_none()`, фабрика окон с `destroy`, замер
|
||||
`first_paint` (двойной rAF → invoke), пустой `permissions` у capability,
|
||||
строгий CSP с `connect-src ipc: http://ipc.localhost`, меню без «Выход».
|
||||
|
||||
## Что PoC не делает (вне задания)
|
||||
|
||||
Нет IPC с агентом, отправки обращений, уведомлений, i18n, дизайн-системы,
|
||||
автозапуска, установщика-поставки. Решение по технологии Помощника принимается
|
||||
в #1.8.3 совместно с Backend — по этим замерам.
|
||||
@@ -1,26 +1,30 @@
|
||||
# Состояние: Frontend
|
||||
|
||||
Обновлено: 2026-11-08 · Владелец: Frontend-разработчик
|
||||
Обновлено: 2026-11-09 · Владелец: Frontend-разработчик
|
||||
|
||||
Снимок, а не история. Внутренние правила зоны — `docs/frontend/`.
|
||||
|
||||
## Сейчас
|
||||
- Кода продукта нет. Окружение готово, Tauri 2 собирается на Windows.
|
||||
- PoC Помощника собран и замерен: цели подтверждены на Windows 11.
|
||||
|
||||
## Сделано в текущем шаге
|
||||
- #1.2 правила git, шаблон PR, хуки, личные заметки `docs/private/`.
|
||||
- #1.3 версии инструментов; hello world Tauri и Go на Windows (#1.3.9, часть Frontend/Windows).
|
||||
- #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 · ветка · что осталось -->
|
||||
- #1.3 · `feat/1.3-hello-world` · осталось: Linux-сборка (нужна машина #1.3.7), проверка у Максима
|
||||
- #1.8 · `feat/1.8-helper-tray-poc` · PR на проверке; осталось — замер на Astra 1.8 (Максим, #1.12.5) и решение в #1.8.3
|
||||
- #1.4 · без ветки · обсуждение поддерживаемых ОС (взял в работу)
|
||||
|
||||
## Ждём от Backend
|
||||
- Окружение и проверка #1.3.9 у Максима.
|
||||
- Linux-сборка hello world (#1.3.9) и замер PoC на Astra 1.8 (#1.8.1–1.8.2), когда будет VM #1.12.5.
|
||||
|
||||
## Ближайшее
|
||||
- PoC Помощника: Tauri только с иконкой в трее, замеры ОЗУ и времени открытия окна (#1.8.1–1.8.2).
|
||||
- #1.8.3–1.8.5 решение по Помощнику и ADR-0005 (вместе с Максимом).
|
||||
- Информационная архитектура и макеты (#1.11).
|
||||
|
||||
## Известные проблемы и долги
|
||||
- Предварительно WebView2 в hello world занимает ~337 МБ рабочего набора — проверить точным замером в #1.8 (цель ≤ 150 МБ с окном).
|
||||
- Замер рабочего набора hello world (~337 МБ) оказался завышенным на общую память — PrivateBytes окна в PoC ~155 МБ (WS ~97 МБ).
|
||||
- `poc/` временная, удаляется после ADR-0005.
|
||||
@@ -1,6 +1,6 @@
|
||||
# Состояние: общее (shared)
|
||||
|
||||
Обновлено: 2026-11-08 · Шаг 1 «Решения и подготовка» · Версия —
|
||||
Обновлено: 2026-11-09 · Шаг 1 «Решения и подготовка» · Версия —
|
||||
|
||||
Снимок, а не история. Правила — `docs/ai/PROTOCOL.md`, разделы 2 и 6.
|
||||
|
||||
@@ -27,6 +27,7 @@
|
||||
<!-- Формат: - 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 pull`, `mise trust && mise install` по `docs/environment.md`
|
||||
- 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 -->
|
||||
|
||||
Reference in new issue
Block a user