邮件助手（Youjian Assistant）
收件箱的待办打捞员。核心信条：邮件台账可以粗，待办一条不能漏——已过期标红排最前，3 天内标黄，「把…发给我」这种隐性请求也跑不掉。
核心能力（M1–M3）
| 模块 | 能力 | 说明 |
|---|---|---|
| M1 | 批量解析台账 | 目录里 .eml/.txt/.md 邮件全读一遍：主题/发件人/收件人/日期/附件清单自动入表，eml 编码主题（=?UTF-8?B?...?=）自动解码，100 封约 1 秒 |
| M2 | 待办提取 | 正文里「请/麻烦/请于/务必/把…发给我」类祈使句全拎出；截止日期解析成真实日期（明天/下周三/月底/N天后，以收件日期为锚），已过期标红、3 天内标黄 |
| M3 | 批量改名归档 | 按「日期_发件人_主题」规范重命名，按月分文件夹；默认 dry-run 先出计划表，加 --do 执行且复制不移动——原件永远不动，重名拒绝执行 |
工作流：台账 → 待办 → 归档
- 扫描（scan）：邮件目录丢进来，台账+待办清单一次出全。
- 办事：待办清单按优先级排序，过期的先清；每条可戳回来源邮件。
- 归档（archive）：dry-run 看计划，确认后 --do 复制归档，按月分文件夹。
能力边界与免责声明
- 只做提取提醒：待办是从正文规则提取的线索，请以邮箱原文为准复核。
- 待核对不瞎编：版式太野的邮件标「待核对」，由人补录。
- 原件零风险：归档只复制不移动；台账不修改任何源文件。
- 纯本地处理：邮件是商务机密——你的收件箱，不出你的电脑。
文件结构
youjian-assistant/
├── SKILL.md
└── scripts/
├── main.py # 统一入口：scan / archive
├── common.py # 断点、重试、日志、人话报错
├── mail_parse.py # M1 eml/txt 解析 + RFC2047 主题解码 + 附件清单
├── todo_extract.py # M2 待办提取 + 截止日期锚定（收件日期为锚）
├── mail_scan.py # 批量主控 + Excel 报告
├── rename_arc.py # M3 改名归档（dry-run + --do）
└── report.py # Excel 报告输出（过期标红/紧急标黄）
示例命令
# 批量解析 + 待办提取
python scripts/main.py scan 邮件目录 -o 邮件台账.xlsx
# 改名归档：先出计划，确认后执行（复制不移动）
python scripts/main.py archive 邮件目录 -o 归档计划.xlsx
python scripts/main.py archive 邮件目录 -o 归档计划.xlsx --do
与家族联动
- 邮件里夹着发票 → 交给「发票管家」（票据台账+查重）
- 邮件里躺着简历 → 交给「简历筛选官」（JD 硬性筛选）
- 外贸客户邮件里躺单证 → 交给「外贸单证通」（三单核对）
安全承诺
纯本地处理，零外部数据传输。邮件是商务机密——你的收件箱，不出你的电脑。
