- API 4 · Python 3.12ПлагиныНовое умение внутри Рины: фраза, своя вкладка, плитка на главном экране, инструменты для ядра.
- Протокол 1 · именованные каналыПротокол ядраСвоя программа рядом с ядром: оболочка, голосовой клиент, интеграция. Всё, что умеет Рина, выражено его методами и событиями.
Что выбрать
Плагин живёт внутри Рины. Его запускает ядро, пользователь включает его в списке плагинов, а работает он через хуки и инструменты. Это путь для нового умения: курс валют, заметки, пересчёт единиц.
Протокол нужен тому, кто пишет программу снаружи: другое окно, другой голосовой вход, связку с чем-то своим. Ядро — отдельный процесс на Python, оболочка на C# говорит с ним по двум именованным каналам, и ваша программа может занять её место.
С чего начать
- Плагин: первый плагин в десять строк и пример целиком.
- Протокол: каналы и кадры, конверт и рукопожатие.
- Граница безопасности: модель угроз, поверхность плагинов.
Документы программы
Решения, из которых выросли эти страницы, лежат в репозитории:
- Архитектура — как устроены оболочка, ядро и плагины;
- ADR 0010, API плагинов — почему плагин объявляет, а ядро решает;
- ADR 0002, транспорт — почему именованные каналы;
- ADR 0004, версии — как растут версии;
- PAGE-SCHEMA-v2 — схема вкладки плагина;
- Безопасность EN и как участвовать EN.
Где спросить
Вопросы — в обсуждениях, поломки — в задачах на GitHub. Если нашли в API то, что расходится с этими страницами, это тоже поломка: страницы собираются из кода и должны с ним совпадать.