SuperAPI AI 工具集

outlook-calendar

办公与效率

查看项目

更新于 10-15 15:16

技能介绍

Outlook 日历技能用于读取企业 Microsoft 365 Outlook 日历,帮助用户查询日程、会议、安排、工作与任务。

用途 当用户提出任何涉及日程、会议、安排、日历、工作、任务、事情的问题时,应调用此技能。典型问法包括:明天有什么安排、这周有什么会、本月日程、帮我看看日历、我今天几点有会、这个月会议一共多少小时、我下周有啥工作、明天要做啥、这周有什么事、下周安排、有啥任务、日程表看一下,以及任何“时间 + 安排/会议/事件/工作/任务/事情”的组合问法。

主要能力 技能通过脚本读取 Outlook Web 日历,支持以下时间范围:

  • 今天: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 读取后可整理输出,例如列出事件、统计总时长、按周分组等。

使用方式 首次配置:

  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" } 敏感信息(账号密码、Cookie、Token)存放在 ~/.outlook/,不在 skill 目录内。

  2. 安装依赖: pip install playwright requests playwright install chromium

  3. 首次登录(MFA): cd ~/.agents/skills/outlook-calendar python login.py 脚本输出 [NUMBER:XX] 时,在 Microsoft Authenticator App 输入数字 XX 并批准,Cookie 自动保存到 ~/.outlook/cookies.json。

调用步骤: 第一步:读取日历 cd ~/.agents/skills/outlook-calendar 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 # 自定义范围

第二步:处理 AUTH_FAILED 若输出 [AUTH_FAILED],Cookie 或 Token 过期,重新登录: python login.py

第三步:整理输出 按用户问题整理回答:列出事件、统计总时长、按周分组等。 注意:API 返回时间为 UTC,需 +8 转换为上海时间。

文件结构 skill 目录(无敏感信息): ~/.agents/skills/outlook-calendar/ ├── SKILL.md ├── login.py # MFA 登录,保存 Cookie 到 ~/.outlook/ └── owa_calendar.py # 日历读取(Token 模式)

敏感数据目录: ~/.outlook/ ├── config.json # 账号密码(自行创建) ├── cookies.json # 登录 Cookie(login.py 自动生成) └── token.json # Bearer Token 缓存(自动生成,1h 有效)

MFA 说明 类型:Authenticator 数字匹配。 Cookie 有效期:通常 1-7 天,过期重跑 login.py。 多次失败会触发微软限速,等 15 分钟再试。

适用场景 适用于需要查询企业 Microsoft 365 Outlook 日历中日程、会议、工作与任务的场景,例如查看某天、某周、某月或自定义日期范围内的事件,统计会议时长,或按周整理安排。

限制 需要企业 Microsoft 365 Outlook 账号,并完成 MFA 登录。Cookie 有效期通常为 1-7 天,过期后需重新运行 login.py。多次登录失败会触发微软限速,需等待 15 分钟再试。API 返回时间为 UTC,需 +8 转换为上海时间。敏感信息需存放在 ~/.outlook/ 目录,不在 skill 目录内。