# 智能简历系统

**Repository Path**: hicupping/smart-resume-system

## Basic Information

- **Project Name**: 智能简历系统
- **Description**: 一个智能简历系统，帮助hr自动筛选简历，可以自动读取qq邮箱信件通过ai进行评分处理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-08
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简历自动分类与评分系统（smart-resume-system）

面向 HR 的本地化简历自动处理系统：自动收取邮箱简历 → 解析 → AI 两阶段评估 → 归档与入选管理。

## 获取代码

本仓库采用**单文件版本包**发布——每个版本一个完整源码压缩包，直接下载最新 zip 解压即可：

```
smart-resume-system_v0.3.0_20260921.zip   ← 最新版本
```

版本间的变更说明见 [CHANGELOG.md](CHANGELOG.md)。

## 快速开始

```bash
# 1. 解压版本包，进入目录双击 start.bat（自动建虚拟环境、装依赖、启动服务）
# 2. 首次启动会要求编辑 .env（参考 .env.example 填入邮箱授权码与大模型 API Key）
# 3. 浏览器访问 http://127.0.0.1:8765
```

## 核心能力

- **全自动收件**：IMAP 轮询（2-4 分钟随机抖动），启动即补扫积压邮件
- **两阶段 AI 评估**：一级分类（有效投递判定）→ 二级逐维度打分（对照岗位 JD 与用户画像），置信度不足自动重试，绝不因系统故障误杀候选人
- **主备模型串行降级**：主模型失败才用备用，全挂时规则引擎兜底（verdict 恒为待定）
- **隐私强制脱敏**：姓名/手机号/邮箱掩码后才出网，发送前残留检测 fail-closed，配置层面禁止关闭
- **入选管理**：岗位名额、按候选人排名、本地文件入选/未入选目录自动同步
- **人工改判**：判定/岗位/分数改判带审计流水，重复投递同步改判，本地文件自动搬家

## 技术栈

FastAPI · SQLAlchemy · SQLite · APScheduler · DeepSeek/Qwen（OpenAI 兼容）· React · Vite · Ant Design · ECharts

## 目录结构（包内）

```
app/          后端（api/scheduler/evaluator/llm/parsers/archive/privacy）
web/          前端源码
tests/        单元测试（42 个用例）
config.yaml   全局配置
start.bat     一键启动
```

> 隐私说明：数据库、简历文件、密钥（.env）均在本地，不进版本库。