用途：为智能体提供邮箱能力，核心场景是自动完成服务注册——用 $MAILS_MAILBOX 填写表单后，调用 GET /api/code?timeout=60 获取验证码并填入，即可自主完成注册。也可用于收发邮件、监控收件箱、按关键词搜索、下载附件等。
主要能力：收件箱列表与搜索（GET /api/inbox，支持 query、limit、offset、direction、label、mode 关键词/语义/混合）；读取邮件详情（GET /api/email?id=ID）；长轮询等待验证码（GET /api/code?timeout=60）；发送邮件（POST /api/send，字段含 from、to、cc、bcc、subject、text、html、reply_to、in_reply_to、headers、attachments）；删除邮件（DELETE /api/email?id=ID）；下载附件（GET /api/attachment?id=ID）；会话线程（GET /api/threads、GET /api/thread?id=ID）；结构化提取（POST /api/extract，type 支持 order/shipping/calendar/receipt/code）；统计（GET /api/stats）；SSE 实时事件（GET /api/events）；邮箱信息与设置（GET/PATCH /api/mailbox）；暂停/恢复（PATCH /api/mailbox/pause、/resume）；按标签的 webhook 路由（GET/PUT/DELETE /api/mailbox/routes）；能力查询（GET /api/me）；健康检查（GET /health，无需鉴权）。
使用方式：除 /health 外，所有请求需带 Authorization: Bearer $MAILS_AUTH_TOKEN 头；POST/PUT/PATCH 需 Content-Type: application/json。to 参数可选，API 会自动限定到令牌对应邮箱。邮件接收后自动打标签：newsletter、notification、code、personal，可用 ?label=notification 过滤。
限制：from 必须等于 $MAILS_MAILBOX（服务端强制）；验证码为 4-12 位字母数字（支持英/中/日/韩）；验证码等待超时最长 55 秒；发送限每邮箱每天 100 封；搜索使用 FTS5 全文（关键词模式）或 Vectorize（语义模式）。