Email Manager 📧

停止手动检查邮件。通过 Agent 统一管理邮件。

问题所在

邮件是 Agent 错过的最重要信息来源，位居第一。缺乏集成意味着 Agent 无法感知截止日期、告警或需采取行动的消息。

Email Manager 提供了邮件集成的基础能力，采用本地 JSON 存储方案。

快速上手

查看收件箱

node skills/email-manager/email-manager.js --inbox

显示最近 10 封邮件。可指定数量：--inbox 20

查看未读邮件

node skills/email-manager/email-manager.js --inbox --unread

搜索邮件

node skills/email-manager/email-manager.js --search "project deadline"

在发件人、收件人、主题和正文内容中进行搜索。

撰写草稿

node skills/email-manager/email-manager.js --compose james@example.com "Meeting Notes" "Here are the notes..."

立即发送

node skills/email-manager/email-manager.js --compose --send james@example.com "Meeting Notes" "Here are the notes..."

查看邮件会话线程

node skills/email-manager/email-manager.js --thread thread-id-123

标记为已读

node skills/email-manager/email-manager.js --inbox --read email-id

删除邮件

node skills/email-manager/email-manager.js --inbox --delete email-id

状态概览

node skills/email-manager/email-manager.js --status

功能特性

收件箱管理

• 按时间倒序排列（最新在前）
• 支持未读邮件筛选
• 提供预览片段（前 80 个字符）
• 跟踪已读/未读状态

搜索功能

• 支持在发件人、收件人、主题和正文中搜索
• 不区分大小写匹配
• 最多返回 20 条结果

撰写与发送

• 草稿模式（保存至 emails.json）
• 发送模式（需对接 SMTP/API 实现真实投递）
• 可配置发件人地址

会话线程视图

• 按线程 ID 对消息分组
• 按时间顺序排列
• 展示完整消息历史

状态追踪

• 总邮件数
• 未读邮件数（含警告提示）
• 草稿数与已发送数

配置说明

数据文件存储路径：memory/email/

• emails.json — 邮件存储（含收件箱、草稿、已发送）
• settings.json — 发件人地址及偏好设置

覆盖默认数据目录：

--dir /path/to/data

Agent 协议规范

适用于具备邮件感知能力的操作：

1. 检查收件箱 — 在心跳周期中执行 --inbox，用于识别紧急事项
2. 主动搜索 — 使用 --search 检索与当前项目相关的关键词
3. 撰写草稿 — 使用 --compose 创建邮件草稿，发送前需人工审核
4. 确认后发送 — 使用 --compose --send 时必须获得用户明确授权
5. 线程上下文 — 使用 --thread 处理正在进行的邮件对话

集成说明

• 邮件存储基于 JSON 格式（仅限本地）
• 需集成 SMTP/API 才能实现真实邮件投递
• 可通过连接 IMAP/SMTP 或邮件 API（如 Gmail API、SendGrid 等）接入邮件服务
• 发件人地址由 settings.json 文件配置

心跳集成

请将以下内容添加至你的 HEARTBEAT.md 文件中：

### 📧 Email Check

- Run `node skills/email-manager/email-manager.js --inbox --unread`
- Only alert if urgent emails detected (look for "urgent", "deadline", "action required")

安全须知

• 邮件以明文 JSON 形式存储 —— 请确保文件权限严格限制
• 发件人地址存于 settings.json —— 请重点保护该文件
• 邮件内容未加密（如涉及敏感数据，请自行补充加密机制）

对比分析

Email Manager 在零外部依赖的前提下，提供收件箱 + 搜索 + 撰写 + 会话线程的完整能力。

设计原则

1. 零配置启动 —— 开箱即用，无需任何初始化配置
2. 零依赖 —— 纯 Node.js 实现，不依赖任何 npm 包
3. 可扩展性强 —— JSON 存储结构便于后续集成扩展
4. 高度透明 —— 所有数据均直观可见于 JSON 存储中
5. 面向 Agent 设计 —— 专为 Agent 驱动的邮件工作流而构建