Каталог возможностей
Перед разработкой плагина изучите полный публичный каталог. Каждая возможность имеет независимую версию; каждая зависимость должна находиться в разделе requires манифеста.
29 возможности
Возможность
libraryДомены · v 1.0.0- Плагин может
- Читать книги, файлы, метаданные, оглавления, коллекции, а также импортировать и удалять элементы библиотеки.
- Полномочия
library:read / library:write- Хост сохраняет
- Инварианты библиотеки, записи через журнал событий, файлы и проекции.
readingДомены · v 1.0.0- Плагин может
- Просматривать активную сессию, перемещаться и обновлять позицию, прогресс и время чтения.
- Полномочия
reading:read / reading:write- Хост сохраняет
- Жизненный цикл ридера, семантика прогресса и зафиксированные события.
annotationsДомены · v 1.0.0- Плагин может
- Читать и изменять выделения и заметки через канонические команды.
- Полномочия
annotations:read / annotations:write- Хост сохраняет
- Проверка, атрибуция, сохранение и порядок событий.
conversationsДомены · v 1.0.0- Плагин может
- Читать сводки книжных и глобальных веток разговоров.
- Полномочия
conversations:read- Хост сохраняет
- Записи разговоров, сборка промпта и память.
settingsДомены · v 1.0.0- Плагин может
- Обнаруживать, читать и обновлять явно предоставленные пути настроек, а также подписываться на них.
- Полномочия
settingsAccess- Хост сохраняет
- Каталог, цели, проверка, сохранение и эффекты изменений.
selectionActionsРасширения · v 1.0.0- Плагин может
- Добавлять команду в меню выделения и аннотаций.
- Полномочия
нет- Хост сохраняет
- Размещение меню, интерфейс вызова, загрузка и доступность.
headerActionsРасширения · v 1.0.0- Плагин может
- Добавлять действие на панели ридера или библиотеки с представлением хоста.
- Полномочия
нет- Хост сохраняет
- Размещение, навигация, всплывающие окна, страницы и фокус.
commandsРасширения · v 1.0.0- Плагин может
- Добавлять явную команду в палитру команд.
- Полномочия
нет- Хост сохраняет
- Реестр, палитра, сочетания клавиш и отображение результата.
settingsOptionsРасширения · v 1.0.0- Плагин может
- Определять динамические варианты одного объявленного параметра плагина.
- Полномочия
нет- Хост сохраняет
- Отрисовка формы, запасной ввод и проверка значения.
voiceProvidersРасширения · v 1.0.0- Плагин может
- Перечислять голоса и синтезировать кодированный звук для чтения вслух.
- Полномочия
нет- Хост сохраняет
- Воспроизведение, темп, предварительная загрузка, подсветка и запасной вариант.
contentProvidersРасширения · v 1.0.0- Плагин может
- Загружать разделы виртуальных книг, например RSS-лент.
- Полномочия
нет- Хост сохраняет
- Связь с библиотекой, модель чтения, навигация и представление.
readerModesРасширения · v 1.0.0- Плагин может
- Предоставлять ограниченный режим сегментации предложений или абзацев. Пока только для встроенных плагинов.
- Полномочия
reader:modes- Хост сохраняет
- Управление ридером, жизненный цикл, отрисовка и навигация.
agentToolsРасширения · v 1.0.0- Плагин может
- Регистрировать именованный инструмент, который может вызвать помощник по чтению.
- Полномочия
agent:tools- Хост сохраняет
- Оркестрация, видимость инструментов, подтверждения и интерфейс транскрипта.
agentContextProvidersРасширения · v 1.0.0- Плагин может
- Возвращать ограниченные справочные блоки для текущего хода пользователя.
- Полномочия
agent:context- Хост сохраняет
- Происхождение, обрезка, размещение в промпте и время жизни.
agentRetrievalProvidersРасширения · v 1.0.0- Плагин может
- Предоставлять поисковый источник плагина как именованный инструмент агента.
- Полномочия
agent:retrieval- Хост сохраняет
- Схема запроса, ограничения, обрезка результатов и описание инструмента.
memoryCandidateProvidersРасширения · v 1.0.0- Плагин может
- Предлагать факты, предпочтения, идеи или сводки после хода.
- Полномочия
agent:memory- Хост сохраняет
- Проверка области, удаление дубликатов, принятие и запись долговременной памяти.
themesРасширения · v 1.0.0- Плагин может
- Предоставлять смысловые данные тем приложения и ридера.
- Полномочия
ui:themes- Хост сохраняет
- Проверка, генерация CSS, выбор и применение.
fontsРасширения · v 1.0.0- Плагин может
- Предоставлять одобренные метаданные шрифтов и встроенные файлы шрифтов.
- Полномочия
ui:themes- Хост сохраняет
- Проверка файлов, загрузка, пункты выбора и активный выбор.
storageСлужбы · v 1.0.0- Плагин может
- Использовать KV и коллекции документов в области плагина.
- Полномочия
нет- Хост сохраняет
- Изоляция пространств имён, сохранение, снимки и события изменений.
secretsСлужбы · v 1.0.0- Плагин может
- Хранить и получать учётные данные из секретных слотов плагина.
- Полномочия
нет- Хост сохраняет
- Шифрование, неразглашение и изоляция пространства имён.
uiСлужбы · v 1.0.0- Плагин может
- Показывать уведомление хоста или открывать поток сохранения и экспорта.
- Полномочия
нет- Хост сохраняет
- Представление, выбор пути и интеграция с платформой.
schedulesСлужбы · v 1.0.0- Плагин может
- Привязывать работу к периодической задаче из манифеста.
- Полномочия
нет- Хост сохраняет
- Периодичность, догон при запуске, предотвращение пересечений и освобождение.
sessionСлужбы · v 1.0.0- Плагин может
- Подписываться на ограниченные сведения о текущей сессии чтения.
- Полномочия
нет- Хост сохраняет
- Источник событий, ограничения полезной нагрузки и жизненный цикл подписки.
networkСлужбы · v 1.0.0- Плагин может
- Выполнять HTTP-запросы через нативный клиент хоста.
- Полномочия
service:network- Хост сохраняет
- Применение разрешений, транспорт и мост ответов.
llmСлужбы · v 1.0.0- Плагин может
- Выполнять ограниченные одноразовые текстовые или структурированные вызовы модели.
- Полномочия
service:llm- Хост сохраняет
- Настройка провайдера, учётные данные, обработка схем и ограничения.
clipboardСлужбы · v 1.0.0- Плагин может
- Записывать текст в системный буфер обмена.
- Полномочия
service:clipboard- Хост сохраняет
- Вызов платформы и контроль разрешений.
viewsСхемы · v 1.0.0- Плагин может
- Возвращать Markdown, списки, формы, детали и ограниченные деревья блоков.
- Полномочия
нет- Хост сохраняет
- Компоненты, безопасность HTML, макет, доступность и навигация.
settingsСхемы · v 1.0.0- Плагин может
- Объявлять поля настроек плагина, отображаемые хостом.
- Полномочия
нет- Хост сохраняет
- Поведение формы, проверка, маршрутизация хранилища и работа с секретами.
themesСхемы · v 1.0.0- Плагин может
- Объявлять смысловые токены тем и метаданные встроенных шрифтов.
- Полномочия
нет- Хост сохраняет
- Проверка грамматики, сгенерированный CSS, загрузка и выбор.
Как читать каталог
- Полномочия обозначают разрешение или точное предоставление настроек, необходимое во время вызова.
- Нет означает отсутствие дополнительного разрешения на установку, а не наличие неописанных скрытых полномочий.
- Хост сохраняет обозначает границу, которую плагин не может заменить или обойти.
- Версия рядом с каждой записью напрямую взята из канонического каталога возможностей хоста.
readerModes остаётся доступным только встроенным плагинам, пока не будет окончательно определён его привилегированный контракт ридера. Манифест может указывать только возможности из каталога; хост по-прежнему фильтрует видимое представление среды выполнения по актору, разрешению, версии и фазе жизненного цикла.
Предварительный просмотр разрешений
Вставьте манифест, чтобы отделить полномочия пользователя от совместимости и эксплуатационных деклараций. Это отражает смысл согласия на установку, но не заменяет валидатор репозитория и не доказывает, что плагин сможет активироваться.
Предпросмотр проверки
Полномочия пользователя · семантические разрешения
annotations:read— Читать выделения и заметки.agent:retrieval— Предоставлять помощнику доступный для поиска источник плагина.service:network— Выполнять сетевые запросы через хост.
Полномочия пользователя · точные предоставления настроек
- Обнаружить
appearance.theme - Читать
appearance.theme
Совместимость · не разрешения
- Домен
annotations^1.0.0 - Домен
settings^1.0.0 - Расширение
commands^1.0.0 - Расширение
agentRetrievalProviders^1.0.0 - Служба
storage^1.0.0 - Служба
schedules^1.0.0 - Служба
network^1.0.0 - Схема
settings^1.0.0
Эксплуатационные декларации · не разрешения
- Схема приватных данных:
1 - 1 периодическая задача
Что на самом деле предоставляет диалог установки
Семантические записи permissions и точные записи settingsAccess предоставляют полномочия. Поставляемый диалог согласия показывает оба типа простым языком. Требования возможностей, расписания, версия схемы, темы и шрифты полезны для проверки, но не переименовываются молча в разрешения.
Этот предпросмотр намеренно локален и не хранит состояние. Следующим шагом инструментов разработчика станет представление актора и инспектор жизненного цикла внутри приложения, основанные на тех же каталогах среды выполнения, с различиями разрешений при обновлении и точными причинами недоступности возможностей.