DispatchMail：一个由AI驱动的本地电子邮件助手

DispatchMail是一个开源的AI电子邮件助手，它在本地计算机上运行，帮助用户管理他们的电子邮箱。 该项目的设计理念是让AI作为人类的协作伙伴，共同处理邮件。它通过连接到用户的电子邮件账户（目前支持Gmail），根据用户设定的提示词（prompt）来监控和处理邮件。DispatchMail的核心功能是利用AI（当前通过OpenAI API）自动执行邮件分类、归档、生成草稿等任务。它提供了一个在本地运行的网页界面，用户可以在这个界面上管理邮件、审查AI生成的草稿和指令。所有数据都存储在本地的SQLite数据库中，确保了用户的隐私和数据安全。该项目目前处于早期alpha原型阶段，主要面向希望尝试和修改的开发者，并欢迎社区提供反馈和贡献。

功能列表

• AI邮件处理: 通过连接OpenAI，根据用户自定义的指令自动处理邮件。
• 本地网页界面: 提供一个本地运行的web应用来管理收件箱、草稿和AI的指令。
• 邮件过滤规则: 用户可以自定义白名单规则，精确控制AI能访问和处理的邮件范围，规则可以基于发件人、主题关键字或自然语言描述。
• 自动生成草稿: AI可以根据指令自动撰写邮件回复的草稿。
• 邮件自动处理: 能够自动为邮件添加标签或进行归档整理。
• 本地数据存储: 用户的邮件内容、凭证和配置都存储在本地的SQLite数据库中，不依赖云服务。
• 发件人深度分析: 可利用大语言模型对发件人进行深入的背景信息研究。

使用帮助

DispatchMail是一个为开发者设计的早期原型项目，需要一定的技术背景才能成功安装和运行。以下是详细的安装和使用步骤。

前期准备

在开始安装之前，请确保你的系统满足以下条件：

1. Python: 版本需要为 3.8 或更高。
2. Node.js: 版本需要为 16 或更高，用于运行Web界面。
3. Gmail 账户: 你的Gmail账户必须开启两步验证（2FA）。
4. OpenAI API 密钥: 你需要一个OpenAI账户并生成API密钥，因为AI功能依赖于此。

安装流程

1. 克隆代码库:
   打开终端（命令行工具），使用git命令将项目代码从GitHub克隆到你的本地电脑。

   git clone https://github.com/dbish/DispatchMail.git
   cd DispatchMail
   

2. 运行安装脚本:
   项目提供了一个便捷的安装脚本setup.py，它会自动完成大部分设置工作。

   python setup.py
   

   这个脚本会执行以下操作：

   • 安装所有Python后端依赖。
   • 初始化本地的SQLite数据库（dmail.db）。
   • 创建一个示例配置文件。
   • 引导你完成账户的基本设置。
3. 配置凭证:
   • 配置OpenAI API密钥: 找到并打开文件 web-app/api/credentials.py，将你的OpenAI API密钥填入其中。

     OPENAI_API_KEY = 'your-openai-api-key'
     

   • 配置Gmail应用密码: 由于开启了2FA，你不能直接使用你的Gmail登录密码。你需要为DispatchMail生成一个专用的“应用密码”。
     • 访问你的Google账户安全页面：https://support.google.com/mail/answer/185833
     • 在“应用密码”部分，选择“邮件”作为应用，选择“其他（自定义名称）”作为设备，然后为它命名（例如，“DispatchMail”）。
     • Google会生成一个16位的密码，请立即复制并妥善保管。这个密码将用于后续的账户设置中。

启动服务

DispatchMail由一个后端API和一个前端界面组成，你需要分别启动它们。

• 选项A：使用启动脚本（推荐）
  项目提供了一个start.py脚本，可以一次性启动所有需要的服务。

  python start.py
  

• 选项B：手动启动服务
  如果你想更好地控制或进行调试，可以手动启动。你需要打开两个终端窗口。
  • 终端 1: 启动后端API

    cd web-app
    python api/api.py
    

    默认情况下，后端API会运行在 http://localhost:5000。

  • 终端 2: 启动前端界面

    cd web-app
    npm run dev
    

    前端开发服务器会运行在 http://localhost:5173。

使用方法

1. 设置邮箱账户:
   服务启动后，在浏览器中打开 http://localhost:5173。你会看到一个设置界面，在这里输入你的Gmail地址、IMAP服务器地址 (imap.gmail.com) 和你刚刚生成的16位应用密码。
2. 配置邮件过滤规则:
   在Web界面的设置区域，你可以配置白名单，决定哪些邮件可以被AI处理。这可以防止AI处理所有邮件，保护你的隐私。你可以根据发件人地址、邮件主题中的关键词或者使用自然语言来设定规则（例如，“只处理来自同事的邮件”）。
3. 自定义AI提示词 (Prompt):
   这是DispatchMail最核心的部分。你需要告诉AI如何分析和处理你的邮件。
   • 阅读提示词 (Reading Prompt): 指导AI如何阅读和理解邮件内容。例如，你可以让AI判断邮件的紧急程度、总结邮件要点、或者提取邮件中的任务。
   • 草稿提示词 (Draft Prompt): 指导AI如何为你生成回复草稿。例如，“如果邮件是会议邀请，就生成一个接受邀请的礼貌回复”。
4. 处理邮件:
   设置完成后，系统会自动从你的Gmail账户获取新邮件。符合白名单规则的邮件会被发送到OpenAI进行处理。处理完成后，你可以在Web界面看到AI生成的标签、摘要或回复草稿。你可以审核、修改并发送这些草稿。

应用场景

1. 自动邮件分类和摘要
   对于每天收到大量邮件的用户，可以配置DispatchMail来阅读所有新邮件，根据内容（如项目名称、发件人关系）自动添加标签，并为长邮件生成一句话摘要，帮助用户快速了解邮件核心内容，决定处理的优先级。
2. 初步回复自动化
   对于客户支持或销售团队，可以设定规则，让AI自动回复常见的客户问询。例如，收到关于产品价格的邮件时，AI可以根据预设的草稿提示词，自动生成一封包含价格表链接的邮件草稿，等待人工审核后一键发送。
3. 任务和信息提取
   研究人员或学生可以使用DispatchMail来监控订阅的学术通知邮件。可以设定AI指令，要求其从邮件中提取出截稿日期、会议地点、论文主题等关键信息，并整理成固定格式，方便用户统一记录。
4. 作为开发者的AI实验平台
   对于想学习和探索AI Agent应用的开发者，DispatchMail提供了一个完整的本地运行环境。开发者可以直接修改agent.py文件，尝试不同的语言模型、调整AI的思考逻辑链（Chain-of-thought），或者集成新的工具，把它作为一个理想的AI应用开发试验场。

QA

1. 这个项目是免费的吗？
   DispatchMail项目本身是开源免费的。但是，它依赖OpenAI的API来提供AI功能，所以你需要支付使用OpenAI API所产生的费用。
2. 我的邮件数据安全吗？
   该项目的一大特点是所有数据都存储在你的本地电脑上的SQLite数据库里，包括你的邮件内容和账户凭证。数据不会上传到任何第三方云服务器，从而保证了隐私安全。但你需要注意保护好本地存储的credentials.py文件和数据库文件。
3. 为什么我需要使用“应用密码”而不是我的Gmail密码？
   因为你的Gmail账户开启了两步验证（2FA），这是一种安全措施。应用密码是Google为需要在非官方应用中登录账户的用户提供的一次性密码，它让应用可以访问你的数据，而无需你暴露你的主密码，从而提高了安全性。
4. 项目目前处于什么阶段？可以用于日常生产环境吗？
   该项目目前处于早期的Alpha原型阶段。它主要是为喜欢折腾的开发者设计的，功能可能不稳定，不建议直接在重要的生产环境中使用。