DeepSeek Harness 本地搭建部署教程：接入 OpenAI 兼容 API

一、引言

上一篇文章调研了 DeepSeek Harness（dsh）的整体架构。本文手把手演示如何在本机（macOS/Linux）把它跑起来，并接入任意OpenAI 兼容 API服务，完整走通 Agent 对话流程。

dsh 的llm-pi-ai适配器支持通过自定义 Provider 接入任意 OpenAI 兼容网关（base URL + API Key 即可），无需使用特定厂商的专属 SDK，也无需修改任何核心代码。

二、环境要求

检查命令：

node--versionnpm--version

如果你的 Node 版本低于 22.19（例如 22.15），建议先升级到 22.x 最新版或 >=24，否则会因 engines 校验失败。

三、安装与启动

3.1 一行命令启动 Web UI

npx-y@deepseek-ai/dsh web

首次运行会自动下载依赖包（约 1-2 分钟），完成后输出：

dsh web: http://127.0.0.1:3080

浏览器打开http://127.0.0.1:3080即可看到 Web 界面。

3.2 验证安装版本

npx-y@deepseek-ai/dsh--version# 输出类似：0.1.0-rc.6

3.3 其他运行形态

# 一次性任务（headless 模式）npx-y@deepseek-ai/dsh--profileheadless"帮我写一个快速排序"# 查看完整配置树npx-y@deepseek-ai/dsh--profileweb --dump-config

四、核心配置：接入 OpenAI 兼容 API

dsh 的网页 UI 支持图形化添加 Provider，但直接修改配置文件更可控。配置文件位于：

$DSH_HOME/profiles/web/cordis.patch.yml

（$DSH_HOME默认是~/.dsh）

4.1 编辑补丁文件

用文本编辑器打开cordis.patch.yml，默认内容是空的补丁数组[]。替换为以下完整配置：

# OpenAI 兼容 Provider 配置（PiAI 适配器 = @deepseek-ai/dsh-llm-pi-ai）-id:llm-pi-aiconfig:providers:# 自定义 OpenAI 兼容网关my-gateway