OWA Outlook 技能（日历 + 邮件）

触发条件

• 日历：今天/明天/本周有什么安排、会议、日程、任务、工作
• 邮件：有没有新邮件、未读邮件、查收件箱、搜索邮件

首次配置

敏感信息存放在 ~/.outlook/，不在 skill 目录内。

1. 创建配置文件

// ~/.outlook/config.json
{
  "email": "your@company.com",
  "password": "your_password",
  "cookie_file": "/root/.outlook/cookies.json",
  "cookie_max_age_days": 7,
  "mfa_type": "authenticator_number_match"
}

2. 安装依赖

pip install playwright requests
playwright install chromium

3. 首次登录（MFA）

cd ~/.agents/skills/owa-outlook
python login.py

脚本输出 [NUMBER:XX] 时，在 Microsoft Authenticator App 输入数字 XX 并批准。

日历用法

cd ~/.agents/skills/owa-outlook
python owa_calendar.py --today
python owa_calendar.py --tomorrow
python owa_calendar.py --week
python owa_calendar.py --month 2026-03
python owa_calendar.py --range 2026-03-01 2026-03-31

注意：API 返回时间为 UTC，需 +8 转换为上海时间。

邮件用法

cd ~/.agents/skills/owa-outlook
python owa_mail.py --unread              # 未读邮件（默认最近20封）
python owa_mail.py --today               # 今天收到的邮件
python owa_mail.py --limit 50            # 最近50封
python owa_mail.py --search "关键词"     # 搜索主题/发件人
python owa_mail.py --folder Inbox        # 指定文件夹
python owa_mail.py --json                # JSON 格式输出

认证说明

• Token 过期（1小时）→ 自动续，无感知
• Cookie 过期 → 自动重新登录，输出 [MFA] 请在 Authenticator 选择数字：【XX】，你在手机上批准即可，脚本自动继续

文件结构

~/.agents/skills/owa-outlook/
├── SKILL.md
├── login.py          # MFA 登录
├── owa_calendar.py   # 日历读取
└── owa_mail.py       # 邮件读取

~/.outlook/
├── config.json       # 账号密码
├── cookies.json      # 登录 Cookie
└── token.json        # Bearer Token 缓存