使用指南

以 DeepSeek 为例

1. 访问 platform.deepseek.com，注册账号
2. 登录后进入「API Keys」页面
3. 点击「创建 API Key」，复制生成的 Key
4. 在 HRBuddy 的配置页面中，选择 DeepSeek 作为 Provider，粘贴 API Key

其他支持的 LLM

1. 下载安装包

从 下载页面 下载 Windows 版本的安装包（.bat 文件）。

2. 运行安装脚本

双击 hrbuddy-setup.bat 文件，自动完成以下操作：

• 检测并自动安装 Node.js（国内镜像，无需管理员权限）
• 下载 HRBuddy 服务端
• 自动启动并在浏览器中打开

3. 日常使用

安装完成后，在命令行中输入：

hrbuddy

浏览器会自动打开 http://localhost:3000

1. 下载安装包

从 下载页面 下载 macOS 版本的安装包（.sh 文件）。

2. 运行安装脚本

下载的文件在 ~/Downloads 目录，打开终端，执行以下命令：

cd ~/Downloads && chmod +x hrbuddy-setup.sh && ./hrbuddy-setup.sh

脚本会自动检测并安装 Node.js（通过 Homebrew），然后启动 HRBuddy。

3. 日常使用

安装完成后，在终端中输入：

hrbuddy

浏览器会自动打开 http://localhost:3000

Windows

:: 删除安装目录
rmdir /s /q %USERPROFILE%\hrbuddy

:: 删除配置文件
rmdir /s /q %USERPROFILE%\.hrbuddy

:: 从 PATH 中移除（需要重启终端生效）
setx PATH "%PATH:C:\Users\你的用户名\hrbuddy;=%"

macOS

# 删除安装目录
rm -rf ~/hrbuddy

# 删除配置文件
rm -rf ~/.hrbuddy

# 删除 PATH 软链接（如果存在）
sudo rm -f /usr/local/bin/hrbuddy

Q: hrbuddy 命令找不到？

请重新打开终端窗口。如果仍然找不到，Windows 用户可以手动将 %USERPROFILE%\hrbuddy 添加到 PATH 环境变量。

Q: 需要联网吗？

是的，HRBuddy 需要联网才能使用。LLM 调用需要网络连接。

Q: API Key 安全吗？

API Key 存储在本地 ~/.hrbuddy/config.json，不会上传到任何服务器。

Q: 支持哪些 LLM？

支持 DeepSeek、OpenAI、Claude、Gemini、Mistral、Groq、Kimi、MiniMax、Xiaomi MiMo 等主流 LLM。

Q: 如何停止 HRBuddy？

在运行 HRBuddy 的终端窗口按 Ctrl+C 即可停止。

Q: 如何卸载？

参见上方「卸载」章节，删除安装目录和配置文件即可。

Q: 删除安装包后还能用吗？

可以。安装包（.bat/.sh）只是一次性安装脚本，安装完成后就可以删除。HRBuddy 的所有文件已安装到 ~/hrbuddy 目录，日常使用只需运行 hrbuddy 命令即可。