电子邮件智能代理
状态：第0阶段-宪法初始化 创建: 2026-02-12 Ralph v2项目：宪法自治发展 上下文：个人生产力工具（不用于工作）
______________________________________________________________________
项目概述
首要目标：为Claude Desktop构建一个个人电子邮件分流系统，作为MCP服务器，自主管理多个电子邮件帐户（Gmail+个人M365）。
不是工作项目 -我在微软有WorkIQ，负责处理工作电子邮件分类。这是为了我的个人生活。
为什么是这个项目？
基于OpenClaw研究（Nate B.Jones分析）， 电子邮件管理是排名第一的技能 拥有5705+社区技能。用户迫切需要自主的收件箱管理。
关键洞察一位OpenClaw用户在两天内通过代理清除了4000封电子邮件。这就是需求信号。
多账户支持
基于sirfixalotv2 OAuth模式来处理：
- Gmail帐户：个人收件箱、模拟账户
- 个人M365：Hotmail/Outlook.com（不工作M365）
- OAuth2流：与sirfixalotv2用于令牌管理的模式相同
时间线
Week 1-2: Build MCP Server + Multi-Account Auth
├─ OAuth2 for Gmail + personal M365
├─ Account management (add/remove accounts)
├─ Keychain-backed token storage
└─ MCP tools for Claude Desktop
Week 2-3: Triage Engine Implementation
├─ Priority classification (4 tiers)
├─ Auto-archive low-priority
├─ Smart actions (unsubscribe, label)
└─ Learning from user overrides
Week 3-4: Dogfooding & Iteration
├─ Use on real personal inbox
├─ Measure: Time saved, accuracy, trust
├─ Fix issues, improve classification
└─ Tune for personal email patterns
Week 5-6: Polish & Optional Sharing
├─ Documentation and deployment guide
├─ Optional: Share insights with M365 team
├─ Optional: Adotob productization
└─ Optional: Open source as Claude Skill______________________________________________________________________
项目结构
email-intelligence-agent/
├── README.md # This file
├── RALPH-CONSTITUTION.md # Ralph v2 governance (5-phase workflow)
├── PRD.md # M365 Copilot Email Intelligence PRD
├── SPEC.md # Technical specification for Claude Skill POC
├── docs/
│ ├── research/
│ │ └── openclaw-demand-signals.md # OpenClaw analysis
│ ├── design/
│ │ ├── architecture.md # System architecture
│ │ └── user-flows.md # User experience flows
│ └── decisions/
│ └── adr-001-mcp-vs-api.md # Architectural decision records
├── src/
│ ├── skills/ # Claude Desktop skills
│ ├── mcp-servers/ # MCP server implementations
│ └── tests/
└── .claude/
└── skills/
└── email-triage/ # Claude Skill manifest______________________________________________________________________
Ralph v2宪法工作流程
该项目如下 Ralph v2宪法自治发展:
第0阶段：宪法初始化✅ （当前）
- 已创建存储库
- 拉尔夫宪法成立
- 加载上下文（个人、Microsoft、共享）
第1阶段：规范和澄清⏳ （下一页）
- PRD用户评论
- 技术规范验证
- 澄清已解决的问题
- 停止：用户必须在第2阶段之前批准
第二阶段：设计与建筑
- 系统架构设计
- MCP服务器设计
- 用户体验流程
- 安全和隐私考虑
第三阶段：实施
- 为Gmail集成构建MCP服务器
- 实施分流逻辑
- 创建Claude桌面技能
- 使用真实收件箱数据进行测试
第4阶段：测试与验证
- 与Gmail API的集成测试
- 用户接受度测试（Fabian收件箱）
- 衡量标准：处理电子邮件、节省时间、准确性
- 基于反馈进行迭代
第5阶段：文件和交接
- M365副驾驶的最终PRD
- 技术文档
- 部署指南
- 经验教训
______________________________________________________________________
成功标准
个人工具成功
- ✅ 可处理多个帐户（2-3个Gmail+1个个人M365）
- ✅ 每天自主处理100多封电子邮件
- ✅ 优先级分类准确率达到85%以上
- ✅ 每周在个人收件箱管理上节省5+小时
- ✅ 用户足够信任代理以启用自动存档
- ✅ 关键个人电子邮件零误报
- ✅ 与Claude Desktop MCP集成可靠工作
可选扩展目标
- ✅ 有价值的见解足以与M365团队分享
- ✅ 架构足够干净，可以进行产品化（Adotob SaaS）
- ✅ 代码质量足够好，可以开源
______________________________________________________________________
主要特点
多账户管理
- OAuth2集成：Gmail+个人M365（Outlook.com、Hotmail）
- 钥匙链存储：通过macOS钥匙链安全存储令牌
- 帐户切换：在个人账户之间轻松切换
- 示范模式：单独的模拟账户用于测试/展示
智能分诊
- 四级优先级：临界、高、中、低
- 自动操作：存档、标签、基于分类的星号
- 智能取消订阅：检测并提供批量取消订阅
- 学习：从用户覆盖改进
隐私与控制
- 本地优先：Mac上的所有处理（无云AI调用）
- 透明：了解为什么每封电子邮件都被分类
- 可逆的：轻松回滚任何操作
- 选择性的：选择要自动分类的帐户
______________________________________________________________________
技术栈
核心架构（基于sirfixalotv2）
- 语言：Python 3.11+（与sirfixalotv2一致）
- MCP服务器：用于Claude Desktop集成的FastMCP
- 运行时：本地Mac（M3 Max）
- 存储：SQLite用于电子邮件状态+分类历史
- 凭证：macOS钥匙链通过
keyring图书馆
邮件集成
- Gmail API：具有读/写/修改作用域的OAuth2
- Microsoft Graph API：个人M365（消费者租户）
- 多账户：来自sirfixalotv2的ACCOUNT_MAPPING模式
- 许可证管理：带设备流+刷新的OAuth2Manager
人工智能与处理
- LLM：Ollama（gpt oss:12b）用于当地分类
- 嵌入：nomic嵌入文本：语义搜索的最新版本
- 矢量存储：用于电子邮件相似性的可选Qdrant
- 缓存：可选Redis以提高性能
可观察性（不可协商）
- 追踪：所有操作的OpenTetry跨度
- 指标：分类准确度、处理时间、API延迟
- 日志记录：带跟踪ID的结构化JSON日志
- 仪表盘：Jaeger用于跟踪可视化
______________________________________________________________________
参考文献
- OpenClaw研究: Nate B.Jones视频记录
- 出色的开放式法律技能: https://github.com/VoltAgent/awesome-openclaw-skills
- iOS联系人清理器：Ralph v2项目的参考实施
- Ralph v2系统:
LLMContext/shared/ralph-v2-system.md
______________________________________________________________________
联系方式与背景
- 拥有者：法比安·威廉姆斯
- PM角色：首席项目经理-M365副驾驶（微软）
- 上下文：个人（POC）→ 微软（PRD）→ Adotob（产品化）
- 拉尔夫v2：有宪法保护的自主执行
______________________________________________________________________
下一步：审查PRD.md和SPEC.md，然后Ralph进入第一阶段（澄清）