Email Assistant

多邮箱管理助手，支持 Gmail、163、QQ、Outlook、Hotmail。功能：(1) 读取收件箱并展示邮件摘要 (2) 关键词分析标记重要邮件 (3) 自动提取邮件中的日程信息并生成日历事件。适用于需要统一管理多个邮箱、避免错过重要邮件和日程的用户。

Security Scan

The skill's code, instructions, and requirements are consistent with a multi‑email inbox reader / analyzer / calendar extractor; it asks for the expected credentials and does not contain unexplained network endpoints or installers.

Purpose & Capability

Name/description match the included scripts (Gmail OAuth client, generic IMAP client, mail parser, scheduler). All requested actions (fetching emails, keyword detection, extracting calendar events) are implemented by the provided files and documented in SKILL.md.

Instruction Scope

SKILL.md directs the user to run local scripts and to provide credentials via credentials.json (Gmail) or CLI args (IMAP). Instructions stay within the email/calendar domain. Note: the Gmail flow runs a local OAuth server (run_local_server on port 8080) and scripts read/write local files (credentials.json, token.pickle/token.json, output ICS/JSON).

Install Mechanism

No install specification or remote downloads are present; this is an instruction + code bundle that runs locally. No archives or external installers are fetched by the skill.

Credentials

The skill requires user email credentials/OAuth JSON and app passwords per the docs, which are appropriate for the functionality. Registry metadata lists no required env vars, but the code expects credential files and CLI-supplied passwords — the absence of declared required credentials in the registry metadata is a minor mismatch users should be aware of. The scripts cache tokens to disk (token.pickle/token.json), which are sensitive.

Persistence & Privilege

always is false and the skill does not request persistent platform privileges. It writes credential/token files locally (normal for OAuth clients) but does not modify other skills or system-wide configs.

Assessment

This skill appears to do what it says, but review and handle credentials carefully before use: 1) Use OAuth credentials.json and app passwords as instructed; do not paste real account passwords into shared places. 2) The Gmail script runs a local OAuth server and will create a token file (token.pickle / token.json) — securely store or delete it after use. 3) Passing passwords on the CLI can expose them in shell history; prefer app passwords and transient input methods. 4) Inspect the scripts yourself before running and run them in a controlled environment (local machine or isolated container). 5) If you don't need write actions, note the Gmail client requests modify scope (it can STAR messages); remove/limit the scope if you only need read-only access.

Email Assistant - 多邮箱管理助手

功能概览

• 多邮箱支持: Gmail、163、QQ、Outlook、Hotmail
• 邮件读取: 获取收件箱、显示摘要、搜索邮件
• 智能分析: 关键词识别重要邮件
• 日程提取: 自动从邮件中提取日程信息

支持的邮箱

邮箱	协议	服务器配置
Gmail	OAuth2 + IMAP	imap.gmail.com:993
163	IMAP	imap.163.com:993
QQ	IMAP	imap.qq.com:993
Outlook	IMAP	outlook.office365.com:993
Hotmail	IMAP	outlook.office365.com:993

使用方法

1. Gmail 配置

首次使用需要配置 OAuth：

# 1. 在 Google Cloud Console 创建项目
# 2. 启用 Gmail API
# 3. 创建 OAuth 2.0 客户端凭据
# 4. 下载凭据文件为 credentials.json
# 5. 首次运行会自动打开浏览器授权

运行脚本：

cd scripts
python3 gmail_client.py --credentials ../credentials.json

2. IMAP 邮箱 (163/QQ/Outlook/Hotmail)

直接运行：

python3 imap_client.py --server <服务器> --email <邮箱> --password <密码或App密码>

3. 查看邮件

# 查看收件箱
python3 mail_parser.py --inbox

# 搜索特定邮件
python3 mail_parser.py --search "关键词"

# 分析重要邮件
python3 mail_parser.py --analyze

4. 提取日程

# 从邮件中提取日程并生成 ICS 文件
python3 scheduler.py --extract --output events.ics

脚本说明

scripts/gmail_client.py

Gmail OAuth 认证客户端。首次运行会打开浏览器进行授权，之后凭据会缓存。

scripts/imap_client.py

通用 IMAP 客户端，适用于 163、QQ、Outlook、Hotmail。使用 App Password 认证。

scripts/mail_parser.py

邮件解析器。解析纯文本/HTML 邮件，提取关键信息，分析重要性。

scripts/scheduler.py

日程提取器。从邮件中识别 iCal 附件或纯文本日程，生成标准 ICS 日历文件。

重要邮件识别

自动识别以下关键词：

• urgent, 紧急, 重要, 即时
• deadline, 截止, 期限
• meeting, 会议, 面试
• invoice, 发票, 付款, 账单
• contract, 合同, 协议

日程提取

支持格式：

• iCal 附件 (.ics)
• 纯文本日程（日期+时间+内容）

注意事项

1. Gmail: 必须使用 OAuth2，密码登录已被禁用
2. 163/QQ: 需开启 IMAP 并使用 App Password
3. Outlook/Hotmail: 使用常规密码或 App Password
4. 建议使用 App Password 而非登录密码，提高安全性