التوثيق

ملفات تعريف السياق

استراتيجيات سياق تصريحية ومُدارة بالإصدارات لـ lean-ctx

تتيح لك ملفات تعريف السياق تكوين كيفية معالجة lean-ctx للمحتوى في سيناريوهات مختلفة: الاستكشاف، تصحيح الأخطاء، الإصلاحات العاجلة، CI، مراجعة الكود والمزيد. فكر في الأمر كـ "Context as Code" - استراتيجيات مُدارة بالإصدارات يمكن لفريقك مشاركتها.

ما هي ملفات التعريف؟

ملف التعريف هو ملف TOML يتحكم في أوضاع القراءة وإعدادات الضغط وميزانيات الرموز وطبقات خط الأنابيب والسلوك المستقل. يمكن لملفات التعريف أن ترث من ملفات تعريف أخرى وتتجاوز حقولاً محددة.

ملفات التعريف المدمجة

يأتي lean-ctx مع 5 ملفات تعريف مدمجة محسّنة لسير العمل الشائع:

exploration

سياق واسع لفهم قواعد الكود. وضع الخريطة، ميزانية 200K رمز، تفضيل التخزين المؤقت.

bugfix

تصحيح أخطاء مركّز في الوضع التلقائي. مخرجات موجزة، ميزانية 100K رمز، نقاط تفتيش كل 10 استدعاءات.

hotfix

سياق أدنى للإصلاحات العاجلة. وضع التوقيعات، مخرجات فائقة الاختصار، 30K رمز، حد تكلفة $1.

ci-debug

تصحيح أخطاء CI/CD مع 200 استدعاء shell. مخرجات موجزة، ميزانية 150K رمز.

review

مراجعة كود مع سياق واسع للقراءة فقط. وضع الخريطة، CRP مضغوط، ميزانية 150K رمز.

تفعيل ملف تعريف

اضبط متغير البيئة LEAN_CTX_PROFILE:

export LEAN_CTX_PROFILE=hotfix

أو عبر واجهة سطر الأوامر:

lean-ctx profile set hotfix

أو بدّل أثناء التشغيل عبر MCP:

ctx_session action=profile value=hotfix

إنشاء ملفات تعريف مخصصة

أنشئ ملف TOML للتعريف في .lean-ctx/profiles/ (محلي للمشروع) أو ~/.lean-ctx/profiles/ (عام):

# .lean-ctx/profiles/my-team.toml
[profile]
name = "my-team"
inherits = "exploration"
description = "Team defaults with lower budget"

[read]
default_mode = "map"
max_tokens_per_file = 40000

[budget]
max_context_tokens = 120000
max_cost_usd = 2.0

أو أنشئ ملف تعريف عبر واجهة سطر الأوامر:

lean-ctx profile create my-team --from exploration

وراثة ملفات التعريف

يمكن لملفات التعريف أن ترث من أي ملف تعريف آخر باستخدام حقل inherits. قيم الابن تتجاوز قيم الأب؛ الحقول غير المحددة تُورث من الأب.

# .lean-ctx/profiles/strict-review.toml
[profile]
name = "strict-review"
inherits = "review"

[budget]
max_context_tokens = 80000
max_cost_usd = 1.0

مخطط ملف التعريف

يحتوي ملف التعريف الكامل على هذه الأقسام:

  • [profile] - name, inherits, description
  • [read] - default_mode, max_tokens_per_file, prefer_cache
  • [compression] - crp_mode, output_density, entropy_threshold
  • [budget] - max_context_tokens, max_shell_invocations, max_cost_usd
  • [pipeline] - intent, relevance, compression, translation (مفاتيح منطقية)
  • [autonomy] - auto_dedup, checkpoint_interval

مرجع واجهة سطر الأوامر

  • lean-ctx profile list - عرض جميع ملفات التعريف المتاحة
  • lean-ctx profile show <name> - عرض تفاصيل ملف التعريف
  • lean-ctx profile diff <a> <b> - مقارنة ملفي تعريف
  • lean-ctx profile create <name> - إنشاء ملف تعريف جديد
  • lean-ctx profile set <name> - عرض تعليمات التفعيل

ترتيب الحل

يتم حل ملفات التعريف بهذا الترتيب:

  1. متغير البيئة LEAN_CTX_PROFILE
  2. .lean-ctx/profiles/<name>.toml محلي للمشروع
  3. ~/.lean-ctx/profiles/<name>.toml عام
  4. القيم الافتراضية المدمجة