teokitten/tracemail

# Tracemail Tracemail 是一个适用于 Linux 的本地邮件调查工作区。 通过 IMAP 连接您的收件箱，按姓名或关键词进行过滤， 深入探索您的通信记录——提供可读的聊天式 交流视图、附件浏览器、相关邮件查找器以及 分析仪表板。 专为需要理解、重构或展示邮件历史的场景而构建：费用纠纷、合同 分歧、通信证明、HR 事务、法律 准备，或任何细节内容和时间点至关重要的案件。 ## 您可以用它做什么 - **重构对话** – 按人员或公司 进行过滤，并以清晰的聊天视图查看完整的交流记录，您的消息 在一侧，对方在另一侧，按时间顺序排列 - **查找支持证据** – 使用“相关”选项卡找出 提及某个关键词但不属于直接交流的 邮件，例如向第三方发送的关于 同一人员或公司的投诉 - **分析关系** – 查看回复率、谁 主动发起对话、回复所需时间、沟通 空档，以及联系开始和结束的时间 - **访问附件** – 在一处浏览、预览和下载过滤后的交流记录中的每个 附件，包括 PDF、XLSX 文件、图像和文档 - **批注并打印** – 为单封邮件添加备注，并 直接从浏览器将完整的交流记录打印为 整洁的文档 - **追踪长期的沟通模式** – 证明您 一直在持续跟进，或者对方系统性地 回复缓慢或直接失联。分析 时间线和空档指标让这一点具体化。 - **核实书面协议内容** – 按人员或 公司进行过滤，并搜索特定术语，以定位承诺或 确认某事的确切邮件 - **从干扰中分离有效信息** – 交流视图会剔除 引用的线程，仅显示每条 消息的实际内容，使海量的通信记录能够通过一次 滚动变得清晰易读 ## 隐私 Tracemail 完全在您的本地机器上运行。您的凭据 存储在浏览器的 localStorage 中，仅通过 SSL 发送到您 自己的邮件服务器。不会有任何数据离开您的本地网络。 没有云端组件，没有遥测，没有 AI 模型， 也没有任何形式的第三方服务。 ## 平台 仅支持 Linux。目前不支持 Windows 和 macOS。 ## 功能 - 五选项卡工作区：列表、交流、附件、分析、 相关 - 聊天式交流视图，带有颜色区分的发送/接收 消息 - 内联附件预览 – PDF、XLSX、DOCX 和图像 - 可点击的分析数据：回复率、回复时间、空档分析、 活跃度时间线 - 通过 IMAP 正文搜索发现相关邮件 - 打印时包含单封邮件的备注 - 浏览器打印为 PDF – 无需导出步骤 - 搜索历史 - 只读 IMAP 访问 - 兼容 Yahoo、Gmail、Outlook 及任何标准的 IMAP 服务器 ## 如何运行 ### 选项 1 – 下载二进制文件（推荐） 1. 从 [GitHub Releases](https://github.com/teokitten/tracemail/releases) 下载最新的 `tracemail` 二进制文件 2. 赋予其可执行权限： ``` chmod +x tracemail ``` 3. 运行它： ``` ./tracemail ``` 4. 在浏览器中打开 `http://127.0.0.1:5050` ### 选项 2 – 从源码运行 **前提条件：** Python 3.11 或更高版本 ``` git clone https://github.com/teokitten/tracemail.git cd tracemail pip install flask PyPDF2 python-docx reportlab openpyxl python app.py ``` 在浏览器中打开 `http://127.0.0.1:5050`。 **注意：** 预览 XLSX 附件需要 `openpyxl`。 如果首次运行时看到错误，请单独安装它： ``` pip install openpyxl ``` ### 选项 3 – 自行构建二进制文件 仅供开发者使用。生成一个独立的二进制文件， 等同于 GitHub Releases 中的版本。 **前提条件：** Python 3.11 或更高版本，PyInstaller ``` pip install pyinstaller pyinstaller --onefile --name tracemail \ --add-data "templates:templates" app.py ./dist/tracemail ``` ## 应用密码设置 当启用了两步验证的 IMAP 时，Yahoo、Gmail 和 Outlook 需要特定于应用的密码。 您常规的账户密码将不起作用。 ### Yahoo Mail 1. 进入您的 Yahoo 账户设置中的 Account Security 2. 如果尚未激活，请启用两步验证 3. 在 Generate app password 下，选择 Other app 并复制 结果 指南：https://help.yahoo.com/kb/generate-third-party-passwords-sln15241.html ### Gmail 1. 在您的 Google 账户上启用两步验证 2. 进入 Google Account → Security → App Passwords 3. 选择 Mail 和您的设备，然后复制 结果 连接前您还必须启用 IMAP：Gmail → Settings → See all settings → Forwarding and POP/IMAP → Enable IMAP → Save Changes。 指南：https://support.google.com/accounts/answer/185833 ### Outlook（个人账户） 1. 进入 Microsoft Account → Security → Advanced security options 2. 在 App Passwords 下，选择 Create a new app password 3. 复制结果 注意：工作或学校账户的 IMAP 可能被您的组织 禁用。如果 IMAP 被管理员级别 阻止，Tracemail 将无法连接。 指南：https://support.microsoft.com/en-us/account-billing/using-app-passwords-with-apps-that-don-t-support-two-step-verification-5896ed9b-4263-e681-128a-a6f2979a7944 ## 如何使用 在过滤栏中输入姓名、公司或关键词以加载 所有选项卡。每个选项卡显示相同过滤后 通信记录的不同视图： **列表** – 按时间顺序排列的邮件列表。单击任意行可在 右侧面板阅读完整邮件。 **交流** – 聊天式对话视图。您发送的消息 在右侧以琥珀色显示，接收到的消息在左侧以 紫色显示。可以内联访问附件。为 单条消息添加备注。使用右下角的按钮打印 完整的交流记录。 **附件** – 在过滤后的 交流记录中找到的所有附件，按类型分组。原生预览 PDF，将 XLSX 文件作为表格查看，并内联查看 图像。可单独下载任何文件。 **分析** – 回复率、平均回复时间、最长 空档、首次和最后一次联系、最活跃的工作日、谁开启了 对话，以及回复时间细分。所有指标都是 可点击的。包含具有可调 粒度的活跃度时间线。 **相关** – 正文中提及了过滤关键词但 不属于直接交流的邮件。 ## 支持的附件预览 | 格式 | 预览 | |--------|---------| | PDF | 浏览器原生渲染 | | XLSX | 表格视图 | | DOCX | 提取的文本 | | 图像 (JPG, PNG, GIF, WebP 等) | 内联图像 | | ZIP, XOPP, 其他 | 仅限下载 | ## 资源使用 没有 AI 模型，没有 GPU，没有后台进程。在单次 IMAP 批处理调用中获取邮件 标头。完整的邮件正文和 附件按需加载。可在任何能够运行浏览器的 Linux 硬件上运行。 ## 更新 没有自动更新。请查看 [GitHub Releases](https://github.com/teokitten/tracemail/releases) 获取新版本。下载新的二进制文件并替换 旧文件。 ## 卸载 删除二进制文件： ``` rm tracemail ``` 要删除所有缓存数据，请清除浏览器设置中 `http://127.0.0.1:5050` 的站点数据。这将移除 存储的凭据、缓存的邮件、备注和搜索历史。 ## 已知限制 - 仅支持 Linux – 目前没有 Windows 或 macOS 二进制文件 - Gmail 要求在设置中手动启用 IMAP， 然后才能连接 - Outlook 工作和学校账户的 IMAP 可能被 IT 策略禁用 - 无论选择何种范围，Yahoo IMAP 将日期范围搜索限制为大约 1000 封邮件 - 完整的邮件正文和附件按需加载 – 首次打开邮件需要进行一次服务器 往返 - XOPP 和 ZIP 文件无法预览；请下载以在 本地打开

标签：Mutation, 代码示例, 可视化, 后端开发, 数字取证, 数据分析, 本地工具, 漏洞挖掘, 电子邮件, 自动化脚本, 逆向工具