interview-guide

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 787 🐛 待处理 8 👀 关注 7

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3479

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，基于AGPL-3.0许可证，可自行部署使用，无收费计划。

项目预览

项目数据

分类搜索知识

开发团队Snailclimb

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

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议AGPL-3.0

主要语言Java

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

GitHub 星标★ 3479

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

代码更新2026-10-08

仓库体积8.4 MB

本站数据更新2026-11-09

维护状态维护中

收录时间2026-08-09

浏览次数3

项目介绍

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 模式。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3479

技术标签

pgvector postgresql rag redis springai

使用教程

难度：进阶约 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 版。