interview-guide

用 AI 模拟面试，练出 Offer 收割机

interview-guide 是一个基于 Spring Boot 4.1、Java 21、Spring AI 2.0、PostgreSQL、pgvector、RustFS 和 Redis 构建的 AI 模拟面试与简历分析平台。它解决求职者在面试准备中缺乏针对性练习和反馈的问题，核心能力包括：简历智能解析与技能提取、基于知识库的 RAG 检索增强问答、模拟面试对话生成与评估。项目采用前后端分离架构，后端提供 REST API，前端可能使用 Vue 或 React（未明确）。作为学习型项目，它展示了如何整合 Spring AI 与向量数据库实现 AI 应用，代码结构清晰，适合 Java 开发者学习微服务、AI 集成和 RAG 模式。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3285

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队Snailclimb

所属国家

官网地址https://javaguide.cn/zhuanlan/interview-guide.html

GitHubhttps://github.com/Snailclimb/interview-guide

定价模式free

价格说明开源项目，基于AGPL-3.0许可证，可自行部署使用，无收费计划。

访问状态

是否开源是

开源协议AGPL-3.0

主要语言Java

技术栈/模型gradle,itext7,mapstruct,pgvector,postgresql,rag,redis,redisson,redisstreams,rustfs,springai,springboot,springboot4,tika

GitHub 星标★ 3285

30天Star增速

HF 下载量

上线时间2026-01-03 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：进阶约 20 分钟部署方式：Docker 7 步

环境要求

JDK 25（必需）
Node.js 18+ 与 pnpm 10+（前端构建，packageManager 指定 10.26）
Docker（推荐，用于一键启动依赖服务）
不使用 Docker 时需自行安装 PostgreSQL 14+（含 pgvector 扩展）、Redis 6+ 和 S3 兼容存储
申请 DashScope（阿里云百炼）API Key，用于文本模型、ASR 和 TTS

安装与启动步骤

1克隆项目代码

把仓库拉取到本地，后续所有命令都在项目根目录执行。
```
git clone https://github.com/Snailclimb/interview-guide.git
cd interview-guide
```
2准备环境变量

复制示例文件为 .env，后端 bootRun 会自动读取根目录 .env。
```
cp .env.example .env
```
3填入 AI API Key

编辑 .env，最少填写 AI_BAILIAN_API_KEY，还可按需调整面试参数配置。
4启动依赖服务

可选步骤，用 dev compose 一键启动 PostgreSQL、Redis、RustFS 三个依赖。
```
docker compose -f docker-compose.dev.yml up -d
```
5启动后端

用 Gradle 启动 Spring Boot 应用，成功后监听 8080 端口。
```
./gradlew :app:bootRun
```
6启动前端

进入 frontend 目录安装依赖并启动开发服务器，监听 5173 端口。
```
cd frontend
corepack enable
pnpm install
pnpm dev
```
7Docker 一键部署

想整体容器化运行（前后端+数据库+中间件共 6 个服务）时使用此方式。
```
docker-compose up -d --build
```

关键配置

配置项	必填	说明	示例
`AI_BAILIAN_API_KEY`	是	DashScope 密钥，供文本模型、ASR、TTS 使用	`sk-xxxxxxxx`
`POSTGRES_PORT`	否	本机 5432 被占用时可修改的数据库端口	`5432`
`REDIS_PORT`	否	本机 6379 被占用时可修改的 Redis 端口	`6379`

如何确认成功

访问 http://localhost:8080（后端）与 http://localhost:5173（前端）可打开；docker ps 中 interview-postgres 显示 0.0.0.0:5432->5432/tcp。

常见问题

Q：启动时报 Connection to localhost:5432 refused 怎么办？

A：通常不是 Flyway 脚本错误，而是后端从宿主机连不上 PostgreSQL。先执行 docker compose -f docker-compose.dev.yml up -d，再用 docker ps 确认容器端口映射为 0.0.0.0:5432->5432/tcp。

Q：容器只显示 5432/tcp，没有 0.0.0.0 映射怎么办？

A：说明旧容器没应用端口映射配置，重建即可：docker compose -f docker-compose.dev.yml up -d --force-recreate postgres redis。

Q：本机 5432 或 6379 被其他项目占用怎么办？

A：修改 .env 中的 POSTGRES_PORT / REDIS_PORT，并同步调整 docker-compose.dev.yml 的端口映射，保证应用配置与容器发布端口一致。

Q：不用 Docker 可以运行吗？

A：可以，但需自行安装 PostgreSQL 14+（含 pgvector 扩展）、Redis 6+ 和 S3 兼容存储，并保证 .env 中的连接信息与之一致。

Q：只想本地调试后端，不想启动全部容器？

A：只启动基础设施即可：docker compose up -d postgres redis minio createbuckets，Bucket 会由初始化任务或应用启动检查自动创建。

注意事项

Docker 方式的数据通过命名卷持久化，执行 docker-compose down 不会丢失数据。
.env.example 中 PostgreSQL、Redis、MinIO 默认账号已与 docker-compose.yml 对齐；若曾用过不同密码，需同步修改 .env，必要时重建 Postgres 卷。
拉取新代码后重新构建部署仍使用 docker-compose up -d --build。
README 中的配套教程为付费内容，但项目承诺完整功能免费开源，无 Pro 版。

核心亮点

技术栈新，整合 Spring AI 2.0 + pgvector，紧跟 AI 应用开发趋势
功能闭环，从简历分析到模拟面试再到知识库检索，覆盖求职准备全流程
代码结构清晰，适合作为 Spring Boot + AI 学习范例

不足之处

文档/社区待观察
依赖外部 AI 服务（如 OpenAI），可能产生 API 费用

适用场景

求职者准备技术面试，进行模拟练习
Java 开发者学习 Spring AI 与 RAG 集成
作为简历项目展示 AI 应用开发能力

替代项目

Pramp、InterviewBit、LeetCode 模拟面试

项目介绍

interview-guide 是学习教育领域的开源项目，由 Snailclimb 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,285）位列前 30%，在学习教育分类中处于中上游。

近 42 天，它的 GitHub 星标从 3,009 增加到 3,285，净增 276。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。基于AGPL-3.0许可证，可自行部署使用，无收费计划。

它主要面向的使用场景是：求职者准备技术面试，进行模拟练习。同类可对比的替代方案包括 Pramp、InterviewBit、LeetCode 模拟面试。

上一篇：GenAI-Showcase

下一篇：second-brain-ai-assistant-course