واجهة الويب

واجهة الويب

السطح الرئيس للمشغّل هو kazma-ui: ‏FastAPI + قوالب Jinja + Alpine.js + بث SSE.

البدء

kazma serve          # default 127.0.0.1:9090
# or
python serve.py

افتح http://127.0.0.1:9090 (أو KAZMA_HOST/KAZMA_PORT الخاص بك).

الصفحات الرئيسة

الصفحة	المسار	الغرض
الدردشة	/ أو مسار الدردشة	دردشة وكيل ببث SSE ‏(sse_chat/، streaming.js)
لوحة التحكم	/dashboard	الرصد + الذاكرة والحوكمة (لوحة صحة، مستكشف رسم خصائص L2، نسخ احتياطية)
الإعدادات	/settings	النماذج، والموفّرات، والسلامة، والحساب، والصوت (?tab=voice — منتقيات STT/TTS؛ تبقى المفاتيح في الموفّرات)، والبريد الإلكتروني (?tab=email)، والمستندات (?tab=documents)، ونبذة عني (تبويب الذاكرة)، والاحتفاظ بسجل خطوات الدردشة وسجل مهام السرب، والحد الزمني للدور (المدة التي يجوز أن يعمل فيها الدور قبل إيقافه، على كل سطح؛ 0 = بلا حد، و/long يرفعه عن دردشة) وموفّر البروكسي (تبويب النظام)، وتنزيل نسخة احتياطية من الإعدادات واستعادتها مع التراجع عن آخر استعادة (تبويب النظام؛ تعرض الاستعادة ما سيتغير أولًا وتُبقي مفاتيحك، الإعداد)
مستوى تحكم الموفّرات	/settings?tab=providers_connectors	رئيس-تفصيل على كل موفّر: شريط حالة + شريط حافة لكل صف، وشارات قدرات معلنة، وحقائق سلكية (URL الأساس، وإصدار API يُقرأ منه)، واختبار — GET /models زائد إكمال دردشة حقيقي (reachable مقابل chat_ok). تُستبعد نماذج الكلام (Whisper)؛ يعيش STT في تبويب الصوت. حلّ المفتاح/النموذج يركب مسارات السجل نفسها التي تركبها رسالة حقيقية.
السرب / مركز القيادة	/swarm	العمال، والمهام الحية، وواجهة الإرسال
السفر عبر الزمن	/replay	متصفح خط زمني للقطات، واستعادة (إرجاع)، وتفرّع (فرع)، ومقارنة الفروق، وأحداث لقطات SSE حية
البحث	/research	بدء بحث عميق (جلسات SSE حية)، وقائمة نتائج، وأرشيف، ومقارنة، وتصدير
المستندات	/documents	ذكاء المستندات: رفع، ومكتبة، ومعاينة محتوى، ومكتبات المعرفة، وتحويل/تقسيم/تنقيح، وسجل المهام، ولوحة تشغيل (السعة، والجاهزية، والتدقيق، وتجربة GC الجافة + التأكيد)
IDE	/ide	محرر CodeMirror 5، وملفات مساحة العمل، وتطبيق الرقع، والتشغيل، وgit، وتحرير بمساعدة الذكاء الاصطناعي
استوديو X	/x	تأليف، وجدولة، وإعادة جدولة، وقفزات الخيوط، وحذف تغريدة منشورة، وتحميل المسودات المحفوظة. نقرة المشغّل هي الموافقة. كل الساعات يفتح /scheduled.
المجدول	/scheduled	ساعة مختلطة: مهام cron ومنشورات X
تسجيل الدخول	/login	سر / مستخدم محلي / OIDC

صفحة المستندات (مسار المنتج)

1. أفلِت ملفًا أو اختره (مع فرض OCR اختياريًا). الرفع الذي يتجاوز حدًّا (الحجم، أو الحد الأدنى للمساحة الحرة في التخزين، أو الطابور، أو سقوف المستأجر أو معدله) يُرفض قبل أن يقرأ الخادم الملف، وتعرض الصفحة السبب.
2. تسرد المكتبة معرّفات معتمة + حالة المعالجة (received … ready / حالات فشل). في تثبيت بمشغّل واحد تكون الصفحة وأوامر الدردشة وأدوات الوكيل كيانًا واحدًا هو المشغّل، فتظهر هنا أيضًا المستندات التي استوردها الوكيل؛ ومع مستخدمي المنصة تسرد الصفحة ما يملكه المستخدم المسجّل دخوله أو ما مُنح له.
3. التفصيل: معاينة محتوى مسيَّجة (أول 8,000 حرف، dir="auto" للاتجاه المزدوج)، وإصدارات، ومهام مع سجل أحداثها (Cancel أثناء عمل المهمة، وRetry للمهمة المحوّلة إلى الرسائل الميتة أو المرفوضة)، ومكتبات المعرفة التي يقع فيها المستند (إضافة، أو إزالة، أو إنشاء مكتبة)، وتحويل / معلومات PDF / تقسيم / تنقيح عندما تكون المحركات جاهزة (التنقيح يسأل أولًا)، والمخرجات مع تنزيلاتها، وDelete / Archive (يسأل أولًا؛ يغادر المستند كل مكتبة، ويستعيد جمع القمامة بايتاته لاحقًا).
4. بطاقة التشغيل: السعة degraded_reasons، والطابور (العمق، وعقود الإيجار، وانتظار إعادة المحاولة، والرسائل الميتة)، والتخزين والحصة، والجاهزية (مهام/بيانات وصفية متعددة النسخ)، وإشعار حين تحتاج الإعدادات المحفوظة إلى إعادة تشغيل، وسجل التدقيق، وتجربة GC الجافة → kazmaConfirm → تشغيل. سجل التدقيق وGC للمشرفين: لأي شخص آخر يبقى السجل فارغًا ويقول GC إن صلاحيات المشرف مطلوبة.
5. الإعدادات → المستندات للحدود الحية، وOCR (بما فيه قراءة الجداول المسطّرة في الصفحات الممسوحة)، وإعدادات البرمجيات الخبيثة والتدرج دون تحرير YAML.

REST: ‏/api/documents/* · الدليل: ذكاء المستندات · التشغيل: معالجة المستندات.

مقاييس لوحة التحكم

تُغذَّى البطاقات من TraceStore في الذاكرة (تتبعات LLM/الأدوات) مضافًا إليه حالة ميزانية قاطع دائرة التكلفة:

البطاقة	المصدر	ملاحظات
التكلفة الإجمالية	إجمالي TraceStore + قاطع التكلفة	تعيد الواجهة البرمجية أرقامًا؛ تنسّق الواجهة $…. يُصفَّر عند إعادة تشغيل العملية.
الرموز الإجمالية	TraceStore	عمر العملية نفسه كالتتبعات.
استدعاءات الأدوات	TraceStore ‏(trace_type=tool)	تتبعات عامل أدوات المشرف.
قاطع الدائرة	قاطع التكلفة (OK / WARNING / HALTED)	ليست قواطع عمال السرب.
زمن التشغيل	وقت بدء TraceStore	عمر عملية المفردة للمخزن.

يدفع GET /api/dashboard/status وWebSocket ‏/ws/dashboard مقاييس رقمية (تُحلَّل الأشكال النصية القديمة مثل "$0.00" / "1,234" بأمان في dashboard.js). ما زال رموز/تكلفة تذييل الدردشة في الدور يأتي من حدث SSE ‏done لتلك الجلسة.

يرسم الرموز عبر الوقت والتكلفة عبر الوقت ما أُنفق فعلًا، من سجل استدعاءات النموذج لكل استدعاء (GET /api/dashboard/usage?range=hour|day|week، للمسؤولين): كل عمود هو رموز فترة واحدة أو تكلفتها، فيبقى السجل بعد إعادة التشغيل وإعادة تحميل الصفحة. تعرض 1H اثني عشر عمودًا كل منها 5 دقائق، و24H أربعة وعشرين عمودًا بالساعة، و7D ثمانية وعشرين عمودًا كل منها 6 ساعات؛ ويتحدّث المخططان مرة كل دقيقة. وحتى 2026-10-22 كانا يرسمان المجاميع التراكمية للبطاقات كما أخذتها الصفحة المفتوحة، فلم تكن إلا تزداد وتضيع عند إعادة التحميل.

تتحدّث مؤشرات جودة الإجابات (للمسؤولين) كل 10 ثوانٍ. وتُبقي القراءة الفاشلة آخر قراءة على الشاشة؛ وتضيف قراءة فاشلة ثانية متتالية “تعذر التحديث؛ تُعرض آخر قراءة.”

الذاكرة والحوكمة (لوحة التحكم)

• صحة المكوّنات من build_memory_health() (رصة V2، والمضمِّن، والحزم، وحقن Neo4j/KB اختياريًا).
• طوبولوجيا V2 على كانفاس لوحة التحكم (رسم المعتقدات؛ رسم SQLite افتراضيًا).
• نسخ احتياطية/صيانة لمخازن الذاكرة.

إدارة الذاكرة (/memory)

صفحة تشغيل مخصصة (ليست الشريط الجانبي للدردشة):

المنطقة	ما يمكنك فعله
الرسم والصحة (الأعلى)	كانفاس المعتقدات، ومؤشرات الأداء، والفحص، وتحديث/تصدير؛ لافتة اقتطاع عند بلوغ السقف (عقد واتصالات مخفية)
الكيانات	إعادة تسمية تسميات العرض، ودمج/ربط الأصداف، وحذف الفارغة، وانقر صفًا → تركيز الرسم. ترقيم صفحات + بحث غير حساس للتشكيل/واعٍ بالكنى. الفحص: Group under / Ungroup (عرض فقط)
المعتقدات	بحث (FTS5)، وEdit للثلاثية (نافذة واحدة)، وإبطال دفعة مع [Undo]؛ وانقر صفًا → تركيز طرفي الحافة + رؤية سجل “recalled N×”
الدموج المعلقة	موافقة/رفض الحجر؛ يعرض الدمج إيصالًا بعدد المعتقدات المعاد توصيلها
النظافة	إفراغ الفارغ، وإزالة تكرار المُشار إليه، وأرشفة الميت (معاينة العدادات قبل التشغيل)
هوية المحور	إعادة تسمية الشخص User / ent_… إلى Mubder تحدّث محور الكانفاس (ليست عقدة «You» ثانية)

عزل متعدد المستأجرين: تُحصر الذاكرة بمستأجر الطلب مع KAZMA_MEMORY_ENFORCE_TENANT=1، في الإنتاج ومع تعدد المستخدمين — كل مسار /api/memory، بالعدادات والنظافة؛ طابور مهام الذاكرة وإعادة التوحيد والتقييم الذهبي للمشرف فقط. الواجهات تحت /api/memory/v2/*. الدليل الكامل: الذاكرة وRAG · أفضل مسار للذاكرة. التدقيق: AUDIT_MEMORY_SYSTEM_2026-08-24.md. ما تبقى للتوسيع: MEMORY_REMAINING.md.

يمر البحث / الكشط عبر أدوات الدردشة ولوحة البحث نموذج البدء + جلسات SSE حية (انظر بحث الويب). جولة في أحدث رصة: الميزات الحديثة.

الذاكرة المستخدمة (في كل دور)

الدور الذي استخدم ذاكرة يعرض صف Memory used في نشاطه: الحقائق وذكريات المحادثات الماضية والملخصات الأسبوعية ومقاطع المكتبة التي عُرضت على النموذج، معدودةً ومسردةً. تُخزَّن مع الدور (إعادة التحميل تعرضها) وتظهر في كل تبويب يراقب الدردشة. مع تفعيل الإعدادات → الذاكرة → Explain recall (الافتراضي)، يسمّي كل سطر القنوات التي وجدته (fts5، dense، belief_ppr، kb_rrf، …). فحص لوحة التحكم يستخدم الوسوم نفسها؛ Run golden eval يشغّل مجموعة الاسترجاع الذهبية.

البريد الإلكتروني (الإعدادات → البريد الإلكتروني)

صِل صناديق بريد حقيقية للوكيل دون إعداد عبر البيئة فقط:

البطاقة	الأنماط
الصندوق التجريبي	مفعّل دائمًا (صندوق بريد SQLite تجريبي)
Gmail / Workspace	OAuth (Gmail API) · IMAP · POP
Microsoft 365	OAuth (متصفح Graph أو رمز جهاز) · IMAP · POP

الواجهة: /api/email/status، وبداية/استدعاء OAuth، وPOST /api/email/protocol/connect. الدليل الكامل: تكامل البريد الإلكتروني.

تقدم البحث ونتائجه وإعدادات الجلب

تحتفظ زحوف البحث والمعرفة بحالة المهمة عبر إعادة التحميل. يحتفظ جرس الإشعارات العام بروابط اكتمال للنتائج وتنبيهات منفصلة للنتائج الجزئية والفشل والإلغاء والانقطاع. يحذر غياب التقدم المرصود بعد 180 ثانية افتراضيًا؛ ويزيل استئنافه التحذير. يبقى انقطاع البث وفشل تحميل قوائم النتائج ظاهرين في صفحاتهما.

توفر الإعدادات → النظام → جلب الويب قراءة الحالة المحفوظة دون طلبات للمزوّدين، وتحديث رصيد Firecrawl صريحًا مسموحًا، وقراءة إعدادات التنبيهات للمراقبة وإشعارات الاكتمال وعتبات انقطاع التقدم والرصيد المنخفض. تبقى الرسوم والأرصدة غير المدعومة مجهولة. تستخدم الإرسالات الخارجية مسارات التشغيل المضبوطة؛ وقبول المنصة وحده يثبت التسليم.

الجلب local_only افتراضيًا. يحتاج البديل المستضاف وضعًا صريحًا وإذن مزوّد عبر متغيرات البيئة الموثقة؛ ولا يفعّله مفتاح محفوظ. يظل التخطيط والكتابة باستخدام النموذج المختار. راجع البحث على الويب للاستئناف والاحتفاظ وحدود المنصات.

موفّر البروكسي (الإعدادات → النظام)

إضافة مرونة كشط اختيارية. يلزم وضع الجلب وإذن proxy في قائمة السماح بالإضافة إلى الإعدادات. عند السماح، تتجه مسارات الكشط والزحف عبر وكيل سكني دوّار (سلم httpx وPlaywright واكتشاف المعرفة وSERP من Bing/Wiki). تبقى SearXNG المحلية وواجهات Jina/Firecrawl وLLM مباشرة.

• الموفّر: ‏None (مباشر) أو anyIP.io (تدوير سكني/جوّال).
• الحقول: المضيف/المنفذ/اسم المستخدم/كلمة المرور (كلمة المرور مشفّرة بالخزنة)، ونوع الشبكة، والدولة اختياريًا، ومفتاح تبديل الجلسة اللاصقة.
• اختبار الاتصال يجلب api.ipify.org عبر البروكسي ويعرض IP الخروج.
• إعداد حي — يسري تغيير في الإعدادات دون إعادة تشغيل.

الواجهة: GET/PUT /api/settings/proxy، وPOST /api/settings/proxy/test.
مصفوفة التغطية: الميزات الحديثة → البروكسي · بحث الويب.

التنفيذ غير المتوقف والشفاء الذاتي (الإعدادات → الوكيل)

كلب مراقبة مشرف ذاتي الشفاء قابل للضبط وأدوات تحكم في تعطل النماذج لسير عمل ذاتي طويل الأمد:

• المفتاح الرئيس: تفعيل/تعطيل كلب مراقبة توقف المشرف والاستعادة الآلية لنقاط التفتيش.
• أدوات تحكم التوقف والمهلة: اضبط عتبة التوقف (الافتراضي 60s) ومهلة تنفيذ كل أداة (agent.tool_timeout_seconds، الافتراضي 120s).
• ميزانية الاستعادة: اضبط أقصى محاولات استعادة (الافتراضي 3) ومعاملات التراجع الأُسّي (backoff_base_seconds، backoff_max_seconds).
• سلسلة تعطل النماذج: بدّل التعطل وحدّد قائمة مرتّبة بنماذج الاحتياط مع فترات تهدئة لكل نموذج (الافتراضي 300s).
• سجل الاستدعاءات: بدّل تسجيل SQLite المتين (kazma-data/llm_calls.db) لكل استدعاءات LLM.
• دعم كامل لتدويل EN/AR وإعادة قراءة حية (get_nonstop_config()) — تسري الإعدادات فورًا دون إعادة تشغيل الخادم.

الواجهة: GET/PUT /api/settings/agent/nonstop. مصفوفة التغطية: الميزات الحديثة → التنفيذ غير المتوقف.

المصادقة

• مشغّل واحد: KAZMA_SECRET (تُفضَّل الجلسات المعتمة على ملف تعريف الارتباط الخام القديم).
• تعدد مستخدمين: مستخدمو المنصة + RBAC + OIDC اختياري — انظر SaaS متعدد المستخدمين.
• ترفض مسارات الواجهة البرمجية افتراضيًا عند ضبط السر.

أعراف الواجهة

• الحوارات: ‏window.confirm وwindow.alert وwindow.prompt متجاوزة عالميًا — كل استدعاء (حالي ومستقبلي) يمر عبر نافذة كاظمه المنسّقة (قائمة على Alpine). لا يزال بوسع المطورين كتابة if (!await confirm('Delete?')) والحصول على الحوار ذي الهوية. تبقى المساعدات kazmaConfirm / kazmaAlert / kazmaPrompt متاحة للاستدعاءات القائمة على الخيارات (العنوان، والخطر، وconfirmText، إلخ).
• زر إيقاف الدردشة: يتحول زر الإرسال إلى زر إيقاف أحمر نابض أثناء التوليد. انقره أو اضغط Escape لإجهاض بث SSE. يبقى حقل الإدخال مفعّلًا ليتمكن المستخدم من كتابة رسالته التالية بينما يعمل الوكيل.
• التنبيهات المنبثقة: ‏window.showToast / ‏Alpine ‏$store.toast.
• بعد التحديث: يعرض التبويب الذي فُتح قبل تحديث كاظمه تنبيهًا منبثقًا واحدًا «تم تحديث كاظمه. حدّث الصفحة لتحميل الإصدار الجديد.» مع زر تحديث. ويتحقق من إصدار الخادم حين يصبح التبويب مرئيًا وكل 5 دقائق؛ وإعادة تشغيل الإصدار نفسه لا تُظهر شيئًا.
• العودة إلى دور جارٍ: مغادرة الدردشة أثناء تشغيل دورها ثم العودة إليها، عبر الشريط الجانبي أو بتحديث الصفحة، تُظهر الدور حيًّا، بما في ذلك موافقة توقّف من أجلها. وبعد إعادة تشغيل الخادم تأخذ الصفحة موضع الخادم في يومية أحداث الدور بدلًا من الموضع الذي حفظته، والذي لم تعد اليومية تحتفظ به.
• أرشيف البحث: لكل بطاقة بحث زر أرشفة. تنتقل العناصر المؤرشفة إلى تبويب «Archived» (مع استعادة + حذف). يستخدم علم metadata.archived بصيغة JSON — دون ترحيل مخطط.
• التنقل بين الصفحات: رابط الشريط الجانبي يبدّل الصفحة دون إعادة تحميل كاملة (التنقل الناعم، static/js/modules/nav.js). تعمل سكربتات الصفحة الجديدة الخاصة بها في كل زيارة، وتُحمَّل السكربتات المشتركة في static/js/modules/ (آلية رسم الأدوار في الدردشة) مرة واحدة لكل إصدار، وتعمل سكربتات الهيكل الأساسي مرة واحدة مع تحميل الصفحة. حتى 2026-10-03 كانت السكربتات المشتركة تُتخطّى، فلا تُظهر الدردشة التي يُنتقل إليها من صفحة أخرى أي دور حتى إعادة التحميل؛ ويتحقق tests/test_soft_nav_page_scripts.py الآن من ألا يُترك أي سكربت تتضمنه أي صفحة.

السمات ورقائق التصميم

تعمل واجهة الويب على نظام تصميم «ABYSS» — جدول رقائق واحد لكل سمة، معرَّف في static/css/kazma.css (§1 الداكنة، §23 الفاتحة) مع صقل الهيكل في kazma.v5.css. تُطابَق الرقائق نفسها على موقع الوثائق (docs/src/css/custom.css).

الجانب	التفاصيل
اللوحة الداكنة	أردوازي أزرق-أسود عميق — الخلفية #0e1626، واللوحة #16223a، والنص #eef3fb. عمق طبقي (لوحة → سطح → مرتفع).
اللوحة الفاتحة	ورق أزرق جليدي — الخلفية #f0f4fa، واللوحة #ffffff، والحبر #0c1526. يُبقى النص الخافت داكنًا لتباين P0.
اللمسات	أزرق ملكي #3b82f6 (داكن) / #2563eb (فاتح) + سماوي #38bdf8. تدرّج العلامة azure → royal → sky.
الخطوط + العلامة	IBM Plex Sans / IBM Plex Sans Arabic ‏(--font-sans / --font-arabic) + JetBrains Mono. حرف الترويسة K هو الشعار والأيقونة والصورة الرمزية. الاقتران نفسه للمستندات المولّدة وDocusaurus.
جدول رقائق واحد	مصدر حقيقة واحد لكل سمة — لوحة v4 السماوية القديمة وطقم «Abyss» طُويا في جدول واحد فلم يعودا يتخاصمان (توحيد رقائق التصميم، P1).
سمة يحتكمها الخادم	تُحلّ السمة على الخادم، لا على العميل فقط، لذا يستمر اختيارك عبر الأجهزة والمتصفحات (تبديل على جهاز يثبت على آخر).
كانفاس داكن حقيقي	يحمل <html> قيمة color-scheme: only <theme> ويُطلى بخلفية السمة، فلم يعد بمقدور Safari على iOS أن يطلي كانفاس النظام الداكن فوق كاظمه الفاتحة.
هيكل الجوال	ترويسة معتمة + رصيف (بلا شفافية)، ومؤلِّف واعٍ بلوحة المفاتيح، وقائمة همبرغر متقاعدة، واختفى الشريط الميت لشريط الأيقونات 769–1280px.
إعادة تحقق HTML قسرية	ترسل القوالب ترويسات كسر التخزين المؤقت حتى لا تنجو صفحة مخزنة قديمة من نشر.
لا وميض x-show	‏x-cloak عالمي؛ كل لوحة x-show تحمل x-cloak أيضًا، وdisplay:flex المضمّن لا يجلس أبدًا على عنصر x-show (يعيش flex في صنف).

اضبط النظام بتحرير جداول الرقائق في kazma.css؛ يتبع موقع الوثائق القيم نفسها.

ذو صلة

• IDE · مركز القيادة · مسارات الواجهة
• النشر · استكشاف الأخطاء وإصلاحها