> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.

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

> ربط وولف فيش بالخدمات الخارجية — Google و GitHub و Notion وغيرها

# ما هو التكامل

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

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

<CardGroup cols={2}>
  <Card title="بدون حالة" icon="plug">
    كل تكامل يقرأ بيانات الاعتماد عند الطلب وقت استدعاء الأداة. لا خدمات خلفية، ولا اتصالات دائمة، ولا حلقات استطلاع.
  </Card>

  <Card title="اختياري" icon="toggle-off">
    يعمل وولف فيش بالكامل بدون أي تكاملات مهيّأة. كل تكامل مستقل — فعّل فقط ما تحتاجه.
  </Card>
</CardGroup>

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

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

```
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` (عارض المخرجات)

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

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

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

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

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

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

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

<CardGroup cols={2}>
  <Card title="Google Workspace" icon="google" href="/ar/integrations/google-workspace">
    Gmail و Drive و Calendar و Contacts و Tasks و Sheets. دعم OAuth لحسابات متعددة.
  </Card>

  <Card title="GitHub" icon="github" href="/ar/integrations/github">
    المستودعات، المشكلات، طلبات السحب، سير العمل، الإصدارات، والمقتطفات عبر رمز وصول شخصي.
  </Card>

  <Card title="Notion" icon="book" href="/ar/integrations/notion">
    الصفحات وقواعد البيانات وقواعد المعرفة. بحث وقراءة وإنشاء واستعلام في مساحة عمل Notion.
  </Card>

  <Card title="Brave Search" icon="magnifying-glass" href="/ar/capabilities/built-in-capabilities">
    بحث الويب عبر Brave Search API. تُعاد النتائج كبيانات منظّمة ليلخّصها النموذج اللغوي.
  </Card>
</CardGroup>

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

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

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

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

## التفعيل

يتم اختيار التكاملات بواسطة `ras` (فلتر الانتباه) تمامًا مثل أي قدرة أخرى. عندما تتطابق رسالتك مع محفّزات تكامل ما، تُضمّن أدواته في سياق النموذج اللغوي.

مثلًا، قول "تحقق من بريدي الإلكتروني" يُفعّل قدرة Google لأن "بريد" في قائمة محفّزاتها. ثم يقرر النموذج اللغوي أي أداة محددة يستدعيها (`gmail_search` أو `gmail_read` وغيرها) بناءً على قصدك.

<Tip>
  إذا لم تظهر أدوات التكامل، تأكد من تهيئة بيانات الاعتماد. القدرات التي تفتقر لبيانات اعتماد يتم تخفيض أولويتها بواسطة `ras` لأن أدواتها ستفشل على أي حال.
</Tip>