Skip to content

USER_MANUAL.md

Latest commit

 

History

History
744 lines (513 loc) · 64.8 KB

USER_MANUAL.md

File metadata and controls

744 lines (513 loc) · 64.8 KB
Raw

AiteBar User Manual

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

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

Содержание

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

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

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

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

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

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

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

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

Указатель положения панели

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

Указатель можно перетащить в удобное место выбранного монитора. AiteBar сохраняет относительное положение, поэтому при изменении масштаба или разрешения индикатор остаётся в видимой области экрана.

Действия с указателем

Действие Что происходит
Левый клик Показать или скрыть панель
Перетаскивание Переместить указатель; его границы не могут выйти за пределы выбранного монитора
Наведение Показать подсказку с текущим положением панели и номером монитора
Правый клик Открыть контекстное меню

Контекстное меню указателя

Пункт меню Действие
Показать панель Открыть панель AiteBar
Настройки Открыть общие настройки программы
Скрыть указатель Убрать индикатор с панели задач (можно вернуть через настройки)

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

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

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

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

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

  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. Нажмите Сохранить.

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

  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 или .pyw.
  4. При необходимости укажите аргументы запуска скрипта, отключите диалог подтверждения, включите режим «Оставлять окно открытым» (чтобы окно не закрывалось сразу после завершения или ошибки), скрытие консольного окна (фоновый режим) или постоянный запуск от имени администратора.
  5. Дайте кнопке понятное название.
  6. Нажмите Сохранить.

По умолчанию перед запуском скрипта AiteBar показывает подтверждение безопасности (можно отключить в параметрах кнопки). При отсутствии файла скрипта показывается сообщение об ошибке. Интерпретатор Python автоматически обнаруживается в виртуальных окружениях (.venv), uv и стандартных путях системы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подробнее о технических деталях работы с браузерами см. в Карте функций.

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

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

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

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

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

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

  1. Нажмите правой кнопкой мыши на свободное место панели и выберите нужную панель.
  2. Прокрутите колесо мыши над панелью.
  3. Используйте горячую клавишу Следующая панель или Предыдущая панель, если она назначена.
  4. Нажмите на цветной номер текущей панели: обычный клик или Enter переключает на следующую включённую панель; Shift + клик или Shift+Enter возвращает к предыдущей. Переключение цикличное.
  5. Нажмите правой кнопкой мыши на цветной номер, чтобы открыть список и выбрать конкретную включённую панель.
  6. Нажмите Alt+0…Alt+9, чтобы открыть панель и сразу перейти к соответствующему включённому контексту.

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

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

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

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

Инструмент Что делает
Поиск Ищет текст из буфера обмена в Google
Скриншот Открывает системный инструмент выделения области экрана
Видео Открывает системный инструмент записи экрана
Калькулятор Запускает калькулятор Windows
Проводник Открывает Проводник
Загрузки Открывает папку загрузок
Таймер и секундомер Открывает компактный таймер или секундомер с паузой, сбросом и пресетами времени
Выбор цвета Позволяет выбрать цвет с экрана и скопировать HEX
Quick Note Открывает быструю заметку
Дзен-редактор Открывает полноэкранный редактор обычного текста с локальным автосохранением
Обработка текста Проверяет орфографию, применяет типографику или очищает артефакты копирования через выбранный AI-сервис
Конструктор промптов Создаёт один профессиональный готовый промпт по краткому описанию задачи
Aite Profiles Показывает локальные Chrome-профили, quick-link, избранное, farm, теги и rotation
File Sorter Утилита для сортировки файлов по расширению и другим правилам
Icon Converter Утилита для конвертации изображений в формат ICO
QR Code Generator Утилита для создания QR-кодов с экспортом в PNG/SVG
Clipboard Manager Показывает историю скопированного текста и изображений, умеет сохранять её между сессиями, закреплять важные записи, копировать текст как одну строку и очищать историю выборочно
Показать рабочий стол Минимизирует все окна и показывает рабочий стол
Папка приложений Открывает системную папку Applications
Copilot Запускает Windows Copilot

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

Clipboard Manager

Clipboard Manager хранит историю текста и изображений из буфера обмена. Если в настройках включено сохранение истории, список переживает перезапуск AiteBar.

  • Поиск работает по тексту записи.
  • Фильтры Все, Закреплённые, Текст и Изображения помогают быстро сузить список.
  • Копировать возвращает исходное содержимое в буфер обмена.
  • 1 строка сворачивает переносы строк и лишние пробелы в одну строку (удобно для AI-промптов, команд и URL).
  • Закрепить оставляет важные записи сверху списка и защищает их от обычной очистки истории.
  • Очистить историю удаляет только незакреплённые записи.
  • Удалить всё стирает все записи, включая закреплённые.

Если не хотите хранить буфер обмена на диске, откройте Настройки программы и отключите Сохранять историю буфера между сессиями.

Подробнее см. в Карте функций.

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

Обработка текста — AI-утилита с пятью независимыми режимами: Проверка текста, Типографика, Очистка текста, Литературная редакция и Естественный стиль. Первые три режима выполняют только технические преобразования. Два редакторских режима могут менять формулировки, но не должны переводить текст, добавлять факты или менять авторскую позицию.

  • Проверка текста исправляет только орфографию, грамматику и пунктуацию.
  • Типографика нормализует кавычки, тире, пробелы и другие типографские знаки без изменения слов.
  • Очистка текста удаляет только явные артефакты копирования и извлечения документов.
  • Литературная редакция может улучшать неудачные формулировки и убирать ненамеренные повторы, сохраняя язык, смысл, факты, имена, авторский голос и структуру абзацев.
  • Естественный стиль делает текст живее: упрощает чрезмерную типографику, меняет ритм предложений, убирает шаблонные конструкции и слишком ровную структуру, сохраняя смысл и факты.
  1. Добавьте и включите AI-подключение в настройках AiteBar.
  2. Откройте утилиту с панели и вставьте или введите текст. Кнопка Вставить добавляет содержимое буфера в позицию курсора либо заменяет выделенный фрагмент.
  3. Выберите режим и модель. Утилита использует только бесплатные текстовые модели; генераторы изображений и видео в список не попадают. Одна модель отображается один раз независимо от количества настроенных API-ключей. В режиме Автоматически AiteBar выбирает подходящую бесплатную модель самостоятельно.
  4. Нажмите основную кнопку или Shift+Enter в редакторе. Обычный Enter вставляет перенос строки; прежнее сочетание Ctrl+Enter также поддерживается. Результат появляется по мере генерации, рядом отображается время выполнения. Запрос можно отменить той же кнопкой или клавишей Esc.
  5. После обработки переключайтесь между исходником и результатом либо нажмите Показать изменения: удалённые фрагменты будут зачёркнуты красным, добавленные — подчёркнуты зелёным. Пока сравнение открыто, кнопка называется Скрыть изменения и возвращает обработанный результат.
  6. Ctrl+Z отменяет, а Ctrl+Y повторяет ручные правки и операции замены текста.
  7. При необходимости используйте Повторить. Для явно выбранной модели AiteBar перебирает доступные API-ключи того же провайдера, но не подменяет выбранную модель другой.

Текст отправляется выбранному AI-сервису только после явного запуска. URL, e-mail, пути, код, теги, версии и идентификаторы защищаются локальными маркерами и восстанавливаются после ответа. Максимальный размер одного запроса — 50 000 символов; более длинный текст не обрезается, но обработка блокируется, пока вы его не сократите. Текст, исходник и результат не сохраняются между запусками AiteBar. При каждом новом открытии первой выбирается Проверка текста; выбранная модель и геометрия окна запоминаются.

Подробнее см. в Карте функций.

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

Конструктор промптов превращает краткое описание задачи в один подробный промпт, готовый для использования в нейросети. Выберите рубрику из списка: Изображения, Живопись, Анимация, Арт-ню, Графика, Видео, Музыка, опишите задачу и нажмите Создать промпт либо Shift+Enter. Обычный Enter вставляет перенос строки; Ctrl+Enter также поддерживается.

Утилита не задаёт уточняющих вопросов и не ведёт диалог. Если важную деталь нельзя безопасно определить из описания, в готовом промпте появляется короткий заполнитель в квадратных скобках. Команды Повторить, Показать задачу, Показать промпт, Показать изменения, копирование и выбор модели работают так же, как в утилите обработки текста. Исходное описание и результат по умолчанию не сохраняются между запусками; для персистентности черновиков можно включить SavePromptBuilderDrafts в settings.json.

Подробнее см. в Карте функций.

Aite Profiles

Aite Profiles открывает компактную таблицу локальных профилей Google Chrome внутри AiteBar.

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

Утилита хранит только локальные данные AiteBar: cache профилей, избранное, farm, теги, quick-link и rotation. Она не читает Chrome Login Data, не считает пароли, не запускает API-сервер, не создаёт tray-иконку и использует hotkey только через стандартные настройки AiteBar.

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

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

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

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

Подробнее см. в Карте функций.

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

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

Обычный экран содержит только фон, центральную колонку обычного текста, выделение и курсор. Шапки, кнопок сворачивания и других элементов окна нет. Каждый жёсткий перенос создаёт визуальный абзац: межстрочный интервал составляет 1,5em, а дополнительный интервал после абзаца — 0,75em (15 DIP при кегле 20). Эти интервалы не добавляют пробелы или пустые строки в сохранённый текст.

Правый клик или Shift+F10 открывает команды создания и выбора документов, восстановления недавно удалённых документов, поиска, экспорта TXT, Undo/Redo, форматирования, буфера обмена и пяти фиксированных тем: Бумага, Слоновая кость, Туман, Графит, Ночь. Выделенный текст автоматически копируется в буфер, а вставка всегда преобразуется в обычный текст. Встроенные сочетания Ctrl+B, Ctrl+I и Ctrl+U применяют жирность, курсив и подчёркивание; это форматирование сохраняется во внутреннем документе и восстанавливается при следующем открытии.

Ctrl+F открывает временную строку поиска. Enter и F3 переходят к следующему совпадению, Shift+Enter и Shift+F3 — к предыдущему; поиск не учитывает регистр и циклически переходит через начало или конец документа. Первое нажатие Esc закрывает открытую строку поиска, следующее закрывает редактор.

Документ сохраняется через 300 мс после остановки ввода, при потере фокуса, переключении документа, экспорте и закрытии. Хранилище полностью локальное; текст не отправляется в AI, аналитику или сеть. При ошибке сохранения редактор оставляет текст открытым и предлагает повторить запись либо экспортировать TXT. При экспорте форматирование удаляется, а между соседними абзацами записывается ровно одна пустая строка; уже существующий промежуток не удваивается.

Основные сочетания: Ctrl+N — новый документ, Ctrl+O — список документов, Ctrl+S — сохранить сейчас, Ctrl+Shift+S — экспорт TXT, Ctrl+Z/Ctrl+Y — Undo/Redo, Ctrl+Alt+1…5 — выбор темы по номеру, Ctrl+Alt+↑/Ctrl+Alt+↓ — циклическое переключение тем назад и вперёд. Стандартные Shift+↑/Shift+↓ расширяют выделение текста. Esc и Alt+F4 закрывают редактор, когда временный поиск не открыт. При переключении через Alt+Tab неактивный редактор перестаёт перекрывать другие программы и возвращает полноэкранный приоритет после активации.

Quick Note

Quick Note — одна локальная заметка с автосохранением. Включите её в настройках быстрых инструментов и откройте кнопкой панели или настроенной горячей клавишей.

Заметка хранится в %AppData%\Codebdbd\Aite Bar\QuickNote.aite-note. Сохраняются форматирование, списки, задачи, код, ссылки и встроенные изображения. Старый QuickNote.rtf загружается при отсутствии основного файла; успешная миграция не удаляет оригинал. Импорт/экспорт Markdown и команда открытия RTF во внешнем редакторе в текущем интерфейсе отсутствуют.

Панель форматирования находится внизу. В ней доступны размер текста, маркированный и нумерованный списки, чеклист, жирный, курсив, зачёркивание, ссылка, изображение, подчёркивание, кодовый блок, цитата, разделитель и очистка форматирования. Чеклисты не добавляются в контекстное меню. В верхней полосе находятся только закрепление, Undo/Redo, выбор цвета и закрытие, без надписи с названием утилиты. Контекстное меню содержит стандартные текстовые команды, выбор цвета и очистку заметки.

Палитра содержит семь вариантов по образцу «Записок» Windows: жёлтый, зелёный, розовый, фиолетовый, голубой, светлый и тёмный. Цвета расположены сплошной полосой, выбранный отмечен галочкой. Насыщенные образцы палитры отделены от светлого фона заметок. Верхние полосы светлых тем светлее образцов палитры: у фиолетовой темы цвет полосы #E7CFFF, фон #F2E6FF, образец #D7AFFF, по предоставленному снимку «Записок» Windows. Остальные светлые полосы осветлены в той же пропорции; образцы палитры и оформление кода и цитат сохранены. Старые идентификаторы тем сохраняют совместимость: графит переходит в тёмный, глина и песок — в жёлтый, туман — в голубой, сирень — в розовый.

Блоки кода во всех темах используют одинаковый тёмный фон индиго со светлым текстом. У кода и цитат есть внутренние вертикальные отступы; обычные списки не добавляют промежутков сверху и снизу. Нижняя строка инструментов соответствует высоте кнопок, а строка статуса имеет минимальные отступы. Рамка фокуса кнопок появляется при навигации с клавиатуры, но не при клике мышью. Удалённые чекбоксы восстанавливаются через Undo вместе с оформлением и обработкой клика.

Сохранение и восстановление

Автосохранение запускается после паузы ввода. Правки, внесённые во время записи, сохраняются следующим снимком; закрытие ждёт сохранения последних изменений. При ошибке записи окно остаётся открытым. Ctrl+S повторяет сохранение; полный текст статуса доступен в подсказке.

Если исходный файл изменился извне или не удалось его прочитать, оригинал не перезаписывается: новые правки сохраняются в QuickNote.conflict-<дата>-<id>.aite-note рядом с ним. Кнопка папки у статуса показывает последнюю копию в Проводнике. Хранятся последние пять таких копий. Для восстановления закройте Quick Note, сохраните отдельную резервную копию исходного файла и скопируйте нужную конфликтную копию на место QuickNote.aite-note, затем откройте окно снова. Не заменяйте файл при открытом редакторе.

Закрепление окна

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

В Windows 11 свободно расположенная заметка использует системное скругление углов. При привязке к краю или разворачивании Windows убирает скругление, чтобы окна стыковались без зазоров. В Windows 10 форма углов определяется системой; собственная прозрачная маска поверх окна не используется.

Кнопка закрепления удерживает окно открытым при потере фокуса. Без закрепления окно закрывается при переходе в другое приложение; диалоги и меню заметки не вызывают случайного закрытия. Размер и позиция запоминаются и ограничиваются рабочей областью доступного монитора.

Перетаскивание и системный выбор соседнего окна Snap Assist не закрывают незакреплённую заметку. Булавка при этом не включается автоматически. После возврата к заметке обычный уход в другое приложение по-прежнему закрывает её, если закрепление выключено.

При совместном изменении размеров Windows может временно показывать серую размытую плашку вместо соседнего окна. Это наблюдается также у обычных окон WPF и WinForms; после отпускания границы содержимое должно вернуться. Если серое поле остаётся после отпускания, это отдельная проблема, требующая проверки.

Чтобы видеть текст заметки во время совместного изменения размеров, захватите её боковой край чуть внутри заметки у общей границы окон, когда указатель принимает форму стрелок изменения размера. Предварительно щёлкать по тексту не нужно: заметка активируется самим захватом. Боковая зона захвата расширена внутрь, чтобы её не перекрывала невидимая рамка соседнего окна. Операцией по-прежнему управляет Windows Snap; при захвате границы со стороны другого приложения Windows может показывать серую плашку вместо заметки.

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

Новые изображения из буфера обмена, файла или перетаскивания вставляются отдельным абзацем без текста сбоку. Текст по обе стороны места вставки сохраняется, курсор оказывается под изображением. Вставка отменяется одним Undo и восстанавливается через Redo вместе с изображением. Старые заметки с изображениями внутри строк по-прежнему загружаются без принудительного изменения их разметки.

Перетаскивание за свободную часть верхней полосы и изменение размера за края обрабатывает Windows через WindowChrome. Прозрачные накладки с ручным запуском изменения размера не используются. Двойной щелчок по свободной части полосы разворачивает или восстанавливает окно, правый щелчок открывает системное меню. Для совместного изменения размера через общую границу сначала разместите заметку и соседнее окно в одной группе привязки Windows; соответствующие параметры привязки должны быть включены в настройках многозадачности Windows.

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

Сочетание Действие
Ctrl+S Сохранить / повторить неудачную запись
Ctrl+Z / Ctrl+Y Отменить / повторить изменение
Ctrl+B / Ctrl+I / Ctrl+U Жирный / курсив / подчёркивание
Ctrl+K Вставить ссылку
Ctrl+Alt+C Кодовый блок
Esc Снять выделение изображения или закрыть окно
Ctrl+клик по URL, e-mail или номеру телефона Открыть ссылку; обычный клик ставит каретку

Подробнее см. Карту функций.

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

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

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

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

Экспорт автоматически упаковывает в .aitebarpanel все пользовательские иконки-файлы, используемые кнопками (при условии, что файл существует на момент экспорта). Внутри пакета иконки хранятся в подпапке images, а их пути в манифесте заменяются на безопасные относительные.

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

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

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

При импорте на другой компьютер пользовательские иконки автоматически раскладываются в локальную папку %AppData%\Codebdbd\Aite Bar\icons, поэтому панель переносится «как есть» и не требует ручного копирования картинок. Перед копированием иконки проходят проверку IsPackagedImagePathSafe на недопустимые .. и абсолютные пути.

Подробнее о технических деталях импорта/экспорта см. в Карте функций.

Резервное копирование

Резервное копирование сохраняет всё состояние приложения в зашифрованный архив .aitebarbackup и позволяет восстановить его на этом же или другом компьютере. В отличие от импорта/экспорта отдельных панелей, бэкап сохраняет все панели-контексты, настройки окна утилит, пользовательские иконки, историю буфера обмена и (опционально) API-ключи нейросетей.

Создать резервную копию

  1. Откройте Настройки программы → вкладка О программе.
  2. В разделе Backups нажмите Create backup....
  3. В открывшемся диалоге выберите режим:
    • Стандартный бэкап (по умолчанию) — настройки, все панели-контексты, Quick Note, документы Дзен-редактора, пользовательские иконки и параметры окон утилит. Без шифрования, без пароля.
    • Полный бэкап (включите опцию Include encrypted API keys and clipboard) — то же самое плюс все API-ключи из Windows Credential Manager и снимок истории буфера обмена. Шифруется AES-GCM-256, требуется придумать пароль.
  4. Если выбрали полный бэкап — придумайте и введите пароль в поле Password.
  5. Выберите место на диске для файла .aitebarbackup.

Бэкап создаётся как ZIP-архив максимального размера 100 МБ. Внутри:

  • settings.json — все настройки и панели (в открытом виде);
  • icons/ — все пользовательские иконки кнопок;
  • private.bin — только в полном бэкапе, зашифрованный контейнер с API-ключами и историей буфера обмена. Шифрование: AES-GCM 256-bit, ключ из пароля через PBKDF2 (SHA-256, 210 000 итераций, случайная 16-байтная salt).

Пароль от полного бэкапа нельзя восстановить. Запомните его или сохраните в надёжном менеджере паролей.

Восстановить из резервной копии

  1. Откройте Настройки программы → вкладка О программе.
  2. В разделе Backups нажмите Restore backup....
  3. Выберите файл .aitebarbackup.
  4. Автоматически создаётся safety backup текущего состояния перед восстановлением — на случай отмены или ошибки.
  5. Подтвердите замену текущих настроек в диалоге подтверждения.
  6. Если бэкап полный (зашифрованный) — введите пароль от него в диалоге Backup options.

После успешного восстановления приложение перезагружает настройки и отображает сообщение Backup restored. Все API-ключи автоматически записываются в локальный Credential Manager с теми же CredentialTarget, а иконки раскладываются в %AppData%\Codebdbd\Aite Bar\icons.

Подробнее о формате файла, шифровании и полях см. в Технической справке.

Настройки

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

Общие

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

  • язык интерфейса;
  • край экрана;
  • монитор;
  • размер панели;
  • зону активации;
  • задержку появления;
  • показывать панель при наведении мыши (включено по умолчанию; можно отключить, сохранив открытие через hotkey, tray и указатель);
  • показывать указатель положения панели (включено по умолчанию).

Панели

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

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

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

  • показать или скрыть панель;
  • переключиться на следующую панель;
  • переключиться на предыдущую панель;
  • добавить кнопку.
  • запустить File Sorter, Icon Converter, Quick Note, Color Picker, Timer/Stopwatch, QR Code Generator, Clipboard Manager, Обработку текста, Дзен-редактор или Aite Profiles.

Не назначайте сочетания, которые уже активно использует 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-значок и выберите Закрыть и выйти.

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

10 панелей-контекстов с номерами от 0 до 9. Панель 0 всегда включена.

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

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

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

Да. Для скриптов поддерживаются .bat, .cmd, .ps1, .py и .pyw. Для .ps1 поддерживаются PowerShell 7 (pwsh) и Windows PowerShell. Для Python поддерживаются виртуальные окружения (.venv/venv проекта), uv, стандартные пути установки и PATH (для .pyw используется pythonw.exe). Для любого скрипта можно включить опцию «Оставлять окно открытым», чтобы консоль не закрывалась после завершения.

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

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

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

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

Как подключить нейросети?

Откройте Настройки программы → Нейросети, нажмите Добавить подключение, выберите сервис, укажите аккаунт или проект с общей квотой и вставьте API-ключ. Нажмите Проверить, затем сохраните настройки. Поддерживаются несколько подключений OpenRouter, Cerebras, Google Gemini, Groq, GitHub Models и Mistral AI. Полная инструкция: AI_PROVIDERS.md.

API-ключи хранятся в Диспетчере учётных данных Windows, а не в settings.json. Подключение само по себе ничего не отправляет во внешний сервис; передача текста или файла происходит только по явной команде в AI-утилите.

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

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

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

См. docs/technical-reference.md.