ما هو التكامل

تربط التكاملات وولفيش بالخدمات الخارجية. كل تكامل هو قدرة (مهارة في cerebellum مع إضافة) تضيف أدوات للتفاعل مع واجهة برمجية محددة — Gmail و GitHub و Notion و Brave Search وغيرها.

مبادئ التصميم

بدون حالة

كل تكامل يقرأ بيانات الاعتماد عند الطلب وقت استدعاء الأداة. لا خدمات خلفية، ولا اتصالات دائمة، ولا حلقات استطلاع.

اختياري

يعمل وولفيش بالكامل بدون أي تكاملات مهيّأة. كل تكامل مستقل — فعّل فقط ما تحتاجه.

كيف تعمل التكاملات

تتبع بنية التكاملات خط معالجة القدرات القياسي:

Settings panel ──► config.json / Variables ──► Plugin reads token ──► API call ──► Result ──► motor ──► broca ──► User

تهيّئ بيانات الاعتماد في لوحة الإعدادات (أو تعدّل config.json مباشرة)
تُخزّن بيانات الاعتماد في ~/.wolffish/workspace/config.json أو كمتغير
عندما يقرر النموذج اللغوي استخدام أداة تكامل، تقرأ الإضافة الرمز وقت الاستدعاء
تنفّذ الإضافة طلب API وتُرجع ToolResult
تمر النتيجة عبر motor (محرك التنفيذ) وتعود إلى broca (عارض المخرجات)

بيانات اعتماد التكاملات المُهيّأة في لوحة الإعدادات (Notion، GitHub، Brave، Google OAuth، إلخ) لا تُرسل أبداً إلى النموذج اللغوي — تقرأها الإضافات مباشرة من config.json عند تنفيذ الأداة. النموذج اللغوي يرى فقط نتيجة الأداة.

المتغيرات مختلفة. أي قيمة مُخزّنة في الإعدادات → المتغيرات تُضمّن في موجه النظام كنص عادي في كل دور حتى يستطيع الوكيل الرجوع إليها واستخدامها. إذا خزّنت سراً كمتغير، فسيراه النموذج اللغوي — هذا مقصود، لأنه يحتاج القيمة لاستخدامها في استدعاءات الأدوات. استخدم المتغيرات لبيانات الاعتماد التي يحتاج الوكيل للتعامل معها مباشرة (مثل تمرير مفتاح API كوسيط لأمر shell). استخدم صفحات إعدادات التكاملات لبيانات الاعتماد التي تتولاها الإضافة بنفسها.

تخزين بيانات الاعتماد

تُخزّن رموز التكاملات في config.json تحت أقسام التكاملات الخاصة بها:

// Example: config.json integration section
{
  "integrations": {
    "google": {
      "accounts": [
        {
          "email": "you@gmail.com",
          "accessToken": "ya29.a0...",
          "refreshToken": "1//0e..."
        }
      ]
    }
  }
}

كما هو الحال مع جميع بيانات مساحة العمل، تُخزّن بيانات الاعتماد كنص عادي على جهازك المحلي. وولفيش هو تطبيق شخصي يعمل محليًا أولًا — مساحة العمل ملكك. إذا كنت تستخدم التحكم بالإصدارات لمساحة العمل، أضف config.json إلى .gitignore.

التكاملات المتاحة

إضافة المتصفح

تحكّم في متصفحاتك الحقيقية — عدّة متصفحات في آنٍ واحد، بملفّاتها الشخصية — تصفّح وانقر واقرأ والتقط لقطات الشاشة. 51 أداة داخل جلساتك المسجَّل دخولها.

تطبيق الهاتف

رفيق الهاتف — اقترِن مرّةً برمز QR أو برمزٍ قصير، ثم المحادثة والسجلّ والاستهلاك وكلّ صفحات الإعدادات عبر نفقٍ مشفَّرٍ من طرفٍ إلى طرف.

إشعارات الهاتف

يبلغك الوكيل على هاتفك المقترن حين ينتهي تشغيلٌ أو يخفق أو يحتاج إليك — استدعاء أداةٍ متعمَّد في كل مرة، لا نبضة تلقائية أبدًا.

توليد الفيديو

ولّد فيديو بـ MiniMax H3 — من نصّ أو صور أو إطارات أو وسائط مرجعية — والوصف يكتبه النموذج الذي تحادثه.

Google Workspace

Gmail و Drive و Calendar و Contacts و Tasks و Sheets. دعم OAuth لحسابات متعددة.

GitHub

المستودعات، المشكلات، طلبات السحب، سير العمل، الإصدارات، والمقتطفات عبر رمز وصول شخصي.

Notion

الصفحات وقواعد البيانات وقواعد المعرفة. بحث وقراءة وإنشاء واستعلام في مساحة عمل Notion.

Brave Search

بحث الويب عبر Brave Search API. تُعاد النتائج كبيانات منظّمة ليلخّصها النموذج اللغوي.

خوادم MCP

اربط أيّ خادم يعمل ببروتوكول سياق النماذج — أمرًا محليًا أو رابطًا بعيدًا — فتصبح أدواته أدوات وولفيش من رسالتك التالية.

خوادم MCP هي التكامل المفتوح. التكاملات أعلاه مدمجة ومضبوطة يدويًا؛ أما اتصالات MCP فتجلب منظومة خوادم الأدوات الخارجية بأكملها. وخلافًا للتكاملات عديمة الحالة، اتصال MCP رابط حيّ مُدار — يحافظ وولفيش على سلامته في الخلفية (إعادة اتصال صامتة، فحوص صحة، تجديد رموز OAuth). انظر خوادم MCP.

التكامل مقابل القدرة

كل تكامل هو قدرة، لكن ليس كل قدرة تكاملًا. الفرق:

	القدرة	التكامل
الموقع	`brain/cerebellum/`	`brain/cerebellum/`
يحتوي SKILL.md	نعم	نعم
يحتوي plugin/	ربما	دائمًا
يحتاج بيانات اعتماد	لا	نعم
يستدعي واجهات برمجية خارجية	لا	نعم
مثال	`git`، `shell`	`google`، `github`

التكاملات هي قدرات إضافية تتطلب بيانات اعتماد خارجية وتنفّذ طلبات شبكة إلى واجهات برمجية لأطراف ثالثة. القدرات الصرفة مثل git وshell تستخدم فقط موارد النظام المحلية.

التفعيل

التكاملات قدرات قابلة للاكتشاف. مخططات أدواتها لا تُرسل مع كل طلب — كل تكامل يكلّف سطراً واحداً في فهرس القدرات داخل موجه النظام (الاسم، وصف قصير، عدد الأدوات). عندما تستدعي مهمةٌ ما أحدها، يُفعّله النموذج عبر tool_search (أو باستدعاء إحدى أدواته مباشرة، وهو ما يفعّل القدرة تلقائياً) فتصبح أدواته قابلة للاستدعاء في الدور نفسه. مثلًا، قول “تحقق من بريدي الإلكتروني” يقود النموذج إلى تفعيل قدرة Google واستدعاء الأداة المناسبة (gmail_search أو gmail_read وغيرها) بناءً على قصدك. التفعيل محصور بنطاق المحادثة، لذا فإن مهمة خلفية تُحمّل GitHub لا تمسّ محادثتك الحية أبداً.

تستخدم تكاملاً ما باستمرار؟ أضفه إلى pinnedCapabilities في config.json لتُرسل أدواته مع كل طلب إلى جانب المجموعة الأساسية المدمجة.

التفعيل يجعل أدوات التكامل قابلة للاستدعاء، لكن الإضافة تظل تقرأ بيانات اعتمادها وقت الاستدعاء — الرمز المفقود يظهر كخطأ في الأداة، لا كأداة مفقودة. إذا فشلت الاستدعاءات، تحقق من بيانات الاعتماد في الإعدادات أولاً.

ابدأ هنا

المفاهيم الأساسية

القدرات

القنوات

النماذج

التكاملات

الذاكرة والتعلم

التكوين

التشخيص

توسيع وولفيش

التطوير

نظرة عامة على التكاملات

ما هو التكامل

مبادئ التصميم

بدون حالة

اختياري

كيف تعمل التكاملات

تخزين بيانات الاعتماد

التكاملات المتاحة

إضافة المتصفح

تطبيق الهاتف

إشعارات الهاتف

توليد الفيديو

Google Workspace

GitHub

Notion

Brave Search

خوادم MCP

التكامل مقابل القدرة

التفعيل

​ما هو التكامل

​مبادئ التصميم

بدون حالة

اختياري

​كيف تعمل التكاملات

​تخزين بيانات الاعتماد

​التكاملات المتاحة

إضافة المتصفح

تطبيق الهاتف

إشعارات الهاتف

توليد الفيديو

Google Workspace

GitHub

Notion

Brave Search

خوادم MCP

​التكامل مقابل القدرة

​التفعيل

ما هو التكامل

مبادئ التصميم

كيف تعمل التكاملات

تخزين بيانات الاعتماد

التكاملات المتاحة

التكامل مقابل القدرة

التفعيل