Compare commits

..
3 Commits
Author SHA1 Message Date
TMSH 4abe485e73 docs: добавлены результаты замеров PoC Помощника
Покой 1,6 МБ, окно 97,3 МБ, открытие 583/564 мс — цели #1.8
подтверждены на Windows 11. В AGENTS.md добавлена папка poc/.

Refs: 1.8.1, 1.8.2
2026-11-09 22:53:43 +03:00
TMSH d663869304 feat(helper): добавлен PoC Помощника только с иконкой в трее
Tauri 2 без окна при старте, меню трея из трёх пунктов, окно создаётся
по клику и уничтожается при закрытии. Флаг --measure-scenario и
measure.ps1 для замеров ОЗУ и времени открытия по методике карты.

Refs: 1.8.1, 1.8.2
2026-11-09 22:53:25 +03:00
TMSH 14bf4a6a8a docs: добавлена запись журнала ветки PoC трея Помощника
Refs: 1.8.1, 1.8.2
2026-11-09 22:01:28 +03:00
15 changed files with 94 additions and 580 deletions

No files matched your search

-37
View File
@@ -1,37 +0,0 @@
# ADR-0005: ПО на устройстве — Агент и Помощник
- **Статус:** Предложено
- **Дата:** 2026-11-11
- **Задача:** #1.8
- **Участники:** Oleg, Максим
- **Зоны:** shared
## Контекст
Пользователю нужен интерфейс на ПК: сообщить о проблеме, видеть статус обращения, подтвердить удалённое подключение. Агент — служба в Session 0 (Windows) / systemd (Linux) и физически не может показывать окна. Значит на устройстве два компонента: служба-агент и «Штиль Помощник» в сессии пользователя. Оставалось выбрать технологию Помощника: критерии — в покое ≤ 40 МБ ОЗУ, с открытым окном ≤ 150 МБ, открытие ≤ 1 с, общий UI-стек с приложением, работа в изолированном контуре.
## Решение
*Черновик до решения #1.8.3: архитектура подтверждена, выбор технологии ждёт замер на Astra 1.8.*
- На устройстве два компонента: **агент** (служба, SYSTEM/root, единственный канал к серверу по mTLS) и **Помощник** (процесс в сессии пользователя, иконка в трее, без прав администратора).
- Помощник общается только с агентом по IPC (named pipe / unix socket, Protobuf, `proto/helper/v1`); агент проверяет подлинность Помощника (путь, подпись бинарника, пользователь сессии).
- Запуск: Windows — агент отслеживает входы и запускает Помощника в сессиях; Linux — XDG autostart, агент контролирует наличие. Пункта «Выход» нет, при падении агент перезапускает.
- Один установщик «агент + Помощник»; на серверах Помощник по умолчанию выключен. Иконка и название переопределяются конфигом (white-label для MSP).
- **Технология (предложение):** Tauri 2 в режиме «только трей»: окна нет при старте, форма создаётся по клику и уничтожается при закрытии. Подтверждено PoC (`poc/helper-tray`, `docs/research/helper-tray-poc.md`): Windows 11, release, медиана из 5 прогонов — покой 2,0 МБ PrivateBytes, открытие 580/555 мс, окно 155,3 МБ PrivateBytes (цель 150 — превышение ~5 МБ признано допустимым, т.к. расход даёт WebView2-движок, общий с приложением).
- Функции Помощника по фазам — `docs/architecture/helper.md`.
## Рассмотренные варианты
| Вариант | Плюсы | Минусы |
|---|---|---|
| **Tauri 2 трей + окно на WebView** | Общий UI-стек и дизайн-система с приложением, один язык для команды, WebView2 уже есть на Windows | Окно ~155 МБ PB > цели 150; на Linux зависит от WebKitGTK 4.1 |
| Трей на Go + окно Tauri по запросу | Покой ещё ниже (~2–3 МБ и так 2 МБ) | Окно всё равно на WebView — выигрыша по памяти с окном нет; второй стек IPC/сборки; выигрыш только в покое, который и так 20× ниже цели |
| Нативный трей + нативные окна (Go/Qt/winfrey) | Минимум памяти | Нет общего UI с приложением, два UI-стека, дороже поддержка — отклонено по трудозатратам |
## Последствия
- Нужны `proto/helper/v1` (черновик методов — `docs/architecture/helper.md`) и каркас `apps/helper/` на следующих шагах.
- Запасной путь при провале цели на Astra/РЕД ОС: трей на Go, окно Tauri по запросу.
- Решение пересматривается, если замер на Astra 1.8 (#1.12.5) покажет окно значительно выше ~160 МБ или открытие > 1 с.
- `poc/` удаляется после принятия ADR.
-46
View File
@@ -1,46 +0,0 @@
# ADR-0006: Обращения пользователей
- **Статус:** Предложено
- **Дата:** 2026-11-15
- **Задача:** #1.9
- **Участники:** Oleg, Максим
- **Зоны:** shared
## Контекст
Обращение (`ticket`) — сообщение сотрудника через Помощника: ключевая функция для пользователей и основа будущего Service Desk. Цель: сообщить о проблеме в два клика, а администратор сразу видит, кто, откуда и что случилось — без звонков. Алерт — автоматическое событие мониторинга (фаза 2); оба типа попадают в раздел «Входящие».
## Решение
**Сценарий.** Пользователь: трей → «Сообщить о проблеме» → форма. Помощник → агент по IPC (агент добавляет автодиагностику и отправляет; без связи — в очереди агента). Сервер создаёт обращение и отдаёт пользователям с правом `tickets.manage` на подразделение устройства, иначе владельцу организации. Пользователь видит статус и ответ в Помощнике.
**Форма.** 6 категорий-кнопок + «Другое»; описание обязательно до 1000 знаков; автоскриншот с превью и «Убрать» (отключается политикой организации); контакт запоминается после первого ввода. Поля «срочность» нет — приоритет ставит администратор при обработке.
**Автодиагностика** (добавляет агент): имя ПК, IP, подразделение, пользователь ОС, ОС и аптайм, CPU/ОЗУ, место на дисках, доступность шлюза, DNS и сервера «Штиль», ошибки системного журнала (за 1 час, до 20). Для «Не печатает» — принтеры, состояние и очередь печати.
**Статусы:** Новое → В работе → Ожидает пользователя → Решено → Закрыто (автоматически через 3 дня) · Отклонено. Ответ пользователя после «Решено» в течение 3 дней переоткрывает обращение.
**Переписка и подтверждение.** Комментарии внутри обращения (не отдельный чат). Кнопка «Решено» у пользователя — политика организации, по умолчанию включена, наследуется по подразделениям: включена — админ ставит «Ожидает пользователя», пользователь подтверждает или переоткрывает; выключена — админ закрывает сам.
**Скриншоты** — персональные данные: хранение 30 дней, доступ по `tickets.manage`, сжатие до 2 МБ, отключение политикой.
**Защита.** Обращение подписано сертификатом устройства; лимит 5 обращений за 10 минут с устройства.
**История и права.** «Мои обращения» — последние 10. Наблюдатель филиала видит обращения филиала только на чтение. Каналы без агента (веб-форма, почта, Telegram) — фаза 2 и позже.
## Рассмотренные варианты
| Вопрос | Выбрано | Альтернатива и почему отказались |
|---|---|---|
| Ответ админа | Комментарии внутри обращения | Живой чат — создаёт ожидание мгновенного ответа, админ не колл-центр |
| Срочность | Ставит админ при обработке | Поле у пользователя — все ставят «срочно», сигнала нет |
| Описание | До 1000 знаков | 2000 — поощряет простыни; 400 — мало для текста ошибки |
| Скриншот | Включён с «Убрать» | Выключен по умолчанию — теряется главная польза диагностики |
| Окно жизни чата | Таймер авто-закрытия (3 дня) | Отдельная механика «активного чата» — лишняя сложность |
## Последствия
- Нужен `proto/helper/v1` (`TicketSubmit` с диагностикой и ссылкой на скриншот — #2.6.4) и `proto/agent/v1` пересылка на сервер.
- Реализация формы и «Входящих» — шаг 6 (#2.15); макет окна Помощника — `docs/ux/helper-window.html` (#1.9.7).
- Политики: скриншоты вкл/выкл, кнопка «Решено», сроки хранения — войдут в каталог функций (#2.3).
- Решение пересматривается, если интервью (#1.14) покажут, что пользователям нужен живой чат или поле срочности.
-56
View File
@@ -1,56 +0,0 @@
# Помощник «Штиль» — функции по фазам
- **Задача:** #1.8.4 · **Статус:** черновик, утверждается решением #1.8.3 → ADR-0005
- Источники: карточка #1.8 (диаграмма), #1.9 (обращения), #1.10 (удалённый доступ)
## Роль и ограничения
Помощник — процесс в сессии пользователя, единственный компонент на устройстве с интерфейсом.
- Прав администратора нет, установки драйверов/служб не требует.
- С сервером напрямую не общается — только с агентом по IPC (named pipe / unix socket, Protobuf).
- Запуск: Windows — агентом при входе пользователя (служба в Session 0 окон не имеет); Linux — XDG autostart, агент контролирует наличие.
- Пункта «Выход» нет; при падении агент перезапускает.
- На серверах не ставится по умолчанию (параметр установки).
- Устанавливается одним инсталлятором с агентом; иконка и название переопределяются конфигом (white-label).
## Фаза 1 — обращения (MVP)
| Функция | Содержание |
|---|---|
| Иконка в трее | Меню: «Сообщить о проблеме», «Мои обращения», «О программе». Без окон при старте; окно создаётся по клику и уничтожается при закрытии |
| Форма обращения | Категории-кнопки: Не печатает · Нет сети/интернета · Медленно работает · Не работает программа · Нужен доступ или ПО · Другое. Описание (обязательно, ≤ 2000), срочность (обычная / срочно — работа стоит), контакт (телефон/кабинет, запоминается) |
| Скриншот | Снимается автоматически, показывается превью, кнопка «Убрать». Организация может отключить политикой |
| Отправка | Помощник → агент по IPC. Агент добавляет автодиагностику и отправляет; без связи копит в своей очереди — у Помощника очереди нет |
| «Мои обращения» | Последние 10: статус и ответы администратора, простая переписка внутри обращения |
| «О программе» | Версия, организация, статус связи с агентом |
## Фаза 2 — удалённый доступ и уведомления
| Функция | Содержание |
|---|---|
| Диалог согласия | Кто подключается и причина. Кнопки: Разрешить / Только просмотр / Отклонить. Нет ответа 30 с — отказ |
| Индикатор сеанса | Красная рамка по краю экрана + панель «К вам подключён {имя} · {время} · Завершить». Пользователь может прервать сеанс в любой момент |
| Захват экрана | По команде агента: служба в Session 0 рабочий стол не видит, снимает только процесс сессии. Передача потока агенту |
| Уведомления | Всплывающие: ответ по обращению, сообщения от администратора, события сеанса удалённого доступа |
## Чего Помощник не делает
- Не хранит данные дольше сессии, не имеет своей БД и очереди.
- Не показывает настроек пользователю (кроме white-label через конфиг агента).
- Не принимает решений по безопасности: показ диалога согласия решает агент по подписанной политике.
- Не работает в Session 0 и без графической сессии.
## Черновой список методов IPC (`proto/helper/v1`)
Для оценки поверхности протокола, детали — в #1.8.5 и позже.
| Метод | Направление | Фаза |
|---|---|---|
| `TicketSubmit` | Помощник → агент | 1 |
| `TicketList` / `TicketReply` | Помощник ↔ агент | 1 |
| `ConsentRequest` / `ConsentResponse` | агент → Помощник → агент | 2 |
| `SessionIndicator` (start/stop) | агент → Помощник | 2 |
| `Notify` | агент → Помощник | 2 |
| `ScreenCapture` (start/stop) | агент → Помощник | 2 |
| `GetState` | Помощник → агент | 1 (статус связи для «О программе») |
@@ -13,26 +13,24 @@ author: Frontend
# [1.8] PoC Помощника: Tauri только с иконкой в трее # [1.8] PoC Помощника: Tauri только с иконкой в трее
## Сделано ## Сделано
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` только при `code.is_none()` (иначе `app.exit(0)` блокируется). Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки). - `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` от завершения по закрытию последнего окна. Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke после двойного rAF (capability с пустым `permissions` на `win-*`). - Замер времени открытия — команда `first_paint` по invoke (capability только `core:default` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log` (рядом с exe или в `%TEMP%`), скрипт снимает **PrivateBytes** и WorkingSetPrivate дерева процессов. - `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log`, скрипт снимает private working set дерева процессов по отметкам.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой **2,0 МБ PB**, окно **155,3 МБ PB** (цель 150 — не дотянуто ~5 МБ), после закрытия **5,2 МБ PB**, открытие **580/555 мс**. Таблица и выводы — `docs/research/helper-tray-poc.md`. - Замеры Windows 11 (release, 5 прогонов, медиана): покой **1,6 МБ**, окно **97,3 МБ**, после закрытия **3,6 МБ**, открытие **583/564 мс**. Все цели выполнены. Таблица и выводы — `docs/research/helper-tray-poc.md`.
- `AGENTS.md` раздел 5: добавлена строка про `poc/`. - `AGENTS.md` раздел 5: добавлена строка про `poc/`.
## Решения ## Решения
- Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным. - Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным.
- Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, capability окон с пустым `permissions`. - Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, минимальный capability — `core:default`.
- Решающая метрика ОЗУ — 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`, `cargo clippy`, `cargo fmt --check` проходят. - `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit` проходит.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, приложение завершается само во всех прогонах (`app.exit(0)` не блокируется). - `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, метрики записаны.
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию. Предупреждение о postMessage-запасном IPC проверить в devtools можно только вручную — на Windows IPC идёт через `window.ipc.postMessage` и не зависит от `connect-src`. - Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию.
## Осталось ## Осталось
- [ ] Замер на Astra 1.8 — Максим, VM #1.12.5. - [ ] Замер на Astra 1.8 — Максим, VM #1.12.5.
@@ -1,33 +0,0 @@
---
date: 2026-11-11
zone: frontend
task: "1.8"
items: ["1.8.4", "1.8.5"]
branch: feat/1.8-helper-functions
pr: —
impact: shared
status: смержено
author: Frontend
---
# [1.8] Функции Помощника по фазам и черновик ADR-0005
## Сделано
- `docs/architecture/helper.md` — список функций Помощника по фазам (#1.8.4): роль и ограничения, фаза 1 (обращения), фаза 2 (удалённый доступ, уведомления, захват экрана), границы, черновой список методов IPC.
- `docs/adr/0005-agent-and-helper.md` — черновик ADR-0005 со статусом «Предложено» (#1.8.5): архитектура «агент + Помощник», варианты технологии с результатами PoC. Решение по технологии открыто — ждёт замер на Astra 1.8 (#1.8.3, В1).
## Решения
- Захват экрана отнесён к Помощнику (фаза 2): агент в Session 0 рабочий стол не видит, снимать экран может только процесс в сессии пользователя — по команде агента.
- Локальная очередь обращений живёт в агенте, не в Помощнике: Помощник без прав, хранить данные дольше сессии не должен.
- Всплывающие уведомления — фаза 2 (по карте); в фазе 1 статусы и ответы видны в «Мои обращения».
## Для другой стороны
- Максиму: посмотреть черновой список методов IPC в конце `docs/architecture/helper.md` — это заготовка под `proto/helper/v1`.
- ADR-0005 в статусе «Предложено» — финальное решение после замера на Astra 1.8 (#1.8.3).
## Проверка
- Документы, кода нет. Сверено с картой: #1.8 (диаграмма, вопросы В2–В5), #1.9 (поля формы, автодиагностика), #1.10 (режимы доступа, диалог согласия, индикатор).
## Осталось
- [ ] Ответы на вопросы В1–В5 и решение в #1.8.3 — после замера Максима на Astra 1.8 (VM #1.12.5).
- [ ] ADR-0005 перевести в «Принято» при записи решения (#1.8.5).
@@ -1,35 +0,0 @@
---
date: 2026-11-15
zone: frontend
task: "1.9"
items: ["1.9.5", "1.9.6", "1.9.7"]
branch: feat/1.9-user-tickets
pr: —
impact: shared
status: в работе
author: Frontend
---
# [1.9] Обращения: ADR-0006 и макет окна Помощника
## Сделано
- `docs/adr/0006-user-tickets.md` — черновик ADR-0006 со статусом «Предложено» (#1.9.6): сценарий обращения, поля формы, статусы, маршрутизация, правила скриншотов, переписка и подтверждение «Решено».
- `docs/ux/helper-window.html` — макет окна Помощника (#1.9.7): живая HTML-страница по прототипу — форма с категориями, описанием со счётчиком, автоскриншотом с превью и «Убрать»; «Мои обращения» со статусами, перепиской и подтверждением «Решено»; «О программе».
- Правки записи журнала ветки 1.8-functions: статус «смержено».
## Решения (по ответам в карточке 1.9)
- Описание обязательно, до 1000 знаков (изначально в карте 2000 — сократили, чтобы не писали простыни).
- Поля «срочность» нет: приоритет ставит администратор при обработке — пользователи всегда ставят «срочно».
- Переписка — комментарии внутри обращения, не отдельный чат; ответ после «Решено» в течение 3 дней переоткрывает.
- Кнопка «Решено» у пользователя — политика организации, по умолчанию включена.
- Скриншоты: хранение 30 дней, доступ по `tickets.manage`, отключение политикой (#1.9.5).
## Для другой стороны
- Максиму: ADR-0006 фиксирует автодиагностику и очередь на агенте — это его реализация на шаге 6.
## Проверка
- Макет открыт в браузере и проверен вручную; документы сверены с ответами в карточке 1.9.
## Осталось
- [ ] Решение 1.9 перевести в «Принято» и ADR-0006 в «Принято» после ревью.
- [ ] Макет окна согласовать с Максимом (он часть результата шага 1).
+36 -57
View File
@@ -20,38 +20,30 @@ 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'; connect-src ipc: http://ipc.localhost` (`default-src 'self'; style-src 'self' 'unsafe-inline'`); identifier `ru.tbsoft.shtil.helper.poc`.
— последнее нужно 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()` только при `code.is_none()`: - `RunEvent::ExitRequested` → `prevent_exit()`, иначе закрытие последнего окна
закрытие последнего окна не завершает приложение в трее, а программный завершает приложение, живущее в трее;
`app.exit(0)` (сценарий замера, «Выход (debug)») работает;
- замер времени открытия: `Instant` перед `build()` окна → фронтенд после - замер времени открытия: `Instant` перед `build()` окна → фронтенд после
`mounted` + двойной `requestAnimationFrame` (вторая рамка = первая уже `mounted` + `requestAnimationFrame` вызывает команду `first_paint` → разница
отрисована) вызывает команду `first_paint` → разница в мс пишется в лог. в мс пишется в лог. Команда приложения — не событие и не плагин, поэтому
Команды приложения не входят в ACL, плагинов нет — capability окон `win-*` capability содержит только `core:default` на окна `win-*`;
имеет пустой `permissions`;
- флаг `--measure-scenario` (только для замера): приложение по таймеру делает - флаг `--measure-scenario` (только для замера): приложение по таймеру делает
30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно → 30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно →
10 с → закрывает и завершается. Отметки этапов пишутся в 10 с → закрывает и завершается. Отметки этапов пишутся в
`helper-tray-poc.measure.log` (рядом с exe, при недоступности — в `%TEMP%`) `helper-tray-poc.measure.log` рядом с exe за ~1,5 с до действия, чтобы
за ~1,5 с до действия, чтобы скрипт успел снять ОЗУ. скрипт успел снять ОЗУ.
- `src/App.vue`: форма по прототипу — кнопки-категории, поле описания, кнопка - `src/App.vue`: форма по прототипу — кнопки-категории, поле описания, кнопка
«Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки. «Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки.
- `measure.ps1`: запускает exe с `--measure-scenario`, читает отметки из лога, - `measure.ps1`: запускает exe с `--measure-scenario`, читает отметки из лога,
снимает два счётчика дерева процессов (приложение + все дочерние снимает **private working set** (`WorkingSetPrivate`,
`msedgewebview2.exe`, по цепочке родителей и по user-data-dir в командной `Win32_PerfFormattedData_PerfProc_Process`) по дереву процессов — приложение +
строке) из `Win32_PerfFormattedData_PerfProc_Process`: все дочерние `msedgewebview2.exe` (по цепочке родителей и по user-data-dir
- **PrivateBytes** — committed private memory. **Решение принимаем по ней:** в командной строке). 5 прогонов, медиана и разброс.
Windows урезает рабочий набор у простаивающих процессов, поэтому
WorkingSetPrivate для покоя занижен;
- **WorkingSetPrivate** — private working set, для справки.
5 прогонов, медиана и разброс.
## Сборка и запуск ## Сборка и запуск
@@ -89,57 +81,44 @@ pnpm tauri build # release-сборка: exe и установщики в
- ОЗУ с открытым окном — через 10 с после открытия. - ОЗУ с открытым окном — через 10 с после открытия.
- ОЗУ после закрытия окна — через 10 с (проверка освобождения). - ОЗУ после закрытия окна — через 10 с (проверка освобождения).
- Время открытия — холодное (первое окно) и тёплое (повторное), из лога. - Время открытия — холодное (первое окно) и тёплое (повторное), из лога.
- ОЗУ — **PrivateBytes** всего дерева процессов (решающая метрика) и - ОЗУ — private working set всего дерева процессов (обычный working set
WorkingSetPrivate для справки. Обычный working set завышает цифру на общую завышает цифру на общую память WebView2).
память 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 прогонов) | Разброс | Итог |
|---|---|---|---|---| |---|---|---|---|---|
| ОЗУ в покое, PB | ≤ 40 МБ | 2,0 МБ | 2,0 – 2,0 | ✅ | | ОЗУ в покое | ≤ 40 МБ | 1,6 МБ | 1,6 – 1,6 | ✅ |
| ОЗУ в покое, WS | — | 1,5 МБ | 1,5 – 1,5 | — | | ОЗУ с открытым окном | ≤ 150 МБ | 97,3 МБ | 96,8 – 97,6 | ✅ |
| ОЗУ с окном, PB | ≤ 150 МБ | 155,3 МБ | 154,9 – 158,3 | ⚠ +4 % к цели | | ОЗУ после закрытия | освобождение | 3,6 МБ | 3,5 – 29,0 | ✅ |
| ОЗУ с окном, WS | — | 97,3 МБ | 96,9 – 100,3 | — | | Открытие окна, холодное | ≤ 1 с | 583 мс | 577 – 702 | ✅ |
| ОЗУ после закрытия, PB | освобождение | 5,2 МБ | 5,0 – 5,2 | ✅ | | Открытие окна, тёплое | ≤ 1 с | 564 мс | 524 – 665 | ✅ |
| ОЗУ после закрытия, WS | — | 3,6 МБ | 3,5 – 3,6 | — | | ОЗУ повторно открытого окна | — | 97,8 МБ | 97,6 – 122,7 | — |
| Открытие окна, холодное | ≤ 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 | | Windows 11 | 1,6 МБ | 97,3 МБ | 3,6 МБ | 583 / 564 мс | 2026-11-09 |
| Astra 1.8 | — ждём VM #1.12.5 — | | | | | | Astra 1.8 | — ждём VM #1.12.5 — | | | | |
## Выводы ## Выводы
- Покой и скорость открытия — с большим запасом: **2,0 МБ PB** (цель ≤ 40), - Все три цели на Windows 11 выполнены с большим запасом: покой **1,6 МБ**
открытие **~0,58 с** (цель ≤ 1 с). «Только трей» реально не запускает (цель ≤ 40), окно **~97 МБ** (цель ≤ 150), открытие **~0,58 с** (цель ≤ 1 с).
WebView2 до первого окна — 2 МБ это весь процесс. - «Только трей» реально не запускает WebView2 до первого окна: в покое живёт
- Окно по решающей метрике **155,3 МБ PB — на ~4 % выше цели 150 МБ** только Rust-процесс с иконкой (1,6 МБ private working set).
(по WorkingSetPrivate — 97 МБ и цель формально выполнена). Это честный - `destroy()` при закрытии полностью освобождает память — через 10 с остаётся
предел WebView2 на Windows 11: private bytes включают зарезервированную, ~3,6 МБ самого процесса. В одном прогоне замер поймал 29 МБ — процессы
но не вытянутую память рендерера. Обсуждение того, насколько цель жёсткая WebView2 завершаются не мгновенно; медиана подтверждает освобождение.
и считаем ли проходом, — в #1.8.3. - Холодное и тёплое открытие почти не различаются (~0,6 с): WebView2 runtime
- `destroy()` при закрытии освобождает память полностью — через 10 с остаётся стартует быстро даже первый раз.
~5,2 МБ PB самого процесса. - Для ADR-0005: на Windows 11 вариант «Tauri только трей» удовлетворяет целям.
- Холодное и тёплое открытие почти не различаются (~0,6 с); повторное окно по Решающий фактор — повторение замера на Astra 1.8 (WebKitGTK может дать
памяти такое же (~157 МБ PB). другие цифры и потребует AppIndicator): Максим, после появления VM #1.12.5.
- Для 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` при `code.is_none()`, фабрика окон с `destroy`, замер `prevent_exit`, фабрика окон с `destroy`, замер `first_paint`, минимальные
`first_paint` (двойной rAF → invoke), пустой `permissions` у capability, capabilities и строгий CSP, меню трея без «Выход».
строгий CSP с `connect-src ipc: http://ipc.localhost`, меню без «Выход».
## Что PoC не делает (вне задания) ## Что PoC не делает (вне задания)
+4 -7
View File
@@ -1,6 +1,6 @@
# Состояние: Frontend # Состояние: Frontend
Обновлено: 2026-11-15 · Владелец: Frontend-разработчик Обновлено: 2026-11-09 · Владелец: Frontend-разработчик
Снимок, а не история. Внутренние правила зоны — `docs/frontend/`. Снимок, а не история. Внутренние правила зоны — `docs/frontend/`.
@@ -11,14 +11,11 @@
## Сделано в текущем шаге ## Сделано в текущем шаге
- #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/`): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 не дотянута ~5 МБ), открытие ~0,58 с. Замеры — `docs/research/helper-tray-poc.md`. PR #8 смержен. - #1.8.1–1.8.2 PoC трея Помощника (`poc/helper-tray/`): покой 1,6 МБ, окно 97 МБ, открытие ~0,58 с — цели выполнены. Замеры — `docs/research/helper-tray-poc.md`.
- #1.8.4 список функций Помощника по фазам — `docs/architecture/helper.md`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md`. PR #9 смержен.
- #1.9.6 черновик ADR-0006 — `docs/adr/0006-user-tickets.md`; #1.9.7 макет окна Помощника — `docs/ux/helper-window.html`.
## В работе ## В работе
<!-- - #ID · ветка · что осталось --> <!-- - #ID · ветка · что осталось -->
- #1.9 · `feat/1.9-user-tickets` · ADR-0006 и макет окна; осталось — ревью и «Принято» - #1.8 · `feat/1.8-helper-tray-poc` · PR на проверке; осталось — замер на Astra 1.8 (Максим, #1.12.5) и решение в #1.8.3
- #1.8 · осталось — замер на Astra 1.8 (Максим, #1.12.5) и решение в #1.8.3
- #1.4 · без ветки · обсуждение поддерживаемых ОС (взял в работу) - #1.4 · без ветки · обсуждение поддерживаемых ОС (взял в работу)
## Ждём от Backend ## Ждём от Backend
@@ -29,5 +26,5 @@
- Информационная архитектура и макеты (#1.11). - Информационная архитектура и макеты (#1.11).
## Известные проблемы и долги ## Известные проблемы и долги
- Замер рабочего набора hello world (~337 МБ) оказался завышенным на общую память — PrivateBytes окна в PoC ~155 МБ (WS ~97 МБ). - Замер рабочего набора hello world (~337 МБ) оказался завышенным на общую память — честный private working set с окном в PoC ~97 МБ, цель ≤150 подтверждена.
- `poc/` временная, удаляется после ADR-0005. - `poc/` временная, удаляется после ADR-0005.
+2 -4
View File
@@ -1,6 +1,6 @@
# Состояние: общее (shared) # Состояние: общее (shared)
Обновлено: 2026-11-15 · Шаг 1 «Решения и подготовка» · Версия — Обновлено: 2026-11-09 · Шаг 1 «Решения и подготовка» · Версия —
Снимок, а не история. Правила — `docs/ai/PROTOCOL.md`, разделы 2 и 6. Снимок, а не история. Правила — `docs/ai/PROTOCOL.md`, разделы 2 и 6.
@@ -27,9 +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 по PrivateBytes покой 2,0 МБ (≤40 ✅), окно 155,3 МБ (цель 150 — не дотянуто ~5 МБ), открытие ~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 цели подтверждены (покой 1,6 МБ, окно 97 МБ, открытие ~0,58 с). Методика и как повторить на Astra 1.8 — `docs/research/helper-tray-poc.md`; нужен замер Максима для ADR-0005 (#1.8.3)
- 2026-11-11 · frontend → backend · функции Помощника по фазам (#1.8.4) — `docs/architecture/helper.md` с черновым списком методов IPC для `proto/helper/v1`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md`
- 2026-11-15 · frontend → backend · обращения пользователей (#1.9): черновик ADR-0006 — `docs/adr/0006-user-tickets.md` (автодиагностика и очередь — на агенте, шаг 6); макет окна Помощника — `docs/ux/helper-window.html`
## Запросы между зонами ## Запросы между зонами
<!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID --> <!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID -->
-220
View File
@@ -1,220 +0,0 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Макет окна «Штиль Помощник» — #1.9.7</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=Golos+Text:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
<style>
:root{
--bg:#F4F5F7; --card:#FFFFFF; --line:#E2E5EA;
--text:#23272E; --text-2:#6B7280; --text-3:#9AA1AB;
--accent:#3D6E9E; --accent-soft:#E8F0F7;
--ok:#3F7D54; --ok-soft:#E5F0E8;
--warn:#9A7418; --warn-soft:#F7EFD8;
--err:#A94438; --err-soft:#F7E6E2;
--mut:#8A919B; --mut-soft:#EEF0F2;
--r:10px;
}
*{margin:0;padding:0;box-sizing:border-box}
body{font-family:"Golos Text",system-ui,sans-serif;background:var(--bg);color:var(--text);font-size:14px;line-height:1.5;padding:32px}
h1{font-size:20px;margin-bottom:4px}
.sub{color:var(--text-2);margin-bottom:24px;font-size:13px}
.sub code{font-family:"JetBrains Mono",monospace;font-size:12px}
.screens{display:flex;gap:24px;flex-wrap:wrap;align-items:flex-start}
.screen-cap{font-family:"JetBrains Mono",monospace;font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--text-3);margin-bottom:8px}
/* окно Помощника */
.win{width:400px;background:var(--card);border:1px solid var(--line);border-radius:14px;box-shadow:0 4px 20px rgba(30,35,45,.10);overflow:hidden}
.win-head{padding:14px 18px;border-bottom:1px solid var(--line);display:flex;align-items:center;gap:10px}
.win-head .ttl{font-weight:700;font-size:15px}
.win-head .min{margin-left:auto;color:var(--text-3);font-family:"JetBrains Mono",monospace;font-size:11px}
.win-body{padding:16px 18px;display:grid;gap:14px}
/* категории */
.cats{display:grid;grid-template-columns:1fr 1fr;gap:8px}
.cat{border:1px solid var(--line);border-radius:var(--r);padding:9px 12px;font-size:13px;font-weight:500;cursor:pointer;display:flex;gap:8px;align-items:center;transition:all .12s}
.cat:hover{border-color:var(--accent)}
.cat.on{border-color:var(--accent);background:var(--accent-soft);color:var(--accent);font-weight:600}
.cat .ic{font-size:15px}
/* поля */
.f label{display:block;font-size:12.5px;font-weight:600;margin-bottom:5px}
.f .hint{float:right;font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);font-weight:400}
.f textarea,.f input{width:100%;font:inherit;font-size:13.5px;border:1px solid var(--line);border-radius:var(--r);padding:9px 11px;resize:vertical;background:#FCFCFD}
.f textarea:focus,.f input:focus{outline:none;border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
.f textarea{min-height:76px}
/* скриншот */
.shot{display:flex;gap:10px;align-items:center;border:1px dashed var(--line);border-radius:var(--r);padding:8px 10px}
.shot .prev{width:72px;height:44px;border-radius:6px;background:linear-gradient(135deg,#cdd6e0,#9fb2c8);flex:none;border:1px solid var(--line);display:flex;align-items:center;justify-content:center;font-size:16px}
.shot .nm{font-size:12.5px;color:var(--text-2)}
.shot .rm{margin-left:auto;font-size:12px;color:var(--err);font-weight:600;cursor:pointer;border:none;background:none;font-family:inherit}
.shot .rm:hover{text-decoration:underline}
/* кнопки */
.btn{font:inherit;font-weight:600;font-size:14px;padding:10px 16px;border-radius:var(--r);border:1px solid transparent;cursor:pointer;transition:all .15s}
.btn-p{background:var(--accent);color:#fff;width:100%}
.btn-p:hover{background:#335F88}
.btn-s{background:transparent;color:var(--accent);border-color:var(--line);padding:7px 13px;font-size:13px}
.btn-s:hover{border-color:var(--accent);background:var(--accent-soft)}
.btn-ok{background:var(--ok);color:#fff;padding:7px 13px;font-size:13px}
.btn-ok:hover{background:#356747}
.btn-err{background:transparent;color:var(--err);border-color:var(--line);padding:7px 13px;font-size:13px}
.btn-err:hover{border-color:var(--err);background:var(--err-soft)}
/* чипы статусов */
.chip{display:inline-flex;align-items:center;gap:5px;font-size:11.5px;font-weight:600;border-radius:999px;padding:3px 10px;white-space:nowrap}
.chip i{width:6px;height:6px;border-radius:50%;background:currentColor;font-style:normal}
.c-new{background:var(--accent-soft);color:var(--accent)}
.c-work{background:var(--warn-soft);color:var(--warn)}
.c-wait{background:var(--err-soft);color:var(--err)}
.c-done{background:var(--ok-soft);color:var(--ok)}
.c-closed,.c-rej{background:var(--mut-soft);color:var(--mut)}
/* список обращений */
.tk{border:1px solid var(--line);border-radius:var(--r);padding:11px 13px;cursor:pointer;transition:all .15s}
.tk:hover{box-shadow:0 2px 10px rgba(30,35,45,.08)}
.tk .top{display:flex;align-items:center;gap:8px}
.tk .t{font-weight:600;font-size:13.5px}
.tk .m{font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);margin-top:3px}
.tk .chip{margin-left:auto}
/* переписка */
.thread{display:grid;gap:8px}
.msg{max-width:88%;border-radius:10px;padding:8px 11px;font-size:13px}
.msg .who{display:block;font-family:"JetBrains Mono",monospace;font-size:10px;color:var(--text-3);margin-bottom:2px}
.msg.a{background:var(--accent-soft);justify-self:start}
.msg.u{background:var(--mut-soft);justify-self:end}
.sysline{text-align:center;font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);padding:4px 0}
.confirm{border:1px solid var(--warn);background:var(--warn-soft);border-radius:var(--r);padding:10px 12px}
.confirm .q{font-size:12.5px;font-weight:600;color:var(--warn);margin-bottom:8px}
.reply{display:flex;gap:8px}
.reply input{flex:1;font:inherit;font-size:13px;border:1px solid var(--line);border-radius:var(--r);padding:8px 11px}
.reply input:focus{outline:none;border-color:var(--accent)}
/* о программе */
.about{display:grid;gap:8px;font-size:13.5px}
.about .row{display:flex;justify-content:space-between;border-bottom:1px dashed var(--line);padding-bottom:6px}
.about .row:last-child{border-bottom:none;padding-bottom:0}
.about .k{color:var(--text-2)}
.about .v{font-weight:500}
.about .v.mono{font-family:"JetBrains Mono",monospace;font-size:12px}
.st-ok{color:var(--ok);font-weight:600}
.note{margin-top:28px;max-width:640px;color:var(--text-2);font-size:12.5px;border-left:3px solid var(--line);padding-left:14px}
@media (prefers-reduced-motion:reduce){*{transition:none!important}}
</style>
</head>
<body>
<h1>Окно «Штиль Помощник»</h1>
<p class="sub">Функциональный макет #1.9.7 — по прототипу из карточки 1.9. Это схема экранов, <b>не визуальный дизайн</b>: цвета и стиль задаст тема приложения позже. Ширина окна ~400px.</p>
<div class="screens">
<!-- ЭКРАН 1: форма -->
<div>
<div class="screen-cap">Экран 1 · Сообщить о проблеме</div>
<div class="win">
<div class="win-head"><span class="ttl">Сообщить о проблеме</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="cats">
<div class="cat"><span class="ic">🖨</span>Не печатает</div>
<div class="cat on"><span class="ic">🌐</span>Нет сети</div>
<div class="cat"><span class="ic">🐢</span>Медленно</div>
<div class="cat"><span class="ic">⚠</span>Программа</div>
<div class="cat"><span class="ic">🔑</span>Доступ / ПО</div>
<div class="cat"><span class="ic">💬</span>Другое</div>
</div>
<div class="f">
<label>Описание <span class="hint">148 / 1000</span></label>
<textarea>Пропал интернет минут 15 назад, значок жёлтый. Соседям по кабинету то же самое.</textarea>
</div>
<div class="shot">
<div class="prev">🖥</div>
<div class="nm">Скриншот приложится<br>автоматически</div>
<button class="rm">Убрать</button>
</div>
<div class="f">
<label>Как с вами связаться</label>
<input value="каб. 214, вн. 45-12">
</div>
<button class="btn btn-p">Отправить</button>
</div>
</div>
</div>
<!-- ЭКРАН 2: список -->
<div>
<div class="screen-cap">Экран 2 · Мои обращения</div>
<div class="win">
<div class="win-head"><span class="ttl">Мои обращения</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="tk">
<div class="top"><span class="t">Нет сети</span><span class="chip c-wait"><i></i>Ждёт вас</span></div>
<div class="m">#1042 · сегодня, 14:02</div>
</div>
<div class="tk">
<div class="top"><span class="t">Не печатает HP</span><span class="chip c-work"><i></i>В работе</span></div>
<div class="m">#1031 · 12 ноя, Козлов Д.</div>
</div>
<div class="tk" style="opacity:.75">
<div class="top"><span class="t">Нужен 1С:ЗУП</span><span class="chip c-closed"><i></i>Закрыто</span></div>
<div class="m">#0987 · 3 ноя</div>
</div>
<div class="tk" style="opacity:.75">
<div class="top"><span class="t">Медленно грузится</span><span class="chip c-rej"><i></i>Отклонено</span></div>
<div class="m">#0950 · 28 окт</div>
</div>
</div>
</div>
</div>
<!-- ЭКРАН 3: карточка с перепиской -->
<div>
<div class="screen-cap">Экран 3 · Обращение и переписка</div>
<div class="win">
<div class="win-head"><span class="ttl">#1042 · Нет сети</span><span class="chip c-wait" style="margin-left:auto"><i></i>Ждёт вас</span></div>
<div class="win-body">
<div class="thread">
<div class="msg u"><span class="who">вы · 14:02</span>Пропал интернет минут 15 назад, значок жёлтый.</div>
<div class="msg a"><span class="who">Козлов Д. · 14:10</span>Вижу, у всего этажа пропал DHCP. Перезапускаю службу, проверьте через минуту.</div>
<div class="msg u"><span class="who">вы · 14:13</span>Появилась сеть, спасибо!</div>
<div class="sysline">Козлов Д. отметил как «Решено» · 14:15</div>
</div>
<div class="confirm">
<div class="q">Проблема решена? Через 3 дня обращение закроется само.</div>
<div style="display:flex;gap:8px">
<button class="btn btn-ok">Да, решено</button>
<button class="btn btn-err">Нет, не помогло</button>
</div>
</div>
<div class="reply"><input placeholder="Написать в обращение…"><button class="btn btn-s">→</button></div>
</div>
</div>
</div>
<!-- ЭКРАН 4: о программе -->
<div>
<div class="screen-cap">Экран 4 · О программе</div>
<div class="win">
<div class="win-head"><span class="ttl">О программе</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="about">
<div class="row"><span class="k">Приложение</span><span class="v">Штиль Помощник</span></div>
<div class="row"><span class="k">Версия</span><span class="v mono">0.9.2 (64-bit)</span></div>
<div class="row"><span class="k">Организация</span><span class="v">ООО «Ромашка»</span></div>
<div class="row"><span class="k">Устройство</span><span class="v mono">WS-0142</span></div>
<div class="row"><span class="k">Связь с агентом</span><span class="v st-ok">подключено</span></div>
</div>
</div>
</div>
</div>
</div>
<p class="note">
<b>Что учтено из решения 1.9:</b> поля «срочность» нет (приоритет ставит админ); описание со счётчиком до 1000; скриншот — превью с «Убрать»; кнопки «Решено / Не помогло» показываются только в статусе «Ожидает пользователя» и только когда политика организации включила подтверждение; список — последние 10 обращений.
</p>
</body>
</html>
+31 -53
View File
@@ -1,18 +1,14 @@
# Замер памяти PoC «Штиль Помощник» (#1.8.1–1.8.2). # Замер private working set PoC «Штиль Помощник» (#1.8.1–1.8.2).
# #
# Запускает release-сборку с флагом --measure-scenario: приложение само # Запускает release-сборку с флагом --measure-scenario: приложение само
# открывает и закрывает окна по таймеру и пишет отметки этапов в # открывает и закрывает окна по таймеру и пишет отметки этапов в
# helper-tray-poc.measure.log (рядом с exe, при недоступности — в %TEMP%). # helper-tray-poc.measure.log рядом с exe. Скрипт снимает private working set
# Скрипт снимает по отметкам два счётчика дерева процессов: # по отметкам: покой (30 с), открытое окно (+10 с), после закрытия (+10 с),
# PrivateBytes — committed private memory (решение принимаем по ней: # повторно открытое окно (+10 с). Время открытия берётся из строк
# Windows урезает рабочий набор простаивающих процессов, # «window-opened ... ms=N» в том же логе.
# поэтому WorkingSetPrivate для покоя занижен);
# WorkingSetPrivate — private working set, для справки.
# Отметки: покой (30 с), открытое окно (+10 с), после закрытия (+10 с),
# повторно открытое окно (+10 с). Время открытия — из строк
# «window-opened ... ms=N» в логе.
# #
# Дерево: процесс приложения + все дочерние msedgewebview2.exe (по цепочке # ОЗУ считается как сумма WorkingSetPrivate по дереву процессов:
# процесс приложения + все дочерние msedgewebview2.exe (ищем по цепочке
# родителей и по user-data-dir в командной строке). # родителей и по user-data-dir в командной строке).
# #
# Использование: powershell -ExecutionPolicy Bypass -File measure.ps1 [-Runs 5] # Использование: powershell -ExecutionPolicy Bypass -File measure.ps1 [-Runs 5]
@@ -26,10 +22,7 @@ param(
$ErrorActionPreference = 'Stop' $ErrorActionPreference = 'Stop'
$WebViewMarker = 'ru.tbsoft.shtil.helper.poc' $WebViewMarker = 'ru.tbsoft.shtil.helper.poc'
$LogCandidates = @( $LogPath = Join-Path (Split-Path $ExePath) 'helper-tray-poc.measure.log'
(Join-Path (Split-Path $ExePath) 'helper-tray-poc.measure.log'),
(Join-Path $env:TEMP 'helper-tray-poc.measure.log')
)
if (-not (Test-Path $ExePath)) { if (-not (Test-Path $ExePath)) {
throw "Не найден $ExePath — сначала выполните: pnpm tauri build" throw "Не найден $ExePath — сначала выполните: pnpm tauri build"
@@ -40,12 +33,9 @@ function Stop-Poc {
Get-CimInstance Win32_Process -Filter "Name='msedgewebview2.exe'" | Get-CimInstance Win32_Process -Filter "Name='msedgewebview2.exe'" |
Where-Object { $_.CommandLine -and $_.CommandLine.Contains($WebViewMarker) } | Where-Object { $_.CommandLine -and $_.CommandLine.Contains($WebViewMarker) } |
ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue } ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }
# Убитые процессы уходят не мгновенно; если не подождать, следующий прогон
# посчитает их за свойства нового (fallback ищет по user-data-dir).
Start-Sleep -Seconds 2
} }
function Get-TreeMemory([int]$AppPid) { function Get-TreePrivateWsMb([int]$AppPid) {
$all = Get-CimInstance Win32_Process $all = Get-CimInstance Win32_Process
# Дочерние процессы приложения (WebView2 плодит дерево глубиной 2–3 уровня). # Дочерние процессы приложения (WebView2 плодит дерево глубиной 2–3 уровня).
$tree = New-Object 'System.Collections.Generic.List[int]' $tree = New-Object 'System.Collections.Generic.List[int]'
@@ -64,18 +54,16 @@ function Get-TreeMemory([int]$AppPid) {
if (-not $tree.Contains($w.ProcessId)) { $tree.Add($w.ProcessId) } if (-not $tree.Contains($w.ProcessId)) { $tree.Add($w.ProcessId) }
} }
$perf = Get-CimInstance Win32_PerfFormattedData_PerfProc_Process $perf = Get-CimInstance Win32_PerfFormattedData_PerfProc_Process
$pb = 0.0; $ws = 0.0 $app = ($perf | Where-Object IDProcess -eq $AppPid | Select-Object -First 1).WorkingSetPrivate
$total = 0.0
foreach ($tpid in $tree) { foreach ($tpid in $tree) {
$row = $perf | Where-Object IDProcess -eq $tpid | Select-Object -First 1 $row = $perf | Where-Object IDProcess -eq $tpid | Select-Object -First 1
if ($row) { if ($row) { $total += $row.WorkingSetPrivate }
$pb += $row.PrivateBytes
$ws += $row.WorkingSetPrivate
}
} }
[pscustomobject]@{ [pscustomobject]@{
Pids = $tree.Count Pids = $tree.Count
PbMB = [math]::Round($pb / 1MB, 1) AppMB = [math]::Round($(if ($app) { $app } else { 0 }) / 1MB, 1)
WsMB = [math]::Round($ws / 1MB, 1) TotalMB = [math]::Round($total / 1MB, 1)
} }
} }
@@ -87,25 +75,24 @@ function Get-Median([double[]]$Values) {
$results = @() $results = @()
for ($run = 1; $run -le $Runs; $run++) { for ($run = 1; $run -le $Runs; $run++) {
Stop-Poc Stop-Poc
foreach ($log in $LogCandidates) { Remove-Item $log -ErrorAction SilentlyContinue } Remove-Item $LogPath -ErrorAction SilentlyContinue
Write-Host "── Прогон $run из $Runs ──────────────" Write-Host "── Прогон $run из $Runs ──────────────"
$proc = Start-Process $ExePath -ArgumentList '--measure-scenario' -PassThru $proc = Start-Process $ExePath -ArgumentList '--measure-scenario' -PassThru
$seen = 0 $seen = 0
$opens = @() $opens = @()
$sample = @{ Done = $false } $sample = @{}
$deadline = (Get-Date).AddSeconds($TimeoutSec) $deadline = (Get-Date).AddSeconds($TimeoutSec)
while ((Get-Date) -lt $deadline -and -not $sample.Done) { while ((Get-Date) -lt $deadline -and -not $sample.Done) {
$logPath = $LogCandidates | Where-Object { Test-Path $_ } | Select-Object -First 1 if (Test-Path $LogPath) {
if ($logPath) { foreach ($line in (Get-Content $LogPath | Select-Object -Skip $seen)) {
foreach ($line in (Get-Content $logPath | Select-Object -Skip $seen)) {
$seen++ $seen++
switch -Regex ($line) { switch -Regex ($line) {
'stage open-window-1' { $sample.Idle = Get-TreeMemory $proc.Id } 'stage open-window-1' { $sample.Idle = Get-TreePrivateWsMb $proc.Id }
'stage close-window-1' { $sample.Open = Get-TreeMemory $proc.Id } 'stage close-window-1' { $sample.Open = Get-TreePrivateWsMb $proc.Id }
'stage open-window-2' { $sample.AfterClose = Get-TreeMemory $proc.Id } 'stage open-window-2' { $sample.AfterClose = Get-TreePrivateWsMb $proc.Id }
'stage close-window-2' { $sample.WarmOpen = Get-TreeMemory $proc.Id } 'stage close-window-2' { $sample.WarmOpen = Get-TreePrivateWsMb $proc.Id }
'window-opened .*ms=(\d+)' { $opens += [int]$Matches[1] } 'window-opened .*ms=(\d+)' { $opens += [int]$Matches[1] }
'stage done' { $sample.Done = $true } 'stage done' { $sample.Done = $true }
} }
@@ -114,10 +101,7 @@ for ($run = 1; $run -le $Runs; $run++) {
Start-Sleep -Milliseconds 200 Start-Sleep -Milliseconds 200
} }
# После «stage done» приложение должно завершиться само (app.exit(0) $proc | Wait-Process -Timeout 15 -ErrorAction SilentlyContinue
# не блокируется prevent_exit — code задан).
$null = $proc | Wait-Process -Timeout 10 -ErrorAction SilentlyContinue
$selfExited = $proc.HasExited
Stop-Poc Stop-Poc
if (-not $sample.Done) { if (-not $sample.Done) {
@@ -127,30 +111,24 @@ for ($run = 1; $run -le $Runs; $run++) {
$results += [pscustomobject]@{ $results += [pscustomobject]@{
Run = $run Run = $run
IdlePbMB = $sample.Idle.PbMB IdleMB = $sample.Idle.TotalMB
IdleWsMB = $sample.Idle.WsMB OpenMB = $sample.Open.TotalMB
OpenPbMB = $sample.Open.PbMB AfterCloseMB = $sample.AfterClose.TotalMB
OpenWsMB = $sample.Open.WsMB WarmOpenMB = $sample.WarmOpen.TotalMB
AfterClosePb = $sample.AfterClose.PbMB
AfterCloseWs = $sample.AfterClose.WsMB
WarmOpenPb = $sample.WarmOpen.PbMB
ColdOpenMs = $opens[0] ColdOpenMs = $opens[0]
WarmOpenMs = $opens[1] WarmOpenMs = $opens[1]
SelfExit = [bool]$selfExited
} }
Write-Host (" покой {0}/{1} МБ · окно {2}/{3} МБ · после закрытия {4}/{5} МБ · открытие {6}/{7} мс" -f ` Write-Host (" покой {0} МБ · окно {1} МБ · после закрытия {2} МБ · открытие {3}/{4} мс" -f `
$sample.Idle.PbMB, $sample.Idle.WsMB, $sample.Open.PbMB, $sample.Open.WsMB, ` $sample.Idle.TotalMB, $sample.Open.TotalMB, $sample.AfterClose.TotalMB, $opens[0], $opens[1])
$sample.AfterClose.PbMB, $sample.AfterClose.WsMB, $opens[0], $opens[1])
} }
if (-not $results) { throw "Ни один прогон не завершился" } if (-not $results) { throw "Ни один прогон не завершился" }
Write-Host "" Write-Host ""
Write-Host "══ Итог ($($results.Count) прогонов): медиана [min–max], PB = PrivateBytes, WS = WorkingSetPrivate ══" Write-Host "══ Итог ($($results.Count) прогонов): медиана [min–max] ══"
foreach ($m in 'IdlePbMB','IdleWsMB','OpenPbMB','OpenWsMB','AfterClosePb','AfterCloseWs','WarmOpenPb','ColdOpenMs','WarmOpenMs') { foreach ($m in 'IdleMB','OpenMB','AfterCloseMB','WarmOpenMB','ColdOpenMs','WarmOpenMs') {
$v = @($results | ForEach-Object { [double]$_.$m }) $v = @($results | ForEach-Object { [double]$_.$m })
$med = Get-Median $v $med = Get-Median $v
Write-Host (" {0,-13} {1,8} [{2} – {3}]" -f $m, $med, ($v | Measure-Object -Minimum).Minimum, ($v | Measure-Object -Maximum).Maximum) Write-Host (" {0,-13} {1,8} [{2} – {3}]" -f $m, $med, ($v | Measure-Object -Minimum).Minimum, ($v | Measure-Object -Maximum).Maximum)
} }
if (-not ($results.SelfExit -contains $false)) { Write-Host " приложение завершилось само во всех прогонах" } else { Write-Warning "были прогоны без самостоятельного завершения" }
$results | Format-Table -AutoSize $results | Format-Table -AutoSize
@@ -1,7 +1,9 @@
{ {
"$schema": "../gen/schemas/desktop-schema.json", "$schema": "../gen/schemas/desktop-schema.json",
"identifier": "helper-windows", "identifier": "helper-windows",
"description": "Окна Помощника, создаваемые динамически из меню трея. Команды приложения не входят в ACL, плагинов нет — разрешений не нужно", "description": "Окна Помощника, создаваемые динамически из меню трея",
"windows": ["win-*"], "windows": ["win-*"],
"permissions": [] "permissions": [
"core:default"
]
} }
+8 -16
View File
@@ -143,21 +143,16 @@ fn spawn_measure_scenario(app: AppHandle) {
} }
fn measure_log_file() -> Option<File> { fn measure_log_file() -> Option<File> {
let exe_dir = std::env::current_exe() let dir = std::env::current_exe()
.ok() .ok()
.and_then(|p| p.parent().map(|d| d.to_path_buf())); .and_then(|p| p.parent().map(|d| d.to_path_buf()))
for dir in [exe_dir, Some(std::env::temp_dir())].into_iter().flatten() { .unwrap_or_else(std::env::temp_dir);
match OpenOptions::new() OpenOptions::new()
.create(true) .create(true)
.write(true) .write(true)
.truncate(true) .truncate(true)
.open(dir.join("helper-tray-poc.measure.log")) .open(dir.join("helper-tray-poc.measure.log"))
{ .ok()
Ok(f) => return Some(f),
Err(e) => eprintln!("не удалось открыть лог в {}: {}", dir.display(), e),
}
}
None
} }
#[cfg_attr(mobile, tauri::mobile_entry_point)] #[cfg_attr(mobile, tauri::mobile_entry_point)]
@@ -186,13 +181,10 @@ pub fn run() {
}) })
.build(tauri::generate_context!()) .build(tauri::generate_context!())
.expect("error while building tauri application"); .expect("error while building tauri application");
// Трею нельзя завершаться при закрытии последнего окна (code == None); // Трею нельзя завершаться при закрытии последнего окна;
// при программном выходе code задан — prevent_exit не вызываем, // app.exit(0) при этом продолжает работать.
// иначе app.exit(0) был бы заблокирован.
app.run(|_handle, event| { app.run(|_handle, event| {
if let tauri::RunEvent::ExitRequested { code, api, .. } = event if let tauri::RunEvent::ExitRequested { api, .. } = event {
&& code.is_none()
{
api.prevent_exit(); api.prevent_exit();
} }
}); });
+1 -1
View File
@@ -12,7 +12,7 @@
"app": { "app": {
"windows": [], "windows": [],
"security": { "security": {
"csp": "default-src 'self'; style-src 'self' 'unsafe-inline'; connect-src ipc: http://ipc.localhost" "csp": "default-src 'self'; style-src 'self' 'unsafe-inline'"
} }
}, },
"bundle": { "bundle": {
-3
View File
@@ -17,13 +17,10 @@ const description = ref("");
const sent = ref(false); const sent = ref(false);
onMounted(() => { onMounted(() => {
// Двойной rAF: вторая рамка гарантирует, что первая уже отрисована.
requestAnimationFrame(() => {
requestAnimationFrame(() => { requestAnimationFrame(() => {
void invoke("first_paint"); void invoke("first_paint");
}); });
}); });
});
</script> </script>
<template> <template>