Система плагинов
Плагины ReadAware компонуют возможности, которые предоставляет настольный хост. Они могут работать с книгами, состоянием чтения, аннотациями, разговорами и памятью; добавлять действия и провайдеров; и использовать ограниченные хост-сервисы.
Эта документация соответствует исходному коду разработки. Сопоставляйте требования к возможностям с установленным приложением перед сборкой или публикацией.
Выберите семейство возможностей
| Семейство | Используйте для | Примеры |
|---|---|---|
| Домены | Данные и поведение, принадлежащие ReadAware | Библиотека, чтение, аннотации, разговоры, настройки, память |
| Вклады | Новые действия, варианты выбора или реализации провайдеров | Команды, контекстные действия, голоса, источники контента, инструменты ассистента, темы |
| Сервисы | Операции хоста и частные механизмы плагина | Ресурсы, сеть, инференс, хранилище, расписания, задания, транзакции |
| Схемы | Данные, которые хост отображает или интерпретирует | Представления, формы настроек, темы |
Используйте Проводник возможностей для поиска фактических методов, понимания границ и создания манифеста. Справочник API объясняет, как семейства компонуются.
Начните с задачи читателя
- Поиск и навигация: используйте поиск по источникам библиотеки и чтение диапазонов, затем навигацию по чтению с защитой текущей сессии.
- Сбор и просмотр заметок: запрашивайте или наблюдайте за аннотациями; условные изменения сохраняют более новые правки.
- Работа с памятью чтения: используйте запросы памяти и авторизованные команды для воспоминаний, классификации, профилей, сущностей, графов и контекстных пакетов.
- Помощь в разговоре: читайте авторизованные стенограммы и резюме, предлагайте ход разговора для одобрения хостом или регистрируйте инструмент ассистента.
- Автоматизация рабочего процесса: комбинируйте расписания, ограниченные курсоры изменений, поддерживаемые долговечные задания и локальные транзакции.
- Привлечение внешнего контента: используйте сетевой доступ с ограничением по источнику, провайдеров контента и защищенные ресурсы вместо обходных путей через файловую систему или браузер.
Разрешения, версии и гранты на объекты
Это отдельные проверки:
requiresобъявляет совместимые версии возможностей.permissions,settingsAccessиnetworkAccessобъявляют полномочия.- Грант на книгу пользователя ограничивает исполнителя всеми книгами, текущей книгой или указанной книгой.
- Жизненный цикл и текущие условия выполнения определяют, доступна ли конкретная операция сейчас.
Сервис, свободный от разрешений, все равно может требовать другой доменный грант для конкретного метода. Успешный запрос доступности — это подсказка, а не разрешение обойти проверку выполнения.
Интерфейсы, отображаемые хостом
Плагины возвращают структурированные представления и обратные вызовы. ReadAware владеет отрисовкой, фокусом, навигацией, состояниями загрузки и ошибок, темами и очисткой. Представления могут включать списки, формы, макеты деталей и ограниченные блоки, с живыми обновлениями через публичный контракт представлений.
Плагины не монтируют React, произвольный HTML, CSS, iframes или DOM. Используйте поддерживаемую точку вклада для нового поведения интерфейса.
Изоляция и жизненный цикл
Каждый плагин работает в модульном воркере. Он не получает прямого доступа к Tauri, SQLite, файловой системе, процессу или DOM. Сеть и хранилище используют контекст, опосредованный хостом.
Этапы активации регистрируют и разрешают поддерживаемые чтения; бизнес-записи и внешние побочные эффекты начинаются с активных обработчиков. Миграция частных данных выполняется с полномочиями только на хранилище. Неудачная активация или миграция откатывается до того, как кандидат заменит текущую среду выполнения.
Установка по-прежнему является решением о доверии к программному обеспечению. Проверьте исходный код пакета, запрошенные полномочия, сетевые назначения и обработку данных.
Учитесь на примере плагинов первой стороны
Дерево исходного кода содержит рабочие примеры, такие как Jumper, Dictionary и Sentence Reader, наряду с встроенными плагинами. Примеры из исходников не являются обещанием, что каждый пакет поставляется в каждом релизе.