Haven邮件与AI聊天:ProtonMail桥接协议与自托管大模型对话完整指南
Haven邮件与AI聊天:ProtonMail桥接协议与自托管大模型对话完整指南
Haven 是一款免费的 Android SSH、VNC、RDP 与 SFTP 客户端,但它远不止远程终端工具——内置的邮件客户端可以直接读取 ProtonMail 与任意 IMAP/SMTP 邮箱,AI 聊天功能则能连接你自托管的大模型(Ollama、llama-server、vLLM 等)进行流式对话。本文将带你快速上手 Haven 的邮件与 AI 聊天两大特色功能,理解其背后的 ProtonMail 桥接协议与多协议 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 支持是移动端少见的差异化能力。它的工作路径是:
- Go 桥接登录:内置的 Go 语言 mailbridge(基于
go-proton-api与gopenpgp,随libgojni.so一起打包)完成 SRP 登录,必要时再走两步验证(TOTP); - 密钥环解锁:用邮箱密码换取解密密钥,
saltedKeyPass仅驻留内存、绝不持久化; - 拉取并解密:列文件夹、列消息、取消息时,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 聊天值得第一时间体验。
