插件内收发邮件¶
🔴 这一份里我的反方比方案多。 不是说不该做,是说原样做会撞上三堵墙, 而每一堵都不是加班能解决的。
你提的四件¶
绑定邮箱 · 收发邮件界面 · 账号密码同步到来发信漫游 · 邮件存本地 + AI 翻译/识别/辅助回复
墙一:扩展自己开不了 TCP —— 但这不等于必须走你的服务器¶
已取证的部分¶
IMAP / SMTP 是 TCP 协议,而 Chrome 扩展(MV3)没有 raw socket:
chrome.sockets.tcp/chrome.socket是 Chrome Apps(Platform Apps) 的 API,已废弃- Direct Sockets API(TCPSocket/UDPSocket)只开放给 Isolated Web Apps, 官方文档明确写了限制在 IWA, 理由是那套环境有强制 CSP + 跨源隔离,扩展没有
- WebSocket / WebTransport / WebRTC 都要对端配合握手,IMAP 服务器不会配合
⇒ 「扩展进程内直接连 IMAP」确实做不到。 这一句成立。
🔴 但初版方案的推论是错的(2026-09-17 订正)¶
初版写「⇒ 所以必须你的服务器中转」——漏了 Native Messaging。
Native Messaging 在 MV3 仍然支持(只是后台侧要在 service worker 里用): 扩展可以和一个装在用户本机的程序双向通信,而那个程序能开 TCP。
⚠️ 更难堪的是:这条路在 SPEC-022-mcp 里已经写了(用于 MCP), 却没被用到本文来 —— 同一个事实出现在两处,只用了一处。
修正后的四条路¶
| 路 | 怎么做 | 凭据在哪 | 你的成本 | 用户代价 |
|---|---|---|---|---|
| A. OAuth + 厂商 API | Gmail API / Graph | 厂商(token) | 0 | 只支持 Gmail/Outlook + 审核门票 |
| B. 你的服务器中转 | 扩展 → 你的服务器 → IMAP | 🔴 你的服务器 | 服务器 + IP 声誉 | 零安装 |
| D. Native Messaging 本地代理 | 扩展 ↔ 本地程序 → IMAP | ✅ 用户本机 | 0 | 装一个本地程序 |
| C. 只做手动 | 扩展只导出话术 | —— | 0 | 不是你要的功能 |
🔴 D 把「墙二」整个消掉了¶
墙二(凭据托管)之所以是这条线最高危的部分,前提是凭据必须进你的服务器。 走 D 就不存在这个前提:
- 邮箱密码 / 应用专用密码只存在用户自己的机器上
- IMAP/SMTP 连接从用户自己的 IP 发出 ⇒ 你的服务器 IP 不会被各家邮箱服务商限流
- 你零服务器成本、零凭据责任
代价只有一个:用户要装一个本地伴侣程序(跨平台打包、签名、自动升级)。
🔴 而这个代价可以三件事分摊¶
同一个本地程序可以同时解决三个架构难题:
本地伴侣程序
├─ IMAP/SMTP 代理 ← 本文(凭据不出本机)
├─ MCP server ← SPEC-022(Claude 直接查数据)
└─ WhatsApp 长连接维持 ← SPEC-020(绕开 SW 30 秒回收)
装一次,解决三个。 这改变了三份方案的成本结构 —— 单看邮件,「让用户装个程序」是个大门槛;三件合起来看,它是一次性投资。
仍然成立的限制¶
⚠️ Service Worker 30 秒回收:如果走 B 或 A,收信只能轮询,做不到「新邮件即时弹出」。 走 D 的话,长连接由本地程序维持,这条限制也一并消掉(本地程序可以常驻、可以 IMAP IDLE)。
🔴 墙二:邮箱密码同步到云端 —— 只在走 B 时成立¶
⚠️ 2026-09-17 订正:本节的全部论证都建立在「凭据必须进你的服务器」这个前提上。 走上面的 D(Native Messaging 本地代理) 就没有这个前提 —— 凭据留在用户本机,本节整个不适用。
下面的内容只在你决定走 B(服务器中转)时才要读。
原文(走 B 时成立)¶
「账号密码同步来发信漫游」意味着:用户的邮箱密码存在你的服务器上。
这跟你现在存的任何东西都不是一个量级:
| 现在存的 | 邮箱密码 | |
|---|---|---|
| 泄露后果 | 采集数据外泄 | 对方邮箱被完全接管(连带重置其它账号) |
| 用户能自救吗 | 能(重采) | 要改密码 + 查所有关联服务 |
| 你的法律暴露 | 低 | 高 |
⇒ 如果走 A(OAuth),根本不需要存密码:存的是可撤销的 token,用户随时能在 Google 后台断开。 这是 OAuth 相对密码的全部意义。
我的建议:不存密码。要漫游就漫游 OAuth token,不漫游密码。 (而 token 漫游同样要加密存储 + 绑定设备,那是另一套工程。)
🔴 订正(Tony 2026-09-17):「不上架所以不存在」只消掉一堵墙¶
Tony 指出这个插件不上架(手动 unpacked 分发)。那确实消掉一件事,但只有一件:
| 跟「上不上架」有关吗 | 结论 | |
|---|---|---|
| Chrome Web Store 审核 | ✅ 有关 | 确实不存在 |
| Google OAuth 的 restricted scope 审核 | ❌ 无关 | 它是 Google Cloud Console 层面的,跟怎么分发扩展无关 |
| GDPR / CAN-SPAM | ❌ 无关 | 法律责任跟分发方式无关 |
| 投递声誉 | ❌ 无关 | 只跟「发信走谁的服务器」有关 |
OAuth 那条为什么仍是硬墙¶
gmail.readonly 属于 Google 的 restricted scope。未经验证的 app:
- 能用,但有 100 个用户的硬上限("测试"模式)
- 超过就必须走验证:OAuth 同意屏幕审核 + 隐私政策 + 演示视频, restricted scope 还可能要第三方安全评估(CASA)
⚠️ 这个扩展是商业产品,不是自用工具 —— 仓库里有付费商品(goodsType: 'mapVip')、
VIP 到期日、客服入口、多组织(apiAccountOrgs)。⇒ 用户数必然超过 100。
所以 OAuth 这条路的门票是真的要买的,而且周期最长。 如果不想买这张票,就只剩「你的服务器中转 IMAP/SMTP」这条路 —— 那就回到墙二(密码)。
🔴 墙三:产品性质会变¶
你现在是数据采集工具 —— 采到的邮箱怎么用是用户的事。 一旦内置发信,产品变成群发工具,法律定位不同:
- GDPR / CAN-SPAM:对采集来的地址群发,合规责任从「用户」转移了一部分到「提供发信能力的工具」
- Gmail/Outlook 的政策:用 OAuth 拿到发信权限后大量外发,触发风控的是用户的邮箱账号 —— 他被封,会来找你
- 投递声誉:如果走 B(你的服务器中转发信),你的 IP 段的发信声誉由所有用户共同决定, 一个用户乱发,全体投递率下降
🔴 Tony 定案(2026-09-17):不走 OAuth,走 IMAP/SMTP¶
「不走 OAuth 所以不存在你说的」「我希望能绑定所有支持 imap 和 smtp 的邮箱」
这条选择是对的,而且理由很硬:外贸客户大量使用企业自建邮箱 (腾讯企业邮 / 阿里邮 / 自建 Exchange),OAuth 只覆盖 Gmail + Outlook —— 覆盖不到的那部分正好是付费意愿最强的那部分。
⇒ 原本据此定为 B(你的服务器中转)。
🔴 但 2026-09-17 取证后发现还有 D(Native Messaging 本地代理), 它同样支持任意 IMAP/SMTP 邮箱,而且凭据不出用户本机、你零服务器成本。 ⇒ B vs D 这个选择重新打开,需要你重新拍。 对比见上一节的四路表。
本节余下部分(凭据托管 / IP 声誉 / 投递声誉)只在走 B 时适用。
换掉了什么¶
| 原来的墙 | 走 IMAP/SMTP 后 |
|---|---|
| Google OAuth restricted scope 审核(100 用户上限、CASA 评估) | ✅ 不存在了 |
| 只能支持 Gmail / Outlook | ✅ 不存在了,任何 IMAP/SMTP 邮箱都能绑 |
🔴 换来了什么(三件,都要设计)¶
① 凭据托管 —— 这是这条路唯一的高危资产
必须存用户的邮箱凭据才能代他连 IMAP/SMTP。三件必须做到:
- 要求应用专用密码,不要主密码。 Gmail、Outlook、腾讯企业邮、阿里邮都支持。 应用专用密码可单独吊销、通常不含其它权限 —— 它和主密码不是一个量级的资产。 绑定流程里要直接教用户怎么生成(带各家的链接),而不是让他填主密码。
- 信封加密存储:每用户独立数据密钥(DEK),DEK 用主密钥(KMS)加密。 服务端用完即弃,不长期驻留明文。
- 一键解绑 + 撤销:用户随时能断,断了立刻删凭据。
⚠️ 这条做不到就别做这个功能 —— 明文存一批外贸公司的邮箱密码, 是把「用户自己的风险」变成「你会上新闻的风险」。
② 你的服务器 IP 会被各家邮箱服务商盯上
几百个用户的扩展,每 5 分钟拉一次 IMAP ⇒ 你的 IP 段在持续高频连接 Gmail/Outlook/腾讯的 IMAP 服务器。这些服务商有连接频率风控。
⇒ 要设计:按用户错峰(不是所有人整点同时拉)、指数退避、 出口 IP 池(一个 IP 被限不影响全部用户)。
③ 投递声誉 —— 订正我之前的判断
初版方案说「走你的服务器中转会让你背投递声誉」,那句只对一半:
| 发信方式 | 声誉在谁那 |
|---|---|
| 你的服务器替用户连他自己的 SMTP 发 | 用户的邮箱服务商(邮件从他的域出去) |
| 你的服务器用自己的 SMTP 发 | 你 |
⇒ 只要坚持用用户自己的 SMTP 凭据发,投递声誉就不在你这边。 这条要写死在设计里 —— 不能为了「发得快一点」而改用自己的发信通道。
修正后的第一版范围¶
原方案建议「只做读」是基于 OAuth 审核难度。那个理由没了,但另一个理由还在:
🔴 发信让产品从「数据工具」变成「群发工具」(墙三仍然成立,与 OAuth 无关)。
⇒ 建议仍然是读先上、写跟后,但理由变了: 不是审核卡住,而是先用只读版验证「AI 帮你读懂回复」这个价值成不成立 —— 如果成立,发信是水到渠成;如果不成立,发信功能只会加速用户被标垃圾。
我的建议:拆成两步,先做「读」¶
第一步:只读 + AI(低风险、能马上验证需求)¶
绑定邮箱(OAuth,只要读权限)
→ 拉回复邮件(轮询,比如 5 分钟一次)
→ 存本地 IndexedDB
→ AI:翻译 / 提炼「对方在问什么」/ 给一版回复草稿
→ 🔴 草稿复制到剪贴板,用户去他自己的邮箱发
为什么这样值得做:外贸最痛的不是发,是发出去之后回复看不懂、回得慢。 只读的 AI 助手把这块吃下来了,而且:
- OAuth 只要
gmail.readonly—— 审核难度比发信权限低一个档 - 不存密码
- 不碰投递声誉
- 产品性质还是「工具」,不是「群发器」
第二步:等第一步验证了再考虑发¶
如果用户真的每天在用第一步,再来谈发信 —— 那时候你有数据支撑投入, 也有真实用户反馈告诉你该支持哪些邮箱。
存储要先算一笔账¶
你已经有:2 万+ 商家 + 整页 Markdown(unlimitedStorage 权限就是为它加的,
注释里估算 30,000 行 × 25.7 KB ≈ 771 MB)。
再加邮件正文:一封往来邮件平均 5-20 KB,一个活跃外贸业务员一年几千封 ⇒ 几十到上百 MB。
⚠️ unlimitedStorage 只解配额上限,不解浏览器在磁盘吃紧时的整库回收
(这句是你仓库里已有的注释,不是我现编的)。
⇒ 邮件如果是「本地唯一副本」,丢了就是真丢了。这条要在产品上说清楚,
或者把邮件设计成「本地缓存 + 服务端为准」。
🔴 需要你拍的四件¶
- 🔴 B 还是 D?(不走 OAuth 已定,但「谁来连 IMAP」重新打开)
| B 你的服务器中转 | D 本地伴侣程序 | |
|---|---|---|
| 用户安装 | 零 | 要装一个程序 |
| 邮箱凭据 | 存你的服务器(要 KMS + 信封加密) | 不出本机 |
| 你的服务器成本 | 有 | 0 |
| 被邮箱服务商限流 | 你的 IP 会 | 不会(用户自己的 IP) |
| 收信实时性 | 只能轮询(SW 30 秒回收) | 能 IMAP IDLE |
| 出问题时排查 | 你能看到日志 | 在用户机器上,难 |
⇒ 我押 D,理由是它把「托管一批外贸公司的邮箱密码」这个责任整个去掉了, 而那是这条产品线唯一会让你上新闻的风险。 代价(装个程序)可以和 SPEC-022-mcp、SPEC-020-whatsapp 三件分摊。
⚠️ 反方要认真听:装本地程序对普通外贸业务员是真门槛 —— Windows 上要处理杀软误报、Mac 上要签名公证、企业电脑可能没安装权限。 如果你的用户画像是「连 Chrome 扩展都要教着装」的,D 就不成立。 这条只有你能判断。 2. 第一版只做读,还是读写一起做? 我押只做读。 3. 邮件存本地还是存云? 只读方案下,本地就够(丢了能重拉)。 4. ~~OAuth 审核要不要买票?~~ 不买了,走 IMAP/SMTP。 ⇒ 新的第 4 问:绑定流程里怎么教用户生成应用专用密码? 这是整个功能的第一道门槛 —— 如果这一步劝退,后面做得再好也没人用。 各家的入口都不一样(Gmail 要先开两步验证、腾讯企业邮在管理后台、阿里邮在设置里), 这是一份要认真写的用户面文档,不是一句提示能带过的。
🔴 Tony 拍板:这一批先不做(2026-09-17)¶
「这些只是梳理,先不做,因为是大版本了…我们先把现在的功能完善,但是产品要写」
⇒ 本 SPEC 保持 draft,作为产品设计存档。
后续启动时,先回头核这几件事有没有变:
- Google 对 restricted scope 的政策(每年都在收紧)
- MV3 的 Service Worker 生命周期(Chrome 在放宽的方向上动过几次)
- 你的用户实际在用什么邮箱(这条只有你能答,也最可能变)