Gmail 最近邮件摘要

运行要求

• 容器环境中必须可用 Python 3（可通过 python 命令调用）。
• IMAP 凭据须通过以下 任一方式 提供（环境变量优先级高于配置文件）：

选项 A — 环境变量（推荐）

选项 B — 配置文件

设置环境变量 EMAIL_CONFIG_PATH 指向一个 JSON 文件，或直接将该文件置于 ~/.config/gmail-summarize/config.json 路径下。 该文件中仅可包含如下字段（不得在该文件中存储任何其他敏感信息）：

{
  "email": {
    "imapHost": "imap.gmail.com",
    "imapPort": 993,
    "imapUsername": "your@gmail.com",
    "imapPassword": "your-app-password",
    "maxBodyChars": 2000
  }
}

安全说明

• 首选方式：通过环境变量（IMAP_HOST、IMAP_PORT、IMAP_USERNAME、IMAP_PASSWORD）提供凭据，从而完全避免读取磁盘上的任何文件。
• 若使用配置文件，则该文件中仅允许包含上述 email 字段。脚本仅读取这四个字段，不会解析或访问文件中的其余内容。
• 本技能建立的唯一外部连接是到 IMAP_HOST / email.imapHost 所指定的 IMAP 服务器，不访问任何其他端点。
• 凭据仅用于 IMAP 会话认证，本技能不会记录或另行存储这些凭据。

适用场景

• 用户请求如：“检查我的 Gmail”、“总结我的邮件”、“邮件摘要”
• cron 触发消息中包含字符串 gmail_digest

执行流程

1. 通过 exec 工具运行拉取脚本： python {workspace}/skills/gmail-summarize/scripts/fetch_unseen.py （请将 {workspace} 替换为您的实际工作区根路径）

2. 解析返回的 JSON 数组。每个条目包含字段：sender（发件人）、subject（主题）、date（日期）、body（正文）

3. 对每封邮件生成一行摘要： [date] sender | subject — 一句话正文摘要

4. 使用 MessageTool 发送完整摘要，格式如下：

   📬 邮件摘要（N 封，覆盖 MM/DD–MM/DD）

   • [日期] 发件人 | 主题 — 一句话摘要 • [日期] 发件人 | 主题 — 一句话摘要 ...

5. 若无结果，发送： 📭 近两日暂无未读邮件

输出规范

• 仅发送摘要消息本身。严禁在摘要前后添加额外评论、问候语、解释性文字或后续提问。
• 禁止使用诸如“主人，以下是您的邮件摘要”或“如需了解详情请告知”等表述。
• 摘要消息即为最终且完整的响应，不得附加任何其他内容。
• 正文的一句话摘要必须翻译为中文；发件人名称与邮件主题则保持原文不变。