[{"data":1,"prerenderedAt":4},["ShallowReactive",2],{"readme:mails":3},"\u003Ch1>mails\u003C\u002Fh1>\n\u003Cp>面向 AI Agent 的邮件基础设施。通过编程方式收发邮件。\u003C\u002Fp>\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmails\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fmails\" alt=\"npm\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fchekusu\u002Fmails\u002Fblob\u002Fmain\u002FLICENSE\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fl\u002Fmails\" alt=\"license\" \u002F>\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fchekusu\u002Fmails\u002Fblob\u002Fmain\u002FREADME.en.md\" rel=\"nofollow ugc noopener\">English\u003C\u002Fa> | \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fchekusu\u002Fmails\u002Fblob\u002Fmain\u002FREADME.ja.md\" rel=\"nofollow ugc noopener\">日本語\u003C\u002Fa> | \u003Cstrong>中文\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Ch2>工作原理\u003C\u002Fh2>\n\u003Cpre>\u003Ccode> 发送 接收\n\n Agent 外部发件人\n | |\n | mails send --to user@example.com | 发送邮件到 agent@mails.dev\n | |\n v v\n+--------+ +-------------------+\n| CLI | | Cloudflare Email |\n| \u002FSDK | | Routing |\n+--------+ +-------------------+\n | |\n | \u002Fv1\u002Fsend | email() handler\n | \u002Fapi\u002Fsend |\n v v\n+-----------------------------------------------------------+\n| Worker |\n| |\n| provider 链：Cloudflare Email Service → Resend |\n| |\n| mails.dev（托管） 或 自己部署（自部署） |\n| +-----------------------------------------+ |\n| | +----------+ +----------------+ | +---------+ |\n| | | db9.ai | | fs9（文件） | | | D1 | |\n| | | 全文搜索 | | （附件存储） | | | （存储） | |\n| | | 高级查询 | +----------------+ | +---------+ |\n| | +----------+ | |\n| +-----------------------------------------+ |\n+-----------------------------------------------------------+\n | |\n 通过 CLI\u002FSDK 查询 mails sync\n （remote provider） （拉取到本地）\n | |\n v +-----+------+\n Agent | |\n +---------+ +-----------+\n | SQLite | | db9.ai |\n | （本地） | | （云端） |\n +---------+ +-----------+\n 离线查询 全文搜索\n 本地备份 高级过滤\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>特性\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>发送邮件\u003C\u002Fstrong> — 多 provider 链：Cloudflare Email Service（原生 \u003Ccode>env.EMAIL.send()\u003C\u002Fcode> binding，公开 beta）与 Resend 互为兜底，默认顺序 \u003Ccode>cloudflare,resend\u003C\u002Fcode>，通过 \u003Ccode>EMAIL_PROVIDERS\u003C\u002Fcode> 覆盖\u003C\u002Fli>\n\u003Cli>\u003Cstrong>接收邮件\u003C\u002Fstrong> — 通过 Cloudflare Email Routing Worker\u003C\u002Fli>\n\u003Cli>\u003Cstrong>搜索收件箱\u003C\u002Fstrong> — 按关键词搜索主题、正文、发件人、验证码\u003C\u002Fli>\n\u003Cli>\u003Cstrong>验证码自动提取\u003C\u002Fstrong> — 自动从邮件中提取验证码（支持中\u002F英\u002F日\u002F韩）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>附件\u003C\u002Fstrong> — CLI \u003Ccode>--attach\u003C\u002Fcode> 或 SDK 发送，Worker 自动解析 MIME 附件\u003C\u002Fli>\n\u003Cli>\u003Cstrong>存储 Provider\u003C\u002Fstrong> — 本地 SQLite、\u003Ca href=\"https:\u002F\u002Fdb9.ai\" rel=\"nofollow ugc noopener\">db9.ai\u003C\u002Fa> 云端 PostgreSQL、或远程 Worker API\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Provider 可见性\u003C\u002Fstrong> — \u003Ccode>\u002Fapi\u002Fsend\u003C\u002Fcode> 响应与 \u003Ccode>\u002Fapi\u002Finbox\u003C\u002Fcode> 的 outbound 行携带 \u003Ccode>provider\u003C\u002Fcode> 字段（\u003Ccode>cloudflare\u003C\u002Fcode>\u002F\u003Ccode>resend\u003C\u002Fcode>），知道是谁真正投递的\u003C\u002Fli>\n\u003Cli>\u003Cstrong>零运行时依赖\u003C\u002Fstrong> — provider 全部走 Workers binding 或原生 \u003Ccode>fetch()\u003C\u002Fcode>，不引 SDK\u003C\u002Fli>\n\u003Cli>\u003Cstrong>托管服务\u003C\u002Fstrong> — 通过 \u003Ccode>mails claim\u003C\u002Fcode> 免费获取 \u003Ccode>@mails.dev\u003C\u002Fcode> 邮箱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>自部署\u003C\u002Fstrong> — 部署自己的 Worker，并使用 mailbox 级 token 鉴权\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>安装\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-bash\">npm install -g mails\n# 或\nbun install -g mails\n# 或直接使用\nnpx mails\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>CLI 最多每 24 小时检查一次 npm；发现新版本时，会在 stderr 打印升级提醒。可用 \u003Ccode>MAILS_NO_UPDATE_CHECK=1\u003C\u002Fcode> 关闭（设置 \u003Ccode>NO_UPDATE_NOTIFIER=1\u003C\u002Fcode> 或 \u003Ccode>CI=1\u003C\u002Fcode> 时也会跳过检查）。\u003C\u002Fp>\n\u003Ch2>快速开始\u003C\u002Fh2>\n\u003Ch3>托管模式 (mails.dev)\u003C\u002Fh3>\n\u003Cpre>\u003Ccode class=\"language-bash\">mails claim myagent # 免费认领 myagent@mails.dev\nmails send --to user@example.com --subject \"Hello\" --body \"World\" # 每月 100 封免费\nmails inbox # 查看收件箱\nmails inbox --query \"密码\" # 搜索邮件\nmails code --to myagent@mails.dev # 等待验证码\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>无需 Resend key — 托管用户每月 100 封免费发件。无限发送请配置自己的 key：\u003Ccode>mails config set resend_api_key re_YOUR_KEY\u003C\u002Fcode>\u003C\u002Fp>\n\u003Ch3>自部署模式\u003C\u002Fh3>\n\u003Cpre>\u003Ccode class=\"language-b\">\n\u003C\u002Fcode>\u003C\u002Fpre>\n",1784240407548]