分类: 工具与效率 | 上传者: 
邮件处理工具（基于 IMAP）。搜索、读取、下载附件、移动邮件。 触发场景： - 用户需要查看、搜索、管理邮件 - 用户需要下载邮件附件 - 用户需要移动、归档邮件 - 用户提到"邮件"、"邮箱"、"收件箱"、"附件" --- # 邮件处理 Skill 基于 IMAP 协议的邮件 CLI 工具。Python 3.13+ 必需。 ## 首次使用 运行 `init` 命令交互式创建配置： ```bash python3 scripts/email_tool.py init ``` 会依次询问： 1. 配置文件保存路径（默认 `email_config.toml`，保存在当前项目目录） 2. 账户名（默认 `qqmail`） 3. 邮箱地址、IMAP/SMTP 服务器信息 4. 密码/授权码 结果： - 非敏感信息写入配置文件（如 `email_config.toml`） - 密码追加到项目 `.env` 文件（不覆盖已有内容） - 自动将 `.env` 加入 `.gitignore` - 自动测试 IMAP 连接 ## 配置说明 **配置文件**（非敏感，可提交到仓库）： ```toml [accounts.qqmail] email = "[email protected]" imap_host = "imap.qq.com" imap_port = 993 ``` **项目 .env 文件**（敏感，已 gitignore）： ``` EMAIL_QQMAIL_PASSWORD=your_app_password ``` 环境变量命名规则：`EMAIL_{ACCOUNT}_PASSWORD`，ACCOUNT 为账户名大写。 配置文件模板位于 `config/accounts.template.toml`。 ## 脚本路径 相对于 skill 安装目录：`scripts/email_tool.py` 所有命令在**项目目录**下执行（`.env` 和配置文件从 cwd 读取）。 ## 命令速查 | 命令 | 用途 | 示例 | |------|------|------| | `init` | 交互式初始化配置 | `email_tool.py init` | | `folders` | 列出所有文件夹 | `email_tool.py folders` | | `list` | 搜索列出邮件 | `email_tool.py list --subject "发票" --last 5` | | `read` | 读取邮件内容 | `email_tool.py read --uid 12345` | | `download` | 下载附件 | `email_tool.py download --subject "发票" --ext pdf --output-dir /tmp` | | `move` | 移动邮件 | `email_tool.py move --subject "账单" --target-folder "账单" --yes` | | `search-links` | 从 HTML 提取链接 | `email_tool.py search-links --subject "京东"` | ## 通用参数 - `--config PATH`：配置文件路径（默认 `email_config.toml`，相对于 cwd） - `--account NAME`：账户名（默认 qqmail） - `--subject TEXT`：主题关键词搜索 - `--sender TEXT`：发件人搜索 - `--since DD-Mon-YYYY`：起始日期（如 `01-Jan-2026`） - `--before DD-Mon-YYYY`：截止日期 - `--last N`：只处理最新 N 封 ## 命令详情 ### init - 初始化配置 ```bash email_tool.py init # 或指定配置路径 email_tool.py --config my_email.toml init ``` 交互式询问账户信息，自动： - 创建配置文件（非敏感信息） - 将密码追加到 `.env`（不覆盖已有内容） - 将 `.env` 加入 `.gitignore` - 测试 IMAP 连接 ### list - 列出邮件 ```bash email_tool.py list --subject "发票" email_tool.py list --sender "jd.com" --last 3 email_tool.py list --subject "报告" --folder "工作" ``` 输出 JSON 包含 `uid`、`sub
更新日志: Source: GitHub https://github.com/zrong/skills
还没有评论，快来第一个发言吧。