one-mail

# 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 <message_id> --account <name>
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 <account_id>    # 删除账户
bash scripts/accounts.sh set-default <id>       # 设置默认
```

## 统计

```bash
bash scripts/stats.sh
```

## 提供商要求

| 提供商 | 认证方式 | 前置条件 |
|--------|----------|----------|
| Gmail | OAuth 2.0 | 需要 `gog` CLI |
| 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](references/troubleshooting.md)。

# one-mail - 统一邮箱管理工具

[English](./README.en.md) | 中文

一个命令行工具，用于统一管理多个邮箱账户（Gmail、Outlook、网易邮箱 163/126）。

## 安装

### 方式 1：通过 ClawHub 安装（推荐）

```bash
# 安装
clawhub install one-mail

# 初始化配置
bash scripts/setup.sh
```

### 方式 2：手动安装

```bash
# 克隆仓库
git clone https://github.com/huangbaixun/one-mail.git
cd one-mail

# 初始化配置
bash scripts/setup.sh
```

## 快速开始

### 1. 初始化配置

```bash
bash scripts/setup.sh
```

按照提示添加你的邮箱账户。

### 2. 收取邮件

```bash
# 收取所有账户的邮件
bash scripts/fetch.sh

# 只看未读邮件
bash scripts/fetch.sh --unread

# 搜索邮件
bash scripts/fetch.sh --query "AI agent"

# 指定账户
bash scripts/fetch.sh --account gmail
```

### 3. 发送邮件

```bash
# 使用默认账户发送
bash scripts/send.sh \
  --to "recipient@example.com" \
  --subject "Hello" \
  --body "Email content"

# 带附件
bash scripts/send.sh \
  --to "recipient@example.com" \
  --subject "Report" \
  --body "See attachment" \
  --attach "/path/to/file.pdf"
```

## 支持的邮箱

### Gmail
- ✅ 收取邮件
- ✅ 发送邮件
- ✅ 附件支持
- ✅ 搜索过滤
- 依赖：`gog` CLI（已配置）

### Outlook
- ✅ 收取邮件
- ✅ 发送邮件
- ✅ 附件支持（< 3MB）
- ✅ 搜索过滤
- 依赖：Microsoft Graph API

### 网易邮箱 (163.com / 126.com)
- ✅ 收取邮件
- ✅ 发送邮件
- ✅ 附件支持
- ✅ 搜索过滤
- ✅ IMAP ID 支持（自动发送客户端标识）
- 依赖：Python 3 + imaplib
- 163 服务器：imap.163.com / smtp.163.com
- 126 服务器：imap.126.com / smtp.126.com

## 配置文件

配置文件位于 `~/.onemail/`：

- `config.json` - 账户配置
- `credentials.json` - 敏感凭证（600 权限）

## 账户管理

```bash
# 列出所有账户
bash scripts/accounts.sh list

# 添加新账户
bash scripts/accounts.sh add

# 删除账户
bash scripts/accounts.sh remove --name outlook

# 设置默认账户
bash scripts/accounts.sh set-default --name gmail

# 测试账户连接
bash scripts/accounts.sh test --name gmail
```

## 高级用法

### 定时检查邮件

添加到 crontab：

```bash
# 每小时检查一次未读邮件
0 * * *...