Meshyface

Meshyface è una dashboard Meshtastic incentrata sulla chat che gira come un singolo servizio Python e serve un'interfaccia web a pagina singola su HTTP.

Superficie attuale dell'app

L'interfaccia attuale espone:

• Chat e conversazioni dirette con i peer
• Workspace Network per mappa, panoramica, collegamenti, rotte, sensori, classifiche Top 10, dettagli dei nodi e cronologia on-demand
• Workspace Console per output live di pacchetti/log
• Workspace Apps con Giochi e una scheda File quando il trasferimento file è abilitato
• Workspace Impostazioni con riquadri per radio, dispositivo, connettività, posizione, canali, ticker, elenchi, aspetto e informazioni
• Cronologia basata su SQLite, ricerca, riepiloghi, persistenza del tema e persistenza di regole di telemetria personalizzate

Workspace Console

Il Workspace Console è una superficie di controllo in stile terminale per il traffico dei pacchetti, la ricerca nella cronologia e i comandi di utilità della mesh.

• Digita un nome di comando per aprire i suggerimenti di autocompletamento. Usa Tab o Enter per accettare, ArrowRight per accettare il suffisso fantasma e ArrowUp / ArrowDown per spostarti nel popup.
• I comandi che accettano un nodo come destinazione mostrano suggerimenti ricchi con nome, ID, emoji, tag, stato, hop, GPS, ultimo ascolto, porte e numero del nodo. Il testo normale restringe per nomi e tag dei nodi; ! restringe per ID del nodo.
• live trasmette il traffico dei pacchetti fino a Ctrl+C o q. Usa live grep <text>, live rg <text>, live filter=<text> o il semplice live <text> per trasmettere solo i gruppi di pacchetti live corrispondenti. I filtri di livello e verbosità vengono comunque applicati, ad esempio live rg TEXT_MESSAGE_APP -vv --layer=2.
• grep <text> e rg <text> cercano nella cronologia persistente di pacchetti/chat con finestre di contesto, limiti, filtri sulla fonte di pacchetti/chat e filtri di ambito riepilogo/pacchetto.
• /search <text> filtra l'output visibile della console dal prompt senza avviare una ricerca nella cronologia persistente.

Screenshot

Mappa di rete live

Vista mappa con posizioni dei nodi, collegamenti, percorsi comuni, cluster e mappa di calore del segnale.

Panoramica della rete

Vista cronologia per conteggio dei nodi, stato online, nuovi nodi e rapporti di posizione.

Topologia dei collegamenti

Vista topologia che mostra i collegamenti osservati dal nodo radice selezionato.

Tracciamento delle rotte

Vista tracciamento per una sorgente, una destinazione, i collegamenti vicini e i dettagli dei pacchetti hop-per-hop.

Cronologia dei sensori

Grafico di telemetria che confronta la cronologia dei sensori su più nodi.

Schede di stato

Schede principali per attività radio, conteggio dei nodi, pacchetti, collegamenti, batteria e uso dei canali.

Personalizzazione del tema

I temi possono rimodellare l'intera dashboard con colori personalizzati, gradienti, trasparenza, sfocatura, font, particelle o uno sfondo a mappa live. Queste palette di esempio sono temi personalizzati; seleziona una qualsiasi anteprima per aprire lo screenshot a piena risoluzione.

Signal Green	Neon Magenta	Aurora Relay

Aspetti condivisi dei nodi

I nodi Meshyface possono condividere pacchetti di aspetto compatti contenenti una ricetta per il tema del nodo e un eventuale ghost o filigrana. Configura e visualizza in anteprima il tuo nodo in Settings > Appearance > Node Appearance, abilita Condividi aspetto del nodo, quindi usa Trasmetti aspetto per pubblicarlo.

• I pacchetti di aspetto usano il canale di invio dei Profili configurato ed ereditano l'impostazione del limite di hop della radio; Meshyface non impone un limite di hop separato.
• Gli aspetti ricevuti possono stilizzare le identità dei nodi in chat, elenchi, dettagli dei nodi, mappe, grafici, sensori e ticker senza sostituire il tema della dashboard ricevente.
• Disattivare Condividi aspetto del nodo disabilita entrambi i lati della funzionalità. Interrompe le trasmissioni e bypassa il percorso di ricezione dei profili prima che i payload di aspetto in arrivo vengano decodificati, memorizzati nella cache o resi persistenti; gli aspetti condivisi in cache vengono cancellati e nessun aspetto ricevuto viene renderizzato.
• Quando la cronologia è abilitata, i profili ricevuti e la preferenza di condivisione locale persistono nel database SQLite della cronologia.
• Gli aspetti condivisi sono metadati cosmetici. Un aspetto ricevuto non modifica le impostazioni radio, i canali o il tema del pacchetto salvato della dashboard.

Architettura del sistema

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

Installazione

Inizia con prerequisiti e dipendenze, poi scegli un percorso di installazione: