USER_MANUAL.md

AiteBar User Manual

AiteBar - скрываемая панель быстрого доступа для Windows. Она появляется у края экрана и запускает сайты, программы, файлы, папки, команды, скрипты, горячие клавиши и встроенные инструменты.

Это руководство написано для пользователей. Технические детали вынесены в docs/technical-reference.md, а проверочный список для релиза - в docs/documentation-qa-checklist.md.

Содержание

• Почему AiteBar удобен
• Быстрый старт
• Главный экран
• Установка и запуск
• Как добавить кнопку
• Типы действий
• Браузеры и профили
• Панели-контексты
• Быстрые инструменты
• Quick Note
• Импорт и экспорт
• Настройки
• Безопасность
• Примеры использования
• Устранение неполадок
• FAQ

Почему AiteBar удобен

AiteBar заменяет разрозненные ярлыки, закладки и команды одной компактной панелью.

• Панель скрывается у края экрана и не занимает место на рабочем столе.
• Кнопки можно разделить по рабочим панелям: работа, личное, AI, администрирование, дизайн.
• Сайты можно открывать в нужном браузере, профиле, приватном режиме или как отдельное приложение.
• Команды, скрипты и горячие клавиши можно запускать из той же панели, что и обычные сайты.
• Панель можно переместить на верхний, нижний, левый или правый край экрана.
• AiteBar работает с несколькими мониторами.
• Текущую панель можно экспортировать и перенести на другой компьютер.

Быстрый старт

1. Запустите AiteBar.
2. Подведите курсор к верхнему краю экрана.
3. Когда появится панель, нажмите +.
4. Введите название кнопки, например ChatGPT.
5. Выберите тип Ссылка.
6. Введите адрес сайта, например chatgpt.com.
7. Выберите иконку и цвет.
8. Нажмите Сохранить.
9. Нажмите новую кнопку на панели.

Скриншот: первая открытая панель AiteBar с кнопкой +. TODO: вставить изображение после подготовки релизных скриншотов.

Главный экран

Главный экран AiteBar - это сама панель. Она появляется у выбранного края экрана и содержит:

Элемент	Для чего нужен
Handle	Перетащите за него панель на другой край или монитор
+	Добавить новую пользовательскую кнопку
Быстрые инструменты	Запустить поиск, скриншот, калькулятор, Quick Note и другие встроенные действия
Пользовательские кнопки	Запустить ваши сайты, программы, файлы, команды и скрипты
Настройки	Открыть общие настройки программы

Скриншот: панель с подписями основных элементов. TODO: вставить изображение после подготовки релизных скриншотов.

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

Показать панель можно одним из способов:

1. Подведите курсор к настроенному краю экрана.
2. Нажмите левой кнопкой мыши на значок AiteBar в системном трее.
3. Откройте tray-меню и выберите Открыть.
4. Нажмите назначенную горячую клавишу.

Панель скрывается автоматически, когда вы кликаете вне неё или запускаете большинство действий.

Переместить панель

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

AiteBar запомнит выбранный край и монитор.

Установка и запуск

Поддерживаются Windows 10 и Windows 11.

1. Запустите AiteBar-Setup.exe.
2. Выберите папку установки.
3. При необходимости включите создание ярлыка и автозапуск.
4. Завершите установку.
5. Запустите AiteBar из меню Пуск, с ярлыка или из последнего шага установщика.

После запуска значок AiteBar появляется в системном трее. Если панель не видна, подведите курсор к верхнему краю экрана или нажмите на tray-значок.

Проверка обновлений

Откройте tray-меню или окно About и выберите Check for updates.

Если доступна новая версия, AiteBar покажет текущую и новую версию и предложит открыть страницу релиза на GitHub. Программа не скачивает и не устанавливает обновления автоматически.

Если интернет недоступен или GitHub временно не отвечает, AiteBar покажет сообщение об ошибке проверки обновлений.

Телеметрия и диагностика

Обычная установленная версия AiteBar не отправляет телеметрию и crash reports по умолчанию.

Диагностическая отправка ошибок через Sentry включается только если пользователь или разработчик явно задал переменную окружения AITEBAR_SENTRY_DSN или SENTRY_DSN перед запуском приложения. Этот режим предназначен для разработки и поддержки.

Как добавить кнопку

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

Скриншот: окно создания кнопки. TODO: вставить изображение после подготовки релизных скриншотов.

Добавить сайт

1. Нажмите +.
2. Введите название, например Gmail.
3. Выберите тип Ссылка.
4. Введите адрес, например gmail.com.
5. Выберите браузер.
6. При необходимости выберите профиль браузера.
7. Нажмите Сохранить.

Если вы ввели адрес без https://, AiteBar добавит его автоматически.

Добавить программу

1. Нажмите +.
2. Выберите тип Программа.
3. Выберите .exe, .lnk или .appref-ms.
4. Настройте название, иконку и цвет.
5. Нажмите Сохранить.

Добавить файл или папку

1. Нажмите +.
2. Выберите тип Файл или Папка.
3. Укажите нужный путь.
4. Нажмите Сохранить.

Добавить скрипт

1. Нажмите +.
2. Выберите тип Скрипт.
3. Выберите .bat, .cmd, .ps1 или .py.
4. Дайте кнопке понятное название.
5. Нажмите Сохранить.

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

Добавить команду

1. Нажмите +.
2. Выберите тип Команда.
3. Введите команду.
4. Дайте кнопке понятное название.
5. Нажмите Сохранить.

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

Добавить горячую клавишу

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

Когда вы нажмёте такую кнопку, AiteBar отправит выбранное сочетание клавиш в активное окно.

Назначить глобальную горячую клавишу кнопке

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

Для кнопки типа Горячие клавиши global shortcut и сочетание, отправляемое в активное окно, являются разными настройками.

Добавить кнопку перетаскиванием

Перетащите на панель файл, папку, .url-ярлык или ссылку из браузера. AiteBar откроет окно создания кнопки с уже заполненной целью.

Типы действий

Тип	Что запускает	Когда использовать
Ссылка	Сайт или веб-приложение	ChatGPT, Gmail, Notion, CRM, рекламные кабинеты
Программа	Установленное приложение	VS Code, Photoshop, терминал, корпоративные утилиты
Файл	Документ или другой файл	Таблица, презентация, шаблон, локальная база
Папка	Папку в Проводнике	Проект, загрузки, рабочие материалы
Скрипт	.bat, .cmd, .ps1, .py	Автоматизация повторяющихся задач
Команда	Консольную команду	Быстрые системные действия
Горячие клавиши	Сочетание клавиш	Команды в активной программе

Управление кнопками

Нажмите правой кнопкой мыши на пользовательскую кнопку, чтобы:

• отредактировать её;
• дублировать;
• переименовать;
• переместить в другую панель;
• скопировать URL, путь или команду;
• открыть расположение файла;
• удалить кнопку.

Перетащите кнопку мышью, чтобы изменить порядок кнопок на панели.

Браузеры и профили

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

Профиль браузера - это отдельный набор аккаунтов, cookies, расширений и истории. Например, вы можете держать личный Gmail в одном профиле, рабочий Gmail - в другом, а клиентский аккаунт - в третьем.

Скриншот: параметры браузера в окне создания кнопки. TODO: вставить изображение после подготовки релизных скриншотов.

Функция	Когда использовать
Обычный запуск	Сайт должен открываться как обычная вкладка или окно браузера
App Mode	Веб-приложение должно выглядеть как отдельное приложение без лишней панели браузера
Incognito / Private	Нужна временная сессия без сохранения обычных cookies
Профиль	Нужно открыть сайт под конкретным аккаунтом
Ротация профилей	Нужно быстро переключаться между несколькими аккаунтами одной кнопкой
Fullscreen	Сайт нужно открыть сразу на полный экран

Выбрать профиль

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

Включить ротацию профилей

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

Если список профилей ротации пустой, AiteBar использует все доступные профили выбранного браузера.

Скриншот: окно выбора профилей ротации. TODO: вставить изображение после подготовки релизных скриншотов.

Панели-контексты

Панели-контексты помогают разделить кнопки по задачам. Например:

• Работа;
• Личное;
• AI;
• Dev;
• Дизайн;
• Администрирование.

В AiteBar доступно до 8 панелей. Первая панель всегда включена, остальные можно включать или выключать в настройках.

Переключить панель

Используйте один из способов:

1. Нажмите правой кнопкой мыши на свободное место панели и выберите нужную панель.
2. Прокрутите колесо мыши над панелью.
3. Используйте горячую клавишу Следующая панель или Предыдущая панель, если она назначена.

Скриншот: контекстное меню выбора панели. TODO: вставить изображение после подготовки релизных скриншотов.

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

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

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

Быстрые инструменты находятся рядом с кнопкой +. Их можно включать и выключать в настройках.

Инструмент	Что делает
Поиск	Ищет текст из буфера обмена в Google
Скриншот	Открывает системный инструмент выделения области экрана
Видео	Открывает системный инструмент записи экрана
Калькулятор	Запускает калькулятор Windows
Проводник	Открывает Проводник
Загрузки	Открывает папку загрузок
Таймер и секундомер	Открывает компактный таймер или секундомер с паузой, сбросом и пресетами времени
Выбор цвета	Позволяет выбрать цвет с экрана и скопировать HEX
Quick Note	Открывает быструю заметку

Чтобы скрыть быстрый инструмент прямо с панели, нажмите по нему правой кнопкой мыши и выберите Открепить.

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

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

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

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

Quick Note

Quick Note - это быстрая заметка с автосохранением.

1. Включите Quick Note в настройках быстрых инструментов.
2. Нажмите кнопку Quick Note на панели.
3. Введите текст.
4. Закройте окно, когда закончите.

Заметка сохраняется автоматически. В Quick Note доступны базовое форматирование, списки, ссылки, темы, очистка заметки и открытие файла во внешнем редакторе.

Полезные сочетания:

Сочетание	Действие
Esc	Закрыть Quick Note
Ctrl+Shift+C	Скопировать весь текст заметки
Ctrl+клик по ссылке	Открыть ссылку

Скриншот: окно Quick Note. TODO: вставить изображение после подготовки релизных скриншотов.

Импорт и экспорт

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

Экспортировать панель

1. Переключитесь на нужную панель.
2. Нажмите правой кнопкой мыши на свободное место панели.
3. Выберите Экспорт текущей панели....
4. Выберите место сохранения.

Импортировать панель

1. Переключитесь на панель, куда нужно импортировать кнопки.
2. Нажмите правой кнопкой мыши на свободное место панели.
3. Выберите Импорт в текущую панель....
4. Выберите файл .aitebarpanel.
5. Проверьте подтверждение импорта.

Импорт добавляет кнопки в текущую панель. Имя текущей панели не меняется.

Скриншот: импорт или экспорт панели. TODO: вставить изображение после подготовки релизных скриншотов.

Настройки

Откройте настройки кнопкой на панели или через tray-меню Настройки программы.

Скриншот: окно настроек, вкладка Общие. TODO: вставить изображение после подготовки релизных скриншотов.

Общие

Здесь можно изменить:

• язык интерфейса;
• край экрана;
• монитор;
• размер панели;
• зону активации;
• задержку появления.

Панели

Здесь можно включить, отключить и переименовать панели-контексты. Первая панель всегда включена.

Горячие клавиши

Здесь можно назначить:

• показать или скрыть панель;
• переключиться на следующую панель;
• переключиться на предыдущую панель;
• добавить кнопку.

Не назначайте сочетания, которые уже активно использует Windows или ваши основные программы.

Глобальная горячая клавиша отдельной пользовательской кнопки настраивается в окне создания или редактирования этой кнопки.

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

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

Безопасность

Команды, скрипты и импортированные панели могут выполнять действия в вашей системе. Относитесь к ним так же внимательно, как к любому исполняемому файлу.

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

Важно: перед импортом чужой панели проверьте, какие кнопки она добавляет. Пакет может содержать кнопки запуска команд или скриптов.

Важно: если скрипт требует прав администратора, AiteBar не делает его безопаснее. Проверьте скрипт вручную перед запуском.

Примеры использования

Маркетолог

Создайте панель Marketing и добавьте:

• Telegram;
• Facebook Ads;
• Google Ads;
• Google Analytics;
• Looker Studio;
• таблицу с UTM-метками;
• разные профили браузера для разных клиентов.

Используйте ротацию профилей, если нужно быстро переключаться между несколькими аккаунтами.

Разработчик

Создайте панель Dev и добавьте:

• VS Code;
• GitHub;
• терминал;
• PowerShell;
• локальную папку проекта;
• скрипт сборки;
• ссылку на staging.

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

Дизайнер

Создайте панель Design и добавьте:

• Figma;
• Photoshop;
• папку проекта;
• Color Picker;
• Quick Note;
• библиотеку ассетов;
• ссылку на брендбук.

Работа с несколькими аккаунтами

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

Устранение неполадок

Панель не появляется

Проверьте:

1. AiteBar запущен и есть значок в системном трее.
2. Вы подводите курсор к правильному краю экрана.
3. В настройках не выбрана слишком маленькая зона активации.
4. Панель не находится на другом мониторе.

Попробуйте открыть панель левым кликом по tray-значку.

Горячая клавиша не работает

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

Кнопка не запускает действие

Проверьте:

• URL сайта;
• путь к программе, файлу или папке;
• наличие скрипта;
• доступность браузера;
• сообщение об ошибке, если оно появилось.

Web-кнопка открывается не в том профиле

1. Отредактируйте кнопку.
2. Проверьте выбранный браузер.
3. Проверьте выбранный профиль.
4. Если включена ротация, проверьте список профилей ротации.

Импорт панели не выполняется

1. Убедитесь, что выбран файл .aitebarpanel.
2. Получите пакет заново, если файл повреждён.
3. Попробуйте импортировать в пустую панель.
4. Если пакет получен от другого человека, проверьте его источник.

Quick Note не сохраняется

1. Закройте внешний редактор, если он открыл файл заметки.
2. Проверьте статус внизу окна Quick Note.
3. Убедитесь, что Windows разрешает запись в профиль пользователя.

FAQ

Что делает AiteBar?

AiteBar показывает скрытую панель быстрого доступа для запуска сайтов, программ, файлов, папок, скриптов, команд, горячих клавиш и встроенных инструментов.

Где находится AiteBar после запуска?

В системном трее Windows. Панель появляется у выбранного края экрана.

Как закрыть AiteBar полностью?

Нажмите правой кнопкой мыши на tray-значок и выберите Закрыть и выйти.

Сколько панелей поддерживается?

До 8 панелей-контекстов. Первая панель всегда включена.

Какие браузеры можно выбрать для web-кнопки?

В редакторе кнопки доступны Chrome, Edge, Brave, Yandex и Firefox.

Можно ли запускать PowerShell и Python?

Да. Для скриптов поддерживаются .bat, .cmd, .ps1 и .py. Для Python нужен установленный Python.

Команды и скрипты запускаются сразу?

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

Как вернуть скрытый быстрый инструмент?

Откройте настройки программы, перейдите на вкладку Быстрые инструменты и включите нужный пункт.

Можно ли отменить импорт панели?

Через интерфейс отмена импорта не предусмотрена. Перед импортом лучше переключиться на пустую или отдельную панель.

Где посмотреть технические детали?

См. docs/technical-reference.md.