تم تثبيت Orca لكن لا يوجد أمر orca: تحقق أولًا من أنه ثُبّت باسم orca-ide (تم التحقق في 2026-10)
عندما لا يُثبّت Orca، أو لا تجد الطرفية أي أمر بعد تثبيته، تكون الأسباب المعتادة هي اسم الأمر وأمر التثبيت عبر Homebrew وتسجيل CLI: على Linux يُثبّت باسم orca-ide وليس orca؛ ويحتاج Homebrew إلى الأمر مع tap؛ وعندما يعرض CLI رسالة command not found يجب تسجيله ضمن Settings → General → Orca CLI. يتصل SSH لكنه لا يبدأ أي طرفية بعيدة، ويفشل إقران الهاتف — وتحتوي الوثائق الرسمية على جملة واحدة عن كل منها (تم التحقق في 2026-10-19).
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
بضعة أمور ينبغي معرفتها أولًا
أسماء الأوامر والحزم
رسميًا، يُثبّت Orca CLI باسم orca-ide على Linux ولا يحل محل قارئ الشاشة GNOME؛ وتحمل حزمتا .deb و.rpm الاسم نفسه. لذا فإن «ثبّتته ولا يفعل orca شيئًا» ليس في الغالب تثبيتًا فاشلًا.
أمر brew الكامل
حزمة cask لهذا التطبيق هي stablyai/orca/orca، وأمر التثبيت الرسمي هو brew install --cask stablyai/orca/orca، وتجري الترقيات عبر أمر cask؛ وتتابع حزمة cask هذه القناة المستقرة فقط، لذا تأتي إصدارات RC من GitHub Releases أو من Check for Updates داخل التطبيق. وقد أصبحت حزمة orca المجردة معطّلة منذ 2026-09-01، والسبب fails_gatekeeper_check.
أين يُسجّل CLI
عندما تعجز الطرفية عن العثور على الأمر، فإن الإصلاح الرسمي هو تسجيل CLI ضمن Settings → General → Orca CLI؛ وعلى macOS يُثبّت shim في ~/.local/bin، ويجب أن يكون ذلك الدليل ضمن PATH في shell الخاص بك.
صيغة الحزمة ≠ الإصدار
تُثبّت AppImage و.deb و.rpm التطبيق نفسه؛ ورسميًا، الفرق الوحيد هو طريقة وصول التحديثات إليك: تُحدّث AppImage نفسها في مكانها، بينما يعرض Orca الإصدار الجديد لحزمتي .deb و.rpm ويمنحك أمر التثبيت.
للتوضيح: التطبيق نفسه، لكن اسم الأمر ليس دائمًا orca
تخصّ صفحة التثبيت الرسمية هذا الموضوع بقسم مستقل، يتصدّره اسم الأمر: تقول النصوص إن Orca CLI على Linux يُثبَّت باسم orca-ide، لا orca، لأن قارئ الشاشة الذي يأتي مع GNOME (الموجود افتراضيًا على Ubuntu وغيرها من أسطح مكتب GNOME) يملك بالفعل /usr/bin/orca، ولن يطغى Orca عليه؛ ويحسم القسم نفسه أيضًا أسماء حزم .deb و.rpm، وهي orca-ide للسبب نفسه. لذا على Linux، فإن «تم التثبيت، وorca لا يفعل شيئًا» ليس عادة تثبيتًا فاشلًا — فذلك الأمر لم يكن اسمه orca أصلًا. وإعادة قراءة صفحة التثبيت في 2026-10-19 تترك تلك الصياغات دون تغيير، وأحدث إصدار هو v1.4.230.
مُحتسبة في اليوم نفسه
يُرجع أحدث إصدار في GitHub Releases، الذي جُلب في 2026-10-19، الإصدار v1.4.230، المنشور في 2026-10-19T06:30:00Z، مع أصول تشمل بنى orca-macos-x64.dmg وorca-windows-setup.exe وorca-linux.AppImage. كانت اللقطة المأخوذة في 2026-09-23 لا تزال v1.4.207، المنشورة في 2026-09-22T09:44:40Z. الترخيص هو MIT بحسب ملف LICENSE الخاص بالمستودع (يوافق حقل license في API على ذلك). تُستبعد العدادات التي تتغير كل دقيقة، مثل النجوم (stars) والتفرعات (forks)، من متن هذه الصفحة — فذلك ينتمي إلى جدول المقارنة في صفحة P4، حيث يحمل كل رقم يوم جلبه الخاص. على الهواتف، يمر iOS عبر App Store (الاسم الداخلي للتطبيق في ذلك الإدراج هو orca-ide)؛ أما Android فالقناة الرسمية لديه هي app-release.apk في صفحة الإصدارات، إضافة إلى دليل تثبيت قصير.
الخط الزمني
2026-09-01: في البيانات الوصفية العامة لـ Homebrew، هذا هو disable_date الخاص بـ orca cask، وdisable_reason الخاص به هو fails_gatekeeper_check. أظهر جلب 2026-09-23 القيمة disabled: true وdeprecated: false، ويعيد فحص 2026-10-20 قراءة الحالتين نفسيهما. لذا لم يكن «مستبدلًا بـ Orca» — بل عطّله Homebrew.
2026-09-22: تستند هذه الصفحة إلى ست صفحات من الوثائق الرسمية — install وtroubleshooting وssh وmobile وandroid-apk وheadless Linux server — بالإضافة إلى README. 2026-10-19: أحدث إصدار رسمي هو v1.4.230؛ والأوامر والمسارات وأسماء الحزم هنا تتبع تلك الوثائق.
2026-10-19: أحدث إصدار رسمي هو v1.4.230، نُشر في 2026-10-19T06:30:00Z؛ وتقول ملاحظات الإصدار نفسها إن Orca Server 2.0 سيصدر قريبًا، بينما لا يزال Remote Server الحالي تجريبيًا وقد يحتوي على أخطاء. تتغير أسماء CLI وأسماء الحزم وحالة cask حسب الإصدار، لذلك يذكر كل قسم يوم التحقق منه.
الإصلاح بنفسك مقابل الوثائق
ما تنص عليه الوثائق
تم التحقق في 2026-10-19؛ سبع عبارات تطابق الصفحات الرسمية حرفيًا: 1) على Linux يُثبَّت Orca CLI باسم orca-ide، لا orca؛ 2) قارئ الشاشة المرفق مع GNOME يملك بالفعل /usr/bin/orca، ولن يحل Orca محلّه؛ 3) أمر التثبيت هو الأمر المرتبط بـ tap، وأمر الترقية هو أمر cask، ويتتبع ذلك cask القناة المستقرة؛ 4) يوفّر كل إصدار ثلاث حزم Linux — AppImage و.deb و.rpm، لكل من x64 وarm64؛ 5) تضم الحزم الثلاث التطبيق نفسه، والفرق الوحيد هو كيفية وصول التحديثات إليك؛ 6) إصلاح «command not found» هو تسجيل CLI ضمن الإعدادات ← عام ← Orca CLI، وعلى macOS يُوضع shim في ~/.local/bin؛ 7) عرض إقران الهاتف هو قدرة تتضمن بيانات اعتماد جهاز ومواد E2EE، ويجب ألا يُرسل إلا إلى العميل المقصود. تقول صفحة التثبيت الرسمية أيضًا إن Orca تطبيق سطح مكتب تُنزَّل بنياته حسب المنصة من GitHub، وإن بناء macOS موقّع وموثّق، لذا قد يطلب منك التشغيل الأول التأكيد رغم ذلك.
⚠️ افتراضات خاطئة شائعة
الأول: «كتابة orca لا تعطي شيئًا، لذا فهو غير مثبّت». على Linux لم يُسمَّ orca قط؛ وتقول الصفحة الرسمية صراحةً إنه لن يحجب قارئ شاشة GNOME، لذا تحقق من orca-ide وPATH أولًا. الثاني: «سُحب orca من brew، لذا لا يستطيع Homebrew تثبيت Orca». المعطّل هو cask الذي يحمل الاسم نفسه دون tap (معطّل منذ 2026-09-01، والسبب fails_gatekeeper_check، ولا يزال معطّلًا في إعادة التحقق بتاريخ 2026-10-20)؛ أما stablyai/orca/orca مع tap فهو هذا المسار، وهو أول سطر في صفحة التثبيت الرسمية. الثالث: «SSH يتصل، لذا فإنه يعمل». تفصل صفحة استكشاف الأخطاء وإصلاحها الرسمية بين الملفات والطرفيات باعتبارهما أمرين اثنين، وتدرج حالة واحدة على حدة: ينقل SSH الملفات، لكنه لا يستطيع سحب مجلد كامل بمفرده — فالمجلد الكامل يحتاج SFTP بشكل تكراري، وعلى قناة sftp الخاصة بالنظام قد يعمل نصف ذلك فقط (تحقق في 2026-09-22؛ واللقطات في المصادر). وتجد إعادة تحقق في 2026-10-20 أن الصياغة الرسمية لم تتغير، لذا يظل ذلك قائمًا.
تثبيت خاطئ مقابل تثبيت مفقود
أولًا: الأمر ومسار التثبيت
الاسم: هل يعيد which orca-ide أي شيء، وهل ~/.local/bin موجود في PATH لديك. القناة: على macOS، cask مع tap أو .dmg من GitHub — كلاهما مستقر، لكن cask وحده يتبع brew upgrade. بمجرد أن يتطابق الاسم والقناة، تختفي معظم حالات "command not found" من تلقاء نفسها. هناك حالة أخرى تنتمي إلى هذه الخطوة (تم التحقق في 2026-11-12). السطر: الأمر موجود، لكنه ينتهي فورًا بالرسالة "Unable to determine Orca.app path from symlink: /usr/local/bin/orca". السبب: على macOS، الأمر رابط رمزي — ومسار التطبيق الافتراضي له هو /usr/local/bin/orca — ويجب أن يُحل إلى الحزمة عند Orca.app/Contents/Resources/bin/orca؛ يقطع المشغّل مساره المحلول عند .app للعثور على تلك الحزمة، لذا فإن أي رابط يُحل خارج Orca.app يطبع السطر نفسه. الحالة المسجلة في issue #19120 هي رابط لا يستطيع حسابك قراءته: نشر الإصدار 1.4.197 الرابط مملوكًا لـ root بالوضع lrwx------، ويفرض macOS وضع الرابط الرمزي نفسه عند readlink()، لذا فشل هدف صحيح في الحل رغم ذلك. الإصلاح: سجّل مرة أخرى في Settings → General → Orca CLI. بعد إصلاح 2026-10-16، ينشر تسجيل جديد الرابط بالوضع 0755، ويُوسم الرابط غير القابل للقراءة الذي خلفه إصدار أقدم بالرسالة "cannot be read. Register again to repair it.". على إصدار أقدم، الإجراء لمرة واحدة الذي يورده issue نفسه هو sudo chmod -h 755 /usr/local/bin/orca. بعد ذلك يجب أن يعرض ls -l القيمة lrwxr-xr-x، مثل الأوامر الأخرى في ذلك الدليل.
ثم: التوقيع والمضيف البعيد والصورة
التوقيع والموافقة: يقول قسم macOS الرسمي إن بناء التطبيق موقّع وموثّق، وإن التشغيل الأول قد يطلب منك التأكيد رغم ذلك، وهو أمر طبيعي في التطبيقات المبنية على Electron. الجهاز البعيد: إذا اتصل SSH لكن لم تبدأ أي نافذة طرفية، تطلب منك الوثائق التأكد من أن الجهاز البعيد يملك Node ووصولًا إلى الشبكة من أجل تثبيت الترحيل لأول مرة؛ وعلى Linux أيضًا make وg++/clang++ وpython3، ثم أعد الاتصال مرة واحدة. الصورة الدنيا: يحتاج الخادم بلا سطح مكتب إلى Xvfb والمكتبات المشتركة التي يرتبط بها Electron — الناقص هو المكتبات، لا Orca نفسه.
اختيار مسار التثبيت
macOS: الأمر الرسمي هو الذي يتضمن tap، وهو brew install --cask stablyai/orca/orca، وتجري الترقيات عبر brew upgrade --cask orca؛ وتتابع حزمة cask هذه القناة المستقرة، لذا تأتي إصدارات RC من GitHub Releases أو من Check for Updates داخل التطبيق. أما اسم cask orca المجرد فتحتفظ به حزمة أخرى: تُظهر بيانات Homebrew الوصفية العامة التي جُلبت في 2026-09-23 ما يلي: disabled: true, disable_date 2026-09-01, disable_reason fails_gatekeeper_check (غير محذوف، وdeprecated لا يزال false)، ولا تزال إعادة التحقق في 2026-10-20 تُظهر disabled: true, deprecated: false. Linux: تسرد صفحة التثبيت الرسمية AppImage و.deb و.rpm (يتوفر كل من x64 وarm64)؛ وهذه الصيغ تثبّت التطبيق نفسه، والفرق الوحيد هو طريقة وصول التحديثات إليك — تُحدّث AppImage نفسها في مكانها، بينما تتلقى .deb و.rpm إشعار الإصدار وأمر التثبيت من Orca. الأمر هو orca-ide: تضع حزمتا .deb و.rpm الأمر عند /usr/bin/orca-ide، بينما مع AppImage تسجّله ضمن Settings → General → Orca CLI، ويستقر shim في ~/.local/bin، لذا تحقق من أنه ضمن PATH لديك. توجد الإصدارات الأقدم على GitHub Releases. للخوادم بلا واجهة صفحتها الرسمية الخاصة: ثبّت Xvfb والمكتبات المشتركة التي يحتاجها Electron أولًا. مسار Arch هو yay -S stably-orca-bin، أو stably-orca-git المبني من المصدر.
أين يندرج QCode في ذلك
لا شيء في جانب التثبيت يخص QCode: لا يشحن Orca أي نموذج ولا يحتفظ بأي بيانات اعتماد، وبعد التثبيت يظل الوصول إلى النماذج آتيًا من إعدادات CLI الوكيل الذي شغّلته. المهم هو إلى أين يشير ذلك المفتاح — فمع نقطة النهاية الخاصة بك تغيّر base_url ومفتاح ذلك CLI؛ أما تشغيل Orca نفسه وفتح الطرفية البعيدة واقتران الهاتف فهي مهام من جانب التثبيت؛ ويُوصَف إعداد نقطة النهاية في دليل نقطة النهاية المخصصة على الموقع. أما من جانب QCode فتُحتسب التكلفة لكل token، وسعر كل نموذج مُدرج على /models. هل تريد تجربة بعض النماذج الأحدث على QCode أولًا؟ تبدأ باقات الدفع حسب الاستخدام من $4 مقابل حصة لمرة واحدة تستخدمها خلال 7 أيام.
الأسئلة الشائعة
كتبت orca على Linux فلم تظهر أي استجابة. هل فشل التثبيت؟
عادةً يكون مثبتًا. تخصص صفحة التثبيت الرسمية قسمًا خاصًا لاسم الأمر: على Linux يُثبَّت Orca CLI باسم orca-ide، لأن قارئ الشاشة المرفق مع GNOME يملك بالفعل /usr/bin/orca ولن يحل Orca محلّه؛ وسُمّيت حزمتا .deb و.rpm للسبب نفسه. لذا فإن أمر orca غير العامل يعود في الغالب إلى مشكلة تسمية، لا إلى تثبيت مفقود.
لماذا يبلّغ brew install --cask orca بأن حزمة cask هذه معطّلة؟
لأن cask الخاص بـ orca دون tap ليس قناة إصدار هذا المشروع. تُظهر البيانات الوصفية العامة لـ Homebrew في 2026-09-23 أن disabled: true، وdisable_date 2026-09-01، وdisable_reason fails_gatekeeper_check، بينما لا تزال قيمة deprecated هي false؛ وتعرض إعادة التحقق في 2026-10-20 القيم نفسها: لا تزال قيمة disabled هي true، ولا تزال قيمة deprecated هي false، وdisable_date وdisable_reason دون تغيير. ما تقدمه صفحة التثبيت الرسمية هو الأمر المرتبط بـ tap (يكون مسار cask بعد tap هو stablyai/orca/orca)، وتتم الترقيات عبر أمر cask، وتذكر أن cask يتتبع القناة المستقرة.
AppImage أو deb أو rpm — أيّها تختار؟
الصياغة الرسمية هي أن كل إصدار يوفّر صيغ الحزم الثلاث هذه (يتوفر كل من x64 وarm64): وهي تضم التطبيق نفسه، والفرق الوحيد هو كيفية وصول التحديثات إليك، لذا اختر على هذا الأساس — أي أن أساس الاختيار هو كيفية وصول التحديثات إليك، لا اختلافات الميزات. ولمسار Arch استخدم stably-orca-bin أو stably-orca-git، الذي يُبنى من المصدر.
تُظهر الطرفية رسالة command not found الخاصة بـ Orca CLI — أين أصلح ذلك؟
تذكر صفحة استكشاف الأخطاء الرسمية خطوة التسجيل: سجّل CLI ضمن الإعدادات ← عام ← Orca CLI. على macOS يُوضع shim في ~/.local/bin، ثم تتأكد من أن هذا الدليل ضمن PATH في صدفة الأوامر لديك. بعبارة أخرى، لا تحل إعادة التثبيت المشكلة — الناقص هو ذلك الإدخال الواحد في PATH.
يتصل SSH لكن الطرفية البعيدة لا تبدأ — ما الذي ينبغي التحقق منه أولًا؟
تسرد صفحة استكشاف الأخطاء الرسمية عدة شروط: تأكد من أن الجهاز البعيد يتوفر على Node والوصول إلى الشبكة من أجل تثبيت خدمة الترحيل لأول مرة؛ على جهاز Linux بعيد، أضف سلسلة أدوات C/C++ وهي make وg++/clang++ وpython3؛ أعد الاتصال مرة واحدة بعد التثبيت كي يتمكن Orca من إعادة تثبيت وحداته الأصلية. وهناك صفحة أخرى (خادم Linux بلا واجهة رسومية) تضيف المتطلب الخاص بالخادم: صورة خادم بلا بيئة سطح مكتب لا تتضمن أيًا من مكتبات Electron المشتركة، لذا تُثبّت Xvfb وتلك المكتبات معًا.
يبدو عرض إقران الهاتف سليمًا — فلماذا لا يتصل؟
تقسم الصفحة الرسمية الخاصة بالتشغيل بلا واجهة السبب إلى قسمين. يحمل عرض الاقتران نفسه بيانات اعتماد للجهاز ومادة تشفير من طرف إلى طرف، لذا لا ينبغي أن يوجد إلا مع العميل المقصود وليس في سجلات وصول الوكيل؛ أما الاتصال الذي يفشل فغالبًا ما يكون السبب من جهة الشبكة: boundEndpoint هو العنوان الذي تستمع عليه العملية، وadvertisedEndpoint هو العنوان الذي يتصل به العميل، وتذكر الوثائق أنه ما دام DNS أو الجدار الناري أو نشر منافذ Docker أو سياسة Tailscale أو وكيل عكسي لا يوجّه advertised إلى bound، فإن عرضًا يبدو صالحًا تمامًا سيظل غير قادر على الاتصال.
المصادر
الوثائق الرسمية (مؤرشفة محليًا حرفيًا في 2026-09-22): الصفحات الخمس install وtroubleshooting وssh وmobile وandroid-apk موجودة على https://raw.githubusercontent.com/stablyai/orca/HEAD/docs/site/content/docs/<page-name>.mdx؛ والصفحتان headless Linux server وlinux glibc compatibility موجودتان تحت docs/reference/؛ ويقع README في جذر المستودع. ويستخدم جانب Homebrew البيانات الوصفية العامة على https://formulae.brew.sh/api/cask/orca.json؛ وتأتي أسماء الإصدارات والأصول من https://api.github.com/repos/stablyai/orca/releases/latest. تم جلب كل شيء عبر الإنترنت العام، دون أي حالة تسجيل دخول.
اجعل CLI يظهر أولًا
ترتيب استكشاف الأخطاء المقترح: هل orca-ide على PATH ← تسجيل CLI (الإعدادات ← عام ← Orca CLI) → Node وسلسلة الأدوات على المضيف البعيد ← ثم نقطة نهاية النموذج. تم التحقق من الصياغة الرسمية في 2026-10-19.
قراءات ذات صلة
ما هو Orca ADE وأشجار العمل المتوازية
آلية العمل موجودة في تلك الصفحة: ما هو، وما الذي يوفره العمل المتوازي، وما الذي تتخلى عنه مقابله. أما تثبيته وتوصيله فهما موضوع هذه الصفحة.
مفتاح API المخصص في Cursor وBase URL
أين تذهب المفاتيح في Settings → Models، وأي خانة يمكنها تغيير Base URL، ولماذا يتجاوز Tab مفتاحك، وإعداد QCode.
BYOK في GitHub Copilot لـ Claude وGPT
إعداد BYOK لـ VS Code Custom Endpoint وCopilot CLI: صيغ URL، ومتطلبات الخطة، وحد JetBrains.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تعيد هذه الصفحة صياغة وثائق Orca المفتوحة ومحتوى المستودع لدى Stably. لا يوجد انتساب إلى Orca أو Stably، ولا تأييد. يقتصر اسم الأمر وحالة cask وصيغ الحزم وسلوك SSH/الهاتف على الصفحات الرسمية المحفوظة في 2026-10-19؛ والصياغة الرسمية هي المرجع إذا تغيّرت. تظهر إتاحة النماذج والأسعار على /models.