Haven邮件与AI聊天:ProtonMail桥接协议与自托管大模型对话完整指南

原创2026-10-14 04:43:551,422 阅读

Haven邮件与AI聊天:ProtonMail桥接协议与自托管大模型对话完整指南

Haven 是一款免费的 Android SSH、VNC、RDP 与 SFTP 客户端,但它远不止远程终端工具——内置的邮件客户端可以直接读取 ProtonMail 与任意 IMAP/SMTP 邮箱,AI 聊天功能则能连接你自托管的大模型(Ollama、llama-server、vLLM 等)进行流式对话。本文将带你快速上手 Haven 的邮件与 AI 聊天两大特色功能,理解其背后的 ProtonMail 桥接协议与多协议 AI 路由设计。

Haven 邮件客户端与 AI 聊天功能概览

一、Haven 是什么:不止是 SSH 客户端

Haven 把"连接"统一成一种抽象:无论 SSH、VNC、RDP、SFTP,还是邮件和AI 端点,都保存为带类型的连接配置文件(profile),共用同一套隧道路由(WireGuard、Tailscale、SOCKS 等)、端口敲击(port knocking)与单包公告(SPA)安全链。

这种设计带来两个直接好处:

  • 📧 邮件可走隧道:邮箱流量可以经由你的隧道中转,甚至做"失败即关闭"(fail-closed)——隧道不可达时宁可连接失败,也不泄露明文流量;
  • 🤖 AI 端点可走隧道:私网里的自托管大模型(比如局域网里的 Ollama),通过隧道从手机直接对话。

官方功能说明见 docs/features/email.md 与 docs/features/chat.md。

二、Haven 邮件客户端:两种引擎,一条消息管线

Haven 的邮件能力位于独立的 core/mail/ 核心模块与 feature/mail/ 界面模块,背后是"一个 MailClient 抽象 + 两个引擎"的架构:

引擎 适用邮箱 读 写 特点
ProtonMail Proton 邮箱(免费版即可) ✅ ⏳ 规划中 Go 桥接协议 + 原生 PGP 解密
通用 IMAP/SMTP Gmail、iCloud、Fastmail、自托管 Dovecot 等 ✅ ✅ 标准协议,支持应用专用密码

两者统一收敛到同一套 MIME 解析(Apache Mime4j),渲染纯文本正文、不加载远程图片与脚本,读信更安全。

2.1 ProtonMail 桥接协议是如何工作的

Haven 的 ProtonMail 支持是移动端少见的差异化能力。它的工作路径是:

  1. Go 桥接登录:内置的 Go 语言 mailbridge(基于 go-proton-api 与 gopenpgp,随 libgojni.so 一起打包)完成 SRP 登录,必要时再走两步验证(TOTP);
  2. 密钥环解锁:用邮箱密码换取解密密钥,saltedKeyPass 仅驻留内存、绝不持久化;
  3. 拉取并解密:列文件夹、列消息、取消息时,Go 侧直接把密文消息解密成标准 MIME 交给 Kotlin 侧解析。

核心实现见 ProtonMailClient.kt 与 Go 桥接 mailbridge.go,完整的方案设计记录在 EMAIL.md。

2.2 通用 IMAP/SMTP 引擎:发信与写信

通用引擎由 ImapMailClient.kt 实现,走 JVM 侧 JavaMail:

  • 收信:IMAP 993(默认隐式 TLS),消息 ID 采用 folderId:UID 编码;
  • 发信:SMTP 465(隐式 TLS)或 587(STARTTLS),发送成功后尽力归档到 Sent 文件夹;
  • 写信界面:全屏撰写 + 回复 / 全部回复 / 转发,多账号时通过"From"行切换发信账号。

⚠️ 小贴士:开启两步验证的 Gmail、iCloud、Yahoo 邮箱需要先生成应用专用密码再填入 Haven。

2.3 安全链:隧道路由 + SPA / 端口敲击

邮件连接会复用 Haven 的全套预连接安全机制:若 profile 配置了隧道,Proton 引擎经 localhost SOCKS5 端点中转,IMAP/SMTP 引擎则注入隧道的 SocketFactory。关键点是失败即关闭——官方实测中把邮件 profile 指向一个"黑洞隧道"时,连接直接失败,绝不会悄悄回落到明网。

三、AI 聊天:连接自托管大模型的最快方法

Haven 的 AI 聊天位于 feature/chat/ 界面模块与 core/openai/ 核心模块。一个 AI 端点就是一个连接 profile:主机、端口、可选路径前缀(如 CLIProxyAPI 的 /api)与可选 API Key(加密存储)。

3.1 支持四种线协议

协议选择见 AiProtocol.kt,请求构造与流式解析见 OpenAiClient.kt:

协议 线格式 典型服务器
OpenAI 兼容 /v1/chat/completions + SSE llama-server、vLLM、CLIProxyAPI
Ollama 原生 /api/tags + /api/chat(NDJSON) Ollama
Anthropic Messages API /v1/messages(SSE) Claude API
Gemini generateContent(x-goog-api-key) Gemini API

点击连接时,Haven 会先拉取服务端模型列表做验证(密钥错误、路径前缀写错、隧道不通都会被区分提示),聊天界面的模型选择器只列出服务端真实上报的模型——连接前先探活,避免"连上了却不能用"。

3.2 隧道路由与"失败即关闭"

AI 端点支持两种互斥的路由层(OpenAiRoute.kt):

  • AI 路由载体:借助某个 SSH 会话的本地端口转发或 Reticulum 网格桥接,把私网大模型暴露为 127.0.0.1:<port>;
  • 隧道穿透:与其他传输一致的 WireGuard / Tailscale / SOCKS 路由。

两者都遵循同一契约:已配置但不可解析的路由拒绝拨号,绝不回落到直连——你特意配置的加密路径,不会在故障时被静默绕过。

3.3 实用功能:视觉、剪贴板与加密存档

  • 视觉输入:每条消息最多附带 4 张图(相册或相机),发送前自动缩放重编码,1200 万像素照片不会变成 12 MB 请求体(ChatAttachSheet.kt);
  • 剪贴板双向互通:长按气泡复制文本/图片,新回复下方有一键"复制上一条回复",剪贴板有图时输入框出现粘贴按钮;
  • 会话存档:默认会话随连接生命周期而丢弃;打开存档开关后,全部消息(含附件与模型名)写入应用数据库并加密存储,关闭开关即删除。

四、进阶:让 MCP 智能体同时驾驭邮件与 AI

Haven 内置 MCP(Model Context Protocol)智能体桥,邮件与 AI 聊天都对其开放(完整工具清单见 docs/mcp-tools.md):

工具 作用
list_mail_folders / list_mail_messages 只读列出文件夹与消息
read_mail_message 读取并解析单封邮件(Proton 邮件自动解密)
send_mail 发送纯文本邮件,每次调用都需用户同意并记入连接日志
openai_chat / openai_list_models 不经界面直接对已连接端点跑一次补全

这意味着你可以对智能体说"把收件箱里昨天的发票附件存到 SFTP 上的目录"或"用本地大模型帮我总结这封邮件"——create_mail_rule 等邮件规则工具还能让智能体自动撰写收件自动化规则(匹配条件 + 动作序列,敏感动作进入待批准队列)。

五、模块路径速查

关注点 路径
邮件核心(会话管理 / 双引擎) core/mail/
ProtonMail 客户端 ProtonMailClient.kt
邮件 Go 桥接 rclone-android/go/mailbridge/
邮件方案设计文档 EMAIL.md
AI 客户端与流式解析 OpenAiClient.kt
AI 路由策略 OpenAiRoute.kt
聊天界面 feature/chat/
邮件 / AI 功能文档 docs/features/email.md、docs/features/chat.md

总结

Haven 用"统一连接 + 安全链"的思路,把两件看似不相干的事做到了同一个 App 里:邮件——ProtonMail 走 Go 桥接协议原生解密、通用 IMAP/SMTP 可发可收;AI 聊天——四种协议直连自托管或 API 大模型,隧道不可用就果断失败。两者再叠加 MCP 智能体工具,手机就同时成了你的加密邮箱、大模型对话入口和自动化枢纽。如果你想要一款免费、开源、不依赖云账号的 Android 远程办公工具,Haven 的邮件与 AI 聊天值得第一时间体验。

登录后查看全文
Haven