JustHireMe

环境要求

• Windows / macOS(Apple Silicon) / Linux(Debian、Ubuntu) 桌面系统，用于安装官方安装包
• 网络连接：首次启动需通过 HTTPS 下载 runtime pack（浏览器 + 向量库 + 嵌入模型）
• 源码构建方式额外需要 Node.js 与 npm（执行 npm ci）
• 源码构建方式额外需要 uv（执行 uv sync）与 Tauri 构建环境

安装与启动步骤

1. 1下载对应安装包

   打开最新 GitHub Release 页面，按你的平台选择资产：Windows 选 _x64-setup.exe，macOS(Apple Silicon) 选 _aarch64.dmg，Linux 选 _amd64.deb 或 _amd6

2. 2安装桌面应用

   Windows 双击 setup.exe，若出现 SmartScreen 点“更多信息”->“仍要运行”；macOS 打开 dmg，若提示应用已损坏/未验证，去 系统设置 -> 隐私与安全性 -> 仍要打开。

3. 3Linux 安装 deb

   Debian/Ubuntu 用户用 dpkg 安装下载好的 deb 包，文件名按实际版本号填写。

   sudo dpkg -i JustHireMe_*_amd64.deb

   复制

4. 4Linux 运行 AppImage

   便携版先加可执行权限再运行，无需安装到系统。

   chmod +x JustHireMe_*_amd64.AppImage
   ./JustHireMe_*_amd64.AppImage

   复制

5. 5克隆源码仓库

   想用 Tauri 外壳加 Python 后端 sidecar 的完整开发环境时，先克隆仓库并进入目录。

   git clone https://github.com/vasu-devs/JustHireMe.git
   cd JustHireMe

   复制

6. 6安装前端依赖

   在仓库根目录安装 Node 依赖，使用 npm ci 保证按 lock 文件安装。

   npm ci

   复制

7. 7同步后端依赖

   进入 backend 目录，用 uv 同步 Python 依赖（含开发依赖），完成后回到仓库根目录。

   cd backend
   uv sync --dev
   cd ..

   复制

8. 8启动开发模式

   运行 Tauri 开发命令，它会启动前端并拉起 Python 后端 sidecar/开发进程。仅在开发官网或跑完整本地检查时才需安装 website 目录的 npm ci。

   npm run tauri dev

   复制

关键配置

如何确认成功

桌面应用窗口正常打开即成功；首次启动会自动通过 HTTPS 下载并缓存 runtime pack（浏览器 + 向量库 + 嵌入模型），之后可离线启动。开发模式则 Tauri 窗口弹出并同时启动 Python 后端进程。

常见问题

注意事项

• 安装包由 GitHub Actions 从 release tag 构建，Release notes 中提供 SHA256 校验和，可用于核对下载文件。
• 不要分享含 API Key、Cookie、私人简历或个人数据的截图、日志、issue 附件或数据库文件。
• 应用会从最新 GitHub Release 自动更新，无需手动升级。
• 仅在开发官网或运行完整本地检查时，才需要进入 website 目录执行 npm ci。