Meshyface

Meshyface एक चैट-प्रथम Meshtastic डैशबोर्ड है जो एकल Python सेवा के रूप में चलता है और HTTP पर एक एकल-पृष्ठ वेब UI प्रदान करता है।

वर्तमान ऐप सतह

वर्तमान UI निम्नलिखित प्रदर्शित करता है:

• चैट और प्रत्यक्ष-सहकर्मी वार्तालाप
• मानचित्र, अवलोकन, लिंक, मार्ग, सेंसर, शीर्ष 10 रैंकिंग, नोड विवरण, और ऑन-डिमांड इतिहास के लिए नेटवर्क कार्यक्षेत्र
• लाइव पैकेट/लॉग आउटपुट के लिए कंसोल कार्यक्षेत्र
• ऐप्स कार्यक्षेत्र जिसमें गेम और फ़ाइल स्थानांतरण सक्षम होने पर फ़ाइलें टैब है
• सेटिंग्स कार्यक्षेत्र जिसमें रेडियो, डिवाइस, कनेक्टिविटी, स्थान, चैनल, टिकर, सूचियाँ, उपस्थिति, और के बारे में फलक हैं
• SQLite-समर्थित इतिहास, खोज, रोलअप, थीम स्थिरता, और कस्टम टेलीमेट्री नियम स्थिरता

कंसोल कार्यक्षेत्र

कंसोल कार्यक्षेत्र पैकेट ट्रैफ़िक, इतिहास खोज, और मेश उपयोगिता कमांड के लिए एक टर्मिनल-शैली नियंत्रण सतह है।

• ऑटोकम्प्लीट सुझाव खोलने के लिए एक कमांड नाम टाइप करें। स्वीकार करने के लिए Tab या Enter का उपयोग करें, घोस्टेड सफ़िक्स स्वीकार करने के लिए ArrowRight, और पॉपअप में जाने के लिए ArrowUp / ArrowDown का उपयोग करें।
• नोड लक्ष्य लेने वाले कमांड नाम, आईडी, इमोजी, टैग, स्थिति, हॉप्स, GPS, अंतिम-सुनी स्थिति, पोर्ट, और नोड संख्या के साथ समृद्ध नोड सुझाव दिखाते हैं। सामान्य पाठ नोड नाम और टैग द्वारा संकीर्ण होता है; ! नोड आईडी द्वारा संकीर्ण होता है।
• live पैकेट ट्रैफ़िक को Ctrl+C या q तक स्ट्रीम करता है। केवल मिलान करने वाले लाइव पैकेट समूहों को स्ट्रीम करने के लिए live grep <text>, live rg <text>, live filter=<text>, या नंगे live <text> का उपयोग करें। लेयर और वर्बोसिटी फ़िल्टर अभी भी लागू होते हैं, उदाहरण के लिए live rg TEXT_MESSAGE_APP -vv --layer=2।
• grep <text> और rg <text> संदर्भ विंडो, सीमाएं, पैकेट/चैट स्रोत फ़िल्टर, और सारांश/पैकेट स्कोप फ़िल्टर के साथ संग्रहीत पैकेट/चैट इतिहास खोजते हैं।
• /search <text> एक संग्रहीत-इतिहास खोज शुरू किए बिना प्रॉम्प्ट से दृश्य कंसोल आउटपुट को फ़िल्टर करता है।

स्क्रीनशॉट

लाइव नेटवर्क मानचित्र

नोड स्थानों, लिंक, सामान्य पथ, क्लस्टर, और सिग्नल हीटमैप के साथ मानचित्र दृश्य।

नेटवर्क अवलोकन

नोड गणना, ऑनलाइन स्थिति, नए नोड, और स्थिति रिपोर्ट के लिए इतिहास दृश्य।

लिंक टोपोलॉजी

चयनित रूट नोड से देखे गए लिंक दिखाने वाला टोपोलॉजी दृश्य।

रूट ट्रेस

स्रोत, गंतव्य, निकटवर्ती लिंक, और प्रति-हॉप पैकेट विवरण के लिए ट्रेस दृश्य।

सेंसर इतिहास

एकाधिक नोड में सेंसर इतिहास की तुलना करने वाला टेलीमेट्री चार्ट।

स्थिति कार्ड

रेडियो गतिविधि, नोड गणना, पैकेट, लिंक, बैटरी, और चैनल उपयोग के लिए शीर्ष कार्ड।

थीम अनुकूलन

थीम कस्टम रंग, ग्रेडिएंट, पारदर्शिता, ब्लर, फ़ॉन्ट, कण, या लाइव-मैप पृष्ठभूमि के साथ पूरे डैशबोर्ड को नया आकार दे सकती हैं। ये उदाहरण पैलेट कस्टम थीम हैं; इसका पूर्ण-रिज़ॉल्यूशन स्क्रीनशॉट खोलने के लिए किसी भी पूर्वावलोकन का चयन करें।

Signal Green	Neon Magenta	Aurora Relay

साझा नोड उपस्थितियाँ

Meshyface नोड एक नोड-थीम रेसिपी और एक वैकल्पिक घोस्ट या वॉटरमार्क वाले कॉम्पैक्ट उपस्थिति पैकेट साझा कर सकते हैं। अपने नोड को Settings > Appearance > Node Appearance में कॉन्फ़िगर और पूर्वावलोकन करें, Share node appearance सक्षम करें, फिर इसे प्रकाशित करने के लिए Broadcast appearance का उपयोग करें।

• उपस्थिति पैकेट कॉन्फ़िगर किए गए प्रोफ़ाइल भेजने वाले चैनल का उपयोग करते हैं और रेडियो की हॉप-लिमिट सेटिंग प्राप्त करते हैं; Meshyface एक अलग हॉप सीमा लागू नहीं करता है।
• प्राप्त उपस्थितियाँ प्राप्त डैशबोर्ड की अपनी थीम को बदले बिना चैट, रोस्टर, नोड विवरण, मानचित्र, ग्राफ़, सेंसर और टिकर में नोड पहचान को स्टाइल कर सकती हैं।
• Share node appearance बंद करने से सुविधा का दोनों पक्ष अक्षम हो जाता है। यह प्रसारण रोक देता है और आने वाले उपस्थिति पेलोड को डिकोड, कैश या लगातार रखे जाने से पहले प्रोफ़ाइल प्राप्त पथ को बायपास करता है; कैश की गई साझा उपस्थितियाँ साफ़ हो जाती हैं और कोई भी प्राप्त उपस्थिति प्रस्तुत नहीं की जाती है।
• जब इतिहास सक्षम होता है, तो प्राप्त प्रोफ़ाइल और स्थानीय साझाकरण प्राथमिकता इतिहास 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

स्थापना

पूर्वापेक्षाएँ और निर्भरताएँ से शुरू करें, फिर एक स्थापना पथ चुनें:

• मैन्युअल फ़ोरग्राउंड रन: कहीं भी क्लोन करें और डैशबोर्ड को सीधे चलाएं।
• अनुशंसित systemd सेवा: स्थायी GitHub-अपडेट करने योग्य होस्ट के लिए /opt/meshyface में क्लोन करें।
• Docker: कंटेनर में /data माउंटेड होने पर स्थायी स्थिति के साथ वही ऐप एंट्रीपॉइंट चलाएं।
• वर्कस्टेशन पुश डिप्लॉयमेंट: एक स्थानीय चेकआउट को SSH पर लक्ष्य पर कॉपी करें।
• Proxmox रनटाइम टोपोलॉजी: VM/LXC इंस्टॉल के लिए TCP या USB रेडियो प्लेसमेंट चुनें।
• ऑफ़लाइन मानचित्र पैक: एयर-गैप्ड या कम-कनेक्टिविटी डैशबोर्ड के लिए विस्तृत स्थानीय मानचित्र डेटा जोड़ें।

डेटा और भंडारण