Skip to main content

Gmail وDrive وCalendar والمزيد

يربط تكامل Google Workspace تطبيق وولفيش بـ Gmail و Google Drive و Calendar و Contacts و Tasks و Sheets. يدعم حسابات Google متعددة ويستخدم OAuth 2.0 للمصادقة.

الإعداد

يقوم التكامل على gogcli، وهي أداة سطر أوامر صغيرة لـ Google Suite يثبّتها وولفيش نيابةً عنك. وأنت تُحضِر عميل OAuth الخاص بك من Google Cloud، وهو ما يُبقي الأمر كلَّه على بيانات اعتمادك أنت.
1

تثبيت gogcli

افتح الإعدادات ← الخدمات ← Google Workspace واضغط تثبيت. ينزّل وولفيش الملف التنفيذي الجاهز لمنصّتك إلى ~/.wolffish/bin/gog — دون مدير حزم ودون كلمة مرور المسؤول. وماك ولينكس وويندوز جميعها مدعومة. ومنذ الإصدار 1.0.263 صار المثبِّت مثبَّتاً على إصدار gogcli المدقَّق بعينه (v0.37.0) بدل جلب الأحدث أيّاً كان، فلا يستطيع سطر الأوامر أن يغيّر صيغته من تحت إصدارٍ منشور — كلُّ أداةٍ متحقَّقٌ منها أمراً أمراً على تلك الثنائية، والنسخة الأقدم المخالفة تلقى خطأً يسمّي العلاج: حدِّث من الإعدادات.
2

إنشاء عميل OAuth

في Google Cloud Console: أنشئ مشروعًا، وفعّل الواجهات التي تريدها من APIs & Services ← Library (Gmail وDrive وCalendar وSheets وTasks وPeople وما تسرده اللوحة سواها)، واضبط شاشة موافقة OAuth على External وأضف نفسك مستخدمًا تجريبيًّا، ثم Credentials ← Create Credentials ← OAuth client ID ← Desktop app. ونزّل ملف client_secret_*.json. وتمشي بك اللوحة في كل خطوة مع تأكيدٍ لكلٍّ منها.
3

إفلات ملف JSON

اسحب الملف المنزَّل إلى منطقة إفلات بيانات الاعتماد. يتحقّق وولفيش منه ويخزّنه، ويعرض القسم المشروعَ والعميل اللذين صار يحملهما.
4

تفويض حساب

اكتب بريد الحساب واضغط تفويض. يفتح متصفّحك شاشة موافقة Google؛ وافق فيحطّ الحساب في قائمة الحسابات. أضف ما شئت من الحسابات، واستخدم إعادة الاتصال لأيّ حساب انتهت صلاحية رمز تحديثه أو أُلغي.
تُحفَظ بيانات الاعتماد والرموز في سلسلة مفاتيح gogcli نفسها، لا في تهيئة وولفيش. ولا يحتفظ config.json إلا ببيانات وصفية عامة آمنة — معرّفا العميل والمشروع، وما إذا كانت بيانات الاعتماد مخزّنة. وحذف بيانات الاعتماد من اللوحة يزيل معها كلَّ حسابٍ مفوَّض.
اترك حالة النشر في شاشة الموافقة على Testing. فلا يستطيع التفويض إلا المستخدمون التجريبيّون، وهو ما يناسب الاستعمال الشخصيّ تمامًا، ويمكنك تفعيل واجهات إضافية لاحقًا دون إعادة أيٍّ من هذا.

دعم الحسابات المتعددة

يمكنك تفويض حسابات Google متعددة. أداة google_accounts تعرض جميع الحسابات المتصلة، وكل أداة Google أخرى تتطلب معامل account صريحًا لتحديد الحساب المراد استخدامه.
ولا يوجد حساب افتراضيّ ضمنيّ: حتى مع حسابٍ واحدٍ مفوَّض، يحمل كلُّ استدعاءٍ account صراحةً. وفي الطلب غير المرتبط بهويّة («هل من بريدٍ غير مقروء؟») يستدعي النموذج الأداةَ مرّةً لكل حساب، بالتوازي.

الأدوات المتاحة

كلّ أداة مسبوقة بـ google_ وتأخذ معامل account إلزاميًّا.

الحسابات

Gmail

Google Drive

Google Calendar

Google Contacts

Google Tasks

Google Sheets

المحفّزات

القدرة ليست في السياق افتراضيًّا — بل تُحمَّل عند الطلب حين يطابق tool_search طلبَك مع المحفّزات المعلنة في SKILL.md الخاصّ بها:
وبمجرّد تحميلها تصبح أدواتها قابلة للاستدعاء في الدور نفسه.

أمثلة على سير العمل

مرجع التهيئة

لا يحمل config.json إلا بياناتٍ وصفيّةً عامّة عن الاتصال — ولا يحمل رمزًا قطّ:
أدِر الحسابات من اللوحة لا يدويًّا. فملفّ عميل OAuth وكلّ رمز تحديثٍ يقيمان في سلسلة مفاتيح gogcli، ولذلك لا يستطيع تعديل config.json أن يضيف حسابًا أو يزيله أو يصلحه — وحذف بيانات الاعتماد يزيلها جميعًا دفعةً واحدة.
إذا بدأت استدعاءات Google بالفشل بأخطاء 401، فافتح الإعدادات ← الخدمات ← Google Workspace واضغط إعادة الاتصال على الحساب المعنيّ — فذلك يعيد تشغيل مسار الموافقة ويأتي برمز تحديثٍ جديد. وهذا ما تريده بعد إلغاء الوصول من إعدادات أمان حسابك في Google.