# Linux / macOS
chmod +x mboxshell-*
sudo mv mboxshell-* /usr/local/bin/mboxshell

# أو ضعه في دليل محلي للمستخدم
mv mboxshell-* ~/.local/bin/mboxshell

# استنساخ وبناء
git clone https://github.com/dcarrero/mboxshell.git
cd mboxshell
cargo build --release

# الملف الثنائي في target/release/mboxshell
# ثبّته على مستوى النظام:
sudo cp target/release/mboxshell /usr/local/bin/

# أو للمستخدم الحالي فقط:
cp target/release/mboxshell ~/.local/bin/

# أضف الهدف الذي تحتاجه
rustup target add aarch64-apple-darwin      # macOS Apple Silicon
rustup target add x86_64-unknown-linux-gnu  # Linux x86_64
rustup target add aarch64-unknown-linux-gnu # Linux ARM64

# البناء لهدف محدد
cargo build --release --target aarch64-apple-darwin

cargo install --git https://github.com/dcarrero/mboxshell.git

# افتح ملف MBOX في واجهة الطرفية
mboxshell mail.mbox

# فهرسة وعرض الإحصائيات
mboxshell index mail.mbox
mboxshell stats mail.mbox

# البحث من سطر الأوامر
mboxshell search mail.mbox "from:[email protected] date:2024"
mboxshell search mail.mbox "has:attachment subject:invoice" --json

# تصدير الرسائل
mboxshell export mail.mbox --format eml --output ./emails/
mboxshell export mail.mbox --format csv --output summary.csv

# تسليم جزء فقط من الأرشيف: صندوق بريد جديد يحتوي فقط على المطابقات
mboxshell export mail.mbox --format mbox --query "from:[email protected]" -o handover.mbox

# استخراج المرفقات
mboxshell attachments mail.mbox --output ./attachments/

# دمج ملفات MBOX متعددة (تتم إزالة التكرارات افتراضيًا)
mboxshell merge file1.mbox file2.mbox -o merged.mbox

# دمج مع وضع علامة على كل رسالة بصندوق البريد الذي جاءت منه
mboxshell merge Inbox.mbox Sent.mbox -o merged.mbox --source-header

# توليد إكمالات الصدفة
mboxshell completions bash > /etc/bash_completion.d/mboxshell
mboxshell completions zsh > ~/.zfunc/_mboxshell
mboxshell completions fish > ~/.config/fish/completions/mboxshell.fish

from:[email protected]              البحث حسب المرسل
to:[email protected]         البحث حسب المستلم
cc:[email protected]              البحث حسب مستلم Cc
subject:invoice                  البحث في سطر الموضوع
body:important text              البحث في نص الرسالة (نص كامل)
filename:report.pdf              البحث حسب اسم ملف المرفق
id:<message-id@domain>           البحث حسب Message-ID
has:attachment                   فقط الرسائل التي تحتوي على مرفقات
has:no-attachment                فقط الرسائل التي لا تحتوي على مرفقات
label:Inbox                      التصفية حسب تسمية Gmail
date:2024-01                     رسائل من يناير 2024
date:2024-01-01..2024-06-30      نطاق تواريخ
before:2024-06-01                قبل تاريخ (ذلك اليوم مستبعد)
after:2024-01-01                 من تاريخ فصاعدًا (ذلك اليوم مشمول)
after:2024-01-01 before:2025-01-01   كل عام 2024
size:>1mb                        رسائل أكبر من 1 ميجابايت
size:>1mb size:<5mb              بين 1 و5 ميجابايت
-subject:spam                    استبعاد الرسائل التي تحتوي على "spam" في الموضوع
"exact phrase"                   البحث عن عبارة دقيقة
from:john subject:budget         AND ضمني (يجب أن يطابق كلاهما)
term1 OR term2                   OR صريح
from:a OR from:b subject:budget  OR يربط بشكل أقوى: (a OR b) AND subject

[general]
default_sort = "date"
sort_order = "desc"
date_format = "%Y-%m-%d %H:%M"
log_level = "warn"

[display]
theme = "dark"
layout = "horizontal"
show_sidebar = false
max_cached_messages = 50

[export]
default_format = "eml"
csv_separator = ","

src/
+-- main.rs              # CLI مع clap
+-- lib.rs               # إعادة تصدير الوحدات
+-- error.rs             # أنواع الأخطاء مع thiserror
+-- config.rs            # إعدادات TOML
+-- mailbox_naming.rs    # أسماء صناديق البريد المقروءة (حزم Apple Mail)
+-- i18n/                # التدويل (EN/ES)
+-- parser/
|   +-- mbox.rs          # محلل تدفقي (لا يحمّل الملف في الذاكرة أبدًا)
|   +-- eml.rs           # محلل ملفات EML الفردية
|   +-- mime.rs          # فك ترميز MIME، multipart، مجموعات الأحرف
|   +-- header.rs        # ترويسات RFC 5322، كلمات مشفرة RFC 2047
+-- index/
|   +-- builder.rs       # بناء الفهرس الثنائي
|   +-- reader.rs        # استعلامات الفهرس
|   +-- format.rs        # صيغة ثنائية مع فحص سلامة SHA-256
+-- model/
|   +-- mail.rs          # MailEntry، MailBody
|   +-- attachment.rs    # بيانات وصفية للمرفقات
|   +-- address.rs       # تحليل عناوين RFC 5322
+-- store/
|   +-- reader.rs        # قراءة قائمة على الإزاحة مع ذاكرة تخزين مؤقت LRU
+-- search/
|   +-- query.rs         # محلل استعلامات البحث
|   +-- metadata.rs      # بحث سريع في الفهرس (O(n)، < 200ms لـ 1M رسالة)
|   +-- fulltext.rs      # بحث نص كامل تدفقي
+-- export/
|   +-- eml.rs           # تصدير إلى .eml
|   +-- csv.rs           # تصدير ملخص إلى CSV (UTF-8 BOM)
|   +-- text.rs          # تصدير إلى نص عادي
|   +-- attachment.rs    # استخراج المرفقات
|   +-- mbox.rs          # دمج MBOX مع إزالة التكرار وترويسة المصدر
+-- tui/
    +-- app.rs           # الحالة العامة (Elm Architecture)
    +-- event.rs         # معالجة أحداث لوحة المفاتيح
    +-- ui.rs            # تخطيط وتوزيع العرض
    +-- threading.rs     # خوارزمية JWZ لسلاسل المحادثات
    +-- theme.rs         # سمة الألوان
    +-- widgets/         # المكونات المرئية
        +-- mail_list.rs       # قائمة مع تمرير افتراضي
        +-- mail_view.rs       # عارض رسائل مع تمرير
        +-- sidebar.rs         # لوحة التسميات/المجلدات
        +-- header_bar.rs      # الشريط العلوي
        +-- status_bar.rs      # شريط الحالة
        +-- search_bar.rs      # شريط البحث
        +-- search_popup.rs    # نافذة فلاتر البحث المنبثقة
        +-- help_popup.rs      # نافذة المساعدة المنبثقة
        +-- attachment_popup.rs # نافذة المرفقات المنبثقة
        +-- export_popup.rs     # نافذة التصدير المنبثقة