الإعدادات

يستخدم PRX نظام إعدادات قائم على TOML مع دعم إعادة التحميل الفوري. تتواجد جميع الإعدادات في ملف واحد (مع أجزاء مقسّمة اختيارية)، ومعظم التغييرات تسري فورًا دون إعادة تشغيل الخادم.

موقع ملف الإعدادات

ملف الإعدادات الرئيسي هو:

~/.openprx/config.toml

يحدد PRX مجلد الإعدادات بالترتيب التالي:

1. متغير البيئة OPENPRX_CONFIG_DIR (إذا كان معيّنًا)
2. متغير البيئة OPENPRX_WORKSPACE (إذا كان معيّنًا)
3. علامة مساحة العمل النشطة (~/.openprx/active_workspace.toml)
4. ~/.openprx/ (الافتراضي)

مجلد مساحة العمل (حيث تُخزّن الذاكرة والجلسات والبيانات) يكون افتراضيًا ~/.openprx/workspace/.

تنسيق TOML

تستخدم إعدادات PRX تنسيق TOML -- تنسيق بسيط وقابل للقراءة البشرية. إليك إعدادات عمل بسيطة:

# اختيار المزود والنموذج
default_provider = "anthropic"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

# مفتاح API (أو استخدم متغير البيئة ANTHROPIC_API_KEY)
api_key = "sk-ant-..."

# واجهة الذاكرة
[memory]
backend = "sqlite"
auto_save = true

# خادم البوابة
[gateway]
port = 16830
host = "127.0.0.1"

أقسام الإعدادات

تنتظم الإعدادات في الأقسام الرئيسية التالية:

القسم	الغرض
(المستوى الأعلى)	المزود الافتراضي، النموذج، درجة الحرارة، مفتاح API
[gateway]	بوابة HTTP: المضيف، المنفذ، الاقتران، حدود الطلبات
[channels_config]	قنوات المراسلة: Telegram، Discord، Slack، إلخ.
[channels_config.telegram]	إعدادات بوت Telegram
[channels_config.discord]	إعدادات بوت Discord
[memory]	واجهة الذاكرة وإعدادات التضمينات
[router]	موجه النماذج اللغوية الإرشادي وAutomix
[security]	صندوق الرمل، حدود الموارد، تسجيل التدقيق
[autonomy]	مستويات الاستقلالية وقواعد نطاق الأدوات
[observability]	واجهة المقاييس والتتبع
[mcp]	تكامل خادم بروتوكول سياق النموذج
[browser]	إعدادات أداة أتمتة المتصفح
[web_search]	إعدادات أدوات البحث على الويب والجلب
[xin]	محرك المهام المستقلة Xin
[reliability]	سلاسل إعادة المحاولة والاحتياط
[cost]	حدود الإنفاق وتسعير النماذج
[cron]	تعريفات المهام المجدولة
[self_system]	عناصر التحكم في محرك التطور الذاتي
[proxy]	إعدادات وكيل HTTP/HTTPS/SOCKS5
[secrets]	مخزن بيانات الاعتماد المشفرة
[auth]	استيراد بيانات الاعتماد الخارجية (Codex CLI، إلخ.)
[storage]	مزود التخزين الدائم
[tunnel]	كشف النفق العام
[nodes]	إعدادات وكيل العقد البعيدة

راجع مرجع الإعدادات للتوثيق الكامل حقلًا بحقل.

ملفات الإعدادات المقسّمة

لعمليات النشر المعقدة، يدعم PRX تقسيم الإعدادات إلى ملفات أجزاء ضمن مجلد config.d/ بجانب config.toml:

~/.openprx/
  config.toml          # الإعدادات الرئيسية (المستوى الأعلى + التجاوزات)
  config.d/
    channels.toml      # قسم [channels_config]
    memory.toml        # قسما [memory] و[storage]
    security.toml      # قسما [security] و[autonomy]
    agents.toml        # قسما [agents] و[sessions_spawn]
    identity.toml      # قسما [identity] و[identity_bindings]
    network.toml       # أقسام [gateway] و[tunnel] و[proxy]
    scheduler.toml     # أقسام [scheduler] و[cron] و[heartbeat]

تُدمج ملفات الأجزاء فوق config.toml (الأجزاء لها الأولوية). تُحمّل الملفات أبجديًا.

كيفية التعديل

المعالج التفاعلي

يرشدك معالج الإعداد عبر اختيار المزود وإعداد القنوات وضبط الذاكرة:

prx onboard

أوامر الإعدادات في سطر الأوامر

عرض وتعديل الإعدادات من سطر الأوامر:

# عرض الإعدادات الحالية
prx config show

# تعديل قيمة محددة
prx config set default_provider anthropic
prx config set default_model "anthropic/claude-sonnet-4-6"

# تشغيل إعادة تحميل يدوية
prx config reload

التحرير المباشر

افتح ~/.openprx/config.toml في أي محرر نصوص. يتم اكتشاف التغييرات تلقائيًا بواسطة مراقب الملفات وتُطبَّق خلال ثانية واحدة (راجع إعادة التحميل الفوري).

تصدير المخطط

صدّر مخطط الإعدادات الكامل كـ JSON Schema للإكمال التلقائي والتحقق من الصحة في المحرر:

prx config schema

ينتج هذا مستند JSON Schema يمكن استخدامه مع VS Code أو IntelliJ أو أي محرر يدعم التحقق من صحة مخطط TOML.

إعادة التحميل الفوري

تُطبَّق معظم تغييرات الإعدادات فورًا دون إعادة تشغيل PRX. يستخدم مراقب الملفات نافذة تأخير مدتها ثانية واحدة ويستبدل الإعدادات الحية ذريًا عند نجاح التحليل. إذا احتوى الملف الجديد على أخطاء بنية، يُحتفظ بالإعدادات السابقة ويُسجَّل تحذير.

راجع إعادة التحميل الفوري لتفاصيل ما يتطلب إعادة تشغيل.

الخطوات التالية

• مرجع الإعدادات -- التوثيق الكامل حقلًا بحقل
• إعادة التحميل الفوري -- ما يتغير فوريًا مقابل ما يتطلب إعادة تشغيل
• متغيرات البيئة -- متغيرات البيئة ومفاتيح API ودعم .env
• مزودو النماذج اللغوية -- إعدادات خاصة بالمزود