# 邮件收件箱管理

管理已读邮件内容和处理状态。

## 目录结构

```
mailbox/
├── inbox.json           # 收件箱状态索引
├── mailbox_manager.py   # 管理脚本
├── emails/              # 邮件存储目录
│   └── <邮件ID>/
│       ├── meta.json   # 邮件元数据（主题、发件人、状态等）
│       ├── body.txt    # 邮件正文
│       └── attachments/ # 附件目录
└── archive/            # 已归档邮件
```

## 邮件状态

| 状态 | 说明 | 命令 |
|------|------|------|
| unread | 未读 | sync |
| read | 已读 | read |
| pending | 待处理 | pending |
| processing | 处理中 | processing |
| done | 已完成 | done |
| archived | 已归档 | archive |

## 使用方法

```bash
cd /home/xian/.openclaw/workspace-coder/works/mailbox

# 从 IMAP 同步未读邮件
python3 mailbox_manager.py sync

# 列出所有邮件
python3 mailbox_manager.py list

# 按状态筛选
python3 mailbox_manager.py list pending
python3 mailbox_manager.py list done

# 显示邮件详情
python3 mailbox_manager.py show 42

# 更新状态
python3 mailbox_manager.py read 42        # 标记已读
python3 mailbox_manager.py pending 42      # 待处理
python3 mailbox_manager.py processing 42   # 处理中
python3 mailbox_manager.py done 42 完成任务  # 已完成（可加备注）

# 归档邮件
python3 mailbox_manager.py archive 42
```

## 工作流建议

1. **同步邮件**: `python3 mailbox_manager.py sync`
2. **查看列表**: `python3 mailbox_manager.py list`
3. **查看详情**: `python3 mailbox_manager.py show <id>`
4. **处理邮件**: 
   - 标记为 `pending` 等待处理
   - 处理时标记为 `processing`
   - 完成后标记为 `done`（可加备注）
5. **归档**: 定期归档已完成的邮件

## AI 使用说明

扣德在处理邮件时应：
1. 先同步邮件：`sync`
2. 查看未处理邮件：`list pending` 或 `list unread`
3. 读取邮件详情：`show <id>`
4. 根据邮件内容执行任务
5. 完成后更新状态：`done <id> 处理说明`
6. 定期归档旧邮件