核心用法
email-163-com 是一个针对 163 邮箱的 Python 命令行邮件管理工具,实现了完整的邮件生命周期管理。核心功能包括:
邮件发送:支持纯文本、HTML 格式,可附加单个或多个文件,支持从文件读取正文内容。
邮件读取:基于 IMAP 协议(含 RFC 2971 ID 扩展),可读取指定文件夹、数量,查看完整邮件内容及附件列表。
文件夹管理:列出、创建、删除邮箱文件夹(如自定义分类)。
邮件搜索:按发件人、主题等条件组合搜索,支持结果数量限制。
邮件操作:删除、移动到指定文件夹、标记已读/未读状态。
附件管理:查看邮件附件列表,下载到指定目录。
显著优点
- 完整功能覆盖:涵盖收发、管理、搜索、附件处理等邮件全场景需求
- 163 邮箱深度适配:原生支持 IMAP ID 扩展(RFC 2971),解决 163 邮箱的特殊认证要求
- 安全传输:默认使用 TLS/SSL 加密连接(IMAP 993/SMTP 465 端口)
- 中文友好:完整支持中文主题、发件人、文件夹名称
- 配置灵活:支持 JSON 配置文件与环境变量两种方式
- 命令行友好:输出格式清晰,带 emoji 标识,便于脚本集成
潜在缺点与局限性
- 单邮箱限制:仅针对 163 邮箱优化,其他邮箱服务商可能无法直接使用
- 授权码门槛:必须使用 163 网页版生成的"客户端授权码",非普通登录密码,增加初次配置复杂度
- 无图形界面:纯命令行工具,对非技术用户不够直观
- 本地配置风险:密码存储于本地明文 JSON 文件,虽有权限建议(chmod 600),但仍存在泄露风险
- 依赖手动配置:需手动编辑配置文件,无交互式首次设置向导
适合人群
- 需要自动化邮件处理的技术用户、开发者
- 偏好命令行工作流的效率用户
- 需要在服务器/无头环境管理 163 邮箱的运维人员
- 需要批量处理邮件、附件的办公自动化场景
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | 授权码明文存储于本地配置文件 | 设置 600 权限,考虑使用环境变量 |
| 中间人攻击 | 虽使用 TLS/SSL,但需确保证书验证未被禁用 | 使用官方标准端口 993/465 |
| 误操作删除 | 命令行操作不可逆,可能误删重要邮件 | 操作前先用 `read`/`search` 确认 |
| 附件安全风险 | 下载附件可能包含恶意文件 | 下载后使用杀毒软件扫描 |
| 配置错误导致锁定 | 多次认证失败可能触发账户保护 | 确认授权码正确,非登录密码 |