核心用法
Gmail Secretary（代号 Alan）是一款面向学生用户的 Gmail 智能分类与起草助手。系统通过 gog CLI 工具与 Gmail API 交互，采用 Claude Haiku 作为分类引擎，实现以下功能：
1. 收件箱抓取：triage-and-draft.sh 脚本获取未读邮件，生成结构化摘要存入 gmail-inbox-summaries.json
2. 智能分类：Haiku 代理读取摘要，结合用户背景（Stanton College Prep IB/AP 学生、FBLA/Science Fair/Mayo Clinic 项目等）进行语义分类
3. 标签应用：apply-labels.sh 根据分类结果自动应用预设标签（Urgent, Needs Reply, Waiting On, Read Later 等）
4. 草稿生成：针对需回复邮件，系统根据 voice.md 中维护的写作风格参考生成个性化回复草稿
5. 分类摘要：输出 gmail-triage.md 供用户快速浏览决策
关键安全机制：
- 明确禁止自动发送邮件，仅生成草稿
- 优先使用标签而非移动/删除操作
- 风格参考仅保留模式与脱敏片段，非完整邮件存档
显著优点
- LLM 驱动的语义分类：相比正则规则，Haiku 代理能理解邮件上下文（如区分 "Apple 公司邮件" vs "学校 Apple ID 通知"）
- 个性化标签体系：针对学生场景优化（School/Clubs/Mayo/Admin 等），支持项目制学习场景
- 语音风格学习：自动从已发邮件中提取写作风格，保持回复一致性
- 人机协同设计：关键决策点（发送、删除）保留人工确认，降低误操作风险
潜在局限
- 依赖外部 CLI 工具：
gog为第三方 Gmail CLI，稳定性与权限范围受限于该工具 - Haiku 分类成本：高频使用可能产生 API 调用费用；轻量级任务使用 Haiku 而非更小型模型
- 上下文窗口限制：单次分类需处理整批邮件摘要，量大时可能截断
- 风格参考质量波动：基于最近 50 封已发邮件采样，若近期邮件类型单一，风格参考可能偏差
适合人群
- 日均收件量 20-100 封的学生用户
- 参与多社团/项目、需要标签区分的组织型人格
- 希望保持个人写作风格、又需批量处理邮件的用户
- 对自动发送有安全顾虑、偏好草稿预览的谨慎型用户
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 权限过度 | `gog` CLI 可能请求完整 Gmail 访问权限 | 定期审查 OAuth 范围，使用最小权限原则 |
| 分类误判 | LLM 可能将重要邮件标为 Read Later | 保留 Urgent 标签人工复核流程 |
| 风格泄露 | voice.md 采样可能意外包含敏感信息 | 自动脱敏处理，人工定期检查参考文件 |
| 草稿误发 | 用户可能误将草稿当作已审阅发送 | 草稿文件明确标注 "DRAFT - REVIEW REQUIRED" |
| 缓存残留 | JSON/MD 缓存文件可能包含邮件内容残留 | 定期清理缓存目录，避免敏感信息本地堆积 |