Документация / Основные понятия
AI-компоновка
Опишите нужную рабочую область в панели чата AI-компоновки — упоминайте через @ конкретные приложения, окна, сцены или мониторы, — и AI проанализирует открытые окна (заголовки, URL, пути к файлам), а затем предложит план сцен, который можно просмотреть, доработать, применить или отменить одним действием (Cmd-Z в панели). Используйте её с собственным ключом AI-провайдера на лицензии Pro или с BetterStage AI — управляемой подпиской, которой не нужны ключ API и настройка.
Как это работает
AI-компоновка просматривает все открытые окна на всех мониторах, собирает метаданные (название приложения, заголовок окна, путь к документу, URL) и отправляет их AI-модели — вашему собственному провайдеру (с вашим ключом API) или управляемому сервису BetterStage, если у вас есть подписка BetterStage AI. Модель возвращает план, который создаёт именованные сцены и распределяет каждое окно по нужной сцене и монитору.
- Сканирование — BetterStage считывает заголовки окон, пути к документам, URL и названия приложений для каждого открытого окна.
- Анализ — данные отправляются AI-провайдеру: вашему собственному или управляемому сервису BetterStage при подписке BetterStage AI. Панель чата показывает ход работы в реальном времени и прикрепляет предложенные действия к ответу ассистента.
- Просмотр и применение — создаются новые сцены, и каждое окно назначается нужному монитору на каждой сцене. BetterStage также выбирает режим окон для каждого монитора — расширенный Native или TabStack — в зависимости от того, что там сгруппировано; в запросе можно попросить определённый режим. План можно доработать до применения, а применённые изменения — потом отменить целиком.
Запуск AI-компоновки
Запустить AI-компоновку можно четырьмя способами:
- Сочетание клавиш — нажмите Opt+Z (в европейской схеме: Ctrl+Opt+Z) или своё сочетание из раздела «Настройки» > «Сочетания».
- Строка меню — нажмите значок BetterStage в строке меню и выберите «AI-компоновка…»
- Колесо привязки — откройте колесо привязки и выберите «AI-компоновка» в подменю «Рабочая область».
- Настройки — откройте «Настройки» > «AI-компоновка», настройте провайдера и запустите оттуда.
Настройка провайдера
С собственным ключом API AI-компоновка обращается напрямую к вашему провайдеру, и никакие данные не проходят через серверы BetterStage. (При подписке BetterStage AI запросы вместо этого идут через управляемый сервис BetterStage — ключ не нужен.) Провайдер настраивается в разделе «Настройки» > «AI-компоновка». BetterStage включает 25 предустановок провайдеров: OpenAI, Claude (Anthropic), Google Gemini, OpenRouter, Groq, Together AI, Mistral, xAI (Grok), DeepSeek, Moonshot (Kimi), Zhipu (GLM), Alibaba Qwen, MiniMax, Tencent Hunyuan, ByteDance Doubao, NVIDIA NIM, Hugging Face, Azure OpenAI и другие — включая локальные серверы, такие как Ollama и LM Studio.
- Актуальные списки моделей — выберите предустановку, и BetterStage загрузит модели, действительно доступные вашему ключу.
- Выбор региона — у провайдеров с региональными конечными точками (Qwen, Moonshot, Zhipu, MiniMax, SiliconFlow) можно переключаться между китайским и международным базовым URL.
- Отдельные ключи API для провайдеров — каждый провайдер помнит свой ключ, поэтому при смене предустановки ключи не теряются.
- Своя конечная точка — предустановка «Другой (совместимый с OpenAI)» принимает любой базовый URL и название модели, например прокси или собственный сервер.
| Провайдер | Модель по умолчанию | Аутентификация |
|---|---|---|
| OpenAI | gpt-4.1-mini | Ключ API (Bearer-токен) |
| Claude (Anthropic) | claude-sonnet-4-6 | Ключ API (заголовок x-api-key) |
| Ollama (локально) | установленная вами модель | Нет (localhost) |
| Другой (совместимый с OpenAI) | любая | Ключ API (Bearer-токен) |
Остальные 22 предустановки устроены так же — совместимы с OpenAI, с заранее заполненными базовым URL и моделью по умолчанию.
Проверить подключение
В разделе «Настройки» > «AI-компоновка» есть кнопка «Проверить подключение», которая отправляет настоящее сообщение в чат настроенной модели, — так вы убедитесь, что конечная точка, ключ и модель действительно работают, прежде чем на них полагаться. Проблемы настройки обнаруживаются ещё до запроса: вместо необработанной ошибки провайдера вы увидите понятное сообщение и кнопку «Открыть настройки».
Сохранённые рецепты
Рецепты — это сохранённые инструкции о том, как должна быть устроена ваша рабочая область. Держите отдельные рецепты для разных сценариев — программирования, дизайн-ревью, поддержки, написания текстов или чего угодно, что вы делаете регулярно. В панели AI-компоновки можно переключать рецепты, создавать новые, дублировать и переименовывать существующие, удалять старые и выбирать рецепт по умолчанию для новых сеансов.
Выбранный рецепт учитывается при запуске AI-компоновки. Редактируйте его с помощью тех же @-упоминаний, что и в чате (мониторы, сцены, окна, приложения и режимы окон), просматривайте точный промпт, который отправляется модели, и запускайте расстановку прямо из панели.
Примеры заметок в рецепте:
- «Размести чаты и музыку на маленьком боковом мониторе. Вкладки браузера с документацией проекта держи рядом с редактором».
- «Всегда создавай сцену „Общение“ для Slack, Discord и почты».
- «По возможности группируй по имени клиента».
Какие данные отправляются
AI-компоновка отправляет AI-модели снимок рабочей области. С собственным ключом API он идёт напрямую к вашему провайдеру, и серверы BetterStage его не видят; при подписке BetterStage AI он передаётся через управляемый сервис BetterStage. Снимок включает:
- Метаданные окон — название приложения, заголовок окна, путь к файлу документа, URL содержимого (хост + путь)
- Расположение мониторов — названия дисплеев, порядок расположения, границы, статус основного/дополнительного
- Системные ограничения — максимальное число сцен, максимальное число окон на сцене
Содержимое файлов, снимки экрана и нажатия клавиш не отправляются. Однако заголовки окон, пути к файлам и URL могут содержать конфиденциальные названия проектов или документов, поэтому выбирайте провайдера, которому доверяете.
Требования
- Лицензия Pro — AI-компоновка является функцией Pro.
- AI-провайдер — собственный ключ API для одного из 25 поддерживаемых провайдеров (или любой совместимой с OpenAI конечной точки) либо подписка BetterStage AI, которая запускает AI за вас без ключа.
- Подключение к интернету — требуется для облачных провайдеров. Локальные серверы (Ollama, LM Studio) работают без сети.