Smart Email — 邮件助手
让用户通过聊天（Telegram / 飞书 / WhatsApp）管理邮箱，查看邮件，获取 AI 摘要和每日日报。
用户可以说什么（意图识别）
当用户发送以下类型的消息时，使用此 skill：
| 用户说的话 | 执行的命令 |
|---|
| "查邮件" / "有新邮件吗" / "check email" | INLINECODE0 |
| "查看 xxx@gmail.com 的邮件" |
check --summarize --account xxx@gmail.com |
| "最近3天的邮件" |
check --summarize --since 4320 |
| "邮件日报" / "今天邮件总结" / "email digest" |
digest |
| "读一下这封邮件" + uid |
read <uid> |
| "添加邮箱" / "设置邮箱" / "setup email" | → 引导 setup 流程 |
| "删除邮箱 xxx" |
remove xxx@gmail.com |
| "我有哪些邮箱" / "邮箱列表" |
accounts |
| "设置 API Key" / "配置 AI" | → 引导 config 流程 |
CLI
所有命令通过此路径执行，输出 JSON：
CODEBLOCK0
INLINECODE7 是此 skill 的安装目录。
命令参考
check — 查看新邮件
CODEBLOCK1
- -
--summarize — 包含 AI 摘要（推荐默认开启） - INLINECODE9 — 回看 M 分钟（默认 60）
- INLINECODE10 — 最多返回 N 封（默认 10）
- INLINECODE11 — 只查指定邮箱
输出示例：
CODEBLOCK2
格式化回复建议：按邮件逐条展示，包含发件人、主题、AI摘要。标注重要程度。
read — 读取邮件全文
CODEBLOCK3
返回邮件全文 + AI 解读。
digest — 邮件日报
CODEBLOCK4
- -
--since M — 回看时间（默认 1440 = 24小时）
返回 AI 生成的邮件总结，按紧急/关注/可忽略分类。
accounts — 查看已配置邮箱
CODEBLOCK5
setup — 添加邮箱
CODEBLOCK6
引导用户的流程：
- 1. 问用户邮箱地址
- 自动检测类型（Gmail / Outlook / Workspace）
- 如果是 Gmail/Workspace：
- 告诉用户需要 App Password
- 指导：Google 账户 → 安全性 → 两步验证 → 应用专用密码
- 用户提供后执行 setup
- 4. 如果是 Outlook/M365：
- 推荐 OAuth2（更安全，不需要密码）
- 执行
setup <email> --auth oauth，会返回一个链接和验证码
- 告诉用户在浏览器打开链接、输入验证码
- 等待授权完成
- 5. 其他邮箱：问用户密码/App Password
remove — 删除邮箱
CODEBLOCK7
config — 配置
CODEBLOCK8
Web UI（可选）
提供浏览器界面，适合不喜欢命令行的用户：
CODEBLOCK9
启动后会显示带 token 的 URL，打开即可在浏览器中配置和使用。
首次使用检查
当用户第一次使用邮件相关功能时，检查：
- 1.
accounts 是否有已配置邮箱？没有 → 引导 setup - INLINECODE15 是否有
ai_api_key？没有 → 提示需要配置 AI Key（否则没有摘要功能）
数据存储
- - 邮箱凭证：
<SKILL_DIR>/data/email.db（SQLite，本地加密存储） - 配置： INLINECODE18
- 所有数据仅存在用户本地，不上传
Smart Email — 邮件助手
让用户通过聊天（Telegram / 飞书 / WhatsApp）管理邮箱，查看邮件，获取 AI 摘要和每日日报。
用户可以说什么（意图识别）
当用户发送以下类型的消息时，使用此 skill：
| 用户说的话 | 执行的命令 |
|---|
| 查邮件 / 有新邮件吗 / check email | check --summarize |
| 查看 xxx@gmail.com 的邮件 |
check --summarize --account xxx@gmail.com |
| 最近3天的邮件 | check --summarize --since 4320 |
| 邮件日报 / 今天邮件总结 / email digest | digest |
| 读一下这封邮件 + uid | read
|
| 添加邮箱 / 设置邮箱 / setup email | → 引导 setup 流程 |
| 删除邮箱 xxx | remove xxx@gmail.com |
| 我有哪些邮箱 / 邮箱列表 | accounts |
| 设置 API Key / 配置 AI | → 引导 config 流程 |
CLI
所有命令通过此路径执行，输出 JSON：
bash
node /cli.js [options]
是此 skill 的安装目录。
命令参考
check — 查看新邮件
bash
node /cli.js check [--summarize] [--account EMAIL] [--since MINUTES] [--max N]
- - --summarize — 包含 AI 摘要（推荐默认开启）
- --since M — 回看 M 分钟（默认 60）
- --max N — 最多返回 N 封（默认 10）
- --account EMAIL — 只查指定邮箱
输出示例：
json
{
emails: [
{
account: user@gmail.com,
uid: 12345,
from: Boss,
subject: Q1 Report,
date: 2026-03-12T10:00:00Z,
bodyPreview: Please review...,
summary: 🔴 老板要你审核 Q1 报告，需要尽快回复
}
],
total: 1
}
格式化回复建议：按邮件逐条展示，包含发件人、主题、AI摘要。标注重要程度。
read — 读取邮件全文
bash
node /cli.js read [--account EMAIL]
返回邮件全文 + AI 解读。
digest — 邮件日报
bash
node /cli.js digest [--since MINUTES] [--account EMAIL]
- - --since M — 回看时间（默认 1440 = 24小时）
返回 AI 生成的邮件总结，按紧急/关注/可忽略分类。
accounts — 查看已配置邮箱
bash
node /cli.js accounts
setup — 添加邮箱
bash
Gmail / Google Workspace
node DIR>/cli.js setup --password PASSWORD>
Outlook / M365 (OAuth2)
node /cli.js setup --auth oauth
Outlook / M365 (App Password)
node DIR>/cli.js setup --auth password --password PASSWORD>
引导用户的流程：
- 1. 问用户邮箱地址
- 自动检测类型（Gmail / Outlook / Workspace）
- 如果是 Gmail/Workspace：
- 告诉用户需要 App Password
- 指导：Google 账户 → 安全性 → 两步验证 → 应用专用密码
- 用户提供后执行 setup
- 4. 如果是 Outlook/M365：
- 推荐 OAuth2（更安全，不需要密码）
- 执行 setup --auth oauth，会返回一个链接和验证码
- 告诉用户在浏览器打开链接、输入验证码
- 等待授权完成
- 5. 其他邮箱：问用户密码/App Password
remove — 删除邮箱
bash
node /cli.js remove
config — 配置
bash
查看当前配置
node /cli.js config
设置 AI API Key（必需，用于邮件摘要）
node DIR>/cli.js config aiapi_key
设置 API 地址和模型（可选）
node DIR>/cli.js config aiapi_base https://api.deepseek.com
node DIR>/cli.js config aimodel deepseek-chat
Microsoft OAuth2 配置（Outlook 用户需要）
node DIR>/cli.js config msclientid ID>
node DIR>/cli.js config mstenantid ID>
Web UI（可选）
提供浏览器界面，适合不喜欢命令行的用户：
bash
node /server.js [--port 3900]
启动后会显示带 token 的 URL，打开即可在浏览器中配置和使用。
首次使用检查
当用户第一次使用邮件相关功能时，检查：
- 1. accounts 是否有已配置邮箱？没有 → 引导 setup
- config 是否有 aiapikey？没有 → 提示需要配置 AI Key（否则没有摘要功能）
数据存储
- - 邮箱凭证：DIR>/data/email.db（SQLite，本地加密存储）
- 配置：DIR>/data/config.json
- 所有数据仅存在用户本地，不上传
