exchange2010

Exchange 2010 EWS 集成，支持邮件、日历、联系人和任务管理。

配置

需在 .env.credentials 文件中提供凭据：

EXCHANGE_SERVER=mail.company.com
EXCHANGE_DOMAIN=company
EXCHANGE_EMAIL=user@company.com
EXCHANGE_PASSWORD=your_password

功能特性

• ✅ 邮件：读取未读邮件、发送、搜索、标记为已读
• ✅ 邮件附件：下载附件、提取文本（PDF、TXT）
• ✅ 邮件文件夹：浏览“已发送”、“草稿”、“垃圾邮件”、“已删除邮件”等文件夹
• ✅ 日历：查看、创建、更新、删除及搜索日程事件
• ✅ 重复事件：识别并管理重复系列
• ✅ 共享日历：访问其他 Exchange 邮箱的日历
• ✅ 联系人：搜索通讯录、解析姓名（GAL）
• ✅ 任务 / 待办事项：管理、新建、完成任务
• ✅ 外出办公（Out-of-Office）：读取和设置缺席消息
• ✅ EWS 过滤器：支持快速搜索，如 subject__contains、start__gte 等
• ✅ 列出日历：显示所有日历文件夹

使用示例

读取邮件

from skills.exchange2010 import get_account, get_unread_emails

account = get_account()
emails = get_unread_emails(account, limit=10)
for email in emails:
    print(f"{email['subject']} from {email['sender']}")

今日日程

from skills.exchange2010 import get_today_events

# 当前用户的日程
today = get_today_events()

# 共享日历中的日程
today = get_today_events('shared@company.com')

搜索日程

from skills.exchange2010 import search_calendar_by_subject
from datetime import date

# 快速搜索 Ekadashi 相关日程
ekadashi = search_calendar_by_subject(
    email_address='shared@company.com',
    search_term='Ekadashi',
    start_date=date(2025, 1, 1),
    end_date=date(2026, 12, 31)
)
print(f"Found: {len(ekadashi)} events")

创建日程

from skills.exchange2010 import create_calendar_event
from datetime import datetime

create_calendar_event(
    subject="Team Meeting",
    start=datetime(2026, 2, 7, 14, 0),
    end=datetime(2026, 2, 7, 15, 0),
    body="Project discussion",
    location="Conference Room A"
)

更新日程

from skills.exchange2010 import update_calendar_event
from datetime import datetime

# 重新安排时间
update_calendar_event(
    event_id='AAQkAG...',
    start=datetime(2026, 2, 10, 14, 0),
    end=datetime(2026, 2, 10, 15, 0),
    location="New Room B"
)

浏览邮件文件夹

from skills.exchange2010 import get_folder_emails, list_email_folders

# 列出所有文件夹
folders = list_email_folders(account)
for f in folders:
    print(f"{f['name']}: {f['unread_count']} unread")

# 已发送邮件
sent = get_folder_emails('sent', limit=10)

# 草稿
drafts = get_folder_emails('drafts')

# 垃圾邮件/已删除邮件
trash = get_folder_emails('trash')

搜索邮件

from skills.exchange2010 import search_emails

# 按发件人搜索
emails = search_emails(sender='boss@company.com', limit=10)

# 按主题搜索
emails = search_emails(subject='Invoice', folder='inbox')

# 仅搜索未读邮件
emails = search_emails(is_unread=True, limit=20)

标记邮件为已读

from skills.exchange2010 import mark_email_as_read

mark_email_as_read(email_id='AAQkAG...')

下载附件

from skills.exchange2010 import get_email_attachments

# 显示附件信息
attachments = get_email_attachments(email_id='AAQkAG...')
for att in attachments:
    print(f"{att['name']}: {att['size']} bytes")

# 下载附件到指定路径
attachments = get_email_attachments(
    email_id='AAQkAG...',
    download_path='/tmp/email_attachments'
)

从附件中提取文本

前提条件：需安装 pip install PyPDF2 以支持 PDF 文本提取

from skills.exchange2010 import process_attachment_content

results = process_attachment_content(email_id='AAQkAG...')
for result in results:
    print(f"File: {result['name']}")
    if 'extracted_text' in result:
        print(f"Content: {result['extracted_text'][:500]}...")

搜索联系人

from skills.exchange2010 import search_contacts, resolve_name

# 搜索联系人
contacts = search_contacts('John Doe')
for c in contacts:
    print(f"{c['name']}: {c['email']}")

# 解析姓名（GAL）
result = resolve_name('john.doe@company.com')
if result:
    print(f"Found: {result['name']} - {result['email']}")

管理任务

from skills.exchange2010 import get_tasks, create_task, complete_task, delete_task
from datetime import datetime, timedelta

# 查看待处理任务
tasks = get_tasks()
for task in tasks:
    status = '✅' if task['is_complete'] else '⏳'
    print(f"{status} {task['subject']}")

# 创建新任务
task_id = create_task(
    subject="Finish report",
    body="Q1 report due Friday",
    due_date=datetime.now() + timedelta(days=3),
    importance="High"
)

# 标记为已完成
complete_task(task_id)

# 删除任务
delete_task(task_id)

查找重复事件

from skills.exchange2010 import get_recurring_events

recurring = get_recurring_events(
    email_address='shared@company.com',
    days=30
)
for r in recurring:
    print(f"{r['subject']}: {r['recurrence']}")

外出办公（Out-of-Office）

from skills.exchange2010 import get_out_of_office, set_out_of_office
from datetime import datetime, timedelta

# 检查当前状态
oof = get_out_of_office()
print(f"Out of office active: {oof['enabled']}")

# 启用外出办公
set_out_of_office(
    enabled=True,
    internal_reply="I am on vacation until Feb 15th.",
    external_reply="I am on vacation until Feb 15th.",
    start=datetime.now(),
    end=datetime.now() + timedelta(days=7),
    external_audience='All'  # 'All', 'Known', 'None'
)

# 禁用外出办公
set_out_of_office(enabled=False, internal_reply="")

发送邮件

from skills.exchange2010 import send_email

send_email(
    to=["recipient@example.com"],
    subject="Test",
    body="Hello!",
    cc=["cc@example.com"]
)

API 参考文档

邮件

邮件文件夹

日历

联系人

任务

外出办公（Out-of-Office）

注意事项

• Exchange 2010 SP2 明确指定为此模块所兼容的版本
• 对自有邮箱与共享邮箱均采用 DELEGATE 访问类型
• EWS 过滤器（如 subject__contains、start__gte）比遍历方式性能更优
• 时区处理：自动转换为 EWSDateTime 并统一为 UTC 时间
• 共提供 27 个函数