Skip to content

Latest commit

 

History

History
207 lines (143 loc) · 9.71 KB

File metadata and controls

207 lines (143 loc) · 9.71 KB

Polywise Logo Polywise

نظام المحتوى الوكيلي مفتوح المصدر

X Discord License npm

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

في الوضع الفاتح تظهر شمس مرسومة، وفي الوضع الداكن يظهر القمر مع النجوم.

ما هو Polywise

Polywise هو نظام محتوى وكيلي مفتوح المصدر. يمكنك استخدامه من سطر الأوامر أو من تطبيق سطح المكتب للدردشة مع النماذج، وحفظ المعرفة، واسترجاع السياق، وتحويل أساليب العمل المتكررة إلى وكلاء يمكن إعادة استخدامهم.

🚀 التثبيت

لدى Polywise طريقتان عمليتان للبدء: واجهة الأوامر CLI وتطبيق سطح المكتب.

CLI

ثبّت واجهة الأوامر بشكل عام:

npm install -g polywise

ثم شغّل خدمة Polywise المحلية:

polywise start
polywise start -d

الأمر polywise start يُبقي الخدمة في الواجهة. أما polywise start -d فينهي الأمر مباشرة ويترك الخدمة تعمل في الخلفية.

بعد ذلك افتح واجهة الويب على http://localhost:3072/app/ .

يمكنك تفعيل تسجيل الدخول عبر Auth من الإعدادات. بعد التفعيل وتعيين كلمة مرور، سيصبح تسجيل الدخول مطلوبًا للوصول إلى Web UI، وسيتم أيضًا حماية الـ API. هذا مهم جدًا إذا كنت ستنشر Polywise على خادم للوصول عن بُعد.

تطبيق سطح المكتب

حمّل أحدث نسخة من GitHub Releases.

إذا كنت تريد استكشاف الجلسات والمحتوى المحفوظ والوكلاء والمنشورات بدون الاعتماد الدائم على الطرفية، فتطبيق سطح المكتب هو الخيار الأسهل.

التشغيل الأول

عند أول تشغيل، يحتاج Polywise بشكل أساسي إلى:

  • مزوّد نماذج واحد متاح
  • نماذج embedding و rerank إذا كنت تريد استرجاع المحتوى المحفوظ

لا تحتاج إلى إعداد كل provider وكل integration من اليوم الأول.

⬆️ الترقية

CLI

polywise upgrade

تطبيق سطح المكتب

ثبّت أحدث إصدار من GitHub Releases.

⚡ بداية سريعة

إذا كنت تريد أقصر طريق للوصول إلى أول فائدة حقيقية:

  1. افتح Settings -> Model Provider واضبط مزودًا واحدًا يمكنك استخدامه فعليًا.
  2. افتح Settings -> Model Setting وتأكد من أن نموذج الدردشة الافتراضي متاح.
  3. انتقل إلى Session واسأل سؤالًا حقيقيًا بدلًا من إرسال hello فقط.
  4. احفظ ملاحظة قصيرة أو ملخص صفحة أو إجابة داخل Polywise.
  5. اذكر هذا العنصر المحفوظ مرة أخرى في الدردشة للتأكد من أن الاسترجاع يعمل.

🧭 الاستخدام

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

تطبيق سطح المكتب

يصبح فهم التطبيق أسهل عندما يكون لكل قسم وظيفة واضحة:

  • Session لطرح أسئلة حقيقية، وتخطيط العمل، والبقاء داخل سياق مساحة العمل
  • Linkcase لجلب محتوى الويب واستخلاصه داخل النظام
  • Agent لتحويل أساليب التعليمات المتكررة إلى مساعدين يمكن إعادة استخدامهم
  • Posts لحفظ المعرفة التي تستحق أن تعيش أطول من مجرد رد في الدردشة

هناك اختصاران من المفيد تعلمهما مبكرًا:

  • @ يجلب الملفات والوكلاء وسياقات أخرى إلى الجلسة
  • / يجلب الأدوات والمهارات إلى سير العمل

CLI

واجهة CLI هي غلاف خفيف فوق الـ backend API. افتراضيًا تتصل بـ http://localhost:3072؛ وإذا كان الخادم عندك في مكان آخر، فاضبط POLYWISE_SERVER_URL.

بدلًا من حفظ الأوامر، ابدأ من المساعدة:

polywise -h
polywise session -h
polywise session create -h

استخدم input_schema عندما تحتاج إلى شكل الإدخال الدقيق لأمر معين:

polywise input_schema session.create

أوامر شائعة:

polywise start
polywise start -d
polywise version
polywise session create --title "Daily Review"
polywise search fullTextSearch --query "vector database"
polywise save --for user --content "Key takeaway..."

عندما تصبح الحمولة أكثر تعقيدًا، يمكنك تمرير JSON مباشرة:

polywise search fullTextSearch --json '{"query":"agent memory","for_types":["wiki","memory"],"enable_recall":true}'

📚 التوثيق

🎬 Intro Video

Open the intro video file

💭 الدافع

تم بناء Polywise على قناعة بسيطة: الذكاء الاصطناعي الذكي فعلًا يحتاج إلى ذاكرة ذكية فعلًا. الفكرة ليست مجرد التخزين، بل بناء نظام يستطيع أن يكوّن الروابط بشكل طبيعي، ويزداد قوة مع الاستخدام، وينسى بشكل استراتيجي، ويواصل التطور.

📄 المراجع

استُلهم هذا المشروع من الأوراق البحثية التالية:

🙏 الشكر

يقف Polywise على أكتاف هذه المشاريع المفتوحة المصدر الممتازة:

Libraries & Tools

  • 🐘 Sqlite - قاعدة البيانات المضمنة عالية الأداء الأكثر انتشارًا في العالم
  • 🏹 sqlite-vec - يضيف البحث المتجهي إلى Sqlite
  • ⚛️ React - مكتبة واجهات أمامية
  • 🖥️ Electron - إطار عمل لتطبيقات سطح المكتب
  • 🔗 tRPC - واجهات API آمنة الأنواع من الطرف إلى الطرف
  • 📦 MobX - إدارة حالة بسيطة وقابلة للتوسع
  • 🎨 Tailwind CSS - إطار CSS بنهج utility-first
  • 🚀 Hono - إطار ويب فائق السرعة
  • 🛠️ Rsbuild - أداة بناء من الجيل الجديد مدعومة بـ Rspack
  • 📚 Rslib - أداة بناء مكتبات مبنية على Rsbuild
  • 🤖 AI SDK - مجموعة أدوات موحّدة لبناء تطبيقات مدعومة بالذكاء الاصطناعي
  • 🤗 node-llama-cpp – ربط Node.js مع llama-cpp للتعامل مع النماذج المحلية

📜 الترخيص

MIT – راجع LICENSE للتفاصيل.