تخطَّ إلى المحتوى
kazma.
EN نجمة 7 ابدأ الآن

المسرد

مصطلحات تُستخدم عبر كاظمة، بمعانٍ دقيقة مُستندة إلى قاعدة الشيفرة.

A

Section titled “A”

Adapter (platform) — مُكيّف المنصة صنف يترجم الأحداث الأصلية للمنصة (تحديثات Telegram، أحداث بوابة Discord، أحداث مقبس Slack) إلى IncomingMessage الخاص بكاظمة، ويُصيِّر OutboundMessage للخلف. جميعها توسِّع BaseAdapter (kazma-gateway/.../gateway.py:239). يختلف عن مُكيّف الناقل (bus adapter).

Adapter (bus) — مُكيّف الناقل مُكيّف منفصل لموافقات HITL الخاصة بالسرب (TelegramBusAdapter، DiscordBusAdapter، SlackBusAdapter)، وجميعها فئات فرعية من BusAdapter (kazma_core/swarm/bus.py:66). يُنشَّط واحدٌ منها فقط في كل مرة؛ الأولوية Telegram > Discord > Slack.

Agent handler — معالج الوكيل الجسر بين مُكيّفات المنصة ورسم المُشرف. أصبح الآن حزمة agent_handler/ (مُفكَّكة من ملف agent_handler.py القديم). يملك عزل المنصة.

Aggregation — التجميع طريقة دمج نتائج التوزيع المتعدّد (fan-out): collect، first_valid، merge_all، vote، synthesize (swarm/aggregator.py).

Authority (Context) — سلطة السياق ContextAuthority (authority.py) — يقرّر متى يُضغط (compact) المحادثة (عند 80% من نافذة السياق) ويستدعي CompactionEngine.

AutoScaler — الموسِّع التلقائي يُنشئ عمّال \{name\}-pool-\{n\} من قوالب عندما لا يجد التوجيه auto عاملًا قادرًا؛ ويُلغي (reaps) النسخ الخاملة.

B

Section titled “B”

Blackboard (pipeline) — اللوحة المشتركة (خط المعالجة) السياق المشترك الذي يُمرَّر بين مراحل خط المعالجة؛ ترى كل مرحلة مخرجات المراحل السابقة.

BlackboardStore — مخزن اللوحة المشتركة كائن المسودة المشتركة (scratchpad) الذي يُمرَّر بين عمّال خط المعالجة/التوزيع المتعدّد/الاستشارة؛ تقرأ كل مرحلة المخرجات السابقة وتكتب مخرجاتها.

Bounded concurrency — التوازي المحدود BoundedConcurrency (reliability.py:872) — غلاف لـ asyncio.Semaphore يحدّ من عمليات الإرسال المتوازية (الافتراضي 5).

Breaker (circuit) — قاطع الدائرة CircuitBreaker (reliability.py:238) — عازل إخفاقات ثلاثي الحالات (CLOSED/OPEN/HALF_OPEN). تسمح حالة نصف المفتوحة بتجربة واحدة بالضبط (probe) (_probe_in_flight).

Bus (message) — ناقل الرسائل المفرد (singleton) (get_message_bus()، bus.py:282) الذي يوجّه طلبات موافقة HITL الخاصة بالسرب إلى مُكيّف ناقل المنصة النشط.

C

Section titled “C”

Checkpointer — حافظ نقاط التفتيش طبقة استمرارية LangGraph (AsyncSqliteSaver على kazma-data/checkpoints.db) التي تخزّن حالة المحادثة ووقفات HITL.

CheckpointManager — مدير نقاط التفتيش swarm/checkpoint_manager.py — يملك حالة خط المعالجة الموقوف، يفعّل مهلات الرفض التلقائي، يحفظ إلى SQLite، ويستعيد عند إعادة التشغيل.

Classify (MCP tool) — تصنيف (أداة MCP) classify_mcp_tool() (mcp/manager.py:71) — يصنّف أداة MCP مكتشفة وقت التشغيل كـ danger/safe/unknown حسب نمط الاسم. المجهول يُعدّ خطرًا افتراضيًا.

Code-switch token — رمز تبديل الشفرة تسلسل إنجليزي/لاتيني مضمَّن داخل نص عربي، يُوسَم CODE_SWITCH بواسطة المُرمِّزين المزدوجين ليُحفَظ بدلًا من نقحرته أو تجذيعه.

CommandConsole — وحدة الأوامر شريط أوامر بأسلوب vim في TUI يُفعَّل بـ : (أدخل أوامر ex مثل :theme، :lang).

Compaction — الضغط CompactionEngine (compaction.py) — يُلخّص المحادثة عندما تقترب من نافذة السياق. في الربط الافتراضي، تعمل خطوة تلخيص LLM فقط (استرجاع الذاكرة + نقاط التفتيش no-ops).

ConfigStore — مخزن الإعدادات مخزن إعدادات زمن التشغيل المدعوم بـ SQLite (config_store.py) الذي يتجاوز kazma.yaml. مفرد عبر get_config_store(). WAL + busy_timeout=5000.

CONSULT — الاستشارة نمط سرب: جمع آراء متوازية من عدة عمّال، ثم توليف عبر LLM.

ContextAuthority انظر Authority.

CostCircuitBreaker — قاطع التكلفة cost_breaker.py — ينفصل عندما يتجاوز الإنفاق سقفًا (الافتراضي $0.50) بعد نافذة صمت (الافتراضي 5 دقائق). غير مربوط تلقائيًا في chat().

D

Section titled “D”

Danger tool — أداة الخطر أداة تتطلّب موافقة HITL قبل التنفيذ. هناك ثلاث قوائم (graph/swarm/MCP) — انظر الأمان والسلامة.

Delegation — التفويض تسليم مهام تاريخي بين الوكلاء بسلامة تشفيرية (Ed25519 / AES-GCM). مكتبة/أرشيف فقط اعتبارًا من 2026-07 — العمل الحي متعدد العمّال يستخدم تسليمات SwarmEngine، لا حزمة التفويض. يختلف عن MCP والمهارات.

DISPATCH — الإرسال نمط سرب: عامل واحد يعالج مهمة.

Dormant gate — بوابة خامدة بوابة HITL غير نشطة لأن hitl_config لم يُمرَّر عند بناء الرسم (كل الأدوات تذهب إلى safe_tools).

F

Section titled “F”

FAN_OUT — التوزيع المتعدّد نمط سرب: تنفيذ متوازٍ عبر العمّال بتوازٍ محدود، ثم تجميع.

Fallback chain — سلسلة الاحتياط احتياطات تسلسلية للعمّال بعد فشل الأساسي (reliability.py:734).

H

Section titled “H”

Handoff — التسليم نقل عامل لمهمة إلى عامل آخر أثناء التنفيذ. محدود بعمق 5 وزيارتين لكل عامل (handoff_guards.py).

HITL Human-in-the-Loop (الإنسان في الحلقة). لدى كاظمة ثلاث بوابات HITL مستقلة: مقاطعة الرسم (الدردشة)، ناقل السرب (الإرسال)، نقاط تفتيش خط المعالجة.

Hub — المحور سجل/سوق المهارات (kazma_core/hub/) مع التوقيع والشهادة والبحث (kazma hub …).

I

Section titled “I”

i18n — التدويل نظام ترجمة EN/AR المضمَّن في kazma-ui/kazma_ui/i18n.py (بلا ملفات منفصلة). يضبط dir/lang لكل طلب.

interrupt() أولية تعليق LangGraph، تُستدعى في tool_worker_node لأدوات الخطر. تُستأنف عبر Command(resume=...).

InProcessWorker تنفيذ العامل لنوعي in_process وtelegram_bot (worker_factory.py:17).

M

Section titled “M”

Majlis — المجلس بروتوكول المحادثة الثقافي الخليجي (majlis.py) — 4 مراحل: GREETING → SOCIAL → TRANSACTION → FAREWELL. وحدة جوهرية، لا مفتاح واجهة.

MCP Model Context Protocol. خوادم أدوات خارجية (stdio أو SSE) تُمرَّر إلى الوكيل. SSE يدعم مصادقة bearer؛ stdio لا يدعمها.

ModelRegistry — سجل النماذج المفرد على مستوى العملية (model_registry.py:81) الذي يدير المزوّدين والنماذج والاكتشاف والاختيار النشط. الاسم البديل: UnifiedModelRegistry.

O

Section titled “O”

OutputValidator — مدقّق المخرجات reliability.py:488 — يتحقّق من مخرج العامل مقابل نموذج Pydantic، أو JSON Schema، أو dict أنواع بسيط.

P

Section titled “P”

Phonebook — دليل الأسماء swarm/phonebook.py — استدعاء وإرسال مباشر يتجاوز طبقة الموثوقية؛ يُستخدم بواسطة منفّذي الطوبولوجيا/DAG. يحقن ذاكرة حلقية من مسار استدعاء V2.

PermissionLevel — مستوى الصلاحية طبقة وصول أدوات السرب: READ_ONLY، SYSTEM_EXEC، FULL_ACCESS. تُعيَّن لكل دور عامل.

Pipeline — خط المعالجة نمط سرب: مراحل مرتّبة تتشارك لوحة مشتركة، مع نقاط تفتيش HITL اختيارية.

Platform isolation — عزل المنصة الثابت أن chat_id/user_id/message_id وغيرها لا تدخل أبدًا حالة الرسم — تعيش في SessionStore وتُعاد ربطها عند الرد عبر _build_target_id().

R

Section titled “R”

RRF Reciprocal Rank Fusion — خوارزمية مزج الترتيب. كان UnifiedMemoryAdapter (V1) يستخدمها لدمج طبقاته الأربع (_RRF_K = 60)؛ أُزيل ذلك المكدّس في التحوّل من V1 إلى V2. لا يزال استدعاء V2 يدمج نتائج المعتقدات + الحلقات + PPR عبر خطوة RRF داخلية في memory/recall.py.

ReliabilityRegistry — سجل الموثوقية swarm/reliability_registry.py — حامل إعدادات لقواطع العمّال، وإعادة المحاولة، والمهلات، والمدقّقين، والتوازي. آلات الحالة تعيش في reliability.py.

RetryPolicy — سياسة إعادة المحاولة reliability.py:66 — تراجع أسي (الافتراضي 3 محاولات، 1–60 ث). لا يعيد محاولة 4xx.

S

Section titled “S”

SafetyMiddleware — وسيط السلامة swarm/safety.py:47 — بوابة HITL لناقل السرب. check_sync() مغلق عند الفشل (fail-closed). (لا يوجد صنف باسم SafetyGate/SafetyChecker.)

SessionStore — مخزن الجلسات تعيين معرّف المنصة ↔ thread_id (gateway.py:185). SQLite أو في الذاكرة. لا يحمل أبدًا حالة الرسم.

Skill — المهارة نقطة دخول Python معبّأة وقابلة للتوقيع اختياريًا + manifest يسجّل أداة أو أكثر. تُحمَّل من kazma-skills/manifests/ أو الـ Hub.

sqlite-vec امتداد SQLite للبحث المتّجهي. في V2 يدعم memory/vector_engine.py (sqlite-vec أصلي مع احتياطي NumPy محروس) لاسترجاع المتجهات الكثيفة للحلقات. مُعلَن في الإضافة الاختيارية [rag] (sqlite-vec>=0.1.6).

SwarmEngine — محرك السرب swarm/engine.py:103 — المنسّق async المركزي لعمّال السرب.

T

Section titled “T”

TaskType — نوع المهمة تعداد أنماط السرب: DISPATCH، BROADCAST، PIPELINE، FAN_OUT، CONSULT، CONDITIONAL.

TimeoutGuard — حارس المهلة reliability.py:397 — مهلة لكل مهمة (الافتراضي 300 ث) بسلوك fail/retry/skip.

ToolRegistry — سجل الأدوات agent/tool_registry.py — السجل الذي يستشيره المُشرف كل دورة. execute() هو مسار التنفيذ الوحيد وبوابة HITL لناقل السرب.

TUI لوحة Textual الطرفية (kazma-tui)، مستهلك قراءة غالبًا للمفردات الجوهرية.

U

Section titled “U”

UnifiedMemoryAdapter — مُكيّف الذاكرة الموحّد أُزيل في التحوّل من V1 إلى V2. مازج الذاكرة السابق رباعي الطبقات (swarm/memory/adapter.py): ChromaDB + رسم خصائص SQLite + FTS5 + sqlite-vec، مدموج بـ RRF. حلّ محلّه محرك V2 المعرفي — انظر محرك V2 المعرفي.

UnifiedRouter — الموجِّه الموحّد محرك التوجيه التلقائي لإرسال السرب بـ workers=["auto"].

V

Section titled “V”

محرك V2 المعرفي (V2 Cognitive Engine) — مكدّس الذاكرة الوحيد لكاظمة (kazma-core/kazma_core/memory/). رسم معتردات ثنائي الزمن (مسندات وظيفية/مجموعات/حالة بمحوري valid_from/valid_until + ingested_at/invalidated_at)، حلقات من 4 طبقات، استرجاع Personalized PageRank بمخطط الأنانية المحلي، DAG المهارات الإجرائية، وطابور توحيد دائم بـ SQLite. مسار القراءة الموحّد: recall() في memory/recall.py؛ مسار الكتابة: mutate_belief() في memory/belief_mutation.py. نشط افتراضيًا (memory.v2.use_new_stack: true). حلّ محلّ مكدّس RRF الرباعي الطبقات (V1).

VectorMemory — الذاكرة المتّجهية أُزيل في التحوّل من V1 إلى V2. مفرد الذاكرة السابق المدعوم بـ ChromaDB (memory/vector_store.py) للإقلاع / الصحة / احتياط الأدوات. تستخدم V2 memory/vector_engine.py (sqlite-vec أصلي + احتياطي NumPy محروس) بدلًا منه.

Consolidator — الموحِّد أمين مكتبة ما بعد الدورة (memory/consolidator.py): يستخرج حقائق دائمة + ثلاثيات SPO (LLM + استدلال)، مسيَّج بالتعليمات، مزال التكرار مقابل auto_store، يكتب إلى المُكيّف ورسم L2.

K

Section titled “K”

Kazma (كاظمه) اسم المنتج باللاتينية هو Kazma. صيغ العلامة العربية الصحيحة كاظمه (المفضّلة) وكاظمة. الإملاء كازما (بحرف ز) خطأ ويجب عدم استخدامه. معرفة المنتج الذاتية تُحقَن عبر kazma_core.product_knowledge في موجه نظام المُشرف.

Web research tools — أدوات البحث على الويب حزمة بحث/استخراج/بحث مدمجة: web_search، read_url (تصفّح صفحات)، read_url_to_file، crawl_site (متعدّد الصفحات محدود)، ومساعدات التقطيع/التلخيص. تُستخدم من الدردشة (بلا slash /research). الدليل: البحث على الويب.

W

Section titled “W”

Worker — العامل وحدة تنفيذ السرب (SwarmWorker). مسجَّلة في _workers؛ تُحَل عبر السجل أو دليل الأسماء.

WorkerCapabilities — قدرات العامل كائن \{role, expertise, tools, model_specialty\} يصف ما يستطيع العامل فعله؛ يستخدمه UnifiedRouter وAutoScaler لمطابقة المهام بالعمّال.

WorkerRegistry — سجل العمّال سجل عمّال مدعوم بـ JSON (swarm/registry.py)، يُحمَّل من swarm_registry.json.