邮件分诊代理

为 Hermes Agent 提供确定性邮件分诊。它将消息分类为 P0–P3 或 REVIEW，发出共享的 pif.event.v1 契约，并让 Hermes 通过其现有的飞书网关交付结果。

确定性的 Hermes 邮件分诊 MCP：不确定就保留，V1 永不删除、永不发信，飞书凭证继续由 Hermes 管理。

为什么 / 设计理念

• 减少信息，不要制造更多信息。

• P0 是立即处理；P1 等待摘要；P2/P3 仅用于审计。

• 发件人认证冲突和低置信度变为 REVIEW/HOLD。

• 人工反馈更新外部 JSONL 规则轨迹，绝不更新模型权重。

• 可选适配器通过只读 IMAP 连接真实邮箱。它从不执行删除、发送、移动或已读更改。

Related MCP server: inbox-to-action-mcp

本地运行

npm ci
npm test
npm run demo

真实邮箱适配器命令：

node src/adapter-cli.js test --account qq-main
node src/adapter-cli.js poll --accounts qq-main

凭证是对 macOS 钥匙串项目或环境变量的引用；配置验证会拒绝字面密码和令牌。请参阅只读邮箱适配器指南。

一次性分类：

node src/cli.js --json '{"sender":"no-reply@accounts.google.com","subject":"New login detected","auth":{"spf":"pass","dkim":"pass","dmarc":"pass"},"protectedSender":true}'

在 macOS 上添加到 Hermes

Hermes 从 ~/.hermes/config.yaml 发现 stdio MCP 工具。克隆并安装，然后使用绝对路径：

git clone https://github.com/roclee2692/email-triage-agent.git ~/Projects/email-triage-agent
cd ~/Projects/email-triage-agent && npm ci
hermes mcp add email-firewall --command node --args "$HOME/Projects/email-triage-agent/src/mcp.js"
hermes mcp test email-firewall

Hermes 注册的工具名称如 mcp_email_firewall_triage_email。服务器永远不需要飞书密钥：Hermes 已经拥有飞书频道，并展示或安排返回的消息。

工具

• triage_email

• render_feishu_email

• record_email_feedback

• get_email_policy

• poll_email_accounts

• test_email_account

• acknowledge_email_events

配套仓库是 crypto-market-sentinel。两者返回相同的事件信封，因此一个 Hermes 提示可以应用相同的紧急/摘要/审计策略。

请参阅 Hermes macOS 设置 和共享的 PIF 事件契约。

许可证

MIT。请参阅 LICENSE。