اختصار OmniRoute على سطح المكتب

يفتح الاختصار بوابة OmniRoute ثم لوحة التحكم على العنوان http://localhost:20128/dashboard بنقرتين.

تنبيه: لا يمكن إنشاء الاختصار من بيئة العمل السحابية، فهو يُنشأ على جهازك أنت. الملفات المرفقة (الموجودة في المجلد scripts/launchers) تقوم بذلك عند تشغيلها عندك.

أولًا: التثبيت (مرة واحدة)

  1. ثبّت Node.js بالإصدار 22 أو أحدث من nodejs.org.
  2. افتح موجه الأوامر أو PowerShell (أو الطرفية في ماك ولينكس) ونفّذ:
    npm install -g omniroute
  3. انسخ المجلد scripts/launchers من المستودع إلى أي مكان ثابت على جهازك، ولا تحذفه بعد إنشاء الاختصار.

ثانيًا: إنشاء الاختصار

ويندوز

  1. انقر بزر الفأرة الأيمن على الملف Create-Desktop-Shortcut.ps1 واختر «Run with PowerShell».
  2. إن منع النظام تشغيله بسبب سياسة التنفيذ، نفّذ هذا الأمر من داخل المجلد:
    powershell -ExecutionPolicy Bypass -File .\Create-Desktop-Shortcut.ps1
  3. طريقة يدوية بديلة: انقر بزر الفأرة الأيمن على OmniRoute.bat ثم «إرسال إلى» ثم «سطح المكتب (إنشاء اختصار)».

ماك

  1. افتح الطرفية داخل المجلد ونفّذ:
    bash create-desktop-shortcut.sh
  2. في أول تشغيل انقر بزر الفأرة الأيمن على الملف الجديد على سطح المكتب واختر «فتح» ثم أكّد.

لينكس

  1. نفّذ الأمر نفسه: bash create-desktop-shortcut.sh.
  2. إن ظهر تحذير على الأيقونة، انقر بزر الفأرة الأيمن واختر «السماح بالتشغيل» (Allow Launching).

ثالثًا: الاستخدام اليومي

  1. انقر مرتين على الاختصار. تظهر نافذة طرفية، وتُفتح لوحة التحكم في المتصفح عند جاهزية الخادم (ينتظر الاختصار حتى 60 ثانية).
  2. أبقِ نافذة الطرفية مفتوحة طوال الاستخدام. إغلاقها يوقف الخادم.
  3. إذا كان الخادم يعمل أصلًا، فالنقر على الاختصار يفتح لوحة التحكم فقط.

رابعًا: التفعيل (أول دخول وإضافة المزوّدين)

  1. سجّل الدخول بكلمة المرور المحددة في المتغير INITIAL_PASSWORD. القيمة في ملف المثال .env.example هي CHANGEME وهي للتجربة المحلية فقط، وغيّرها من Dashboard ← Settings ← Security. إن لم يقبل الدخول فراجع docs/getting-started/TROUBLESHOOTING.md.
  2. اذهب إلى Providers ← Add Provider واختر المزوّد وأدخل مفتاحه.
  3. لا تحتاج مفتاحًا مع بعض المزوّدين المجانيين مثل Kiro وOpenCode Free وPollinations، ويكفي الضغط على Connect.
  4. اربط أدواتك بالعنوان http://localhost:20128/v1 واستعمل النموذج auto ليختار OmniRoute المزوّد المناسب.

خامسًا: المزوّدون الأربعة الجدد

هؤلاء المزوّدون متاحون بدءًا من الإصدار الذي يتضمن طلب الدمج رقم 19206. إن لم يظهروا في نسختك فحدّثها بالأمر npm install -g omniroute@latest.
المزوّدالمطلوب عند الإضافة
Hetzner Inferenceمفتاح من experiments.hetzner.com/inference. الخدمة تجريبية بلا اتفاقية مستوى خدمة.
Grokifiedمفتاح من grokified.com.
Replicateرمز الوصول (API token) من replicate.com.
Cerebriumالمفتاح، مع حقل Base URL إلزامي بصيغة https://api.cerebrium.ai/v4/p-xxxx/اسم-التطبيق/run وهو رابط نشرك أنت. بدونه يظهر خطأ 400.

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

حل المشكلات الشائعة