DeepSeek Harness - 88API 配置教程
在 DeepSeek Harness Web UI 中添加 88API 自定义提供方，配置 Responses 协议和 DeepSeek 模型
DeepSeek Harness（dsh）是 DeepSeek AI 开源的 Agent Harness。本教程介绍如何在它的 Web UI 中添加 88API 自定义提供方，并使用 deepseek-v3.2、deepseek-v4-flash 和 deepseek-v4-pro。
开发者预览
DeepSeek Harness 目前仍处于开发者预览阶段，官方明确提示后续可能出现破坏兼容性的变更。如果界面文字略有不同，请以“设置 → 模型 → 添加自定义提供方”这条路径为准。
- 官方项目：https://github.com/deepseek-ai/deepseek-harness
- 官方 Web UI 指南：Use the Web UI
- 官方模型配置指南：配置模型
配置速查
| DeepSeek Harness 配置项 | 填写内容 |
|---|---|
| Provider ID | api |
| 显示名称 | 88API |
| API 地址 | https://88api.ai/v1 |
| API 协议 | openai-responses |
| API 密钥 | 在 88API 控制台创建的 API Key |
| 模型 | deepseek-v3.2、deepseek-v4-flash、deepseek-v4-pro |
Provider ID 必须使用小写字母开头。它会写入请求路由、已保存会话和凭据引用，保存后不要随意更改。显示名称只影响界面显示，可以填写 88API。
使用前准备
- 安装 Node.js。
- 注册并登录 88API，确认账户有可用余额。
- 在 88API 控制台创建一个 API Key。
- 确认当前 API Key 可以使用准备添加的 DeepSeek 模型。
- 准备一个测试项目目录。DeepSeek Harness 可以读取和修改所选工作区文件，因此首次测试建议使用容易回滚的项目。
建议为 DeepSeek Harness 单独创建 API Key，并按需设置额度或访问范围。不要把完整密钥写进教程、截图、项目文件或聊天消息。
1. 启动 DeepSeek Harness Web UI
在准备作为工作区的项目目录中打开终端，运行官方启动命令：
npx @deepseek-ai/dsh web命令启动后会打印 Web UI 地址，默认通常是：
http://127.0.0.1:3080在浏览器中打开该地址。dsh 会把启动命令所在目录作为默认文件系统位置，但新 Web UI 仍需要你在界面中选择工作区。
2. 获取 88API 密钥
进入 88API 控制台的“API 密钥”页面，创建或选择一个现有密钥，然后复制 API Key。
API Key 只应粘贴到 DeepSeek Harness 的提供方配置窗口。不要将密钥保存到项目仓库。
3. 添加 88API 自定义提供方
- 点击 DeepSeek Harness 左下角的“设置”。
- 进入“模型”。
- 点击“添加自定义提供方”。
- 按下表填写提供方信息。
| 字段 | 填写值 | 说明 |
|---|---|---|
| Provider ID | api | 小写且保存后不随意更改 |
| 显示名称 | 88API | 用于模型列表分组显示 |
| API 地址 | https://88api.ai/v1 | 填基础地址，不额外拼接接口路径 |
| API 协议 | openai-responses | 本教程所用的 Responses 兼容协议 |
| API 密钥 | 你的 88API API Key | 粘贴完整密钥，前后不要带空格 |
上图中的密钥已经由界面遮挡。DeepSeek Harness 官方说明，密钥保存后只会返回脱敏描述，不会把明文密钥重新显示在设置页面。
4. 添加模型目录
在同一个配置窗口的“模型目录”中添加以下模型。模型 ID 和显示名称可以先填写成相同值：
| 模型 ID | 显示名称 |
|---|---|
deepseek-v3.2 | deepseek-v3.2 |
deepseek-v4-flash | deepseek-v4-flash |
deepseek-v4-pro | deepseek-v4-pro |
模型名称必须与 88API 当前向你的账户提供的模型名称完全一致，包括大小写、连字符和版本后缀。不要填写渠道数字 ID，也不要自行改写模型名称。
如果你的账户只开放了其中一部分模型，只添加实际可用的模型即可。以后可以重新编辑 88API 提供方增加或删除模型。
5. 保存并确认提供方
保存配置后，返回“设置 → 模型”。列表中应出现名为 88API 的自定义提供方，并显示绿色可用状态。
如果没有看到 88API，重新打开自定义提供方配置，检查 Provider ID、API 地址、协议、密钥和模型目录是否已经完整保存。
6. 选择 88API 模型
关闭设置窗口并新建会话。点击输入框底部的模型名称，在模型列表的 88API 分组中选择需要使用的模型。
配置正确时，可以看到：
deepseek-v3.2deepseek-v4-flashdeepseek-v4-pro
选择模型也会把它设为新会话的默认模型。已经发送过请求的旧会话会继续保留自身记录的模型；切换提供方或模型后，建议新建会话测试。
7. 选择工作区并测试
- 点击“选择工作区”。
- 添加并选择准备测试的项目目录。
- 新建会话并确认底部选中的是
88API分组下的模型。 - 先发送一个只读任务：
请概括当前项目的目录结构，先不要修改文件，也不要运行安装命令。确认可以正常回复后，再测试一个范围明确、容易回滚的修改任务。DeepSeek Harness 能够读取和编辑工作区、运行命令及调用插件，首次使用时应留意每个权限确认提示。
8. 在 88API 验证请求
打开 88API 控制台，进入“使用日志”，确认出现刚才的请求记录。
重点核对：
- 请求使用了刚才选择的模型；
- 状态成功，没有持续重试；
- Token 和费用与测试任务规模相符；
- 请求时间与 DeepSeek Harness 测试时间一致。
验证清单
88API已显示在模型提供方列表中；- 提供方状态正常；
- 三个模型或当前账户实际可用的模型已加入目录；
- 新会话可以从
88API分组选择模型； - 简单只读任务能够正常回复；
- 需要 Agent 能力的模型能够按权限策略调用工具；
- 88API 使用日志中出现对应请求。
常见问题
提示 401、认证失败或 MISSING_CREDENTIAL
重新从 88API 控制台复制 API Key，检查密钥前后是否带有空格或换行。确认密钥没有被禁用、额度可用，并且已经保存在 88API 自定义提供方中。
提示 UNKNOWN_MODEL 或模型不存在
返回 88API 查看当前账户实际可用的模型名称，然后把名称原样填入模型目录。不要填写渠道 ID、中文展示名称或自己创建的别名。
如果修改了模型目录，请新建会话再测试，旧会话会保留之前记录的模型。
返回 404 或接口不兼容
检查以下两项：
- API 地址应为
https://88api.ai/v1； - API 协议应为
openai-responses。
不要在 API 地址后重复添加 /responses。地址字段填写基础地址，具体请求路径由 DeepSeek Harness 根据协议生成。
保存后找不到 88API 提供方
确认点击的是“添加自定义提供方”，并且至少添加了一个模型。Provider ID 必须以小写字母开头；如果需要修改已经保存的 Provider ID，应删除旧提供方后重新添加。
模型可以回复，但不能修改代码或调用工具
先确认已经选择工作区，并检查 DeepSeek Harness 的权限策略和操作审批。普通对话成功不代表模型一定适合 Agent 编程；还需要模型、协议和上游服务正确支持工具调用。
切换模型后旧会话仍使用原模型
这是 DeepSeek Harness 的会话行为：已经发送过请求的会话会保留日志中记录的模型。新建会话后重新选择 88API 模型即可。