核心用法
Gmail Secretary (Alan) 是一款专为高中学业场景设计的邮件分类自动化工具，通过Haiku轻量级LLM实现智能邮件分流。系统采用「抓取→分析→标注→反馈」四步闭环：首先通过triage-and-draft.sh抓取收件箱内容并生成结构化摘要；随后Haiku代理基于学生身份上下文（IB/AP课程、FBLA/Science Fair等社团、Mayo Clinic科研项目）对邮件进行分类决策；结果写入gmail-triage-labels.json后，由apply-labels.sh调用gog CLI执行标签应用；最终生成可视化分类报告gmail-triage.md供用户查阅。
标签体系覆盖学生典型场景：Urgent（紧急事务）、Needs Reply（待回复）、Waiting On（等待跟进）、Read Later（新闻订阅/促销）、Receipt/Billing（账单）、School（学业相关）、Clubs（社团事务）、Mayo（科研项目）、Admin/Accounts（账户安全）。分类规则明确区分商业邮件与学校事务，账户安全类邮件独立归档。
草稿生成功能基于voice.md中的风格参考（从已发送邮件自动采样提取），生成拟人化回复建议，但强制限制为草稿状态，需用户手动确认发送。
显著优点
1. 学生场景深度定制：内置Stanton College Prep学生身份画像，识别IB/AP课业、多社团并行、科研项目的复合邮件场景，分类准确率显著优于通用工具
2. 安全架构严谨：通过「仅草稿+人工确认」机制彻底杜绝误发风险；标签操作可逆，避免不可逆的删除/移动操作
3. 轻量高效：选用Haiku级LLM平衡成本与延迟，适合高频次的日常邮件处理
4. 风格一致性：自动学习用户历史发送习惯，保持沟通语气统一
潜在缺点与局限性
- 依赖外部CLI：
gog工具需单独配置OAuth授权，初始化门槛较高 - 分类颗粒度固定：9个预设标签无法灵活扩展，特殊场景（如实习申请、大学招生）需人工调整
- 无实时同步：需手动触发脚本刷新，非持续监控模式
- 隐私集中化：邮件摘要需经过LLM处理，虽使用轻量模型仍存在数据离开本地风险
适合人群
- IB/AP高中生：社团事务与课业并行的复杂收件箱管理
- 科研参与学生：需要区分学术合作邮件与日常事务
- Gmail重度用户：日均收件量>20封、依赖标签管理的效率导向者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 误分类 | Haiku可能将紧急社团通知误判为Read Later | 每日查看triage.md digest，Urgent标签人工复核 |
| 草稿泄露 | 风格参考文件包含真实邮件片段 | voice.md采用脱敏采样，仅保留句式模式 |
| OAuth凭证 | `gog` CLI需存储Gmail API令牌 | 建议配置应用级密码，定期轮换 |
| 本地缓存 | 邮件摘要JSON留存磁盘 | 路径限定在`/home/delta/.openclaw/workspace/cache/`，建议配置tmpfs或定期清理 |
安全等级说明
本工具虽涉及邮件数据外理至LLM，但采用最小化原则：仅传输摘要而非全文，使用轻量Haiku模型，且禁止任何写操作至Gmail发送功能。核心风险可控，适合个人生产力场景。