Meshyface

Meshyface — это чат-ориентированная панель управления Meshtastic, которая работает как один Python-сервис и предоставляет одностраничный веб-интерфейс по HTTP.

Текущая функциональность приложения

Текущий интерфейс предоставляет:

• Чат и прямые разговоры с узлами
• Рабочее пространство сети: карта, обзор, связи, маршруты, датчики, Топ-10, детали узлов и история по запросу
• Рабочее пространство консоли: вывод пакетов/логов в реальном времени
• Рабочее пространство приложений: Игры и вкладка Файлы (при включённой передаче файлов)
• Рабочее пространство настроек: панели радио, устройства, подключения, местоположения, каналов, тикеров, списков, внешнего вида и о программе
• История на SQLite, поиск, сводки, сохранение темы и сохранение пользовательских правил телеметрии

Рабочее пространство консоли

Рабочее пространство консоли — это управляющая поверхность в стиле терминала для пакетного трафика, поиска по истории и утилит сети.

• Введите имя команды, чтобы открыть подсказки автодополнения. Используйте Tab или Enter для принятия, ArrowRight для принятия призрачного суффикса, и ArrowUp / ArrowDown для перемещения по всплывающему окну.
• Команды, принимающие цель-узел, показывают подробные предложения узлов с именем, ID, эмодзи, тегом, статусом, прыжками, GPS, временем последнего приёма, портами и номером узла. Обычный текст сужает поиск по именам и тегам узлов; ! сужает по ID узла.
• live транслирует пакетный трафик до нажатия Ctrl+C или q. Используйте live grep <текст>, live rg <текст>, live filter=<текст> или просто live <текст>, чтобы транслировать только соответствующие группы пакетов. Фильтры уровня и детализации всё ещё применяются, например live rg TEXT_MESSAGE_APP -vv --layer=2.
• grep <текст> и rg <текст> ищут в сохранённой истории пакетов/чата с окнами контекста, лимитами, фильтрами источника пакетов/чата и фильтрами области сводки/пакета.
• /search <текст> фильтрует видимый вывод консоли из приглашения, не запуская поиск по сохранённой истории.

Скриншоты

Карта сети в реальном времени

Вид карты с местоположениями узлов, связями, общими путями, кластерами и тепловой картой сигнала.

Обзор сети

Вид истории для количества узлов, статуса онлайн, новых узлов и отчётов о местоположении.

Топология связей

Вид топологии, показывающий наблюдаемые связи от выбранного корневого узла.

Трассировка маршрута

Вид трассировки для источника, назначения, ближайших связей и деталей пакетов по прыжкам.

История датчиков

Диаграмма телеметрии, сравнивающая историю датчиков для нескольких узлов.

Карточки статуса

Верхние карточки: активность радио, количество узлов, пакеты, связи, батарея и использование каналов.

Настройка тем

Темы могут преобразить всю панель управления с помощью пользовательских цветов, градиентов, прозрачности, размытия, шрифтов, частиц или фона с живой картой. Эти примеры палитр — пользовательские темы; выберите любой превью, чтобы открыть полноразмерный скриншот.

Сигнальный зелёный	Неоновый малиновый	Реле Авроры

Общие внешние виды узлов

Узлы Meshyface могут обмениваться компактными пакетами внешнего вида, содержащими рецепт темы узла и необязательный призрак или водяной знак. Настройте и просмотрите свой узел в Настройки > Внешний вид > Внешний вид узла, включите Делиться внешним видом узла, затем используйте Транслировать внешний вид для публикации.

• Пакеты внешнего вида используют настроенный канал отправки профилей и наследуют настройку лимита прыжков радио; Meshyface не накладывает отдельный лимит прыжков.
• Полученные внешние виды могут стилизовать идентичности узлов в чате, списках, деталях узлов, картах, графиках, датчиках и тикерах без замены собственной темы принимающей панели.
• Отключение Делиться внешним видом узла отключает обе стороны функции. Оно останавливает трансляции и обходит путь получения профилей до того, как входящие полезные нагрузки внешнего вида будут декодированы, кэшированы или сохранены; кэшированные общие внешние виды очищаются, и ни один полученный внешний вид не отображается.
• Когда история включена, полученные профили и локальная настройка обмена сохраняются в базе данных SQLite истории.
• Общие внешние виды — это косметические метаданные. Полученный внешний вид не меняет настройки радио, каналы или сохранённый пакет темы панели.

Архитектура системы

flowchart LR
  Browser["Browser<br/>single-page UI"]
  CDN["Vendored browser assets<br/>Leaflet + leaflet.heat + particles.js"]
  Tiles["Basemap provider<br/>OpenStreetMap tile service"]
  Server["ThreadingHTTPServer<br/>HTML shell + JSON API"]
  Assets["Python template assembly<br/>meshdash/html* + meshdash/assets/*"]
  State["State loaders<br/>live snapshot + history readers"]
  Services["Write services<br/>chat, settings, tools, games, optional files"]
  Tracker["DashboardTracker<br/>live receive path + in-memory buffers"]
  History["HistoryStore / SQLite (WAL)<br/>chat, packets, rollups, settings"]
  Radio["Meshtastic interface<br/>serial or TCP"]
  Mesh["Meshtastic radio / mesh"]
  Atlas["Bundled offline atlas<br/>reference basemap fallback"]

  Browser -->|GET /| Server
  Browser -->|GET /api/*| Server
  Browser -->|POST write APIs| Server
  Browser --> CDN
  Browser --> Tiles
  Browser -->|fallback basemap data| Atlas
  Server --> Assets
  Server --> State
  Server --> Services
  State <--> Tracker
  State <--> History
  Services <--> History
  Services <--> Radio
  Radio <--> Mesh
  Radio -->|receive callbacks| Tracker

Установка

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