# super-interviewer

**Repository Path**: GWanan/super-interviewer

## Basic Information

- **Project Name**: super-interviewer
- **Description**: 基于Flask + Coze AI的智能求职助手，支持职位查询、简历分析和模拟面试功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-05-21
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# super_interviewer - AI智能面试助手
基于 Flask + Coze API 开发的全流程面试辅助系统，提供岗位搜索、简历智能分析、个性化面试题生成、面试作答专业点评四大核心功能，帮助求职者高效准备技术面试。

---

## ✨ 核心功能
1.  **岗位搜索**：根据岗位名称和城市，快速获取目标岗位招聘信息，明确岗位核心要求
2.  **简历智能分析**：结合目标岗位要求，精准识别简历存在的问题，提供可落地的优化建议
3.  **个性化面试题生成**：根据简历内容和岗位核心技术栈，生成针对性面试题，覆盖基础知识点、项目场景、综合能力三类题型
4.  **面试作答专业点评**：对用户的面试回答进行多维度专业点评，分析得分点、不足之处及具体优化方向

---

## 🛠️ 技术栈
- **后端框架**：Python 3.x + Flask
- **核心依赖**：Flask、requests、python-dotenv
- **AI能力**：Coze 大模型工作流
- **前端**：原生 HTML + Jinja2 模板渲染

---

## 📁 项目目录结构
```plaintext
super_interviewer/
├── api_code/                # 接口业务代码目录
│   ├── job_search.py        # 岗位搜索接口
│   ├── resume_analysis.py   # 简历智能分析接口
│   ├── interview_question.py # 个性化面试题生成接口
│   └── interview_judge.py   # 面试作答点评接口
├── templates/               # 前端HTML模板目录
│   ├── job-search.html      # 岗位搜索首页
│   ├── job-list.html        # 岗位搜索结果页
│   ├── resume-analysis.html # 简历分析输入页
│   ├── resume-result.html   # 简历分析结果页
│   ├── interview.html       # 面试功能引导页
│   ├── interview_questions.html # 面试答题页
│   └── interview_result.html # 面试点评结果页
├── .env                     # 本地环境配置文件（需自行创建，不上传仓库）
├── .env.example             # 环境配置文件示例
├── .gitignore               # Git忽略文件配置
├── app.py                   # 项目入口文件，主路由配置
├── requirements.txt         # 项目依赖清单
└── venv/                    # 本地虚拟环境（不上传仓库）
```

---

## 🚀 快速开始
### 1. 环境准备
确保本地已安装 Python 3.8 及以上版本和 Git 工具

### 2. 克隆项目
```bash
git clone https://gitee.com/你的Gitee用户名/super_interviewer.git
cd super_interviewer
```

### 3. 安装依赖
```bash
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境（Windows系统）
venv\Scripts\activate

# 安装所有项目依赖
pip install -r requirements.txt
```

### 4. 配置环境变量
1.  复制项目根目录下的 `.env.example` 文件，重命名为 `.env`
2.  打开 `.env` 文件，填写你的 Coze 配置信息：
```env
# Coze API 个人访问令牌
COZE_API_TOKEN=你的Coze个人访问令牌

# Coze 工作流ID
COZE_WORKFLOW_JOB=岗位搜索工作流ID
COZE_WORKFLOW_RESUME=简历分析工作流ID
COZE_WORKFLOW_INTERVIEW=面试题生成工作流ID
COZE_WORKFLOW_JUDGE=面试点评工作流ID
```

### 5. 启动项目
```bash
python app.py
```
项目启动成功后，在浏览器中访问 `http://127.0.0.1:5000` 即可使用系统。

---

## ⚠️ 注意事项
1.  请妥善保管 `.env` 文件中的敏感信息，绝对不要上传到任何公开代码仓库
2.  确保所有 Coze 工作流已发布，且你的 API Token 拥有对应工作流的访问权限
3.  虚拟环境目录 `venv/`、PyCharm 配置目录 `.idea/` 已配置在 `.gitignore` 中，不会被提交到仓库

---

## 📄 开源协议
MIT License