Meshyface

Meshyface هي لوحة تحكم لـ Meshtastic تعتمد على المحادثة أولاً، وتعمل كخدمة Python واحدة وتقدّم واجهة ويب من صفحة واحدة عبر HTTP.

أسطح التطبيق الحالية

توفّر الواجهة الحالية ما يلي:

• المحادثة ومحادثات النظراء المباشرة
• مساحة عمل الشبكة للخريطة والنظرة العامة والروابط والمسارات وأجهزة الاستشعار وأفضل 10 تصنيفات وتفاصيل العقدة والسجل عند الطلب
• مساحة عمل Console لإخراج الحزم/السجلات المباشر
• مساحة عمل Apps مع ألعاب وتبويب Files عند تفعيل نقل الملفات
• مساحة عمل Settings مع أجزاء الراديو والجهاز والاتصال والموقع والقنوات وtickers والقوائم والمظهر وحول
• سجل مدعوم بـ SQLite، والبحث، والتجميعات (rollups)، واستمرار المظهر، واستمرار قواعد القياس عن بُعد المخصصة

مساحة عمل Console

مساحة عمل Console هي سطح تحكم بأسلوب طرفية لحركة الحزم، والبحث في السجل، وأوامر أدوات الشبكة.

• اكتب اسم أمر لفتح اقتراحات الإكمال التلقائي. استخدم Tab أو Enter للقبول، وArrowRight لقبول اللاحقة المعروضة باهتة، وArrowUp / ArrowDown للتنقل داخل النافذة المنبثقة.
• الأوامر التي تتطلب عقدة هدف تعرض اقتراحات عقد غنية بالاسم والمعرّف والرمز التعبيري والوسم والحالة والقفزات (hops) ونظام تحديد المواقع (GPS) وآخر حالة استماع والمنافذ ورقم العقدة. النص العادي يضيّق النتائج حسب أسماء العقد ووسومها؛ و! يضيّق حسب معرّف العقدة.
• live يبث حركة الحزم حتى Ctrl+C أو q. استخدم live grep <text> أو live rg <text> أو live filter=<text> أو live <text> فقط لبث مجموعات الحزم المباشرة المطابقة فقط. ما تزال فلاتر الطبقة والتفصيل (verbosity) مطبَّقة، على سبيل المثال live rg TEXT_MESSAGE_APP -vv --layer=2.
• grep <text> وrg <text> يبحثان في سجل الحزم/المحادثة المحتفظ به مع نوافذ سياق، وحدود، وفلاتر مصدر الحزم/المحادثة، وفلاتر نطاق الملخص/الحزم.
• /search <text> يفلتر مخرجات Console المرئية من موجه الأوامر دون بدء بحث في السجل المحتفظ به.

لقطات الشاشة

خريطة الشبكة المباشرة

عرض الخريطة مع مواقع العقد، والروابط، والمسارات الشائعة، والعناقيد، وخريطة حرارة الإشارة.

نظرة عامة على الشبكة

عرض السجل لأعداد العقد، وحالة الاتصال، والعقد الجديدة، وتقارير المواقع.

طوبولوجيا الروابط

عرض الطوبولوجيا الذي يظهر الروابط المرصودة من العقدة الجذرية المحددة.

تتبع المسار

عرض التتبع لمصدر ووجهة وروابط قريبة وتفاصيل الحزم لكل قفزة.

سجل أجهزة الاستشعار

مخطط القياس عن بُعد الذي يقارن سجل أجهزة الاستشعار عبر عقد متعددة.

بطاقات الحالة

بطاقات علوية لنشاط الراديو، وأعداد العقد، والحزم، والروابط، والبطارية، واستخدام القنوات.

تخصيص المظهر

يمكن للمظاهر إعادة تشكيل لوحة التحكم بالكامل بألوان مخصصة، وتدرجات لونية، وشفافية، وضبابية، وخطوط، وجسيمات، أو خلفية خريطة مباشرة. هذه اللوحات مثال على مظاهر مخصصة؛ اختر أي معاينة لفتح لقطة الشاشة بدقة كاملة.

Signal Green	Neon Magenta	Aurora Relay

مظاهر العقد المشتركة

يمكن لعقد Meshyface مشاركة حزم مظهر مضغوطة تحتوي على وصفة مظهر للعقدة وعلامة مائية أو شبح اختيارية. هيّئ عقدتك وعاينها في Settings > Appearance > Node Appearance، وفعّل Share node appearance، ثم استخدم Broadcast appearance لنشرها.

• تستخدم حزم المظهر قناة الإرسال الخاصة بملفات التعريف (Profiles) وترث إعداد حد القفزات في الراديو؛ لا تفرض Meshyface حد قفزات منفصلًا.
• يمكن للمظاهر المستلمة تنسيق هويات العقد في المحادثة، وقوائم الأعضاء، وتفاصيل العقد، والخرائط، والرسوم البيانية، وأجهزة الاستشعار، وtickers دون استبدال مظهر لوحة التحكم المستلمة نفسها.
• إيقاف تشغيل 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 الموصى بها: استنسخ إلى /opt/meshyface لاستضافة مستمرة قابلة للتحديث عبر GitHub.
• Docker: شغّل نقطة دخول التطبيق نفسها في حاوية مع تركيب /data للحالة المستمرة.
• نشر الدفع من محطة العمل: انسخ نسخة محلية إلى جهاز هدف عبر SSH.
• طوبولوجيا تشغيل Proxmox: اختر موضع راديو TCP أو USB لتثبيت VM/LXC.
• حزم الخرائط دون اتصال: أضف بيانات خرائط محلية مفصلة للوحات المعزولة عن الشبكة أو منخفضة الاتصال.

البيانات والتخزين

قاعدة بيانات السجل المشتركة

--history-db هو اسم ملف SQLite النهائي على القرص. لم تعد لوحة التحكم تضيف لاحقة الراديو المتصل، لذا فإن أي راديو يُوصَل بلوحة التحكم يساهم في نفس سجل الحزم والمحادثة والعقد والتجميعات المحفوظ.

أوضاع السجل