ReadAware

Система плагинов

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

Эта документация соответствует исходному коду разработки. Сопоставляйте требования к возможностям с установленным приложением перед сборкой или публикацией.

Выберите семейство возможностей

СемействоИспользуйте дляПримеры
ДоменыДанные и поведение, принадлежащие ReadAwareБиблиотека, чтение, аннотации, разговоры, настройки, память
ВкладыНовые действия, варианты выбора или реализации провайдеровКоманды, контекстные действия, голоса, источники контента, инструменты ассистента, темы
СервисыОперации хоста и частные механизмы плагинаРесурсы, сеть, инференс, хранилище, расписания, задания, транзакции
СхемыДанные, которые хост отображает или интерпретируетПредставления, формы настроек, темы

Используйте Проводник возможностей для поиска фактических методов, понимания границ и создания манифеста. Справочник API объясняет, как семейства компонуются.

Начните с задачи читателя

  • Поиск и навигация: используйте поиск по источникам библиотеки и чтение диапазонов, затем навигацию по чтению с защитой текущей сессии.
  • Сбор и просмотр заметок: запрашивайте или наблюдайте за аннотациями; условные изменения сохраняют более новые правки.
  • Работа с памятью чтения: используйте запросы памяти и авторизованные команды для воспоминаний, классификации, профилей, сущностей, графов и контекстных пакетов.
  • Помощь в разговоре: читайте авторизованные стенограммы и резюме, предлагайте ход разговора для одобрения хостом или регистрируйте инструмент ассистента.
  • Автоматизация рабочего процесса: комбинируйте расписания, ограниченные курсоры изменений, поддерживаемые долговечные задания и локальные транзакции.
  • Привлечение внешнего контента: используйте сетевой доступ с ограничением по источнику, провайдеров контента и защищенные ресурсы вместо обходных путей через файловую систему или браузер.

Разрешения, версии и гранты на объекты

Это отдельные проверки:

  1. requires объявляет совместимые версии возможностей.
  2. permissions, settingsAccess и networkAccess объявляют полномочия.
  3. Грант на книгу пользователя ограничивает исполнителя всеми книгами, текущей книгой или указанной книгой.
  4. Жизненный цикл и текущие условия выполнения определяют, доступна ли конкретная операция сейчас.

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

Интерфейсы, отображаемые хостом

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

Плагины не монтируют React, произвольный HTML, CSS, iframes или DOM. Используйте поддерживаемую точку вклада для нового поведения интерфейса.

Изоляция и жизненный цикл

Каждый плагин работает в модульном воркере. Он не получает прямого доступа к Tauri, SQLite, файловой системе, процессу или DOM. Сеть и хранилище используют контекст, опосредованный хостом.

Этапы активации регистрируют и разрешают поддерживаемые чтения; бизнес-записи и внешние побочные эффекты начинаются с активных обработчиков. Миграция частных данных выполняется с полномочиями только на хранилище. Неудачная активация или миграция откатывается до того, как кандидат заменит текущую среду выполнения.

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

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

Учитесь на примере плагинов первой стороны

Дерево исходного кода содержит рабочие примеры, такие как Dictionary, RSS Reader и Sentence Reader, наряду с встроенными плагинами. Примеры из исходников не являются обещанием, что каждый пакет поставляется в каждом релизе.

Создать плагин · Справочник API · Публикация