راهنمای کاربر MailForge

افزونه پیشرفته VSTO Outlook برای مدیریت، جستجو، و تحلیل ایمیل‌ها با تم تاریک و ۱۸+ قابلیت

VSTO Outlook Add-in C# .NET 4.8 Dark Theme 18+ Features

✨ ویژگی‌ها

MailForge مجموعه‌ای از ابزارهای حرفه‌ای برای مدیریت بهتر ایمیل‌های Outlook شماست:

MailForge یک تب MailForge به نوار ابزار Outlook اضافه می‌کند که در ۷ گروه سازمان‌دهی شده است:

گروهدکمه‌ها
IntelligenceAdvanced Search · Daily Digest · Quick Notes
AnalyticsEmail Dashboard · Storage Analyzer · Data Scanner
Batch ToolsBatch Operations · Smart Categorize
Email TemplatesNew Template · Apply Template
Compose ToolsQuick Reply · Schedule Send · Signatures
ManageEmail Tracker · Snooze · Archive · Settings
AppearanceToggle Theme
🔍

جستجوی پیشرفته

جستجو در تمام پوشه‌ها (Inbox, Sent, Drafts, Junk, Archive) با فیلترهای Subject, From, To, Body, Date, Flagged, Unread, Attachment و Importance.

📰

Daily Digest

خلاصه‌ای از فعالیت‌های اخیر صندوق ایمیل شما را تولید می‌کند.

📝

Quick Notes

یادداشت خصوصی به هر ایمیل برای مراجعه بعدی الصاق کنید.

📊

داشبورد ایمیل

نمودارهای بصری فعالیت ایمیل شما — ارسال، دریافت، و آمار کلی صندوق ورودی.

💾

Storage Analyzer

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

📂

Data Scanner

اسکن ایمیل‌ها برای الگوهای داده حساس (PII، کلمات عبور و غیره).

عملیات دسته‌ای

آرشیو، حذف، انتقال، و علامت‌گذاری خوانده/نخوانده برای چندین ایمیل به‌طور همزمان.

🧠

Smart Categorize

تخصیص خودکار دسته‌بندی‌های Outlook بر اساس الگوی فرستنده.

📄

قالب جدید

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

📥

اعمال قالب

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

↪️

پاسخ سریع

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

🕐

ارسال زمان‌بندی‌شده

زمان‌بندی ارسال ایمیل برای زمان مناسب.

✍️

امضاها

مدیریت و درج چندین امضای Outlook.

📍

Email Tracker

پیگیری و ردیابی یکپارچه: ثبت ایمیل‌های ارسالی، پیگیری پاسخ‌ها، Snooze و نظارت بر وضعیت باز شدن.

😴

Snooze

ایمیل‌ها را برای بازگشت در زمان مشخص به تعویق بیندازید.

🗃️

Archive

انتقال ایمیل‌های انتخاب‌شده به پوشه آرشیو در یک کلیک.

⚙️

تنظیمات

پیکربندی ظاهر، مسیرهای ذخیره‌سازی، امضاها و گزینه‌های پیش‌فرض جستجو.

🌗

تعویض تم

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

📦 نصب و راه‌اندازی

پیش‌نیازها

موردنسخه
Microsoft Outlook2016، 2019، 2021، 2024، یا Microsoft 365
.NET Framework4.8
VSTO Runtime4.0
سیستم‌عاملWindows 10 / 11
Visual Studio2019 یا 2022 (فقط برای ساخت)

روش ۱: نصب با install.bat (ساده‌ترین)

۱
پروژه را در Visual Studio باز کنید و Build → Rebuild Solution را اجرا کنید.
۲
فایل install.bat را با دسترسی Administrator اجرا کنید.
۳
Outlook را باز کنید و پیام اعتماد را تأیید کنید.
۴
تب MailForge در نوار ابزار Outlook ظاهر می‌شود.
نکته: اگر Outlook باز است، آن را ببندید و دوباره اجرا کنید تا افزونه بارگذاری شود.

روش ۲: ثبت دستی

  1. فایل MailForge.dll را به %LOCALAPPDATA%\MailForge\ کپی کنید.
  2. کلیدهای رجیستری زیر را اضافه کنید:
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\MailForge] "Description"="MailForge" "FriendlyName"="MailForge" "LoadBehavior"=dword:00000003 "Manifest"="file:///%LOCALAPPDATA%/MailForge/MailForge.vsto|vstolocal"
هشدار: نصب با دسترسی Administrator توصیه می‌شود. در صورت عدم دسترسی، نصب برای حساب کاربری فعلی انجام می‌شود.

📊 داشبورد ایمیل

داشبورد بصری فعالیت ایمیل شما را نشان می‌دهد. نمودارهای ارسال و دریافت ایمیل را در یک نگاه مشاهده کنید.

📝 قالب‌های ایمیل

قالب‌های ایمیل برای پاسخ‌های تکراری بسیار کاربردی هستند:

  1. از منوی Save یک قالب جدید بسازید.
  2. متن قالب را ویرایش کنید.
  3. هنگام نوشتن ایمیل جدید، از منوی Load قالب مورد نظر را انتخاب کنید.

📦 عملیات دسته‌ای

پس از جستجو، نتایج را انتخاب کرده و عملیات دسته‌ای اجرا کنید:

عملیاتتوضیح
آرشیوانتقال ایمیل‌ها به پوشه آرشیو
حذفحذف ایمیل‌های انتخاب‌شده
انتقالانتقال به پوشه دلخواه
علامت خواندههمه را به عنوان خوانده علامت کنید
علامت نخواندههمه را به عنوان نخوانده بازگردانید
دسته‌بندی هوشمنددسته‌بندی بر اساس الگوی فرستنده

📍 Email Tracker

MailForge ابزارهای پیگیری و ردیابی را در یک تب واحد ادغام کرده است:

⚙️ تنظیمات

از صفحه Settings می‌توانید:

❓ سؤالات متداول

آیا MailForge نیاز به دسترسی Administrator دارد؟

خیر. نصب برای حساب کاربری فعلی انجام می‌شود و نیاز به دسترسی Administrator ندارد (البته اجرای install.bat با دسترسی Administrator توصیه می‌شود).

آیا MailForge با Outlook 365 کار می‌کند؟

بله. MailForge با Outlook 2016، 2019، 2021، 2024 و Microsoft 365 سازگار است.

چگونه ایمیل‌های تکراری جلوگیری می‌شوند؟

MailForge از یک HashSet برای ردیابی EntryID ایمیل‌ها استفاده می‌کند و هر ایمیل فقط یک بار در نتایج نمایش داده می‌شود.

آیا جستجوی Regex پشتیبانی می‌شود؟

بله. با فعال کردن گزینه Use Regex می‌توانید از عبارات باقاعده در فیلدهای جستجو استفاده کنید.

خروجی CSV چه فرمتی دارد؟

فایل CSV با ستون‌های: Subject, From, To, Date, Size, Attach, Flag, Unread. با encoding UTF-8 ذخیره می‌شود.

اگر VSTOInstaller پیدا نشد چه کنیم؟

نصب به صورت دستی از طریق ثبت Registry انجام می‌شود. فایل install.bat خودکار بهترین روش را انتخاب می‌کند.

جستجو کند است یا جدول خالی می‌ماند؟

MailForge صندوق‌ها را با GetFirst/GetNext استریم می‌کند (هرگز کل فروشگاه را شمارش نمی‌کند)، بنابراین حتی صندوق ۱۰۰ گیگابایتی Outlook را هنگ نمی‌کند. اگر نتایج نمایش داده نمی‌شوند، مطمئن شوید حداقل یک فیلتر تنظیم شده و Importance روی Any باقی مانده است مگر اینکه بخواهید خاصاً بر اساس اولویت فیلتر کنید.

🛠️ عیب‌یابی (Office 2024)

Outlook 2024 سخت‌گیرانه‌تر از 2016/2019/2021 عمل می‌کند. اگر افزونه بارگذاری نشد یا غیرفعال شد، مراحل زیر را اعمال کنید.

علامت: «Not loaded. A runtime error occurred during the loading»

علامت: «Slow and Disabled» با میانگین تأخیر ۱۲ ثانیه

نکته: پس از هر فیکس، Outlook را کاملاً ببندید، fix-outlook-user.bat را اجرا کنید، سپس Outlook را دوباره باز کنید. بررسی کنید که تب MailForge در ریبون ظاهر می‌شود و هیچ هشدار «disabled» در File → Options → Add-ins → Manage COM Add-ins نمایش داده نمی‌شود.

📁 ساختار پروژه

MailForge/ ├── Forms/ # فرم‌های کاربری (WinForms) │ ├── AdvancedSearchForm.cs # جستجوی پیشرفته ایمیل │ ├── BatchOperationForm.cs # عملیات دسته‌ای │ ├── DarkThemeHelper.cs # موتور تم تاریک │ ├── EmailDashboardForm.cs # داشبورد ایمیل │ ├── FollowUpForm.cs # Email Tracker یکپارچه (پیگیری + ردیابی) │ ├── SettingsForm.cs # تنظیمات برنامه │ ├── SignatureManagerForm.cs # مدیریت امضا │ ├── StorageAnalyzerForm.cs # تحلیل فضای ذخیره‌سازی │ ├── SensitiveDataScannerForm.cs # اسکنر داده‌های حساس │ ├── TemplateForm.cs # مدیریت قالب‌ها │ └── ... ├── Services/ # لایه منطق کسبی │ ├── JsonStorageService.cs # ذخیره‌سازی فایل JSON │ ├── TemplateService.cs # مدیریت قالب‌ها │ ├── FollowUpTrackerService.cs # مدیریت پیگیری + ردیابی │ ├── SettingsService.cs # تنظیمات │ └── ... ├── Resources/ # فایل‌های منابع (۲۲ آیکون گلسمورفیسم) ├── Ribbon1.cs # تعریف ریبون Outlook ├── Ribbon1.xml # چیدمان ریبون XML ├── ThisAddIn.cs # نقطه ورود افزونه VSTO ├── OutlookSafe.cs # Safe ribbon stub + محافظ خطای سراسری ├── App.config # Binding redirects برای .NET 4.8 / Office 2024 ├── fix-outlook-user.bat # ثبت COM سطح کاربر + فیکس CRL-off ├── install.bat # اسکریپت نصب ├── uninstall.bat # اسکریپت حذف نصب ├── MailForge.csproj # فایل پروژه └── README.md # فایل خواندنی پروژه

📚 راهنمای کامل تب‌ها

یک راهنمای HTML مستقل و جامع که کاربرد تمام ۱۸ تب ریبون MailForge را با مراحل گام‌به‌گام، ویژگی‌ها و نکات هر کدام پوشش می‌دهد.

دانلود راهنمای کامل (HTML)