内容
# DeskMail AI
一款 **适用于 Windows 的本地、单用户桌面邮件客户端**，具有安全、内置的 Claude 连接器。您的邮件从您自己的邮件服务器获取，并在您的 PC 上本地数据库缓存；您的密码由 Windows 加密。除了与您自己的邮件服务器的连接外，**只有在您选择的情况下**，您的 Claude 信息才会离开您的机器。
> ### 👋 不熟悉编程、Claude 或 AI？
> 本 README 是为熟悉终端的人编写的。**如果您不熟悉这些**，请向下滚动到 **[针对不熟悉这些的人](#针对不熟悉这些的人)**，位于页面底部。它用简单的语言解释了这是什么以及如何运行，无需任何先前的知识。
---
## 功能
- 完整的 **IMAP/SMTP** 邮件：每个文件夹、深度历史、即时新邮件推送（IDLE）、已读/未读、标记/取消标记、移动/删除的双向同步。
- **阅读和整理**：文件夹、标签、固定/静音、延迟、跟进、规则、学习垃圾过滤器、智能视图和可选的聚焦收件箱。
- **撰写**：富文本、附件、多个签名、模板、草稿、定时发送和撤销发送。
- **日历和联系人**、搜索、附件浏览器、备份/恢复。
- 一个 **本地 Claude（MCP）连接器**，可以读取、搜索、草拟和整理您的邮件 - 但 **永远不会发送、永久删除或读取您的密码**。它甚至可以 **为您设置邮件账户**（见下文）。
完整的功能列表请参见 **[FEATURES.md](FEATURES.md)**。测试内容和已知限制请参见 **[TESTING_AND_LIMITATIONS.md](TESTING_AND_LIMITATIONS.md)**。
---
## 快速入门
**简单方式（无需编码）**：从 [Releases](../../releases) 页面下载 Windows 安装程序，运行它，然后点击 **"更多信息" → "仍然运行"**，忽略"未知发布者"警告（这是免费应用的正常情况）。然后打开 DeskMail 并添加您的电子邮件账户。
**从源码（开发者）**:
**先决条件：** Windows 10/11，[Node.js](https://nodejs.org/) 20+ 和 Git。
```bash
git clone <your-fork-url>
cd "DeskMail AI"
npm install
npm run dev # 启动应用并启用热重载
```
其他命令：
```bash
npm test # 单元测试
npm run test:e2e # 端到端测试（构建并驱动应用）
npm run build # 生产环境构建到 out/
npm run package # 构建 Windows 安装程序到 release/
```
> **安装注意：** 本项目避免原生编译 - `electron` 是一个纯下载，数据库是 WebAssembly SQLite（`node-sqlite3-wasm`），因此不需要构建工具。
---
## 连接 Claude Desktop（本地 MCP 连接器）
这是主要功能：连接 DeskMail 到 **Claude Desktop** 应用，以便 Claude 可以帮助处理您的电子邮件 - 读取、搜索、总结、草拟回复、整理，甚至设置账户。它通过 **PC 上的本地服务器** 运行，并故意限制为 **仅读取和草拟**：它 **永远不会发送邮件、永久删除任何内容、读取您的密码、更改设置或触及 DeskMail 外部的任何文件**。它编写的任何草稿都将在您的草稿中等待您审查和发送。
> **不熟悉这些？** DeskMail 有一个内置的、纯英文的逐步指南 - 打开 **设置 → Claude 连接器** 并点击 **" 新手？给我展示简单的逐步指南"**：
>
> 
### 您需要先
在同一台 PC 上安装免费的 **Claude Desktop** 应用 - 从 [claude.ai/download](https://claude.ai/download) 下载。并至少运行一次 DeskMail，以便其本地数据库存在。
### 逐步指南
**1. 在 DeskMail 中，打开设置 → Claude 连接器** 并点击 **复制**。这会复制一个包含您机器确切路径的小配置文件。
**2. 在 Claude Desktop 中，打开配置文件。** 进入 **设置 → 开发者 → 编辑配置**。这会在文本编辑器中打开一个名为 `claude_desktop_config.json` 的文件。
**3. 粘贴 DeskMail 块。** 您复制的块如下所示（您的路径会有所不同 - 始终复制应用中的实际块，而不是手动输入）：
```json
{
"mcpServers": {
"deskmail-ai": {
"command": "C:\\Program Files\\DeskMail AI\\DeskMail AI.exe",
"args": ["C:\\Program Files\\DeskMail AI\\resources\\app\\out\\main\\mcp-server.js"],
"env": {
"ELECTRON_RUN_AS_NODE": "1",
"DESKMAIL_DB": "C:\\Users\\you\\AppData\\Roaming\\deskmail-ai\\deskmail.db"
}
}
}
}
```
> **如果文件已经有其他服务器：** 它已经包含一个 `"mcpServers"` 部分。不要粘贴第二个 - 只需在现有的 `mcpServers` 对象中添加 `"deskmail-ai": { … }` 条目，并确保逗号和大括号仍然对齐（它必须保持有效的 JSON）。
**4. 保存文件。**
**5. 完全退出并重新打开 Claude Desktop**（完全退出，而不是简单地关闭窗口，然后再次启动）。
**6. 检查是否有效。** 在 Claude Desktop 聊天中，您现在应该能够使用 DeskMail 的工具。尝试询问：*"使用 DeskMail，总结我的未读邮件。"* Claude 将通过连接器读取您的邮件并回答。
### 它通过 DeskMail 本身启动
配置运行 DeskMail 的二进制文件在 Node 模式下（`ELECTRON_RUN_AS_NODE=1`），因此您 **不需要单独的 Node.js 安装**，并通过 `DESKMAIL_DB` 指向您的本地 `deskmail.db`。您的任何邮件信息都不会离开您的 PC。
### 让 Claude 为您设置电子邮件账户
连接后，您可以询问 Claude Desktop，例如 *"在 DeskMail 中设置我的 iCloud 邮件。"* Claude 查找正确的服务器设置，为您填写应用中的添加账户表单，并告诉您输入密码、运行连接测试并保存。**Claude 永远不会要求或查看您的密码** - 您只需输入这些信息。
### 故障排除
- **Claude Desktop 中没有显示工具？** 检查配置是否为有效的 JSON（缺少逗号或大括号会阻止其加载），然后完全退出并重新打开 Claude Desktop。
- **确保 DeskMail 至少运行过一次**，以便其数据库存在于 `DESKMAIL_DB` 中的路径。
- 如果您移动或重新安装了 DeskMail，请从 **设置 → Claude 连接器 → 复制** 中重新复制配置（路径会更改）。
---
## 自定义
这个应用的全部意义在于您可以用 Claude 修改它。参见 **[docs/CUSTOMISING_WITH_CLAUDE.md](docs/CUSTOMISING_WITH_CLAUDE.md)**，其中包含实际示例（"改为深蓝色主题"、"添加快捷方式到存档"、"更改阅读窗格"），每个示例都以 **您需要输入到 Claude 中的内容** 和 **如何查看其工作** 的形式编写。
如果您正在使用 Claude Code 编辑代码，根目录下的 **[CLAUDE.md](CLAUDE.md)** 告诉 Claude 应用是如何构建的以及要遵循的规则。
---
## 许可
**Apache License 2.0** - 参见 [LICENSE](LICENSE)。
简单来说：**免费和开源。** 您可以自由使用、阅读代码、修改、分享、分支和构建您自己的版本 - 您所要做的就是保留版权声明和许可。与此同时。您可以保留"DeskMail AI"名称或重命名您的分支，随您喜欢。如果您改进了它，请分享您的成果 - 这就是这个项目的初衷。
第三方依赖许可在 [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) 中。
**无保修。** 该软件涉及您的邮件和密码。它 **按原样提供，不提供任何保修**，作者 **不对因使用它而造成的任何损失或损害负责**。请自担风险，并保留自己的备份。有关诚实的威胁模型，请参见 [SECURITY.md](SECURITY.md)。
---
## 针对不熟悉这些的人
如果"终端"、"仓库"、"Node"或"MCP"这些词对您来说毫无意义，那么本节是为您准备的。这里没有任何代码假设。
**什么是 DeskMail AI？**
它是一个您在自己的 Windows 计算机上运行的电子邮件程序 - 就像 Outlook 或邮件应用一样，但它将您的电子邮件保存在 **您的** 机器上，并让 AI 助手（Claude）安全地帮助您处理它们。
**为什么我要使用它？**
- 您的电子邮件保持私密，存储在您的计算机上。它不会发送到其他地方。
- Claude 可以读取和整理您的邮件，并为您撰写草稿 - 但它 **永远不会** 单独发送任何内容或永久删除任何内容。您始终处于控制之中。
- 您可以仅通过 **询问 Claude** 来更改其外观和功能，即使您以前从未编写过一行代码。
**什么是 Claude / Claude Desktop / Claude Code？**
Claude 是由 Anthropic 制作的 AI 助手。"Claude Desktop" 是您在计算机上安装的 Claude 应用。"Claude Code" 是一个可以为您编辑文件和代码的版本。DeskMail 可以连接到两者，以便 AI 可以帮助您处理电子邮件或修改应用。
**什么是"应用密码"？**
大型电子邮件提供商（Gmail、iCloud、Outlook、Yahoo）通常不允许另一个应用使用您的正常密码登录出于安全考虑。相反，您在电子邮件账户的安全设置中创建一个特殊的、一次性使用的"应用密码"，并使用它。就像切割一个备用钥匙，只适用于一个设备。如果您要求 Claude 为您设置账户，它会在您需要时告诉您在哪里获取。
**我如何实际运行它？**
如果您不进行编码，最简单的方法：
1. 转到此项目的 **Releases** 页面（链接位于此页顶部）。
2. 下载 Windows 安装程序（以 `.exe` 结尾的文件）。
3. 运行它。Windows 可能会警告发布者未知 - 这是免费应用的预期；如果您感到舒适，请选择"更多信息" → "仍然运行"。
4. 打开 DeskMail，并手动添加您的电子邮件或要求 Claude 为您设置。
5. 要让 Claude 帮助您处理邮件，请按照上面的 **[连接 Claude Desktop](#连接-claude-desktop-本地-mcp-连接器)** 进行操作 - 如果某个步骤不清楚，应用自己的 **"新手？"** 指南会引导您完成，或者将该步骤粘贴到 Claude 中并要求它帮助您。
**安全吗？**
您的邮件和密码保留在您的 PC 上。唯一的诚实警告是，您的邮件的本地副本 **未在磁盘上加密**（您的密码已加密），因此请将您的 Windows 账户视为门锁。更多详细信息请参见 [SECURITY.md](SECURITY.md)。
