MS Outlook + Teams 助理（以桌面端为优先）

该技能的功能说明

• 收件箱提醒（Outlook 桌面版）：查找过去 7 天内可能需要回复的邮件，并持续发送提醒，直至用户手动忽略。
• 邮件回复草稿生成：生成简洁明了的回复草稿，符合用户的语气规范（如：对话式、极简式、礼貌式；使用简单英语；篇幅短小；避免冗余；禁用 em dash（—））。
• Teams 消息追踪（可选）：若已配置 Microsoft Graph 并获得租户策略许可，则可追踪近期可能需回复的 Teams 聊天消息，并以类似方式发起提醒。

安全默认设置

• 不自动发送任何电子邮件或 Teams 消息。
• 仅在 Outlook 中创建草稿，或把草稿粘贴至 Telegram 供人工审核与确认后发送。
• 关于提醒：默认发送至 Telegram；仅当明确启用时，才向 Teams 发送提醒。

初始配置（一次性操作）

A) Outlook 桌面端自动化（推荐）

1. 确保已安装并登录 Outlook 桌面版。
2. 安装 Python 依赖（在目标机器上执行前请先征得用户同意）：
   • pip install pywin32
3. 创建配置文件：
   • 复制 references/config.example.json → references/config.json，并填写其中字段。
   • 重要提示：若 references/config.json 中包含个人 ID 等敏感信息，请勿将其提交至代码仓库。

B) 通过 Graph 接入 Teams（可选）

仅适用于可创建 Entra ID 应用注册并授予相应权限的场景。

• 复制 references/config.example.json → references/config.json，并填写 teams.tenantId、teams.clientId 和 teams.scopes 字段。
• 随后运行一次 scripts/teams_scan.py，完成 Device Code 登录流程。

详见 references/teams-graph-setup.md。

核心工作流

1) 扫描并发起提醒（Outlook）

使用 scripts/scan_outlook.py。

1b) 扫描 Teams（Graph）

使用 scripts/teams_scan.py。

参数：

• --days 7（默认值）

首次运行将打印一条 Device Code 登录提示（仅需按提示操作一次）。

其他参数：

• --days 7（默认值）
• --mode report|telegram（默认为 report）
• --max-items 200

启发式规则（可在配置文件中编辑）：

• 限定在最近 N 天内
• 排除明显来自广播类来源（如群发邮件列表、公告系统）的消息
• 优先选择用户出现在 To: 字段（而不仅是 CC）的会话线程，或主题/正文包含明确请求内容的消息
• 优先选择用户尚未回复的消息（尽力而为）

输出结果：

• 一份可操作事项清单，含：主题、发件人、接收时间、被标记原因。

后续行为：

• 若指定 --mode telegram，则生成一条简洁的提醒消息（含项目符号列表），并发送至 Telegram。

2) 忽略 / 暂延某项提醒

本技能使用本地状态文件来防止重复提醒（nag loop）。

• 忽略（Dismiss）：将该邮件的 internetMessageId（若不可用，则回退至“主题+时间戳”组合）加入已忽略列表。
• 暂延（Snooze）：记录一个 snoozeUntil 时间戳。

可使用 scripts/state.py 提供的辅助工具操作（必要时也可直接编辑 JSON 文件）。

3) 生成邮件回复草稿（Outlook）

使用 scripts/draft_reply.py。

4) 生成提醒（不实际发送）

使用 scripts/scan_all.py 更新本地缓存的扫描结果，再调用 scripts/remind.py 生成一条适配 Telegram 的提醒消息（该脚本本身不执行发送动作）。

其应用逻辑如下：

• 一对一 Teams 对话 → 当 needsReply=true 时提醒
• 群组 Teams 对话 → 当同时满足 mentionedMe=true 且 needsReply=true 时提醒
• Outlook 邮件 → 对已标记的项目发起提醒

若输出非空，代理应将结果发送至 Telegram。

输入支持：

• 首选提供消息的 EntryID；亦可按主题 + 近期时间窗口进行搜索。

行为说明：

• 尽力提取完整会话线程及关键元数据。
• 生成两版回复草稿：
  • 简短版（2–5 句）
  • 常规版（5–10 句）
• 应用 references/writing-style.md 中定义的语气规则。

输出结果：

• 将草稿内容打印至标准输出（stdout）。
• 若指定 --create-draft 参数，可自动在 Outlook 中创建一封回复草稿（不发送）。

当需要用户补充上下文时

仅询问无法通过已有信息推断的内容：

• 具体要回复哪封邮件（可通过主题 / 发件人 / 接收时间定位）
• 用户的意图（同意 / 拒绝 / 请求信息 / 确认时间节点等）
• 是否存在约束条件（截止时间、附件、特定人名等）

提问应尽量精简（每次最多 3 个问题）。