Локальная панель управления рутованной Яндекс Станцией с компьютера или телефона — для маленьких станций с Алисой: Лайт, Лайт 2 и семейство Мини. Vue 3 + TypeScript на фронтенде, Node.js + Express на backend, связь со станцией — по SSH. Браузер никогда не подключается к станции напрямую, не видит root-пароль и не хранит его.
Скачать: последний релиз · 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 и в журнал.
Откройте 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Нужны только 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 работать, «Остановить панель и выйти» завершает и панель, и значок.
-
Скачайте
Alice-Control-Center-<версия>.zipиAlice-Control-Center-<версия>.zip.sha256со страницы Releases. -
Сверьте контрольную сумму:
Windows:
certutil -hashfile Alice-Control-Center-<версия>.zip SHA256
macOS/Linux:
sha256sum -c Alice-Control-Center-<версия>.zip.sha256
-
Распакуйте архив в любую папку и запустите:
- Windows:
start.bat - macOS/Linux:
./start.sh
- Windows:
Текущая линия — 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- Frontend: http://localhost:5173
- Backend: http://127.0.0.1:8722
- Vite проксирует
/apiи/wsна backend.
Production-сборка:
npm run build
npm startПосле сборки backend отдаёт dist и API на одном порту: http://127.0.0.1:8722.
Порт можно изменить переменной ACC_PORT.
- Откройте «Мастер подключения».
- Нажмите «Найти колонку в сети» — панель опрашивает mDNS, таблицу ARP и SSH-порты
(
22,2222) по локальным /24-сетям и сама подставляет адрес, порт и пользователя. - Укажите пароль root — он сохранится только в
data/config.jsonна этом компьютере. - Нажмите проверку: панель подключится, определит модель, прошивку и доступные модули.
- Сохраните подключение.
Если станция позже получит новый IP от DHCP, панель найдёт её по MAC-адресу и переподключится сама — ручной правки адреса больше не требуется.
Пароль сохраняется только на этом компьютере в data/config.json. В исходниках и публичном
архиве его нет.
- «Настройки» → «Доступ с телефона» → включите «Разрешить доступ по локальной сети».
- Нажмите «Проверить сеть для телефона» — панель покажет адреса всех активных интерфейсов и пометит тот, который находится в одной /24-сети со станцией.
- Откройте этот адрес с телефона и вставьте токен (или отсканируйте QR-код).
LAN-доступ всегда защищён токеном. Выключайте его, когда он не нужен.
Если Wi-Fi раздаёт сам телефон. Станция и компьютер подключены к точке доступа телефона, а сам
телефон сидит на мобильном интернете — роутер в этой схеме не участвует, весь трафик остаётся внутри
сети телефона. Открывать нужно адрес интерфейса точки доступа (обычно 192.168.43.x или 172.20.x.x),
панель помечает его как «сеть колонки». Если страница не грузится:
- на телефоне не включайте «изолированный режим» / AP isolation — он запрещает устройствам видеть друг друга;
- Windows часто помечает сеть точки доступа как «общедоступную», и брандмауэр не пускает входящие. Кнопка «Разрешить порт в брандмауэре» добавит правило TCP только для частной сети через запрос UAC;
- мобильный трафик тут ни при чём: если телефон и компьютер в одной сети, адрес работает и без интернета.
- Карточка обзора показывает сеть станции и настоящий пароль (
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 минут) и показывает баннер, если доступна новая версия. Ручная проверка — «Настройки» → «Обновления».
Установка:
- Панель скачивает ZIP-архив релиза по HTTPS.
- Проверяет SHA-256 из
asset.digestGitHub или из файла.sha256рядом с архивом. - Распаковывает архив во временную папку и проверяет версию в
package.json. - Сохраняет резервную копию файлов панели в
data/updates/backup-*. - Запускает
scripts/apply-update.mjsиз распакованного архива (установленная копия — запасной вариант, если в архиве скрипта нет): он останавливает старый backend, копирует файлы, возвращает право+xвсем.sh(ZIP не хранит Unix-права), при необходимости обновляет зависимости и запускает новый backend. - При ошибке возвращает предыдущую версию. Папка
data/не затрагивается.
Если у релиза нет контрольной суммы, установка отменяется. Архивы с небезопасными путями,
слишком большим размером или несовпадающей версией отклоняются. Обновление можно запустить
вручную из ZIP-архива: распакуйте его поверх папки панели, сохранив data/, и запустите
start.bat или start.sh.
Репозиторий проверки можно переопределить переменной ACC_GITHUB_REPO=owner/repo; для приватных
форков доступен ACC_GITHUB_TOKEN. Обе переменные читаются только на backend.
Не запускайте панель под менеджером, который сам перезапускает процесс во время обновления: старый и новый backend могут одновременно занять порт.
start.batиstart.shэтого не делают.
- Сканирование ограничено 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, kernel4.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. - Для моделей без кастомизации показывается официальное изображение, акценты берутся из палитры модели.
- Приветствие можно открыть повторно: «Настройки» → «Приветствие» → «Показать».
- Сцены отправляются на станцию одним запросом.
- 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.
Один прогон собирает в 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-debugnpm run debug:full # из папки проекта
./full-debug.sh --full-debugКаждая секция выполняется отдельно: упавшая команда не отменяет остальные, а в отчёте у неё
появляется причина. Пароли Wi-Fi (psk) маскируются на стороне панели и не попадают в файл в
открытом виде; пароль SSH не печатается вовсе. Работает только при сохранённом подключении по SSH —
та же панель должна сначала увидеть станцию («Мастер подключения»).
Telegram: @myloveiskeri — предложения, баги, вопросы. GitHub: chrometechhype/alice-control-center.
Лицензия: MIT. Панель не является официальным продуктом Яндекса.
