如何使用 B.AI API Key 接入 DeepSeek Harness
本文以
deepseek-v4-flash为配置示例。B.AI 提供的其他 DeepSeek 模型，如支持通过 OpenAI 兼容接口调用，也可以按照相同方式接入 DeepSeek Harness。配置时，请填写该模型在 B.AI 中的准确模型 ID，并尽量从可用模型列表中选择。本文所述步骤已在 DeepSeek Harness Web（
@deepseek-ai/dsh 0.1.0-rc.7）中验证。其他版本的界面或参数行为可能有所不同。
DeepSeek Harness 是什么
DeepSeek Harness 是 DeepSeek 官方推出的开源 AI Agent 工具。它可以在指定的本地工作区中读取文件、修改代码、运行命令并完成多步骤任务。
需要注意：DeepSeek Harness 的界面和工具运行在本地，但模型推理由 B.AI 云端 API 完成。为了完成任务，用户输入、代码上下文、文件片段和工具执行结果可能被发送至 B.AI。
请勿在未经授权的情况下处理包含商业机密、个人隐私或其他敏感信息的项目。
DeepSeek Harness 当前仍处于开发预览阶段，后续版本可能调整界面、配置路径或参数行为。请查看 DeepSeek Harness 官方项目。
使用前准备
开始前需要准备：
- 已安装 Node.js 的电脑
- 一个有效的 B.AI API Key
- 可用的 B.AI 账户额度或模型权限
- 一个用于测试的本地文件夹
建议使用 Node.js 当前的长期支持版本，并先在终端中执行：
node --version
npm --version
如果两个命令都能正常输出版本号，说明 Node.js 和 npm 已经可以使用。
创建安全的测试工作区
DeepSeek Harness 启动时所在的目录会成为默认工作区候选。不要直接在个人主目录或存放重要资料的目录中启动。
建议先创建一个测试目录：
mkdir dsh-test
cd dsh-test
如果需要处理已有项目，建议先备份项目，或者在项目副本中测试。
安装并启动 DeepSeek Harness
方式一：使用 npx 直接启动
在测试目录中执行：
npx @deepseek-ai/dsh web
第一次运行时，npm 可能需要下载相关软件包。启动成功后，在浏览器中打开：
http://127.0.0.1:3080
该地址默认仅供本机访问。运行期间不要关闭启动终端；如果需要停止 DeepSeek Harness，可以在终端按 Ctrl+C。
DeepSeek Harness 官方提供的 Web 启动方式是 npx @deepseek-ai/dsh web，默认端口为 3080。请查看 官方启动说明。
方式二：全局安装
如果需要经常使用，可以全局安装：
npm install -g @deepseek-ai/dsh
安装完成后使用以下命令启动：
dsh web
准备 B.AI API Key
登录 B.AI，在 API Key 管理页面创建一个新的 API Key。
Key 通常以 sk- 开头，例如：
sk-xxxxxxxxxxxxxxxx
请妥善保存 API Key，并遵守以下安全要求：
- 不要把完整 Key 放进截图、群聊或公开文档
- 不要把 Key 写入公开代码仓库
- 不同项目尽量使用不同的 Key
- 如果 Key 已经公开，应立即删除旧 Key 并创建新 Key
- 教程截图中的 Key 应显示为
sk-****...****
B.AI 支持通过 Bearer Token 或 x-api-key 进行认证。请查看 B.AI API 与安全说明。
在 DeepSeek Harness 中添加 B.AI
打开 DeepSeek Harness 后：
- 点击“设置”。
- 进入“模型”。
- 点击“添加自定义提供方”。
- 按照下表填写。
| 配置项 | 填写内容 |
|---|---|
| Provider ID | b-ai |
| API 密钥 | 用户自己的 B.AI API Key |
| 显示名称 | B.AI |
| API 地址 | https://api.b.ai/v1 |
| API 协议 | openai-completions |
Provider ID 必须以小写字母开头。它用于唯一标识该提供方，并关联已保存的会话和凭证；创建提供方后无法修改。本文建议填写 b-ai。
API Key 输入框中只需要粘贴 Key 本身：
sk-xxxxxxxxxxxxxxxx
不要填写成：
Bearer sk-xxxxxxxxxxxxxxxx
为什么 API 地址要包含 /v1
B.AI 官方 API Base URL 是：
https://api.b.ai
其 OpenAI 兼容聊天接口是：
POST /v1/chat/completions
因此，在 DeepSeek Harness 的自定义提供方配置中填写：
https://api.b.ai/v1
为什么协议选择 openai-completions
虽然 DeepSeek Harness 中的选项名称是 openai-completions，但它在这里表示 OpenAI 兼容协议适配器，最终调用的是 B.AI 的 /v1/chat/completions 接口。
添加 DeepSeek 模型
本文以 DeepSeek V4 Flash 为例。在“模型目录”中点击“获取可用模型”，选择 deepseek-v4-flash，然后点击“添加所选”。
建议从可用模型列表中选择，以使用 B.AI 当前返回的模型 ID。如果需要手动添加模型，请填写 B.AI 实际支持的准确模型 ID：
deepseek-v4-flash
不要根据显示名称自行猜测模型 ID。上下文窗口和输出限制应根据所选模型及实际任务决定，本文不为用户预设具体数值；如需了解模型能力，请查看对应的 B.AI 模型页面。
点击“创建提供方”保存配置。
接入其他 DeepSeek 模型
DeepSeek V4 Flash 只是本文的配置示例。用户也可以按照相同方法接入 B.AI 提供的其他 DeepSeek 模型。
接入其他模型时，建议先在“获取可用模型”列表中选择。若手动添加，则需要填写准确的模型 ID，也可以填写显示名称。
可以通过以下方式确认模型 ID：
- 点击 DeepSeek Harness 中的“获取可用模型”
- 查看 B.AI 官方模型目录
- 调用 B.AI 的
GET /v1/models接口
例如，如果接入 DeepSeek V4 Pro，对应模型 ID 为：
deepseek-v4-pro
不同模型的能力可能不同；请按需查看对应的 B.AI 模型页面，不要根据本文示例推定参数。
如果只使用一个模型，模型目录中只保留该模型即可。
开始第一次测试
创建提供方后：
- 返回 DeepSeek Harness 主界面。
- 新建一个会话。
- 选择提供方
B.AI。 - 选择刚刚添加的 DeepSeek 模型。
- 点击“选择工作区”，添加并选中
dsh-test文件夹作为当前工作区。 - 发送测试消息。
新的 DeepSeek Harness Web UI 不会自动选中工作区；未选择工作区时，消息输入框和发送按钮不可用。
建议第一次发送：
只回复“连接成功”，不要读取、创建或修改任何文件。
如果模型成功返回，说明以下配置已经生效：
- DeepSeek Harness 已正常启动
- B.AI API Key 有效
- API 地址和协议正确
- 模型 ID 可以正常调用
接下来可以测试只读项目分析：
请先只读检查当前项目，说明项目使用了什么技术栈，不要修改任何文件。
确认结果正常后，再让 Agent 执行文件修改或命令操作。