اختصار OmniRoute على سطح المكتب
يفتح الاختصار بوابة OmniRoute ثم لوحة التحكم على العنوان http://localhost:20128/dashboard بنقرتين.
تنبيه: لا يمكن إنشاء الاختصار من بيئة العمل السحابية، فهو يُنشأ على جهازك أنت. الملفات المرفقة (الموجودة في المجلد
scripts/launchers) تقوم بذلك عند تشغيلها عندك.
أولًا: التثبيت (مرة واحدة)
- ثبّت Node.js بالإصدار 22 أو أحدث من
nodejs.org. - افتح موجه الأوامر أو PowerShell (أو الطرفية في ماك ولينكس) ونفّذ:
npm install -g omniroute
- انسخ المجلد
scripts/launchersمن المستودع إلى أي مكان ثابت على جهازك، ولا تحذفه بعد إنشاء الاختصار.
ثانيًا: إنشاء الاختصار
ويندوز
- انقر بزر الفأرة الأيمن على الملف
Create-Desktop-Shortcut.ps1واختر «Run with PowerShell». - إن منع النظام تشغيله بسبب سياسة التنفيذ، نفّذ هذا الأمر من داخل المجلد:
powershell -ExecutionPolicy Bypass -File .\Create-Desktop-Shortcut.ps1
- طريقة يدوية بديلة: انقر بزر الفأرة الأيمن على
OmniRoute.batثم «إرسال إلى» ثم «سطح المكتب (إنشاء اختصار)».
ماك
- افتح الطرفية داخل المجلد ونفّذ:
bash create-desktop-shortcut.sh
- في أول تشغيل انقر بزر الفأرة الأيمن على الملف الجديد على سطح المكتب واختر «فتح» ثم أكّد.
لينكس
- نفّذ الأمر نفسه:
bash create-desktop-shortcut.sh. - إن ظهر تحذير على الأيقونة، انقر بزر الفأرة الأيمن واختر «السماح بالتشغيل» (Allow Launching).
ثالثًا: الاستخدام اليومي
- انقر مرتين على الاختصار. تظهر نافذة طرفية، وتُفتح لوحة التحكم في المتصفح عند جاهزية الخادم (ينتظر الاختصار حتى 60 ثانية).
- أبقِ نافذة الطرفية مفتوحة طوال الاستخدام. إغلاقها يوقف الخادم.
- إذا كان الخادم يعمل أصلًا، فالنقر على الاختصار يفتح لوحة التحكم فقط.
رابعًا: التفعيل (أول دخول وإضافة المزوّدين)
- سجّل الدخول بكلمة المرور المحددة في المتغير
INITIAL_PASSWORD. القيمة في ملف المثال.env.exampleهيCHANGEMEوهي للتجربة المحلية فقط، وغيّرها من Dashboard ← Settings ← Security. إن لم يقبل الدخول فراجعdocs/getting-started/TROUBLESHOOTING.md. - اذهب إلى Providers ← Add Provider واختر المزوّد وأدخل مفتاحه.
- لا تحتاج مفتاحًا مع بعض المزوّدين المجانيين مثل Kiro وOpenCode Free وPollinations، ويكفي الضغط على Connect.
- اربط أدواتك بالعنوان
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. |
لم تُجرَّب هذه المزوّدات على الخدمات الحية بعد، لأن بيئة العمل لا تملك مفاتيح ولا وصولًا إلى مضيفاتها. يستحسن اختبار طلب واحد لكل مزوّد قبل الاعتماد عليه.
حل المشكلات الشائعة
- العبارة «OmniRoute is not installed yet»: نفّذ
npm install -g omnirouteثم أعد فتح الطرفية. - عدم التعرف على الأمر
npm: أعد تثبيت Node.js وأعد تشغيل الجهاز. - المنفذ 20128 مشغول: أغلق النسخة الأخرى أو غيّر المنفذ بالمتغير
PORT، وعدّل العنوان داخل ملف الاختصار. - الاختصار لا يعمل بعد نقل المجلد: أعد تشغيل ملف إنشاء الاختصار من مكان المجلد الجديد.