DeepSeek Harness 配置方法

DeepSeek Harness（dsh）是 DeepSeek 开源的 Agent Harness，支持 Web UI 和命令行运行。wylon 新云 Token 工厂提供 OpenAI Chat Completions 兼容接口，通过自定义 Provider 即可接入。

前置准备

• Node.js 22.15.0 或更高版本，可通过 node --version 确认。
• 一枚 wylon API Key，格式类似 sk-...。
• 一个允许 Agent 读写的目录。dsh 会将启动命令时所在目录作为 workspace 根目录。

1. 配置 Provider

设置 API Key

Linux / macOS

export WYLON_API_KEY="<你的_wylon_API_Key>"

Windows PowerShell

$env:WYLON_API_KEY="<你的_wylon_API_Key>"

创建配置文件

将以下内容写入 settings.yaml：

agent-default-model:
  provider: wylon
  model: ZhipuAI/GLM-5.3

llm-pi-ai:
  providers:
    wylon:
      displayName: wylon
      api: openai-completions
      baseURL: https://api.wylon.cn/v1
      apiKeyEnv: WYLON_API_KEY
      models:
        - id: ZhipuAI/GLM-5.3

可在 模型广场复制合法的模型 ID，或请求 GET https://api.wylon.cn/v1/models 获取列表。

2. 启动与验证

可先通过命令行执行一次只读冒烟测试。该模式不占用端口，发生错误时会直接打印错误码。

npx @deepseek-ai/dsh --profile headless "用一句话说明你是什么模型，不要修改任何文件。"

首次运行 npx 时需要下载软件包。能够正常返回一句话，表示 API Key、Base URL 与模型 ID 均已正确配置。

冒烟测试通过后，可启动 Web UI 进一步检查是否接入成功：

npx @deepseek-ai/dsh web

1. 在模型选择器中确认 Provider 为 wylon。
2. 确认模型为 ZhipuAI/GLM-5.3。
3. 新建会话并先发送只读任务。
4. 确认读取范围和命令授权策略后，再逐步允许 Agent 修改文件或执行命令。

3. 在 Web UI 中管理 Provider

除编辑 settings.yaml 外，也可以通过 Web UI 中进入设置 → 模型 → 添加自定义提供方创建和维护 Provider。

填写 Provider ID 与 API 密钥后，展开默认收起的自定义设置，继续填写以下内容：

1. 点击获取可用模型会调用 GET /v1/models 拉取列表，也可以通过添加模型手动填写。
2. 保存后，Provider 名称旁的绿点表示密钥已经配置。设置面板右上角的打开配置文件可用于核对 settings.yaml。
3. 界面填入的密钥会以只写方式存入 ~/.dsh/.credentials.yaml，并自动派生引用名写回 profile 的 apiKeyEnv。
4. 无需手动编辑该凭据文件。