核心用法
email-163-com 是一款针对 163 邮箱的完整命令行邮件管理工具,基于 Python 实现,采用标准 IMAP/SMTP 协议通信。核心功能覆盖邮件生命全周期:发送(纯文本/HTML/多附件)、读取(支持 IMAP ID 认证)、搜索(按发件人/主题/日期)、文件夹管理(创建/删除/列表)以及邮件操作(删除/移动/标记已读未读)。配置通过 ~/.config/email-163-com/config.json 完成,需使用 163 邮箱"客户端授权码"而非登录密码,支持 TLS/SSL 加密连接和环境变量覆盖。
显著优点
1. 协议合规性强:原生支持 163 邮箱强制的 IMAP ID 扩展(RFC 2971),避免 "Unsafe Login" 拦截,兼容性优于通用邮件客户端
2. 功能完整性高:覆盖收发、搜索、附件下载、文件夹管理等全流程,输出格式友好(带 emoji 的视觉化列表)
3. 零依赖部署:纯 Python 标准库实现,无需额外安装包
4. 自动化友好:命令行接口设计清晰,支持脚本集成和批量操作
潜在缺点与局限性
1. 单服务商锁定:仅针对 163 邮箱优化,其他邮箱(Gmail/Outlook/QQ 等)可能因 IMAP ID 策略差异无法直接使用
2. 凭证管理风险:配置文件明文存储授权码,虽建议 chmod 600 但缺乏原生密钥环集成
3. 无 OAuth 支持:依赖静态授权码,不支持 163 邮箱的 OAuth2 流程,安全性落后于现代标准
4. 无交互式配置:首次使用需手动编辑 JSON 配置文件,无引导式初始化向导
适合人群
- 需要批量处理 163 邮件的开发者/运维人员
- 希望将邮件操作集成到 CI/CD 或自动化脚本的用户
- 偏好命令行效率、拒绝 GUI 邮件客户端的技术用户
- 需自动化发送监控报告、日志文件等场景
常规风险
- 凭证泄露:配置文件权限配置不当可能导致授权码被其他用户读取
- 误操作不可逆:
delete --all等批量操作无二次确认机制 - 网络拦截:虽启用 TLS,但证书验证配置错误或中间人攻击仍存在理论风险
- 授权码过期:163 授权码有有效期,自动化任务可能因凭证失效中断