# 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

# 在终端 UI 中打开 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

# 生成 shell 补全
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]              按抄送收件人搜索
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 年 1 月的消息
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 MB 的消息
size:>1mb size:<5mb              1 至 5 MB 之间
-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              # 使用 clap 的 CLI
+-- 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)，100 万条消息 < 200 毫秒）
|   +-- fulltext.rs      # 流式全文搜索
+-- export/
|   +-- eml.rs           # 导出为 .eml
|   +-- csv.rs           # 导出摘要为 CSV（UTF-8 BOM）
|   +-- text.rs          # 导出为纯文本
|   +-- attachment.rs    # 附件提取
|   +-- mbox.rs          # MBOX 合并，带去重和来源头
+-- tui/
    +-- app.rs           # 全局状态（Elm 架构）
    +-- 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     # 导出弹窗