الانتقال إلى المحتوى الرئيسي

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

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

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

بدون حالة

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

اختياري

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

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

تتبع بنية التكاملات خط معالجة القدرات القياسي: 
Settings panel ──► config.json / Variables ──► Plugin reads token ──► API call ──► Result ──► motor ──► broca ──► User
  1. تهيّئ بيانات الاعتماد في لوحة الإعدادات (أو تعدّل config.json مباشرة)
  2. تُخزّن بيانات الاعتماد في ~/.wolffish/workspace/config.json أو كمتغير
  3. عندما يقرر النموذج اللغوي استخدام أداة تكامل، تقرأ الإضافة الرمز وقت الاستدعاء
  4. تنفّذ الإضافة طلب API وتُرجع ToolResult
  5. تمر النتيجة عبر 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.

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

Google Workspace

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

GitHub

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

Notion

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

Brave Search

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

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

كل تكامل هو قدرة، لكن ليس كل قدرة تكاملًا. الفرق:
القدرةالتكامل
الموقعbrain/cerebellum/brain/cerebellum/
يحتوي SKILL.mdنعمنعم
يحتوي plugin/ربمادائمًا
يحتاج بيانات اعتمادلانعم
يستدعي واجهات برمجية خارجيةلانعم
مثالgit، shellgoogle، github
التكاملات هي قدرات إضافية تتطلب بيانات اعتماد خارجية وتنفّذ طلبات شبكة إلى واجهات برمجية لأطراف ثالثة. القدرات الصرفة مثل git وshell تستخدم فقط موارد النظام المحلية.

​
التفعيل

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