مستندات رسمی · بررسی‌شده در 2026-10-19

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-18

این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT، DeepSeek و Qwen بدون نیاز به کارت ارزی.

#نام فرمان orca-ide#brew همراه با tap#خودبه‌روزرسانی AppImage#جفت‌سازی SSH و تلفن

چند نکته که ابتدا باید بدانید

orca-ide

نام‌های فرمان و بسته

به‌طور رسمی، Orca CLI روی Linux با نام orca-ide نصب می‌شود و جای صفحه‌خوان GNOME را نمی‌گیرد؛ بسته‌های .deb و .rpm همین نام را دارند. بنابراین «آن را نصب کردم و orca هیچ کاری نمی‌کند» عمدتاً نشانه نصب ناموفق نیست.

همراه با tap

فرمان کامل brew

cask این برنامه stablyai/orca/orca است، و فرمان نصب رسمی brew install --cask stablyai/orca/orca است، و به‌روزرسانی‌ها از طریق فرمان cask انجام می‌شوند؛ آن cask فقط کانال stable را دنبال می‌کند، بنابراین نسخه‌های RC از GitHub Releases یا Check for Updates درون‌برنامه می‌آیند. cask ساده orca از 2026-09-01 غیرفعال شده است، با دلیل fails_gatekeeper_check.

مسیر ~/.local/bin

CLI کجا ثبت می‌شود

وقتی ترمینال نمی‌تواند فرمان را پیدا کند، راه‌حل رسمی ثبت CLI در Settings → General → Orca CLI است؛ روی macOS یک shim در ~/.local/bin نصب می‌کند، و آن پوشه باید در PATH شل شما باشد.

همان برنامه

قالب بسته ≠ نسخه

AppImage، .deb و .rpm همان برنامه را نصب می‌کنند؛ به‌طور رسمی، تنها تفاوت در نحوه رسیدن به‌روزرسانی‌ها به شماست: AppImage خودش را درجا به‌روزرسانی می‌کند، در حالی که برای .deb و .rpm، Orca نسخه جدید را گزارش می‌دهد و فرمان نصب را به شما می‌دهد.

برای روشن شدن موضوع: همان برنامه است، اما نام فرمان همیشه orca نیست.

صفحه رسمی install به این موضوع بخش جداگانه‌ای می‌دهد که با نام فرمان شروع می‌شود: متن می‌گوید در Linux، Orca CLI به‌صورت orca-ide نصب می‌شود، نه orca، زیرا صفحه‌خوانی که همراه GNOME ارائه می‌شود (به‌طور پیش‌فرض در Ubuntu و دیگر میزکارهای GNOME وجود دارد) از قبل مالک /usr/bin/orca است و Orca آن را تحت‌الشعاع قرار نمی‌دهد؛ همان بخش نام بسته‌های .deb و .rpm را نیز روشن می‌کند که به همان دلیل orca-ide هستند.

بنابراین در Linux، «نصب شد، و orca هیچ کاری نمی‌کند» معمولاً نصب ناموفق نیست — آن فرمان از ابتدا هرگز orca نامیده نمی‌شد. بازخوانی صفحه install در 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 منتشر شده بود.

مجوز در فایل LICENSE خود مخزن MIT ذکر شده است (فیلد license در API نیز همین را تأیید می‌کند). شمارنده‌هایی که هر دقیقه تغییر می‌کنند، مانند ستاره‌ها و فورک‌ها، از بدنه این صفحه بیرون نگه داشته می‌شوند — این موضوع به جدول مقایسه در صفحه P4 تعلق دارد که هر عدد در آن روز دریافت خودش را همراه دارد. روی گوشی‌ها، iOS از طریق App Store عرضه می‌شود (نام داخلی برنامه در آن لیست orca-ide است)؛ برای Android کانال رسمی، app-release.apk در صفحه انتشارها به‌همراه یک راهنمای کوتاه نصب است.

خط زمانی

2026-09-01

2026-09-01: در فراداده عمومی Homebrew، این مقدار disable_date برای cask مربوط به orca است و disable_reason آن fails_gatekeeper_check است. واکشی 2026-09-23 مقدار disabled: true و deprecated: false را خواند، و بازبینی 2026-10-20 همان دو وضعیت را نشان می‌دهد. بنابراین «با Orca جایگزین شده» نبود — Homebrew آن را غیرفعال کرد.

2026-09-22

2026-09-22: مستندات رسمی‌ای که این صفحه بر آن‌ها تکیه دارد شش صفحه است — install، troubleshooting، ssh، mobile، android-apk و headless Linux server — به‌علاوه README. 2026-10-19: آخرین انتشار رسمی v1.4.230 است؛ فرمان‌ها، مسیرها و نام بسته‌های اینجا از همان مستندات پیروی می‌کنند.

2026-10-19

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 در Settings → General → Orca CLI است و در macOS shim در ~/.local/bin قرار می‌گیرد؛ 7) پیشنهاد جفت‌سازی گوشی یک capability است که شامل اعتبارنامه دستگاه و مواد E2EE می‌شود و باید فقط به کلاینت موردنظر داده شود.

صفحه نصب رسمی همچنین می‌گوید Orca یک اپ دسکتاپ است که بیلدهایش برای هر پلتفرم از GitHub دانلود می‌شوند و بیلد macOS امضا و notarized شده است، بنابراین اجرای نخست ممکن است همچنان از شما تأیید بخواهد.

⚠️ فرض‌های نادرست رایج

یک: «تایپ 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؛ اسنپ‌شات‌ها در Sources). بازبینی در 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 فرمان یک symlink است — مسیر پیش‌فرض برنامه برای آن /usr/local/bin/orca است — و باید به بسته در Orca.app/Contents/Resources/bin/orca منتهی شود؛ launcher مسیر resolve‌شده خود را در .app قطع می‌کند تا آن بسته را پیدا کند، بنابراین لینکی که خارج از یک Orca.app resolve شود همان خط را چاپ می‌کند.

مورد ثبت‌شده در issue #19120 لینکی است که حساب کاربری شما نمی‌تواند بخواند: 1.4.197 آن را با مالکیت root و به‌صورت lrwx------ منتشر کرد، و macOS حالت خود symlink را در readlink() اعمال می‌کند، بنابراین یک هدف درست هم در resolve ناموفق می‌شد. راه‌حل: CLI را دوباره در 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 می‌گوید بیلد امضا و notarized شده است و اجرای نخست ممکن است همچنان از شما تأیید بخواهد، که برای اپ‌های مبتنی بر Electron طبیعی است. ماشین راه‌دور: اگر SSH وصل می‌شود اما هیچ ترمینالی بالا نمی‌آید، مستندات از شما می‌خواهد تأیید کنید که ماشین راه‌دور Node و دسترسی شبکه برای نصب اولیه رله دارد؛ در Linux نیز باید make، g++/clang++ و python3 موجود باشد و سپس یک‌بار دوباره متصل شوید.

ایمیج مینیمال: سروری بدون دسکتاپ به Xvfb و کتابخانه‌های اشتراکی‌ای نیاز دارد که Electron به آن‌ها لینک می‌شود — کمبود از کتابخانه‌هاست، نه خود Orca.

انتخاب مسیر نصب

macOS: دستور رسمی همان دستور همراه با tap است، brew install --cask stablyai/orca/orca، و به‌روزرسانی‌ها از طریق brew upgrade --cask orca انجام می‌شوند؛ آن cask فقط کانال stable را دنبال می‌کند، بنابراین نسخه‌های 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، هزینه به‌ازای هر توکن محاسبه می‌شود و قیمت هر مدل در /models فهرست شده است. می‌خواهید ابتدا چند مدل جدیدتر را در QCode امتحان کنید؟ بسته‌های پرداخت به‌ازای مصرف از $4 شروع می‌شوند و شامل یک سهمیه یک‌باره هستند که ظرف 7 روز مصرف می‌کنید.

پرسش‌های متداول

روی Linux دستور orca را تایپ کرده‌اید — هیچ پاسخی نیست. نصب شکست خورده است؟

معمولاً نصب شده است. صفحه نصب رسمی برای نام دستور بخش جداگانه‌ای دارد: در 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 را که از سورس ساخته می‌شود.

ترمینال می‌گوید Orca CLI «command not found» است — کجا باید آن را برطرف کنم؟

صفحه رسمی عیب‌یابی مرحله ثبت را می‌آورد: CLI را در Settings → General → 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 (Settings → General → Orca CLI) → Node و زنجیره ابزار روی ماشین راه‌دور ← سپس نقطه پایانی مدل. متن رسمی در 2026-10-19 بررسی شده است.

مطالب مرتبط

راهنمای پرداخت با رمزارز

نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.

این صفحه محتوای مستندات باز و مخزن Orca از Stably را بازگو می‌کند. هیچ وابستگی به Orca یا Stably و هیچ تأییدی وجود ندارد. نام دستور، وضعیت cask، قالب‌های بسته و رفتار SSH/گوشی به صفحات رسمی ثبت‌شده در 2026-10-19 محدود است؛ اگر متن رسمی تغییر کند، آن ملاک است. در دسترس بودن مدل‌ها و قیمت‌ها در /models فهرست شده است.

مطمئن نیستید از کجا شروع کنید؟

یک هفته امتحان کنید

بسته کوچک: $4 برای $30 سهمیه، به مدت 7 روز معتبر

هر روز از آن استفاده کنید

Starter: $9.00/ماه با $5 سهمیه در هر روز — فقط $0.060 به‌ازای هر $1 سهمیه، در برابر حدود $0.113 برای بسته متوسط