lib2027
العربية

مجاني الاستخدام · يعمل على جهازك

مكتبة معرفة مبنية على ملفاتك، لك ولوكلاء الذكاء الاصطناعي

أضف مجلدًا من المستندات وابحث فيه بثلاث طرق في آنٍ واحد: بالمعنى، وبصيغ الكلمات في 15 لغة، وبأسماء API الدقيقة. هناك واجهة ويب لك، وخادم MCP لـ Claude Code و pi و Cursor وغيرها من الوكلاء.

  • ملف Rust تنفيذي واحد عبر npx
  • بلا Python وبلا قاعدة بيانات
  • NVIDIA GPU أو DirectML أو CPU
# ضع مجلدًا على الرف
$ npx lib2027 add ./docs
# افتح واجهة الويب → http://127.0.0.1:2027
$ npx lib2027
اطّلع على نتائج الاختباراتالحزمة على npm

اختبارات الأداء

هل يساعد النموذج فعلًا على الإجابة؟

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

كيف قسنا

النموذج نفسه والأسئلة نفسها

تُجرى كل مقارنة بنموذج واحد على مجموعة واحدة من الأسئلة. الشيء الوحيد الذي يتغير هو ما يُعطى للنموذج ليقرأه.

مجموعة البلاسيبو

نص لا علاقة له بالسؤال وبالطول نفسه: ضابطٌ لفكرة أن «المزيد من السياق يساعد».

تسجيل مسبق

حُدّدت الأسئلة والقواعد وعتبات النجاح قبل جمع أي بيانات.

تكرار واختبار

شُغّلت كل مجموعة 3 مرات، وتُحسب الدلالة الإحصائية باختبار الإشارة للعينات المزدوجة على مستوى الأسئلة.

نسبة الإجابات الصحيحة

  • بلا مكتبة
  • بلاسيبو
  • مع lib2027
  • بلا مكتبة — يجيب النموذج من ذاكرته
  • بلاسيبو — نص لا علاقة له بالسؤال وبالطول نفسه
  • مع lib2027 — المقاطع التي أعادها بحث lib2027

توثيق ويب حديث (devdocs، سبتمبر 2026)

150 سؤالًا · qwen3.8-27b
بلا مكتبة17.8‎%‎
بلاسيبو12.7‎%‎
مع lib202785.1‎%‎

الأسئلة نفسها بنموذج صغير

150 سؤالًا · 4B
بلا مكتبة9.1‎%‎
بلاسيبو0.4‎%‎
مع lib202783.1‎%‎

القانون الروسي (15 مدونة قانونية، pravo.gov.ru)

150 سؤالًا · qwen3.8-27b
بلا مكتبة34.7‎%‎
بلاسيبو33.8‎%‎
مع lib202784.4‎%‎¹

اختبار أسئلة عن API في three.js r186

90 إجابة · Claude Haiku 4.5
بلا مكتبة27.8‎%‎
بلاسيبولم يُقَس
مع lib202788.9‎%‎

¹ تُعاد المادة القانونية كاملةً بدلًا من أول 800 حرف (كانت النتيجة السابقة 69.1‎%‎). وفي المواد المعدّلة منذ 2024، يرتفع أداء النموذج من 25‎%‎ إلى 81‎%‎.

اعرض الأرقام في جدول
المهمةالنموذجبلا مكتبةبلاسيبومع lib2027
توثيق ويب حديث (devdocs، سبتمبر 2026)
150 سؤالًا · qwen3.8-27b		qwen3.8-27b17.8‎%‎12.7‎%‎85.1‎%‎
الأسئلة نفسها بنموذج صغير
150 سؤالًا · 4B		4B9.1‎%‎0.4‎%‎83.1‎%‎
القانون الروسي (15 مدونة قانونية، pravo.gov.ru)
150 سؤالًا · qwen3.8-27b		qwen3.8-27b34.7‎%‎33.8‎%‎84.4‎%‎¹
اختبار أسئلة عن API في three.js r186
90 إجابة · Claude Haiku 4.5		Claude Haiku 4.527.8‎%‎—88.9‎%‎

أبعد من الاختبار: three.js مع Claude Haiku 4.5

إجابات تستخدم API قديمًا

24.4‎%‎5.6‎%‎

الأقل أفضل

مهمة «اكتب لعبة»، الدرجة من 100

5275

الأعلى أفضل

عدد الجولات لإكمال اللعبة

5636

بتكلفة أقل قليلًا

مكتبة لم يرها النموذج من قبل

2–5‎%‎84–96‎%‎

ترتفع نسبة المهام التي ينجح فيها نموذج 4B من 2–5‎%‎ إلى 84–96‎%‎ عندما يوصل lib2027 ملاحظات الترحيل إلى المهمة.

الخلاصة

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

السرعة: Rust مقابل إصدار Python السابق

قيست على Windows مع RTX 5090، على الرف نفسه وبالاستعلامات نفسها. ويعيد الإصداران النتائج نفسها: في اختبار القانون، أوصل كلاهما المادة المطلوبة في 122 من أصل 150 سؤالًا.

  • Python + PyTorch
  • lib2027 (Rust)
الأقل أفضل
البحث الهجين، الوسيط (GPU)
Python + PyTorch207 ms
lib2027 (Rust)103 ms
البحث المعجمي
Python + PyTorch39 ms
lib2027 (Rust)5 ms
البحث على CPU فقط
Python + PyTorch4.4 s
lib2027 (Rust)1.7 s
743 ألف مقطع (devdocs)، لكل استعلام
Python + PyTorch~0.4 s
lib2027 (Rust)0.15 s
جاهزية خادم MCP لاستقبال initialize
Python + PyTorch2.6–3.8 s
lib2027 (Rust)< 0.2 s
add ./docs (6 مستندات، 237 مقطعًا)
Python + PyTorch36.6 s
lib2027 (Rust)8.6 s
بناء 15 مدونة قانونية (16 ألف مقطع)
Python + PyTorch169 s
lib2027 (Rust)127 s
تحليل 7,170 ملفًا
Python + PyTorch136 s
lib2027 (Rust)4.1 s
التثبيت

Python + PyTorch: Python + PyTorch، نحو 2.5 GB

lib2027 (Rust): Node.js + ملف تنفيذي بحجم 7 MB؛ وتُنزَّل بيئة التشغيل والنماذج عند أول تشغيل

آلية العمل

ثلاثة أنواع من البحث، وإجابة واحدة مرتّبة

يمر كل استعلام عبر ثلاث قنوات في آنٍ واحد. تُدمج النتائج ويُعاد ترتيبها، فتحصل أنت أو وكيلك على مقاطع كاملة للقراءة والاستشهاد، لا على شذرات متفرقة.

المعنى

يعثر البحث الدلالي بنموذج التضمين Qwen3-Embedding-0.6B على المقاطع التي تقول الشيء نفسه بكلمات أخرى.

صيغ الكلمات

تحليل صرفي للروسية والإنجليزية و13 لغة أخرى: ابحث عن صيغة واحدة للكلمة تجد صيغها الأخرى.

أسماء API الدقيقة

تُطابَق أسماء الدوال والأصناف والخيارات تطابقًا تامًا، فيعثر الاسم على الشيء نفسه لا على ما يشبهه.

إعادة الترتيب

يقرأ المُرمِّز المتقاطع bge-reranker-v2-m3 كل نتيجة مرشّحة مع الاستعلام، ويضع الأفضل في المقدمة.

مواد كاملة

تُحفظ بنية المستند. تُقسَّم القوانين إلى مواد وتُسلَّم المادة كاملة: وهذا ما رفع نتيجة اختبار القانون من 69.1‎%‎ إلى 84.4‎%‎.

الصيغ: md، txt، html، pdf، docx والشيفرة المصدرية (js، ts، json، …). ويضيف npx lib2027 package <name> حزمة npm كاملة: أنواع API والتوثيق والاختبارات والأمثلة.

للوكلاء

اربطه بـ Claude Code و pi و Cursor وغيرها من عملاء MCP

يعمل lib2027 كخادم MCP. أمر واحد يكفي لربطه، وبعدها يبحث الوكيل في مكتباتك بنفسه.

Claude Code

npx lib2027 claude

يشغّل claude mcp add نيابةً عنك. ويحصل Claude Code على هذه الأدوات:

  • search_knowledge
  • read_source
  • list_libraries
  • check_code
  • explore_graph

pi

npx lib2027 pi

يثبّت محوّل MCP في pi ويربط lib2027. والأمر npx lib2027 pi --remove يفصله.

Cursor و Claude Desktop وعملاء آخرون

أضف هذا إلى إعدادات MCP:

{ "mcpServers": { "lib2027": { "command": "npx", "args": ["-y", "lib2027", "mcp"] } } }

على Windows، شغّل npx عبر cmd:

{ "mcpServers": { "lib2027": { "command": "cmd", "args": ["/c", "npx", "-y", "lib2027", "mcp"] } } }

تفضّل المتصفح؟ يفتح npx lib2027 واجهة الويب على http://127.0.0.1:2027، ومعها HTTP API.

الأوامر

ملف تنفيذي واحد وبضعة أوامر.

الأمروظيفته
add <folder|files…> [--name …] [--lang auto|ru|en|…] [--to slug]يتحوّل المجلد إلى مكتبة، أو تُضاف الملفات إلى المكتبة المحددة. وإعادة التشغيل تحدّث الملفات التي تغيّرت.
listالمكتبات على الرف
search "query" [-l slug] [--top-k 5]البحث
remove <slug> / restore <slug>إخفاء من البحث / إعادة (تبقى الملفات على القرص)
package <npm-package>[@version]حزمة npm كاملة: أنواع API والتوثيق والاختبارات والأمثلة
ui [--port 2027] [--no-open]واجهة الويب و HTTP API (مثل التشغيل دون أمر)
mcpخادم MCP عبر stdio (يشغّله الوكيل)
claude [--scope user|project]يشغّل claude mcp add نيابةً عنك؛ وفي غياب Claude Code يطبع إعدادات للعملاء الآخرين
pi [--project] [--remove]يثبّت محوّل MCP في pi ويربط lib2027 (أو يفصله)
ask "question"إجابة مع استشهادات موثّقة (يتطلب مفتاح نموذج: LIB2027_ANSWER_*)
setup [--device cuda|directml|cpu]يثبّت بيئة التشغيل والنماذج مسبقًا
doctorيعرض ما هو مثبّت وعلى أي عتاد تجري الحسابات

يعمل حيث تعمل

المنصات

المنصاتCUDADirectMLCPU
Windows x64✓✓✓
Windows arm64——✓
Linux x64glibc 2.35+✓—✓
Linux arm64glibc 2.35+——✓
macOS Apple Silicon——✓

التسريع

NVIDIA CUDA على Windows و Linux بمعمارية x64، و DirectML على Windows بمعمارية x64. وكل ما عدا ذلك يعمل على CPU.

ما تحتاج إليه

Node.js 18+ فقط. عند التشغيل الأول يُنزَّل الباقي إلى ~/.lib2027 مرة واحدة، في نحو دقيقتين: بيئة تشغيل ONNX تناسب عتادك ونموذجان، هما Qwen3-Embedding-0.6B و bge-reranker-v2-m3.

مستنداتك تبقى على جهازك

محلي بطبيعته

تبقى مستنداتك والرف على جهازك، ويجري البحث داخل الملف التنفيذي على GPU أو CPU الخاص بك.

لا يُرسَل شيء إلا بطلبك

لا يذهب النص إلى طرف ثالث إلا إذا ضبطت نموذجًا خارجيًا لخدمة الإجابات (LIB2027_ANSWER_*).

localhost افتراضيًا

من دون LIB2027_API_KEY، لا تحتاج واجهة الويب و HTTP API إلى مفتاح، ولا يمكن الوصول إليهما إلا من localhost.

مجلد عادي

تتكوّن كل مكتبة من library.sqlite و vectors.f16 و knowledge.json. انسخ الرف واحمله معك أينما ذهبت.

الترخيص

مجاني الاستخدام، بما في ذلك الاستخدام التجاري، على أي عدد من الأجهزة. مغلق المصدر. يجوز لك إعادة توزيع الحزم دون تعديل. وتُنزَّل النماذج و ONNX Runtime من ناشريها بموجب تراخيصهم الخاصة.

اقرأ الترخيص على npm

جرّبه على مستنداتك

أمران فقط، وكل ما تحتاج إليه هو Node.js 18+.

# ضع مجلدًا على الرف
$ npx lib2027 add ./docs
# افتح واجهة الويب → http://127.0.0.1:2027
$ npx lib2027
الحزمة على npm