شرح بالفيديو
ما تحتاجه
- وولف فيش مثبت ويعمل
- مفتاح API لنموذج لغة مُهيأ في الإعدادات > النماذج. يُنصح بـ DeepSeek V4 Flash — سريع ورخيص وأكثر من كافٍ لتلخيص البريد الإلكتروني. أي مزود آخر يعمل أيضاً.
- حساب Google — أي Gmail مجاني يعمل. لا حاجة لاشتراك Google Workspace.
الجزء الأول: إنشاء مشروع Google Cloud
تحتاج مشروع Google Cloud مجاني لإنشاء بيانات اعتماد OAuth. هذا إعداد لمرة واحدة يستغرق حوالي 5 دقائق.أنشئ مشروع Google Cloud
اذهب إلى Google Cloud Console وأنشئ مشروعاً جديداً. سمّه أي شيء — “وولف فيش” يعمل.سترى لوحة تحكم المشروع مع اسم مشروعك في الشريط العلوي عندما يكون جاهزاً.
فعّل Gmail API
اذهب إلى APIs & Services > Library في الشريط الجانبي الأيسر. ابحث عن Gmail API وانقر على Enable.أثناء وجودك هنا، فعّل هذه أيضاً ليعمل تكامل Google Workspace الكامل:
- Gmail API
- Google Drive API
- Google Calendar API
- Google Sheets API
- Google Docs API
- Google Slides API
- Tasks API
- People API
هيّئ شاشة موافقة OAuth
اذهب إلى OAuth consent screen في الشريط الجانبي الأيسر.
- اضبط نوع المستخدم على External
- املأ الحقول المطلوبة — اسم التطبيق (أي شيء)، بريدك الإلكتروني لجهة اتصال الدعم
- تخطَّ النطاقات — وولف فيش يطلب ما يحتاجه وقت التفويض
- تحت Test users، أضف عنوان Gmail الخاص بك
- انقر على Save
أنشئ بيانات اعتماد OAuth
اذهب إلى Credentials في الشريط الجانبي الأيسر.
- انقر على Create Credentials > OAuth client ID
- اختر نوع التطبيق: Desktop app
- سمّه أي شيء — “وولف فيش” يعمل
- انقر على Create
الجزء الثاني: ربط وولف فيش بـ Google
ثبّت تكامل Google
افتح وولف فيش. اذهب إلى الإعدادات > الخدمات > Google Workspace.انقر على Install. يُحمّل هذا ملف
gog الثنائي (~50 ميغابايت) الذي يستخدمه وولف فيش داخلياً لجميع استدعاءات Google API. يظهر شريط تقدم أثناء التحميل.ارفع بيانات اعتماد OAuth
في نفس لوحة الإعدادات، ابحث عن قسم OAuth Credentials.اسحب وأفلت ملف
client_secret_*.json الذي حمّلته من Google Cloud Console. يتحقق وولف فيش منه ويعرض معرف المشروع ومعرف العميل.فوّض حساب Gmail الخاص بك
في قسم Accounts، اكتب عنوان Gmail الخاص بك وانقر على Authorize.يفتح متصفحك الافتراضي على شاشة موافقة Google. سجّل الدخول، راجع الأذونات، وانقر على Allow. يُعيد المتصفح التوجيه ويؤكد وولف فيش أن الحساب متصل.تُخزَّن رموز OAuth بأمان في حلقة مفاتيح نظام التشغيل (macOS Keychain أو Windows Credential Manager أو Linux Secret Service) — وليس في أي ملف إعدادات.
يمكنك تفويض عدة حسابات Google. يعمل وولف فيش عبرها جميعاً عندما تطلب شيئاً عاماً مثل “تفقد بريدي” — لا حاجة لتحديد أي حساب في كل مرة.
الجزء الثالث: الأمر
هذا كل ما في الإعداد. عد إلى محادثة وولف فيش وأرسل هذا:كيف يعمل
- يحمّل وولف فيش قدرة Google Workspace ويستدعي
google_accountsلاكتشاف حساباتك المفوَّضة. - لكل حساب، يستدعي
google_gmail_searchبـis:unread in:inbox— استدعاء واحد لكل حساب، بالتوازي — يجلب كل رسالة غير مقروءة. - لكل سلسلة رسائل غير مقروءة، يستدعي
google_gmail_readللحصول على محتوى البريد الكامل. - يقرأ نموذج اللغة كل بريد وينتج الملخص المهيكَل — المرسِل، الملخص، الأولوية.
- يقترح مسودات ردود لأي شيء يحتاج رداً.
المزيد
الأمر أعلاه نقطة بداية. إليك تنويعات يمكنك تجربتها:مسودات ردود تلقائية
مسودات ردود تلقائية
ملخص يومي في ملف
ملخص يومي في ملف
البحث عن سلسلة رسائل وتلخيصها
البحث عن سلسلة رسائل وتلخيصها
ملخص صباحي عبر الخدمات
ملخص صباحي عبر الخدمات
الأتمتة بـ Heartbeat
بمجرد أن تثق في الإخراج، جدوِله ليعمل كل صباح. افتح الإعدادات > Heartbeat لتشغيل محرر Heartbeat المدمج — الصق الكتلة أدناه واحفظ. راجع توثيق Heartbeat لجميع تنسيقات الجدولة.الحدود
- حالة OAuth “Testing” — تبقى شاشة الموافقة في وضع “Testing”، مما يقصر التفويض على مستخدمي الاختبار الذين أضفتهم (أنت). هذا مناسب للاستخدام الشخصي. إذا أردت أن يستخدمها آخرون، ستحتاج لنشر التطبيق عبر عملية التحقق من Google.
- تحديث الرموز — تُحدَّث الرموز تلقائياً. إذا ألغيت الوصول من إعدادات أمان حساب Google، أعد التفويض في إعدادات وولف فيش.
- حدود المعدل — تملك Gmail API من Google حصصاً مجانية سخية (250 وحدة حصة لكل مستخدم في الثانية). الاستخدام الشخصي العادي لن يقترب منها.
- بدون محتوى المرفقات — يمكن لـ وولف فيش رؤية بيانات المرفقات الوصفية (الاسم، النوع، الحجم) لكنه لا يحمّل أو يقرأ محتوى المرفقات افتراضياً. يمكنك طلب تحميل مرفقات معينة عبر Google Drive.