Skip to content

About

Локальная панель управления рутованной Яндекс Станцией: SSH, LED, звуки, Bluetooth, бэкапы и обновления

Topics

Resources

Security policy

Stars

13 stars

Watchers

1 watching

Forks

Repository files navigation

Alice Control Center

Alice Control Center

Локальная панель управления рутованной Яндекс Станцией с компьютера или телефона — для маленьких станций с Алисой: Лайт, Лайт 2 и семейство Мини. Vue 3 + TypeScript на фронтенде, Node.js + Express на backend, связь со станцией — по SSH. Браузер никогда не подключается к станции напрямую, не видит root-пароль и не хранит его.

Последний релиз Release workflow License: MIT Node.js 20+

Скачать: последний релиз · Telegram: @myloveiskeri

Панель рассчитана на собственную станцию в локальной сети. Не публикуйте backend, SSH или ADB в открытый интернет.

Что умеет

  • Setup Wizard — автопоиск колонки в сети (mDNS, ARP и опрос SSH-портов), проверка подключения, определение модели и возможностей, сохранение настройки.
  • Обзор — состояние, модель, прошивка, метрики, громкость, быстрые действия.
  • Системный монитор — CPU, память, температура, Wi-Fi, диски, процессы, fastfetch-подобная сводка.
  • Sound Studio — список системных звуков, замена с автоматическим бэкапом, восстановление, воспроизведение на станции и озвучка текста голосом Алисы.
  • LED Studio — цвет по зонам, готовые эффекты, произвольный FPS до 60, анимация выполняется на самой колонке; «Сброс» возвращает кольцо в состояние, которое было до эффекта.
  • Wi-Fi — сеть и пароль станции на главном экране, сканирование эфира и переключение между сетями без перезагрузки.
  • Bluetooth — сканирование, сопряжение, подключение, удаление устройств, режим поиска для телефона и голос Алисы в подключённых наушниках.
  • Файлы — просмотр и загрузка только в разрешённые каталоги.
  • Терминал — только команды из белого списка, опасные операции требуют подтверждения.
  • Бэкапы — конфигурация панели и файлы станции, проверка SHA-256, восстановление.
  • Автоматизация — сценарии из разрешённых действий с тринадцатью видами триггеров: подключение и отключение станции, перезагрузка, новый релиз, пороги метрик, громкость, Wi-Fi, Bluetooth, расписание, интервал и цепочка сценариев.
  • Fun Lab — готовые LED-сцены и ИИ-генератор через любой OpenAI-совместимый сервер: модель описывает сцену рецептом, а кадры считает панель, поэтому ответ проходит с первого раза.
  • Event Center — журнал операций с очисткой секретов; повторы одного события склеиваются в строку со счётчиком, а не занимают экран сотнями копий.
  • Плагины и YAM — просмотр состояния, без установки случайных бинарников.
  • Обновления — проверка релизов GitHub, SHA-256, резервная копия и откат при ошибке.
  • Установка и трей — установка одной командой, ярлык на рабочем столе, значок состояния с запуском и остановкой панели.
  • Оформление — Material You 3 Expressive, светлая/тёмная/системная тема, динамические акценты под цвет корпуса Алисы.
  • Приветствие — пошаговое знакомство, контакт автора в Telegram.

Поддерживаемые станции

Панель обещает полный набор функций маленьким станциям с Алисой. Модель определяется автоматически по hostname/model при подключении, а в «Настройках» её можно выбрать вручную — от этого зависит только образ колонки и акцентный цвет интерфейса, ни одна функция от выбора не включается и не выключается.

Семейство Модели
Лайт Лайт, Лайт 2
Мини Мини, Мини 3, Мини 3 Про, Мини с часами

Полный набор функций проверен на Станции Лайт 2 (Yandex Prune EVT2). На остальных маленьких станциях доступность LED, Bluetooth, системных звуков и отдельных путей зависит от прошивки.

Другие модели панель тоже подключает — диагностика, Files, Terminal, бэкапы и обновления работают, — но полный набор функций на них не проверен, и в списке моделей они не предлагаются.

Архитектура

Браузер (Vue 3, localhost:5173 или backend:8722)
        │  HTTP / WebSocket (локально; для телефона — токен)
        ▼
Backend (Node + Express, 127.0.0.1:8722, data/config.json)
        │  allowlist, zod, подтверждения, журнал
        ▼
StationAdapter (SSH, root@station:2222)
        ▼
Яндекс Станция (BusyBox, sysfs, /data, /system/vendor/quasar)

Backend по умолчанию слушает только 127.0.0.1. Доступ с телефона включается явно в настройках, при включении LAN-доступа требуется токен. Пароль SSH и ключи ИИ хранятся только в data/config.json с правами 0600, не попадают во frontend и в журнал.

Быстрый старт

Установка одной командой (Windows)

Откройте PowerShell и вставьте:

irm https://raw.githubusercontent.com/chrometechhype/alice-control-center/main/install.ps1 | iex

Установщик:

  • проверяет Node.js 20+ и при отсутствии предлагает поставить LTS через winget;
  • скачивает последний релиз GitHub и сверяет SHA-256 — без контрольной суммы установка отменяется;
  • ставит панель в %LOCALAPPDATA%\AliceControlCenter, сохраняя data/ при обновлении;
  • создаёт ярлык «Alice Control Center» на рабочем столе;
  • запускает панель на http://127.0.0.1:8722 и значок состояния в трее.

Права администратора не нужны. Другую папку можно задать перед запуском:

$env:ACC_INSTALL_DIR = 'D:\Apps\AliceControlCenter'
irm https://raw.githubusercontent.com/chrometechhype/alice-control-center/main/install.ps1 | iex

Нужна конкретная версия, а не последняя — например альфа 1.0.0-alpha.14:

$env:ACC_VERSION = 'v1.0.0-alpha.14'
irm https://raw.githubusercontent.com/chrometechhype/alice-control-center/main/install.ps1 | iex

Установка одной командой (Linux и macOS)

Нужны только Node.js 20+ и curl, остальное установщик сделает сам:

curl -fsSL https://raw.githubusercontent.com/chrometechhype/alice-control-center/main/install.sh | sh

Установщик:

  • проверяет Node.js 20+ и npm, без них останавливается с подсказкой;
  • скачивает последний релиз GitHub и сверяет SHA-256 — без совпадения контрольной суммы установка отменяется;
  • ставит панель в ~/.local/share/AliceControlCenter, сохраняя data/ при обновлении;
  • запускает панель в фоне на http://127.0.0.1:8722, журнал — acc.log в папке установки.

Установке нужен доступ к registry.npmjs.org: установщик скачивает зависимости и при обрыве повторяет попытку трижды. Если registry закрыт, настройте прокси или зеркало (npm config set registry …) и запустите установщик снова.

Другая папка или конкретная версия:

curl -fsSL https://raw.githubusercontent.com/chrometechhype/alice-control-center/main/install.sh | ACC_INSTALL_DIR="$HOME/Apps/AliceControlCenter" sh
curl -fsSL https://raw.githubusercontent.com/chrometechhype/alice-control-center/main/install.sh | ACC_VERSION=v1.0.0-alpha.14 sh

Значка в трее на Linux и macOS пока нет: панель запускает ~/.local/share/AliceControlCenter/acc-start.sh, останавливает kill $(cat ~/.local/share/AliceControlCenter/acc.pid).

Значок в трее

Ярлык запускает панель без окна консоли и показывает значок в области уведомлений:

Значок Состояние
зелёный панель работает, станция подключена
жёлтый панель работает, станция не подключена
серый панель остановлена

Правый клик — открыть, запустить, остановить или перезапустить панель, проверить обновления, открыть папку и журнал, скрыть значок. Двойной клик открывает панель. «Скрыть значок» оставляет backend работать, «Остановить панель и выйти» завершает и панель, и значок.

Готовый архив

  1. Скачайте Alice-Control-Center-<версия>.zip и Alice-Control-Center-<версия>.zip.sha256 со страницы Releases.

  2. Сверьте контрольную сумму:

    Windows:

    certutil -hashfile Alice-Control-Center-<версия>.zip SHA256

    macOS/Linux:

    sha256sum -c Alice-Control-Center-<версия>.zip.sha256
  3. Распакуйте архив в любую папку и запустите:

    • Windows: start.bat
    • macOS/Linux: ./start.sh

Текущая линия — 1.0.0-alpha.14; она публикуется как обычный релиз, поэтому лежит по ссылке «последний релиз» и приходит через автообновление.

Скрипт установит зависимости, соберёт frontend при необходимости и запустит backend на http://127.0.0.1:8722. Папка data/ создастся при первом запуске.

Требования: Node.js 20+ и npm, станция с включённым root-SSH в локальной сети. SFTP не требуется: панель работает через shell-каналы.

Из исходников

npm install
npm run dev

Production-сборка:

npm run build
npm start

После сборки backend отдаёт dist и API на одном порту: http://127.0.0.1:8722. Порт можно изменить переменной ACC_PORT.

Первое подключение

  1. Откройте «Мастер подключения».
  2. Нажмите «Найти колонку в сети» — панель опрашивает mDNS, таблицу ARP и SSH-порты (22, 2222) по локальным /24-сетям и сама подставляет адрес, порт и пользователя.
  3. Укажите пароль root — он сохранится только в data/config.json на этом компьютере.
  4. Нажмите проверку: панель подключится, определит модель, прошивку и доступные модули.
  5. Сохраните подключение.

Если станция позже получит новый IP от DHCP, панель найдёт её по MAC-адресу и переподключится сама — ручной правки адреса больше не требуется.

Пароль сохраняется только на этом компьютере в data/config.json. В исходниках и публичном архиве его нет.

Доступ с телефона

  1. «Настройки» → «Доступ с телефона» → включите «Разрешить доступ по локальной сети».
  2. Нажмите «Проверить сеть для телефона» — панель покажет адреса всех активных интерфейсов и пометит тот, который находится в одной /24-сети со станцией.
  3. Откройте этот адрес с телефона и вставьте токен (или отсканируйте QR-код).

LAN-доступ всегда защищён токеном. Выключайте его, когда он не нужен.

Если Wi-Fi раздаёт сам телефон. Станция и компьютер подключены к точке доступа телефона, а сам телефон сидит на мобильном интернете — роутер в этой схеме не участвует, весь трафик остаётся внутри сети телефона. Открывать нужно адрес интерфейса точки доступа (обычно 192.168.43.x или 172.20.x.x), панель помечает его как «сеть колонки». Если страница не грузится:

  • на телефоне не включайте «изолированный режим» / AP isolation — он запрещает устройствам видеть друг друга;
  • Windows часто помечает сеть точки доступа как «общедоступную», и брандмауэр не пускает входящие. Кнопка «Разрешить порт в брандмауэре» добавит правило TCP только для частной сети через запрос UAC;
  • мобильный трафик тут ни при чём: если телефон и компьютер в одной сети, адрес работает и без интернета.

Wi-Fi

  • Карточка обзора показывает сеть станции и настоящий пароль (psk) из /bkupgrade/data/wpa_supplicant.conf. Пароль скрыт за «глазом» и копируется одной кнопкой.
  • Вкладка Wi-Fi сканирует эфир через wpa_cli scan / scan_results и показывает уровень сигнала, шифрование и частоту.
  • «Подключить» дописывает блок network={…} в конфиг, сохраняя остальные блоки байт в байт, и применяет его через wpa_cli -i wlan0 reconfigure + reassociate — перезагрузка станции не нужна.
  • Сохранённые сети можно переключать и удалять; удаление текущей сети требует подтверждения.
  • Если на прошивке нет wpa_cli, вкладка честно говорит об этом, а не показывает выдуманный список.
  • Домашний Wi-Fi после переезда: панель помнит, через какую сеть пришла, и показывает её в «Настройках».

Сценарии

Сценарий — это последовательность шагов из действий панели (кольцо, звук, фраза Алисы, пауза, HTTP-запрос к лампе и т. п.), до 32 шагов. Связанные шаги можно выполнять одновременно: они стартуют в одном тике, поэтому кольцо и голос срабатывают вместе.

Триггер Когда срабатывает Настройка
manual по кнопке «Запустить» —
app.start при старте панели —
device.connect станция подключилась —
device.disconnect станция отключилась —
station.reboot станция перезагружается —
update.available вышел новый релиз панели один раз на версию
metrics метрика вышла за порог метрика, оператор, значение
volume громкость пересекла уровень > или <, процент
wifi смена сети станции событие, SSID
bluetooth устройство подключилось или ушло событие, MAC или имя
schedule в заданное время HH:MM и дни недели
interval каждые N минут, пока панель работает период
scenario.done завершился другой сценарий ID и «только при успехе»

Сценарии хранятся в data/scenarios.json на этом компьютере. Запуски попадают в Event Center.

Обновления

Панель проверяет последний релиз GitHub при запуске (кэш — 15 минут) и показывает баннер, если доступна новая версия. Ручная проверка — «Настройки» → «Обновления».

Установка:

  1. Панель скачивает ZIP-архив релиза по HTTPS.
  2. Проверяет SHA-256 из asset.digest GitHub или из файла .sha256 рядом с архивом.
  3. Распаковывает архив во временную папку и проверяет версию в package.json.
  4. Сохраняет резервную копию файлов панели в data/updates/backup-*.
  5. Запускает scripts/apply-update.mjs из распакованного архива (установленная копия — запасной вариант, если в архиве скрипта нет): он останавливает старый backend, копирует файлы, возвращает право +x всем .sh (ZIP не хранит Unix-права), при необходимости обновляет зависимости и запускает новый backend.
  6. При ошибке возвращает предыдущую версию. Папка data/ не затрагивается.

Если у релиза нет контрольной суммы, установка отменяется. Архивы с небезопасными путями, слишком большим размером или несовпадающей версией отклоняются. Обновление можно запустить вручную из ZIP-архива: распакуйте его поверх папки панели, сохранив data/, и запустите start.bat или start.sh.

Репозиторий проверки можно переопределить переменной ACC_GITHUB_REPO=owner/repo; для приватных форков доступен ACC_GITHUB_TOKEN. Обе переменные читаются только на backend.

Не запускайте панель под менеджером, который сам перезапускает процесс во время обновления: старый и новый backend могут одновременно занять порт. start.bat и start.sh этого не делают.

Bluetooth

  • Сканирование ограничено 20 секундами и выполняется через bluetoothctl.
  • «Подключить» идёт через D-Bus: Device1.Trust, при необходимости Device1.Pair, затем Device1.Connect. Интерактивный bluetoothctl на прошивке «Лайт 2» не поднимает агента и возвращает приглашение вместо результата, а D-Bus ждёт настоящего ответа BlueZ. Если устройство требует PIN, завершите сопряжение на самом устройстве: ACC не вводит PIN за вас.
  • Звук в наушниках. Когда подключается устройство с A2DP-профилем, панель переключает на него собственный вывод станции: голос Алисы и звуки сценариев играют в наушниках. В карточке устройства появляется метка «звук здесь», а баннер над списком возвращает звук в колонку одной кнопкой. Отключение наушников, удаление устройства и выключение адаптера возвращают звук в колонку; сторож делает то же, если наушники пропали сами, — в течение полуминуты. Переключение живёт в /tmp/asound-vol.conf и после перезагрузки станции звук снова в колонке. Яндекс Музыка в наушники не уходит: прошивка «Лайт 2» принимает исходящий A2DP-поток за Bluetooth-плеер, забирает звуковой фокус и останавливает музыку. Поэтому при включённом выводе в наушники музыкальное воспроизведение глушится самим quasar, а не панелью.
  • «Режим поиска» включает discoverable on и pairable on, чтобы телефон увидел станцию. Выключение возвращает discoverable off и pairable off.
  • «Забыть» удаляет устройство из списка после подтверждения.
  • Выключение адаптера требует подтверждения и может прервать работу пульта или приложения колонки.
  • На некоторых прошивках набор команд или имена адаптеров отличаются. Панель показывает вывод bluetoothctl и не имитирует недоступные функции.

Озвучка

Sound Studio умеет включать звук прямо на колонке, не меняя её библиотеку:

  • «Играть на станции» запускает уже существующий системный звук через первый доступный плеер (ffplay, mpv, gstreamer, paplay, aplay). Файл только читается, запись не выполняется.
  • «Сказать голосом Алисы» произносит текст штатным голосом станции. Панель отправляет фразу в локальный речевой сервис Алисы (AliceCapability → START_VOCALIZE на 127.0.0.1:9875) по тому же SSH-соединению; станция синтезирует её в облаке Яндекса и проигрывает своим плеером. Файлы не создаются, сторонние TTS и голосовые ключи не используются.
  • Интонацию Алиса берёт из самих знаков: «?» поднимает голос, «!» делает громче, запятые и точки дают паузы, «…» — длинную. Пробелы вокруг знаков панель поправляет сама, чтобы пауза не пропала. SSML станция не понимает — на проверке <speak>Да.</speak> прочиталось вместе с именами тегов, поэтому такую фразу панель отклоняет с объяснением, а не озвучивает.
  • Шаг сценария «сказать» говорит тем же голосом Алисы. ИИ-провайдер отвечает только за генерацию текста и сцен, а не за озвучку.
  • Фразы выполняются по очереди: два запроса не перемешиваются в одном сокете. Если ни socat, ни nc на прошивке нет или локальный IPC не отвечает, панель называет причину, а не выдаёт тишину за успех.
  • Конец фразы панель узнаёт по состоянию речи самой станции: события TTS, а на прошивках без них — кадр состояния, который появляется с началом проигрывания и пропадает с его концом. Если начало подтверждено, а конец — нет, панель так и сообщает, вместо ложного таймаута.
  • Плееры определяются один раз на подключение; если на станции не нашлось ни одного, кнопки воспроизведения готовых звуков заблокированы и показана причина.
  • Громкость берётся из ALSA. На максимальной громкости микрофон колонки может услышать собственный динамик и завизжать — это акустическая обратная связь станции, к панели она отношения не имеет.

Безопасность

Правила, на которых построен проект:

  • По умолчанию backend слушает только 127.0.0.1.
  • Доступ с телефона включается явно в настройках.
  • При включении LAN-доступа требуется авторизация.
  • Не сохраняй пароли в исходном коде.
  • Не копируй приватные ключи в проект.
  • Не сохраняй секреты в frontend.
  • Не добавляй пароли в URL.
  • Не выполняй произвольные shell-команды через незащищённый HTTP endpoint.
  • Проверяй пути файлов от обхода каталогов.
  • Не публикуй root-доступ, SSH или ADB в открытый интернет.
  • Не перезапускай всю станцию автоматически.
  • Все потенциально опасные операции должны требовать подтверждения.
  • Не скачивай и не запускай случайные бинарники.
  • Не устанавливай ничего на колонку без необходимости.

Дополнительно: CSP и security-заголовки, zod-валидация, белый список команд и путей, лимит размера загрузок, проверка magic-байтов, очистка журнала от секретов. Подробнее — SECURITY.md.

Модули

Модуль Что делает Ограничения
Обзор метрики, модель, громкость, быстрые действия —
Системный монитор CPU/RAM/температура/Wi-Fi/диски/процессы команды только для чтения
Sound Studio системные звуки, замена, бэкап только /system/vendor/quasar/sounds
LED Studio цвет, сцены, FPS 1–60 запись в /sys/class/leds
Wi-Fi сеть и пароль, скан, переключение нужен wpa_cli на прошивке
Bluetooth scan/pair/connect/forget/discoverable зависит от bluetoothctl на прошивке
Файлы чтение разрешённых каталогов, загрузка запись только /data/opt, /data/sounds
Терминал команды из белого списка без ;, |, $, перенаправлений
Бэкапы файлы станции и конфигурация панели SHA-256, лимит 32 МБ на файл
Автоматизация сценарии из действий панели, 13 триггеров без произвольного shell
Fun Lab сцены, свои кадры, без таймаута, ИИ-генератор нужен OpenAI-совместимый сервер; FPS выбирает модель
Event Center журнал операций секреты вычищаются
Плагины и YAM просмотр состояния установка не автоматизируется
Обновления GitHub Releases + SHA-256 + откат архив должен содержать package.json и scripts/apply-update.mjs

Совместимость

  • Полный набор функций проверен на Яндекс Станции Лайт 2 (Yandex Prune EVT2, прошивка 0.372.1.13, kernel 4.9.113, BusyBox 1.31.1).
  • Другие модели панель подключает через тот же SSH-адаптер, но полный набор функций на них не проверен — в списке моделей они не предлагаются.
  • SSH без SFTP (shell fallback), BusyBox sh, usleep, awk, sha256sum.
  • Светлая, тёмная и системная темы; динамические акценты по цвету корпуса.

Не поддерживается / не гарантируется

  • Установка сторонних APK, прошивок, модулей ядра и случайных бинарников.
  • Прямое управление ADB из браузера.
  • Публикация панели в интернет, root-доступ без токена.
  • Автоматический перезапуск станции.
  • Цвет корпуса и наличие часов нельзя прочитать программно: панель использует сохранённый выбор пользователя (по умолчанию — зелёный, без часов) и подстраивает акценты.
  • На некоторых прошивках Bluetooth-команды или отдельные sysfs-узлы могут отличаться.
  • 60 FPS — экспериментальный режим: кольцо может обновляться неравномерно, а долгая нагрузка способна перегрузить LED-контроллер. Для длительных сцен используйте 20–30 FPS.
  • Во время стресс-теста 60 FPS станция один раз перезагрузилась через несколько минут. Причина не подтверждена; панель сама станцию не перезапускает. Учитывайте это при долгих анимациях.
  • Панель не является официальным продуктом Яндекса.

Бэкапы и восстановление

  • Замена системного звука автоматически создаёт бэкап оригинала.
  • «Бэкапы» → создать бэкап конфигурации панели или выбранных файлов станции.
  • Каждый файл проверяется по SHA-256 при создании и восстановлении.
  • Восстановление пишет файл на станцию, выставляет права и повторно сверяет хеш.
  • Файлы бэкапов лежат в data/backups/ и не попадают в общий архив проекта.
  • Обновления панели складывают резервные копии в data/updates/ и хранят три последние.

Внешний вид и цвета

  • «Настройки» → «Образ станции»: цвет корпуса (зелёный, лавандовый, синий, розовый, коралловый, серый) и часы.
  • Выбор сохраняется в браузере (localStorage) и не меняет настройки колонки.
  • Акценты, фоны, карточки, кнопки, навигация и логотип подстраиваются под цвет Алисы через CSS color-mix.
  • Для моделей без кастомизации показывается официальное изображение, акценты берутся из палитры модели.
  • Приветствие можно открыть повторно: «Настройки» → «Приветствие» → «Показать».

Fun Lab и LED

  • Сцены отправляются на станцию одним запросом.
  • Backend генерирует shell-скрипт, записывает его в /tmp/acc-led-anim.sh и запускает через nohup.
  • Кадры пишутся в sysfs на самой колонке, без SSH-канала на каждый кадр — соединение остаётся стабильным.
  • Остановка — через PID-файл и stop-файл; после остановки можно вернуть штатный триггер led_ring_fb.
  • Переключатель «Работать без таймаута» повторяет сцену бесконечно — и для готовых, и для своих сохранённых сцен. Выключение — кнопками «Выключить» или «Штатный режим».
  • Свои сохранённые сцены выводятся отдельным блоком «Мои сцены» над готовыми сценами.
  • «ИИ-генератор» работает только через OpenAI-совместимый сервер, выбранный в настройках. Модель возвращает не кадры, а рецепт сцены: эффект, палитру, название, fps и число шагов. Кадры считает backend — детерминированно и с замкнутым циклом, — поэтому ответ не упирается в лимит токенов. Неполный или заваленный примером ответ чинится парсером, затем следует одна автоматическая повторная генерация; после успеха сцена сохраняется в «Мои сцены».
  • Встроенные пресеты: OpenAI, OpenRouter, Groq, Pollinations без ключа (около одного запроса в 30 секунд), локальные Ollama и LM Studio. В режиме «Свой сервер» можно вручную указать base URL, модель и ключ.
  • Описание сцены уходит только на выбранный вами сервер. Не пишите в него пароли и личные данные. API-ключ остаётся на backend.
  • Пресеты сохраняются в data/led-presets.json на компьютере.

Известные ограничения

  • SFTP на станции отсутствует; запись больших файлов идёт через shell и ограничена таймаутами.
  • Некоторые операции требуют root; панель не повышает привилегии и не обходит ограничения прошивки.
  • Метрики обновляются с выбранным интервалом (по умолчанию 5 с), это не realtime-мониторинг.
  • При обрыве Wi-Fi возможны переподключения; статус виден в шапке и Event Center.
  • ИИ-генератор зависит от выбранного сервера и интернета (кроме локальных Ollama/LM Studio). Качество сцены определяется моделью; при ошибке панель показывает причину и не подменяет результат локальным алгоритмом.
  • Проверка обновлений обращается к GitHub. При отсутствии интернета панель показывает ошибку, но продолжает работать.
  • Панель не является официальным продуктом Яндекса.

Разработка и релизы

npm run dev        # backend + Vite
npm run build      # vue-tsc + production build
npm test           # unit-тесты
npm run package    # release/alice-control-center + ZIP + SHA-256

Версия хранится в package.json. Релиз публикуется тегом vX.Y.Z (альфа-линия — vX.Y.Z-alpha.N): workflow release.yml собирает проект, запускает тесты, упаковывает release/Alice-Control-Center-X.Y.Z.zip и прикладывает архив с .sha256 к GitHub Release. Степень зрелости видна в самой версии, поэтому тег с - публикуется как обычный релиз и попадает в «последний».

npm version patch
git push --follow-tags

Если релиз создаётся вручную:

npm run build
npm run package
gh release create v1.0.0-alpha.14 release/Alice-Control-Center-1.0.0-alpha.14.zip \
  release/Alice-Control-Center-1.0.0-alpha.14.zip.sha256 \
  --title "Alice Control Center 1.0.0 Alpha 14" \
  --notes-file docs/release-notes/1.0.0-alpha.14.md

Список изменений — CHANGELOG.md.

Структура

server/        Express backend, SSH-адаптер, allowlist, бэкапы, LED, обновления
shared/        общие типы
src/           Vue-приложение, компоненты, стили, store
public/        официальные изображения станций, аватар Telegram
tests/         unit-тесты парсеров, безопасности, определения модели
scripts/       apply-update.mjs, упаковка релиза, служебные скрипты
docs/          технические заметки, тизер, release notes
data/          создаётся при запуске: config.json, бэкапы, журнал (не коммитить)

Диагностика

  • «Event Center» — последние операции и ошибки.
  • «Системный монитор» — нагрузка, температура, Wi-Fi RSSI.
  • Проверка SSH: «Мастер подключения» → проверить соединение.
  • Если backend не стартует, проверьте, что порт 8722 свободен (ACC_PORT меняет порт).
  • Логи backend выводятся в консоль процесса npm run dev / npm start.
  • Логи обновления: data/updates/last-update.log и data/logs/update-process.log.

Полная отладка (--full-debug)

Один прогон собирает в data/reports/full-debug-<дата>.txt всё, что нужно, чтобы понять, почему служба упала или станция ведёт себя странно:

  • ядро и причина прошлой перезагрузки, dmesg и выборка ошибок/OOM/segfault;
  • журналы демонов из /data/quasar/daemons_logs, /data/quasar/logs и /data/log;
  • процессы Quasar и YAM (/proc/PID/cmdline, состояние, потоки, RSS) и ps;
  • дамп ОЗУ: /proc/meminfo, vmstat, buddyinfo, zoneinfo и 30 самых тяжёлых процессов;
  • скорость диска: запись 32 МиБ с fsync, чтение и перезапись через dd;
  • сеть, открытые порты, Bluetooth, температура и wpa_supplicant.conf со статусом wpa_cli.
start.bat --full-debug
npm run debug:full        # из папки проекта
./full-debug.sh --full-debug

Каждая секция выполняется отдельно: упавшая команда не отменяет остальные, а в отчёте у неё появляется причина. Пароли Wi-Fi (psk) маскируются на стороне панели и не попадают в файл в открытом виде; пароль SSH не печатается вовсе. Работает только при сохранённом подключении по SSH — та же панель должна сначала увидеть станцию («Мастер подключения»).

Контакт

Telegram: @myloveiskeri — предложения, баги, вопросы. GitHub: chrometechhype/alice-control-center.

Лицензия: MIT. Панель не является официальным продуктом Яндекса.

About

Локальная панель управления рутованной Яндекс Станцией: SSH, LED, звуки, Bluetooth, бэкапы и обновления

Topics

Resources

Security policy

Stars

13 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages