مرحبًا بك في كاظمة

كاظمة (Kazma) هي إطار متعدد المنصات لوكلاء الذكاء الاصطناعي المستقلين، مبني على عقل مُشرف عبر LangGraph، وتنسيق السرب، والإرسال متعدد المنصات (Telegram / Discord / Slack / الويب / TUI)، وطبقة مُزوّدات نماذج لغوية متوافقة مع OpenAI — مع دعم من الدرجة الأولى للّغة العربية / RTL وبروتوكول محادثة يحاكي الثقافة الخليجية (المجلس).

اعتبارًا من v0.11.0 (Hands)، كاظمة هي الوكيل المستضاف ذاتيًا الذي يعدّل مستودعك ويراسل فريقك ويجدول حياتك — ويتوقف أو يسأل أو يفشل بصدق بدل اختراع إجابة. الدردشة هي الصفحة الرئيسية (/ → /chat). file_apply_patch_set بطاقة HITL واحدة. محرّر /ide هو CodeMirror 5. kazma acp هو مسار المحرّر الصناعي. ما زالت تشمل IDE محايدًا للنقل، واسترجاع RAG لكل دور بتضمينات قابلة للتوصيل (sqlite-vec محليًا وpgvector مع Postgres)، وخزنة أسرار مشفّرة، وعمال سرب ذاتيي التوسّع، واستمرار ثنائي الخلفية (SQLite افتراضيًا، وPostgres اختياري لـ SaaS)، وسجل مهام لحلّ القصد الدائم، وTurn Delivery V2، وناشر X عبر الـ API الرسمي، وبوابات إنتاج صلبة.

هذه الوثائق مرجع مُعاد بناؤه من الصفر ومُتحقَّق من الكود: كل ادعاء وقائعي يمكن تتبّعه إلى المصدر، وكل ما هو غير مُنفَّذ بعد يُشار إليه صراحةً.

مصدر الحقيقة: وثائق المنتج تعيش أيضًا في المستودع الأحادي تحت docs/docs/ (Docusaurus). يطابق موقع التسويق أدلة المشغّلين؛ فضّل المستودع الأحادي لأحدث كتيّبات التشغيل (WSL، Postgres، DR).

البداية السريعة

ثبّت الإطار، واضبط مُزوّدًا واحدًا، وأرسل أول رسالة في أقل من 10 دقائق.

البنية المعمارية

حلقة ReAct للمُشرف، ونظام IDE الفرعي، ومخططات تدفق البيانات، وتفاصيل الأنظمة الفرعية.

الإعدادات

كل مفتاح في kazma.yaml، وكل متغير بيئة، ونموذج تجاوز ConfigStore.

الأمان والسلامة

بوابات HITL الثلاث، بوابات الإنتاج الصلبة، سياسة YOLO، وسلوك الإغلاق عند الفشل.

قاعدة المعرفة ومتجر الروح

ذاكرة متجهة (Chroma)، استرجاع RAG لكل دور، ومتجر الروح المسيَّج للتحسين الذاتي.

السفر عبر الزمن وإعادة التشغيل

تسجيل لقطات الحالة (snapshots.db)، إعادة لف الخيط (/replay)، والتفريع (/fork).

نظام IDE الفرعي

محرك برمجة محايد للنقل، تحديد مساحة العمل عبر ContextVar، ووعي البيئة.

تنسيق السرب

ستة أنماط، توجيه تلقائي، عمال ذاتيو التوسّع، وطبقة الموثوقية.

البريد

Gmail وMicrosoft — OAuth أو IMAP أو POP — مع صندوق sandbox بلا إعداد.

ناشر X

الـ API الرسمي لـ X فقط. ألّف وخطِّط في استوديو X (/x). أدوات المحادثة دائمًا HITL؛ نقرة الويب هي الموافقة.

إلى أين تتجه بعد ذلك

• جديد على كاظمة؟ ابدأ بـ البداية السريعة.
• تُقيّم الإطار للإنتاج؟ اقرأ البنية المعمارية، ثم الأمان والسلامة والنشر.
• تُدير نسخة قيد التشغيل؟ انتقل إلى استكشاف الأخطاء وإصلاحها ومرجع CLI.
• Postgres / متعدد المستخدمين؟ انظر النشر → Postgres وSaaS.
• المكتبة المعرفية؟ المكتبة المعرفية · البحث على الويب؟ البحث على الويب.
• النشر على X؟ ناشر X — استوديو X (/x) مقابل المجدول (/scheduled).

ما الجديد (2026-09-10) — Hands 0.11

المجال	التغيير
الدردشة هي الصفحة الرئيسية	GET / يحوّل إلى /chat. التشغيل الأول يطلب مفتاح مزوّد واحد ونموذجًا واحدًا. أدوات الفحص تحت More.
حلقة الترقيع Hands	file_apply_patch_set بطاقة HITL واحدة (فروق -/+). verify=true يشغّل pytest القريب. المشرف يعيد المحاولة بعد TESTS FAILED (حد أقصى 3).
محرّر /ide	CodeMirror 5 fromTextArea (nord). الملف يظهر حتى لو حُجب الـ CDN. Monaco لم يعد مستخدمًا. أوامر git للقراءة ليست HITL.
ACP	kazma acp يرسل فروقًا منظَّمة؛ session/cancel يلغي الدور. إعداد Zed في مرجع CLI.
السجن	KAZMA_CODE_EXEC_DOCKER=force يمنع shell_exec على المضيف إلا مع KAZMA_HOST_SHELL=1.

ما الجديد (2026-09-03)

المجال	التغيير
بطاقة المهمة الحيّة	سطح واحد لحالة الدور في الدردشة: عنوان الطور الحيّ، والوقت المنقضي، وعدد الخطوات، والعدّ التنازلي للمراقب — مع بطاقات الموافقة تُعرض داخل المحادثة نفسها. البطاقات المحسومة تنتقل فوق الرد المتدفّق وتنطوي في سطر واحد مع شريحة القرار.
سجلّ بوابات HITL	قاعدة hitl_gates.db هي صاحب القرار الوحيد: بطاقة واحدة، صف واحد؛ والموافقة الثانية تُجاب بـ 409. الرفض التلقائي للمراقب يُدوَّن مزدوجًا في البوابة، فالبطاقة غير المجابة تُحسم حتميًا بدل تعليق الدور. بطاقات الموافقة تعدّ تنازليًا حتى موعد الرفض التلقائي.
Turn Delivery V2	يوميات الدردشة هي مصدر الحقيقة؛ close_turn هو المُغلِق الوحيد؛ والعميل يعرض الإسقاط. أصلح القطع نفسه البطاقات الشبحية والفقعات المكررة والتوسيعات التلقائية لسلسلة التفكير.
موجات تدقيق الأمان 0–8	تثبيت IP لمسار SSRF في الكشط المباشر (إحباط الأقران الخاصّة)، ومواءمة PBKDF2 لكلمة مرور الدخول مع الخزنة (600 ألف)، ومقترحات محصورة بالمستأجر، وHITL ثلاثي الحالات لـ FanOut، وإحباط الأقران، وسجلّ بوابات مُحصَّن فاشل-مغلق.
خريطة التشخيص (صفحة جديدة)	خريطة من العَرَض إلى العنصر إلى الثابت لأنظمة كاظمة متعددة المسارات (الدردشة/HITL/الذاكرة/السرب): ما العنصر المشترك، وكم مسارًا يخدمه، وأين تنظر أولًا. انظر خريطة التشخيص.

ما الجديد (2026-08-31)

المجال	التغيير
استوديو X	مؤلّف /x ومخطِّط X فقط: انشر الآن، جدوِل، أعد الجدولة، قفزات الخيط، احذف تغريدة حيّة، حمّل مسودة (proposal_id — النص المخزَّن يفوز). x_post في المحادثة يبقى HITL دائمًا. كل الجداول يفتح /scheduled.
الخط والعلامة	IBM Plex Sans / IBM Plex Sans Arabic في الواجهة وهذه الوثائق والمستندات المُولَّدة. حرف K هو الشعار والأيقونة. Amiri احتياط نسخي.
الحارس --reload	قتل النشر لا يُعامل كتحطّم، فلا ينتظر التحميل الخامس 300 ثانية. أعد تشغيل KazmaAgent مرة إن كان الحارس القديم ما يزال يتسلّق.

ما الجديد في 0.6.x (ملخّص)

المجال	التغيير
المنفذ الافتراضي	kazma serve يربط 127.0.0.1:9090 (كان 8000). Docker يطابق المضيف 9090 → الحاوية 8000.
Postgres	اختياري KAZMA_DATABASE_URL + extra [postgres] لـ ConfigStore وجلسات الدردشة ومهام السرب ونقاط حفظ LangGraph.
الإنتاج	KAZMA_PRODUCTION=1 يشدّد YOLO وcode_exec Docker ومفتاح الخزنة وجذر مساحة العمل وأدوات MCP غير الموثوقة.
المصادقة	رفض افتراضي لـ /api/*؛ كوكيز kazma-session معتمة؛ OIDC اختياري + RBAC للمنصة.
الواجهة	نظام أيقونات SVG؛ تباعد تنقّل الجوال؛ لوحة التحكم تعرض خلفية Postgres عند التفعيل.
وثائق المستودع	شجرة Docusaurus واحدة تحت docs/؛ الأشجار المزدوجة القديمة مؤرشفة.
البريد	email-manager أصلي: sandbox، Gmail OAuth/IMAP/POP، Microsoft Graph؛ الإعدادات → البريد؛ HITL على الإرسال/الحذف/التصنيف.
البحث على الويب	أدوات الدردشة: تصفّح read_url، crawl_site، هضم في مساحة العمل — بلا أمر slash منفصل /research.

إرث الاسم

كاظمة كانت منطقة ساحلية قديمة في الكويت — اشتهرت كشبكة واحات حيوية من الآبار المائية وبوابة تجارية استراتيجية تربط حضارات متمايزة. كما كانت موقعًا لـ معركة السلاسل الأسطورية (ذات السلاسل، 633 م)، حيث حطّم التنسيق الصارم الموحّد خطًّا دفاعيًا صلبًا عبر مناورة لامركزية دقيقة.

يرث الإطار هذه المبادئ البنيوية الثلاثة — مُوصوفة بأمانة، كما يُنفّذها الكود اليوم:

• الآبار ← الذاكرة. ذاكرة متجهة طويلة الأمد (Chroma) مع استرجاع اختياري لكل دور، وأدوات memory_search / memory_store صريحة. (انظر الذاكرة وRAG.)
• البوابة ← التوجيه. مُشرف LangGraph واحد يُوجَّه إلى قنوات عديدة — Telegram وDiscord وSlack والويب وTUI — عبر طبقة مُكيّفات واحدة. (انظر البوابات والمنصات.)
• السلاسل ← الثقة. كل مهارة موقّعة بـ HMAC وكل إجراء خطير يمرّ عبر ثلاث بوابات مستقلة للموافقة البشرية في الحلقة. (انظر الأمان والسلامة.)

أمانة الوثائق: تميّز كاظمة بين ما يفعله الكود اليوم وما تدّعيه النصوص القديمة. الميزات الموصلة جزئيًا فقط تُعلَّم داخل النص تحت «ملاحظات الحالة الأمينة» — أبرزها في الذاكرة وRAG واستكشاف الأخطاء وإصلاحها.