Перейти к содержимому
bb plugin atlas

Поверхности

bb 0.43.3SDK 0.4.104пин e865697 (desktop-v0.43.3)

API плагинов включает 46 поверхностей, разбитых на семь групп. Их нумерация такая же, как во встроенном Plugin Guide. Поверхность в этом руководстве — это продуктовая группировка: объекты PluginSurface { id, title, summary, bullets, apiSymbols, … } внутри SurfaceGroup. Номер — это индекс внутри группы плюс один (SURFACE_NUMBERS); у группы headless номеров нет.

Визуальная карта

На странице /map/ эти же номера наложены на реальный интерфейс bb (App shell · Quick palette · Home · Settings → страница плагина · страница Plugins). Ниже — табличный указатель с символами SDK и ссылками.

В каждой строке указаны id поверхности, её символы SDK, использующие её плагины из поставки bb и место в интерфейсе. Из строки можно перейти к визуальной карте и карточке слота или неймспейса, реализующего эту поверхность.

Окно приложения bb

Главное окно bb: боковая панель, переписка и правая панель. Плагин может добавлять строки, элементы управления, вкладки панели и содержимое сообщений в пронумерованные области.

Палитра команд

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

Композер

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

  • Баннерыстабильный Отрисовывает баннер над полем ввода. С её помощью плагин может: на макете зон
  • Упоминаниястабильный Добавляет результаты в меню, которое открывается, когда в поле ввода набирают символ-триггер. Если bb сам не использует этот триггер, меню открывает и ведёт ваш плагин. С её помощью плагин может: на макете зон
  • Подсветка черновика промптастабильный Стилизует диапазоны текста по мере набора промпта пользователем, не изменяя сам текст. С её помощью плагин может: на макете зон
  • Состояние и блокировка черновикастабильный Читает черновик промпта и может блокировать ввод, пока плагин работает. С её помощью плагин может: на макете зон
  • Меню +стабильный Добавляет пункты в меню, которое открывается кнопкой + рядом с полем ввода. С её помощью плагин может: на макете зон
  • Провайдеры агентаэкспериментальный Добавляет агента в селектор моделей bb и исполняет запускаемые с ним треды. С её помощью плагин может: на макете зон
  • Действия в поле вводастабильный Добавляет кнопку в панель управления внутри поля ввода, рядом с кнопками голосового ввода и отправки. С её помощью плагин может: на макете зон

Страница плагина

Страница, которую bb показывает для установленного плагина в разделе Plugins: что это за плагин, что он регистрирует и исправен ли он. Плагин может сообщить, что его нужно настроить, и bb скажет об этом вверху страницы.

  • Статус конфигурациистабильный Сообщает, что плагин не может работать, пока его не настроят, чтобы bb показал это, а плагин не ломался молча. С её помощью плагин может: на макете зон

Бэкенд плагина

Части API плагинов без собственного интерфейса.

Команды и возможности агента

Выполнение и реакции

Данные и платформа

  • Хранилищестабильный Сохраняет данные плагина на сервере bb. С её помощью плагин может: на макете зон
  • SDK bbстабильный Вызывает собственный API bb из серверного кода плагина. С её помощью плагин может: на макете зон
  • Метаданные плагина в тредестабильный Хранит JSON плагина в его неймспейсе для треда и не показывает его модели автоматически. С её помощью плагин может: на макете зон
  • Управление десктопным браузеромэкспериментальный Управляет выбранным окном на десктопе через bb.sdk.experimental_desktopBrowsers. С её помощью плагин может: на макете зон
  • AI-сервисыэкспериментальный Позволяет плагину отвечать на вызовы вспомогательной модели самого bb — короткие вызовы, которые стоят за названиями тредов и сообщениями коммитов, — и на транскрипцию для кнопки микрофона. С её помощью плагин может: на макете зон
  • Компоненты хостастабильный Рендерит переписку bb, поле ввода и общие иконки приложения внутри страниц плагина. С её помощью плагин может: на макете зон

Проверка

Главная страница

Экран, с которого открывается bb: композер нового треда и правая панель. Плагин может добавить секцию под композером и действие в этой панели, которое открывает собственную вкладку плагина.

Страница настроек плагина

Страница настроек, которую bb создаёт для каждого установленного плагина. Плагин может объявить поля, которые отрисует bb, и добавить под ними собственную секцию.