本文内容相对轻松，适合准备动手调试、扩展求职派源码的小伙伴。
将从以下部分进行展开，降低大家的学习成本。
- 项目结构说明
- 不同开发环境的说明
- 本地初始化和启动方式
- 关键功能生效的代码路径
- 项目约定
一、项目源码获取
源码申请戳这个链接，一次申请，可以获取星球所有项目源码：https://paicoding.com/ai-agent-projects-guide
我们这次的源码仍然和派聪明、PaiCLI 项目一样，采用了闭源的机制，托管在 GitCode 平台，并且严格按照加微信后发 GitCode 账号的形式才通过审核。
做个项目不容易，相信大家也都能理解。但星球的项目申请一次，你就可以一辈子拥有。
而我，会一直出项目。😄，让你爽个够。
我们这次的源码仍然和派聪明、PaiCLI 项目一样，采用了闭源的机制，托管在 GitCode 平台，并且严格按照加微信后发 GitCode 账号的形式才通过审核。
拿到源码权限后，仓库权限大概是这个样子。
做个项目不容易，相信大家也都能理解。但星球的项目申请一次，你就可以一辈子拥有，这个良心吧。
你可以 clone 到本地，或者直接使用 GitHub 桌面版导入，后期通过 GitHub 桌面版进行代码版本管理。
二、项目初始化与本地启动
1. 导入后端项目
导入到 IntelliJ IDEA 后是下面这个样子。
建议 Maven 的配置和下面的截图一致：Maven 主路径选择「使用 Maven 包装器」，重写用户设置文件不勾选，本地仓库不勾选，使用 .mvn/maven.config 中的设置勾选。
下面简单解释一下这几个选项的区别：
① Maven 主路径：「使用 Maven 包装器」vs「已捆绑（Maven 3）」
- 使用 Maven 包装器：走项目根目录下的
mvnw脚本来执行构建。好处是所有人用的 Maven 版本都由项目的.mvn/wrapper/maven-wrapper.properties统一控制，不管你本地装的是 Maven 3.6 还是 3.9，构建行为都一致。推荐选这个。 - 已捆绑（Maven 3）：走 IDEA 自带的 Maven。如果你的 IDEA 版本比较新，内置的 Maven 版本通常也够用，但不同 IDEA 版本捆绑的 Maven 可能不一样，团队协作时容易出现“我这能跑你那跑不了”的情况。
- 还有一个「本地安装」选项，就是走你系统
PATH里自己装的 Maven，版本完全取决于你个人环境。
② 重写 — 用户设置文件：
- 勾选：可以指定一个自定义的
settings.xml路径，IDEA 构建时会用你指定的这个文件，而不是默认的~/.m2/settings.xml。适合你需要为这个项目单独配一套镜像源或私服地址的场景。 - 不勾选：使用系统默认的
~/.m2/settings.xml。对于大多数人来说，这个文件里已经配好了阿里云镜像，不需要额外覆盖。
③ 重写 — 本地仓库：
- 勾选：可以指定一个自定义目录作为这个项目的本地仓库，下载的 jar 包会放到你指定的位置。适合你想把某个项目的依赖和其他项目隔离开的场景。
- 不勾选：所有项目共享默认的
~/.m2/repository，已经下载过的依赖可以直接复用，省磁盘也省下载时间。绝大多数情况下不需要改。
④ 使用 .mvn/maven.config 中的设置：
- 勾选：IDEA 构建时会自动读取项目根目录下
.mvn/maven.config里预设的参数（比如额外的仓库地址、编译选项等），和你在命令行跑./mvnw install的行为完全一致。求职派项目必须勾选这个，否则可能出现 langgraph4j 等依赖下载失败的问题。 - 不勾选：IDEA 会忽略
.mvn/maven.config，只用 IDEA 自己的默认配置去构建，行为可能和命令行不一致。
导入完成后，建议先在终端执行一次全量构建，确保所有模块都编译通过：
./mvnw install -DskipTests
如果 mvnw 没有执行权限，先运行：
chmod +x mvnw
这一步会把各子模块安装到本地 Maven 仓库，后续 IDEA 编译和命令行启动都不容易遇到跨模块依赖找不到的问题。
2. 初始化环境变量文件
项目根目录下有 .env.example，先复制一份本地 .env：
cp .env.example .env
这份 .env 主要用于本地数据库名、MCP、支付等运行配置覆盖。
3. 拷贝 H2 初始化数据库
默认 dev 环境使用 H2。为了避免污染种子数据，建议复制一份本地开发库：
cp workspace/datas/jobclaw.mv.db workspace/datas/jobclaw-my.mv.db
然后在 .env 中修改数据库名称：
JOBCLAW_DATABASE_NAME=jobclaw-my
这样做的好处是：如果测试过程中数据混乱，可以直接删除 jobclaw-my.mv.db 并重新拷贝一份，不会影响原始种子数据。
4. 启动后端
方式一：IDEA 启动。
- 进入
JobClawApplication主类入口 - 在 main 方法前面的启动标识按钮上点击启动
方式二：命令行启动。
./mvnw spring-boot:run -pl app
-pl app 指定只运行 app 模块，也就是 Spring Boot 主应用所在模块。
启动后直接访问：http://localhost:8087
说明：
项目默认做了字典数据初始化，并集成了两个用户：一个普通用户、一个管理员。
虽然求职派是前后端分离项目，但后端 app/src/main/resources/static/ 目录中已经放了打包好的前端静态资源。因此只启动后端，也能正常访问页面。
:::
5. 前端开发启动（可选）
如果只是后端开发或体验项目，前面的后端启动已经够了。下面的前端步骤仅在你需要修改 ui-react 里的前端代码时执行。
先切换到前端目录：
cd ui-react
安装依赖：
pnpm install
启动前端开发服务：
pnpm dev
回复