● مجتمع
saskinosie
🔑 يتطلب مفتاحك
Weaviate Claude Skills
بواسطة saskinosie · saskinosie/weaviate-claude-skills
Weaviate المحلي الشامل من Claude - الإعداد، والاتصال، والمخطط، والاستيعاب، وRAG في خمس مهارات مركزة.
saskinosie/weaviate-claude-skills عبارة عن سوق صغير يضم خمس مهارات تغطي سير عمل Weaviate: إعداد weaviate المحلي (إنشاء عامل الإرساء)، واتصال weaviate (فحص الصحة + المصادقة)، ومدير مجموعة weaviate (مسؤول المخطط والتجميع)، واستيعاب بيانات weaviate (استيراد فردي + دفعة + ملف)، ووكيل استعلام weaviate (البحث الدلالي، المرشحات، الهجين، RAG). يعمل مع Claude.ai وClaude Desktop؛ يمكنك إحضار قبو المستندات والمهارات التي تتعامل مع السباكة الخاصة بـ Vector DB.
لماذا تستخدمه
الميزات الأساسية
- خمس مهارات تغطي دورة حياة Weaviate المحلية الكاملة
- قالب إنشاء عامل ميناء لمثيل محلي
- استيعاب الدفعة والواردات المستندة إلى الملفات
- استعلامات RAG باستخدام المرشحات والبحث المختلط والتحليلات
- إعداد Python-venv مع ملف require.txt
عرض مباشر
كيف يبدو في الممارسة
weaviate-claude-skills.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: Weaviate Claude Skills
متى تستخدمه: تريد الدردشة مع مستنداتك الخاصة دون إرسالها إلى بائع السحابة.
الخطوات
-
عامل ميناء-بدء Weaviate
استخدم weaviate-local-setup لبدء إنشاء عامل إرساء لـ Weaviate محلي.✓ تم النسخ
→ يُظهر docker ps صحة weaviate على 8080
-
إنشاء مجموعة
قم بإنشاء مجموعة "Docs" تحتوي على الحقول: العنوان (النص)، النص (النص)، المصدر_url (النص).✓ تم النسخ
→ تم تطبيق المخطط؛ يقوم weaviate-collection-manager بإرجاع التكوين
-
استيعاب
استوعب كل .md ضمن ./docs ككائنات في "Docs".✓ تم النسخ
→ تم الإبلاغ عن تقدم الدفعة؛ الكائنات مرئية عبر الاستعلام
-
بسأل
استخدم weaviate-query-agent: "كيف نقوم بتدوير مفاتيح واجهة برمجة التطبيقات؟"✓ تم النسخ
→ تستشهد الإجابة بـ source_url من مجموعة المستندات
النتيجة: RAG محلي قابل للتشغيل يمكنك التكرار عليه.
المزالق
- استيعاب ملفات PDF العملاقة بالكامل دون تقطيع — قطعة بقيمة 500 رمز تقريبًا؛ اسمح لقالب استيعاب المهارة بالتعامل معها
متى تستخدمه: RAG المبكر — يتغير مخططك أسبوعيًا ولا تريد أوامر التجعيد.
الخطوات
-
فحص المخطط الحالي
إظهار مخطط "المستندات" - الحقول، والمتجه، وتكوين الفهرس.✓ تم النسخ
→ تم إرجاع التكوين الكامل
-
اقتراح التغيير
أضف خاصية التعداد "اللغة" (en/zh/ja)؛ احتفظ بالباقي.✓ تم النسخ
→ خطة الهجرة + تحذير احتياطي
-
يتقدم
يتقدم؛ أعد فهرسة الكائنات الـ 500 الموجودة.✓ تم النسخ
→ تقدم الوظيفة؛ التهم التوفيق
النتيجة: تطور المخطط بأمان مع الوعي بتكلفة إعادة الفهرسة.
المزالق
- على افتراض أن عمليات إزالة الممتلكات مجانية — تتطلب بعض التغييرات إعادة التضمين؛ علامات المهارة عندما تكون رخيصة مقابل باهظة الثمن
متى تستخدمه: البحث الدلالي البحت يفتقد مصطلحات المطابقة التامة؛ يعمل الهجين (BM25 + المتجه) على إصلاحه.
الخطوات
-
تشغيل الاستعلامات المختلطة
الاستعلام "رمز خطأ SAML SSO 42"، alpha=0.5 (الرصيد الدلالي + الكلمة الرئيسية).✓ تم النسخ
→ تتضمن أفضل النتائج التطابق الحرفي "42" ولكن أيضًا تلك ذات الصلة من الناحية المفاهيمية
-
مرشحات الطبقة
يحتوي عامل التصفية language='en' وsource_url على '/docs/auth/'.✓ تم النسخ
→ ضاقت الزيارات؛ يبقى الجواب مقتبسا
النتيجة: دقة أعلى في الاستعلامات ذات المصطلح المحدد دون فقدان الاستدعاء.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
استوعب الملفات المحلية عبر نظام الملفات MCP، ثم استعلم من خلال المهارة
قم بإدراج جميع عمليات التخفيض ضمن ./docs، واستوعبها في Weaviate 'Docs'، ثم ابحث عن السؤال المختلط.✓ تم النسخ
قارن بين الأساليب - عمليات التضمين فقط مقابل فهرس Weaviate المنظم
بالنسبة لهذه المجموعة، قم بمقياس هجين محلي مقابل Weaviate في 10 أسئلة تقييم.✓ تم النسخ
weaviate-claude-skills +
qdrant
قم بتقييم اختيار قاعدة بيانات المتجهات على عبء العمل الخاص بك
قم بتشغيل نفس مجموعة التقييم على Weaviate وQdrant؛ تقرير الكمون + MRR.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء - يعمل Weaviate محليًا
- الرموز لكل استدعاء
- استعلام + حجم القطعة المستردة
- التكلفة المالية
- مجانا للمحلية. لدى Weaviate Cloud أسعارها الخاصة إذا قمت بالترحيل لاحقًا.
- نصيحة
- القطعة عمدا (~500 رمز)؛ القطع كبيرة الحجم تهدر كلاً من التخزين والسياق.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: قم بدمج مفاتيح API في .env، وليس في ملفات المهارات. يمكن للمطور المحلي تخطي المصادقة ولكن دون الكشف عن المنفذ.
نقل البيانات الخارجي: لا شيء يترك جهازك للإعداد المحلي. يرسل Cloud Weaviate إلى نقطة النهاية التي تم تكوينها.
- يرتبط Weaviate المحلي بـ 0.0.0.0 افتراضيًا في العديد من الصور - ويقتصر على 127.0.0.1 في حالة تشغيل خدمات أخرى على شبكة LAN الخاصة بك.
- تضمين النماذج: إذا كنت تستخدم ناقلًا تابعًا لجهة خارجية، فستنتقل قطعك إلى ذلك المزود. احتفظ بها محليًا (على سبيل المثال، محولات text2vec) للبيانات الحساسة.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
تم رفض الاتصال 8080
حاوية Weaviate لا تعمل. عامل الإرساء يؤلف -d في الإعداد المحلي weaviate.
تحقق: curl localhost:8080/v1/.well-known/ready
فشل تغيير المخطط
تتطلب بعض تغييرات الخاصية إعادة إنشاء المجموعة. تصدير، وإفلات، وإعادة إنشاء، وإعادة الاستيعاب.
تحقق: weaviate-collection-manager diff output
الاستعلامات البطيئة
تحقق من معلمات فهرس HNSW ومن تكوين أداة التوجيه هذه بشكل صحيح. تجنب الرجوع إلى النص الكامل في الحقول غير المفهرسة.
تحقق: Query explain in the skill's debug mode
البدائل
Weaviate Claude Skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
| qdrant | أنت تفضل أداء Qdrant's API وRust | SDK مختلفة؛ قدرات مماثلة |
| local-rag | تريد RAG محليًا خفيف الوزن بدون قاعدة بيانات متجهة | أقل مرونة؛ لا يوجد مخطط |
| neo4j | بياناتك علائقية/رسم بياني وليست متجهة | نموذج مختلف |