01 /
安装与准备
先准备 Node.js、个人 API Key 和模型 ID。
安装前检查
- 使用 Node.js 24 或更新版本，并确认 node --version 输出正确。
- 在个人控制台创建一个专用 API Key。
- 从模型目录复制准确的模型 ID，不要手写近似名称。
安装 Harness
按项目提供的安装方式完成安装。
终端bash
npm install -g deepseek-harness
deepseek-harness --version02 /
配置 Router
把 API 地址和 Key 写入 Harness 的个人配置。
环境变量
建议使用环境变量，避免把 Key 写进项目文件。
macOS / Linuxbash
export OPENAI_API_KEY="sk-mengbi-xxxxxx"
export OPENAI_BASE_URL="https://router-api.mengbi-ai.net/v1"Windows PowerShellpowershell
$env:OPENAI_API_KEY="sk-mengbi-xxxxxx"
$env:OPENAI_BASE_URL="https://router-api.mengbi-ai.net/v1"启动与验证
启动 Harness 后发送一条最简单的任务。能返回结果即表示配置生效；报模型不存在时，重新从模型目录复制 ID。
Note不同版本的 Harness 配置字段可能不同；优先使用它的 OpenAI-compatible 配置入口。
03 /
常见问题
先判断是环境变量、模型 ID 还是请求协议问题。
Key 未生效
- 重新打开终端或应用。
- 检查当前进程是否能读取 OPENAI_API_KEY。
- 不要把 Key 放到前端代码或 git 仓库。