DeepSeek Harness(dsh)是 DeepSeek 开源的 Agent Harness,核心设计是 Everything is a Plugin。它支持 Web UI、插件化模型提供方,以及自定义 OpenAI 兼容端点。
前置条件
- 已安装 Node.js
- 已 创建 API 密钥
安装与启动
- npm 快速启动(推荐)
- 源码启动
在终端执行:默认会启动 Web UI,地址通常是:
通过 Web UI 配置 Teio
1
访问 Web UI
启动后访问
http://127.0.0.1:3080。2
跳过官方模型配置
首次进入时会提示配置 DeepSeek 官方模型。这里先选择 稍后设置,后面再添加 Teio 提供方。

3
打开模型设置
进入 设置 → 模型。

4
添加自定义提供方
选择 添加自定义提供方,用于配置 Teio 这类 OpenAI 兼容网关。

5
填写 Teio 连接信息
Provider ID:
teio显示名称:TeioAPI 地址:https://teio.me/v1API 协议:openai-completionsAPI 密钥:填写你在 Teio 创建的 API 密钥
6
设置模型
点击 获取可用模型,在弹窗中选择需要使用的模型。

7
保存提供方
保存后,Teio 会出现在模型选择器中。

8
选择模型并开始使用
在聊天页面选择工作区,然后选择 
teio/你的模型名,即可开始使用。
常见问题
启动后打不开页面怎么办?
启动后打不开页面怎么办?
先确认终端里
npx @deepseek-ai/dsh web 没有退出,并查看输出中的实际访问地址。默认地址通常是 http://127.0.0.1:3080,如果端口被占用,Harness 可能会使用其他端口。提示 UNKNOWN_MODEL 怎么办?
提示 UNKNOWN_MODEL 怎么办?
当前会话选择的模型没有出现在 Teio 提供方的
models 列表中,或模型名与 Teio 实际模型名不一致。请查看 模型与分组,确认 API Key 分组和模型名后重新保存配置。获取模型列表返回 401 怎么办?
获取模型列表返回 401 怎么办?
401 通常表示 API Key 无效、没有复制完整,或当前 Key 没有对应分组。先在 Teio 后台检查密钥和分组,再确认 Base URL 使用
https://teio.me/v1。