دليل الميزات الحديثة

دليل الميزات الحديثة

هذه الصفحة هي الجولة الموجَّهة للمشغّل عبر الميزات التي هبطت في دفعة صقل البحث → مكتبة المعرفة (KB) → الذاكرة (بما فيها أعمال الرسم/إعادة التسمية/المركز الإدارية في /memory). استخدمها لتشغيل الميزات، وتجربتها مرة واحدة، والعثور على الوثائق العميقة عندما تحتاج إلى التفاصيل.

جديد في 2026-09-10 (Hands 0.11): الدردشة هي الصفحة الرئيسية (/ → /chat؛ التشغيل الأول يطلب مفتاح مزوّد ونموذجًا). file_apply_patch_set بطاقة HITL واحدة (verify=true يشغّل pytest القريب). /ide هو CodeMirror 5 — Monaco لم يعد مستخدمًا. أوامر git للقراءة ليست أداة خطر. kazma acp يرسل فروقًا منظَّمة ويحترم session/cancel. KAZMA_CODE_EXEC_DOCKER=force يمنع shell_exec على المضيف إلا مع KAZMA_HOST_SHELL=1.

جديد في 2026-09-01/02: ‏Turn Delivery V2 (السجل + close_turn؛ فقاعة الدردشة تعرض الإسقاطات). سجل بوابات HITL (hitl_gates.db — بطاقة واحدة، صف واحد، و409 عند الموافقة الثانية). شُحنت موجات التدقيق الصناعي 0–8 (التقرير التنفيذي). تثبيت IP في SSRF عند الكشط المباشر. سلامة السياق (دمج لوحة الخدش، المقترحات المخزَّنة، صافي تلخيص الاقتطاع، وshift_explicit مقابل المستنتَج). HITL الخاص بـ FanOut ثلاثي الحالات. إعادة التحميل: kazma_guard.py --reload. جودة سبب 503 لدى الحارس مؤجَّلة.

جديد في 2026-08-31: ‏استوديو X (/x) هو سطح التحرير والتخطيط (نشر فوري، جدولة، إعادة جدولة، سلاسل، حذف، مسودات محفوظة). IBM Plex Sans / IBM Plex Sans Arabic هو الخط المشترك عبر واجهة الويب وDocusaurus والمستندات المولَّدة؛ وحرف K في الترويسة هو الشعار والأيقونة favicon. ‏kazma_guard.py --reload هو مسار النشر — فهو يتخطّى سلّم التراجع بعد الانهيار، فلا تصبح إعادة التحميل الخامسة في اليوم الواحد انتظارًا مدته 300 ثانية (أعد تشغيل KazmaAgent مرة واحدة إن كان حارس قديم لا يزال يصعد السلّم). لا تقتل uvicorn يدويًا. أدوات نظام الملفات لم تعد تعطِّل /health/ready. قفزات الخطة تبقى في عنصر Plan. تحتاج نقاط حفظ Postgres على Windows إلى حلقة أحداث Selector (kazma serve / الحارس، وليس python -m uvicorn).

جديد في 2026-08-27: سجل المهام (حلّ النية الدائم + نطاق انفجار كتابات git)، واحتياطي الاستدعاء من نص المحادثة (الذاكرة وRAG)، وسجل تدقيق X (ناشر X)، وإصلاح ملاحظات الحقيقة في SearXNG (البحث في الويب).

قائمة الفحص الدخاني (عندما تختبر لاحقًا): مصفوفة الفحص الدخاني.
سياق المعمارية: البحث في الويب · مكتبة المعرفة · ذكاء المستندات · مراحل المستندات · أفضل مسار للذاكرة.

---

الجديد — الموثوقية والمنظومة (أغسطس–سبتمبر 2026)

المجال	ما تحصل عليه	أين
Hands 0.11 (2026-09-10)	الدردشة هي الصفحة الرئيسية. file_apply_patch_set (بطاقة HITL واحدة، فروق -/+، تحقق pytest اختياري). المشرف يعيد المحاولة بعد TESTS FAILED (حد 3). فروق ACP + session/cancel. سجن Docker force.	IDE؛ CLI؛ examples/hands-demo/
محرّر /ide CodeMirror (2026-09-10)	لوحة الملف CodeMirror 5 fromTextArea (nord). الملف يظهر حتى لو حُجب الـ CDN. أوامر git للقراءة عملية فرعية وليست HITL.	/ide؛ IDE
Turn Delivery + سجل HITL (2026-09)	سجل الدردشة هو مصدر الحقيقة SoT؛ وclose_turn هو المُغلِق الوحيد؛ والعميل يعرض الإسقاطات. صف HITL واحد في hitl_gates.db (pending = أزرار حيّة؛ المطالبة الثانية 409). ‏FanOut ثلاثي الحالات.	الأمان؛ خريطة التشخيص؛ AGENTS.md §30–§31
تثبيت IP في SSRF (الموجة 8)	الكشط المباشر يتصل بعنوان IP العام المُتحقَّق منه؛ ويُحبَط عند نظير خاص. يُتخطّى التثبيت عند ضبط وكيل.	الأمان؛ KAZMA_JINA_READER=1 لا يزال اختياريًا
سلامة السياق (2026-08-30)	لوحة الخدش تُدمَج؛ المسودات تعيش في agent_artifacts.db؛ الاقتطاع يلخّص دائمًا الأدوار المتروكة؛ فقط التحوّل الصريح عن الموضوع يفكّ سلاح الاستدعاء.	الذاكرة؛ AGENTS.md §29
استوديو X (2026-08-31)	محرِّر /x من الدرجة الأولى + مخطِّط لـ X فقط. نشر فوري / جدولة / إعادة جدولة / قفزات السلاسل / حذف. المسودات المحفوظة تُختَم بـ proposal_id (النص المخزَّن هو الفائز). x_post في الدردشة يبقى HITL دائمًا. كل الساعات تفتح /scheduled (cron + X مختلطة).	ناشر X؛ الشريط الجانبي ← استوديو X
خط العلامة وشعارها (2026-08-31)	IBM Plex Sans / IBM Plex Sans Arabic عبر الواجهة والوثائق والمستندات المولَّدة (Amiri بديلًا للنسخ). حرف K في الترويسة هو الشعار والأيقونة والصورة الرمزية. لم تعد PPTX/XLSX تفرض خط Calibri برمجيًا.	العربية والثقافة؛ توليد المستندات
إعادة تحميل الحارس وإصلاحات التعليق (2026-08-31)	--reload يوقف الابن المسجَّل وحامل المنفذ، ويتخطّى تراجع الانهيار، وينتظر ميزانية الإقلاع كاملة، ولا يرفع KazmaAgent إلا إذا كان المراقب ميتًا. file_search خارج حلقة الأحداث. نتائج أدوات الملفات محدودة بـ 32k. القفزات الخاصة بالخطة وحدها تبقى خارج نص الدردشة.	python scripts/service/kazma_guard.py --reload؛ النشر
الدردشة هي المنتج (2026-08-26)	/ غامرة (بلا ترويسة الدردشة/الرئيسية/الدردشة). المحرِّر: إرفاق + إدخال + إرسال؛ وLong/YOLO/التكلفة تعيش تحت ⋯. الشريط الجانبي يبقى قائمة العمل / النشاط / الإعدادات المجمَّعة (أُرجِع More — فلم يكن ينطوي أبدًا).	GOAL؛ أعد التشغيل بعد السحب
أخذ عينات HITL + CUA أصيل + فحص دخاني في CI (2026-08-25)	أخذ عينات MCP بطاقة Once حقيقية (KAZMA_MCP_SAMPLING=1). computer_use يستدعي Anthropic CUA / دالة Gemini عندما يكون ذلك النموذج نشطًا. مهمة Playwright في CI: /health/live + #chat-input.	MCP؛ KAZMA_CUA_PLANNER=0
بقايا ما بعد الصناعي (2026-08-25)	موارد/مطالبات MCP (مسيَّجة؛ أخذ عينات HITL). محوّلات مخطِّط CUA على computer_use. نشر TTS الخاص بـ LiveKit في الغرفة. تراجع 429 على Anthropic. حدود الكلمات في الموجِّه + models.defaults. أثر أدوات التقييم. كعبات Bright Data/Oxylabs.	GOAL؛ MCP
LiveKit مزدوج الاتجاه (الويب) (2026-08-25)	زر البث الحي: WebRTC AEC + المقاطعة (إيقاف TTS). العقل لا يزال LangGraph. يحتاج LIVEKIT_URL + مفتاح/سر API. تيليجرام تبقى رسائل صوتية.	الصوت؛ KAZMA_VOICE_DUPLEX=0
LiteLLM بوابة اختيارية (2026-08-25)	KAZMA_LITELLM_URL (أو llm.gateway.url) يرسل الاستدعاءات المتوافقة مع OpenAI عبر وكيل LiteLLM. تبقى Anthropic/Azure/Bedrock/Gemini الأصيلة مباشرة. والمحلية تبقى مباشرة. ليس حصريًا.	الأسئلة الشائعة؛ KAZMA_LITELLM=0
استخدام الحاسوب + صقل البقايا (2026-08-25)	حلقة screenshot→action في computer_use (HITL). Langfuse يعمل تلقائيًا مع المفاتيح. أسطول تضمين مستضاف (KAZMA_EMBED_FLEET=1). إنقاذ Docling/LlamaParse لملفات PDF العصية. الصوت قائم على الأدوار، وليس Realtime.	الأدوات؛ KAZMA_COMPUTER_USE=0؛ الصوت
kazma ask + ACP (2026-08-25)	kazma ask "…" يشغّل الرسم البياني دون خادم الويب. الرموز تتدفّق؛ وHITL على الطرفية TTY (y/N). kazma acp هو ACP عبر stdio مع session/update + session/request_permission. --yolo يعمل بلا واجهة.	البداية السريعة؛ kazma ask --help
خلفية IDE LSP (2026-08-25)	/api/ide/lsp ما زال موجودًا. محرّر الويب CodeMirror تلوين فقط؛ مسار المحرّر الصناعي هو kazma acp.	/ide؛ KAZMA_IDE_LSP=0؛ IDE
وضع الخطة (2026-08-25)	/plan on للفحص (الكتابة/التنفيذ محجوبان). /plan go أو متابعة للتنفيذ. لا يزال HITL مفعّلًا.	شارة Plan؛ أوامر الشرطة المائلة؛ KAZMA_PLAN_MODE=0
خطافات ما قبل/ما بعد الأداة (2026-08-25)	PreToolUse / PostToolUse على طريقة Claude Code (رفض، إعادة كتابة، مراقبة). ليس نظام صلاحيات — فـ HITL لا يزال يبوّب الأدوات الخطيرة.	agent.hooks.*؛ KAZMA_TOOL_HOOKS=0؛ المعمارية · الأمان
مخططات أدوات صارمة (2026-08-25)	مخطط JSON للأدوات مغلق (additionalProperties: false). أدوات OpenAI strict + response_format اختيارية.	KAZMA_STRICT_TOOLS=1؛ فهرس الأدوات؛ المعمارية
فهرس قاعدة الشيفرة (2026-08-25)	codebase_search يجد الدوال/الأصناف (tree-sitter أو regex) إضافة إلى ripgrep الحي. يتحدّث الفهرس عند الكتابة/الترقيع.	الإضافة kazma[index]؛ KAZMA_CODE_INDEX=0؛ IDE
E2B + Temporal (2026-08-25)	python_exec اختياري على Firecracker (E2B_API_KEY) وإرسال سرب ملفوف بـ Temporal (KAZMA_TEMPORAL_HOST). الافتراضيات دون تغيير.	الإضافتان kazma[sandbox] / kazma[durable]؛ متغيرات البيئة
apply-patch (2026-08-25؛ مجموعة Hands 0.11)	تعديلات الوكيل تستخدم file_apply_patch / file_apply_patch_set (HITL) بدل إعادة كتابة الملفات كاملة. /ide هو CodeMirror 5 لا Monaco.	/ide؛ IDE؛ فهرس الأدوات
بحث الذاكرة بـ pgvector (2026-08-25)	عندما يكون Postgres مفعّلًا، يستخدم الاستدعاء المتجه dense محرك pgvector (تلقائيًا). وضع Postgres-primary هو ILIKE + RRF متجهي، وليس ILIKE فقط. KAZMA_PGVECTOR=0 يبقي sqlite-vec.	الإعدادات ← الذاكرة؛ الذاكرة وRAG؛ Postgres وSaaS
تدقيق نظام الذاكرة (2026-08-24)	مراسٍ مركزية لرسم الإيغو (لا مزيد من العقد المفاهيمية العائمة)، وشواهد قبور في مرآة PG + scripts/reconcile_memory_mirror.py، ومسح رسم محدود بالمستأجر (لا مسحًا لكل المستأجرين)، وإعادة بناء انحراف FTS عند المسح كل 6 ساعات، وأرشيف سجل الدمج، وفك التجميع Ungroup، ولافة اقتطاع صادقة	/memory؛ أعد التشغيل بعد git pull
نسخ احتياطي شامل	نسخة موحَّدة واحدة من كل البيانات: كل قواعد SQLite (آمنة مع WAL)، وكل الأصول (مخزن المستندات، مساحة العمل، المرفقات، المتجهات). تلقائي كل 6 ساعات + يدوي؛ يتحقق من نضارة نسخة PG (لا ينسخ مرتين). شريط تقدّم، وحذف/أرشفة/تنزيل	الإعدادات ← تبويب النسخ الاحتياطي؛ POST /api/backup/now
نسخ Postgres الاحتياطي	pg_dump تلقائي لـ KAZMA_PG_TABLES (ذرّي ومُتحقَّق منه؛ بقاء النسخ المرحلية المحلية 3، وrestic يحفظ التاريخ) + تحقق من المخطط وقت الإقلاع + استعادة بأمر واحد	kazma-data/backups/pg/؛ python scripts/pg_backup.py backup|restore --latest|list
سوق مهارات الوكيل	تصفّح/تثبيت منظومة agentskills.io المفتوحة (GitHub ‏topic:agent-skills) من الواجهة؛ ويستطيع الوكيل search_agent_skills + install_agent_skill	/skills ← تبويب السوق
مهارات بداية مرفقة	3 مهارات أصلية في كاظمة تُشحن داخل الشجرة (release-notes، conventional-commits، ui-conventions)، مُتحقَّق منها بالمجموع الاختباري	/skills (النطاق: مرفقة)
إصلاحات أدوات Windows	أدوات المتصفح، وshell_exec، والتلمترية، وسحب Ollama، وتثبيتات بيئات التشغيل تعمل فعلًا الآن على Windows (أُصلح فخ العمليات الفرعية في حلقة selector)	شفاف — أدوات كانت لا تفعل شيئًا بصمت أصبحت تعمل
إصلاح استدعاء الذاكرة	لم يعد البحث يُعيد [] للاستعلامات الحاوية على ترقيم (==، //)	شفاف
استعادة الفشل المرحلي عند 429	النموذج الأساسي المحدود بمعدل ينتقل الآن إلى سلسلة الاحتياط بدل إفشال الدور إخفاقًا تامًا	شفاف
إصلاحات الإقلاع	استعادة المهام المتوقفة لم تعد تتجمد (تسليح مهلة مؤجَّل)؛ حارس مخطط PG يتحقق فعلًا؛ أُصلح تصدير البحث	شفاف

إجراءات المشغّل بعد git pull: يعمل kazma ask / kazma acp دون إعادة تشغيل (CLI؛ الرموز تتدفّق، وTTY HITL). أعد تشغيل الخادم لتفعيل استوديو X (/x)، وهوية IBM Plex / حرف-K في الترويسة، وتخطّي التراجع في --reload (أعد تشغيل KazmaAgent مرة واحدة ليكون الحارس على الشيفرة الجديدة)، وcomputer_use، والتشغيل التلقائي لـ Langfuse، وإنقاذ Docling/LlamaParse، وIDE LSP (التمرير/الإكمال على /ide)، ووضع الخطة (/plan on · شارة Plan)، وخطافات الأدوات (agent.hooks.*؛ وKAZMA_TOOL_HOOKS=0 للتعطيل)، ومخططات الأدوات المغلقة (additionalProperties: false؛ واختياريًا KAZMA_STRICT_TOOLS=1 لأجل OpenAI strict)، وإصلاحات تدقيق الذاكرة (مراسي المركز، ومسح FTS، وربط مسح الرسم)، والاستدعاء المتجه dense بـ pgvector (عند ضبط KAZMA_DATABASE_URL — شغّل CREATE EXTENSION vector أولًا)، وإصلاحات القوالب (أزرار MCP/المهارات)، ونظام النسخ الاحتياطي (أول نسخة شاملة بعد الإقلاع بنحو دقيقتين)، وإصلاحات أدوات Windows. التفاصيل الهندسية الكاملة في CHANGELOG.md وAGENTS.md §21–§23. التدقيق: AUDIT_MEMORY_SYSTEM_2026-08-24.md.

---

نظرة سريعة

المجال	ما تحصل عليه	أين
استوديو X	تحرير / جدولة / إعادة جدولة / سلاسل / حذف على X (‏API الرسمي)	/x؛ ناشر X
البحث العميق	خط أنابيب متعدد المصادر، جلسات حيّة، توجيه، معيار تقييم	/research، الدردشة، /research deep
ذكاء المستندات	ابتلاع آمن، وOCR، وفهرسة، وتوليد/تحويل/تنقيح، وعمليات (سعة/GC/تدقيق)، وشهادة	/documents، /api/documents/*، أمر /documents، أدوات document_*، مستندات TUI
مزوّد الوكيل	وكيل سكني للكشط/الزحف/Playwright/SERP	الإعدادات ← النظام
مكتبة المعرفة	إعادة فهرسة ذكية، تقليم الروابط المختفية، حقن هجين؛ جسر document_index	/knowledge، الإعدادات ← الذاكرة، المستندات ← الفهرسة
إدارة الذاكرة	إزالة تكرار الرسم، إعادة تسمية، قائمة↔رسم، تعديل المعتقدات، هوية المركز، تجميع/فك تجميع، صدق الاقتطاع	/memory
شرح الذاكرة	رقائق القنوات على أدوار الدردشة + فحص لوحة المعلومات	الإعدادات ← الذاكرة ← شرح الاستدعاء
التقييم الذهبي	اختبار انحدار الاستدعاء دون اتصال	لوحة المعلومات ← تشغيل التقييم الذهبي
تركيز تحوّل الموضوع	التحوّل الصريح يفكّ سلاح الاستدعاء؛ والانجراف المستنتَج يعيد الترتيب فقط. تسجيلات الوصول الاستفهامية لا تُحتسب انجرافًا أبدًا	الإعدادات ← agent.topic_drift.*؛ AGENTS.md §29
التنفيذ غير المتوقف والشفاء الذاتي	كلب مراقبة المشرف، سلسلة الفشل المرحلي للنموذج، سجل الاستدعاءات، استعادة الأيتام، مهلة HITL	الإعدادات ← الوكيل ← التنفيذ غير المتوقف
تحصين الكاشط	حدود الحجم (5MB افتراضيًا)، تراجع إعادة المحاولة عند 5xx، الامتثال لـ robots.txt	read_url، crawl_site، KAZMA_FETCH_MAX_BYTES
إعادة المحاولة التلقائية عند الاقتطاع	مضاعفة max_tokens عند اقتطاع الطول + أداة تقطيع file_append	llm_provider، LocalToolRegistry
Turn Delivery / سجل HITL	السجل + close_turn؛ صف بوابة واحد؛ 409 عند الموافقة الثانية	الأمان · التشخيص
طبقة الالتزام	بوابة الحل-قبل-التنفيذ؛ بطاقات توضيح/تأكيد دلالية؛ قائمة منع exec؛ أوضاع + مفاتيح إيقاف	طبقة الالتزام
التوجيه / الإلغاء	/steer (ناعم)، و/steer! (إيقاف + حقن)، و/abort لمهمة قيد التشغيل	أوامر الشرطة المائلة
منح المسارات	وصول خارج مساحة العمل بالإذن (منحة جلسة أو extra_roots دائم)	IDE ← منح المسارات
تجديد هوية الواجهة	رموز تصميم ABYSS، سمة الخادم فيها المرجعية، لوحة ألوان داكنة، هيكل الجوال	واجهة الويب ← السمات

---

0. أحدث ما شُحن (2026-09، ثم 2026-08)

سبتمبر 2026 (موجات التدقيق الصناعي 0–8):

• Turn Delivery V2 — دردشة مبنية على الأحداث: السجل + close_turn. فروق الرموز تُلحَق؛ وturn_complete وحده يستبدل. لا تُعِد رسّامًا ثانيًا في chat.js.
• سجل بوابات HITL — ‏CAS في hitl_gates.db (pending → claimed → settled). البطاقات الشبحية / المختومة مسبقًا بـ Approved كانت فئة الحوادث. مفتاح الإيقاف KAZMA_GATE_REGISTRY=0 مسار تنفيذ احتياطي رفيع، وليس مُفوِّضًا ثانيًا. الأمان · AGENTS.md §30.
• FanOut ثلاثي الحالات — مع منصّتي دردشة أو أكثر، يكون الرفض صوتًا حتى اكتمال expected_voters أو انتهاء المهلة. أول مطالبة على الويب تبقى 200/409.
• تثبيت IP في SSRF — الكشط المباشر يثبّت IP العام؛ ويُحبَط إذا كان النظير خاصًا. لا تثبّت عبر proxy=.
• سلامة السياق — مُخفِّض دمج لوحة الخدش؛ مقترحات دائمة؛ صافي تلخيص عند كل اقتطاع؛ shift_explicit مقابل shift_inferred.
• جولة الوثائق — ‏AGENTS.md، والمعمارية، والسرب، وخريطة النظام، والأمان، والذاكرة، والالتزام، والتشخيص، وهذه الصفحة، وقائمة فحوص الإنتاج.
• لا يزال 503 للحارس يقول unreachable: Service Unavailable (Docker/Postgres). المؤجَّل: تنبيهات الحارس/العمليات.

أما دفعة أغسطس — فإلى جانب البنود الواردة في الجدول أعلاه:

• استوديو X (/x) — تحرير، وجدولة، وإعادة جدولة، وقفزات السلاسل، وحذف تغريدة حيّة، وتحميل مسودة محفوظة. x_post في الدردشة يبقى HITL دائمًا؛ ونقرة الويب هي الموافقة. كل الساعات تفتح /scheduled (cron + X). ناشر X.
• خط العلامة وشعارها — IBM Plex Sans / IBM Plex Sans Arabic (الواجهة، الوثائق، المستندات المولَّدة). حرف K في الترويسة هو الشعار/الأيقونة. ويبقى Amiri بديل النسخ. العربية والثقافة.
• ‏--reload للحارس يتخطّى تراجع الانهيار — قتل النشر ليس انهيارًا، فلا تكون إعادة التحميل الخامسة في اليوم انتظارًا 300 ثانية. أعد تشغيل KazmaAgent مرة واحدة إن كان حارس قديم لا يزال يصعد. النشر.
• التوجيه والإلغاء (/steer، /steer!، /abort) — إشارات خارج النطاق إلى مهمة قيد التشغيل. التوجيه الناعم يطوي النص في الخطوة التالية؛ والتوجيه الصارم يوقف، ويحقن متطلبًا، ويستأنف (بالتنزيل إلى ناعم إذا كانت المهمة في طور الإنهاء)؛ و/abort يلغي ويترك. انظر أوامر المهام قيد التشغيل.
• طبقة الالتزام (الحل قبل التنفيذ) — بوابة سياسات بين الـ LLM والتعديلات الدائمة. شُحنت كل المراحل (0–8): authorize_effect، وبطاقات مقاطعة توضيح/تأكيد دلالية بزر لكل خيار، وقائمة منع exec، ومفاتيح الإعداد المحمية، وقائمة سماح الصادر، ورموز نطاق السرب، وبوابة تأكيد الروح، والأوضاع (strict/balanced/autonomous/yolo)، ومفاتيح الإيقاف. دليل مخصّص: طبقة الالتزام.
• مواءمة الاستئناف الدلالي لـ HITL (PR1–PR5) — نقطة اختناق استئناف واحدة مفروضة، ومواءمة WS/SSE للمقاطعات الدلالية، وثابتة التوضيح-النهائي التي تقتل حلقة التوضيح، وبوابة التذكير ذات الوسائط أولًا المفحوصة بالذاكرة، وبطاقات خيارات التوضيح الدلالي + عدّاد حلقة /metrics.
• منح المسارات — الوصول خارج مساحة العمل مرفوض افتراضيًا لكنه قابل للفتح بالإذن: منح جلسة سلسة عبر بطاقة HITL ‏request_path_access، أو workspace.extra_roots الدائم. IDE ← منح المسارات.
• ‏kazma update الأساسي — مسار ترقية فاشل-مغلق للمشغّل: فحص مسبق، وstash مسمّى، وإعادة تعيين صارمة إلى origin/main، وإعادة تثبيت تحفظ الإضافات، وتحقق لاحق. تحديث كاظمة.
• ابتلاع PDF العربي — استخلاص بدرجة صناعية: PyMuPDF أساسيًا مع مقارنة متعددة المحركات (pypdfium2/pdfplumber/pypdf)، وترتيب قراءة واعٍ بالتخطيط، ومتحقق RTL ضبابي ذهابًا وإيابًا، وتوجيه OCR ‏ara+eng. ذكاء المستندات.
• ثراء توليد المستندات — تظليل الشيفرة/النحو (PDF+HTML)، ومخططات XLSX (متعددة السلاسل + عناوين المحاور)، وتضمين صور الأصول المعتمدة، وفهرس PDF حقيقي
  • فهرس HTML قابل للنقر. توليد المستندات.
• تجديد هوية الواجهة (P1–P4) — رموز تصميم ABYSS موحَّدة، وسمة الخادم فيها المرجعية (تبقى عبر الأجهزة)، ولوحة داكنة رمادية بعمق طبقات حقيقي، وإصلاحات هيكل الجوال، وإعادة تحقق HTML قسرية. واجهة الويب ← السمات.

---

1a. ذكاء المستندات (مسار المنتج)

ماذا يفعل

منصة مستندات آمنة من طرف إلى طرف: استقبال متدفّق → عزل CAS → شمّ السياسات → تحليل/OCR معزول → مهام دائمة → فهرسة معرفة اختيارية، وتوليد/تحويل/تنقيح، وعمليات (سعة، GC، تدقيق، شهادة).

كيفية التشغيل

المدخل	الكيفية
الويب	رفع /documents + العمليات؛ الإعدادات ← المستندات
الوكيل	document_import / document_read / document_index / …
البوابة	/documents list|read|status|… (الاسم المستعار /docs)
TUI	تبويب المستندات
الشهادة	python scripts/certify_documents.py

تثبيت المحركات (اختياري)

pip install -e ".[document-platform]"
# System: Tesseract (OCR), ClamAV (malware), LibreOffice (some convert)

وثائق أعمق: ذكاء المستندات · العمليات · الأمان · المراحل 0–10.

---

1. البحث العميق (مسار المنتج)

ماذا يفعل

يخطّط run_research_pipeline الاستعلامات، ويبحث عبر web_acquire، ويرتّب الروابط، ويجلب الصفحات كاملة، ويهضم، ويُجمِّع، مع سدّ فجوات اختياري، ثم يكتب تقريرًا تحت research/reports/ مع معيار تقييم (rubric) بنيوي.

المراحل الصناعية (R0–R4): ترتيب + ادّعاءات + عميق فاشل-مغلق → خطة تكيفية + حلقة الفجوات → جلسات دائمة + SSE → توجيه ناعم إلى خط الأنابيب + API تقييم.

كيفية التشغيل

المدخل	الكيفية
الويب	افتح /research ← الموضوع، العمق (عميق/موجز)، الحد الأقصى للمصادر ← ابدأ
الدردشة	«بحث عميق عن …» (يفضّل المشرف run_research_pipeline)
البوابة	/research deep <topic> (تنبيهات تقدّم أثناء التشغيل)

الجلسات الحيّة (R3)

• صفوف الجلسات: kazma-data/research_sessions.db
• البدء: POST /api/research/sessions
• التقدّم الحي: GET /api/research/sessions/{id}/stream (‏SSE)
• زر الإلغاء بينما الحالة running / pending
• القائمة تعرض جلسات [Deep] + أوراق خط الأنابيب + مهام بحث السرب

التوجيه (R4)

الطلبات المصوغة بعمق تحصل على تلميح نظام لاستدعاء خط الأنابيب مرة واحدة بدل سلسلة web_search يدوية طويلة. والقفزات اليدوية المتعددة على طلب عميق تحصل على تنبيه واحد بـ «فضِّل خط الأنابيب». للتعطيل: KAZMA_RESEARCH_ROUTE=0.

الجودة

• التقرير + rubric.json تحت مجلد الورقة
• الجلسة تخزّن rubric_score / rubric_ok
• قيّم أي تقرير: GET /api/research/eval?path=… أو ?session_id=…

تعمّق: البحث في الويب.

---

2. الاقتناء المشترك من الويب + Proxy Provider

المكدّس المشترك

تعيش إدخالات/إخراجات البحث / الكشط / الزحف في kazma_core.web_acquire (تستخدمه البحث واستخلاص صفحات المكتبة معًا). لا تمرّ واجهات LLM عبر هذا المكدّس أبدًا.

تغطية الوكيل (الإعدادات ← النظام ← مزوّد الوكيل)

عندما يُضبط مزوّد (مثل anyIP)، فإنه ينطبق على:

المسار	عبر الوكيل؟
جلب الصفحات (سلّم httpx) البحث + المكتبة	نعم
استعادة Playwright (read_url + المكتبة)	نعم
عنكبوت روابط crawl_site	نعم
اكتشاف sitemap / robots للمكتبة	نعم
Bing / Wikipedia SERP	نعم
DuckDuckGo (ddgs)	نعم (عند ضبط مزوّد الوكيل)
SearXNG البعيد	نعم
SearXNG المحلي / Docker	لا (عنوان راجع — لا hairpin)
استدعاءات API لـ Jina / Firecrawl	لا (هما يجلبان الهدف من جهة الخادم)
واجهات مزوّدي LLM	أبدًا

الإعداد حيّ (لا إعادة تشغيل). كلمة المرور تُشفَّر في الخزنة.

تعمّق: البحث في الويب ← الكشط المضاد للعوائق.

---

3. تحصين مكتبة المعرفة

إعادة الفهرسة الذكية

الحالة	السلوك
الصفحة دون تغيير (نفس تجزئات المحتوى المرتبة)	تخطّي التنقية + التضمين
الصفحة تغيّرت أو انكمشت	تنقية الرابط (SQLite + FTS + Chroma) وإعادة كتابة
الرابط اختفى من الاكتشاف (ضمن نطاق البذور)	يُقلَّم عند زحف/تحديث الموقع

تعرض واجهة المهام / التنبيهات متخطّى · دون تغيير · مقلوم · فاشل.

الاستدعاء + الحقن (مكدّس هجين واحد)

المخازن تبقى منفصلة — لا دمج في جدول واحد مع معتقدات V2.

Chat turn
  ├─ V2 memory recall (beliefs + episodes)
  ├─ KB inject (RRF: Chroma semantic + FTS5)  ← same as knowledge_search
  └─ All inject fenced as untrusted docs

الوضع	المكتبات
الحقن	مكتبات auto_inject=1 ‏(+ توسيع البحث الذكي)
الاتحادي / الأدوات	كل المكتبات النشطة غير المؤرشفة ذات المقاطع

الإعدادات ← الذاكرة

المفتاح	المعرّف	الأثر
حقن المعرفة في الدردشة	memory.v2.merge_knowledge_into_chat	حقن المكتبة لكل دور
ترقية أفضل نتائج المكتبة	memory.v2.promote_kb_to_episodes	مرآة ناعمة إلى الحلقات
البحث الذكي في المعرفة	knowledge.smart_search	في الأسئلة التقنية، حقن من كل المكتبات النشطة ذات المقاطع
شرح الاستدعاء	memory.v2.explain_recall	وسم النتائج + لوحة الدردشة (أدناه)

مفتاح الإيقاف: KAZMA_KB_AUTO_INJECT=0.

تعمّق: مكتبة المعرفة · أفضل مسار للذاكرة.

---

4. شرح الذاكرة + التقييم الذهبي

لوحة سياق الذاكرة على دور الدردشة

الافتراضي الصناعي: ‏explain_recall مفعّل في افتراضيات الإعداد (وافتراضي واجهة الإعدادات). عندما يحدث الحقن والشرح معطّل، لا تزال اللوحة تعرض ملخصًا (عدادات + معاينات قصيرة) مع تلميح لتفعيل الرقائق الكاملة.

1. أبقِ شرح الاستدعاء مفعّلًا (الإعدادات ← الذاكرة) للحصول على رقائق القنوات كاملة.
2. دردث كالمعتاد (ازرع حقيقة، ثم اسأل).
3. افتح منضدة العمل الخاصة بالدور (بطاقة التقدّم).
4. سياق الذاكرة يسرد المعتقدات / الحلقات / صفوف المكتبة مع رقائق القنوات:

الرقاقة	المعنى
fts5 / belief_fts	معجمي
dense	تشابه التضمين
belief_ppr	متعدد القفزات على رسم المعتقدات (الافتراضي 3 قفزات)
session_boost	حلقات نفس السلسلة
kb_rrf	‏RRF هجين للمعرفة

الدور الفارغ يعرض «No memory/KB hits this turn».

يعمل على دردشة SSE وWebSocket.

لوحة المعلومات

• فحص الذاكرة — نفس رقائق القنوات
• الاتحادي — ذاكرة + مكتبة موسومتان
• تشغيل التقييم الذهبي — معدّل نجاح حزمة الفحوص دون اتصال (POST /api/memory/v2/eval/golden)

القفزات المتعددة للمعتقدات (PPR)

يستخدم Personalized PageRank لرسم المعتقدات حوافٍ موزونة بالثقة ونصف قطر قفزات قابلًا للضبط (memory.v2.ppr_hop_radius، الافتراضي 3) حتى تظهر سلاسل مثل user → works_at → Acme → located_in → Paris.

تعمّق: الذاكرة وRAG.

---

4b. واجهة إدارة الذاكرة — الرسم، إعادة التسمية، جسر القائمة (2026-08)

صفحة المشغّل /memory: الرسم في الأعلى، والكيانات/المعتقدات/الدمج/النظافة في الأسفل.

القدرة	السلوك
لا تكرار لمعرّفات الرسم	النص الموضوعي المساوي لمعرّف كيان (مثل shipx) عقدة حقيقية واحدة، وليس كيانًا + حقيقة افتراضية
إعادة التسمية للعرض	المعرّف ثابت؛ الاسم + الأسماء المستعارة تتغيّر (ShipX، المركز Mubder)
القائمة ↔ الرسم	نقر الصف ⇄ نقر العقدة؛ إعادة التسمية/الدمج/الإبطال تحدّث اللوحة
تعديل المعتقد	المعتقدات ← تحرير ← PATCH الثلاثية (الموضوع/المحمول/المفعول)
هوية المركز	أغلفة الأشخاص ent_* للـ User تُخطَّط إلى مركز user؛ وإعادة التسمية تزامن وسم المركز
مراسي رسم الإيغو	وقائع موضوع الحِمل (subject → pred → literal) تحصل أيضًا على user → related_to → subject فلا تكون مكوّنًا منفصلًا
تجميع / فك تجميع	عنقودة للعرض فقط من الفحص؛ استطلاع الـ30 ثانية يستخدم groups في حمولة الرسم (لا GET إضافي)
صدق الاقتطاع	اللافة تُخبر بالعقد و الوصلات المخفية بسبب حد الـ top-N

تعمّق: الذاكرة وRAG — الواجهة الإدارية · أفضل مسار للذاكرة.

---

4c. إصلاح شامل لصفحة الذاكرة + تذكيرات cron (2026-08)

جولة كاملة على صفحة المشغّل /memory — الفائدة، والأداء، والصحة، وسهولة الوصول — إضافة إلى إصلاح انهيار قديم في تذكيرات cron.

صفحة الذاكرة (/memory):

القدرة	ما الذي تغيّر
ترقيم الصفحات + العدادات	القوائم تعرض «عرض 1–150 من إجمالي 3,412» + تحميل المزيد؛ والرسم يعرض لافة اقتطاع. لا مزيد من حد صامت يتنكّر كفراغ.
بحث حقيقي	بحث FTS5 غير حسّاس للتشكيل (francais→Français) وواعٍ بالأسماء المستعارة عبر المعتقدات + الكيانات.
«لماذا استُدعي»	انقر معتقدًا ← سجل الاستدعاء (العدد، آخر مرة، حلقة المنشأ) + افحص من هذا المعتقد.
التراجع	الإبطال / الوصل / التحرير / الحذف تعرض تنبيه [تراجع] لمدة 60 ثانية. والدمج يعرض وصلًا بعدد إعادة التوصيل.
فتح الصفحة أسرع بنحو 10×	عدادات كيانات مجسَّدة تحل محل الاستعلامات الفرعية المرتبطة لكل صف؛ وتلتئم ذاتيًا إن فات موقع كتابة.
تعدد المستأجرين	‏KAZMA_MEMORY_ENFORCE_TENANT=1 يعزل الذاكرة لكل مستأجر (معطّل افتراضيًا).
سهولة الوصول	حالة aria-live، وتسميات الجداول، وأوصاف اللوحة الديناميكية، ونافذة واحدة لتحرير المعتقد.

تذكيرات cron تُسلَّم فعلًا الآن:

• كان المجدول يُبنى دون graph_builder=، فكان كل تذكير مجدول ينهار عند الإطلاق برسالة «No graph builder configured». أصبح موصولًا الآن.
• كذلك لم تكن التذكيرات تبلغ تيليجرام أبدًا لأن هدف التسليم لم يكن يُلتقط؛ الآن يُلتقط delivery_target (وهو telegram:<chat_id> المنشأ) وقت الجدولة ويُستخدم وقت الإطلاق. (البحث في SessionStore ليس بديلًا مجديًا — فالجلسات تُطرد بانتهاء TTL بعد 5 دقائق.)

تعمّق: الذاكرة وRAG — قدرات المشغّل · متغيرات البيئة.

---

4d. محرّك التنفيذ غير المتوقف والشفاء الذاتي (2026-08)

طبقة تنفيذ ذاتية الشفاء بدرجة مؤسسية مصمَّمة للمهام المستقلة طويلة المدى.

القدرة	السلوك
كلب مراقبة المشرف	يغلّف supervised_invoke() تنفيذ الرسم بنبضات العقد، وكشف التعليق (60 ثانية افتراضيًا)، وتصنيف الحوادث (stalled، transient_llm، context_overflow، panic). يتراجع تلقائيًا إلى آخر نقطة حفظ دائمة، ويحقن تأملًا، ويستأنف حتى N محاولة.
سلسلة الفشل المرحلي للنموذج	النماذج الأساسية المستنفَدة تنتقل عبر agent.nonstop.failover.chain مع فترات تهدئة لكل نموذج (300 ثانية افتراضيًا) دون تغيير ملفات الإعدادات النشطة.
سجل استدعاءات LLM	‏SQLite WAL دائم (kazma-data/llm_calls.db) يسجّل السلسلة، والتكرار، والنموذج، واستخدام الرموز، والتكلفة، والكمون، والحالة، ومنشأ الفشل المرحلي لكل استدعاء LLM.
استعادة الأيتام عند الإقلاع	مهام السرب العالقة في status='running' بسبب انهيارات العمليات أو إعادة التشغيل يعاد وضعها في الطابور كـ pending عند الإقلاع حتى 3 محاولات.
مهلة موافقة HITL	كلب مراقبة خلفي يمسح مقاطعات موافقة HITL المعلّقة كل 15 ثانية ويرفض تلقائيًا الأدوار الفاسدة بعد safety.hitl.approval_timeout_seconds (60 ثانية افتراضيًا).
دردشة مرنة	استدعاءات LLM خارج الرسم (عمال السرب، ومخطِّط البحث، ومُجمِّع البحث) تستخدم resilient_chat مع إعادة محاولات عابرة، وسلسلة فشل مرحلي، ومهل تنفيذ أدوات (agent.tool_timeout_seconds، ‏120 ثانية).
بطاقة واجهة الإعدادات	تبويب إعدادات الوكيل يضم قسم التنفيذ غير المتوقف والشفاء الذاتي مع مفاتيح إعادة قراءة حيّة، وعتبات، وتحكّم بسلسلة الفشل المرحلي (يدعم i18n إنجليزي/عربي).

---

4e. تحصين الكاشط والتعافي من الاقتطاع (2026-08)

مرونة كشط ويب بدرجة صناعية وتعافٍ من اقتطاع مخرجات النموذج.

الميزة	التفاصيل
حدود حجم الاستجابة	يبثّ read_url قراءات الجسم ويفرض KAZMA_FETCH_MAX_BYTES (5 MB افتراضيًا) لمنع استنزاف الذاكرة واستغلالات قنابل gzip.
بوابة نوع المحتوى	الحِمل الثنائي غير النصي (ملفات PDF، صور، أرشيفات) يفشل سريعًا بإرشاد قابل للتنفيذ بدل تلويث مستخلص النص.
حلقة إعادة المحاولة عند 5xx	حلقة إعادة محاولة الكاشط HTTP تغطي رموز 500 و502 و503 و504 مع تراجع وتذبذب (3 محاولات).
الامتثال لـ robots.txt	‏crawl_site(respect_robots=True) الاختياري أو KAZMA_CRAWL_RESPECT_ROBOTS=1 يحلّل robots.txt للمضيف ويعلّم الروابط غير المسموح بها blocked_robots.
إعادة محاولة الاقتطاع تلقائيًا	عندما يتوقف إكمال LLM مع finish_reason='length'، يعيد llm_provider.chat المحاولة بشفافية مرة واحدة مع مضاعفة max_tokens (بحد أقصى 4 أضعاف المضبوط / 32k) بدل إرجاع JSON أدوات مكسور.
أداة file_append	أداة مدمجة في LocalToolRegistry تتيح للوكلاء كتابة الملفات الكبيرة على مقاطع (file_write للتهيئة، وfile_append للأقسام التالية).

---

5. وصفات سريعة للمشغّل

أ. أول ورقة بحث عميق

1. تأكّد من عمل بحث الويب (يُنصح بـ SearXNG).
2. افتح /research ← أدخل الموضوع ← ابدأ.
3. راقب المراحل؛ افتح ملف MD عند الانتهاء؛ ولاحظ درجة معيار التقييم على البطاقة.

ب. تحديث رخيص للمكتبة

1. ازحف مكتبة مرة واحدة.
2. حدّث فورًا.
3. أكّد دون تغيير / متخطّى في شريط المهام (عمل إعادة تضمين قليل).

ج. «الوكيل يعرف مستنداتي للتو»

1. ابتلع مكتبة؛ وفعّل auto_inject على تلك المكتبة.
2. أبقِ حقن المعرفة في الدردشة مفعّلًا.
3. اختياري: البحث الذكي في المعرفة للأسئلة التقنية عبر كل المكتبات النشطة.
4. اسأل سؤالًا عن المستندات؛ وتوقّع استشهادات / تذييل معرفة.

د. تنقيح ما استخدمته الذاكرة

1. فعّل شرح الاستدعاء.
2. اسأل سؤال حقيقة شخصية بعد «تذكّر …».
3. افحص رقائق سياق الذاكرة و/أو فحص لوحة المعلومات.

هـ. حصّن الكشط

1. الإعدادات ← النظام ← مزوّد الوكيل ← anyIP (أو بلا).
2. اختبر الاتصال.
3. أعد محاولة read_url محجوب / زحف مكتبة.

و. امنح مركز الذاكرة هوية العلامة (You → Mubder)

1. افتح /memory.
2. تبويب الكيانات ← اعثر على شخص User أو ent_… (أو المركز).
3. إعادة تسمية ← Mubder (أو Kazma).
4. حدّث تحديثًا قسريًا؛ يجب أن يطابق وسم مركز اللوحة الاسم. انقر الصف ← يقوم المركز بالتقريب.

ز. أصلح معتقدًا خاطئًا دون SQL

1. /memory ← المعتقدات ← ابحث.
2. تحرير ← صحّح المفعول (ثم المحمول/الموضوع إن لزم).
3. يجب أن يعرض تحديث الرسم نص الحافة الجديد.

---

6. ملخص API السريع

الطريقة	المسار	الدور
GET	/api/research/ready	فحص مسبق (?live=1 اختياري)
POST	/api/research/sessions	بدء بحث عميق
GET	/api/research/sessions	سرد الجلسات
GET	/api/research/sessions/{id}/stream	تقدّم SSE
POST	/api/research/sessions/{id}/cancel	إلغاء التشغيل
GET	/api/research/eval	درجة معيار التقييم
GET/PUT	/api/settings/memory/merge-kb	الحقن، الترقية، البحث الذكي، الشرح
GET/PUT	/api/settings/proxy	مزوّد الوكيل
GET/PUT	/api/settings/agent/nonstop	إعدادات التنفيذ غير المتوقف والشفاء الذاتي
POST	/api/memory/v2/probe	تشغيل جاف للاستدعاء (مع الشرح)
POST	/api/memory/v2/federated-search	ذاكرة + مكتبة موسومتان
POST	/api/memory/v2/eval/golden	حزمة التقييم الذهبي للاستدعاء
GET	/api/memory/v2/graph	حمولة لوحة المعتقدات (معرّفات فريدة، وسم المركز، groups مضمَّنة)
DELETE	/api/memory/v2/graph/groups/{id}	فك التجميع (عرض فقط)
POST	/api/memory/graph/clear	إبطال ثنائي الزمن محدود بالمستأجر + تنظيف Neo4j
GET	/api/memory/v2/entities	قائمة الكيانات (is_self، graph_id)
POST	/api/memory/v2/entities/{id}/rename	إعادة تسمية للعرض (+ مزامنة المركز للذات)
PATCH	/api/memory/v2/beliefs/{id}	تحرير الثلاثية بواسطة المشغّل
GET	/memory	صفحة HTML لإدارة الذاكرة

الجداول الكاملة: مسارات API.

---

7. ما تعمّدنا عدم فعله

الفكرة	الحالة
دمج المكتبة + المعتقدات في جدول SQLite واحد	لن يُصلَح — اتحادي / حقن فقط
اشتراط Neo4j للذاكرة	لا — ‏SQLite مصدر الحقيقة؛ والكتابة المزدوجة إلى Neo4j اختيارية
توجيه حركة LLM عبر الوكيل	لا — الكشط فقط
‏Postgres-primary / تعدد المناطق كافتراضي	لاحقًا (قضايا التوسّع #76–#78)

---

8. التحقّق بعد الترقية

إعادة تحميل المشغّل (لا تقتل python/uvicorn):

& '.venv\Scripts\python.exe' scripts\service\kazma_guard.py --reload
& '.venv\Scripts\python.exe' scripts\service\kazma_guard.py --status

ثم: ‏GET /health/deep ‏200؛ ‏HITL بطاقة موافقة واحدة + ‏409 عند النقرة الثانية؛ مصفوفة الفحص الدخاني. إطلاق الإنتاج: قائمة فحوص الإنتاج.

---

وثائق ذات صلة

الموضوع	الرابط
خط البحث الكامل والوكيل	البحث في الويب
ابتلاع المكتبة وإعادة الفهرسة الذكية	مكتبة المعرفة
مسار المشغّل لـ V2 + الحقن	أفضل مسار للذاكرة
أسطح الويب	واجهة الويب
التنقيح متعدد المسارات	خريطة التشخيص
عقد البناء	AGENTS.md (§30–§33)
التدقيق الصناعي	AUDIT_DEEP_2026-09-01_EXEC.md