lean-ctx

yvgude/lean-ctx – ملخص المستودع

الاسم: yvgude/lean-ctx

الوصف: *Control what your AI can see your AI — طبقة ذكاء السياق للوكيل AI؛ ثنائية محلية واحدة بلغة Rust تقرر ما يقرأه الوكيل، تضغط ما يرسله، تتذكر ما تعلمه، تحمي ما يلمسه، وتثبت ما يحفظه بسجلّ موقّع يمكن التحقق منه. النتيجة: خفض 60‑90 % من عدد الرموز (الـ tokens) مع الحفاظ على الأداء، بدون إعدادات مسبقة.

اللغة: Rust

النجوم: 2,943 (حتى لحظة كتابة هذا الشرح)

ما هو LeanCTX ولماذا يُستخدم؟

LeanCTX هو طبقة هندسة السياق (Context Engineering Layer) للوكيل الذكائي. يعمل كوسيط محلي بين الوكيل (مثلاً Cursor, Claude Code, Copilot, Windsurf, Codex, Gemini أو أي من 30+ وكيل آخر) والمصادر التي يتفاعل معها الوكيل (ملفات، أوامر شيفرة، قواعد بيانات، إلخ).

الفوائد الأساسية التي يقدّمها للمطورين

الفائدة	كيف يتحققها LeanCTX
تقليل استهلاك الرموز	يضغط قراءة الملفات ومخرجات الأوامر؛ إعادة القراءة المخزّنة تكلف ~13 رمزًا فقط بدلاً من آلاف الرموز.
تقليل التكلفة المالية	عدد أقل من الرموز المرسلة إلى نماذج AI يعني فواتير API أقل (تقدير 60‑90 % توفير).
استمرارية السياق بين الجلسات	ذاكرة الجلسة (CCP) تحتفظ بالحقائق والقرارات عبر محادثات متعددة، فلا تحتاج إلى إعادة شرح نفس الملف مرارًا.
عدم الحاجة لتعديل الإعدادات	أمر واحد `lean-ctx setup` يثبّت الوكيل ويعمل معه بدون تعديل إعدادات الوكيل أو المشروع.
رؤية واضحة لاستهلاك السياق	لوحة تحكم مباشرة تُظهر عدد الرموز المدفوعة والموفّرة بالدولار في الوقت الحقيقي.
أمان وقابلية إثبات	كل عملية حفظ تُوقّع وتُسجّل في دفتر حسابات يمكن التحقق منه لاحقًا، مما يضمنintegrity.

أهم الميزات (حسب ما ورد في README)

1. الضغط (Compression) – كفاءة الإدخال

أنماط قراءة الملفات: 10 أوضاع مثل full, map, signatures, diff, lines:N-M, density:X …
إعادة القراءة المخزّنة تكلف ~13 رمزًا.
الكثافة المستهدفة (density:0.4): ضغط على نمط SDE يحتفظ بأعلى خطوط إنتروبيا حتى يبقى ~40 % من الرموز الأصلية، بطريقة محددة.
كشف JIT: نمط signatures يحمل امتدادات الأسطر ويشير إلى lines:N-M للتوسيع عند الحاجة (المخطط أولًا، التفاصيل عند الطلب).
ضغط مخرجات الشيفرة: أكثر من 95 نمط لضغط مخرجات الأوامر الشائعة (git, npm, cargo, docker, kubectl, terraform…) مع 270 قاعدة مرور (passthrough).
دعم شجرة التحليل (Tree‑sitter): فهم بنيوي لـ 18 لغة برمجة لضغط أكثر ذكاءً من مجرد ضغط نصي.

2. التوجيه (Routing) – fidelity المناسب لكل قراءة

يختار تلقائيًا وضع القراءة الأمثل لكل نوع ملف باستخدام ModePredictor الذي يتعلم من الجلسات السابقة.
محرك النية (IntentEngine) يصنّف تعقيد الاستعلام zodat البحثات البسيطة تبقى رخيصة.

3. الذاكرة (Memory) – سياق يبقى بين المحادثات

ذاكرة الجلسة (CCP): تخزين منظم للمهام والحقائق والقرارات يبقى صالحًا بعد ضغط السياق.
مخطط المعرفة: حقائق زمنية بنوافذ صلاحية،episodic + procedural (غير مفصّل بالكامل في المقتطف لكن يُذكر وجوده).

4. الإثبات (Proof) – ما يُحفظ يمكن التحقق منه

كل عملية حفظ تُوقّع وتُضاف إلى دفتر حسابات يمكن التحقق منه لاحقًا، ما يضمن أن ما يراه الوكيل ويذكره هو بالضبط ما تم تخزينه.

5. تكامل سهل مع الوكلاء الشائعين

يعمل مع Cursor, Claude Code, Copilot, Windsurf, Codex, Gemini وأكثر من 30 وكيل آخر دونneed لتعديل إعداداتهم.
أمر التثبيت السريع: lean-ctx setup.

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

عرض مباشر لتوفير الرموز والتكلفة بالدولار.
تقارير مقارنة (benchmark) تُظهر التحسين حسب اللغة ووضع القراءة.

7. التوزيع والتثبيت المتعدد

حزمة على crates.io (lean-ctx).
حزمة على npm (lean-ctx-bin).
متوفر في AUR لمستخدمي Arch Linux.
متوفر عبر Pi.dev.
رخصة Apache 2.0.

كيف يتم التثبيت والاستخدام الأساسي؟

> ملاحظة: الخطوات التالية مستخلصة من قسم “Get started – 60 seconds” في README ومن روابط التثبيت المذكورة.

التثبيت عبر Cargo (المستحسن للمستخدمين الذين يفضّلون Rust):

   cargo install lean-ctx

أو عبر npm (للمستخدمين الذين يفضّلون Node):

   npm i -g lean-ctx-bin

إعداد LeanCTX للوكلاء:

بعد التثبيت، شغّل الأمر مرة واحدة:

   lean-ctx setup

يكتشف الأمر الوكلاء المثبتة (Cursor, Claude Code، إلخ) ويضيف وسيطًا محليًا يوجه طلباتهم عبر LeanCTX.
لا يلزم تعديل ملفات إعداد الوكيل يدويًا.

تشغيل الوكيل كالمعتاد:

بعد الإعداد، عند طلب الوكيل قراءة ملف أو تشغيل أمر، يمر الطلب عبر LeanCTX الذي يضغطه، يخزّنه، ويوجه النتيجة مرةً إلى الوكيل.

مراقبة الأداء:

يمكن فتح لوحة التحكم عبر متصفح (عادةً على http://localhost:<port>، يُظهرها الأمر عند التشغيل) لمشاهدة عدد الرموز المستهلكة والموفّرة في الوقت الحقيقي.
أمر lean-ctx benchmark يُنتج تقريرًا مقارنًا يوضح التحسين حسب لغة الملف ووضع القراءة.

إلغاء التثبيت أو الإعادة الضبط:

لإزالة الوسيط: lean-ctx unset (أو ما يعادله حسب الوثائق).
لإعادة ضبط الإعدادات: إعادة تشغيل lean-ctx setup.

التقنيات المستخدمة

التقنية	الغرض في المشروع
Rust	لغة التنفيذ الأساسية؛ تضمن أداءً عاليًا، أمانًا للذاكرة، وتوزيعًا كثنائي وحيد دون اعتماديات ثقيلة.
Tree‑sitter	مكتبة تحليل بناءية تُستَخدم لفهم بنية الكود لـ 18 لغة وتمكين ضغط مبني على البنية وليس على النص فقط.
مضغط مخصص	خوارزميات ضغط مخصصة للسياق (أنماط القراءة، الكثافة المستهدفة، كشف JIT) تم تنفيذها في Rust.
نظام إضافة (plugins) للوكلاء	آلية لاكتشاف الوكلاء المثبتة وتوجيه استدعاءاتهم عبر وسيط محلي دونneed لتعديل إعداداتهم.
لوحة تحكم ويب (مُضمنة في الثنائي)	تُعرض إحصائيات استهلاك الرموز والتوفير المالي باستخدام خادم HTTP خفيف مدمج.
ملفات تعريف وتخزين محلي	تخزين ذاكرة الجلسة (CCP) ومخطط المعرفة على القرص بصيغة فعّالة (على الأرجح باستخدام structs وserialization في Rust).
إثبات التوقيع	استخدام تشفير التوقيع (مثلاً Ed25519 أو مشابه) لتسجيل عمليات الحفظ في دفتر يمكن التحقق منه لاحقًا.

من يستفيد من LeanCTX؟

الفئة	السبب في الاستفادة
مطورون يعملون مع مساعدي برمجة AI (Cursor, Copilot, Claude Code…)	يقللون من استهلاك الرموز وتكاليف API، ويحافظون على سياق العمل عبر محادثات متعددة.
فرق DevOps / SRE التي تستخدم أوامرShell بشكل متكرر مع الوكلاء	يضغط مخرجات الأوامر (git status, docker ps, kubectl get…) لتجنب إرسال آلاف الرموز غير الضرورية.
باحثون في مجال هندسة السياق	يوفّر منصة تجريبية لتجربة أنماط قراءة مختلفة، تقنيات ضغط، وآليات ذاكرة طويلة الأمد.
مستخدمون يهتمون بالخصوصية والأمان	كل العملية محلية؛ لا تُرسل بيانات خام إلى خوادم خارجية ما لم يختار الوكيل ذلك؛ بالإضافة إلى إثبات قابلية التحقق من ما تم حفظه.

| **من يرغب في تقليل التكلفة الس