README.md

metadata

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
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 也可以在界面的配置面板中直接输入。

💻 本地运行

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 时，邮件内容不会发送到任何外部服务