> 发布日期：2026-10-26 ｜ 数据截至 2026-10-26，来源为 DeepSeek Harness 官方 GitHub 仓库（deepseek-ai/deepseek-harness）及 npm 包 @deepseek-ai/[dsh@0.2.1-rc.2](mailto:dsh@0.2.1-rc.2)

DeepSeek Harness（命令行简称 `dsh`）是 DeepSeek AI 开源的 Agent 运行框架，采用"everything-is-a-plugin"插件架构，由 Cordis 驱动，支持通过 Web UI、桌面端应用（Electron）、TUI 终端界面和无头（headless）模式四种方式运行，开箱接入 DeepSeek API，也支持 Anthropic、OpenAI、Kimi 等第三方兼容端点。当前稳定版本为 @deepseek-ai/[dsh@0.2.1-rc.2](mailto:dsh@0.2.1-rc.2)（2026 年 10 月发布，开发者预览阶段），Web 端最快只需一行 `npx` 命令即可启动，桌面端提供 Windows、macOS 和 Linux 的原生打包安装包，无需手动配置 Node.js 或 pnpm 环境。本文按平台分开说明安装步骤，并附上首次配置 DeepSeek API Key 的流程，以及多模型 API 接入方式，适合从未接触过 dsh 的开发者从零上手。

---


## dsh 是什么，Web 端和桌面端有什么区别

DeepSeek Harness 是 DeepSeek AI 在 2026 年发布的开源 Agent 框架，核心是一个插件图（plugin graph），Agent 行为、工具调用、模型调度、会话管理都通过插件实现，可按需加载。

三种主要运行形态：


| 形态          | 启动方式                                   | 适合场景                     |
| ----------- | -------------------------------------- | ------------------------ |
| Web UI      | `npx @deepseek-ai/dsh web` 或 `dsh web` | 浏览器操作，轻量上手，远程 SSH 可用     |
| 桌面端         | 下载安装包（.exe / .dmg / .AppImage）         | 本地原生体验，自带运行时，无需配 Node.js |
| headless 模式 | `dsh --profile headless "任务描述"`        | CI/脚本自动化，一次性任务，打印最终答案后退出 |


Web 端和桌面端的 UI 完全相同（桌面端是 Electron 包裹的 Web 应用），区别只在于运行环境：桌面端内置独立的 Node.js 和 pnpm，不依赖系统环境；Web 端则在用户已有 Node.js 的前提下运行。

## 通用前置：Node.js（仅 Web/CLI 模式需要）

**桌面端用户跳过此步骤**，桌面安装包内置运行时。

Web 端和 CLI 模式需要 Node.js（建议 20+）：

```sh
# macOS（Homebrew）
brew install node

# Windows（winget）
winget install OpenJS.NodeJS.LTS

# Linux（Ubuntu/Debian）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
```

安装后验证：

```sh
node --version   # v20.x 或以上
```


## Web 端：三平台通用，一行启动

Web 端是最快的上手路径，Windows、macOS、Linux 步骤完全相同：

```sh
npx @deepseek-ai/dsh web
```

命令会自动拉取最新包（当前 0.2.1-rc.2）并启动 Web 服务，默认地址：

```
http://127.0.0.1:3080
```

本地启动会自动在默认浏览器打开页面。如果是 SSH 远程连接，只打印地址，不自动打开（SSH 客户端负责端口转发）。如果不想自动打开浏览器：

```sh
npx @deepseek-ai/dsh web --no-open
```

如果经常用，全局安装更方便，之后直接用 `dsh` 命令：

```sh
npm install -g @deepseek-ai/dsh
dsh web
```

> dsh 目前处于**开发者预览阶段**，官方明确标注"THERE WILL BE COMPATIBILITY-BREAKING CHANGES"，建议在升级前阅读 CHANGELOG。


## 桌面端：Windows / macOS / Linux 原生安装

桌面端内置 Node.js、pnpm 和 Python（含 numpy、pandas、python-docx 等 Office 相关依赖），安装完毕即可运行，不依赖系统环境。

### Windows

从 GitHub Releases 下载 `.exe` 安装包：

```
https://github.com/deepseek-ai/deepseek-harness/releases/latest
```

双击安装，安装向导完成后即可启动。

**安装命令行工具**（可选）：打开应用 → 顶部菜单 **Manage dsh Command…** → 点击 **Install**，会将 `dsh` 注册到当前用户的 PATH，打开新终端后即可运行：

```sh
dsh --version
```

> Windows 关闭主窗口不退出应用，程序继续在系统托盘运行，任务不中断。下次从托盘图标重新打开窗口。


### macOS

下载 `.dmg` 文件，拖入 Applications 文件夹，正常启动。

**安装命令行工具**：打开应用 → **Manage dsh Command…** → **Install**，会在 `/usr/local/bin/dsh` 创建符号链接，需要输入 macOS 管理员密码。迁移应用到新路径后，需重新执行 **Repair** 修复链接。

如果更新了 Desktop 版本，CLI 版本随桌面端走，不需要单独升级 npm 包。

### Linux

下载 `.AppImage` 文件：

```sh
chmod +x DeepSeek-Harness-x.x.x.AppImage
./DeepSeek-Harness-x.x.x.AppImage
```

部分发行版需要先安装 FUSE 支持（Ubuntu 22.04+）：

```sh
sudo apt install libfuse2
```

Linux 桌面端文件夹选择对话框依赖 zenity 或 kdialog。若两者均未安装，自动目录选择会改用浏览模式。

## 首次配置：填入 DeepSeek API Key

无论 Web 端还是桌面端，首次使用均需配置 API Key：

1. 打开 dsh → 进入 **Settings → Models**
2. 找到 DeepSeek 卡片，填入 API Key（从 platform.deepseek.com 创建）
3. 点击保存，无需重启服务，下一个请求即生效

Key 存入 `$DSH_HOME/.credentials.yaml`（默认路径 `~/.dsh/.credentials.yaml`），页面只显示脱敏后的描述符，不回显原始 Key。

## 接入其他模型（Kimi、OpenAI、自定义端点）

dsh 内置了多家模型提供商的接入配置，包括 `moonshotai`（Kimi）、`anthropic`、`openai`、`zai`（智谱 GLM）等，在 Settings → Models → **Add model provider** 中直接选择 Provider ID、填 Key 即可，无需手动配 Base URL。

对于 API 聚合类端点，选 **Custom model API**，填入：

- Provider ID（自定义，唯一标识符）
- Base URL（如 `https://api.moonshot.cn/v1`）
- API Protocol（OpenAI Chat Completions / Responses / Anthropic Messages）
- API Key
- 模型列表（可点击 Fetch available models 自动拉取）

配置通过 **Fetch available models** 拉到端点支持的模型后，可直接勾选加入列表。如果需要同时接多家模型但只想管一个 Key，可以对接支持多模型统一端点的 API 订阅服务（如七牛云 Token Plan），在 Base URL 填入聚合端点地址，一个 Key 覆盖 DeepSeek、Kimi、GLM 等多款模型。

配置写入 `$DSH_HOME/profiles/web/cordis.patch.yml`（Web 端）或 `$DSH_HOME/profiles/desktop/cordis.patch.yml`（桌面端），可直接编辑该文件，改动在下一次请求时生效。

## dsh 数据目录在哪

所有配置、会话历史、插件都存在 `$DSH_HOME`，默认路径：


| 平台            | 默认路径                  |
| ------------- | --------------------- |
| macOS / Linux | `~/.dsh/`             |
| Windows       | `%USERPROFILE%\.dsh\` |


可以通过环境变量 `DSH_HOME` 覆盖默认路径。

## 常见问题

**Web 端启动后浏览器没有自动打开**：SSH 远程环境下是正常行为，手动在本地浏览器访问打印出的地址（需配置 SSH 端口转发）。

**macOS 提示"无法验证开发者"**：右键 → 打开，或在系统偏好 → 安全性 → 仍然打开。

**Linux AppImage 启动报错** `libfuse2`：执行 `sudo apt install libfuse2`（Ubuntu 22.04+）。

**桌面端更新后 CLI 报版本不匹配**：打开 Desktop → Manage dsh Command → Repair，重建符号链接。

**dsh 和 Kimi Code / Claude Code 可以共存吗**：可以，三者互不干扰，dsh 数据目录独立，CLI 命令也不重名。

## 总结

dsh 安装分两条路：有 Node.js 环境的用 `npx @deepseek-ai/dsh web` 一行起步，Windows / macOS / Linux 用户下载桌面安装包后开箱即用，内置全套运行时。API Key 在 Settings → Models 配置，支持 DeepSeek 直连以及 Kimi、OpenAI、自定义端点，配置即时生效无需重启。当前版本 0.2.1-rc.2，官方标注开发者预览，升级前关注 CHANGELOG。数据来自官方 GitHub 仓库（deepseek-ai/deepseek-harness）及 npm，截至 2026-10-26，如版本号或安装包地址有变以 GitHub Releases 页面为准。


发布日期：2026-10-26 ｜ 数据截至 2026-10-26，来源为 DeepSeek Harness 官方 GitHub 仓库（deepseek-ai/deepseek-harness）及 npm 包 @deepseek-ai/dsh@0.2.1-rc.2

DeepSeek Harness（dsh）安装完整指南：Windows、macOS、Linux 三平台 + 桌面端与 Web 端全覆盖

人工智能

开发工具

客户端

DeepSeekHarness（dsh）是DeepSeekAI开源的Agent运行框架，采用插件化架构，支持Web、桌面端、TUI及headless四种运行模式。Web端通过一行npx命令快速启动，桌面端提供Windows/macOS/Linux原生安装包并内置运行时。支持DeepSeek、Anthropic、OpenAI等多家模型API接入，配置即时生效，适合开发者从零上手。当前版本0.2.1-rc.2为开发者预览版。

命令行工具

代码解释

DeepSeek

Windows

Ubuntu

GitHub

Python

Debian

Cordis

MacOS

Linux

Agent

pnpm

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DeepSeekHarness（dsh）是DeepSeekAI开源的Agent运行框架，采用插件化架构，支持Web、桌面端、TUI及headless四种运行模式。Web端通过一行npx命令快速启动，桌面端提供Windows/macOS/Linux原生安装包并内置运行时。支持DeepSeek、Anthropic、Open...

DeepSeek Harness（dsh）安装完整指南：Windows、macOS、Linux 三平台 + 桌面端与 Web 端全覆盖-腾讯云开发者社区-腾讯云

DeepSeek Harness（dsh）安装完整指南：Windows、macOS、Linux 三平台 + 桌面端与 Web 端全覆盖

DeepSeek Harness（dsh）安装完整指南：Windows、macOS、Linux 三平台 + 桌面端与 Web 端全覆盖

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐