Email Sentinel · 邮件哨兵

概述

一句话：批量验证邮箱有效性，避开无效 / 陷阱 / 一次邮箱，提升触达率。

它是什么

Email Sentinel 是一个已商用的邮箱验证服务，运行在自有中转层（Cloudflare Worker + D1），背后聚合多家上游验证引擎的能力，但对外不暴露任何上游品牌名。你看到的是一个干净、统一、可计费的 API。

生产状态（2026-09-07 更新）：

• ✅ 支付宝 A402 真实收单已开通，实测多笔 ¥29.90 到账
• ✅ 电脑网站支付开通：付款页直跳支付宝官方收银台（render.alipay.com），买家扫码即付
• ✅ 手动入账兜底 /v1/check-payment：直接问支付宝真实状态入账（异步 notify 失败也能量化入账）
• ✅ 支付成功页 /v1/pay-success：买家付款后回到支付页有"我已付款"按钮自助理单
• ✅ Phase 1 幂等：5 分钟内同 user+package 复用未完成订单，停止幽灵单循环
• ✅ 全链路客服邮箱 service@authoritylinker.com（402 账单、错误响应、付款页全覆盖）

适用场景：

配额

套餐 ID 就是 1k 和 1500（传给 buy_quota 的 package_id）。不要硬编码——用 sentinel_account_status 读 packages[] 拿实时列表。

工具

⚠️ 给 Agent 的执行约定（务必遵守）

这一节决定了这个 SKILL 在不同 agent runtime 里能不能正常工作。详见[references/agent-integration.md](references/agent-integration.md)。

1. 退出码语义（v0.5.0 起）

HTTP 402 不是错误。 它是 A402 协议的第一步——服务端开出账单等待付款。v0.4.1 及更早版本在 402 时 exit 1，导致把非零退出码判为工具调用失败的 runtime（Manus、多数 LangChain shell、n8n Execute Command 等）直接丢弃 stdout，付款链接永远到不了用户手里。v0.5.0 已修正。

2. 付款链接必须原样透传给用户

任何脚本输出里出现 action_required.pay_url 时，agent 必须把这个 URL原样展示给用户，作为可点击链接。同一个链接也会以纯文本形式写到 stderr，方便只取摘要的 runtime 抓取。

不要改写、不要缩短、不要用 markdown 把它藏进一个词里、不要"代替用户付款"。支付这一跳只能由持有支付宝的真人完成。

3. 任何异常都要把客服邮箱展示给用户

脚本在所有非正常结果（失败、付款未到账、需要用户操作）里都会返回support 字段。agent 必须把 support.email 和 support.sla 原样展示给用户，有订单号时一并附上。健康调用不带这个字段，不用画蛇添足。

遇到问题？联系 service@authoritylinker.com，我们会在 24 小时内回复您。

请附上订单号 out_trade_no，我们能立即定位。

绝不能让一个已经付了钱的用户走到死胡同却找不到人。

4. 付款后不要假设已到账

用户说"我付了"不等于钱到了。必须调 sentinel_check_payment 确认，或重新拉 sentinel_account_status 看 purchased_quota 是否真的涨了。check_payment 返回 buyer_pay_amount: "0.00" 表示支付宝侧显示未实付。

付款流程（无 A402 客户端的 agent）

1. buy_quota '{"package_id":"1k"}'
   → exit 0, HTTP 402, action_required.pay_url
2. 把 pay_url 给用户 → 用户浏览器打开 → 支付宝收银台 → 扫码付款
3. 付完自动跳 /v1/pay-success，异步 notify 通常几秒内入账
4. 若未到账：check_payment '{"out_trade_no":"ES..."}'
   → exit 0 = 已入账 / exit 2 = 未到账，按 note 提示处理
5. account_status '{}' 确认 purchased_quota 已增加
6. 任何一步出错 → 展示 service@authoritylinker.com，24 小时内回复

有原生 A402 能力的 agent（如 WorkBuddy）可直接走buy_quota '{"package_id":"1k","confirm":true,"payment_proof":"...","out_trade_no":"..."}'。

安装

# WorkBuddy / SkillHub 一键
skillhub install email-sentinel

# 手动
unzip email-sentinel-1.0.0.zip -d ~/.claude/skills/email-sentinel/
export EMAIL_SENTINEL_API_KEY="es_xxx..."

# 或跑安装脚本
bash scripts/install/install.sh        # macOS / Linux
scriptsinstallinstall.bat            # Windows

注册时务必绑定邮箱：signup.mjs '{"email":"you@example.com"}'。email: null 的账户在 key 丢失后无法找回，已购配额一并作废。

安全与隐私

• API key 仅以 sha256 哈希存储在中转层 D1，原始 key 只在签发时返回一次。
• 本 Skill 不接触、不存储、不上传任何邮箱正文（仅发送邮箱字符串到上游验证）。
• 中转层抽象了上游品牌，避免第三方涨价 / 倒闭直接影响业务。
• 每次扣减写入 usage_log，可自行审计。

FAQ

Q：怎么付款？我没有支付宝 A402 客户端。A：不需要。购买配额时（如「购买 1000 配额」），返回的 402 响应带 pay_url 字段——用浏览器打开即自动跳转支付宝官方收银台（render.alipay.com），扫码或登录付款即可，付完额度自动到账。有 A402 能力的 agent（如 WorkBuddy）则直接弹支付卡完成付款。

Q：我付了款但额度没到账，怎么办？A：先等 30 秒（异步通知可能有延迟），然后访问 https://api.authoritylinker.com/v1/pay-success?out_trade_no=<订单号>，点「我已付款」按钮即可手动入账。手动入账直接向支付宝查询真实状态，只要支付宝侧显示已付款，一定会到账。如果仍未到账，发邮件到 service@authoritylinker.com（24 小时内回复），附上订单号 out_trade_no。

Q：和直接用 REOON / ZeroBounce / NeverBounce 比有什么区别？A：Email Sentinel 加了一层中转 + 配额管理 + 统一计费 + 隐藏第三方品牌，适合不想操心基建、要给下游团队或客户分发配额的场景。直连上游意味着自行处理多厂商切换、配额核算、计费一致性等工程问题。

Q：免费额度用完后还能不能试用？A：每日 UTC 00:00 自动到账 500 次。够轻度使用；批量场景建议直接购买。

Q：购买后额度会过期吗？A：付费配额包永久有效，直到用完。

Q：能开发票吗？A：支付宝 A402 个人开发者通道暂不支持开票。如需企业月结 / 增值税专票 / API 接入 / 定制 SLA，请联系：sentinel@authoritylinker.com。

已知问题（v1.0.0 已修复 · 历史清算）

v1.0.0 发布前最后一批已修复的 5 个服务端问题（2026-09-07 全部修复并部署）：

⚠️ 待核实：1500 套餐（service_id API_161744F7846B4B83）尚未经过真实支付验证，建议实测一笔 ¥50 确认资金链路；1k 套餐（API_46E7E4D96B4243F4）已由真实首单 ¥29.90 验证通过。

支持

遇到任何问题，邮件联系 service@authoritylinker.com，我们会在 24 小时内回复您。请附上订单号 out_trade_no，我们能立即定位。

• 客服邮箱：service@authoritylinker.com（24 小时内回复，买卖双方都可见）
• 企业/开票/定制 SLA：sentinel@authoritylinker.com
• API：https://api.authoritylinker.com
• 状态页：https://api.authoritylinker.com/healthz

风险与合规

• 上游引擎故障时调用会失败（已自动 refund 配额）。
• 上游对 gov.cn / mil / edu 等域的 SMTP 检测可能受限，结果为 unknown，请勿用于合规关键决策。
• 单任务 ≤50,000 条，超出请分批，避免上游 rate-limit。
• 验证结果仅供决策参考，不构成 PII 合规建议。