Mailbox CLI 用于从命令行读取和管理多个 IMAP 账户的邮件，返回带 success 字段的 JSON 契约，失败时附 error 与 error_code。
主要能力：邮件列表、跨账户最近邮件、搜索、读取单封或批量邮件、文件夹查询、标记已读、删除、加旗标、移动、发送；cleanup 可对收件箱分类并给出删除计划。所有变更类命令默认 dry-run，需加 --confirm 才生效。
安装：curl -fsSL https://raw.githubusercontent.com/leeguooooo/Mailbox/main/install.sh | sh，装到 ~/.local/bin。配置账户需创建 ~/.config/mailbox/auth.json。可安装常驻 daemon 提升调用速度，也可通过 MCP 供 AI 客户端直接调用。
用法：始终加 --json 并检查 success；每封邮件带 gid（account_id:folder:uid）。注意部分新参数需 mailbox ≥ 2.11.0，旧版可用回退参数。
限制：QQ/163 等部分服务商 IMAP 文本搜索不可用，搜索退化为客户端过滤且较慢；邮件正文默认截断为 2000 字符并去 URL。具体账户配置细节与完整参数请查阅官方文档。