راهنمای کاربر MailForge — کاربرد تمام تب‌ها

افزونه VSTO Outlook برای مدیریت، جستجو، تحلیل و بهینه‌سازی ایمیل‌ها

۱۸ دکمه ۷ گروه ریبون تم تاریک/روشن پردازش کاملاً محلی

📑 فهرست تب‌ها

  1. Advanced Search
  2. Daily Digest
  3. Quick Notes
  4. Email Dashboard
  5. Storage Analyzer
  6. Data Scanner
  7. Batch Operations
  8. Smart Categorize
  9. New Template
  10. Apply Template
  11. Quick Reply
  12. Schedule Send
  13. Signatures
  14. Email Tracker
  15. Snooze
  16. Archive
  17. Settings
  18. Toggle Theme
🔍 Advanced Search Intelligence

قوی‌ترین ابزار MailForge. جستجوی ترکیبی با فیلترهای دقیق روی پوشه‌های مختلف — نه فقط پوشه فعلی.

کاربرد: پیدا کردن سریع ایمیل با ترکیب موضوع، فرستنده، گیرنده، متن، تاریخ، فلگ، خوانده/نخوانده و پیوست.
فیلدها: Subject, From, To, Body, Date From/To, Folder (انتخاب چندگانه), Use Regex, Flagged, Unread, Has Attachment, Importance.
ویژگی‌های خروجی: ضدتکرار (هر ایمیل یک بار)، خروجی CSV، ذخیره جستجو، تاریخچه جستجو، لغو حین اجرا.
۱. حداقل یک فیلد را پر کنید (مثلاً Subject Contains "فاکتور").
۲. در پانل Folders چک‌باکس‌ها را انتخاب کنید (All Folders یا Inbox + Sent ترکیبی).
۳. دکمه Search را بزنید.
۴. روی هر ردیف دوبار کلیک کنید تا ایمیل باز شود.
۵. با Export CSV نتایج را خروجی بگیرید.
⚠️ اگر نتیجه‌ای نیامد: مطمئن شوید حداقل یک فیلتر ست کرده‌اید و Importance روی Any باقی مانده باشد.
📰 Daily Digest Intelligence

یک خلاصه متنی از وضعیت صندوق ورودی: ایمیل‌های نخوانده، فلگ‌شده، رسیده‌های امروز و یادآوری‌های پیگیری.

کاربرد: مشاهده سریع وضعیت Inbox بدون اسکرول کردن بین صدها ایمیل.
خروجی: پنجره‌ای با متن ساختاریافته شامل آمار + لیست ۱۰ مورد برتر نخوانده/فلگ‌شده + یادآوری فالوآپ.
ذخیره تاریخچه: هر دایجست در digest_history.json ذخیره می‌شود (محلی روی همین کامپیوتر).
۱. روی دکمه Daily Digest در ریبون کلیک کنید.
۲. خلاصه در یک پنجره نمایش داده می‌شود.
۳. می‌توانید متن را کپی/پرینت بگیرید.
⚠️ افزونه فقط صندوق Inbox را برای دایجست می‌خواند (۵۰ آیتم جدیدترین).
📝 Quick Notes Intelligence

یادداشت شخصی الصاق کنید به هر ایمیل (با EntryId آن) — مثل یک Post-it روی نامه.

کاربرد: یادداشت‌های سریع مثل "با این فرد ساعت ۳ تماس بگیر" بدون تغییر دادن خود ایمیل.
ذخیره: در quicknotes.json محلی — به ایمیل چسبیده و با باز کردن دوباره قابل بازیابی است.
۱. یک ایمیل را در Outlook انتخاب کنید.
۲. دکمه Quick Notes را بزنید.
۳. متن یادداشت را بنویسید و Save کنید.
۴. بار بعد با باز کردن همان ایمیل، یادداشت از طریق سرویس بازیابی می‌شود (در فرم‌های دیگر قابل نمایش).
✅ افزودن یادداشت جدید به ایمیل موجود، متن قبلی را پاک نمی‌کند بلکه به آن ملحق می‌شود.
📊 Email Dashboard Analytics

۳ تب تحلیلی: نمای کلی، پرتماس‌ترین‌ها، و آمار ایمیل.

تب Overview: تعداد کل، میانگین حجم، نمودار روزانه (۳۰ روز)، ۱۰ فرستنده برتر، ۱۰ گیرنده برتر، ایمیل به تفکیک پوشه، بزرگترین پیوست‌ها.
تب Most Contacted: ۲۰ مخاطب برتر بر اساس ارسال/دریافت (فیلتر: All / By Sent / By Received).
تب Email Stats: نمودار ارسال/دریافت روزانه، شلوغ‌ترین ساعات، شلوغ‌ترین روزهای هفته.
۱. دکمه Email Dashboard را بزنید (خودکار شروع به اسکن می‌کند).
۲. برای به‌روزرسانی دکمه Refresh یا کلید F5.
۳. بین ۳ تب جابجا شوید.
⚠️ اسکن پوشه‌های Inbox, Sent, Drafts, Deleted, Outbox را پوشش می‌دهد. برای صندوق‌های بسیار بزرگ چند ثانیه طول می‌کشد.
💾 Storage Analyzer Analytics

تحلیل فضای اشغالی صندوق: کدام پوشه‌ها و کدام فرستندگان بیشترین فضا را می‌گیرند.

تب Overview: حجم کل، تعداد کل، نمودار میله‌ای فضای هر پوشه، جدول پوشه‌ها با درصد.
تب Size by Contact: ۲۰ مخاطب با بیشترین حجم اشغالی (تعداد + میانگین + کل).
تب Oldest & Largest: ۱۰ ایمیل قدیمی‌ترین و ۱۰ ایمیل بزرگترین برای پاکسازی هدفمند.
۱. دکمه Storage Analyzer را بزنید (خودکار تحلیل می‌کند).
۲. از تب Oldest & Largest برای یافتن ایمیل‌های حجیم جهت آرشیو استفاده کنید.
✅ ابزار فقط می‌خواند و هیچ ایمیلی را حذف یا جابجا نمی‌کند — فقط گزارش می‌دهد.
📂 Data Scanner (Sensitive Data) Analytics

اسکن محلی ایمیل‌ها برای الگوهای داده حساس — بدون خروج هیچ داده‌ای از کامپیوتر.

الگوهای شناسایی: شماره کارت اعتباری (Visa/Master/Amex/Discover)، SSN، شماره تلفن، آدرس ایمیل در متن، آدرس IP.
سطح هشدار: HIGH (کارت)، CRITICAL (SSN)، MEDIUM (تلفن)، LOW (ایمیل/آی‌پی).
خروجی: جدول با نوع، شدت، موضوع، فرستنده، تاریخ، الگوی ماسک‌شده و متن اطراف + دکمه Export.
۱. نوع اسکن و پوشه را انتخاب کنید.
۲. Start Scan را بزنید.
۳. در صورت یافتن مورد، با Export (یا Ctrl+E) خروجی بگیرید.
⚠️ تمام پردازش محلی است. الگوها با Regex بررسی می‌شوند و مقادیر واقعی ماسک می‌شوند (مثل ****1234).
Batch Operations Batch Tools

انتخاب چندین ایمیل و اجرای عملیات دسته‌ای با نوار پیشرفت.

عملیات: Archive (به پوشه MailForge Archive)، Move to (پوشه دلخواه)، Delete، Mark Read، Mark Unread.
رابط: جدول با ستون چک‌باکس، دکمه‌های Select All / Deselect All، نمایش تعداد انتخاب‌شده.
۱. چند ایمیل را در Outlook انتخاب کنید و دکمه Batch Operations را بزنید.
۲. در فرم، موارد دلخواه را تیک بزنید.
۳. یک عملیات را انتخاب کنید (تأیید ظاهر می‌شود).
۴. منتظر نوار پیشرفت بمانید؛ ردیف‌های پردازش‌شده حذف می‌شوند.
⚠️ Delete غیرقابل بازگشت است. قبل از حذف دسته‌ای تأییدیه نمایش داده می‌شود — دقت کنید.
✅ کلید Delete در فرم، حذف دسته‌ای انتخاب‌شده‌ها را با تأیید اجرا می‌کند.
🧠 Smart Categorize Batch Tools

تخصیص خودکار دسته‌بندی‌های Outlook بر اساس قوانین محلی (دامنه / کلمه کلیدی / نام فرستنده).

قوانین پیش‌فرض: Newsletters، Social (facebook/twitter/linkedin/instagram)، Finance (invoice/billing/payment)، Urgent (urgent/ASAP/critical).
منطق: ایمیل‌های انتخاب‌شده را بررسی می‌کند و دسته‌بندی متناظر را روی آن‌ها اعمال می‌کند.
۱. ایمیل‌های مورد نظر را در Outlook انتخاب کنید.
۲. دکمه Smart Categorize را بزنید.
۳. پیام تأیید تعداد دسته‌بندی‌شده را نشان می‌دهد.
✅ قوانین در categorize_rules.json ذخیره می‌شوند و قابل ویرایش/افزودن از کد هستند.
📄 New Template Email Templates

ایجاد و ذخیره قالب ایمیل برای پاسخ‌های تکراری.

فیلدها: Template Name، Subject، Body (RichText).
عملیات: Save (ذخیره)، Delete (حذف قالب موجود)، Load (بارگذاری از لیست کشویی).
۱. دکمه New Template را بزنید.
۲. نام، موضوع و متن را بنویسید.
۳. Save (یا Ctrl+S) را بزنید.
۴. برای ویرایش بعدی، از لیست کشویی انتخاب کنید.
⚠️ نام قالب الزامی است. پس از بارگذاری یک قالب، فیلد نام غیرفعال می‌شود (برای جلوگیری از بازنویسی اتفاقی).
📥 Apply Template Email Templates

اعمال سریع یک قالب ذخیره‌شده روی ایمیل جدید یا در حال نگارش.

رابط: لیست کشویی قالب‌ها + پیش‌نمایش (نام/موضوع/متن) + دکمه Apply.
رفتار: پس از Apply، قالب روی پنجره ایمیل فعال اعمال می‌شود.
۱. دکمه Apply Template را بزنید.
۲. از لیست، قالب را انتخاب کنید (پیش‌نمایش نمایش داده می‌شود).
۳. Apply Template (یا Ctrl+Enter) را بزنید.
✅ اگر ایمیل جدید باز نباشد، MailForge یک ایمیل جدید ایجاد و قالب را اعمال می‌کند.
↪️ Quick Reply Compose Tools

پاسخ سریع به ایمیل انتخاب‌شده در یک کلیک.

رفتار: روی ایمیل انتخاب‌شده mail.Reply() را اجرا می‌کند و پنجره پاسخ را باز می‌کند.
۱. یک ایمیل را انتخاب کنید.
۲. دکمه Quick Reply را بزنید.
۳. پنجره پاسخ باز می‌شود؛ متن خود را بنویسید و ارسال کنید.
⚠️ حداقل یک ایمیل باید در پنجره اصلی Outlook انتخاب باشد، وگرنه پیام "لطفاً یک ایمیل انتخاب کنید" نمایش داده می‌شود.
🕐 Schedule Send Compose Tools

زمان‌بندی ارسال یک ایمیل برای تاریخ/ساعت مشخص.

رفتار: فرم انتخاب زمان را باز می‌کند و از ScheduleService برای زمان‌بندی استفاده می‌کند.
۱. دکمه Schedule Send را بزنید.
۲. در فرم باز شده، تاریخ و ساعت مورد نظر را تنظیم کنید.
۳. OK را بزنید تا ایمیل در صف ارسال زمان‌بندی شده قرار گیرد.
✅ ایمیل تا زمان تعیین‌شده در پوشه Drafts/Outbox باقی می‌ماند و سپس ارسال می‌شود.
✍️ Signatures Compose Tools

مدیریت و درج چندین امضای Outlook از یک پنجره.

قابلیت‌ها: لیست امضاها، ایجاد/ویرایش، حذف، و درج روی ایمیل در حال نگارش.
۱. دکمه Signatures را بزنید.
۲. امضای مورد نظر را انتخاب یا جدید بسازید.
۳. برای درج روی ایمیل باز، دکمه Insert را بزنید.
✅ امضاها از طریق SignatureService مدیریت می‌شوند و با پروفایل Outlook همگام‌سازی می‌شوند.
📍 Email Tracker Manage

تب یکپارچه پیگیری و ردیابی ایمیل‌های ارسالی (ادغام Follow-up + Tracking).

ثبت پیگیری: ایمیل انتخاب‌شده را با یادداشت و یادآوری N روزه ثبت می‌کند.
ردیف‌ها: Subject، To، Sent Date، Follow-up Date، Replied (✅/❌)، Reply Time، Note، EntryId.
رنگ‌بندی: زرد = سررسید گذشته (Overdue)، سبز = پاسخ داده شده، عادی = در انتظار.
دکمه‌ها: Add Selected Email، Replied (علامت پاسخ داده)، Delete، Refresh.
۱. ایمیل ارسالی را انتخاب کنید.
۲. در فرم Email Tracker، تعداد روز یادآوری و یادداشت را تنظیم کنید.
۳. Add Selected Email (یا Ctrl+Enter) را بزنید.
۴. وقت پاسخ داد طرف، ردیف را انتخاب و Replied را بزنید.
۵. دابل‌کلیک روی هر ردیف، ایمیل را باز می‌کند.
⚠️ داده‌ها در followup.json محلی ذخیره می‌شوند. حذف این فایل، تاریخچه پیگیری را پاک می‌کند.
😴 Snooze Manage

به تعویق انداختن ایمیل برای بازگشت در زمان مشخص (مثل "بعداً به این رسیدگی کن").

رفتار: ایمیل انتخاب‌شده را با استفاده از EmailSnoozeService زمان‌بندی می‌کند تا در زمان تعیین‌شده دوباره در صدر قرار گیرد.
۱. ایمیل را انتخاب کنید.
۲. دکمه Snooze را بزنید.
۳. زمان بیداری (مثلاً +۱ ساعت) را تنظیم و تأیید کنید.
✅ ایمیل تا زمان تنظیم‌شده از دید خارج نمی‌شود بلکه با پرچم زمان‌بندی شده نشانه‌گذاری می‌شود.
🗃️ Archive Manage

انتقال سریع ایمیل‌های انتخاب‌شده به پوشه آرشیو (پیش‌فرض: MailForge Archive).

رفتار: فرم انتخاب نام پوشه را باز می‌کند؛ تایید، ایمیل‌ها را جابجا می‌کند.
ذخیره نام: دکمه Save Folder Name، نام پوشه را در تنظیمات حفظ می‌کند برای استفاده بعدی.
۱. چند ایمیل را انتخاب کنید.
۲. دکمه Archive را بزنید.
۳. نام پوشه را تأیید یا تغییر دهید.
۴. Archive Now (یا Ctrl+Enter) را بزنید.
⚠️ Archive ایمیل را از پوشه اصلی خارج و به پوشه آرشیو منتقل می‌کند (نه حذف). قابل بازگشت از پوشه آرشیو است.
⚙️ Settings Manage

تنظیمات عمومی افزونه: زمان‌بندی، پیگیری، اسنوز، دایجست، آرشیو و تم.

فیلدها: Schedule Every (min)، Follow-up After (days)، Snooze Duration (min)، Enable Daily Digest، Digest Time (HH:mm)، Archive Folder Name، Theme (Dark/Light).
تأثیر تم: تغییر تم در همین لحظه اعمال می‌شود بدون نیاز به ری‌استارت Outlook.
۱. دکمه Settings را بزنید.
۲. مقادیر را تنظیم کنید.
۳. Save (یا Ctrl+Enter) را بزنید.
⚠️ فرمت Digest Time باید HH:mm باشد (مثل 08:00) وگرنه هنگام Save اخطار می‌دهد.
🌗 Toggle Theme Appearance

تعویض آنی بین تم تاریک (الهام‌گرفته از GitHub-dark) و تم روشن.

رفتار: وضعیت فعلی را از Settings می‌خواند، آن را معکوس می‌کند و بلافاصله روی تمام فرم‌های باز و آینده اعمال می‌کند.

۱. دکمه Toggle Theme را در ریبون بزنید.
۲. پیام تأیید تم جدید نمایش داده می‌شود.
۳. انتخاب در Settings نیز ذخیره می‌شود (در ری‌استارت بعدی حفظ می‌شود).
✅ هیچ ری‌استارتی لازم نیست — تغییر لحظه‌ای است.