DeepSeek Harness 配置

DeepSeek Harness（dsh）是开源的国产终端 Agent，自带 Web UI，可接任意 OpenAI 兼容的自定义供应商。

前置准备

需要	版本要求
Node.js	`^22.19.0` 或 `>=24.0.0`
小关API 密钥	控制台创建的 `sk-...`

启动

npx @deepseek-ai/dsh web

浏览器打开 http://127.0.0.1:3080。

方法一：Web UI 添加自定义 Provider（推荐）

第一步：打开设置

进入 Settings → Models。

第二步：添加自定义提供方

点 Add a custom provider。

第三步：按下表填写

字段	填写内容
Provider ID	`xiaoguan`（小写，创建后不可改，只能删了重建）
Display name	`xiaoguan`（可随意）
Base URL	`https://api.yzgz.cn/v1`
API protocol	`openai-completions`（OpenAI 兼容）
API key	`sk-你的密钥`

第四步：拉取模型

在 Model catalog 区域点 Fetch available models， Harness 会请求 GET /v1/models 拉取本站可用模型，勾选要用的。

拉取报 401 或失败

检查 key 是否复制完整
本站 /v1/models 需要鉴权，key 错了就会 401
如果还是拉不到，直接在 Model list 里手动填模型 ID（从模型广场复制）

第五步：保存并选用

点 Save，回到对话页，在模型选择器里选中刚配好的模型。

上下文与输出上限

项	值
上下文窗口	1048576
最大输出 token	32768

要识图就勾上图片

Harness 里如果模型支持视觉，需要在模型配置中**勾选「图片」**能力，否则不会把图片内容传给模型。

方法二：直接编辑 settings.yaml

也可以跳过 UI，直接写配置文件：

providers:
  - id: xiaoguan
    display_name: xiaoguan
    base_url: https://api.yzgz.cn/v1
    api_protocol: openai-completions
    api_key: sk-你的密钥
    models:
      - id: claude-opus-4-5
        capabilities:
          - text
          - vision

排错

现象	原因	处理
Fetch 报 401	key 错	重新复制
Provider ID 改不了	设计如此	删掉重建
模型列表空	拉取失败	手动填模型 ID
识图没反应	没勾图片能力	在模型配置里勾上

前置准备​

启动​

方法一：Web UI 添加自定义 Provider（推荐）​

第一步：打开设置​

第二步：添加自定义提供方​

第三步：按下表填写​

第四步：拉取模型​

第五步：保存并选用​

上下文与输出上限​

方法二：直接编辑 settings.yaml​

排错​