/ الدليل / الملعب / swarmvault
● مجتمع swarmclawai ⚡ فوري

swarmvault

بواسطة swarmclawai · swarmclawai/swarmvault

حوّل البحث الخام — ملفات PDF والنصوص المكتوبة والأكواد والملفات الصوتية — إلى ويكي markdown محلي + رسم بياني معرفة يمكن لذكائك الاصطناعي الاستعلام عنه بلا حدود.

يجمّع SwarmVault مدخلات متنوعة (30+ صيغة) إلى ويكي متوافق مع Obsidian مع رسم بياني معرفة مكتوب النوع وبحث هجين. يوفّر خادم MCP لـ Claude Code و Codex و OpenCode وغيرها. كل حافة موسومة بـ extracted/inferred/ambiguous لتتبع الأصل. موجه للعمل محليًا مع موفّر heuristic offline (بلا حاجة لمفاتيح API).

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

swarmvault.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "swarmvault": {
      "command": "npx",
      "args": [
        "-y",
        "swarmvault"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "swarmvault": {
      "command": "npx",
      "args": [
        "-y",
        "swarmvault"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "swarmvault": {
      "command": "npx",
      "args": [
        "-y",
        "swarmvault"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "swarmvault": {
      "command": "npx",
      "args": [
        "-y",
        "swarmvault"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "swarmvault",
      "command": "npx",
      "args": [
        "-y",
        "swarmvault"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "swarmvault": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "swarmvault"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add swarmvault -- npx -y swarmvault

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: swarmvault

تراكم البحث عبر أشهر في ويكي قابل للاستعلام

👤 الباحثون والمحللون الذين يقومون بعمل عميق عبر الزمن ⏱ ~60 min intermediate

متى تستخدمه: عندما تكون قد قضيت أسابيع في البحث عن موضوع وتدرك أن ملاحظاتك متفرقة.

المتطلبات الأساسية
  • swarmvault CLI — npm install -g @swarmvaultai/cli
  • vault — swarmvault init --obsidian --profile personal-research
الخطوات
  1. إفراغ المصادر الخام
    ضع كل شيء في raw/: ملفات PDF والمقالات المحفوظة ونصوص الاجتماعات ومقاطع الأكواد.✓ تم النسخ
    → مجلد raw/ غير قابل للتغيير مأهول بالسكان
  2. جمّع الويكي
    swarmvault compile — توليد wiki/ مع صفحات مكتوبة وfrontmatter الروابط.✓ تم النسخ
    → تم إنشاء صفحات الويكي
  3. الاستعلام عبر MCP
    عبر MCP: ما هو الإجماع الحالي في ملاحظاتي حول 'post-quantum TLS timeline'؟ اشمل التناقضات.✓ تم النسخ
    → إجابة مع استشهادات متسلسلة من الرسم البياني والتناقضات المضمنة

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

المزالق
  • المدخلات المزعجة تنتج رسم بياني مزعج — انتقِ محتوى raw/ — احذف الفضلات بدلاً من استيعاب كل شيء
  • الاعتماد الزائد على الرسم البياني للحقيقة — الحافات الموسومة بـ 'inferred' أو 'ambiguous' هي فرضيات وليست حقائق — احترم الوسوم
اجمعها مع: documentation-server

تحويل نصوص الاجتماعات إلى معرفة فريق منظمة

👤 الفرق التي تجري الكثير من الاجتماعات المسجلة ⏱ ~45 min intermediate

متى تستخدمه: عندما تكون لديك نصوص Fathom/Otter متراكمة وتريد الاستعلام عبرها.

الخطوات
  1. ضع النصوص المكتوبة في raw/
    انسخ جميع نصوص Otter الخاصة بي من الربع الماضي إلى raw/meetings/.✓ تم النسخ
    → الملفات في مكانها
  2. جمّع
    swarmvault compile. تأكد من استخراج الكيانات (الأشخاص والمشاريع).✓ تم النسخ
    → تقرير عدد الكيانات
  3. استعلام
    ماذا قررنا حول إعادة هيكلة التسعير عبر جميع اجتماعات Q1؟ استشهد بكل مصدر.✓ تم النسخ
    → إجابة موحدة مع نصوص المصادر المستشهد بها

النتيجة: ذاكرة مؤسسية تبقى حتى بعد رحيل الأشخاص.

بناء ويكي نادي الكتاب مع استدلال عابر للكتب

👤 القراء الجادون ⏱ ~90 min intermediate

متى تستخدمه: عندما تريد من الذكاء الاصطناعي أن يستدل عبر الكتب وليس واحدًا في كل مرة.

الخطوات
  1. استيعاب
    ضع ملفات PDF + ملاحظات 5 كتب في raw/؛ جمّع.✓ تم النسخ
    → ويكي مع صفحة واحدة لكل كتاب + صفحات المفاهيم
  2. استدلال متقاطع
    ما هي المفاهيم التي تظهر في 3+ كتب؟ حدد التناقضات بين المؤلفين.✓ تم النسخ
    → خريطة مفاهيم مع التناقضات المضمنة

النتيجة: ممارسة قراءة تتراكم.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

swarmvault للويكي المنظم؛ documentation-server للبحث السريع في الاستيعاب

استيعب الأوراق الجديدة في كليهما — قارن جودة الاسترجاع والبنية.✓ تم النسخ
swarmvault + logseq

تصدير صفحات vault إلى رسم بياني Logseq

صدّر wiki/ Markdown إلى دليل Logseq pages/ مع الحفاظ على frontmatter.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
vault_search query: str, top_k?: int الاسترجاع الرئيسي free (local)
vault_get_page slug: str قراءة الصفحة كاملة free
vault_graph_neighbors slug, depth? استكشاف رسم بياني المفاهيم free
vault_contradictions topic?: str فحص الجودة free
vault_compile (none) بعد إضافة raw/ جديد CPU + optional embedding calls
vault_graph_report scope?: str نظرة عامة على موضوع free

التكلفة والحدود

تكلفة التشغيل

حصة API
صفر مع موفّر heuristic؛ بخلاف ذلك حدود موفّر LLM الخاص بك
الرموز لكل استدعاء
يمكن لـ Compile بث محتوى مصدر كبير عبر embeddings؛ استعلامات البحث 500-2000 token عادة
التكلفة المالية
مجاني؛ موفّرو LLM الاختياريون يكلفون رسوم LLM عادية
نصيحة
استخدم موفّر heuristic لـ compile في المرة الأولى؛ ارتقِ إلى compile مدعوم بـ LLM فقط عندما تكون الجودة مهمة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: مفاتيح موفّر LLM الاختياري في env/config
نقل البيانات الخارجي: لا شيء بشكل افتراضي (heuristic)؛ استدعاءات موفّر اختيارية فقط

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Compile fails on a specific PDF

بعض ملفات PDF تم المسح الضوئي عليها/صور فقط. قم بـ Pre-OCR باستخدام ocrmypdf قبل إسقاطها في raw/.

تحقق: pdftotext file.pdf - | head
MCP connection fails after agent install

أعد تشغيل swarmvault install --agent <name> وأعد تشغيل agent؛ تختلف مسارات config حسب المنصة.

تحقق: قائمة MCP العميل تظهر swarmvault
Hybrid search returns nothing

لم يتم جمع vault بعد، أو لم يتم بناء embeddings لوضع offline. قم بتشغيل swarmvault compile.

تحقق: swarmvault status

البدائل

swarmvault مقابل البدائل

البديلمتى تستخدمهاالمقايضة
documentation-serverعندما تريد RAG سريع بسحب وإفلات بدون ترجمة wikiلا توجد رسوم بياني منظم أو كشف تناقضات
Obsidian + Smart Connectionsعندما تسكن في Obsidian وتريد ذكاء اصطناعي داخل المحررخط أنابيب ترجمة أقل تنظيمًا
NotebookLMعندما تكون موافقًا على Google-hosted وواجهة سهلةالبيانات تغادر جهازك؛ لا توجد عملية تصدير الرسوم البيانية

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills