Paseo مع نماذج GetVibe
إعداد Paseo خطوة بخطوة مع GetVibe: ثبّت أدوات CLI، وضع ملف config.json الجاهز، وتجنّب إعادة ربط OAuth، وتحقق من الإنفاق.
إعداد جاهز
يُنشأ من كتالوجنا عند الطلب: عنوان API، وكل نموذج منشور مع حدود السياق والإخراج الخاصة به، والإعدادات الموصى بها. لا يحتوي على أي مفتاح. يمرّر Paseo قيم env إلى الوكلاء كما هي، لذا يحتوي الملف على ثلاثة عناصر نائبة بالصيغة PASTE-YOUR-GETVIBE-API-KEY-HERE — استبدلها بمفتاحك (الخطوات أدناه).
# macOS / Linux
mkdir -p ~/.paseo
curl -fsSL https://getvibeapi.com/api/integrations/paseo.json -o ~/.paseo/config.json# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.paseo" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/paseo.json -OutFile "$HOME\.paseo\config.json"- النموذج الرئيسي —
gpt-6.1-sol: مبرمج وكيلي قوي بسياق كبير وسعر معتدل؛ ويُبقي المعرّف المجرّد على التحويل التلقائي بين القنوات مفعّلًا. - المهام الصغيرة —
deepseek-v4.1-flash: أرخص نموذج قادر بسياق 1M، للعناوين والملخصات ورسائل الالتزام والضغط. - تشغيل البث، ومهلة طلب 600 ثانية، وجهد استدلال medium: الإجابة الاستدلالية الطويلة تستغرق دقائق، وبدون البث تصطدم بحد الانتظار.
- معرّفات النماذج المجرّدة في كل مكان، دون :suffix — فذلك يُبقي التحويل التلقائي عند الفشل إلى قناة سليمة مُفعَّلًا.
?models= مع مُعرّفات مفصولة بفواصل إلى الرابط.Paseo برنامج رسومي لنظامي Windows و macOS. ثبّت التطبيق، ثم اربط المجموعة الجاهزة من موفري GetVibe الثلاثة: Codex و Claude Code و OpenCode. لا يلزم سطر أوامر إلا لتثبيت أدوات CLI الثلاث تلك — لا لتثبيت Paseo نفسه أو تشغيله.
1. نزّل Paseo Desktop وثبّته
افتح صفحة paseo.sh/download الرسمية ونزّل الإصدار المناسب لنظامك:
| المعلمة | النوع | الوصف |
|---|---|---|
Windows | installer | عادةً Intel / x64. شغّل الملف المُنزَّل Paseo-Setup-…-x64.exe واتبع خطوات المثبِّت. |
macOS | DMG | Apple Silicon — لأجهزة Mac المزوَّدة بشريحة M1/M2/M3/M4 أو أحدث؛ Intel — لأجهزة Mac الأقدم. افتح ملف DMG واسحب Paseo إلى Applications. |
شغّل Paseo من قائمة Start في Windows أو من Applications على Mac. عند التشغيل الأول يبدأ التطبيق تشغيل الـ daemon المحلي الخاص به — فلا حاجة إلى تثبيت Paseo بشكل منفصل عبر npm أو كتابة الأمر paseo.
2. ثبّت أدوات CLI للمزوّدين الذين تحتاجهم
يدير Paseo Desktop الوكلاء، لكن يجب تثبيت Codex و Claude Code و OpenCode نفسها على نظامك. ثبّت أولًا إصدار LTS الحالي من Node.js من nodejs.org ثم أعد فتح الطرفية بعد ذلك.
كيفية فتح طرفية
الطرفية نافذة تكتب فيها الأوامر نصيًّا. لفتحها:
| المعلمة | النوع | الوصف |
|---|---|---|
Windows | PowerShell | اضغط Win + X → «Terminal» (أو «Windows PowerShell»). أو: Win + R، واكتب powershell، ثم Enter. |
macOS | Terminal | اضغط Cmd + Space، واكتب Terminal ثم اضغط Enter. |
تُفتح نافذة بمؤشر وامض. الصق الأوامر أدناه واحدًا واحدًا واضغط Enter بعد كل منها. اللصق: بزر الفأرة الأيمن أو Ctrl + V على Windows، وCmd + V على macOS. يستغرق التثبيت 1–3 دقائق؛ أبقِ النافذة مفتوحة أثناء التنفيذ.
ثبّت جميع واجهات CLI الثلاث:
npm install -g @openai/codex @anthropic-ai/claude-code opencode-aiتحقق من توفر الأوامر:
codex --version
claude --version
opencode --version3. اربط ملف config.json الجاهز
نزّل paseo-getvibe-config.json. أعد تسميته إلى config.json وضعه في:
| المعلمة | النوع | الوصف |
|---|---|---|
macOS / Linux | path | ~/.paseo/config.json |
Windows | path | %USERPROFILE%\.paseo\config.json |
يبدأ المجلد .paseo بنقطة، لذا يكون مخفيًا افتراضيًا. إن لم ترَه — فلا تنشئ مجلدًا جديدًا، بل أظهر الملفات المخفية:
| المعلمة | النوع | الوصف |
|---|---|---|
Windows | مستكشف الملفات | الصق %USERPROFILE%\.paseo في شريط عناوين Explorer واضغط Enter — يُفتح المجلد حتى لو كان مخفيًا. |
macOS | Finder | في Finder اضغط Cmd + Shift + G، اكتب ~/.paseo ثم اضغط Enter. لإظهار الملفات المخفية: Cmd + Shift + . (النقطة). |
.paseo موجودًا بعد — شغّل Paseo مرة واحدة ثم أغلقه: فهو ينشئ المجلد بنفسه. وهذا أكثر موثوقية من إنشائه يدويًا.config.json في هذا المجلد هو الطريقة المعتادة لتحميل مزوّدين مخصّصين جاهزين.config.json.txt — امتداد الملف مخفي. في Explorer فعّل «View → Show → File name extensions» وتحقّق من أن الاسم هو بالضبط config.json. هذا هو السبب الأكثر شيوعًا لكون Paseo «لا يرى» الإعداد.agents.providers إلى ملفك الحالي. لا تستبدل إعداداتك ومزوّديك.4. الصق مفتاح API الخاص بك
افتح الملف في محرّر نصوص عادي: على Windows استخدم "Notepad" (انقر بزر الفأرة الأيمن على الملف → "Open with" → "Notepad")، وعلى macOS استخدم "TextEdit" (انقر بزر الفأرة الأيمن → "Open With" → TextEdit). ولا تفتحه في Word أو Pages — فهما يضيفان تنسيقًا ويصبح الملف غير قابل للقراءة.
استبدل المواضع الثلاثة كلها التي يظهر فيها PASTE-YOUR-GETVIBE-API-KEY-HERE بمفتاحك من لوحة تحكم GetVibe واحفظ الملف (Ctrl + S على Windows، وCmd + S على macOS). الصق المفتاح بين علامتي التنصيص واحتفظ بهما. لا تنشر الملف النهائي ولا تضفه إلى Git.
5. أزل تسجيلات الدخول القديمة
قد يعيد Codex استخدام تسجيل دخول محفوظ عبر «Sign in with ChatGPT». وعندها قد يذهب الطلب بصمت مباشرة إلى OpenAI. أما Claude Code مع رمز GetVibe فيختاره قبل الاشتراك المحفوظ، لكن تسجيل الخروج يُسقِط أيضًا أي جلسة قديمة لـ Apps Gateway. شغّل الأمرين مرة واحدة:
codex logout
claude auth logoutgetvibe وعنوانه ومفتاحه. لا تشغّل codex login --with-api-key بمفتاح GetVibe.6. أعد التشغيل وتحقق من كل شيء في Paseo
unknown variant auto_review, expected user or guardian_subagent. الإصلاح الأساسي: شغّل npm install -g @openai/codex@latest في الطرفية، ثم أغلق Paseo Desktop بالكامل وأعد فتحه. وقد لا تكفي Restart daemon وحدها لتحديث تطبيق قيد التشغيل بالفعل.- أعد فتح Paseo Desktop.
- افتح Settings → Host → Overview واضغط Restart daemon.
- افتح Settings → Host → Providers. ينبغي أن تعرض القائمة الآن
Codex (GetVibe)وClaude Code (GetVibe)وOpenCode (GetVibe). - عُد إلى مساحة العمل وأنشئ وكيلاً. في القائمة المنسدلة للوضع/الأذونات أسفل نموذج الوكيل الجديد اختر Default Permissions. إنه اختيار مؤقت آمن للمبتدئ. لا تختر Auto-review. خيار Full Access يمنح الوكيل صلاحية التنفيذ دون مطالبات التأكيد المعتادة، وهو غير مطلوب لهذا الإصلاح.
- أرسل اختبارًا قصيرًا:
Reply with a single word: ready.
config.json بالكامل يدويًا.7. تحقق من الوجهة التي وصل إليها الطلب
- قبل الاختبار، افتح الاستخدام والطلبات في لوحة تحكم GetVibe.
- أرسل اختبارًا واحدًا من Paseo وانتظر الرد.
- حدّث الصفحة: ينبغي أن يظهر صف جديد بالنموذج المختار والرسوم المطبقة.
استكشاف الأخطاء وإصلاحها
«Command not found»
أغلق الطرفية وأعد فتحها. إذا كان أحد أدوات سطر الأوامر فقط مفقودًا، فأعد تشغيل أمر تثبيته من الخطوة 2. لا تحتاج إلى إعادة تثبيت Paseo Desktop.
مراجعة تلقائية: متغيّر غير معروف auto_review
حدِّث Codex باستخدام npm install -g @openai/codex@latest، ثم أغلق Paseo Desktop تمامًا وأعد فتحه. وإلى أن تُصلَح مشكلة التوافق، اختر Default Permissions من القائمة المنسدلة في الوضع أسفل الشاشة. وإذا لم تطبّق جلسة فاشلة بالفعل الوضع الجديد، فأنشئ وكيلًا أو تبويبًا جديدًا واختره قبل الإرسال.
401 أو قيمة بديلة تُركت في الملف
استبدل جميع مواضع العناصر النائبة الثلاثة، وتحقق من الفواصل والعلامات المقتبسة، ثم في Paseo افتح Settings → Host → Overview → Restart daemon.
Codex يردّ لكن لا يظهر أي استهلاك في GetVibe
شغّل codex logout مرة أخرى، وتحقق من codex login status، وأعد تشغيل الخدمة الخلفية عبر Settings واختر Codex (GetVibe) فقط.
Claude يطلب تسجيل الدخول أو يعرض Gateway
شغّل claude auth logout، وتحقق من مفتاحك وأعد تشغيل مزوّد claude-getvibe.
OpenCode: «لم يُعثر على المزوّد: getvibe»
تأكد من أن بيئة المزوّد تحتوي على OPENCODE_CONFIG_CONTENT، وأن الملف حُفظ بصيغة JSON صحيحة، ثم أعد تشغيل الـ daemon من Settings.
Qwen3.8 مفقود أو يبدأ بخطأ قديم
- أعد تنزيل النسخة الحالية من paseo-getvibe-config.json: فالنسخة المحفوظة سابقًا لا تُحدّث نفسها.
- أغلق Paseo Desktop إغلاقًا تامًا. استبدل الملف
config.jsonالقديم في مجلد.paseoبالملف الجديد وألصق مفتاحك في المواضع الثلاثة النائبة مرة أخرى. لا ترسل هذا الملف إلى الدعم. - افتح Paseo، ونفّذ Settings → Host → Overview → Restart daemon، ثم أنشئ وكيلًا جديدًا: فقد يواصل تبويب قديم استخدام النموذج السابق.
- اختر بالضبط OpenCode (GetVibe)، ثم Qwen3.8 Max Preview. لا ينتمي Qwen إلى مزوّد Codex (GetVibe).
إذا تكرر الخطأ، فالتقط صورة للمنطقة التي تحتوي على اسم المزوّد والنموذج ونص الخطأ كاملًا فقط. وغطِّ مفتاحك ومحتويات config.json أو اقتصّهما من الصورة. يمكنك أيضًا نسخ سطر خطأ واحد من نافذة الوكيل — دون رسائل المهام أو المفاتيح أو متغيرات البيئة.