邮件管理器Skill:让 AI 助手直接帮你收发、搜索和管理邮箱
- 📧 一句话定位:基于标准 IMAP/SMTP 协议的邮件管理技能,让 AI 助手具备"查看未读、搜索邮件、下载附件、发送带附件邮件"的完整邮箱操作能力。
- 📮 兼容广泛:官方详情明确支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、yeah.net、QQ 邮箱,以及任何标准 IMAP/SMTP 服务器。
- ⚙️ 配置驱动:通过
.env文件或环境变量注入邮箱凭据,无需改动代码即可切换不同邮箱账号。 - 🧰 命令行原子能力:
check、fetch、download、search、mark-read、list-mailboxes、send、test八类操作为 AI 提供清晰可组合的动作集合。 - 🔐 安全提醒内置:明确要求凭据写入
.env并加入.gitignore,并给出 Gmail 应用专用密码、163 授权码等常见坑位的处理方式。
该技能叫什么?如何下载安装 AI 技能提升开发效率?
基本信息
| 项目 | 内容 |
|---|---|
| 技能中文名 | 邮件管理器Skill |
| 技能英文名 | email-manager |
| 技能ID | 14341 |
| 图标标识 | 📧 |
| 运行依赖 | Node.js、npm(命令行二进制依赖 node、npm) |
它解决什么问题?
在没有这个技能之前,AI 助手对"邮箱"这件事基本是隔着一层玻璃的:它能帮你写邮件草稿,却不能真正把邮件发出去;它能帮你分析问题,却看不到你收件箱里那封客户来信的原文和附件。用户往往要在"AI 对话窗口"和"邮件客户端"之间反复复制粘贴,效率损耗极大。
邮件管理器Skill 把这层玻璃打穿了——它通过 IMAP 协议读取、搜索、管理邮件,通过 SMTP 协议发送邮件,把邮箱变成一个 AI 可以直接调用的"工具集"。你说"帮我看看今天有没有客户发来的报价单,把附件下载下来",AI 就能依次调用 check → search → fetch → download 完成任务。
一键安装的思路与步骤
所谓"一键安装",核心是把技能的运行环境准备好,让它能被 AI 稳定调用。按照官方技能详情,安装可以拆成四步:
- 准备前提:本机可用的 Node.js 与 npm 环境;一个已开启 IMAP/SMTP 服务的邮箱账号(163、126、QQ 等国内邮箱需先在网页端设置中开启 IMAP/SMTP 服务;Gmail 需开启两步验证并生成应用专用密码)。
- 安装依赖:在技能所在文件夹执行依赖安装命令
npm install,安装 IMAP/SMTP 相关依赖包。 - 写入配置:在 skill 文件夹中创建
.env文件,或直接设置环境变量。必须覆盖接收与发送两组共 12 个键:IMAP_HOST、IMAP_USER、IMAP_PASS、SMTP_HOST、SMTP_USER、SMTP_PASS(必备),以及IMAP_PORT、IMAP_TLS、IMAP_MAILBOX、SMTP_PORT、SMTP_SECURE、SMTP_FROM等可选键。 - 验证是否生效:先运行
node scripts/smtp.js test,它会向自己发送一封测试邮件以验证 SMTP 通道;再运行node scripts/imap.js check --limit 5,若能列出最近邮件,说明收件通道也已打通。
技能的具体分发渠道与安装入口(例如技能市场地址、是否需要付费)以官方说明为准;本文只保证上述命令与配置项来自技能详情本身。
该技能的主要功能和特点
- 未读邮件巡检(check):默认返回最多 10 封邮件,支持
--limit控制数量、--mailbox切换文件夹、--recent 30m/2h/7d只关注最近时段的新邮件,适合"每天上班先看一眼昨夜来信"这种高频轻量场景。 - 多条件邮件搜索(search):支持按未读/已读状态、发件人(
--from)、主题关键词(--subject)、时间区间(--since/--before,格式 YYYY-MM-DD)、最近时段(--recent)组合筛选,并可指定--limit(默认 20)与目标文件夹。 - 正文级读取(fetch):按 UID 拉取某封邮件的完整内容,让 AI 能够阅读邮件正文再做总结、翻译或抽取关键信息。
- 附件下载(download):支持下载某封邮件的全部附件,或用
--file <filename>精确定位单个附件,用--dir <path>指定落盘目录,避免附件散落。 - 邮件状态管理(mark-read / mark-unread):支持一次传入多个 UID 批量标记已读或未读,方便 AI 完成"处理完就归档"的收尾动作。
- 文件夹枚举(list-mailboxes):列出账号下所有可用邮箱文件夹,为后续指定
--mailbox提供依据。 - 富格式发信(send):支持纯文本正文、HTML 正文、从文件读取正文/HTML、抄送
--cc、密送--bcc、多附件--attach(逗号分隔)、多收件人(逗号分隔)、覆盖默认发件人--from。 - 连接自检(test):一条命令完成 SMTP 连通性与认证的双重验证,是排查问题的第一入口。
和普通工具比强在哪? 普通邮件客户端是给人点的,邮件管理器Skill 是给 AI 调的:所有能力都是可参数化、可组合、可脚本化的原子动作,且完全基于标准 IMAP/SMTP 协议,不绑定某一家云服务,换邮箱只需改 .env。
如何使用该技能?
以下步骤均基于技能详情提供的真实命令,可直接参考。
第 1 步:完成配置。在 skill 文件夹创建 .env,以 163 邮箱为例:
IMAP_HOST=imap.163.com
IMAP_PORT=993
IMAP_USER=your@163.com
IMAP_PASS=你的授权码
IMAP_TLS=true
IMAP_MAILBOX=INBOX
SMTP_HOST=smtp.163.com
SMTP_PORT=465
SMTP_SECURE=true
SMTP_USER=your@163.com
SMTP_PASS=你的授权码
SMTP_FROM=your@163.com
注意 163 系邮箱使用授权码而非登录密码;Gmail 则必须使用 16 位应用专用密码(详情给出的生成入口为 https://myaccount.google.com/apppasswords)。
第 2 步:检查未读邮件。
node scripts/imap.js check --limit 10 --recent 2h
输出为最近 2 小时内的邮件列表,包含可用于后续操作的 UID。
第 3 步:搜索目标邮件。
node scripts/imap.js search --from boss@company.com --recent 7d --limit 20
node scripts/imap.js search --subject 报价单 --since 2025-01-01 --mailbox INBOX
第 4 步:读取正文与下载附件。拿到 UID 后:
node scripts/imap.js fetch 1024
node scripts/imap.js download 1024 --dir ./attachments --file 报价单.xlsx
第 5 步:处理完毕标记状态。
node scripts/imap.js mark-read 1024 1025 1026
第 6 步:发送邮件。
# 简单文本
node scripts/smtp.js send --to client@example.com --subject "项目进度同步" --body "本周进度见正文"
# 带附件 + 抄送
node scripts/smtp.js send --to "a@example.com,b@example.com" --cc "manager@example.com" \
--subject "月度报表" --body "请查收附件" --attach report.pdf,data.xlsx
# HTML 正文
node scripts/smtp.js send --to user@example.com --subject "Newsletter" --html --body "<h1>Welcome</h1>"
第 7 步:异常时自检。认证失败、连接超时、TLS 错误时,先跑 node scripts/smtp.js test;确认主机名端口是否正确、账号是否用了授权码/应用专用密码、SMTP_SECURE 与端口是否匹配(465 用 true,587 用 false)。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 邮件管理器Skill(email-manager) | 面向 AI 助手的 IMAP/SMTP 工具集 | 未读巡检、多条件搜索、正文读取、附件下载、批量标记、HTML/多附件发信 | 需 Node.js 与 npm,需手写 .env 的 12 项配置,需处理授权码/应用专用密码 |
AI 工作流中的邮件读写、自动化处理、附件归集 | 优势:协议标准、跨服务商、可被 AI 组合调用;不足:无图形界面,初次配置有一定门槛,不提供邮件规则可视化编辑 |
| 传统邮件客户端(如 Foxmail、Outlook 桌面版) | 面向人的完整邮件终端 | 收发、日历、联系人、规则过滤器、离线缓存 | 下载安装即可,图形化向导配置 | 人工日常办公、需要长期阅读与整理邮件 | 优势:体验成熟、功能全面;不足:无法被 AI 直接调用,跨窗口复制粘贴效率低 |
| 通用自动化平台(如 Zapier、Make 类工具) | 无代码触发式流程编排 | 邮件触发、条件分支、对接数百种应用 | 无需写代码,但需配置触发条件与配额,高级能力通常依赖付费档位(以官方说明为准) | 固定的"收到邮件→做某事"流程 | 优势:可视化、生态广;不足:对"临时性、探索式"的邮件操作支持弱,难以让 AI 边看边决定下一步 |
| 自写 IMAP 脚本(如 Python imap-tools) | 开发者完全自定义方案 | 取决于个人实现 | 需自己写代码、自己处理编码与附件解析 | 有强定制需求的工程场景 | 优势:完全可控;不足:重复造轮子,维护成本高,难以复用给 AI 调用 |
该技能的典型应用场景与实际体验情况
场景一:开发者的"AI 邮件秘书"
角色是独立开发者或小团队工程师,痛点是每天被大量通知类邮件干扰,却又要盯住少数关键邮件(如服务器告警、客户询价)。使用方式是让 AI 先跑 check --recent 2h 列出新邮件,再用 search --from alert@xxx.com 精确定位,最后 fetch 读正文总结。实际体验:上手难度中等,难点集中在首次 .env 配置;配置完成后日常几乎零成本,效果是把"翻邮箱"压缩成一句自然语言请求。注意点:告警类邮件往往高频,建议始终带 --limit 或 --recent,避免一次拉回过多内容。
场景二:运营/销售的邮件检索与附件归集
角色是商务或运营,痛点是要在海量历史邮件里找"某客户三个月前发的那份合同附件"。使用方式是 search --from 客户邮箱 --since 2025-01-01,拿到 UID 后 download <uid> --dir ./contracts。实际体验:多条件组合搜索明显优于客户端的手动翻页;附件下载支持单文件精确定位,不会把整封邮件的杂项附件都拖下来。注意点:不同服务商的文件夹命名不同,先用 list-mailboxes 确认目标文件夹名再传 --mailbox。
场景三:批量通知与报表分发
角色是项目负责人,痛点是每周要把报表发给多人并抄送主管。使用方式是 send --to "a@x.com,b@x.com" --cc manager@x.com --attach report.pdf --body "本周报表请查收"。实际体验:一次命令完成多收件人、抄送、附件三件事,比自己点开客户端省下数分钟;HTML 正文能力也让格式化的周报可以直接发送。注意点:首次发信前务必先 node scripts/smtp.js test 验证通道,避免正式邮件因认证问题静默失败。
场景四:多邮箱统一调度
角色是需要同时管理个人 Gmail、公司 Outlook 与国内 163 邮箱的用户。使用方式是维护多套 .env 配置,按需切换后调用同一批命令。实际体验:因为全部走标准协议,命令完全一致,学习成本只付一次。注意点:Gmail 必须使用应用专用密码并开启两步验证;163/126 系列必须使用授权码;这些凭据文件要加入 .gitignore,切勿提交到代码仓库。
该技能能为用户带来的价值
效率层面:把"打开客户端 → 找到文件夹 → 翻页 → 点开邮件 → 下载附件"这一串人工动作,压缩为 AI 的一次工具调用组合。一次典型的"查未读 + 找邮件 + 下附件"操作,原本需要数分钟的手工点击,现在只需描述需求即可完成。
门槛层面:用户不需要懂 IMAP 协议、不需要写解析邮件 MIME 结构的代码,只要把 .env 填好,剩下的交给 AI。技能内置了常见服务商的主机与端口对照(163、126、188、yeah.net、Gmail、Outlook、QQ 邮箱),把最容易出错的"填端口"环节标准化了。
自动化与长期价值:所有能力都是命令行原子动作,天然适合被编排进更大的工作流——例如"每天早上检查未读 → 摘要 → 处理完批量 mark-read"。由于基于标准协议而非某家云 API,账号迁移、服务商更换都不会导致技能失效,配置一次、长期复用。
安全层面:技能明确要求把凭据存放在 .env 并加入 .gitignore,并区分了 Gmail 应用专用密码与 163 授权码的正确用法,降低了把主密码硬编码进脚本的风险。
常见问题 FAQ
Q1:怎么安装?需要准备什么?
需要三样东西:Node.js 与 npm 环境、一个已开启 IMAP/SMTP 服务的邮箱账号、正确的凭据(163 用授权码,Gmail 用应用专用密码)。安装时在技能文件夹执行 npm install 安装依赖,然后创建 .env 并填写 IMAP_HOST、IMAP_USER、IMAP_PASS、SMTP_HOST、SMTP_USER、SMTP_PASS 等配置,最后用 node scripts/smtp.js test 与 node scripts/imap.js check 验证是否生效。具体分发渠道与安装入口以官方说明为准。
Q2:这个技能收费吗? 技能详情本身未涉及任何定价信息,是否收费、是否有使用额度限制需以官方说明为准。可以确定的是,它基于标准 IMAP/SMTP 协议工作,邮件收发不依赖第三方商业网关,因此不产生额外的中间服务费用。
Q3:为什么 Gmail 一直提示认证失败?
Gmail 不接受常规账号密码登录。需要先在 Google 账号中开启两步验证,再到应用专用密码页面生成 16 位应用专用密码,并把该密码填入 IMAP_PASS 与 SMTP_PASS。163/126 系列同理,必须使用授权码,且需先在网页端设置中开启 IMAP/SMTP 服务。
Q4:它和 Foxmail、Outlook 这类邮件客户端有什么区别?该选谁? 邮件客户端是给人操作的可视化终端,适合长时间阅读、整理和长期归档;邮件管理器Skill 是给 AI 调用的工具集,适合"让 AI 帮你查、帮你读、帮你发、帮你下附件"的自动化场景。两者并不冲突——日常大量阅读仍可用客户端,重复性、探索性的邮件操作交给技能,效率提升最明显。
Q5:支持哪些邮箱?公司自建邮箱能用吗?
详情明确支持 163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com、yeah.net、Gmail、Outlook、QQ 邮箱,以及任何标准的 IMAP/SMTP 服务器。公司自建邮箱只要能提供 IMAP/SMTP 主机、端口与账号凭据,就可以按同样的方式配置;若使用自签名证书,把 IMAP_REJECT_UNAUTHORIZED 或 SMTP_REJECT_UNAUTHORIZED 设为 false 即可。