dead-letter 是一个将 .eml 邮件导出文件转换为干净、本地、LLM 就绪 Markdown 的工具，输出包含 YAML front matter。其核心目标是把原始 MIME 和 base64 噪音从上下文中移除，同时保留邮件线程结构、发件人归属、链接和附件元数据。
主要能力包括：完整保真转换（HTML 清理、Gmail/Outlook 线程分割、内联图片处理、日历事件摘要）、单文件或整个目录递归转换、JSON 转换报告、质量诊断（附件引用/保留计数）、可选的签名图片和跟踪像素剥离、捆绑转换（Markdown + 附件 + 源文件在同一目录）。
使用方式多样：CLI 直接指向文件或目录即可；本地 Web UI 提供暗色指挥中心界面，支持拖放导入、监视模式、转换等级徽章、处理历史和每任务诊断；MCP 服务器可集成 Claude Desktop、Claude Code、Codex 等 MCP 客户端；Claude 插件提供五个斜杠命令（/dead-letter:convert、/dead-letter:summarize、/dead-letter:triage、/dead-letter:cabinet、/dead-letter:mbox）；可移植 Agent Skill 可安装到各类代理；Python API 通过 from dead_letter import convert 调用。安装支持 uv、Homebrew（仅核心 CLI）和 pipx。
适用场景：邮件转 Markdown 归档、RAG 与 LLM 摄入、代理工作流、知识库迁移（如 Obsidian 或本地搜索）、数字保存。
已知限制：CLI/Python 接受 .eml、扁平 .mbox 导出以及 0.4.5 起支持 ZIP/TGZ Takeout 下载；Web UI 仅支持 EML；MCP 服务器从 0.4.5 起增加有界 convert_mbox 工具。不支持 PST、MSG 和实时邮箱连接。0.4.6 起 CLI/Python 提供可选的可恢复 MBOX 导入（--mbox-resume）。本地单用户单机，无远程服务器或认证服务，内存作业注册表在重启后重置，保留的二进制附件需要单独的解析器进行文本索引。许可证为 PolyForm Noncommercial 1.0.0，个人、教育和非营利使用免费，商业使用需单独许可。
