Skip to content
kazma.
البحث في كاظمة والتوثيق
EN نجمة 7 ابدأ الآن
الأسئلة الشائعة

أسئلة متكررة.

كل ما تحتاجه لتقييم كاظمة للإنتاج. لم تجد إجابة؟ افتح مسألة.

النشر

ما المنصات المدعومة؟
لينكس، macOS، ويندوز، دوكر، وWSL. انشر بأمر واحد `docker compose up` — حجمين، إيقاف آمن، بدون كود خاص بنظام التشغيل.
أين تُخزَّن البيانات؟
جميع حالة المستخدم توجد تحت `~/.kazma/`؛ وقواعد البيانات في `kazma-data/`. كل مسار قابل للتجاوز عبر الإعدادات أو متغيرات البيئة — لا مسارات مثبّتة في الكود.

Features

هل يمكنني الرجوع أو التفريع من محادثة؟
نعم — يلتقط Kazma حالة الوكيل الكاملة بعد كل تكرار للإشراف. استخدم /replay list لرؤية اللقطات، /replay <N> لإرجاع الخيط الحي إلى تلك النقطة، /fork <N> للتفريع إلى خيط جديد (الأصلي يبقى سليماً)، /replay compare <A> <B> لمقارنة لقطتين، أو لوحة /replay في واجهة الويب لجدول زمني مرئي مع أزرار الاستعادة والتفريع. تُحفظ اللقطات في kazma-data/snapshots.db.

عام

ما هي كاظمة؟
إطار مفتوح المصدر لبناء وكلاء ذكاء اصطناعي موثوقين وواعين ثقافياً. مبني على LangGraph مع نقاط حفظ SQLite أو Postgres اختياري، يصمد أمام الأعطال، ويتذكّر عبر الجلسات، ويفرض حدود الأمان — مع بوابة متعددة المنصات، وذاكرة RAG، وموافقة بشرية في الحلقة.
كيف أبدأ؟
استنسخ المستودع، شغّل `uv sync`، ثم أطلق `kazma-web` (واجهة الويب)، أو `kazma-tui` (الطرفية)، أو `kazma` (سطر الأوامر). يمكن لمستخدمي ويندوز تشغيل `.\setup.ps1`.

التعريب

هل تدعم كاظمة العربية؟
نعم — كاظمة مبنية بدعم عربي أصيل. تتعامل مع الفصحى ولهجات الخليج مع بروتوكول مجلس للسياق الثقافي الخليجي، بالإضافة إلى واجهة ثنائية اللغة كاملة.

المزوّدون

ما مزوّدو النماذج المدعومون؟
ثمانية عشر إعدادًا مسبقًا تُرفق خارج الصندوق عبر طبقة المزوّدين المتوافقة مع OpenAI — OpenAI وAnthropic وDeepSeek وGoogle Gemini (ADC) وGroq وxAI وOpenRouter وMistral وTogether وCohere وFireworks وPerplexity وAI21 وNVIDIA NIM، بالإضافة إلى الأوقات المحلية (Ollama، LM Studio). لدى Anthropic وAzure OpenAI وAWS Bedrock فئات مزوّدين أصلية مخصّصة (تستخدم مصادقتها/مخطّطها الخاص، وليس صيغة OpenAI)، لذا لا حاجة لبروكسي. سلسلة `models.router` تبوّب فرع احتياطي لوسيط LiteLLM، لكن LiteLLM نفسه لا يُستورد.

الأمان

كيف تُحكَم الإجراءات الخطيرة؟
بوابات موافقة بشرية ثلاثية تعترض العمليات الخطيرة على طبقات الرسم البياني وناقل السرب ونقاط تفتيش خطوط الأنابيب، ويحكمها سجلّ بوابات واحد (hitl_gates.db). الأدوات الخطيرة تتطلب موافقة بشرية على الويب وتيليجرام وديسكورد وسلاك، وتُغلق افتراضياً عند الفشل.

السرب

كيف يعمل تنسيق السرب؟
ستة أنماط إرسال — إرسال، بثّ، خط أنابيب، توزيع، استشارة (آراء مستقلة + تركيب)، وشرطي (موجّه) — بالإضافة إلى التوجيه التلقائي (اختيار العامل بناءً على القدرة). طبقة الموثوقية: RetryPolicy، CircuitBreaker، OutputValidator.
وجهاً لوجه

كاظمة مقابل أطر الوكلاء البديلة.

مقارنة تقنية للقدرات التي تهمّ في الإنتاج.

القدرة كاظمة SDK عام نمط الطاقم
بوابات موافقة بشرية ثلاثية
توقيعات مهارات مشفّرة (HMAC-SHA256)
تنفيذ دائم (SQLite / Postgres اختياري)
عربي أولاً + طبقة Majlis الثقافية
تنسيق السرب (6 أنماط + توجيه تلقائي)
بوابة متعددة المنصات (TG/Discord/Slack/Web)
قواطع دوائر ذاتية الشفاء
واجهة مزدوجة (ويب + SSH/TUI)
مفتوح المصدر — رخصة MIT