الانتقال إلى المحتوى الرئيسي
صندوق الوارد وظيفة بدوام كامل لم تتقدم لها. يتصل وولف فيش بـ Gmail عبر OAuth من Google، يقرأ رسائلك غير المقروءة، يلخّص ما يهم، ويمكنه الرد والأرشفة والتصنيف والمسودة نيابة عنك. بدون أتمتة متصفح. بدون كشط شاشة. وصول مباشر عبر API إلى صندوق بريدك. أمر واحد. كل صباح. صندوق وارد فارغ.

شرح بالفيديو

ما تحتاجه

  • وولف فيش مثبت ويعمل
  • مفتاح API لنموذج لغة مُهيأ في الإعدادات > النماذج. يُنصح بـ DeepSeek V4 Flash — سريع ورخيص وأكثر من كافٍ لتلخيص البريد الإلكتروني. أي مزود آخر يعمل أيضاً.
  • حساب Google — أي Gmail مجاني يعمل. لا حاجة لاشتراك Google Workspace.

الجزء الأول: إنشاء مشروع Google Cloud

تحتاج مشروع Google Cloud مجاني لإنشاء بيانات اعتماد OAuth. هذا إعداد لمرة واحدة يستغرق حوالي 5 دقائق.
1

أنشئ مشروع Google Cloud

اذهب إلى Google Cloud Console وأنشئ مشروعاً جديداً. سمّه أي شيء — “وولف فيش” يعمل.سترى لوحة تحكم المشروع مع اسم مشروعك في الشريط العلوي عندما يكون جاهزاً.
2

فعّل 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
كل API مُفعَّل يظهر في لوحة Enabled APIs & services. يمكنك دائماً العودة وتفعيل المزيد لاحقاً.
3

هيّئ شاشة موافقة OAuth

اذهب إلى OAuth consent screen في الشريط الجانبي الأيسر.
  • اضبط نوع المستخدم على External
  • املأ الحقول المطلوبة — اسم التطبيق (أي شيء)، بريدك الإلكتروني لجهة اتصال الدعم
  • تخطَّ النطاقات — وولف فيش يطلب ما يحتاجه وقت التفويض
  • تحت Test users، أضف عنوان Gmail الخاص بك
  • انقر على Save
سترى ملخص شاشة الموافقة بحالة Testing. اتركها في Testing — فقط مستخدمو الاختبار (أنت) يمكنهم التفويض، وهذا بالضبط ما تريده للاستخدام الشخصي.
4

أنشئ بيانات اعتماد OAuth

اذهب إلى Credentials في الشريط الجانبي الأيسر.
  • انقر على Create Credentials > OAuth client ID
  • اختر نوع التطبيق: Desktop app
  • سمّه أي شيء — “وولف فيش” يعمل
  • انقر على Create
يظهر العميل الجديد في قائمة OAuth 2.0 Client IDs.
5

حمّل ملف JSON

انقر على أيقونة التحميل (سهم لأسفل) بجانب عميلك الجديد للحصول على ملف JSON.يُحمَّل ملف يبدأ بـ client_secret_. هذا ملف بيانات اعتماد OAuth — احتفظ به بأمان. ستضعه في وولف فيش بعد قليل.
هذا الإعداد بالكامل مجاني. تمنح Google Cloud كل حساب طبقة مجانية سخية تغطي الاستخدام الشخصي لـ API بهامش كبير. لن تُحاسَب.

الجزء الثاني: ربط وولف فيش بـ Google

1

ثبّت تكامل Google

افتح وولف فيش. اذهب إلى الإعدادات > الخدمات > Google Workspace.انقر على Install. يُحمّل هذا ملف gog الثنائي (~50 ميغابايت) الذي يستخدمه وولف فيش داخلياً لجميع استدعاءات Google API. يظهر شريط تقدم أثناء التحميل.
2

ارفع بيانات اعتماد OAuth

في نفس لوحة الإعدادات، ابحث عن قسم OAuth Credentials.اسحب وأفلت ملف client_secret_*.json الذي حمّلته من Google Cloud Console. يتحقق وولف فيش منه ويعرض معرف المشروع ومعرف العميل.
3

فوّض حساب Gmail الخاص بك

في قسم Accounts، اكتب عنوان Gmail الخاص بك وانقر على Authorize.يفتح متصفحك الافتراضي على شاشة موافقة Google. سجّل الدخول، راجع الأذونات، وانقر على Allow. يُعيد المتصفح التوجيه ويؤكد وولف فيش أن الحساب متصل.تُخزَّن رموز OAuth بأمان في حلقة مفاتيح نظام التشغيل (macOS Keychain أو Windows Credential Manager أو Linux Secret Service) — وليس في أي ملف إعدادات.
يمكنك تفويض عدة حسابات Google. يعمل وولف فيش عبرها جميعاً عندما تطلب شيئاً عاماً مثل “تفقد بريدي” — لا حاجة لتحديد أي حساب في كل مرة.

الجزء الثالث: الأمر

هذا كل ما في الإعداد. عد إلى محادثة وولف فيش وأرسل هذا:
Check all my email accounts for unread messages in the inbox.

RULES — READ CAREFULLY:
- Fetch EVERY single unread email, however many there are.
  No caps, no pagination limits, no early stops.
- You MUST call google_gmail_read for EACH email individually.
  Reading the subject line or metadata from google_gmail_search
  is NOT enough — you need the full body content of every email.
- Do NOT skip emails because you think you already know what
  they're about from the search results. Search results give
  you metadata only. You MUST read the actual content.
- If there are 43 unread emails, I expect to see 43
  google_gmail_read calls. If there are 200, I expect 200.
  No exceptions.
- Work in batches of 10-15 reads per response. After each
  batch, continue with the remaining emails in your next
  response. Do NOT produce any summary, briefing, or final
  output until EVERY email has been read via google_gmail_read.
- Do NOT mark any email as read. Do NOT archive, label, move,
  or modify anything.

COMPLETION CHECK:
Before producing your final briefing, count how many
google_gmail_read calls you made. If that number is less than
the total unread count from google_gmail_search, you are NOT
done — go back and read the ones you missed.

BRIEFING FORMAT (only after ALL emails are read):
1. Total unread count per account
2. For each email:
   - Who it's from and when
   - One-line summary of what they want or what it's about
   - Priority: urgent (needs action today), normal, or low
     (newsletter/promo/notification)
3. At the end, list any emails that need a reply with a
   suggested one-liner I can approve or edit

كيف يعمل

  1. يحمّل وولف فيش قدرة Google Workspace ويستدعي google_accounts لاكتشاف حساباتك المفوَّضة.
  2. لكل حساب، يستدعي google_gmail_search بـ is:unread in:inbox — استدعاء واحد لكل حساب، بالتوازي — يجلب كل رسالة غير مقروءة.
  3. لكل سلسلة رسائل غير مقروءة، يستدعي google_gmail_read للحصول على محتوى البريد الكامل.
  4. يقرأ نموذج اللغة كل بريد وينتج الملخص المهيكَل — المرسِل، الملخص، الأولوية.
  5. يقترح مسودات ردود لأي شيء يحتاج رداً.
بدون متصفح. بدون لقطات شاشة. بدون نقرات فأرة. استدعاءات API مباشرة لخادم Gmail.

المزيد

الأمر أعلاه نقطة بداية. إليك تنويعات يمكنك تجربتها:
Check my unread emails. For any email that's clearly
expecting a reply (a question, a request, an invitation),
draft a reply using google_gmail_draft_create. Match my
tone from soul.md. Don't send anything — just save drafts
for me to review.
Check all my email accounts for unread messages from the
last 24 hours. Write a markdown digest to
files/email-digest-today.md with sections: Action Required,
FYI, and Newsletters. Include sender, subject, and a
one-sentence summary for each. Mark newsletters as read.
Search my email for the most recent thread from
sarah@example.com about the Q3 budget. Read the full
thread and summarize the current state — what was agreed,
what's still open, and what I need to do next.
Give me a morning briefing:
1. Unread emails — summarize by priority
2. Today's calendar — list all events with times
3. Overdue tasks — anything past due in Google Tasks

Present it as one unified briefing, grouped by section.

الأتمتة بـ Heartbeat

بمجرد أن تثق في الإخراج، جدوِله ليعمل كل صباح. افتح الإعدادات > Heartbeat لتشغيل محرر Heartbeat المدمج — الصق الكتلة أدناه واحفظ. راجع توثيق Heartbeat لجميع تنسيقات الجدولة.
## Gmail Briefing | Weekday (07:30)

Check all my email accounts for unread messages in the inbox.

RULES — READ CAREFULLY:
- Fetch EVERY single unread email, however many there are.
  No caps, no pagination limits, no early stops.
- You MUST call google_gmail_read for EACH email individually.
  Reading the subject line or metadata from google_gmail_search
  is NOT enough — you need the full body content of every email.
- Do NOT skip emails because you think you already know what
  they're about from the search results. Search results give
  you metadata only. You MUST read the actual content.
- If there are 43 unread emails, I expect to see 43
  google_gmail_read calls. If there are 200, I expect 200.
  No exceptions.
- Work in batches of 10-15 reads per response. After each
  batch, continue with the remaining emails in your next
  response. Do NOT produce any summary, briefing, or final
  output until EVERY email has been read via google_gmail_read.
- Do NOT mark any email as read. Do NOT archive, label, move,
  or modify anything.

COMPLETION CHECK:
Before producing your final briefing, count how many
google_gmail_read calls you made. If that number is less than
the total unread count from google_gmail_search, you are NOT
done — go back and read the ones you missed.

BRIEFING FORMAT (only after ALL emails are read):
1. Total unread count per account
2. For each email:
   - Who it's from and when
   - One-line summary of what they want or what it's about
   - Priority: urgent (needs action today), normal, or low
     (newsletter/promo/notification)
3. At the end, list any emails that need a reply with a
   suggested one-liner I can approve or edit
غيّر Weekday (07:30) ليتناسب مع جدولك — Daily (08:00) لكل يوم، Cron (0 7 * * 1-5) لأيام العمل فقط، أو Weekly (Monday 07:00) لملخص أسبوعي.

الحدود

  • حالة OAuth “Testing” — تبقى شاشة الموافقة في وضع “Testing”، مما يقصر التفويض على مستخدمي الاختبار الذين أضفتهم (أنت). هذا مناسب للاستخدام الشخصي. إذا أردت أن يستخدمها آخرون، ستحتاج لنشر التطبيق عبر عملية التحقق من Google.
  • تحديث الرموز — تُحدَّث الرموز تلقائياً. إذا ألغيت الوصول من إعدادات أمان حساب Google، أعد التفويض في إعدادات وولف فيش.
  • حدود المعدل — تملك Gmail API من Google حصصاً مجانية سخية (250 وحدة حصة لكل مستخدم في الثانية). الاستخدام الشخصي العادي لن يقترب منها.
  • بدون محتوى المرفقات — يمكن لـ وولف فيش رؤية بيانات المرفقات الوصفية (الاسم، النوع، الحجم) لكنه لا يحمّل أو يقرأ محتوى المرفقات افتراضياً. يمكنك طلب تحميل مرفقات معينة عبر Google Drive.