عن المشروع

Vector Watcher هو تطبيق سطح مكتب متعدد المنصات لفحص وإدارة قواعد بيانات LanceDB المتجهة من خلال واجهة رسومية. يستهدف التطبيق المستخدمين الذين يعملون مع التضمينات المتجهة (vector embeddings) المحلية أو البعيدة ويرغبون في تصفحها والاستعلام عنها وتنظيمها دون كتابة نصوص برمجية. ## ماذا يقدم التطبيق - **مدير الاتصالات** — تكوين وحفظ والتبديل بين عدة مثيلات LanceDB محلية أو بعيدة. - **فاحص المخططات والجداول** — تصفح مجموعات البيانات المتجهة، والمخططات الهيكلية، والبيانات الوصفية، وعدد الصفوف. - **البحث عن التشابه المتجهي** — تشغيل استعلامات المسافة باستخدام مقاييس L2 أو Cosine أو Dot Product مباشرة من واجهة المستخدم. - **sidecar بدون إعدادات** — يتم إدارة الخلفية المحلية بلغة Python تلقائياً وتعمل على مقبس loopback معزول عند `127.0.0.1:8765`. ## البنية التحتية يجمع المشروع بين مضيف Tauri أصلي (Rust) وواجهة أمامية webview تعتمد على React/TypeScript. يدير نواة Tauri محرك Python/FastAPI مدمج يتم تشغيله كعملية sidecar عبر Uvicorn، والذي يتواصل بدوره مع LanceDB Core (الإصدار 0.30.2) من خلال روابط أصلية. يتم التواصل بين webview والمضيف الأصلي باستخدام IPC المحلي لـ webview؛ وتكون الخلفية مرتبطة محلياً بدلاً من تعريضها على الشبكة. ## التثبيت يتم نشر الملفات الثنائية المجمعة مسبقاً في صفحة الإصدارات (Releases) الخاصة بالمشروع. تشمل الأهداف الموثقة Linux (Ubuntu 24.04+، x86_64/arm64، بصيغ `.AppImage` و `.deb`) و macOS (Apple Silicon و Intel، بصيغة `.dmg`) و Windows 11 (x64، بصيغ `.msi` و setup `.exe`). ## التطوير المستودع عبارة عن monorepo مقسم إلى دليل `frontend` ودليل `backend`. المتطلبات المذكورة هي Node.js v20+ LTS، وسلسلة أدوات Rust مستقرة وحديثة لـ Tauri، و Python 3.11+ مع Poetry. تغطي خطوات الإعداد تنفيذ `npm install` في الواجهة الأمامية، و `poetry install` بالإضافة إلى نص تشغيل لـ Python sidecar، وتشغيل أمر Tauri dev. يتم إنتاج مثبتات مستقلة عن طريق تشغيل نص بناء الخلفية ثم نص `tauri:build` الخاص بالمنصة. ## التوثيق والمجتمع تتوفر مواد إضافية — دليل المستخدم والعمليات، وملاحظات البنية وبروتوكول FastAPI، وسير عمل التغليف/binary sidecar — في Wiki الخاص بالمشروع على GitHub. يتم صيانة المشروع بواسطة Keshav Mohta و Dhwani Khandelwal، ويرحب بالمشكلات (issues) وطلبات السحب (pull requests)، ويتم توزيعه بموجب رخصة MIT. ## ملاحظات يعكس هذا الموجز فقط ما وثقه ملف README: عميل واجهة رسومية لسطح المكتب لـ LanceDB. لم يتم وصف خصائص الأداء، أو حدود حجم مجموعة البيانات، أو مجموعة الميزات الكاملة بما يتجاوز القدرات المذكورة في المواد المصدرية.