one-mail

统一管理多个邮箱的CLI工具。配置文件存储在~/.onemail/目录下。

初始化

首次使用时，运行setup命令添加账户：

bash
bash scripts/setup.sh

收取邮件

bash
bash scripts/fetch.sh # 收取所有账户邮件
bash scripts/fetch.sh --unread # 仅收取未读邮件
bash scripts/fetch.sh --account gmail # 指定账户
bash scripts/fetch.sh --query AI agent # 搜索邮件
bash scripts/fetch.sh --limit 10 # 限制数量

阅读邮件

bash
bash scripts/read.sh --id --account
bash scripts/read.sh --account outlook --latest
bash scripts/read.sh --account gmail --query MacBook
bash scripts/read.sh --json # JSON格式输出

发送邮件

bash
bash scripts/send.sh \
--to recipient@example.com \
--subject Hello \
--body Email content

指定账户 + 附件

bash scripts/send.sh \ --account outlook \ --to recipient@example.com \ --subject Report \ --body See attachment \ --attach /path/to/file.pdf

注意：Outlook附件大小限制为3MB。

账户管理

bash
bash scripts/accounts.sh list # 列出所有账户
bash scripts/accounts.sh add # 添加账户
bash scripts/accounts.sh remove # 删除账户
bash scripts/accounts.sh set-default # 设置默认账户

统计信息

bash
bash scripts/stats.sh

提供商要求

提供商	认证方式	前置条件
Gmail	OAuth 2.0	需要gogCLI工具
Outlook

OAuth 2.0 (Graph API) | 需要Mail.ReadWrite + Mail.Send权限 | | 网易163 | IMAP/SMTP | 需要开启IMAP并使用应用密码 | | 网易126 | IMAP/SMTP | 需要开启IMAP并使用应用密码 |

依赖项

必需：curl、jq、python3。可选：gog（Gmail OAuth认证）。

故障排除

遇到认证或连接问题时，请参考troubleshooting.md。