إعداد Devin Desktop (المعروف سابقًا بـ Windsurf)

أصبح Windsurf الآن Devin Desktop ويقوم على ACP: أرفق Claude Code كوكيل ACP مع توجيه بيئته إلى QCode

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-09-18 · 📄 وفق الوثائق الرسمية (Devin Desktop 3.10.31 (صدر في 2026-09-16))

نظرة سريعة¶

⚠️ أُعيد تسمية Windsurf. في 2026-06-02 أعادت Cognition تسمية Windsurf إلى Devin Desktop وأطلقته كتحديث عن بُعد. ما وعد به المزوّد بندًا بندًا هو الخطط والأسعار والإعدادات والإضافات؛ أما اختصارات لوحة المفاتيح واتصالات MCP فغير مضمونة كلًّا على حدة، ولم نتحقق منها واحدًا واحدًا. أُزيل وكيل Cascade الأصلي: قالت الأسئلة الشائعة آنذاك إنه «يظل متاحًا حتى يوليو»، لكن الإزالة وقعت فعليًا في سجل تغييرات v3.9.19 (8 سبتمبر 2026) — «تمت إزالة Cascade» — ما يجعل Devin Local الوكيل الوحيد المضمّن في Devin Desktop.

Devin Desktop مبني الآن حول ACP (Agent Client Protocol): يعمل كمضيف، وتُرفق أي وكيل يتحدث ACP — Claude Code وCodex CLI وOpenCode وغيرها. تشمل القدرات الجديدة مركز أوامر بأسلوب Kanban، وSpaces لتجميع المهام، ووكيلًا محليًا Devin Local (يصفه المزوّد بأنه يشارك بنية Devin CLI) وCodemaps.

الطريقة الصحيحة لاستخدام QCode: ACP هو المسار الوحيد¶

لا يوفّر Devin Desktop أي حقل BYOK يمكنك فيه كتابة Base URL عشوائي: البحث في فهرس الوثائق الرسمي عن BYOK / إحضار مفتاحك الخاص / نقطة النهاية المخصصة / Base URL / تجاوز النموذج لا يعيد شيئًا، وقائمة النماذج كتالوج ثابت مرتبط بخطتك. لاستخدام مفتاح QCode والحصة الخاصة بك، عليك إرفاق وكيلك الخاص عبر ACP:

🔑 يشغّل Devin Desktop وكلاء ACP كـعمليات فرعية عند الطلب ويتواصل معها عبر JSON-RPC على stdio (بالصياغة الرسمية). الطريقتان الموثقتان لتزويد الوكيل بمتغيرات البيئة هما زر «...» في علامة تبويب Agents ضمن إعدادات مستخدم Devin، وإعداد devin.acp.agentEnv.<agentName> في settings.json. أما ما إذا كان الوكيل يرث بيئة shell الخاصة بك أيضًا، فذلك غير موعود به حرفيًا من المزوّد — صحيح عادةً، لكنه غير مضمون، ولهذا تضع الخطوة 1 الإعداد في ملف الوكيل نفسه.

الخطوة 1: توجيه Claude Code إلى QCode¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_qcode_key"

من البر الرئيسي للصين، استخدم https://asia.qcode.cc/api.

أكثر موثوقية: ضع هذه المتغيرات في كتلة env داخل ~/.claude/settings.json بدلًا من ملف تعريف الصدفة — فتطبيق واجهة رسومية يُشغَّل من أيقونة لا يقرأ ~/.zshrc، وهذا هو سبب الفشل الأكثر شيوعًا. راجع نظرة عامة على ACP ومتغيرات البيئة.

تأكد أولًا من أن CLI يعمل من الطرفية:

claude -p "reply with exactly: OK"

الخطوة 2: إرفاق الوكيل داخل Devin Desktop¶

الوكيل المدمج الوحيد هو Devin Local. تسرد الوثائق الرسمية Codex CLI وClaude Agent وOpenCode وJunie وGemini CLI بوصفها وكلاء نموذجية على سبيل المثال — أي وكلاء ACP من جهات خارجية يمكنك إرفاقهم، ويلزمك تثبيت ملفاتهم التنفيذية بنفسك (تذكر الوثائق أن Devin Desktop لا ينزّل توزيعات الوكلاء من السجل، لأسباب أمنية). منذ الإصدار v3.10.23 (2026-09-10) أصبح ACP مفعّلًا دائمًا، ولم يعد خيار Enable ACP القديم موجودًا. طريقة الإرفاق:

• لوحة الأوامر (Cmd/Ctrl + Shift + P) → Devin User Settings → تبويب Agents → فعّل وكلاء ACP الذين تريدهم

• أو حرّر السجل المحلي: ~/.windsurf/acp/registry.json على macOS / Linux (~/.windsurf-next/acp/registry.json في Devin Desktop Next)، و %USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json على Windows

• يفتح الأمر Open Local ACP Registry Config في لوحة الأوامر ذلك الملف مباشرة؛ وبعد التحرير نفّذ Reload ACP Connections — دون حاجة إلى إعادة تشغيل كاملة

المفاتيح والحدود: وثائق ACP الرسمية لـ Devin.

⚠️ تحذير رسمي: ما دامت مساحة عمل مفتوحة في Restricted Mode، فإن كل وكيل — سواء Devin Local أو وكلاء ACP — غير متاح، ولا تُحمَّل الخطافات ولا تعمل. تحقق من ذلك أولًا عندما لا يظهر أي وكيل على الإطلاق.

بعد الإرفاق، افتح جلسة في Devin Desktop. ردّ طبيعي يعني أنه يستهلك حصتك من QCode.

تحقق من أن الحركة تذهب فعلًا إلى QCode¶

افتح probe.qcode.cc وأدخل مفتاح API الخاص بك. ينبغي أن تظهر الجلسة التي شغّلتها للتو في قائمة الطلبات (مع النموذج وعدد tokens وطول السياق). إذا لم تظهر، فالوكيل لم يرث بيئتك — عُد إلى الخطوة 1 واستخدم صيغة ~/.claude/settings.json.

استكشاف الأخطاء وإصلاحها¶

ذو صلة¶

• نظرة عامة على ACP — الإعداد نفسه يغطي أيضًا Zed وJetBrains
• متغيرات البيئة
• نقاط النهاية ومسارات API

المؤسسات ←