用途：在 macOS 上通过脚本与 Mail.app 交互，完成刷新、列出、搜索、读取、发送、回复、删除及标记已读/未读等操作。脚本需从 cd {baseDir} 目录运行。
主要能力与常用命令：刷新 scripts/mail-refresh.sh [account] [wait_seconds]；列出近期邮件 scripts/mail-list.sh [mailbox] [account] [limit]；搜索 scripts/mail-search.sh "query" [mailbox] [limit]；快速搜索 scripts/mail-fast-search.sh "query" [limit]；读取 scripts/mail-read.sh <message-id>；删除 scripts/mail-delete.sh <message-id>；标记已读 scripts/mail-mark-read.sh <message-id>；标记未读 scripts/mail-mark-unread.sh <message-id>；发送 scripts/mail-send.sh "to@email.com" "Subject" "Body" [from-account] [attachment]；回复 scripts/mail-reply.sh <message-id> "body" [reply-all]；列出账户 scripts/mail-accounts.sh；列出邮箱 scripts/mail-mailboxes.sh [account]。支持批量传入多个 ID。
使用方式与性能：列表/搜索输出格式为 ID | ReadStatus | Date | Sender | Subject，● 表示未读。快速搜索基于 SQLite，约 50ms；账户查询 <1s，列表 1-3s，发送 1-2s，读取约 2s。Gmail 特殊文件夹需加 [Gmail]/ 前缀，如 [Gmail]/Spam。
限制：Mail.app 必须正在运行；mail-list.sh 不会自动刷新，需最新数据前先调用 mail-refresh.sh；已知限制为 Mail.app 会在已发送邮件开头添加空行，无法绕过；消息 ID 为内部 ID，需从列表/搜索获取最新值。