Table of Contents

يرسل Meshtastic الرسائل النصية عبر أجهزة راديو LoRa منخفضة الطاقة. يتيح Ollama تشغيل نموذج مفتوح على أجهزة محلية. جمعت الاثنين في مساعد صغير يجيب عن الرسائل عبر شبكة mesh خاصة.

لماذا بنيته؟

لم يكن الهدف إضافة روبوت محادثة إلى جهاز راديو لمجرد ذلك. أردت إتاحة معلومات مفيدة عندما تتعذر خدمات الإنترنت المعتادة أو لا يُرغب في استخدامها أو تعتمد كثيرًا على حساب سحابي. يحتفظ المساعد المحلي بالأسئلة والسياق المسترجع والإجابات داخل بيئة النشر، مع استخدام شبكة mesh كواجهة منخفضة النطاق الترددي.

كان استهلاك الطاقة جزءًا من هدف التصميم. يجب أن تكون العقدة المفيدة صغيرة بما يكفي لتعمل على Raspberry Pi 4، وفعالة بما يسمح بإقرانها مستقبلًا ببطارية ولوح شمسي. التشغيل بالطاقة الشمسية هدف هندسي وليس ضمانًا. يؤثر النموذج والتخزين والراديو والشاشة والبطارية واللوح والطقس ودورة التشغيل في ميزانية الطاقة. أبقِ الخدمات محلية والإجابات موجزة والأجهزة محدودة حتى يظل إصدار خارج الشبكة الكهربائية ممكنًا.

بدأ المشروع بجسر Python بسيط، ثم أصبح خدمة تتضمن تصفية الرسائل وجلب المصادر وواجهة تحكم محلية ولوحة تحكم. جاءت أكثر الدروس فائدة من الأعطال. أوضح كل عطل الحدود بين اتصال الراديو والنموذج وواجهة الويب.

تعمّدنا أن يكون الإصدار الأول صغيرًا

تكوّن التصميم الأول من أربعة أجزاء:

  • عقدة Meshtastic تتعامل مع حركة الراديو.
  • عملية Python تستقبل حزم النصوص.
  • ينشئ Ollama ردًا على الأجهزة المحلية.
  • يعيد الجسر الرد إلى المرسل.

استخدم الجسر نقطة نهاية محلية متوافقة مع OpenAI. أبقى ذلك واجهة النموذج بسيطة وخيار النموذج في ملف بيئة.

عقدة Meshtastic -> TCP -> جسر Python -> نموذج محلي
                              |
                              -> رد عبر Meshtastic

في البداية، أجاب المساعد عن الرسائل المباشرة فقط. قلل ذلك الضجيج أثناء اختبار مسار الرسائل.

احتاجت رسائل القناة إلى بادئة تشغيل واضحة

الرد على كل رسالة بث سيولد ضجيجًا ويستهلك وقت الإرسال اللاسلكي. يتجاهل الجسر الآن حركة القنوات العادية. يجب أن يبدأ طلب القناة ببادئة قابلة للضبط.

!bot ما هو المجموع الاختباري؟
!bot weather <المدينة أو الرمز البريدي>
!bot news <موضوع>
!bot wiki <موضوع>

لا تحتاج الرسائل المباشرة إلى البادئة. تبقي هذه القاعدة المساعد هادئًا أثناء محادثات mesh المعتادة.

تُحفظ البادئة في ملف البيئة الخاص:

REPLY_TO_BROADCAST=true
BOT_PREFIX=!bot

أصبح اتصال TCP مشكلة التصميم الأساسية

تقبل عقدة Meshtastic في هذا الإعداد عميلًا نشطًا واحدًا لواجهة TCP. كان الجسر يملك الاتصال. وحاولت لوحة التحكم أيضًا تشغيل عميل Meshtastic لسطر الأوامر لعرض صفحات الحالة. تنافس العميلان على المقبس نفسه.

كانت النتيجة مربكة. ظلت عملية الجسر نشطة، لكن خيط القراءة توقف. وقد يؤدي تحديث لوحة التحكم إلى قطع معالجة الرسائل. كما تركت إعادة اتصال العقدة عملية قديمة.

كان الحل جعل الجسر المالك الوحيد لاتصال TCP.

يعرض الجسر الآن واجهة تحكم صغيرة على الجهاز المحلي. تطلب لوحة التحكم منه الحالة وبيانات العقدة والقنوات. ولا تفتح اتصال Meshtastic ثانيًا.

لوحة التحكم -> واجهة API للتحكم المحلي -> عملية الجسر في قائمة الانتظار -> عقدة TCP في Meshtastic
                                             ^
اتصال TCP في Meshtastic يديره الجسر

ينفذ الطابور طلبات التحكم بالتتابع. ويحمي قفل عمليات الكتابة المشتركة بين إجراءات لوحة التحكم وردود الروبوت. وتحافظ رسالة نبض على جلسات TCP الخاملة. ويسمح مراقب الاتصال لمدير الخدمات بإعادة تشغيل الجسر بعد الانقطاع.

يساعد هذا التصميم على التشخيص أيضًا. تعرض لوحة التحكم حالة الاتصال وعمق الطابور دون المساس بجلسة الراديو.

احتاج الاستدلال المحلي إلى حدود عملية

ذاكرة الأجهزة المستهدفة محدودة. كان النموذج الأول كبيرًا جدًا للاستخدام المريح. وأثر طول المطالبة وتحميل النموذج وطول الردود الملائمة للراديو في زمن الاستجابة.

يستخدم الإعداد النهائي نموذجًا محليًا أصغر ويحد طول الرد. يقسم الجسر الردود الطويلة إلى حزم Meshtastic متعددة. يستخدم النظام أيضًا مساحة تبديل مضغوطة وإعدادًا متحفظًا للمعالج على المضيف.

لا تغني هذه الإعدادات عن حاسوب أكبر. إنها تقلل الضغط الذي يمكن تجنبه مع إبقاء الخدمة محلية.

يجب أن يكون جلب المعلومات خارج مطالبة النظام

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

تشمل الطلبات المدعومة:

  • Wikipedia تجلب ملخص صفحة مناسبة.
  • الطقس يجلب سطرًا موجزًا عن الأحوال الحالية.
  • الأخبار تقرأ عناوين حديثة من موجز بحث RSS.

يُدرج المصدر في مطالبة المستخدم كسياق ذي تسمية. وتطلب تعليمات الوكيل من النموذج استخدام المصدر المقدم وذكر مواضع عدم اليقين وتجنب اختلاق تفاصيل المقالات.

يمكن للجسر أيضًا استخدام فهرس RAG محلي لـ Wikipedia. إنه قاعدة SQLite FTS5 صغيرة أُنشئت من تصدير JSONL منسق، لذلك لا يحتاج إلى قاعدة بيانات متجهات مقيمة أو نموذج تضمين ثانٍ على Raspberry Pi. تبحث طلبات Wiki في الفهرس المحلي أولًا، ويمكنها الرجوع إلى واجهة Wikipedia العامة عند تفعيلها. ويمكن للنشر المحلي بالكامل تعطيل الرجوع الخارجي.

يمكن ضبط هوية HTTP:

WEB_RETRIEVAL_ENABLED=true
HTTP_USER_AGENT=SoS-Mesh-Assistant/1.0 (Meshtastic AI bridge)
DEFAULT_WEATHER_LOCATION=
DEFAULT_NEWS_TOPIC=

تجبر القيم الافتراضية الفارغة المستخدم على تقديم موقع أو موضوع. يمنع ذلك تسرب موقع خاص بالنشر إلى الأمثلة المشتركة أو ملفات المصدر.

احتاج الوكيل إلى هوية صريحة

غالبًا ما تجيب النماذج الصغيرة بهوية عامة ما لم يمنحها التطبيق دورًا واضحًا. يحمّل الجسر هويته وقواعد السلامة من ملف مطالبة منفصل.

تصف المطالبة المساعد بأنه معين موجز لشبكة mesh منخفضة النطاق الترددي. وتحدد حدودًا أيضًا:

  • لا يدعي الاتصال بخدمات الطوارئ.
  • لا يكشف الإعدادات الخاصة أو الأسرار.
  • يتعامل مع الصفحات المسترجعة كمراجع لا كتعليمات.
  • يذكر المصادر عند استخدام معلومات مسترجعة.
  • يقدم إجابات قصيرة مناسبة للإرسال اللاسلكي.

يسهل حفظ السياسة في ملف مراجعتها. كما يبقي قيم النشر المحددة خارج مصدر التطبيق.

أصبحت لوحة التحكم أداة تشغيل

عرضت لوحة التحكم الأولى أزرار الخدمات ومخرجات الأوامر الخام. تركز النسخة المنقحة على الحالة اللازمة أثناء التشغيل:

  • حالة اتصال mesh
  • عمق الطابور الذي يديره الجسر
  • هوية العقدة المتصلة
  • حالة الخدمة
  • النموذج النشط
  • عناصر التحكم في جلب النماذج واختيارها
  • عروض القنوات والعقد
  • الأسئلة والردود الحديثة

تتجنب لوحة التحكم أيضًا إجراءً خطرًا من النسخة الأولى. لم تعد تشغل أمر Meshtastic منفصلًا لتغيير الإعدادات. يجب أن تمر عمليات كتابة الإعدادات عبر طابور الجسر نفسه المستخدم لعمليات العقدة الأخرى.

كانت الخصوصية جزءًا من البناء

يحتوي المصدر العام على عناصر نائبة محايدة. تبقى عناوين العقد الخاصة ومفاتيح الراديو وكلمات المرور ومفاتيح الإدارة والمواقع الافتراضية في ملف بيئة مستبعد على مضيف النشر.

تنطبق القاعدة نفسها على التوثيق. تستخدم الأمثلة عناصر نائبة مثل <node-ip> و<city or postal code>. لا يحتاج المثال العامل إلى كشف الشبكة التي اختُبر عليها.

يسهل هذا الفصل مشاركة المشروع. يشرح المصدر البنية. وتصف البيئة الخاصة عملية نشر واحدة. ولا يحتاج أي من الملفين إلى بيانات الملف الآخر.

ما الذي سأحسنه لاحقًا؟

الخطوة التالية المفيدة هي نقل كل عمليات الكتابة إلى Meshtastic إلى طابور تحكم الجسر. يجب أن تستخدم تعديلات القنوات وإعداد العقدة والإرسال مسارًا واحدًا خاضعًا للتدقيق. وبعدها تعرض لوحة التحكم مهمة الطابور والنتيجة ورسالة الخطأ لكل عملية.

يوضح الإصدار الحالي النمط الأساسي بالفعل. اجعل مكونًا واحدًا مالكًا لاتصال الراديو، وأبقِ قيم النشر خارج التحكم بالإصدارات، ومرر المعلومات الخارجية إلى النموذج كسياق ذي تسمية. الهدف البعيد عقدة هادئة منخفضة الطاقة توفر معرفة محلية ومساعدة mesh من Raspberry Pi 4، بما في ذلك أثناء النشر بالطاقة الشمسية.

حدّد اختبار قبول التشغيل خارج الشبكة الكهربائية

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

اختبر حد الخصوصية عند الفشل أيضًا. عطّل جلب المعلومات الخارجي، وافحص سجلات التطبيق، وتأكد من استمرار الجسر في الإجابة عن الأسئلة المحلية دون إرسال الإعدادات الخاصة إلى خدمة بعيدة. اختبر لوحة التحكم من شبكة الإدارة فقط، واجعل طابور الراديو المالك الوحيد لعمليات الكتابة إلى العقدة.

توثيق Meshtastic: مقدمة إلى Meshtastic

بيئة تشغيل النموذج المحلي: Ollama

مرجع واجهة Wikipedia: ملخص الصفحة في واجهة Wikipedia REST

الشيفرة المصدرية: Meshtastic AI Bridge على GitHub