Gmail-digester_办公效率 skill-PHP中文网

Gmail-digester

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

获取近期未读Gmail（昨天和今天），并向用户发送摘要。

Gmail 近期摘要.

功能概述

Gmail 近期摘要.是一项面向实际任务的技能，主要用于Python 3 必须在容器环境中提供( python 命令)；IMAP 证书必须通过以下方法之一提供(env vars优先):.。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Gmail 最近邮件摘要

运行要求

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

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

变量名	说明	默认值
`IMAP_HOST`	IMAP 服务器主机名	`imap.gmail.com`
`IMAP_PORT`	IMAP 服务器端口	`993`
`IMAP_USERNAME`	IMAP 登录用户名	（必填）
`IMAP_PASSWORD`	IMAP 登录密码 / 应用专用密码	（必填）
`IMAP_MAX_BODY_CHARS`	每封邮件正文最大字符数	`2000`

选项 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

执行流程

通过 exec 工具运行拉取脚本： python {workspace}/skills/gmail-summarize/scripts/fetch_unseen.py （请将 {workspace} 替换为您的实际工作区根路径）
解析返回的 JSON 数组。每个条目包含字段：sender（发件人）、subject（主题）、date（日期）、body（正文）
对每封邮件生成一行摘要： [date] sender | subject — 一句话正文摘要
使用 MessageTool 发送完整摘要，格式如下：

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

• [日期] 发件人 | 主题 — 一句话摘要 • [日期] 发件人 | 主题 — 一句话摘要 ...
若无结果，发送： 📭 近两日暂无未读邮件