跳转至

插件内收发邮件

🔴 这一份里我的反方比方案多。 不是说不该做,是说原样做会撞上三堵墙, 而每一堵都不是加班能解决的。

你提的四件

绑定邮箱 · 收发邮件界面 · 账号密码同步到来发信漫游 · 邮件存本地 + 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。三件必须做到:

  1. 要求应用专用密码,不要主密码。 Gmail、Outlook、腾讯企业邮、阿里邮都支持。 应用专用密码可单独吊销、通常不含其它权限 —— 它和主密码不是一个量级的资产。 绑定流程里要直接教用户怎么生成(带各家的链接),而不是让他填主密码。
  2. 信封加密存储:每用户独立数据密钥(DEK),DEK 用主密钥(KMS)加密。 服务端用完即弃,不长期驻留明文。
  3. 一键解绑 + 撤销:用户随时能断,断了立刻删凭据。

⚠️ 这条做不到就别做这个功能 —— 明文存一批外贸公司的邮箱密码, 是把「用户自己的风险」变成「你会上新闻的风险」。

② 你的服务器 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 只解配额上限,不解浏览器在磁盘吃紧时的整库回收 (这句是你仓库里已有的注释,不是我现编的)。 ⇒ 邮件如果是「本地唯一副本」,丢了就是真丢了。这条要在产品上说清楚, 或者把邮件设计成「本地缓存 + 服务端为准」。

🔴 需要你拍的四件

  1. 🔴 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 在放宽的方向上动过几次)
  • 你的用户实际在用什么邮箱(这条只有你能答,也最可能变)