تثبيت goose وتهيئة Provider مخصص

goose هو مساعد ذكاء اصطناعي عام يعمل على جهازك. وإلى جانب البرمجة، يمكنه إجراء عمليات البحث والكتابة والأتمتة وتنظيم البيانات. يمكنك استخدامه عبر إصدار سطح المكتب أو الطرفية أو الواجهة البرمجية، ويشترك إصدار سطح المكتب وإصدار الطرفية في تهيئة النماذج نفسها. وهو مناسب لمعالجة أعمال البرمجة المتكررة، كما يمكنه الاتصال بـ GitHub وقواعد البيانات والملفات.

التحضير قبل التثبيت

goose متاح بطريقتين للتثبيت: Desktop وCLI. إصدار Desktop هو تطبيق سطح مكتب مزود بنافذة، بينما CLI هو إصدار يُستخدم بإدخال الأوامر في الطرفية. يشترك الإصداران في التهيئة الأساسية، بما فيها Provider والنماذج. ويمكن فهم Provider على أنه إعداد اتصال «يخبر goose بخدمة النماذج التي يجب استخدامها».

إذا أردت نافذة

goose Desktop

• نزّل zip على macOS
• أو استخدم brew cask
• استخدم حزمة التثبيت على Linux

إذا أردت الطرفية فقط

goose CLI

• download_cli.sh
• أو Homebrew CLI
• ثم goose session

Windows

اختر البيئة أولًا

• Git Bash أو MSYS2
• يمكن أيضًا استخدام PowerShell
• أضف الأمر إلى PATH إذا تعذّر العثور عليه

قبل البدء، جهّز معرّف النموذج الموجود في قائمة النماذج الحالية. معرّف النموذج هو الاسم الذي تستخدمه خدمة النماذج للتعرّف على نموذج محدد، ويجب نسخه كاملًا عند الاستخدام.

التثبيت والتشغيل لأول مرة

عند الرغبة في استخدام نافذة

يوفر macOS مسارين للتثبيت:

• التنزيل من صفحة التثبيت. تتضمن الصفحة خياري macOS Silicon وmacOS Intel. بعد التنزيل، فك ضغط ملف zip وشغّل البرنامج الموجود داخله.
• أو استخدام Homebrew:

brew install --cask block-goose

يؤدي ذلك إلى تنزيل التطبيق نفسه، ويمكنه أيضًا معالجة التحديثات.

إذا كنت تستخدم Apple Mac M3 ولم تظهر أي نافذة بعد فتح التطبيق، فتحقق من أن ~/.config قابل للقراءة والكتابة. يحتاج goose إلى هذا الدليل لكتابة السجلات.

نزّل إصدار سطح المكتب لنظام Linux من صفحة التثبيت. تتوفر حزم DEB ‏(Ubuntu/Debian) وRPM ‏(RHEL/Fedora) وFlatpak. على Debian أو Ubuntu، اتبع الخطوات الآتية: نزّل حزمة DEB، وانتقل إلى الدليل الذي حُفظت فيه، ثم نفّذ sudo dpkg -i (filename).deb، وبعد ذلك افتح goose من قائمة التطبيقات. استبدل (filename) باسم الملف الفعلي.

نزّل إصدار سطح المكتب لنظام Windows من صفحة التثبيت، ثم فك ضغط ملف zip وشغّل البرنامج الموجود داخله.

عند الاكتفاء بالطرفية

على macOS وLinux، نفّذ:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

إذا لم ترغب في إجراء تهيئة تفاعلية أثناء التثبيت، فأضف CONFIGURE=false في البداية:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

يمكنك أيضًا تنفيذ الأمر الآتي على macOS:

brew install block-goose-cli

لتحديث CLI المثبّت، استخدم:

goose update

على Windows، يجب استخدام واحدة من البيئات الثلاث الآتية: Git Bash، المتوفر مع Git for Windows والمحدد بوصفه الخيار الموصى به، أو MSYS2، أو PowerShell المدمج في Windows 10/11. في Git Bash وMSYS2، استخدم أمر download_cli.sh نفسه الوارد أعلاه. أما في PowerShell، فنزّل البرنامج النصي أولًا ثم شغّله:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

إذا ظهرت رسالة تفيد بأن goose غير موجود في PATH، فأضف ~/.local/bin أو %USERPROFILE%\.local\bin إلى تهيئة shell الحالية وفقًا لصفحة التثبيت، ثم أعد فتح الطرفية. PATH هو مجموعة من الأدلة التي تبحث فيها الطرفية عن البرامج. إذا لم يُضف دليل البرنامج إليها، فقد يتعذر تشغيل البرنامج بكتابة اسمه مباشرة حتى لو كان مثبّتًا.

كان إصدار CLI بتاريخ 2026-10-09 هو 1.54.0. يضع برنامج التثبيت الملف التنفيذي افتراضيًا في ~/.local/bin. ويمكن استخدام متغير البيئة GOOSE_BIN_DIR لتغيير هذا الدليل. بعد تغييره، لن يكتب البرنامج النصي تلقائيًا في تهيئة shell، وستعرض الطرفية رسالة تفيد بأن الدليل غير موجود في PATH. أضف ذلك الدليل إلى PATH أو شغّل البرنامج باستخدام مساره الكامل.

عند الاستخدام لأول مرة، سيطلب منك goose تهيئة Provider. يمكنك تخطي المزوّدين المدمجين أولًا، ثم إضافة Provider مخصص باتباع القسم التالي. في الطرفية، انتقل إلى الدليل الذي تريد العمل فيه وشغّل:

goose session

الحصول على معلمات الاتصال من OmniProxy

جهّز العنوان والمفتاح واسم النموذج من OmniProxy الخاص بك. يضع المثال الخاص بـ Provider المخصص قيمة base_url عند /v1/chat/completions، ولذلك يُستخدم التنسيق نفسه هنا:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   انسخ المعرّفات الكاملة من قائمة نماذج OmniProxy الحالية، وافصل بين عدة معرّفات بفواصل إنجليزية

انسخ اسم النموذج كاملًا من قائمة OmniProxy الحالية، مع الاحتفاظ بالشرطات المائلة. معرّفا المقارنة الواردان في مستندات المزوّدين بتاريخ 2026-10-09 هما grok-4.7 من Grok وgpt-6-luna الوارد في مستندات OpenAI. يدعم gpt-6-luna واجهة Chat Completions، ولا يدعم استدعاء الدوال فيها إلا عندما تكون قيمة reasoning_effort هي none. لا تنسخ أسماء غير موجودة في القائمة.

إدخال تهيئة الأداة

يستخدم Provider المخصص تنسيقًا متوافقًا مع OpenAI أو Anthropic أو Ollama. ويعني التنسيق المتوافق أن الأداة ترسل الطلبات وفق واجهة عامة معينة. عند الاتصال بـ OmniProxy، اختر OpenAI Compatible.

إصدار سطح المكتب

1. انقر على الزر الموجود في الزاوية العلوية اليسرى لفتح الشريط الجانبي.
2. انقر على Settings.
3. انقر على Models.
4. انقر على Configure providers.
5. انقر على Add Custom Provider أسفل النافذة.
6. اختر OpenAI Compatible في Provider Type. يمكنك إدخال OmniProxy في Display Name. أدخل عنوان القسم السابق في API URL. عند الحاجة إلى مفتاح، فعّل خيار طلب API Key وأدخل مفتاح OmniProxy. أدخل أسماء النماذج في Available Models، وافصل بين عدة أسماء بفواصل إنجليزية.
7. انقر على Create Provider.

لا يمكن حاليًا تعريف ترويسات طلب مخصصة في هذه النافذة ضمن إصدار سطح المكتب. إذا كنت تحتاج إلى ترويسات، فعدّل ملف التهيئة بعد إنشاء Provider.

الطرفية

شغّل:

goose configure

اختر Custom Providers، ثم Add A Custom Provider. اختر OpenAI Compatible في API Type، ثم اتبع التعليمات لإدخال الاسم وAPI URL وما إذا كان المفتاح مطلوبًا وأسماء النماذج وما إذا كانت الاستجابات المتدفقة مدعومة.

عند إجراء التهيئة يدويًا على Windows، إذا ظهر خطأ متعلق بمخزن المفاتيح، فاختر عدم الحفظ عندما يُطلب منك تحديد ما إذا كنت تريد الحفظ في keyring، واستخدم متغير بيئة بدلًا من ذلك. ثم شغّل goose configure مجددًا. مخزن المفاتيح هو مساحة تخزين آمنة صغيرة يستخدمها النظام لحفظ المفاتيح.

ملف التهيئة

الأدلة المحددة هي:

• macOS وLinux: ~/.config/goose/custom_providers/
• Windows: %APPDATA%\Block\goose\config\custom_providers\

يمكن إنشاء الملف بالاستناد إلى المثال التالي. استبدل الاسم والعنوان والنماذج بقيمك، وضع المفتاح في متغير البيئة المحدد بواسطة api_key_env. لا تكتب المفتاح الحقيقي داخل الملف:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

احتفظ برقم في context_limit كما في المثال. يعتمد طول السياق الفعلي على النموذج وOmniProxy؛ لا تعتبر الرقم الوارد في المثال حدًا رسميًا لذلك النموذج. قبل الاستخدام، نفّذ:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

بعد الدخول إلى دليل العمل، نفّذ:

goose session --provider omniproxy --model grok-4.7

استبدل قيمة --model بالمعرّف الكامل الموجود في القائمة. لا يحتوي goose session على أمر فرعي باسم start. ويمكن أيضًا تعيين --provider و--model عبر متغيري البيئة GOOSE_PROVIDER وGOOSE_MODEL. إذا كانت البوابة لا تتحقق من المفتاح، فلا يزال يجب أن تكون لـ OMNIPROXY_API_KEY قيمة، ويمكن أن تكون سلسلة أحرف نائبة لا تُستخدم إلا محليًا. في الاختبار بتاريخ 2026-10-09، تمكن بهذه الطريقة من قراءة الملف.

النافذة

Settings

• Settings في الشريط الجانبي
• صفحة Models
• Add Custom Provider

الطرفية

goose configure

• اختر Custom Providers
• ثم اختر الإضافة
• حدّد OpenAI Compatible كنوع

الملف

custom_providers

• يوجد في ~/.config على macOS وLinux
• يوجد في APPDATA على Windows
• اضبط base_url وفق المثال الرسمي

التحقق باستخدام مهمة فعلية

انتقل إلى دليل يحتوي على ملف عادي، ثم شغّل goose session الوارد في القسم السابق. اطلب منه قراءة السطر الأول من ملف تحدده. يجب أن يعرض محتوى الملف، لا أن يكتفي بإظهار أن التهيئة قد حُفظت.

لقراءة الملفات أو تنفيذ الأوامر، تحتاج الجلسة إلى امتداد Developer. ويمكن فهم امتداد Developer على أنه وحدة أدوات تتيح لـ goose التعامل مع الملفات والأوامر المحلية. تتضمنه التهيئة الافتراضية عادةً. إذا أجاب بأنه لا يملك أدوات للتعامل مع الملفات، فأضف إلى الأمر:

--with-builtin developer

لا تضف --no-profile في الوقت نفسه، لأن هذا الخيار يعطّل الامتدادات الافتراضية.

بتاريخ 2026-10-09، تمكن goose 1.54.0 من قراءة السطر الأول من الملف المحدد. قد تستغرق الاستجابة الأولى نحو دقيقة.

بعد ذلك، تحقق من المصدر واسم النموذج في سجل الاستدعاءات داخل OmniProxy.

التشغيل

يمكن بدء جلسة

• goose session
• Provider هو الذي أُضيف للتو
• اسم النموذج موجود في القائمة

المهمة

نفّذ المهمة فعلًا

• مثلًا، اعرض محتويات المجلد الحالي
• راجع رده
• لا تكتفِ برسالة نجاح الحفظ

السجل

يظهر في البوابة

• استخدم العنوان الوارد في مثال الوثائق
• لا تكتب المفتاح في المستودع
• معرّف النموذج مطابق للقائمة

الأخطاء الشائعة

• تعذر العثور على الأمر goose: أضف دليل التثبيت إلى PATH وفقًا لصفحة التثبيت، ثم أعد فتح الطرفية.
• لا تظهر نافذة إصدار سطح المكتب على M3: تحقق من صلاحيات القراءة والكتابة للدليل ~/.config.
• فشل مخزن المفاتيح: لا تحفظ المفتاح في keyring، واستخدم متغير بيئة بدلًا من ذلك.
• النموذج غير موجود في القائمة: في إصدار سطح المكتب، يمكنك اختيار Use custom model وإدخال اسم النموذج يدويًا. لا يسمح goose configure بإدخال اسم نموذج مخصص؛ عند استخدام الطرفية، انتقل إلى إصدار سطح المكتب أو عدّل GOOSE_MODEL مباشرةً في التهيئة.
• تعذر الاتصال بالعنوان: تأكد من أن API URL ينتهي بـ /v1/chat/completions كما في المثال، ومن أن OmniProxy قيد التشغيل.
• تظهر رسالة تفيد بتعذر قراءة الملفات: أضف امتداد Developer ولا تستخدم --no-profile.
• ظهور unsupported Responses role: system: يكون العنوان صحيحًا عادةً. استخدم معرّفًا كاملًا آخر من قائمة النماذج.

المراجع الرسمية

راجع Install goose لمعرفة خطوات التثبيت. ولمعرفة كيفية إعداد Provider مخصص، راجع goose providers. أما معرّفات النماذج المستخدمة في الأمثلة، فتوجد في صفحة نماذج xAI وGPT-6 Luna.

استبدل كل عنصر نائب بقيم إعداد OmniProxy الخاصة بك. لا تنشر مفتاحاً حقيقياً أبداً.

لا يثبت الحفظ الناجح أو HTTP 200 وحده توافق Agent الكامل. تحقق من المصدر والنموذج في سجل استدعاءات OmniProxy.

المصادر الرسمية · goose ↗