DeepSeek Harness 本地安装与三方模型配置实战

DeepSeek Harness 本地安装与三方模型配置实战

最近在本地试了 DeepSeek Harness（命令行是 dsh）。Harness 负责工作区、会话和工具，模型可以来自 DeepSeek 官方，也可以换成任意兼容 OpenAI 协议的第三方服务。

本文记录完整流程：安装 Harness、添加第三方提供方、选择 gpt-5.6-sol 发测试消息，以及如何清理后重新安装。

本文按 DeepSeek Harness 当前开发者预览版本编写。截图中的密钥已经打码，真实 Key 不要发布到文章、截图或 Git 仓库。

一、准备 Node.js

建议使用 Node.js 20+，先检查环境：

node –version
npm –version

二、安装并启动 Harness

1. npm 临时运行

npx –yes @deepseek-ai/dsh web

默认 Web UI 地址是 http://127.0.0.1:3080。只启动服务、不自动打开浏览器：

npx –yes @deepseek-ai/dsh web –no-open

2. 从源码运行

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

三、添加第三方模型服务

启动 Web UI 后进入：

设置 → 模型 → 添加自定义提供方

以灵链云为例：

保存后点击“获取可用模型”。如果端点支持 GET /models，点击获取模型，列表里会出现 gpt-5.6-sol；不支持时直接手动填模型 ID。

为什么地址要带 /v1

这里填写的是 API 基础地址，Responses 请求最终会落到：

https://llapi.org/v1/responses

少写 /v1 常见结果是 404，多写一层则会变成 /v1。

四、用 settings.yaml 配置（可选）

也可以直接编辑 $DSH_HOME/settings.yaml：

llm-pi-ai:
providers:
llapi:
displayName: 灵链云
apiKeyEnv: LLAPI_API_KEY
api: openai–responses
baseURL: https://llapi.org/v1
models:
– id: gpt–5.6–sol
name: GPT–5.6 Sol

当前终端临时设置 Key：

PowerShell：

$env:LLAPI_API_KEY = "sk-你的密钥"

macOS / Linux：

export LLAPI_API_KEY="sk-你的密钥"

apiKeyEnv 只是环境变量名，不是 Key 本身。不要把真实值写进 settings.yaml 或提交 .env。

五、用 gpt-5.6-sol 发测试

在 设置 → 模型 选中 灵链云 / gpt-5.6-sol，新建会话后发送：

请只回复：DeepSeek Harness 配置成功

预期结果：

DeepSeek Harness 配置成功

六、只重跑一份，还是彻底重装

只重跑

停止当前进程，再执行同一条命令：

npx –yes @deepseek-ai/dsh web

同一个 $DSH_HOME 会保留设置、凭据和会话。想开独立实例可以换 Home：

PowerShell：

$env:DSH_HOME = "$pwd\\.dsh-demo-2"
npx —yes @deepseek-ai/dsh web

macOS / Linux：

DSH_HOME="$PWD/.dsh-demo-2" npx –yes @deepseek-ai/dsh web

删除后重新安装

确认没有 dsh 进程运行后，删除你明确指定的 Home：

PowerShell：

Remove-Item –Recurse –Force "$env:DSH_HOME"
npx —yes @deepseek-ai/dsh web

macOS / Linux：

rm -rf "$DSH_HOME"
npx –yes @deepseek-ai/dsh web

这会删除 profile、settings、credentials 和 sessions。要保留历史会话，先备份 $DSH_HOME/sessions。

七、常见问题

401 或 INVALID_CREDENTIAL：检查 Key 是否完整，环境变量名是否和 apiKeyEnv 一致。

UNKNOWN_MODEL：模型 ID 必须和服务端实际提供的值一致，本文使用 gpt-5.6-sol。

连接成功但请求被拒绝：确认协议是 openai-responses。只有明确只支持 Chat Completions 的网关，才改为 openai-completions。

修改后没有生效：新建会话再试；仍无效时重启 dsh web。

八、灵链云作为备用端点

如果平时会在几个模型服务之间切换，把灵链云单独配置成一个 Provider 会比较省事：Harness 里只改模型选择，不需要改项目代码。本文使用的端点是 https://llapi.org/v1，示例模型是 gpt-5.6-sol。

实际可用模型、额度和计费以灵链云控制台为准。生产环境建议使用单独的 Key、设置额度上限，并定期轮换；文章和截图只保留脱敏示例。

参考

• DeepSeek Harness 官方仓库
• DeepSeek Harness 文档
• 灵链云 API 端点