用途:将 Gmail 或 Outlook 邮件同步到 IntentMail 本地存储,并返回一份限定范围、按优先级排序的只读简报。该流程不改变邮件服务商的消息状态;同步会更新本地缓存,并可能刷新本地保存的 OAuth 令牌。
前提:在 Node.js 20 或更高版本运行 IntentMail;通过 IntentMail OAuth 连接至少一个 Gmail 或 Outlook 账户;配置用于生成分类与摘要的 AI 提供商。
认证与隐私:要求账户此前已通过 mail_auth_start 连接,本技能不运行 OAuth,也不会在对话中索取密钥。OAuth 令牌与索引邮件保留在自托管的 IntentMail 进程中。Anthropic、OpenAI、Groq、Cerebras 或 Vertex 会接收所请求 AI 分类或摘要所需的邮件与线程内容;Ollama 可保持推理本地进行。
流程:解析账户,未提供 ID 时调用 mcp__intentmail__mail_list_accounts,多个账户时询问;确认时间窗口与上限,默认使用摘要工具的 50 项限制,可按需使用 unreadOnly 或 sinceHours;对所选账户调用 mcp__intentmail__mail_sync,未经说明与批准不要设置 forceInitial: true 或提高 maxMessages;调用 mcp__intentmail__mail_daily_digest,优先使用其结构化结果;若摘要工具不可用,则用 mcp__intentmail__mail_search 获取限时窗口、mcp__intentmail__mail_triage 分类,仅对需要压缩的线程使用 mcp__intentmail__mail_summarize;先呈现高优先级与待回复项,再呈现其余分组,并保留工具输出中的不确定性与出处。
校验:确认返回的账户 ID 与所选账户一致;报告同步类型、新增/删除/标签变更计数及同步时间戳;区分同步报告的服务商已删除项与本技能执行的操作;同步失败时不得声称空摘要代表收件箱为空。
输出:返回账户与时间窗口、同步回执、摘要计数、P1-P4 分组、回复需求、检测到的截止时间、简洁摘要、不确定性,以及失败或省略的阶段;不暴露超出用户审阅范围的邮件正文。
错误处理:无账户或 OAuth 过期时停止并引导至明确的 IntentMail 认证流程;AI 提供商不可用时返回受限的 mail_search 结果并标注为未分类;部分同步或限流时报告错误与上次成功同步时间;遇到请求执行操作时停止并转交 email-triage-actions;优先级或截止时间不确定时展示不确定性与原文出处。