README.md

---
title: 邮件解析 & AI 分类查看器
emoji: 📧
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
---

# 📧 邮件解析 & AI 分类查看器

> 上传 Outlook `.msg` 邮件文件，自动提取并展示可**一键复制**的关键字段

## ✨ 核心功能

| 功能 | 说明 |
|------|------|
| 📂 .msg 文件解析 | 支持拖拽上传，批量处理多文件 |
| 🏢 公司名提取 | AI 自动识别，支持一键复制 |
| 🏷️ 邮件类型分类 | 8 种标签（Auto reply / Forward / not fit 等）|
| 📝 正文内容展示 | 完整正文可滚动查看，支持一键复制 |
| 💡 邮件摘要 | AI 提炼最关键一句话 |
| 🔌 连接测试 | 界面内直接验证 API Key 是否有效 |

## 🚀 部署到 Hugging Face Spaces

### 步骤 1：创建 Space

1. 访问 [huggingface.co/new-space](https://huggingface.co/new-space)
2. SDK 选择 **Gradio**，Hardware 选 **CPU (Free)**
3. Visibility 选 **Private**（保护邮件隐私）

### 步骤 2：上传文件

将以下文件上传到你的 Space 仓库根目录：
```
app.py
requirements.txt
README.md
src/
  __init__.py
  config.py
  email_parser.py
  ai_classifier.py
```

### 步骤 3：配置 Secrets（可选，启用 AI 分类）

在 Space 的 **Settings → Secrets** 中添加：

```
# 选择其一：
LLM_PROVIDER    = deepseek
DEEPSEEK_API_KEY = sk-your-key

# 或
LLM_PROVIDER    = openai
OPENAI_API_KEY  = sk-your-key
OPENAI_MODEL    = gpt-4o-mini
```

> **不配置 Secrets 也能使用**：只是不会进行 AI 分类，仅展示解析内容。  
> API Key 也可以在界面的配置面板中直接输入。

## 💻 本地运行

```bash
cd wellfound-viewer

# 安装依赖
pip install -r requirements.txt

# 可选：创建 .env 配置 API Key
echo "DEEPSEEK_API_KEY=sk-your-key" > .env

# 启动
python app.py
# 访问 http://localhost:7860
```

## 📊 分类标签

| 标签 | 含义 |
|------|------|
| 🤖 Auto reply | 自动回复邮件 |
| 🔗 career page | 建议访问招聘页 |
| 💬 connect more | 希望进一步了解 |
| 📌 considered | 保留资料，待机会 |
| 🚫 not hiring | 当前不招聘 |
| ❌ do not exist | 邮箱退信 |
| 👋 not fit | 不符合要求 |
| 📤 Forward | 已转发简历 |

## 🔒 隐私说明

- 邮件内容**仅在处理会话期间存在于内存**，不写入磁盘
- API Key 通过 HF Spaces Secrets 配置，不出现在代码中
- 未配置 API Key 时，邮件内容**不会发送**到任何外部服务