/ الدليل / الملعب / llm-context.py
● مجتمع cyberchitta ⚡ فوري

llm-context.py

بواسطة cyberchitta · cyberchitta/llm-context.py

شارك الجزء المناسب من مشروعك مع أي نموذج لغة كبير — اختيار ملفات قائم على القواعد، وملخصات بنيوية، وجلب عند الطلب، وليس 'لصق الكل'.

llm-context.py أداة لمشاركة الأكواد قائمة على القواعد تعرّض مخرجاتها عبر MCP أو clipboard. بدلاً من رفع مشروعك كاملاً، تحدد قواعس قابلة للتركيب (filter, instruction, style, excerpt) لكل مهمة وتُرسل سياقاً مركزاً. نمط MCP يسمح للنموذج بطلب ملفات إضافية عند الطلب.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

llm-context-py.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "llm-context-py": {
      "command": "uvx",
      "args": [
        "llm-context.py"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "llm-context-py": {
      "command": "uvx",
      "args": [
        "llm-context.py"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "llm-context-py": {
      "command": "uvx",
      "args": [
        "llm-context.py"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "llm-context-py": {
      "command": "uvx",
      "args": [
        "llm-context.py"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "llm-context-py",
      "command": "uvx",
      "args": [
        "llm-context.py"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "llm-context-py": {
      "command": {
        "path": "uvx",
        "args": [
          "llm-context.py"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add llm-context-py -- uvx llm-context.py

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: llm-context.py

أرسل سياق مراجعة أكواد مركزاً إلى نموذجك

👤 المطورون المتعبون من لصق 3000 سطر ⏱ ~15 min intermediate

متى تستخدمه: أنت على وشك طلب 'راجع وحدة المصادقة الخاصة بي' ولا تريد المشروع كاملاً في السياق.

المتطلبات الأساسية
  • تثبيت llm-context.py — uv tool install 'llm-context>=0.6.0'
  • تهيئة في مشروعكlc-init في جذر مشروعك
الخطوات
  1. إنشاء قاعدة filter للمصادقة
    أنشئ قاعدة lc filter باسم 'flt-auth' تتضمن src/auth/** و src/middleware/auth*.ts.✓ تم النسخ
    → تم إنشاء ملف القاعدة تحت .lc/
  2. معاينة ما تختاره القاعدة
    قم بتشغيل lc_preview على flt-auth — أظهر لي أي ملفات سيتم إرسالها وإجمالي عدد tokens.✓ تم النسخ
    → قائمة الملفات + عدد tokens
  3. شارك السياق مع النموذج عبر MCP
    باستخدام قاعدة flt-auth، راجع الوحدة بحثاً عن مشاكل الأمان. إذا كنت بحاجة إلى رؤية ملف محدد غير مضمن، اطلب عبر lc_missing.✓ تم النسخ
    → مراجعة مع طلبات ملفات موجهة

النتيجة: مراجعة أكواد تناسب السياق ويمكنها الاستكشاف — بدون لصق يدوي.

المزالق
  • القاعدة ضيقة جداً → لا يمكن للنموذج فهم المتصلين بوحدتك — أدرج الواجهات / الأنواع من الوحدات المجاورة، استخدم الملخصات للبقية
  • القاعدة واسعة جداً → تجاوز ميزانية tokens — ابدأ بنطاق واسع، راقب lc_preview، ضيّق حتى تصل إلى حدود العميل
اجمعها مع: filesystem

امنح النموذج خريطة بنيوية لمشروع ضخم

👤 المهندسون الذين يبدآن العمل على monorepos غير مألوفة ⏱ ~20 min intermediate

متى تستخدمه: مشروع يحتوي على 100k+ سطر أكواد؛ تحتاج إلى توجيه، وليس كل الأكواد.

الخطوات
  1. إنشاء ملخص
    lc_outlines للمشروع كاملاً — الفئات والدوال العليا والصادرات لكل ملف. تخطي الأجسام.✓ تم النسخ
    → ملخص هيكلي يحتوي على بضعة آلاف من الأسطر
  2. اطرح أسئلة التوجيه
    بناءً على الملخص، أين نقطة الدخول، أين يتم تعريف التوجيه، وأي ملفات تحتوي على تجريدات طبقة البيانات؟✓ تم النسخ
    → إجابات معمارية
  3. التوغل في منطقة واحدة
    أظهر لي المحتويات الكاملة للملفات الثلاثة التي تحدد التوجيه عبر lc_missing.✓ تم النسخ
    → ملفات محددة توسع في السياق

النتيجة: جولة موجهة بدون لصق المشروع كاملاً أبداً.

أرفق قواعس أسلوب المشروع بكل prompt

👤 الفرق ذات الأعراف المحددة ⏱ ~10 min beginner

متى تستخدمه: تريد من Claude أن يعرف دائماً 'نحن نستخدم pytest وليس unittest' دون تكرار.

الخطوات
  1. اكتب قاعدة أسلوب
    أنشئ قاعدة sty-python: 'pytest فقط، type hints مطلوبة، تنسيق black'.✓ تم النسخ
    → تم حفظ القاعدة
  2. التطبيق التلقائي
    استخدم prm-default التي تركب flt-current + sty-python + ins-standards لكل سياق.✓ تم النسخ
    → تم ربط القاعدة تلقائياً

النتيجة: أعراف لكل مهمة مفروضة بدون boilerplate يدوية.

اجمعها مع: drift

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

llm-context-py + drift

drift يسجل الأعراف؛ llm-context يدفع الملفات ذات الصلة فقط + قواعس الأسلوب لكل مهمة

حمّل أعراف drift لهذا المشروع، ثم استخدم lc مع قاعدة flt-auth + sty-ts لمراجعة وحدة المصادقة.✓ تم النسخ
llm-context-py + filesystem

بعد المراجعة، filesystem يطبق التعديلات

بناءً على مراجعة llm-context، استخدم filesystem لتطبيق التعديلات المقترحة على src/auth/.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
lc_outlines rule?: str التوجيه على المشاريع الكبيرة مجاني (محلي)
lc_preview rule: str قبل إرسال السياق، تحقق من النطاق مجاني
lc_missing path: str النموذج يستدعي هذا أثناء المحادثة لطلب ملف مجاني

التكلفة والحدود

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

حصة API
لا شيء
الرموز لكل استدعاء
يعتمد بالكامل على نطاق قاعدتك — هذه هي النقطة
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
قم دائماً بتشغيل lc_preview قبل lc_outlines/إرسال السياق — ثانية واحدة من المعاينة توفر آلاف tokens.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: فقط إلى أي عميل نموذج/موفر تنقل السياق إليه

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

لم يتم العثور على قواعس

قم بتشغيل lc-init في جذر المشروع لإنشاء هيكل .lc/.

تحقق: ls .lc/
عدد tokens في lc_preview مرتفع بشكل مفاجئ

مرشحك فضفاض جداً أو يتضمن ملفات مُنشأة. ضيّق globs وأضف أنماط تجاهل.

تحقق: lc_preview again
أداة MCP غير متاحة

استخدم uvx --from llm-context lc-mcp في إعداد خادم MCP الخاص بك.

تحقق: claude mcp list

البدائل

llm-context.py مقابل البدائل

البديلمتى تستخدمهاالمقايضة
repomix / ai-digestتريد تفريغ ملف واحد، وليس أدوات MCPلا توجد lc_missing تفاعلية؛ لقطة ثابتة
filesystem MCPتريد وصولاً خاماً للملفاتلا يوجد اختيار قائم على القواعس أو ملخصات
driftتريد ذاكرة أعراف دائمة، وليس حزم ملفات لكل مهمةمشكلة مختلفة تماماً

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills