发布日期：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）是 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（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+）：

# 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

安装后验证：

node --version   # v20.x 或以上

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

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

npx @deepseek-ai/dsh web

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

http://127.0.0.1:3080

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

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

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

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，打开新终端后即可运行：

dsh --version

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

macOS

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

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

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

Linux

下载 .AppImage 文件：

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

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

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 页面为准。

延伸阅读

  • DeepSeek Harness GitHub：github.com/deepseek-ai/deepseek-harness

  • DeepSeek Harness 官方文档：deepseek-harness.github.io/deepseek-harness/

  • npm 包 @deepseek-ai/dsh：npmjs.com/package/@deepseek-ai/dsh

  • DeepSeek 开放平台（API Key 申请）：platform.deepseek.com

  • 七牛云 Token Plan（deepseek/kimi低至1.2折）：https://www.qiniu.com/ai/plan