توثيق موقع BACR

• البدء
• التثبيت
• مرجع CLI
• مرجع API

نظرة عامة

BACR (مساعد الروبوت مع الاسترجاع السياقي) هو مساعد دردشة ذكاء اصطناعي متطور يجمع بين معالجة المستندات المتقدمة، والتوجيه الذكي للاستعلامات، والذاكرة المستمرة. تم بناؤه باستخدام Python و Flet و LangGraph و FAISS، يوفر BACR تجربة مساعد ذكاء اصطناعي سطح مكتب قوية مع قدرات فهم المستندات المحلية.

النقاط الرئيسية:

• 🤖 توجيه الذكاء الاصطناعي متعدد النماذج مع تصنيف تلقائي للاستعلامات
• 📚 نظام RAG هجين مع البحث الشعاعي وإعادة الترتيب بالذكاء الاصطناعي
• 💾 ذاكرة عبر الجلسات تتعلم من محادثاتك
• 🎨 واجهة مستخدم رسومية حديثة لسطح المكتب مع دعم السمات
• 🔐 مصادقة Google OAuth آمنة
• 📊 تتبع استخدام الرموز والتكلفة في الوقت الفعلي

لماذا BACR؟

للمطورين:

• معالجة المستندات المحلية دون إرسال الملفات إلى واجهات برمجة التطبيقات الخارجية
• توجيه ذكي يدرك الكود لأسئلة البرمجة
• دعم متعدد التنسيقات (PDF، DOCX، TXT، MD، والمزيد)
• سجل محادثات مستمر عبر الجلسات

للباحثين:

• RAG متقدم مع إعادة ترتيب Jina AI لاسترجاع دقيق للمستندات
• تتبع الاستشهادات - يتم عرض المصادر المستشهد بها فقط
• ذاكرة عبر الجلسات لبناء المعرفة بمرور الوقت
• تصدير المحادثات إلى PDF للتوثيق

للفرق:

• قواعد بيانات معزولة للمستخدمين للخصوصية
• مفاتيح API مُدارة من الخادم لسهولة النشر
• وضع عدم الاحتفاظ بالبيانات (ZDR) للمستخدمين المهتمين بالخصوصية
• تتبع التكلفة لكل استعلام لإدارة الميزانية

الميزات

الذكاء الاصطناعي والذكاء

• التوجيه الذكي ذو المرحلتين: يتم تصنيف الاستعلامات تلقائيًا وتوجيهها إلى النموذج الأمثل
  • المرحلة 1: إدارة الملفات → RAG (البحث في المستندات) → LLM مباشر
  • المرحلة 2: البرمجة → التفكير → الدردشة → البحث
• تكامل النماذج: الوصول إلى أكثر من 200 نموذج ذكاء اصطناعي بما في ذلك GPT-4 و Claude و Gemini و DeepSeek والمزيد
• البث في الوقت الفعلي: استجابات رمز تلو الآخر مع تحديثات الحالة المباشرة
• تتبع التكلفة: مراقبة استخدام الرموز والتكاليف لكل استعلام مع تفاصيل مفصلة
• أوضاع النموذج: التبديل بين ZDR وغير ZDR

معالجة المستندات (RAG)

• البحث الهجين: يجمع بين التشابه الشعاعي وإعادة ترتيب Jina AI
• التضمينات المحلية: يستخدم نموذج تضمين GGUF محلي - لا توجد مكالمات API للتضمينات
• التصفية الذكية: عتبة الصلة تزيل تلقائيًا الأجزاء غير ذات الصلة
• الاستشهادات الذكية: يستشهد LLM بالمصادر كـ (Doc 1)، (Doc 2)؛ يتم عرض المصادر المستشهد بها فقط
• التخزين المستمر: فهارس FAISS خاصة بالمستخدم محفوظة في ~/.bacr/user_databases/
• دعم متعدد التنسيقات: PDF، TXT، MD، DOCX، XLSX، PPTX، RTF، CSV، JSON، YAML، والمزيد

الذاكرة والسياق

• الذاكرة عبر الجلسات: ذاكرة دلالية LangMem تستمر عبر جميع المحادثات
• قواعد بيانات خاصة بالمستخدم: قواعد بيانات SQLite معزولة لكل مستخدم للخصوصية
• السجل المستمر: جميع المحادثات محفوظة وقابلة للبحث
• مدرك للسياق: كل جلسة تحافظ على سياق مستقل مع تتبع الملفات

واجهة المستخدم

• واجهة Flet الحديثة: واجهة سطح مكتب نظيفة ومتجاوبة مبنية بـ Flutter
• دعم السمات: سمات فاتحة وداكنة والنظام (تستمر عبر إعادة التشغيل)
• جلسات بعلامات تبويب: محادثات مستقلة متعددة مع سهولة التبديل
• التحكم في حجم الخط: حجم نص قابل للتعديل مع عناصر تحكم مرئية
• شريط الحالة: عدد الملفات في الوقت الفعلي، واستخدام الرموز، ورصيد الائتمان
• وضع التصدير: حدد وصدّر رسائل محددة إلى PDF

المصادقة والأمان

• Google OAuth: تسجيل دخول آمن مع دعم تسجيل الدخول التلقائي باستخدام رموز التحديث
• صور الملف الشخصي: يتم جلبها حديثة من Google في كل تسجيل دخول
• عزل المستخدم: جميع البيانات مفصولة حسب حساب المستخدم
• حماية الخصوصية: بيانات المستخدم معزولة

البنية المعمارية

تم بناء BACR ببنية معيارية تفصل الاهتمامات وتمكن الصيانة السهلة:

طبقة الواجهة الأمامية:

• واجهة مستخدم رسومية قائمة على Flet مع مكونات تفاعلية
• تكامل Google OAuth للمصادقة
• تحديثات الحالة في الوقت الفعلي والاستجابات المتدفقة
• إدارة السمات والتفضيلات

الطبقة الأساسية:

• إدارة المحادثات القائمة على LangGraph
• نظام توجيه ذكي ذو مرحلتين
• RAG هجين مع البحث الشعاعي وإعادة الترتيب
• ذاكرة عبر الجلسات مع LangMem

الطبقة الخلفية:

• عميل API الخادم للمصادقة وإدارة مفاتيح API
• مدير النماذج مع التبديل بين وضع ZDR/غير ZDR
• الوصول متعدد النماذج
• تتبع استخدام الرموز وحساب التكلفة

طبقة التخزين:

• قواعد بيانات SQLite خاصة بالمستخدم
• فهارس شعاعية FAISS لتضمينات المستندات
• نظام الملفات المحلي للتخزين المؤقت للمستندات

المتطلبات

متطلبات النظام:

• نظام التشغيل: Windows 10/11، Linux (Ubuntu 20.04+، Fedora، Arch)، macOS 11+
• Python: 3.9 أو أعلى
• الذاكرة العشوائية: 4 جيجابايت كحد أدنى، 8 جيجابايت موصى به
• مساحة القرص: 2 جيجابايت للتطبيق والتبعيات
• الإنترنت: مطلوب للمصادقة والوصول إلى API

Windows

Linux

MacOS

غير متوفر

الأوامر

يوفر BACR مجموعة شاملة من أوامر الشرطة المائلة لإدارة الملفات والجلسات والمحادثات.

إدارة الملفات

/add <filepath>

• إضافة مستند إلى نظام RAG للسياق
• يدعم: PDF، TXT، MD، DOCX، XLSX، PPTX، RTF، CSV، JSON، YAML
• مثال: /add C:\Documents\report.pdf
• ينشئ التضمينات ويفهرس المستند للبحث

/remove <filename>

• إزالة ملف محدد من نظام RAG
• مثال: /remove report.pdf
• يزيل التضمينات ويحرر الذاكرة

/files

• سرد جميع الملفات الموجودة حاليًا في نظام RAG
• يعرض أسماء الملفات وعدد الأجزاء
• يعرض حجم السياق الإجمالي

/clear

• إزالة جميع الملفات من نظام RAG
• يمسح جميع تضمينات المستندات
• لا يمسح سجل الدردشة

إدارة الجلسات

/new-chat أو Ctrl+N

• بدء محادثة جديدة في علامة تبويب جديدة
• ينشئ سياقًا مستقلاً
• تظل الجلسات السابقة قابلة للوصول

/close-tab أو Ctrl+W**

• إغلاق علامة تبويب المحادثة الحالية
• يحفظ المحادثة في قاعدة البيانات
• لا يمكن إغلاق آخر علامة تبويب

/list-chats

• عرض جميع المحادثات المحفوظة
• يعرض أسماء الجلسات والطوابع الزمنية
• يعرض عدد الرسائل

/load-chat <name_or_id>

• تحميل محادثة في علامة التبويب الحالية
• يستبدل المحادثة الحالية
• مثال: /load-chat Project Discussion

/open-chat <name_or_id>

• فتح محادثة في علامة تبويب جديدة
• يحتفظ بالمحادثة الحالية
• مثال: /open-chat Meeting Notes

/rename-chat <new_name>

• إعادة تسمية المحادثة الحالية
• مثال: /rename-chat Q1 Planning
• لا يمكن إعادة تسمية الجلسات المؤقتة

/delete-chat <name_or_id>

• حذف محادثة محفوظة نهائيًا
• مثال: /delete-chat Old Notes
• لا يمكن التراجع عنه

سجل الدردشة

/clear-chat أو /clear

• مسح سجل الدردشة للمحادثة الحالية
• يزيل جميع الرسائل من العرض والحالة
• لا يحذف المحادثة المحفوظة
• تبقى الملفات في السياق

/export-chat

• تصدير المحادثة الحالية إلى ملف
• يحفظ كملف نصي بطابع زمني
• يتضمن جميع الرسائل والبيانات الوصفية
• الموقع: ~/.bacr/exports/

/import-chat <filepath>

• استيراد محادثة من ملف
• يدعم تنسيقات TXT و PDF
• يضيف إلى المحادثة الحالية
• مثال: /import-chat notes.txt

الأدوات المساعدة

/tokens

• عرض استخدام الرموز للمحادثة الحالية
• يعرض رموز الإدخال والإخراج والإجمالي
• يعرض التكاليف المقدرة
• يجمع عبر جميع الجلسات

/find <query>

• البحث عبر جميع سجل المحادثات
• يفتح واجهة البحث
• يبرز الرسائل المطابقة
• مثال: /find API documentation

/help

• يفتح صفحة المساعدة في المتصفح
• يعرض جميع الأوامر المتاحة
• يتضمن أمثلة وأوصاف

/quit

• إغلاق التطبيق
• يحفظ جميع المحادثات
• يمسح مفاتيح API من الذاكرة

التكوين

تبديل السمة

• انقر على أيقونة السمة في الشريط العلوي
• يتبدل بين الفاتح/الداكن
• يستمر التفضيل عبر إعادة التشغيل

حجم الخط

• انقر على أزرار حجم الخط في الشريط العلوي
• يضبط حجم النص لجميع الرسائل
• النطاق: 12 بكسل إلى 20 بكسل

تبديل وضع ZDR

• انقر على تبديل ZDR في الإعدادات
• يتبدل بين النماذج المجانية والمميزة
• يمسح ذاكرة التخزين المؤقت للنموذج عند التبديل

أوامر Shell

يدعم BACR أوامر shell الشائعة للتنقل في نظام الملفات:

cd <directory>

• تغيير دليل العمل الحالي
• مثال: cd Documents
• يؤثر على عمليات الملفات

ls أو dir

• سرد الملفات في الدليل الحالي
• يعرض أسماء الملفات والأحجام

pwd

• طباعة دليل العمل
• يعرض المسار الحالي

cat <file>

• عرض محتويات الملف
• مثال: cat notes.txt

mkdir <directory>

• إنشاء دليل جديد
• مثال: mkdir projects

rm <file>

• إزالة ملف (استخدم بحذر)
• مثال: rm temp.txt

cp <source> <dest>

• نسخ ملف
• مثال: cp file.txt backup.txt

mv <source> <dest>

• نقل أو إعادة تسمية ملف
• مثال: mv old.txt new.txt

إلخ

أمثلة الاستخدام

دردشة أساسية:

المستخدم: ما هو التعلم الآلي؟
BACR: [يبث الاستجابة مع الحالة في الوقت الفعلي]

معالجة المستندات:

المستخدم: /add C:\Reports\Q4_Analysis.pdf
BACR: ✔︎ تمت إضافة Q4_Analysis.pdf بنجاح (45 جزءًا)

المستخدم: ما هي النتائج الرئيسية في الربع الرابع؟
BACR: وفقًا لتحليل الربع الرابع (Doc 1)، كانت النتائج الرئيسية...

المصادر:
• Q4_Analysis.pdf

سير عمل متعدد الجلسات:

المستخدم: /new-chat
المستخدم: /add project_spec.md
المستخدم: اشرح تدفق المصادقة
BACR: [يقدم شرحًا مفصلاً مع الاستشهادات]

المستخدم: /rename-chat Auth Documentation
المستخدم: /export-chat
BACR: ✔︎ تم التصدير إلى ~/.bacr/exports/Auth_Documentation_2026-03-07.txt

البحث في السجل:

المستخدم: /find API endpoints
BACR: [يفتح واجهة البحث مع 12 تطابقًا عبر 3 محادثات]

المصادقة

يستخدم BACR Google OAuth 2.0 لمصادقة المستخدم وإدارة مفاتيح API القائمة على الخادم.

نظام RAG

يجمع نظام RAG (التوليد المعزز بالاسترجاع) بين البحث الشعاعي والبحث بالكلمات الرئيسية وإعادة الترتيب.

الأمان

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

• رموز التحديث: سجل Windows (مشفر)
• المحادثات: SQLite محلي (خاص بالمستخدم)
• المستندات: فهارس FAISS محلية (خاصة بالمستخدم)
• التفضيلات: سجل Windows (مشفر)

نقل البيانات:

• جميع مكالمات API تستخدم HTTPS
• يستخدم Google OAuth تدفق PKCE
• تنتهي صلاحية رموز JWT بعد 24 ساعة
• تنتهي صلاحية رموز التحديث بعد 30 يومًا

الخصوصية:

• بيانات المستخدم معزولة بواسطة التجزئة
• لا يتم إرسال محتوى المستند إلى الخادم
• يتم تخزين التضمينات فقط محليًا
• يتم تسجيل استخدام الرموز للفوترة فقط

أفضل الممارسات:

• تسجيل الخروج عند الانتهاء لمسح مفاتيح API
• لا تشارك رموز التحديث
• استخدم وضع ZDR للبيانات الحساسة
• قم بتصدير المحادثات المهمة بانتظام

الدعم

• البريد الإلكتروني: support@bacr.app

القانونية

• شروط الخدمة: https://bacr.app/terms
• سياسة الخصوصية: https://bacr.app/privacy

الإصدار: 1.0.0
آخر تحديث: 7 مارس 2026 التوثيق: https://bacr.app/documentation