functions.md

# AiteBar Functions

## Краткое описание программы

AiteBar - desktop-утилита для Windows: скрываемая edge-панель быстрого доступа с пользовательскими кнопками, панелями-контекстами, встроенными быстрыми инструментами, tray-меню, глобальными горячими клавишами, импортом/экспортом панелей и локальным хранением настроек.

Пользователь может запускать сайты, приложения, файлы, папки, скрипты, консольные команды и сочетания клавиш. Web-действия поддерживают выбор браузера, профиля, app mode, incognito/private mode, fullscreen и ротацию профилей.

---

# Карта возможностей

- Панель быстрого доступа
  - Показать панель наведением на край экрана
  - Показать/скрыть панель через tray
  - Показать/скрыть панель через указатель положения панели
  - Показать панель глобальной горячей клавишей
  - Автоматически скрыть панель кликом вне нее
  - Переместить панель на другой край экрана drag-and-drop за handle
  - Переместить панель на другой монитор
  - Переключить активную панель через контекстное меню
  - Переключить активную панель колесом мыши
  - Переключить активную панель горячими клавишами
  - Открыть настройки программы через кнопку ⚙️ на панели
  - Указатель положения панели
    - Показать/скрыть указатель
    - Перетащить указатель в удобное место выбранного монитора
    - Сохранить относительное положение при изменении DPI или разрешения
    - Не допустить выхода указателя за видимые границы монитора
    - Показать подсказку с положением панели при наведении
    - Контекстное меню указателя с быстрым доступом к панели и настройкам

- Пользовательские кнопки
  - Создать кнопку
  - Создать кнопку перетаскиванием файла, папки, `.url` или `http/https` ссылки
  - Запустить пользовательскую кнопку
  - Изменить порядок кнопок перетаскиванием
  - Редактировать кнопку
  - Дублировать кнопку
  - Переименовать кнопку
  - Переместить кнопку в другую панель
  - Удалить кнопку
  - Скопировать URL, путь или команду
  - Открыть расположение файла, папки, программы или скрипта

- Типы действий кнопок
  - Открыть web-ссылку
  - Запустить программу
  - Открыть файл
  - Открыть папку
  - Запустить `.bat` или `.cmd`
  - Запустить `.ps1`
  - Запустить `.py`
  - Выполнить консольную команду
  - Отправить сочетание клавиш

- Web-действия
  - Выбрать браузер
  - Выбрать браузерный профиль
  - Запустить сайт в app mode
  - Запустить сайт в incognito/private mode
  - Запустить сайт и перевести окно в fullscreen
  - Включить ротацию профилей
  - Выбрать профили для ротации
  - Найти профиль через поиск в окне выбора ротации
  - Выбрать все профили ротации
  - Очистить выбор профилей ротации

- Встроенные быстрые инструменты
  - Искать текст из буфера обмена в Google
  - Сделать скриншот через Windows screen clipping
  - Запустить запись экрана через Windows screen clipping
  - Открыть калькулятор
  - Открыть проводник
  - Открыть папку загрузок
  - Открыть таймер и секундомер
  - Взять цвет с экрана и скопировать HEX
  - Открыть Quick Note
  - Открыть File Sorter
  - Открыть Icon Converter
  - Открыть QR Code Generator
  - Открыть Clipboard Manager
  - Открыть обработку текста
  - Открыть Дзен-редактор
  - Открыть Aite Profiles
  - Проверить орфографию и пунктуацию без изменения формулировок
  - Применить типографику с учетом языка текста
  - Очистить артефакты копирования из PDF, документов и веб-страниц
  - Повторить последнюю обработку
  - Смотреть историю текста и изображений между сессиями AiteBar
  - Закреплять важные клипы
  - Копировать текст как одну строку для промптов, команд и URL
  - Фильтровать историю по закреплённым, тексту и изображениям
  - Очищать только незакреплённую историю или полностью стирать все клипы
  - Показать рабочий стол
  - Открыть папку приложений
  - Открыть Copilot
  - Открепить встроенный инструмент от панели

- Quick Note
  - Открыть быструю заметку
  - Ввести и редактировать текст
  - Автосохранить заметку в Markdown
  - Открыть файл заметки во внешнем редакторе
  - Очистить заметку
  - Закрыть заметку
  - Переместить окно заметки
  - Изменить размер окна заметки
  - Закрепить/открепить окно заметки (не закрывать при потере фокуса)
  - Выбрать тему заметки
  - Сделать текст жирным
  - Сделать текст курсивом
  - Подчеркнуть текст
  - Применить inline-code стиль
  - Создать/убрать маркированный список
  - Создать/убрать нумерованный список
  - Очистить форматирование
  - Вырезать, копировать, вставить, выделить все
  - Скопировать весь текст заметки через Ctrl+Shift+C
  - Открыть URL из заметки через Ctrl+клик
  - Автоматически подсветить ссылки
  - Сохранить конфликтную копию при внешнем изменении файла

- Настройки кнопки
  - Задать название
  - Выбрать тип действия
  - Выбрать панель
  - Ввести URL, путь или команду
  - Выбрать файл, папку, программу или скрипт через диалог
  - Задать браузер и профиль
  - Включить app mode, incognito, fullscreen, ротацию
  - Задать сочетание клавиш для hotkey-действия
  - Выбрать иконку из библиотеки
  - Найти иконку в библиотеке
  - Выбрать пользовательскую иконку-файл
  - Выбрать цвет из палитры
  - Ввести HEX-цвет
  - Открыть настройки программы из окна кнопки
  - Сохранить или отменить изменения

- Настройки программы
  - Выбрать язык интерфейса
  - Выбрать сторону панели
  - Выбрать монитор
  - Настроить размер панели
  - Настроить размер зоны активации
  - Настроить задержку появления
  - Включить/отключить указатель положения панели
  - Включить/отключить панели 2-10
  - Переименовать панели
  - Назначить hotkey показа панели
  - Назначить hotkey следующей панели
  - Назначить hotkey предыдущей панели
  - Назначить hotkey добавления кнопки
  - Назначить hotkey File Sorter
  - Назначить hotkey Icon Converter
  - Назначить hotkey Quick Note
  - Назначить hotkey Color Picker
  - Назначить hotkey Timer/Stopwatch
  - Назначить hotkey QR Code Generator
  - Назначить hotkey Clipboard Manager
  - Назначить hotkey Обработки текста
  - Назначить hotkey Дзен-редактора
  - Назначить hotkey Конструктора промптов
  - Назначить hotkey Aite Profiles
  - Включить/отключить встроенные быстрые инструменты
  - Изменить порядок кнопок встроенных утилит
  - Сохранить или отменить настройки

- Импорт и экспорт
  - Экспортировать текущую панель в `.aitebarpanel`
  - Импортировать `.aitebarpanel` в текущую панель
  - Просмотреть подтверждение с количеством импортируемых кнопок
  - Экспортировать резервную копию настроек и локальных данных в `.aitebarbackup`
  - Восстановить настройки и данные из `.aitebarbackup` с опциональным шифрованием секретов

- Tray и справка
  - Открыть панель
  - Открыть настройки программы
  - Проверить обновления
  - Открыть окно "О программе"
  - Открыть страницу поддержки автора
  - Закрыть приложение

- О программе
  - Посмотреть версию
  - Открыть сайт продукта
  - Открыть GitHub-репозиторий
  - Открыть third-party notices
  - Открыть папку данных
  - Открыть папку программы

---

# Полный каталог функций

## Показ панели наведением на край экрана

### Назначение

Открывает скрытую панель, когда курсор находится в настроенной зоне активации у выбранного края экрана.

### Где находится

- Главная панель.
- Системный background-обработчик курсора.
- Настройки: сторона панели, монитор, зона активации, задержка и переключатель показа при наведении.

### Как использовать

1. Убедиться, что AiteBar запущен.
2. Подвести курсор к настроенному краю экрана.
3. Дождаться истечения задержки появления.

### Входные данные

Положение курсора; настройки `Edge`, `MonitorIndex`, `ActivationZoneSizePercent`, `ActivationDelayMs`, `ShowPanelOnMouseHover`.

### Результат

Панель плавно выезжает у выбранного края экрана.

### Ограничения

Панель реагирует на выбранный монитор и выбранную сторону только при включённом `ShowPanelOnMouseHover`. Если настройка отключена, курсор вне зоны или приложение занято анимацией/перетаскиванием панели, показ не выполняется. Hotkey, tray и указатель положения продолжают открывать панель независимо от этой настройки.

### Связанные функции

Настройка стороны панели, настройка монитора, настройка зоны активации, настройка задержки, скрытие панели.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/ActivationZoneHelper.cs`, `AiteBar/PanelLayoutHelper.cs`, `AiteBar/Models.cs`.

## Показ и скрытие панели через tray

### Назначение

Позволяет открыть или скрыть панель кликом по иконке AiteBar в системном tray.

### Где находится

- Системный tray.
- Левый клик по NotifyIcon.
- Контекстное меню tray: `Открыть`.

### Как использовать

1. Найти иконку AiteBar в tray.
2. Нажать левой кнопкой мыши для toggle.
3. Или открыть контекстное меню правой кнопкой и выбрать `Открыть`.

### Входные данные

Клик мышью по tray icon.

### Результат

Панель показывается или скрывается.

### Ограничения

Если панель уже анимируется, повторный toggle игнорируется.

### Связанные функции

Tray-меню, показ панели hotkey, скрытие панели кликом вне панели.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs` (`InitTrayIcon`, `ToggleDock`, `ShowTrayContextMenu`).

## Открыть настройки через кнопку на панели

### Назначение

Открывает окно настроек программы через кнопку ⚙️ на панели.

### Где находится

- Кнопка настроек (⚙️) на правом (или нижнем, при вертикальной ориентации) краю панели.

### Как использовать

1. Открыть панель.
2. Нажать кнопку настроек (⚙️).

### Входные данные

Клик мышью по кнопке настроек.

### Результат

Панель скрывается, открывается окно настроек программы.

### Ограничения

Если панель анимируется, нажатие может быть проигнорировано.

### Связанные функции

Показ/скрытие панели, настройки программы через tray.

### Подтверждение в коде

`AiteBar/MainWindow.xaml` (AppSettingsBlock, BtnAppSettings), `AiteBar/MainWindow.xaml.cs` (`BtnAppSettings_Click`).

## Показ панели горячей клавишей

### Назначение

Открывает/скрывает панель через глобальную горячую клавишу.

### Где находится

- Настройки программы -> вкладка горячих клавиш.
- Win32 global hotkey.

### Как использовать

1. Открыть настройки программы.
2. Назначить модификатор и клавишу для действия `Показать панель`.
3. Сохранить настройки.
4. Нажать заданную комбинацию в Windows.

### Входные данные

Модификатор: не назначено, Ctrl, Alt, Shift, Win, Ctrl+Alt, Ctrl+Shift, Alt+Shift, Ctrl+Win, Alt+Win, Ctrl+Alt+Shift. Клавиша: Space, `[`, `]`, A-Z, 0-9, F1-F12.

### Результат

Панель открывается или скрывается.

### Ограничения

Если Windows или другая программа не дает зарегистрировать hotkey, приложение сохраняет настройки, но показывает предупреждение, что комбинация не будет работать до изменения.

### Связанные функции

Настройка hotkeys, переключение панелей hotkey, добавление кнопки hotkey.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/AppSettingsWindow.xaml.cs`, `AiteBar/NativeIntegrationService.cs`, `AiteBar/NativeMethods.cs`.

## Автоматическое скрытие панели

### Назначение

Скрывает открытую панель, когда пользователь кликает вне ее области.

### Где находится

Глобальный mouse hook.

### Как использовать

1. Открыть панель.
2. Кликнуть мышью вне панели.

### Входные данные

Координаты клика мышью.

### Результат

Панель плавно скрывается.

### Ограничения

Не скрывается во время активных контекстных меню, диалогов или drag-and-drop панели.

### Связанные функции

Показ панели, контекстные меню, диалоги импорта/экспорта.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/NativeIntegrationService.cs`.

## Перемещение панели на другой край или монитор

### Назначение

Позволяет сменить сторону панели и монитор перетаскиванием handle на самой панели.

### Где находится

Handle на рабочей панели.

### Как использовать

1. Открыть панель.
2. Захватить handle мышью.
3. Перетащить панель к другому краю экрана или на другой монитор.
4. Отпустить кнопку мыши.

### Входные данные

Позиция курсора во время drag.

### Результат

Приложение выбирает ближайший край экрана, сохраняет сторону и индекс монитора.

### Ограничения

При отсутствии реального изменения сторона и монитор откатываются к исходным значениям.

### Связанные функции

Настройка стороны панели, настройка монитора, расчет layout панели.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs` (`DragHandle_*`, `GetClosestDockEdge`, `FindScreenIndex`), `AiteBar/Models.cs`.

## Переключение активной панели

### Назначение

Меняет текущую панель-контекст, чтобы показывать другой набор пользовательских кнопок.

### Где находится

- Контекстное меню основной панели.
- Колесо мыши над открытой панелью.
- Горячие клавиши следующей/предыдущей панели.

### Как использовать

1. Открыть панель.
2. Выбрать другую панель в контекстном меню или прокрутить колесо мыши.
3. Либо нажать назначенную горячую клавишу следующей/предыдущей панели.

### Входные данные

Выбор панели, направление прокрутки, hotkey.

### Результат

Активная панель меняется, список пользовательских кнопок обновляется с короткой анимацией.

### Ограничения

Переключение работает только между включенными панелями.

### Связанные функции

Настройки панелей, перенос кнопки в другую панель, hotkeys.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/ContextStateHelper.cs`, `AiteBar/AppSettingsWindow.xaml.cs`.

## Создание кнопки вручную

### Назначение

Создает пользовательскую кнопку действия.

### Где находится

- Кнопка `+` на панели.
- Горячая клавиша `Добавить кнопку`.
- Окно `SettingsWindow`.

### Как использовать

1. Открыть панель.
2. Нажать `+` или назначенную горячую клавишу добавления.
3. Ввести название.
4. Выбрать тип действия.
5. Указать URL, путь, команду или hotkey.
6. Выбрать панель, иконку и цвет.
7. Нажать `Сохранить`.

### Входные данные

Название, тип действия, значение действия, панель, browser/profile options, иконка, цвет, Hotkey action payload и отдельный global shortcut кнопки.

### Результат

Кнопка сохраняется в локальных настройках и появляется на выбранной панели.

### Ограничения

Название обязательно. Для всех типов кроме Hotkey обязательно значение действия. Пути и URL проходят валидацию.

### Связанные функции

Редактирование кнопки, выбор иконки, выбор цвета, выбор браузера, выбор профиля.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/SettingsWindow.xaml`, `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/AppSettingsService.cs`.

## Создание кнопки drag-and-drop

### Назначение

Создает кнопку из перетаскиваемого файла, папки, `.url` ярлыка или прямой web-ссылки.

### Где находится

Главная панель, drag-and-drop на `RootBorder`.

### Как использовать

1. Открыть панель.
2. Перетащить один поддержанный объект на панель.
3. Отпустить объект.

### Входные данные

Один файл, одна папка, `.url` файл или текст `http/https` URL.

### Результат

Создается новая кнопка в активной панели. Для программ и скриптов приложение пытается извлечь иконку. Для web-ссылки может асинхронно загрузиться favicon.

### Ограничения

Одновременно поддерживается только один объект. Поддерживаются только существующие файлы/папки, `.url` с http/https и прямые http/https ссылки.

### Связанные функции

Запуск кнопки, редактирование кнопки, извлечение иконки, загрузка favicon.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs` (`Border_DragOver`, `TryGetDropTarget`, `Border_Drop`), `AiteBar/ActionTargetHelper.cs`, `AiteBar/IconHelper.cs`.

## Запуск пользовательской кнопки

### Назначение

Выполняет действие, привязанное к кнопке.

### Где находится

Пользовательские кнопки активной панели.

### Как использовать

1. Открыть панель.
2. Нажать пользовательскую кнопку левой кнопкой мыши.

### Входные данные

Настройки конкретной кнопки.

### Результат

Запускается web-ссылка, программа, файл, папка, скрипт, команда или hotkey-действие.

### Ограничения

При ошибке запуска показывается dialog с текстом ошибки.

### Связанные функции

Все типы действий кнопки.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/ActionService.cs`, `AiteBar/ActionExecutionResult.cs`.

## Изменение порядка кнопок

### Назначение

Позволяет переставлять пользовательские кнопки внутри активной панели.

### Где находится

Пользовательские кнопки на панели.

### Как использовать

1. Зажать кнопку левой кнопкой мыши.
2. Сдвинуть ее больше чем на 10 px.
3. Перетащить на нужное место.
4. Отпустить кнопку мыши.

### Входные данные

Позиция drag.

### Результат

Порядок кнопок сохраняется.

### Ограничения

Работает в пределах активной панели.

### Связанные функции

Панели-контексты, перенос кнопки в другую панель.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/AppSettingsService.cs`.

## Редактирование кнопки

### Назначение

Открывает окно настройки существующей кнопки.

### Где находится

Контекстное меню пользовательской кнопки -> `Редактировать`.

### Как использовать

1. Правый клик по пользовательской кнопке.
2. Выбрать `Редактировать`.
3. Изменить параметры.
4. Сохранить.

### Входные данные

Любые поля кнопки.

### Результат

Существующая кнопка обновляется.

### Ограничения

Применяется та же валидация, что при создании кнопки.

### Связанные функции

Создание кнопки, выбор иконки, выбор профиля, выбор ротации.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/SettingsWindow.xaml.cs`.

## Дублирование кнопки

### Назначение

Создает копию кнопки рядом с исходной и открывает ее для редактирования.

### Где находится

Контекстное меню пользовательской кнопки -> `Дублировать`.

### Как использовать

1. Правый клик по кнопке.
2. Выбрать `Дублировать`.
3. При необходимости изменить параметры копии.
4. Сохранить.

### Входные данные

Исходная кнопка.

### Результат

Создается новая кнопка с новым ID и именем вида `Имя (копия)`.

### Ограничения

`LastUsedProfile` у копии сбрасывается.

### Связанные функции

Редактирование кнопки, переименование кнопки.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs` (`DuplicateElementAsync`, `BuildDuplicateElementName`).

## Переименование кнопки

### Назначение

Меняет только название существующей кнопки через быстрый prompt.

### Где находится

Контекстное меню пользовательской кнопки -> `Переименовать`.

### Как использовать

1. Правый клик по кнопке.
2. Выбрать `Переименовать`.
3. Ввести новое имя.
4. Сохранить.

### Входные данные

Непустое название.

### Результат

Название кнопки обновляется.

### Ограничения

Пустое имя нельзя сохранить.

### Связанные функции

Редактирование кнопки, дублирование кнопки.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/TextPromptDialog.xaml.cs`.

## Перемещение кнопки в другую панель

### Назначение

Переносит кнопку из текущей панели в другую включенную панель.

### Где находится

Контекстное меню пользовательской кнопки -> `Переместить` -> имя панели.

### Как использовать

1. Правый клик по кнопке.
2. Открыть подменю `Переместить`.
3. Выбрать целевую панель.

### Входные данные

ID целевой панели.

### Результат

`ContextId` кнопки меняется, панель обновляется.

### Ограничения

Целевая панель должна быть включена и отличаться от текущей.

### Связанные функции

Настройка панелей, переключение панелей.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/Models.cs`.

## Удаление кнопки

### Назначение

Удаляет пользовательскую кнопку после подтверждения.

### Где находится

Контекстное меню пользовательской кнопки -> `Удалить`.

### Как использовать

1. Правый клик по кнопке.
2. Выбрать `Удалить`.
3. Подтвердить удаление.

### Входные данные

Подтверждение пользователя.

### Результат

Кнопка удаляется из локальных настроек.

### Ограничения

Удаление не выполняется без подтверждения.

### Связанные функции

Создание кнопки, импорт панели.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/AppSettingsService.cs`.

## Копирование URL, пути или команды кнопки

### Назначение

Копирует основное значение действия кнопки в буфер обмена.

### Где находится

Контекстное меню пользовательской кнопки.

### Как использовать

1. Правый клик по кнопке.
2. Выбрать `Копировать URL`, `Копировать путь` или `Копировать команду`.

### Входные данные

Кнопка с непустым `ActionValue`.

### Результат

Значение действия попадает в буфер обмена.

### Ограничения

Недоступно для hotkey-действий и кнопок без `ActionValue`.

### Связанные функции

Редактирование кнопки, запуск кнопки.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs` (`TryCreateCopyActionMenuItem`, `TryGetCopyValue`).

## Открытие расположения действия

### Назначение

Открывает папку или выделяет файл/программу/скрипт в проводнике.

### Где находится

Контекстное меню пользовательской кнопки -> `Открыть расположение`.

### Как использовать

1. Правый клик по кнопке типа Program, File, Folder или ScriptFile.
2. Выбрать `Открыть расположение`.

### Входные данные

Путь к существующей папке или файлу.

### Результат

Открывается `explorer.exe` с папкой или выделенным файлом.

### Ограничения

Недоступно для Web, Command и Hotkey.

### Связанные функции

Копирование пути, запуск файла/папки.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs` (`CanOpenElementLocation`, `OpenElementLocationAsync`).

## Запуск web-ссылки

### Назначение

Открывает URL в выбранном браузере с указанными web-параметрами.

### Где находится

Кнопка типа `Web`.

### Как использовать

1. Создать или отредактировать кнопку.
2. Выбрать тип `Ссылка`.
3. Указать URL.
4. Выбрать браузер и параметры.
5. Нажать кнопку на панели.

### Входные данные

URL, browser, profile, app mode, incognito, fullscreen, rotation.

### Результат

Браузер запускается с нужными аргументами.

### Ограничения

URL валидируется и нормализуется. Если браузер не найден по известным путям, используется имя executable.

### Связанные функции

Выбор браузера, выбор профиля, ротация профилей.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/BrowserHelper.cs`, `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/ActionTargetHelper.cs`.

## Запуск программы

### Назначение

Запускает выбранную программу или ярлык.

### Где находится

Кнопка типа `Program`.

### Как использовать

1. Создать кнопку типа `Программа`.
2. Выбрать файл через `Обзор` или ввести путь.
3. Сохранить.
4. Нажать кнопку.

### Входные данные

Путь к существующему executable/подходящему program target.

### Результат

Программа запускается через shell.

### Ограничения

Путь должен существовать и проходить проверку `ActionTargetHelper.IsProgramPath`.

### Связанные функции

Извлечение иконки, открытие расположения, копирование пути.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/ActionTargetHelper.cs`.

## Открытие файла

### Назначение

Открывает файл в ассоциированном приложении Windows.

### Где находится

Кнопка типа `File`.

### Как использовать

1. Создать кнопку типа `Файл`.
2. Выбрать файл через `Обзор` или ввести путь.
3. Сохранить и нажать кнопку.

### Входные данные

Путь к существующему обычному файлу.

### Результат

Файл открывается через shell.

### Ограничения

Путь должен существовать и быть обычным файлом, не программой/скриптом.

### Связанные функции

Открытие расположения, копирование пути.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/ActionTargetHelper.cs`.

## Открытие папки

### Назначение

Открывает выбранную папку.

### Где находится

Кнопка типа `Folder`.

### Как использовать

1. Создать кнопку типа `Папка`.
2. Выбрать папку через диалог или ввести путь.
3. Сохранить и нажать кнопку.

### Входные данные

Путь к существующей папке.

### Результат

Папка открывается в Windows.

### Ограничения

Папка должна существовать.

### Связанные функции

Открытие расположения, копирование пути.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`.

## Запуск скрипта

### Назначение

Запускает поддержанный script file.

### Где находится

Кнопка типа `ScriptFile`.

### Как использовать

1. Создать кнопку типа `Скрипт`.
2. Выбрать `.bat`, `.cmd`, `.ps1`, `.py` или `.pyw`.
3. При необходимости задать аргументы командной строки, отключить подтверждение, включить режим «Оставлять окно открытым» (чтобы окно консоли не закрывалось сразу), фоновый режим (скрытие консоли) или запуск от имени администратора.
4. Сохранить и нажать кнопку.

### Входные данные

Путь к существующему скрипту (валидируется перед запуском с отображением ошибки при отсутствии файла), опциональные аргументы командной строки.

### Результат

`.bat`/`.cmd` запускаются через `cmd.exe /c call` (или `/k` при включённом «Оставлять окно открытым»); `.ps1` через `pwsh.exe` или `powershell.exe` с флагом `-ExecutionPolicy Bypass` (и `-NoExit` при включённом «Оставлять окно открытым»); `.pyw` через `pythonw.exe` (без консоли); `.py` через автоматически найденный интерпретатор Python (локальный `.venv`, `uv`, стандартные каталоги установки, PATH) с флагом `-i` при включённом «Оставлять окно открытым».

### Ограничения

Поддерживаются `.bat`, `.cmd`, `.ps1`, `.py`, `.pyw`. Для Python поддерживаются виртуальные окружения рядом со скриптом, `uv`, стандартные пути установки и `PATH` с защитой от пустых заглушек WindowsApps. Для PowerShell (как `pwsh`, так и Windows PowerShell) передается `ExecutionPolicy Bypass`. Поддерживается безопасная передача аргументов с кавычками, удержание окна консоли открытым, скрытие окна консоли и запуск от имени администратора.

### Связанные функции

Открытие расположения, копирование пути, запуск команды.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/ActionTargetHelper.cs`.

## Выполнение консольной команды

### Назначение

Выполняет строку команды через `cmd.exe`.

### Где находится

Кнопка типа `Command`.

### Как использовать

1. Создать кнопку типа `Команда`.
2. Ввести команду.
3. Сохранить.
4. Нажать кнопку.
5. Подтвердить выполнение.

### Входные данные

Строка команды.

### Результат

Команда запускается через `cmd.exe /c`.

### Ограничения

Перед запуском всегда показывается подтверждение.

### Связанные функции

Копирование команды, запуск скрипта.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`.

## Отправка сочетания клавиш

### Назначение

Отправляет выбранное сочетание клавиш в активную систему/приложение.

### Где находится

Кнопка типа `Hotkey`.

### Как использовать

1. Создать кнопку типа `Горячие клавиши`.
2. Выбрать Ctrl, Shift, Alt, Win и клавишу.
3. Сохранить.
4. Нажать кнопку.

### Входные данные

Модификаторы Ctrl/Shift/Alt/Win и основная клавиша: A-Z, 0-9, F1-F12, PrintScreen.

### Результат

Приложение отправляет key down/up события через Win32 `SendInput`.

### Ограничения

Основная клавиша обязательна. Global shortcut, запускающий кнопку, настраивается отдельно и не используется как payload действия.

### Связанные функции

Настройка hotkeys панели, пользовательские действия.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/NativeMethods.cs`.

## Выбор браузера и профиля

### Назначение

Позволяет запускать web-ссылки в конкретном браузере и конкретном профиле.

### Где находится

Окно настройки кнопки для типа `Web`.

### Как использовать

1. Выбрать тип действия `Ссылка`.
2. Выбрать браузер.
3. Выбрать профиль из списка.
4. Сохранить кнопку.

### Входные данные

Браузер: Chrome, Edge, Brave, Yandex, Opera, Opera GX, Vivaldi, Firefox. Профиль из найденных локальных профилей.

### Результат

Web-действие запускается с аргументом профиля.

### Ограничения

Если профили не найдены, доступен вариант без профиля. Для Firefox используется `-P` и имя профиля; для Chromium-подобных браузеров `--profile-directory`.

### Связанные функции

Web-действие, ротация профилей.

### Подтверждение в коде

`AiteBar/BrowserHelper.cs`, `AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`.

## App mode, incognito и fullscreen для web-действий

### Назначение

Меняет режим запуска web-ссылки.

### Где находится

Окно настройки кнопки для типа `Web`.

### Как использовать

1. Создать или отредактировать web-кнопку.
2. Включить `В режиме приложений`, `В режиме инкогнито` или `Открыть на весь экран`.
3. Сохранить.
4. Запустить кнопку.

### Входные данные

Три флага: `IsAppMode`, `IsIncognito`, `OpenFullscreen`.

### Результат

Браузер запускается с соответствующими аргументами; fullscreen отправляет F11 после появления окна.

### Ограничения

Fullscreen зависит от появления `MainWindowHandle` у процесса браузера.

### Связанные функции

Запуск web-ссылки, выбор браузера.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/SettingsWindow.xaml.cs`.

## Ротация браузерных профилей

### Назначение

Позволяет web-кнопке каждый запуск использовать следующий профиль из выбранного набора.

### Где находится

Окно настройки кнопки -> web-настройки -> `В режиме ротации` -> `Профили...`.

### Как использовать

1. Выбрать web-кнопку.
2. Включить ротацию.
3. Нажать `Профили...`.
4. Отметить нужные профили или оставить все.
5. Сохранить кнопку.

### Входные данные

Список путей профилей.

### Результат

При каждом запуске кнопки сохраняется и используется следующий профиль.

### Ограничения

Кнопка `Профили...` активна только при включенной ротации. Сохранение выбора недоступно, если профили есть, но не выбран ни один.

### Связанные функции

Выбор браузера, выбор профиля, запуск web-ссылки.

### Подтверждение в коде

`AiteBar/SettingsWindow.xaml.cs`, `AiteBar/RotationProfileSelectionWindow.xaml.cs`, `AiteBar/ProfileRotationHelper.cs`, `AiteBar/ActionService.cs`.

## Поиск в Google по буферу обмена

### Назначение

Открывает Google-поиск по тексту из буфера обмена.

### Где находится

Встроенная кнопка `Поиск` на основной панели.

### Как использовать

1. Скопировать текст.
2. Открыть панель.
3. Нажать кнопку поиска.

### Входные данные

Текст из clipboard.

### Результат

Открывается Chrome с URL `https://www.google.com/search?q=...`.

### Ограничения

Если в clipboard нет текста или он пустой, действие ничего не делает. Поиск всегда использует Chrome.

### Связанные функции

Включение/отключение быстрых инструментов, открепление инструмента.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/ActionService.cs`.

## Скриншот

### Назначение

Запускает Windows screen clipping.

### Где находится

Встроенная кнопка `Скриншот`.

### Как использовать

1. Открыть панель.
2. Нажать кнопку скриншота.

### Входные данные

Нет.

### Результат

Открывается системный screen clipping через `ms-screenclip:`.

### Ограничения

Зависит от доступности системного URI handler Windows.

### Связанные функции

Запись видео.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/MainWindow.xaml`.

## Запись видео

### Назначение

Запускает системную запись экрана через Windows screen clipping recording.

### Где находится

Встроенная кнопка `Видео`.

### Как использовать

1. Открыть панель.
2. Нажать кнопку записи.

### Входные данные

Нет.

### Результат

Открывается `ms-screenclip:?type=recording`.

### Ограничения

Зависит от поддержки системного URI handler.

### Связанные функции

Скриншот.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/MainWindow.xaml`.

## Открытие калькулятора

### Назначение

Запускает Windows Calculator.

### Где находится

Встроенная кнопка `Калькулятор`.

### Как использовать

Нажать кнопку калькулятора на панели.

### Входные данные

Нет.

### Результат

Запускается `calc.exe`.

### Ограничения

Зависит от наличия системного калькулятора.

### Связанные функции

Быстрые инструменты.

### Подтверждение в коде

`AiteBar/ActionService.cs`.

## Открытие проводника и загрузок

### Назначение

Открывает Windows Explorer или папку Downloads.

### Где находится

Встроенные кнопки `Проводник` и `Загрузки`.

### Как использовать

Нажать соответствующую кнопку на панели.

### Входные данные

Нет.

### Результат

`Проводник` запускает `explorer.exe`; `Загрузки` открывает `shell:Downloads`.

### Ограничения

Зависит от shell Windows.

### Связанные функции

Быстрые инструменты.

### Подтверждение в коде

`AiteBar/ActionService.cs`.

## Таймер и секундомер

### Назначение

Открывает встроенное окно таймера или секундомера для коротких рабочих интервалов.

### Где находится

Встроенная кнопка `Таймер и секундомер`.

### Как использовать

1. Нажать кнопку таймера на панели.
2. Выбрать режим `Таймер` или `Секундомер`.
3. Для таймера выбрать пресет или ввести своё время.
4. Нажать `Старт`.
5. Использовать `Пауза`, `Сброс` или компактный режим по необходимости.

### Входные данные

Режим, длительность таймера, настройка звука.

### Результат

Открывается локальное WPF-окно таймера/секундомера. Таймер отсчитывает время до нуля и может проиграть системный звук; секундомер считает прошедшее время.

### Ограничения

Lap/круги в секундомере не поддерживаются. Окно рассчитано на один активный экземпляр через `ActionService`.

### Связанные функции

Быстрые инструменты, настройки программы.

### Подтверждение в коде

`AiteBar/TimerStopwatchWindow.xaml`, `AiteBar/TimerStopwatchWindow.xaml.cs`, `AiteBar/TimerStopwatchFormatter.cs`, `AiteBar/TimerStopwatchLayoutHelper.cs`, `AiteBar/ActionService.cs`.

## Пипетка цвета

### Назначение

Позволяет выбрать пиксель на экране и скопировать его HEX-цвет.

### Где находится

Встроенная кнопка `Пипетка`.

### Как использовать

1. Нажать кнопку пипетки.
2. Навести курсор на нужную точку экрана.
3. Кликнуть левой кнопкой мыши.
4. Или нажать Esc для отмены.

### Входные данные

Координаты пикселя на виртуальном экране.

### Результат

HEX-цвет формата `#RRGGBB` копируется в clipboard.

### Ограничения

Окно пипетки делает снимок virtual screen при запуске; дальнейшие изменения экрана после запуска могут не попасть в выбор.

### Связанные функции

Быстрые инструменты, clipboard.

### Подтверждение в коде

`AiteBar/ScreenColorPickerWindow.cs`, `AiteBar/ActionService.cs`.

## Открепление встроенного инструмента

### Назначение

Отключает отображение конкретной встроенной кнопки на основной панели.

### Где находится

Контекстное меню встроенной кнопки -> `Открепить от панели`.

### Как использовать

1. Правый клик по встроенному инструменту.
2. Выбрать `Открепить от панели`.

### Входные данные

Выбранный быстрый инструмент.

### Результат

Соответствующий `ShowPreset...` флаг становится `false`, панель обновляется.

### Ограничения

Инструмент можно вернуть через настройки программы.

### Связанные функции

Включение/отключение быстрых инструментов.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/AppSettingsWindow.xaml.cs`.

## Показ рабочего стола

### Назначение

Минимизирует все открытые окна и показывает рабочий стол.

### Где находится

Встроенная кнопка `Показать рабочий стол` на панели.

### Как использовать

1. Включить "Показать рабочий стол" в настройках быстрых инструментов, если кнопка скрыта.
2. Нажать кнопку "Показать рабочий стол".

### Входные данные

Нет.

### Результат

Все открытые окна минимизируются, отображается рабочий стол.

### Ограничения

Работает только на Windows.

### Связанные функции

Папка приложений, Copilot.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/MainWindow.xaml.cs`.

## Папка приложений

### Назначение

Открывает системную папку Applications в Windows.

### Где находится

Встроенная кнопка `Папка приложений` на панели.

### Как использовать

1. Включить "Папка приложений" в настройках быстрых инструментов, если кнопка скрыта.
2. Нажать кнопку "Папка приложений".

### Входные данные

Нет.

### Результат

Открывается проводник с папкой Applications.

### Ограничения

Работает только на Windows.

### Связанные функции

Показ рабочего стола, Copilot.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/MainWindow.xaml.cs`.

## Copilot

### Назначение

Запускает Windows Copilot.

### Где находится

Встроенная кнопка `Copilot` на панели.

### Как использовать

1. Включить "Copilot" в настройках быстрых инструментов, если кнопка скрыта.
2. Нажать кнопку "Copilot".

### Входные данные

Нет.

### Результат

Запускается Windows Copilot.

### Ограничения

Работает только на Windows с поддерживаемой версией и включенным Copilot.

### Связанные функции

Показ рабочего стола, папка приложений.

### Подтверждение в коде

`AiteBar/ActionService.cs`, `AiteBar/MainWindow.xaml.cs`.

## Обработка текста

### Назначение

Выполняет AI-обработку текста в одном из пяти независимых режимов: проверка орфографии, грамматики и пунктуации; типографическое оформление; очистка артефактов копирования; литературная редакция; естественный стиль. Первые три режима не меняют формулировки. Редакторские режимы сохраняют язык, смысл, факты, имена и авторскую позицию; `Естественный стиль` дополнительно убирает шаблонность, чрезмерно ровную структуру и избыточную типографику.

### Где находится

Встроенная кнопка `Обработка текста` на панели. Видимость настраивается вместе с другими быстрыми инструментами.

### Как использовать

1. Настроить хотя бы одно включённое AI-подключение.
2. Ввести текст либо вставить содержимое буфера в позицию курсора; выделенный фрагмент при вставке заменяется.
3. Выбрать один из пяти режимов и автоматический выбор либо конкретную доступную бесплатную текстовую модель. Каждая модель показана один раз независимо от количества API-ключей провайдера. Платные модели, модели с неизвестной стоимостью и генераторы изображений/видео утилита не использует.
4. Запустить обработку кнопкой или `Shift+Enter` в редакторе. Обычный `Enter` вставляет перенос строки; `Ctrl+Enter` также поддерживается.
5. Наблюдать появление результата по мере генерации и время выполнения; при необходимости отменить запрос кнопкой `Отменить` или `Esc`.
6. После успеха переключаться между исходником, результатом и подсвеченным списком изменений. Удалённое показывается красным зачёркнутым, добавленное — зелёным подчёркнутым; открытая команда `Показать изменения` меняется на `Скрыть изменения`.
7. Использовать `Ctrl+Z` и `Ctrl+Y` для отмены и повтора редактирования и операций утилиты.
8. При необходимости повторить последнюю обработку. Явный выбор сохраняет точные провайдера и модель; API-ключи с этой моделью ротируются внутри шлюза без скрытой подмены модели.

### Ограничения и данные

Текст отправляется внешнему AI-сервису только по явной команде. Перед отправкой URL, e-mail, пути, код, теги, версии и идентификаторы временно заменяются служебными маркерами и восстанавливаются локально в ответе. Интерфейс сохраняет текст сверх лимита для копирования и редактирования, но блокирует отправку более 50 000 символов. Содержимое редактора, исходник и результат не сохраняются между запусками; API-ключи остаются в Windows Credential Manager.

### Подтверждение в коде

`AiteBar/TextProcessingUtility.cs`, `AiteBar/TextProcessingWindow.xaml`, `AiteBar/TextProcessingWindow.xaml.cs`, `AiteBar/TextProcessingService.cs`, `AiteBar/AiGateway.cs`.

## Конструктор промптов

### Назначение

Создаёт один профессиональный готовый промпт по краткому описанию задачи. Поддерживает семь независимых творческих рубрик: Изображения, Живопись, Анимация, Арт-ню, Графика, Видео, Музыка. Результат не содержит приветствия, объяснений или уточняющих вопросов.

### Где находится и как использовать

Включите `Конструктор промптов` среди быстрых инструментов, выберите рубрику, опишите задачу и нажмите `Создать промпт`. Утилита использует выбранную бесплатную текстовую модель, показывает потоковый результат и поддерживает повтор, исходную задачу, готовый промпт, сравнение и копирование. Одна команда всегда создаёт один итоговый промпт; обязательные неизвестные данные обозначаются заполнителями в квадратных скобках.

### Подтверждение в коде

`AiteBar/PromptBuilderUtility.cs`, `AiteBar/PromptBuilderWindow.xaml`, `AiteBar/PromptBuilderWindow.xaml.cs`, `AiteBar/PromptBuilderService.cs`, `AiteBar/AiGateway.cs`.

The Video tab provides a persisted directing selector for advertising, cinematic scenes, product, fashion, documentary, vertical social, music video, interview, explainer, architecture, travel, action, time-lapse, macro, stop motion, 3D product animation, and loop animation.

The Music tab produces a ready-to-paste Suno Styles field description from a short vibe or scene brief. The output is a single plain English paragraph (no lyrics, no song titles, no artist names, no markdown formatting) under 1000 characters, covering genre, mood, tempo, instrumentation, production, and arrangement.

Prompt Builder keeps one draft per tab in memory: the original brief, the latest generated prompt, the selected options, and the original/result view state. Switching tabs does not clear work; Clear affects only the active tab. Drafts are not persisted between application launches unless `SavePromptBuilderDrafts` is explicitly enabled in settings.

## Дзен-редактор

### Назначение

Открывает минималистичный полноэкранный редактор обычного текста. Документы
хранятся локально, автоматически сохраняются и восстанавливаются при следующем
запуске. Текст не отправляется в AI, телеметрию или сетевые сервисы.

### Где находится

Встроенная кнопка `Дзен-редактор` с глифом U+E367 на основной панели. Видимость
настраивается в разделе быстрых инструментов.

### Как использовать

1. Нажать `Дзен-редактор` и сразу начать ввод.
2. Нажать правую кнопку или `Shift+F10`, чтобы создать документ, открыть внутренний список, восстановить недавно удалённый документ, найти текст, экспортировать TXT или выбрать одну из пяти фиксированных тем.
3. Использовать `Ctrl+N`, `Ctrl+O`, `Ctrl+S` и `Ctrl+Shift+S` для операций с документами.
4. Использовать `Ctrl+B`, `Ctrl+I` и `Ctrl+U` для жирности, курсива и подчёркивания.
5. Нажать `Ctrl+F` для временного поиска; `Enter`/`F3` находят следующее совпадение, `Shift+Enter`/`Shift+F3` — предыдущее.
6. Использовать `Ctrl+Alt+↑`/`Ctrl+Alt+↓` для циклической смены тем; стандартные `Shift+↑`/`Shift+↓` остаются выделением текста.
7. Нажать `Esc` или `Alt+F4`, чтобы закрыть редактор: актуальный текст, форматирование, курсор, выделение, прокрутка, тема и монитор сохраняются автоматически. Если открыт поиск, первое нажатие `Esc` закрывает его.

Каждый жёсткий перенос отображается как новый абзац с межстрочным интервалом
`1,5em` и дополнительным интервалом `0,75em`. Это только визуальная
типографика: внутренний текст не получает автоматических пробелов или пустых
строк. При экспорте TXT форматирование удаляется, а между соседними абзацами
добавляется ровно одна пустая строка без удвоения уже существующего промежутка.

### Хранение и восстановление

Внутренние документы находятся в `%APPDATA%\Codebdbd\Aite Bar\ZenEditor`.
Запись выполняется атомарно, документы защищены SHA-256 checksum и резервными
снимками. Жирность, курсив и подчёркивание хранятся как диапазоны поверх
plain-text содержимого. Экспорт создаёт независимый UTF-8 TXT с переносами CRLF,
не включает форматирование и не привязывает внутренний документ к внешнему
файлу. Удаление остаётся мягким: команда `Недавно удалённые…` позволяет
восстановить документ вместе с текстом и форматированием.

### Подтверждение в коде

`AiteBar/ZenEditorUtility.cs`, `AiteBar/ZenEditorWindow.xaml`,
`AiteBar/ZenEditorWindow.xaml.cs`, `AiteBar/ZenParagraphEditor.cs`,
`AiteBar/ZenEditorStore.cs`,
`AiteBar/ZenEditorThemeCatalog.cs`.

## Aite Profiles

### Назначение

Встроенная утилита для локальных профилей Google Chrome. Она сканирует профили, показывает их в таблице, позволяет искать, сортировать, выбирать один или несколько профилей, открывать профиль, incognito, Gmail, Drive, Gemini, настройки аккаунта, Gmail compose, папку профиля и Chrome profile picker.

### Как использовать

1. Включить `Aite Profiles` в быстрых инструментах, если кнопка скрыта.
2. Открыть утилиту с панели AiteBar.
3. Нажать `Scan`, если нужен свежий список профилей.
4. Использовать поиск, вкладки `All`, `Favorites`, `Farm`, выделение строк и контекстное меню.
5. Ввести или выбрать quick-link, включить lock/rotation при необходимости и нажать `Launch`.

### Данные и ограничения

Утилита читает локальные Chrome metadata-файлы профилей, bookmarks и timestamps. Она не читает Chrome `Login Data`, не считает пароли, не запускает API-сервер, не создаёт tray-иконку и не регистрирует собственные глобальные hotkey. Собственные данные AiteBar сохраняются локально в подпапке `AiteProfiles`: cache, favorites, farm, tags, snippets и rotation.

### Подтверждение в коде

`AiteBar/AiteProfilesUtility/*`, `AiteBar/UtilityButtonCatalog.cs`, `AiteBar/MainWindow.xaml.cs`.

## Quick Note

Локальная single-note утилита. Открывается кнопкой панели или настроенной горячей клавишей. Автосохранение хранит текст, форматирование, задачи и встроенные изображения в `%AppData%\Codebdbd\Aite Bar\QuickNote.aite-note`. Старый RTF загружается при отсутствии основного файла.

Окно самостоятельное, отображается на панели задач и не принудительно поверх других окон. Закрепление сохраняет окно открытым при потере фокуса. Нативный Windows Snap поддерживает совместное изменение ширины соседних окон.

Боковая зона захвата `WindowChrome` расширена внутрь окна (`12,8,12,8`), чтобы край самой заметки был доступен рядом с невидимой рамкой соседнего окна без предварительного клика в текст. Верхняя зона и заголовок сохраняют прежнюю геометрию. Toolbar и scrollbar помечены `IsHitTestVisibleInChrome`, поэтому нажатия на них остаются действиями элементов управления. Системное превью соседнего окна при операции из другого приложения не подменяется.

Локальные шаблоны `QuickNoteScrollViewerStyle` и `QuickNoteScrollBarStyle` резервируют под прокрутку 6 DIP вместо системной широкой колонки. Видимая часть ползунка — 2 DIP на расстоянии 2 DIP от края, с расширением до 4 DIP при наведении/перетаскивании без изменения ширины колонки. Общие стили scrollbar других утилит не меняются. Сохранены стандартные именованные части WPF, команды прокрутки, колёсико и перетаскивание; при отсутствии переполнения колонка исчезает.

`QuickNoteWindowInteraction` отличает нативное перемещение/изменение размера и переход к системному Snap Assist от обычного ухода в другое приложение. Автозакрытие не прерывает прилепление незакреплённой заметки; настройка закрепления не меняется. Наблюдатель сообщений подключён только к окну заметки и удаляется при освобождении окна.

Снимок документа создаётся на его WPF-потоке, а чтение/запись файла и SHA-256 выполняются вне потока интерфейса при асинхронном вызове сервиса. Первичная синхронная загрузка окна остаётся совместимой с существующим сценарием открытия. Запись идёт через временный файл с flush и заменой; внешнее изменение проверяется по содержимому даже при неизменных размере и дате. Новые правки во время сохранения не помечаются сохранёнными до записи следующего снимка.

Ошибки чтения сохраняют исходный файл. Правки после такой ошибки и при конфликте записываются в отдельную конфликтную копию; сохраняются последние пять. Кнопка папки в статусе показывает последнюю копию. Ошибка записи оставляет окно открытым; `Ctrl+S` повторяет сохранение.

Реализация: `AiteBar/QuickNoteUtility.cs`, `QuickNoteWindow.xaml.cs`, `QuickNoteSaveController.cs`, `QuickNoteService.cs`, `QuickNoteDocumentCodec.cs`, `QuickNoteFileStore.cs`.

## Форматирование Quick Note

Нижняя панель содержит размер текста, маркированный и нумерованный списки, чеклист, жирный, курсив, зачёркивание, ссылку, изображение, подчёркивание, кодовый блок, цитату, разделитель и очистку форматирования. Формат применяется к выделению или текущему вводу. Списки и абзацы представлены нативными WPF-элементами. Чеклисты доступны в панели форматирования, но не в контекстном меню.

Основной формат сохраняет нативную структуру документа и положение изображений внутри абзацев. Runtime-контролы задач преобразуются в маркеры и восстанавливаются после загрузки, в том числе во вложенных списках. Операции Undo/Redo доступны кнопками заголовка, через контекстное меню и `Ctrl+Z`/`Ctrl+Y`.

Новые изображения из буфера, файла или drag-and-drop вставляются в отдельный абзац без текста сбоку; курсор переносится под изображение. Вставка отменяется и повторяется одной операцией Undo/Redo. Существующие изображения внутри текста автоматически не перемещаются.

Реализация: `AiteBar/QuickNoteWindow.xaml`, `QuickNoteWindow.Editor.cs`, `QuickNoteDocumentFormatting.cs`, `QuickNoteDocumentContract.cs`, `QuickNoteRtfAdapter.cs`.

## Меню Quick Note

Правый клик в редакторе открывает стандартные команды текста, выбор цвета и очистку заметки с подтверждением. В заголовке также есть выбор цвета и закрепление. Пункта чеклистов, меню `...` и команд импорта/экспорта Markdown/TXT в текущем окне нет. Поддержка RTF в сервисе используется для совместимости; она не означает наличие команды экспорта в интерфейсе.

Реализация: `AiteBar/QuickNoteWindow.xaml`, `QuickNoteWindow.xaml.cs`, `QuickNoteWindow.Presentation.cs`.
## Работа со ссылками в Quick Note

### Назначение

Открывает распознанный URL, e-mail или номер телефона по Ctrl+клику; ссылка валидируется перед запуском. Обычный клик остаётся редактированием и ставит каретку.

### Где находится

Редактор Quick Note.

### Как использовать

1. Ввести или вставить URL, e-mail либо номер телефона.
2. Удерживая Ctrl, кликнуть по ссылке.

### Входные данные

URL в тексте заметки.

### Результат

Ссылка открывается через системный shell.

### Ограничения

Автоматический поиск ссылок ограничен абзацами до 10000 символов; при превышении показывается статус. Явные гиперссылки продолжают обрабатываться.

### Связанные функции

Quick Note, автосохранение.

### Подтверждение в коде

`AiteBar/QuickNoteWindow.xaml.cs`, `AiteBar/QuickNoteDocumentFormatting.cs`.

## Выбор иконки из библиотеки

### Назначение

Позволяет назначить кнопке шрифтовую иконку из встроенных библиотек.

### Где находится

Окно настройки кнопки -> `Выбрать из библиотеки`; окно `IconPickerWindow`.

### Как использовать

1. Открыть настройку кнопки.
2. Нажать `Выбрать из библиотеки` или кликнуть preview.
3. Выбрать вкладку Material Icons, Fluent System или Brands.
4. Найти и нажать иконку.

### Входные данные

Выбранный glyph и font key.

### Результат

Иконка назначается кнопке.

### Ограничения

Иконки загружаются пачками. Поиск фильтрует только загруженный список текущей вкладки.

### Связанные функции

Пользовательская иконка, цвет иконки.

### Подтверждение в коде

`AiteBar/IconPickerWindow.xaml`, `AiteBar/IconPickerWindow.xaml.cs`, `AiteBar/FontHelper.cs`.

## Выбор пользовательской иконки

### Назначение

Позволяет использовать собственное изображение как иконку кнопки.

### Где находится

- Окно настройки кнопки -> `Своя иконка`.
- Окно IconPicker -> вкладка custom icon.

### Как использовать

1. Нажать `Своя иконка`.
2. Выбрать файл изображения.
3. Подтвердить.

### Входные данные

Файл изображения.

### Результат

Файл копируется в локальную папку `Icons`, путь сохраняется в кнопке.

### Ограничения

При ошибке копирования показывается dialog.

### Связанные функции

Импорт/экспорт панелей, отображение иконки кнопки.

### Подтверждение в коде

`AiteBar/SettingsWindow.xaml.cs`, `AiteBar/IconPickerWindow.xaml.cs`, `AiteBar/IconHelper.cs`, `AiteBar/PathHelper.cs`.

## Выбор цвета иконки

### Назначение

Позволяет задать цвет шрифтовой иконки кнопки.

### Где находится

Окно настройки кнопки -> палитра цветов и HEX-поле.

### Как использовать

1. Выбрать цвет из палитры.
2. Или ввести HEX в поле.
3. Сохранить кнопку.

### Входные данные

HEX-цвет `#RRGGBB` или `#AARRGGBB`.

### Результат

Цвет сохраняется и применяется к glyph-иконке кнопки.

### Ограничения

Для пользовательской image-иконки цвет не меняет изображение.

### Связанные функции

Выбор иконки, настройка кнопки.

### Подтверждение в коде

`AiteBar/SettingsWindow.xaml.cs`, `AiteBar/Models.cs`.

## Настройки программы

### Назначение

Позволяет изменить общие параметры поведения AiteBar.

### Где находится

- Tray menu -> `Настройки программы`.
- Окно настройки кнопки -> `Настройки программы`.

### Как использовать

1. Открыть настройки программы.
2. Изменить параметры на вкладках.
3. Нажать `Сохранить` или `Отмена`.

### Входные данные

Язык, сторона, монитор, размеры, hotkeys, имена панелей, quick tools.

### Результат

Настройки сохраняются в локальный `settings.json`, панель обновляется.

### Ограничения

Дубликаты hotkeys внутри настроек не сохраняются. Неудачно зарегистрированные hotkeys показываются предупреждением.

### Связанные функции

Все настройки в разделе "Настройки".

### Подтверждение в коде

`AiteBar/AppSettingsWindow.xaml`, `AiteBar/AppSettingsWindow.xaml.cs`, `AiteBar/AppSettingsService.cs`.

## Импорт панели

### Назначение

Добавляет кнопки из `.aitebarpanel` в текущую активную панель.

### Где находится

- Контекстное меню панели -> `Импорт в текущую панель...`
- Tray menu -> `Импорт панели...`

### Как использовать

1. Выбрать импорт.
2. Выбрать `.aitebarpanel`.
3. Посмотреть количество импортируемых кнопок.
4. Подтвердить.

### Входные данные

Файл `.aitebarpanel`.

### Результат

Кнопки добавляются в конец активной панели; packaged images копируются в локальную папку иконок.

### Ограничения

Поддерживается только текущая версия формата manifest. Импорт не меняет имя активной панели. Отмена уже выполненного импорта не поддерживается.

### Связанные функции

Экспорт панели, пользовательские иконки.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/PanelPackageService.cs`, `AiteBar/PanelPackageMapper.cs`, `AiteBar/PanelPackageManifest.cs`, `docs/user-manual.md`.

## Экспорт текущей панели

### Назначение

Сохраняет активную панель в файл `.aitebarpanel`.

### Где находится

- Контекстное меню панели -> `Экспорт текущей панели...`
- Tray menu -> `Экспорт текущей панели...`

### Как использовать

1. Активировать нужную панель.
2. Выбрать экспорт.
3. Указать имя и место файла.
4. Подтвердить сохранение.

### Входные данные

Путь для сохранения.

### Результат

Создается `.aitebarpanel` с manifest и иконками.

### Ограничения

Экспортируется только текущая активная панель.

### Связанные функции

Импорт панели, перенос панелей между компьютерами.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`, `AiteBar/PanelPackageService.cs`, `AiteBar/PanelPackageManifest.cs`.

## Экспорт резервной копии настроек

### Назначение

Создаёт полный или частичный архив `.aitebarbackup` со всеми панелями, настройками окна утилит, пользовательскими иконками Quick Note, документами Дзен-редактора и (опционально) API-ключами и историей буфера обмена. В отличие от экспорта одной панели, бэкап сохраняет **всё** состояние приложения целиком.

### Где находится

- `Настройки программы` → вкладка `О программе` → раздел `Backups` → `Create backup...`.

### Как использовать

1. Открыть `Настройки программы` → вкладку `О программе`.
2. Нажать `Create backup...`.
3. В диалоге параметров выбрать:
   - Стандартный бэкап без пароля;
   - или полный бэкап с опцией `Include encrypted API keys and clipboard` и придумать пароль.
4. Указать место сохранения `.aitebarbackup`.

### Входные данные

- Опции: `IncludeSecrets` (boolean), `IncludeClipboard` (boolean), `Password` (строка, только при IncludeSecrets=true).
- Путь сохранения.
- Текущее состояние: `AppSettings`, локальная папка `icons/`, API-ключи из `Credential Manager`, история клипов.

### Результат

Создаётся ZIP-архив `.aitebarbackup`:
- `settings.json` — сериализованные настройки и все 10 панелей;
- `icons/*` — все пользовательские иконки;
- `private.bin` (только при IncludeSecrets=true) — зашифрованный AES-GCM-256 контейнер с API-ключами и историей буфера обмена.

### Ограничения

- Максимальный размер архива — 100 МБ (защита от переполнения RAM при восстановлении).
- Пароль от зашифрованного `private.bin` не восстанавливается.
- Секреты сохраняются только при явном включении опции `Include encrypted API keys and clipboard`.

### Связанные функции

Восстановление из резервной копии, Импорт/Экспорт панели, Credential Manager (секреты AI-подключений).

### Подтверждение в коде

`AiteBar/BackupService.cs` → `CreateAsync()`, `AiteBar/BackupModels.cs`, `AiteBar/BackupPasswordDialog.xaml(.cs)`, `AiteBar/AppSettingsWindow.xaml.cs` → `BtnCreateBackup_Click()`.

## Восстановление из резервной копии

### Назначение

Восстанавливает настройки, пользовательские иконки и (при наличии пароля) секреты из `.aitebarbackup`, полностью заменяя текущее состояние. Перед заменой автоматически создаётся safety backup текущего состояния.

### Где находится

- `Настройки программы` → вкладка `О программе` → раздел `Backups` → `Restore backup...`.

### Как использовать

1. Открыть `Настройки программы` → вкладку `О программе`.
2. Нажать `Restore backup...`.
3. Выбрать файл `.aitebarbackup`.
4. Подтвердить замену (safety backup будет создан автоматически).
5. Если архив содержит зашифрованные секреты — ввести пароль в диалоге.

### Входные данные

- Файл `.aitebarbackup`.
- Пароль (если бэкап был создан с IncludeSecrets=true).

### Результат

- Текущее состояние заменяется на содержимое бэкапа.
- Иконки записываются в `%AppData%\Codebdbd\Aite Bar\icons\`.
- API-ключи записываются в `Credential Manager` под теми же `CredentialTarget`.
- История буфера обмена восстанавливается (если была сохранена).
- Выводится сообщение `Backup restored.`

### Ограничения

- Ошибка неверного пароля или повреждённого `private.bin` — отмена восстановления без побочных эффектов (исключение CryptographicException).
- Safety backup создаётся автоматически перед записью, но удаление/очистка safety backup не реализовано в UI.
- Секреты из старого состояния перезаписываются секретами из бэкапа при совпадении `CredentialTarget`.

### Связанные функции

Экспорт резервной копии, Импорт панели, Менеджер буфера обмена, Credential Manager.

### Подтверждение в коде

`AiteBar/BackupService.cs` → `ReadAsync()` и `RestoreAsync()`, `AiteBar/BackupPasswordDialog.xaml(.cs)` (`isRestore=true`), `AiteBar/AppSettingsWindow.xaml.cs` → `BtnRestoreBackup_Click()`.

## Tray-меню

### Назначение

Дает доступ к основным системным действиям AiteBar из tray.

### Где находится

Правый клик по tray icon.

### Как использовать

1. Правый клик по иконке AiteBar.
2. Выбрать нужный пункт.

### Входные данные

Пункт меню.

### Результат

Можно открыть панель, настройки, импорт/экспорт, About, справку, донат-страницу или закрыть приложение.

### Ограничения

Справка и поддержка автора открывают внешние URL.

### Связанные функции

Показ панели, настройки, импорт/экспорт, About.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`.

## О программе

### Назначение

Показывает сведения о приложении и ссылки на дополнительные ресурсы.

### Где находится

Последний пункт левого меню настроек; tray menu -> `О программе` открывает сразу этот раздел.

### Как использовать

1. Открыть tray menu.
2. Выбрать `О программе`.
3. В открывшемся окне настроек нажать нужную кнопку раздела.

### Входные данные

Кнопки раздела «О программе» в `AppSettingsWindow`.

### Результат

Пользователь может открыть сайт продукта, GitHub-репозиторий, third-party notices, папку данных или папку программы.

### Ограничения

Если notices или папка программы не найдены, показывается dialog.

### Связанные функции

Справка, поддержка автора, локальная папка данных.

### Подтверждение в коде

`AiteBar/AppSettingsWindow.xaml`, `AiteBar/AppSettingsWindow.xaml.cs`, `AiteBar/MainWindow.TrayMenuHandler.cs`.

## Закрытие приложения

### Назначение

Полностью завершает AiteBar.

### Где находится

Tray menu -> `Закрыть и выйти`.

### Как использовать

1. Правый клик по tray icon.
2. Выбрать `Закрыть и выйти`.

### Входные данные

Пункт tray menu.

### Результат

NotifyIcon освобождается, приложение завершает работу.

### Ограничения

Нет отдельного подтверждения выхода.

### Связанные функции

Tray-меню.

### Подтверждение в коде

`AiteBar/MainWindow.xaml.cs`.

---

# User Flows

## Сценарий 1. Первый запуск и открытие панели

Цель пользователя: убедиться, что AiteBar работает.

1. Установить и запустить AiteBar.
2. Найти иконку в tray.
3. Левым кликом открыть панель.
4. Навести курсор на край экрана, чтобы проверить автоматический показ.

Результат: пользователь видит скрываемую панель быстрого доступа.

## Сценарий 2. Создать web-кнопку для AI-сервиса

Цель пользователя: запускать сервис в нужном браузере и профиле.

1. Нажать `+`.
2. Ввести имя, например `ChatGPT`.
3. Выбрать тип `Ссылка`.
4. Ввести URL.
5. Выбрать браузер и профиль.
6. При необходимости включить app mode или incognito.
7. Выбрать иконку и цвет.
8. Сохранить.

Результат: на панели появляется web-кнопка.

## Сценарий 3. Создать кнопку для локального скрипта

Цель пользователя: запускать автоматизацию в один клик.

1. Нажать `+`.
2. Выбрать тип `Скрипт`.
3. Нажать `Обзор`.
4. Выбрать `.bat`, `.cmd`, `.ps1` или `.py`.
5. Сохранить.
6. Запустить кнопку с панели.

Результат: скрипт запускается через подходящий shell/interpreter.

## Сценарий 4. Добавить объект перетаскиванием

Цель пользователя: быстро добавить файл, папку или ссылку.

1. Открыть панель.
2. Перетащить один файл, папку, `.url` или web-ссылку на панель.
3. Дождаться появления кнопки.

Результат: AiteBar создает кнопку в активной панели.

## Сценарий 5. Организовать кнопки по панелям

Цель пользователя: разделить действия по контекстам.

1. Открыть настройки программы.
2. Переименовать панели.
3. Включить нужные панели.
4. Через контекстное меню кнопок перенести элементы в нужные панели.
5. Переключаться между панелями колесом, hotkey или меню панели.

Результат: пользователь получает отдельные наборы действий для разных задач.

## Сценарий 6. Экспортировать и импортировать панель

Цель пользователя: перенести набор кнопок.

1. Выбрать нужную активную панель.
2. Открыть контекстное меню панели или tray.
3. Выбрать экспорт.
4. Сохранить `.aitebarpanel`.
5. На целевой панели выбрать импорт.
6. Выбрать файл и подтвердить.

Результат: кнопки из пакета добавлены в текущую панель.

## Сценарий 7. Использовать Quick Note

Цель пользователя: быстро сохранить текст, ссылку или команду.

1. Включить Quick Note в быстрых инструментах, если он скрыт.
2. Нажать кнопку Quick Note на панели.
3. Ввести текст.
4. Применить форматирование при необходимости.
5. Закрыть окно или открыть файл заметки во внешнем редакторе.

Результат: заметка сохранена в `QuickNote.md`.

## Сценарий 8. Настроить поведение панели

Цель пользователя: адаптировать панель к своему экрану.

1. Открыть настройки программы.
2. Выбрать сторону панели и монитор.
3. Настроить размер панели, зону активации и задержку.
4. Сохранить.
5. При необходимости перетащить panel handle на другой край.

Результат: панель появляется в удобном месте и с нужной чувствительностью.

## Сценарий 9. Запустить команду с подтверждением

Цель пользователя: выполнить служебную команду из панели.

1. Создать кнопку типа `Команда`.
2. Ввести команду.
3. Сохранить.
4. Нажать кнопку.
5. Подтвердить запуск.

Результат: команда выполняется через `cmd.exe /c`.

## Сценарий 10. Взять цвет с экрана

Цель пользователя: скопировать HEX-цвет пикселя.

1. Нажать кнопку пипетки.
2. Навести курсор на цвет.
3. Кликнуть.

Результат: HEX-цвет скопирован в буфер обмена.

---

# Горячие клавиши

| Комбинация | Действие |
| ---------- | -------- |
| Настраиваемая: `Показать панель` | Показать или скрыть панель |
| Настраиваемая: `Следующая панель` | Переключить активную панель вперед |
| Настраиваемая: `Предыдущая панель` | Переключить активную панель назад |
| Настраиваемая: `Добавить кнопку` | Открыть окно создания кнопки |
| Настраиваемая для пользовательской кнопки | Выполнить действие этой кнопки |
| Hotkey-кнопка: Ctrl/Shift/Alt/Win + A-Z/0-9/F1-F12/PrintScreen | Отправить пользовательское сочетание клавиш |
| Quick Note: Esc | Закрыть Quick Note со slide-анимацией и сохранением |
| Quick Note: Ctrl+Shift+C | Скопировать весь текст заметки |
| Quick Note: Ctrl+клик по URL | Открыть ссылку из заметки |
| Quick Note editor: Ctrl+X | Вырезать |
| Quick Note editor: Ctrl+C | Копировать |
| Quick Note editor: Ctrl+V | Вставить |
| Quick Note editor: Ctrl+A | Выделить все |
| Color Picker: Esc | Отменить выбор цвета |

Примечание: доступные модификаторы для hotkeys настроек программы: не назначено, Ctrl, Alt, Shift, Win, Ctrl+Alt, Ctrl+Shift, Alt+Shift, Ctrl+Win, Alt+Win, Ctrl+Alt+Shift. Доступные клавиши: Space, `[`, `]`, A-Z, 0-9, F1-F12.

---

# Настройки

| Параметр | Назначение | Допустимые значения | Значение по умолчанию |
|---|---|---|---|
| `UiCulture` | Язык интерфейса | `auto`, `en`, `de`, `uk`, `ru` | `auto` |
| `Edge` | Сторона экрана для панели | `Top`, `Bottom`, `Left`, `Right` | `Top` |
| `MonitorIndex` | Монитор панели | Индекс экрана, 0 = primary/fallback | `0` |
| `ActivationZoneSizePercent` | Размер зоны активации | Slider UI; layout helper нормализует связанные проценты | `30` |
| `PanelSizePercent` | Размер панели вдоль активной оси | Slider UI; расчет layout ограничивает 20-100% | `80` |
| `ActivationDelayMs` | Задержка появления панели | Slider UI в миллисекундах | `150` |
| `ShowPanelOnMouseHover` | Показывать панель при задержке указателя в зоне активации | true/false | `true` |
| `GlobalHotkeyCtrl` | Ctrl для hotkey показа панели | true/false | `false` |
| `GlobalHotkeyAlt` | Alt для hotkey показа панели | true/false | `true` |
| `GlobalHotkeyShift` | Shift для hotkey показа панели | true/false | `false` |
| `GlobalHotkeyWin` | Win для hotkey показа панели | true/false | `false` |
| `GlobalHotkeyKey` | Клавиша показа панели | Space, Oem4, Oem6, A-Z, D0-D9, F1-F12, None | `D4` |
| `NextContextHotkey` | Hotkey следующей панели | HotkeyBinding | пустой binding |
| `PreviousContextHotkey` | Hotkey предыдущей панели | HotkeyBinding | пустой binding |
| `AddButtonHotkey` | Hotkey добавления кнопки | HotkeyBinding | пустой binding |
| `FileSorterHotkey` | Hotkey File Sorter | HotkeyBinding | пустой binding |
| `IconConverterHotkey` | Hotkey Icon Converter | HotkeyBinding | пустой binding |
| `QuickNoteHotkey` | Hotkey Quick Note | HotkeyBinding | пустой binding |
| `ColorPickerHotkey` | Hotkey Color Picker | HotkeyBinding | пустой binding |
| `TimerStopwatchHotkey` | Hotkey Timer/Stopwatch | HotkeyBinding | пустой binding |
| `QRCodeGeneratorHotkey` | Hotkey QR Code Generator | HotkeyBinding | пустой binding |
| `ClipboardManagerHotkey` | Hotkey Clipboard Manager | HotkeyBinding | пустой binding |
| `TextProcessingHotkey` | Hotkey Обработки текста | HotkeyBinding | пустой binding |
| `PromptBuilderHotkey` | Hotkey Конструктора промптов | HotkeyBinding | пустой binding |
| `ZenEditorHotkey` | Hotkey Дзен-редактора | HotkeyBinding | пустой binding |
| `ShowPresetSearch` | Показывать поиск | true/false | `true` |
| `ShowPresetScreenshot` | Показывать скриншот | true/false | `true` |
| `ShowPresetVideo` | Показывать запись видео | true/false | `true` |
| `ShowPresetCalc` | Показывать калькулятор | true/false | `true` |
| `ShowPresetExplorer` | Показывать проводник | true/false | `true` |
| `ShowPresetDownloads` | Показывать загрузки | true/false | `true` |
| `ShowPresetTimerStopwatch` | Показывать таймер и секундомер | true/false | `true` |
| `ShowPresetColorPicker` | Показывать пипетку | true/false | `false` |
| `ShowPresetQuickNote` | Показывать Quick Note | true/false | `false` |
| `ShowPresetZenEditor` | Показывать Дзен-редактор | true/false | `true` |
| `ShowPresetPromptBuilder` | Показывать Конструктор промптов | true/false | `false` |
| `ShowPresetQRCodeGenerator` | Показывать QR Code Generator | true/false | `false` |
| `ShowPresetClipboardManager` | Показывать Clipboard Manager | true/false | `false` |
| `ClipboardManagerPersistHistory` | Сохранять историю Clipboard Manager между сессиями | true/false | `true` |
| `TimerSoundEnabled` | Звук окончания таймера | true/false | `true` |
| `TimerIsStopwatchMode` | Последний выбранный режим таймера/секундомера | true/false | `false` |
| `TimerDuration` | Последняя длительность таймера | TimeSpan | `00:05:00` |
| `QuickNoteThemeId` | Тема Quick Note | `dark`, `graphite`, `rose`, `clay`, `sand`, `lemon`, `sage`, `mist`, `sky`, `lavender`, `mauve`, `stone` | `dark` |
| `Contexts` | Панели-контексты | 10 нормализованных панелей `0`…`9` | Панель 0 включена |
| `ActiveContextId` | Текущая панель | ID включенной панели | `context-0` |
| `Elements` | Пользовательские кнопки | Список `CustomElement` | пустой список |

## Настройки кнопки

| Параметр | Назначение | Допустимые значения | Значение по умолчанию |
|---|---|---|---|
| `Name` | Название кнопки | Непустая строка | пусто |
| `ActionType` | Тип действия | `Web`, `Hotkey`, `Program`, `File`, `Folder`, `ScriptFile`, `Command` | `Web` |
| `ActionValue` | URL, путь или команда | Зависит от типа | пусто |
| `Browser` | Браузер web-действия | Chrome, Edge, Brave, Yandex, Opera, OperaGX, Vivaldi, Firefox | Chrome или системный браузер при создании |
| `ChromeProfile` | Профиль браузера | Путь профиля или пусто | пусто |
| `RotationProfilePaths` | Профили для ротации | Список путей; пусто = все | пустой список |
| `IsAppMode` | App mode | true/false | false |
| `IsIncognito` | Incognito/private | true/false | false |
| `UseRotation` | Ротация профилей | true/false | false |
| `OpenFullscreen` | Fullscreen после запуска | true/false | false |
| `Icon` | Glyph иконки | Unicode glyph | Fluent default |
| `IconFont` | Font key | Fluent, Material, Brands или другое | Fluent |
| `Color` | Цвет glyph | HEX | `#E3E3E3` |
| `ImagePath` | Пользовательская image-иконка | Локальный путь | пусто |
| `Ctrl`, `Shift`, `Alt`, `Win`, `Key` | Hotkey-действие | Флаги + key | false / `None` |
| `ActivationHotkey` | Глобальная горячая клавиша запуска кнопки (существует в модели и импорте/экспорте, но не зарегистрирована через `RegisterHotKey`) | `HotkeyBinding` | пустой binding |
| `ContextId` | Панель кнопки | ID панели | `context-0` |

---

# Роли и права доступа

В проекте не обнаружены роли пользователей, аккаунты, авторизация, модераторы, администраторы или владельцы. Все функции выполняются локальным пользователем Windows в рамках его прав.

| Роль | Возможности |
|---|---|
| Локальный пользователь Windows | Все функции AiteBar, доступные через UI, tray, hotkeys и локальную файловую систему |

---

# Интеграции

| Сервис/система | Назначение | Доступные действия пользователя |
|---|---|---|
| Windows Shell | Запуск файлов, папок, программ, URL | Открыть файл, папку, программу, сайт, папку данных, папку программы |
| Windows tray / NotifyIcon | Работа в фоне | Открыть меню, открыть панель, выйти |
| Win32 Hotkeys | Глобальные hotkeys | Показать панель, переключить панели, добавить кнопку |
| Win32 SendInput | Отправка клавиш | Выполнить hotkey-кнопку, fullscreen через F11 |
| Win32 low-level mouse hook | Автоскрытие панели/Quick Note | Скрыть панель или заметку при клике вне окна |
| Chrome | Web-запуск и профили | Открыть URL, выбрать профиль, app mode, incognito |
| Microsoft Edge | Web-запуск и профили | Открыть URL, выбрать профиль, app mode, InPrivate |
| Brave | Web-запуск и профили | Открыть URL, выбрать профиль, app mode, incognito |
| Yandex Browser | Web-запуск и профили | Открыть URL, выбрать профиль, app mode, incognito |
| Opera / Opera GX | Web-запуск и профили | Открыть URL, выбрать профиль, private mode |
| Vivaldi | Web-запуск и профили | Открыть URL, выбрать профиль |
| Firefox | Web-запуск и профили | Открыть URL, выбрать профиль через `-P`, private window |
| Windows screen clipping | Скриншот и запись | Сделать скриншот, начать запись экрана |
| Windows Calculator | Калькулятор | Открыть `calc.exe` |
| Explorer | Файлы и папки | Открыть проводник, загрузки, расположение действия, папка приложений |
| cmd.exe | Команды и batch scripts | Выполнить команду, `.bat`, `.cmd` |
| PowerShell / pwsh | PowerShell scripts | Запустить `.ps1` |
| Python | Python scripts | Запустить `.py`, если `python.exe` найден |
| Windows Shell | Показ рабочего стола | Минимизировать все окна |
| Windows Copilot | AI-ассистент | Запустить Copilot |
| Inno Setup | Установка приложения | Установить приложение, создать desktop shortcut, включить autostart |

---

# API-функции

В проекте не обнаружены пользовательские HTTP API, API endpoints, WebSocket-события или backend-роутинг. Программа является локальным Windows desktop-приложением. Пользовательские действия доступны через WPF UI, tray, глобальные hotkeys, drag-and-drop и локальные файлы.

---

# Hidden Features

## Быстрое открепление встроенных инструментов

Встроенные инструменты можно скрыть не только через настройки программы, но и правым кликом по самому инструменту на панели.

Подтверждение: `AiteBar/MainWindow.xaml.cs` (`AttachSystemUtilityContextMenus`, `BuildSystemUtilityContextMenu`).

## Добавление кнопки через drag-and-drop `.url`

Панель умеет читать Windows `.url` shortcut, извлекать строку `URL=` и создавать web-кнопку.

Подтверждение: `AiteBar/MainWindow.xaml.cs` (`TryGetDropTarget`).

## Автозагрузка favicon для web-кнопки, созданной перетаскиванием

После создания web-кнопки через drag-and-drop приложение асинхронно пытается скачать favicon и обновить иконку.

Подтверждение: `AiteBar/MainWindow.xaml.cs` (`Border_Drop`), `AiteBar/IconHelper.cs`.

## Автоизвлечение иконки программы или скрипта

При выборе Program/ScriptFile или drag-and-drop программа пытается извлечь и сохранить иконку файла.

Подтверждение: `AiteBar/SettingsWindow.xaml.cs`, `AiteBar/MainWindow.xaml.cs`, `AiteBar/IconHelper.cs`.

## Quick Note Ctrl+Shift+C

Отдельного обработчика Ctrl+Shift+C в текущем окне нет. Для всего текста используйте Ctrl+A, затем Ctrl+C.

Подтверждение: `AiteBar/QuickNoteWindow.xaml.cs`.

## Quick Note Ctrl+клик по URL

Ссылки открываются только по Ctrl+клику; при удержании Ctrl курсор над ссылкой меняется на hand. Без Ctrl редактор показывает текстовый курсор и обычный клик ставит каретку.

Подтверждение: `AiteBar/QuickNoteWindow.xaml.cs`, `AiteBar/QuickNoteDocumentFormatting.cs`.

## Конфликтные копии Quick Note

Если основной package `QuickNote.aite-note` изменился извне, AiteBar сохраняет текущую версию в уникальную конфликтную копию `QuickNote.conflict-yyyyMMdd-HHmmss-fff-<id>.aite-note`.

Подтверждение: `AiteBar/QuickNoteService.cs`, `AiteBar/QuickNoteWindow.xaml.cs`.

## Миграция старого файла кнопок

Если `settings.json` отсутствует, но есть старый `custom_buttons.json`, приложение загружает элементы из старого файла и сохраняет новое состояние.

Подтверждение: `AiteBar/AppSettingsService.cs`.

## Нормализация старых hotkey defaults

При загрузке настроек приложение заменяет старые default-комбинации `Win+Z` или `Ctrl+Alt+Z` на `Alt+4`.

Подтверждение: `AiteBar/AppSettingsService.cs`.

## Ограничение подсветки ссылок Quick Note

Автоматический поиск ссылок ограничен абзацами до 10000 символов. Явные гиперссылки продолжают обрабатываться. Расчёт находится в `QuickNoteWindow.Presentation.cs` и `QuickNoteLinkHighlightController.cs`.

Подтверждение: `AiteBar/QuickNoteWindow.xaml.cs`.

## Выбор профилей ротации с пустым списком как "все"

В окне выбора ротации пустой сохраненный список означает выбор всех профилей.

Подтверждение: `AiteBar/RotationProfileSelectionWindow.xaml.cs`, `AiteBar/ProfileRotationHelper.cs`.

---

# Проверка полноты

## Список найденных пользовательских действий

- Показать панель наведением.
- Показать/скрыть панель tray-кликом.
- Показать панель через tray menu.
- Показать/скрыть панель hotkey.
- Скрыть панель кликом вне нее.
- Переместить панель за handle.
- Переместить панель между мониторами.
- Переключить панель через контекстное меню.
- Переключить панель колесом мыши.
- Переключить панель hotkey вперед/назад.
- Создать кнопку вручную.
- Создать кнопку hotkey добавления.
- Создать кнопку drag-and-drop.
- Запустить кнопку.
- Перетащить кнопку для изменения порядка.
- Редактировать кнопку.
- Дублировать кнопку.
- Переименовать кнопку.
- Переместить кнопку в другую панель.
- Удалить кнопку.
- Скопировать URL/путь/команду.
- Открыть расположение действия.
- Запустить web URL.
- Запустить программу.
- Открыть файл.
- Открыть папку.
- Запустить script file.
- Выполнить command.
- Отправить hotkey.
- Выбрать browser.
- Выбрать browser profile.
- Включить app mode.
- Включить incognito/private.
- Включить fullscreen.
- Включить rotation.
- Выбрать rotation profiles.
- Найти rotation profile.
- Выбрать все profiles.
- Очистить selection profiles.
- Искать clipboard text в Google.
- Запустить screenshot.
- Запустить screen recording.
- Открыть calculator.
- Открыть explorer.
- Открыть downloads.
- Открыть timer/stopwatch.
- Выбрать screen color.
- Открыть Quick Note.
- Открыть File Sorter.
- Открыть Icon Converter.
- Открыть QR Code Generator.
- Открыть Clipboard Manager.
- Показать рабочий стол.
- Открыть папку приложений.
- Открыть Copilot.
- Открепить quick tool.
- Редактировать Quick Note.
- Автосохранить Quick Note.
- Сохранить заметку через Ctrl+S; показать восстановительную копию в папке.
- Очистить Quick Note.
- Закрыть Quick Note.
- Переместить Quick Note.
- Изменить размер Quick Note.
- Выбрать Quick Note theme.
- Форматировать Quick Note: bold, italic, underline, code.
- Создать bullet/numbered list в Quick Note.
- Очистить formatting в Quick Note.
- Cut/copy/paste/select all в Quick Note.
- Ctrl+A, Ctrl+C для копирования всей заметки.
- Ctrl+клик URL в Quick Note.
- Выбрать иконку из Material.
- Выбрать иконку из Fluent.
- Выбрать brand icon.
- Искать иконку.
- Выбрать custom icon.
- Выбрать icon color.
- Ввести HEX color.
- Открыть app settings из button settings.
- Выбрать UI language.
- Выбрать panel edge.
- Выбрать monitor.
- Настроить panel size.
- Настроить activation zone.
- Настроить delay.
- Включить/выключить panels.
- Переименовать panels.
- Настроить hotkeys.
- Включить/выключить quick tools.
- Импортировать panel package.
- Экспортировать panel package.
- Открыть About.
- Открыть website.
- Открыть repository.
- Открыть third-party notices.
- Открыть data folder.
- Открыть program folder.
- Открыть online help.
- Открыть donate page.
- Добавить несколько подключений AI-сервисов.
- Проверить API-ключ без отправки inference-запроса.
- Изменить приоритет подключений с независимыми квотами.
- Удалить AI-подключение и сохранённый Windows credential.
- Закрыть приложение.

## Сверка покрытия

Все действия из списка выше описаны в карте возможностей, полном каталоге функций, разделах настроек, hotkeys, интеграций или hidden features. Отдельные низкоуровневые действия, такие как hover/active UI-состояния, автонормализация настроек и миграция старого файла, вынесены в `Hidden Features`, если пользователь может наблюдать их эффект.