武汉大学邮箱终端管理工具 (whu-mail-manager)

一个用于在命令行中使用武汉大学邮箱收发邮件的 CLI 工具。

如果你想：

• 在终端给你的AI 搭子（比如Coze机器人、OpenClaw机器人）发送邮件让它干活
• 或者甚至你想用Claude Code、Qoder给你的AI搭子发布命令（比如让它搜索信息，毕竟在国内Claude Code的Web Search功能会被墙），然后以邮件形式获得它返回的运行结果

你会发现：

• 常用的163、QQ邮箱在终端配置起来很麻烦
• 武大邮箱登录配置非常简单，适合你的折腾愿景

安装

方式一：从 npm 安装（推荐）

npm install -g whu-mail-manager

方式二：从 GitHub 安装

npm install -g github:suye0620/WHUMailManager

方式三：本地开发

git clone https://github.com/suye0620/WHUMailManager.git
cd MailManager
npm install
npm link

⚠️ 注意: 需要 Node.js 14.0.0 或更高版本

命令行用法

1. 配置账号

whu-mail config <邮箱> <密码>
# 示例: whu-mail config yourname@whu.edu.cn yourpassword

2. 发送邮件

whu-mail send -t <收件人> -s <主题> -c <内容>
# 示例: whu-mail send -t recipient@example.com -s "测试" -c "你好"

3. 接收邮件（查看最新5封）

whu-mail receive
whu-mail inbox

输出示例：

--- 收件箱 ---

显示最近 5 封邮件 (共 100 封):

[1] 项目进度更新
    发件人: colleague@company.com
    时间: 2026/4/14 10:30:00
    预览: 本周项目进度汇报如下，已完成大部分开发工作...

[2] 会议邀请
    发件人: manager@company.com
    时间: 2026/4/13 15:00:00
    预览: 诚邀您参加下周一的项目评审会议...

4. 查看发件箱（最近5封）

whu-mail sent
whu-mail outbox

输出示例：

--- 发件箱 ---

显示**最近** 5 封已发送邮件 (共 20 封):

[1] 工作汇报
    收件人: supervisor@company.com
    时间: 2026/4/14 09:00:00

[2] 项目方案
    收件人: team@company.com
    时间: 2026/4/13 14:30:00
    预览: 附件为本周的项目方案文档，请各位查阅...

5. 读取邮件详情

whu-mail read <编号>
# 示例: whu-mail read 1
# 编号对应 receive 命令显示的邮件列表编号

输出示例：

--- 读取邮件 ---

=== 邮件内容 ===

主题: 项目进度更新
发件人: colleague@company.com
收件人: yourname@whu.edu.cn
时间: 2026/4/14 10:30:00

--- 内容 ---

本周项目进度汇报：

1. 已完成前端页面开发
2. 后端 API 接口开发中
3. 预计下周完成测试

请查阅，谢谢！

6. 测试连接

whu-mail test

7. 显示帮助

whu-mail help

8. 交互式模式（无参数）

whu-mail
# 直接运行进入交互式菜单

功能特性

• ✅ 发送邮件（SMTP）
• ✅ 接收邮件（查看最新5封，预览截断到200字）
• ✅ 查看发件箱（最近5封）
• ✅ 读取邮件详情（支持 HTML 渲染）
• ✅ 查看邮箱文件夹列表
• ✅ 测试 SMTP/IMAP 连接
• ✅ 交互式配置界面
• ✅ 命令行操作支持
• ✅ MIME 编码中文解码
• ✅ HTML 邮件转纯文本
• ✅ 时间本地化显示（北京时间）
• ✅ 统一的收件箱/发件箱预览格式

武大邮箱服务器信息

服务	主机	端口	加密
SMTP	smtp.whu.edu.cn	465	SSL/TLS
IMAP	imap.whu.edu.cn	993	SSL/TLS

配置文件

配置文件保存在 ~/.whu-mail/config.json

技术栈

• Node.js
• nodemailer (SMTP)
• imap-simple (IMAP)
• mailparser (邮件解析)
• inquirer (交互式界面)
• chalk (终端着色)
• html-to-text (HTML 转纯文本)

更新日志

v1.1.0 (2026-04-14)

• 🐛 修复 seqNo 未定义 bug
• 🐛 修复配置文件路径在某些环境下为 undefined 的问题
• 🐛 修复 read 命令无法读取指定邮件的问题
• 🐛 修复发件箱 getBoxes 方法不可用的问题
• ✨ 新增发件箱查看功能 (whu-mail sent)
• ✨ 预览内容截断从 100 字扩展到 200 字
• ✨ 时间格式改为中文本地化显示
• ✨ 统一收件箱和发件箱的预览格式

注意事项

1. 开启 IMAP/SMTP 服务: 使用前请先登录武大邮箱网页版，在设置中确保 IMAP/SMTP 服务已开启。

2. 密码安全: 配置文件会保存你的邮箱密码，请妥善保管。

3. 网络要求: 确保能访问武大邮箱服务器。

License

MIT