Панель splify2: правила, выходы, подписки, DNS, запросы и диагностика на одной странице. Плагин splify2 и приложение для компьютера
Andromeda — интерфейс splify2 для роутера на OpenWrt. С 26.11 это плагин andromeda
(тип plugin, архив .s2p), а не часть пакета splify2: пакет splify2 несёт каркас на классическом LuCI JS и кладёт архив
Andromeda в семя /usr/share/splify2/seed/, откуда его ставит при установке и обновлении. Адрес страницы Сервисы → splify2
не меняется; какой интерфейс открывать — Andromeda или каркас («Basic»), выбирают в «Настройки → Интерфейс», а ?basic=1 в адресе
всегда открывает каркас.
В репозитории два проекта:
| Каталог | Что |
|---|---|
ui/ |
панель: React (на сборке — preact), vite, Tailwind, vitest. Исходники, дизайн-система ui/andromeda/ |
desktop/ |
приложение для компьютера (Electron): та же панель в своём окне, вход по паролю через API splify2 на роутере |
plugin/ |
то, что делает панель плагином: манифест, схема настроек, словари en/ru, вид LuCI luci/home.js |
Только через публичный API платформы (plugin-sdk: docs/splify2-api.md,
docs/splify2-api-1.1.md, docs/host-api.md, docs/manifest.md):
- Главный экран —
splify2.luci.interfaceв манифесте (splify2-api 1.1): каталогluci/плагина раздаётся какview/splify2/p-andromeda/, и видluci/home.jsгрузит бандл рядом с собой. - Методы — только публичные методы объекта
splify2(списокmethods.tsvв SDK); вынесенные из каркаса в плагины (списки, подписки, архив настроек, проверка узлов, обновление) называют плагин-владельца, и он указан вrequires.plugins.tests/plugin.shсверяет вызовыui/src/lib/rpc.tsс этим списком. - Каталоги хоста (списки, спека, подписки) — методом
paths; в коде нет зашитых/etc/steer/…. - Настройки — схема
plugin/settings.schema.json(setup_wizard,quick_start), значения читаетplugin_settings_get. Одна схема — форма и в каркасе, и здесь. - Тексты —
plugin.nameиplugin.descriptionвplugin/i18n/{en,ru}.json; строки самой панели —ui/src/copy, их переводы языковых плагинов (lang-ru,lang-enв splify2) сверяетtests/frame-sync.sh. - Плагины для панели (вкладка «Плагины», слоты, темы) — host-api v1: его хозяин — Andromeda.
Нужны node ≥ 20.19 и инструмент s2p из plugin-sdk (sh build.sh там даёт bin/s2p).
export PLUGIN_SDK=../plugin-sdk
sh build.sh # ui -> plugin -> s2p lint --official -> out/andromeda-<версия>-all.s2p
S2P_KEY=ключ.sec sh build.sh # с подписью (выпуск)
sh tests/run.sh # lint, tsc, vitest панели и приложения, плагин, сверка с splify2 (SPLIFY2=<каталог>)
cd ui && npm run dev # dev-сервер панели; вызовы ubus вне LuCI падают вслухНа роутере с ядром steer 2.1 и splify2 26.11: steer plugin install --file out/andromeda-26.11.0-all.s2p --unsigned
(без подписи — только для разработки). В обычной жизни архив приезжает семенем пакета splify2.
Устройство панели — ui/README.md, приложения — desktop/README.md.
Репозиторий выделен из ui/ и desktop/ репозитория splify2 (ветка plugins) с сохранением истории коммитов.