技能使用指南

email-manager(邮件管理器)Skill 是什么?如何下载安装并收发邮件?

邮件管理器Skill(email-manager)让 AI 助手直接收发、搜索邮件并下载附件,兼容 Gmail、Outlook、163、126、QQ 邮箱等主流服务商。本文详解 npm 安装、.env 配置、八类命令用法与竞品对比,附高频问题排查,助你快速把邮箱接入 AI 工作流。

邮件管理器Skillemail-manager
8 个章节 约 17 分钟阅读 AI 智能生成

邮件管理器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 稳定调用。按照官方技能详情,安装可以拆成四步:

  1. 准备前提:本机可用的 Node.js 与 npm 环境;一个已开启 IMAP/SMTP 服务的邮箱账号(163、126、QQ 等国内邮箱需先在网页端设置中开启 IMAP/SMTP 服务;Gmail 需开启两步验证并生成应用专用密码)。
  2. 安装依赖:在技能所在文件夹执行依赖安装命令 npm install,安装 IMAP/SMTP 相关依赖包。
  3. 写入配置:在 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 等可选键。
  4. 验证是否生效:先运行 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 即可。