文档中心

MailHelm 入门指南

设置和使用 MailHelm 所需的一切。

快速入门指南

欢迎使用 MailHelm！按照以下步骤，5 分钟内即可上手。

  1. 下载安装 — 获取适合你平台的最新版本。
  2. 创建主密码 — 这将在本地加密你的所有数据。选择一个你能记住的强密码。
  3. 添加邮箱账户 — 使用 IMAP 凭据连接你的第一个邮箱账户。
  4. 开始管理 — MailHelm 将使用规则获取和分类你的邮件。可选添加 AI 服务商进行智能兜底分类。

安装

Linux (AppImage)

# 下载 AppImage
# 添加执行权限
chmod +x MailHelm-*.AppImage

# 运行
./MailHelm-*.AppImage

AppImage 是一个自包含的软件包，适用于大多数 Linux 发行版，无需安装。无需 root 权限。

主密码

你的主密码是 MailHelm 中所有加密数据的钥匙。它通过 PBKDF2（100,000 次迭代）派生加密密钥，然后使用 AES-256-GCM 加密你的邮件凭据和其他敏感数据。

重要： 你的主密码不会存储在任何地方。如果忘记，加密数据将无法恢复。请选择一个强壮且好记的密码并妥善保存。

Groq API 密钥（推荐 — 免费）

Groq 是推荐的 AI 服务商 — 完全免费且无地区限制。以下是获取 API 密钥的方法：

  1. 前往 Groq 控制台
  2. 创建账户（免费）
  3. 点击“创建 API 密钥”
  4. 复制密钥并粘贴到 MailHelm 设置 > AI 配置中

Groq 提供慷慨的免费用量限制，全球可用无地区限制。

Gemini API 密钥（备选）

Google Gemini 是备选 AI 服务商。注意：部分地区可能有速率限制。以下是获取 API 密钥的方法：

  1. 前往 Google AI Studio
  2. 使用 Google 账户登录
  3. 点击“创建 API 密钥”
  4. 复制密钥并粘贴到 MailHelm 设置 > AI 配置中

免费 Gemini API 有慷慨的速率限制，但可用性可能因地区而异。

Claude API 密钥

  1. 访问 Anthropic 控制台
  2. 创建账户并添加计费信息
  3. 从仪表盘生成 API 密钥
  4. 粘贴到 MailHelm 设置 > AI 配置 > Claude

OpenAI API 密钥

  1. 访问 OpenAI 平台
  2. 创建账户并添加计费信息
  3. 生成新的 API 密钥
  4. 粘贴到 MailHelm 设置 > AI 配置 > OpenAI

Gmail 设置

Gmail 需要应用密码才能使用 IMAP 访问。按以下步骤操作：

  1. 启用两步验证
  2. 前往应用密码
  3. 选择"Mail"和你的设备，然后点击"生成"
  4. 复制 16 位应用专用密码

IMAP 设置：

服务器imap.gmail.com
端口993
安全SSL/TLS
用户名your@gmail.com
密码应用密码（16 位）

Hotmail / Outlook 设置

服务器outlook.office365.com
端口993
安全SSL/TLS
用户名your@outlook.com
密码你的账户密码或应用专用密码

Yahoo Mail 设置

Yahoo 也需要应用密码：

  1. 前往 Yahoo 账户安全设置
  2. 启用两步验证
  3. 生成应用专用密码
服务器imap.mail.yahoo.com
端口993
安全SSL/TLS

自定义 IMAP 服务器

MailHelm 支持任何标准 IMAP 服务器。你需要：

  • IMAP 服务器主机名和端口
  • SMTP 服务器主机名和端口（用于发送）
  • 你的用户名（通常是邮箱地址）和密码
  • 安全类型（SSL/TLS 或 STARTTLS）

Telegram \xe6\x9c\xba\xe5\x99\xa8\xe4\xba\xba\xe8\xae\xbe\xe7\xbd\xae

  1. 在 Telegram 上给 @BotFather 发消息
  2. 发送 /newbot 并按提示创建机器人
  3. 复制机器人令牌
  4. 给你的新机器人发消息以开始对话
  5. 获取你的聊天 ID
  6. 在 MailHelm 设置 > 通知 > Telegram 中输入 Bot Token 和 Chat ID

WhatsApp 设置

WhatsApp 通知需要 WhatsApp Business API。此功能在专业版和商业版中可用。

配置详情将在激活专业版或商业版许可证后在应用设置中提供。

飞书 / Lark 设置

飞书（Lark）使用 webhook URL 发送通知：

  1. 打开飞书并进入你想接收通知的群组
  2. 点击设置 > 机器人 > 添加机器人 > 自定义机器人
  3. 复制 Webhook URL
  4. 粘贴到 MailHelm 设置 > 通知 > 飞书

分类规则

MailHelm 为每个邮箱账户使用四层分类漏斗。这意味着你的工作邮箱可以有不同于个人邮箱的规则。

  • 第 1 层 — VIP 发件人 — 来自 VIP 发件人的邮件始终标记为紧急
  • 第 2 层 — 忽略规则 — 过滤订阅邮件、通知和噪音
  • 第 3 层 — 自定义规则 — 按发件人、主题或内容匹配，使用触发器/动作逻辑
  • 第 4 层 — AI 兜底 — 未匹配的邮件交给 AI 进行智能分类（可选）
  • 文件夹映射 — 将分类映射到特定 IMAP 文件夹，新分类自动创建

账户保活

保活引擎使用 Playwright 自动化基于浏览器的登录，防止账户因不活跃被停用。在设置 > 保活中按账户配置。

注意： 保活功能在专业版支持 5 个账户，商业版无限制。引擎在后台运行，随机时间间隔以模拟自然行为。

常见问题

我的数据安全吗？

是的。所有数据都存储在你的电脑上并使用 AES-256-GCM 加密。你的主密码通过 PBKDF2 派生加密密钥。我们无法访问你的数据。

MailHelm 会读取我的邮件吗？

MailHelm 通过 IMAP 获取邮件头和内容进行分类。基于规则的引擎在本地处理一切。如果启用 AI 分类，只有发件人和主题会发送给你选择的 AI 服务商。不会发送邮件正文内容。我们的服务器不存储任何数据。

可以离线使用 MailHelm 吗？

MailHelm 需要网络连接获取邮件（IMAP）。基于规则的分类无需任何外部 API。AI 分类需要网络进行 API 调用。之前获取和分类的邮件始终可从本地数据库离线访问。