معالج الإعداد الأولي

ينشئ أمر prx onboard ملف الإعدادات الأولي من خلال إرشادك عبر اختيار المزود وإدخال مفتاح API واختيار النموذج وإعداد واجهة الذاكرة. وهو الطريقة الموصى بها لضبط PRX لأول مرة.

ما يفعله الإعداد الأولي

عند تشغيل prx onboard، ينفذ المعالج الخطوات التالية:

1. اختيار مزود النماذج اللغوية -- يطلب منك الاختيار من بين 9 مزودين مدعومين (Anthropic، OpenAI، Google Gemini، Ollama، OpenRouter، إلخ.)
2. تخزين مفتاح API -- يكتب بيانات اعتماد المزود بأمان في ملف الإعدادات
3. جلب النماذج المتاحة -- يستعلم واجهة API الخاصة بالمزود لعرض النماذج التي يمكنك الوصول إليها
4. تعيين نموذج افتراضي -- يتيح لك اختيار النموذج المستخدم افتراضيًا
5. ضبط واجهة الذاكرة -- الاختيار بين Markdown (قائم على الملفات) أو SQLite أو PostgreSQL
6. كتابة ملف الإعدادات -- ينشئ ~/.config/openprx/openprx.toml بإعداداتك

بعد الإعداد الأولي، يصبح PRX جاهزًا للتشغيل باستخدام prx daemon أو prx chat.

الوضع التفاعلي

تجربة الإعداد الافتراضية هي الإعداد السريع الذي يطرح الأسئلة الأساسية فقط. للحصول على معالج تفاعلي كامل يمر عبر كل قسم من أقسام الإعدادات، استخدم الراية --interactive:

prx onboard --interactive

يتضمن المعالج التفاعلي إعدادات إضافية لـ:

• إعدادات مضيف ومنفذ البوابة
• الإعداد المسبق للقنوات (Telegram، Discord، إلخ.)
• مستوى الأمان والاستقلالية
• مجلد مساحة العمل
• إعدادات المراقبة

الإعداد السريع (الافتراضي)

يشغّل أمر prx onboard الافتراضي إعدادًا سريعًا مبسطًا:

prx onboard

يسأل فقط عن المزود ومفتاح API والنموذج -- لا شيء أكثر. جميع الإعدادات الأخرى تستخدم قيمًا افتراضية معقولة.

الإعداد السريع باستخدام الرايات

تجاوز الأسئلة التفاعلية تمامًا بتمرير الرايات:

prx onboard \
  --provider anthropic \
  --api-key sk-ant-api03-xxxxxxxxxxxx \
  --model claude-sonnet-4-20250514

الرايات المتاحة:

الراية	الوصف	مثال
--provider	اسم مزود النماذج اللغوية	anthropic، openai، ollama، openrouter
--api-key	مفتاح API أو بيانات اعتماد المزود	sk-ant-...، sk-...
--model	معرّف النموذج الافتراضي	claude-sonnet-4-20250514، gpt-4o
--memory	واجهة الذاكرة	markdown، sqlite، postgres
--interactive	تشغيل المعالج التفاعلي الكامل	(بدون قيمة)
--channels-only	إعادة تشغيل معالج إصلاح القنوات فقط	(بدون قيمة)

أمثلة

Anthropic Claude مع الإعدادات الافتراضية:

prx onboard --provider anthropic --api-key "$ANTHROPIC_API_KEY"

Ollama محلي (لا حاجة لمفتاح API):

prx onboard --provider ollama --model llama3.2

OpenRouter مع نموذج محدد:

prx onboard --provider openrouter --api-key "$OPENROUTER_API_KEY" --model anthropic/claude-sonnet-4-20250514

OpenAI مع ذاكرة SQLite:

prx onboard --provider openai --api-key "$OPENAI_API_KEY" --model gpt-4o --memory sqlite

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

يكتب معالج الإعداد الأولي الإعدادات في:

~/.config/openprx/openprx.toml

على Linux، يتبع هذا مواصفة XDG Base Directory. على macOS، يستخدم ~/Library/Application Support/openprx/openprx.toml ما لم يكن XDG_CONFIG_HOME معيّنًا.

مثال على الإعدادات المولّدة

بعد تشغيل prx onboard --provider anthropic --model claude-sonnet-4-20250514، تبدو الإعدادات المولّدة هكذا:

# OpenPRX Configuration
# Generated by: prx onboard

# ── Provider ──────────────────────────────────────────────
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"
default_temperature = 0.7
api_key = "sk-ant-api03-xxxxxxxxxxxx"

# ── Workspace ─────────────────────────────────────────────
workspace_dir = "~/.local/share/openprx"

# ── Memory ────────────────────────────────────────────────
[memory]
backend = "markdown"
# path defaults to workspace_dir/memory

# ── Gateway ───────────────────────────────────────────────
[gateway]
host = "127.0.0.1"
port = 3120

# ── Channels ──────────────────────────────────────────────
[channels]
cli = true

# ── Security ──────────────────────────────────────────────
[security]
autonomy = "supervised"

يمكنك تعديل هذا الملف في أي وقت. يدعم PRX إعادة التحميل الفوري -- معظم التغييرات تسري دون إعادة تشغيل الخادم.

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

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

القسم	الغرض
default_provider	مزود النماذج اللغوية المستخدم افتراضيًا
default_model	النموذج المستخدم افتراضيًا
api_key	بيانات اعتماد API للمزود
[memory]	واجهة الذاكرة وإعدادات التخزين
[gateway]	إعدادات بوابة HTTP/WebSocket
[channels]	إعدادات قنوات المراسلة
[channels.telegram]	إعدادات بوت Telegram
[channels.discord]	إعدادات بوت Discord
[security]	مستوى الاستقلالية، صندوق الرمل، السياسات
[router]	استراتيجية توجيه النماذج اللغوية
[self_system]	إعدادات أنبوب التطور الذاتي
[observability]	المقاييس، التتبع، التسجيل
[cron]	إعدادات المهام المجدولة
[plugins]	مسارات وإعدادات إضافات WASM

راجع مرجع الإعدادات الكامل لكل خيار متاح.

التحقق بعد الإعداد

بعد الإعداد الأولي، شغّل أمر التشخيص للتحقق من صحة كل شيء:

prx doctor

يتحقق الفاحص من:

• ملف الإعدادات -- يتحقق من صحة بنية TOML والحقول المطلوبة
• اتصال المزود -- يختبر مفتاح API بالاستعلام من المزود
• توفر النموذج -- يؤكد إمكانية الوصول إلى النموذج المختار
• واجهة الذاكرة -- يتحقق من قابلية الكتابة على واجهة التخزين
• اعتماديات النظام -- يتحقق من الأدوات الاختيارية (git، docker، إلخ.)
• الشبكة -- يختبر الاتصال بالخدمات المضبوطة

مثال على المخرج:

PRX Doctor

  Config file .............. OK  (~/.config/openprx/openprx.toml)
  Provider (anthropic) ..... OK  (authenticated)
  Model .................... OK  (claude-sonnet-4-20250514)
  Memory (markdown) ........ OK  (writable)
  Gateway port (3120) ...... OK  (available)
  Git ...................... OK  (2.43.0)
  Docker ................... WARN (not installed -- sandbox features limited)

All critical checks passed.

أوامر الفاحص الفرعية

يحتوي الفاحص أيضًا على أوامر فرعية للتشخيص الموجّه:

# استعراض كتالوجات النماذج عبر جميع المزودين
prx doctor models

# استعراض نماذج مزود محدد
prx doctor models --provider anthropic

معالج إصلاح القنوات

إذا أكملت الإعداد الأولي بالفعل وتريد إضافة أو إصلاح إعدادات القنوات، استخدم الراية --channels-only:

prx onboard --channels-only

يتجاوز هذا إعداد المزود والنموذج وينتقل مباشرة إلى إعدادات القنوات.

إعادة تشغيل الإعداد الأولي

يمكنك تشغيل prx onboard مرة أخرى في أي وقت. يكتشف المعالج إعداداتك الحالية ويعرض تحديثها بدلاً من الكتابة فوقها من الصفر. تُحفظ إعدادات القنوات الحالية وبيانات الذاكرة والإعدادات المخصصة.

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

• البدء السريع -- تشغيل الخادم والمحادثة
• القنوات -- ربط منصات المراسلة
• مرجع الإعدادات -- القائمة الكاملة لجميع خيارات الإعدادات