Skip to main content
DeepSeek Harness(dsh)是 DeepSeek 开源的 Agent Harness,核心设计是 Everything is a Plugin。它支持 Web UI、插件化模型提供方,以及自定义 OpenAI 兼容端点。

前置条件

安装与启动

在终端执行:
默认会启动 Web UI,地址通常是:
DeepSeek Harness 目前仍处于 Developer Preview,后续版本可能会出现不兼容变更。如果配置项名称发生变化,请优先以 Harness 当前版本的设置页和官方文档为准。

通过 Web UI 配置 Teio

1

访问 Web UI

启动后访问 http://127.0.0.1:3080
2

跳过官方模型配置

首次进入时会提示配置 DeepSeek 官方模型。这里先选择 稍后设置,后面再添加 Teio 提供方。
Screenshot 2026 08 17 At 14 17 00
3

打开模型设置

进入 设置 → 模型
Screenshot 2026 08 17 At 14 18 22
4

添加自定义提供方

选择 添加自定义提供方,用于配置 Teio 这类 OpenAI 兼容网关。
Screenshot 2026 08 17 At 14 20 13
5

填写 Teio 连接信息

Provider ID:teio显示名称:TeioAPI 地址:https://teio.me/v1API 协议:openai-completionsAPI 密钥:填写你在 Teio 创建的 API 密钥
Screenshot 2026 08 17 At 14 22 05
6

设置模型

点击 获取可用模型,在弹窗中选择需要使用的模型。
Screenshot 2026 08 17 At 14 25 04
7

保存提供方

保存后,Teio 会出现在模型选择器中。
Screenshot 2026 08 17 At 14 25 39
8

选择模型并开始使用

在聊天页面选择工作区,然后选择 teio/你的模型名,即可开始使用。
Screenshot 2026 08 17 At 14 29 22

常见问题

先确认终端里 npx @deepseek-ai/dsh web 没有退出,并查看输出中的实际访问地址。默认地址通常是 http://127.0.0.1:3080,如果端口被占用,Harness 可能会使用其他端口。
当前会话选择的模型没有出现在 Teio 提供方的 models 列表中,或模型名与 Teio 实际模型名不一致。请查看 模型与分组,确认 API Key 分组和模型名后重新保存配置。
401 通常表示 API Key 无效、没有复制完整,或当前 Key 没有对应分组。先在 Teio 后台检查密钥和分组,再确认 Base URL 使用 https://teio.me/v1
遇到通用 API 配置问题,也可以参考 通用配置教程