DeepSeek Harness 本地搭建部署教程：接入 OpenAI 兼容 API一、引言上一篇文章调研了 DeepSeek Harness（dsh）的整体架构。本文手把手演示如何在本机（macOS/Linux）把它跑起来，并接入任意OpenAI 兼容 API服务，完整走通 Agent 对话流程。dsh 的llm-pi-ai适配器支持通过自定义 Provider 接入任意 OpenAI 兼容网关（base URL + API Key 即可），无需使用特定厂商的专属 SDK，也无需修改任何核心代码。二、环境要求要求版本说明操作系统macOS / LinuxWindows 需 WSLNode.js^22.19 或 =24用node --version检查npm / pnpmnpm = 10npx 随 Node 自带检查命令：node--versionnpm--version如果你的 Node 版本低于 22.19（例如 22.15），建议先升级到 22.x 最新版或 =24，否则会因 engines 校验失败。三、安装与启动3.1 一行命令启动 Web UInpx-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.63.3 其他运行形态# 一次性任务（headless 模式）npx-y@deepseek-ai/dsh--profileheadless"帮我写一个快速排序"# 查看完整配置树npx-y@deepseek-ai/dsh--profileweb --dump-config四、核心配置：接入 OpenAI 兼容 APIdsh 的网页 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 
长河君 · 2026/8/15 1:56:15 · 阅读 1.2k DeepSeek Harness 本地搭建部署教程：接入 OpenAI 兼容 API
DeepSeek Harness 本地搭建部署教程：接入 OpenAI 兼容 API一、引言上一篇文章调研了 DeepSeek Harness（dsh）的整体架构。本文手把手演示如何在本机（macOS/Linux）把它跑起来，并接入任意OpenAI 兼容 API服务，完整走通 Agent 对话流程。dsh 的llm-pi-ai适配器支持通过自定义 Provider 接入任意 OpenAI 兼容网关（base URL + API Key 即可），无需使用特定厂商的专属 SDK，也无需修改任何核心代码。二、环境要求要求版本说明操作系统macOS / LinuxWindows 需 WSLNode.js^22.19 或 =24用node --version检查npm / pnpmnpm = 10npx 随 Node 自带检查命令：node--versionnpm--version如果你的 Node 版本低于 22.19（例如 22.15），建议先升级到 22.x 最新版或 =24，否则会因 engines 校验失败。三、安装与启动3.1 一行命令启动 Web UInpx-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.63.3 其他运行形态# 一次性任务（headless 模式）npx-y@deepseek-ai/dsh--profileheadless"帮我写一个快速排序"# 查看完整配置树npx-y@deepseek-ai/dsh--profileweb --dump-config四、核心配置：接入 OpenAI 兼容 APIdsh 的网页 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