OutlookMailExporter 使用说明

Outlook 邮件筛选导出工具 v1.0 一个 Windows 桌面应用，用于从 Outlook 桌面客户端按条件筛选邮件，并导出为带附件的 Excel 表格。

一、功能简介

本工具通过 COM 接口连接本机桌面版 Outlook，支持按 关键字 / 发件人 / 时间范围 / 邮箱账号 四种条件组合筛选收件箱邮件，并将结果导出为格式化的 Excel 文件，同时自动下载并整理邮件附件。

核心能力一览：

二、系统要求

• 操作系统：Windows（本工具在 Windows 环境分发）
• Outlook：已安装并登录的 桌面版 Outlook（Microsoft 365 / Office）
• 运行方式：需完整解压后运行 .exe，不能直接从压缩包内运行

三、安装与启动

1. 解压

1. 将 OutlookMailExporter-3.12 文件夹完整解压到本地磁盘（如 D:\ 或 C:\）。
2. ️ 必须完整解压 —— 不要尝试从压缩包内直接运行 EXE。

2. 启动

1. 进入解压后的 OutlookMailExporter 文件夹。
2. 双击 OutlookMailExporter.exe。
3. 确保 Outlook 桌面客户端已登录并运行，程序会自动连接。

四、界面说明

程序启动后界面分为以下几块：

  筛选条件区                                              
    [关键字]  [发件人]  [邮箱账号]                         
    [开始时间] [结束时间]  [今天][昨天][本周][本月]         

  [ 开始筛选] [ 导出 Excel] [取消]                    
  [=========== 进度条 ===========]                        

  筛选结果（表格预览）                                    
   发件人 | 收件时间 | 主题                                

  状态栏                                                  

五、操作步骤

第 1 步：设置筛选条件

在“筛选条件”区域填写（均可选，可组合使用）：

快捷按钮：点击 今天 / 昨天 / 本周 / 本月 可快速填入时间范围。

️ 注意：如果不设置任何条件直接搜索，会导出收件箱全部邮件，邮件量大时可能很慢（会有二次确认提示）。

第 2 步：点击「开始筛选」

• 点击 ** 开始筛选**。
• 程序会分批处理邮件（每批 50 封），期间进度条转动、状态栏显示进度。
• 筛选完成后，结果会显示在下方表格中：
  • 绿色背景行 = 该邮件含有附件
  • 白色背景行 = 无附件

第 3 步：导出 Excel

1. 点击 ** 导出 Excel**（筛选到邮件后此按钮才可用）。
2. 在弹出窗口中选择保存文件夹。
3. 程序会自动：
   • 下载所有真实附件到 附件/ 子文件夹
   • 生成 Excel 文件 邮件导出_时间戳.xlsx
4. 完成后会自动打开保存文件夹，并弹出完成提示。

六、导出文件说明

导出后，在目标文件夹内会生成两类文件：

目标文件夹/
 邮件导出_20260804_104652.xlsx    邮件数据表格
 附件/                            下载的附件文件夹

Excel 表格结构

表格特性：

• 蓝色表头 + 微软雅黑字体
• 冻结首行
• 自动筛选功能
• 附件为 HYPERLINK 公式，Excel 与 WPS 均兼容，点击即可打开对应附件文件

七、附件智能过滤规则

程序会自动过滤垃圾/无意义的附件，只保留真实文件：

同一邮件若有同名附件，会自动追加 _1、_2 等后缀避免覆盖。

八、多账号使用

• 程序启动时会自动读取 Outlook 中所有邮箱账号（根文件夹名）。
• 在“邮箱账号”下拉框中选择目标账号即可只搜索该账号的收件箱。
• 不选择则默认使用第一个账号。
• 兼容中文「收件箱」和英文「Inbox」文件夹名。

九、日志与排障

日志位置

每次运行都会在 logs/ 文件夹生成一个日志文件：

logs/export_20260804_104652.log

文件名格式为 export_日期_时间.log，记录了完整运行过程（连接、筛选条件、找到的邮件数、附件保存情况、错误信息等）。

常见问题

十、版本信息

• 程序版本：v1.0
• 技术栈：Python 3.12（PyInstaller 打包）
  • 界面：tkinter / ttk
  • Outlook 交互：win32com（COM / MAPI）
  • Excel 导出：openpyxl
• 日志来源目录：logs/

如有任何问题，请将 logs/ 目录下最新的 .log 文件内容提供给维护人员。