前沿 | DeepSeek Harness 完整指南：架构原理、Windows/Linux 安装、插件生态与实战配置

原创于 2026-08-18 18:41:23 发布 · 143 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

操作系统/开发工具等

话题

#AtomGit「码动四季·开源同行」夏季征稿活动

项目名称： DeepSeek Harness（dsh）
开发者： DeepSeek AI
核心理念： Agent = Model + Harness、Everything is a plugin
官方主页： https://deepseek.com/harness/en/
GitHub： https://github.com/deepseek-ai/deepseek-harness
开发文档： https://deepseek-harness.github.io/deepseek-harness/
插件发现： https://github.com/topics/dsh-plugin

图 1：DeepSeek Harness 相关发布宣传图，突出 Model + Harness = Agent。
图片来源：https://openclaw.club/archives/deepseek-harness-official-release

1. DeepSeek Harness 到底是什么？

DeepSeek Harness 是 DeepSeek AI 开源的一套 Agent Harness（智能体运行框架）。它不是一个新的基础模型，也不只是一个“DeepSeek 聊天客户端”。

如果把大语言模型看作智能体的“大脑”，那么 Harness 更像是智能体的“身体 + 神经系统 + 工作环境”。它负责把模型和真实开发环境连接起来，让模型不只是输出文字，而是能够继续执行：

读取、搜索和修改文件；
调用 Shell / PowerShell；
调用搜索、浏览器、MCP 等工具；
维护 Session；
保存运行轨迹；
调度子 Agent；
管理 Sandbox 与权限；
通过 Web UI、TUI 或其他界面与用户交互。

因此可以把最简单的 LLM 系统写成：

User
  │
  ▼
Model
  │
  ▼
Text Response

而一个完整 Agent 更接近：

                           ┌──────── Model / LLM
                           ├──────── Tools
                           ├──────── Skills
                           ├──────── File System
User ───────► Harness ─────┼──────── Shell
                           ├──────── Session
                           ├──────── Memory
                           ├──────── Sandbox
                           ├──────── Sub-Agent
                           └──────── UI

DeepSeek 官方给出的核心表达非常直接：

Agent = Model + Harness

模型负责推理，但 Agent 能否真正“干活”，很大程度上取决于 Harness 如何组织工具、上下文、权限、执行循环和运行环境。

2. 为什么 DeepSeek Harness 值得关注？

DeepSeek Harness 最有特点的地方并不是“又做了一个 Coding Agent”，而是它把大量传统 Agent 系统中写死的模块拆成了插件。

官方核心设计原则是：

Everything is a plugin —— 一切皆插件。

官方明确列出的可插件化能力包括：

Models
Tools
Skills
Sessions
Sandboxes
Storage
Agent Loops
Scheduling
UI
...

也就是说，可替换的不只是一个 Search Tool 或一个 MCP Server，甚至包括：

模型适配层；
Agent 如何循环执行；
Session 如何保存；
Sandbox 如何实现；
UI 用 Web 还是 TUI；
多 Agent 如何组织。

图 2：DeepSeek Harness 官方页面展示的插件管理界面。
图片来源：https://deepseek.com/harness/en/
原图：https://deepseek.com/harness/images/harness/feat-plugin.en.png

这使 DeepSeek Harness 更像一个 可组合的 Agent Runtime，而不只是一个固定功能的 AI 编程工具。

3. Cordis：Harness 的插件内核

DeepSeek Harness 的底层插件体系建立在 Cordis 上。

可以把 Cordis 理解成整个 Harness 的“插件内核”。它主要处理：

Plugin Mount
     │
     ├── dependency resolution
     ├── service registration
     ├── event registration
     ├── lifecycle
     └── Plugin Unmount

插件可以向运行时注册服务、事件、工具、Provider、UI、存储能力等。多个插件通过 Service 和 Event 协作，而不是所有组件互相硬编码依赖。

一个简化结构可以表示为：

                  DeepSeek Harness
                         │
                  ┌──────▼───────┐
                  │ Cordis Kernel │
                  └──────┬───────┘
                         │
         ┌───────────────┼────────────────┐
         │               │                │
         ▼               ▼                ▼
    LLM Plugin       Tool Plugin       UI Plugin
         │               │                │
         ▼               ▼                ▼
   DeepSeek API      Shell/Search        Web UI
   Other Provider    Browser/MCP         Custom UI

这也是“一切皆插件”能够真正落地的基础。

官方 Cordis Primer：

https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-primer

4. Every Run is Traceable：每一次运行都可以追踪

DeepSeek Harness 的另一条核心设计是：

Every run is traceable.

Harness 会记录模型真正看到和执行过的运行信息，例如：

System Prompt；
Model Reasoning / 上下文事件；
Tool Call；
Tool Result；
Sub-Agent 调度；
Context Injection；
Session 事件。

这些内容被组织到 append-only 的 Session Log 中。

图 3：官方 Trajectory View，可以从一次 Session 中重构 Agent 的执行轨迹。
图片来源：https://deepseek.com/harness/en/

基于同一份事件流，Harness 可以实现：

Resume
Fork
Search
Replay
Inspect

这对 Agent Debug、长任务恢复、Benchmark、失败原因分析都很重要。

5. DeepSeek Harness 的四种运行模式

官方当前将 Harness 划分为四种主要模式。

5.1 Standard Mode

Standard 是日常使用最完整的一套模式，通常包含：

文件编辑；
Shell；
文件搜索；
Web Search；
Skills；
Planning；
Goals；
Sub-Agent；
Workflow。

如果只是第一次体验 DSH，建议先从 Standard Mode 开始。

5.2 Code Mode

Code Mode 在 Standard 的基础上进一步允许模型通过 Code Mode SDK 组合多个工具步骤。

传统工具调用可能是：

Model → Tool A → Model → Tool B → Model → Tool C

Code Mode 更接近：

Model
  │
  ▼
Generate TypeScript Program
  │
  ├── Tool A
  ├── Tool B
  ├── Tool C
  └── Data Processing
  │
  ▼
Result

它更适合多步骤自动化任务。

5.3 Minimal Mode

Minimal Mode 只保留很少的工具，官方定位之一是模型 Benchmark。

典型核心能力为：

persistent bash
str_replace_editor

这样可以减少复杂 Harness 对模型能力测试的影响。

5.4 Creator Mode

Creator Mode 面向 Harness / Plugin 开发者，用于：

runtime inspection；
plugin experiments；
preset authoring；
组合新的 Agent Runtime。

6. 官方仓库与当前状态

DeepSeek Harness 官方 GitHub：

https://github.com/deepseek-ai/deepseek-harness

图 4：DeepSeek Harness GitHub 仓库页面截图。仓库描述为 “Everything is a Plugin”。
图片来源：https://openclaw.club/archives/deepseek-harness-official-release
官方仓库：https://github.com/deepseek-ai/deepseek-harness

截至本文检索时，项目仍明确标记为 Developer Preview，并提醒：

后续快速迭代可能产生兼容性破坏性变化。

因此：

不建议完全按照几个月前的第三方教程照抄；
安装命令、端口、插件兼容版本应优先看官方 README；
插件生态当前变化非常快。

7. 安装前的环境要求

官方仓库 package.json 当前要求：

Node.js: ^22.19.0 || >=24.0.0
pnpm: 11.7.0（源码仓库固定版本）
Git: >= 2.26（源码开发）

官方开发文档：

https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/development.md

其中明确说明：

CI 覆盖 Node 22.19、24、26；
推荐通过 Corepack 使用 pnpm；
源码仓库固定 pnpm@11.7.0；
DeepSeek API Key 对源码构建本身不是强制项，但实际调用 DeepSeek 模型时需要。

如果希望少踩坑，普通用户推荐直接使用：

Node.js 24 LTS

8. Windows 安装 DeepSeek Harness

8.1 推荐环境

推荐组合：

Windows 10 / 11
Node.js 24
Git
PowerShell 7（推荐）

Windows 原生版本已经拥有 PowerShell Tool 和 Windows Sandbox 后端。官方文档中可以看到 Windows 使用 pwsh 工具，并提供 Windows ACL restricted-token sandbox backend。

Sandbox 文档：

https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/sandbox

为什么推荐 PowerShell 7？

Windows 自带的 Windows PowerShell 5.1 对应的是 powershell.exe，而现代跨平台 PowerShell 7 对应的是：

pwsh.exe

Harness 当前 Windows 工具链中明确存在 pwsh tool，所以建议安装 PowerShell 7。

8.2 Windows 安装 Node.js

Node.js 官方：

https://nodejs.org/

安装完成后打开 PowerShell：

node -v
npm -v

建议确认 Node 版本至少为：

v22.19.0+

或者直接使用 Node 24。

不要使用 Node 20，也不要使用低于 22.19 的 Node 22 小版本。

8.3 Windows 最简单启动方式

安装好 Node.js 后，直接执行：

npx @deepseek-ai/dsh web

官方当前 README 给出的默认 Web UI 地址是：

http://127.0.0.1:3080

浏览器打开即可。

注意：网络上部分早期教程写的是 3018，当前官方仓库已经明确是 3080。以启动终端输出和最新 README 为准。

8.4 Windows 全局安装

如果希望后续直接使用 dsh 命令，可以：

npm install -g @deepseek-ai/dsh

然后：

dsh web

第一次体验更建议用：

npx @deepseek-ai/dsh web

这样最简单，也方便切换 npm 发布版本。

8.5 Windows 从源码运行

适合：

想研究 Harness 源码；
想调试 Cordis；
想开发底层插件；
想修改内置能力。

执行：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

corepack enable
pnpm --version

pnpm install
pnpm run build
pnpm dsh web

如果源码模式出现 HMR、native dependency 等问题，先查看官方 GitHub Discussions。Developer Preview 阶段 master 分支可能比 npm 发布包更激进。

8.6 Windows 原生还是 WSL2？

适合 Windows 原生

如果项目本身是：

Visual Studio
MSVC
Windows SDK
PowerShell
Windows 路径

那么用原生 Windows 更自然。

适合 WSL2

如果项目是：

Ubuntu
ROS / ROS 2
GCC
Bash
apt
Linux Docker
Linux CUDA Toolchain

更建议直接把 Harness 安装在 WSL2 Ubuntu 中。

对于机器人、具身智能、ROS、强化学习等 Linux 开发环境，通常：

Windows
   │
   └── WSL2 Ubuntu
          │
          ├── ROS
          ├── CUDA / GCC
          ├── Project Workspace
          └── DeepSeek Harness

会更顺手。

9. Linux 安装 DeepSeek Harness

Ubuntu / Debian 等发行版整体更直接。

先检查：

node -v
npm -v
git --version

建议：

Node.js 24
Git >= 2.26

9.1 Linux 最简单安装

npx @deepseek-ai/dsh web

浏览器访问：

http://127.0.0.1:3080

9.2 Linux 全局安装

npm install -g @deepseek-ai/dsh

然后：

dsh web

9.3 Linux 源码安装

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

corepack enable
pnpm install
pnpm run build
pnpm dsh web

9.4 Linux native module 问题

如果安装过程中 native dependency 无法使用预编译产物，可能会回退到 node-gyp 本地构建。

建议准备：

sudo apt update
sudo apt install -y python3 make g++

如果看到类似：

Failed to load native module: pty.node

重点排查：

python3 --version
make --version
g++ --version
node -v

而不是优先怀疑 API Key。

9.5 Linux 使用 1Panel 的社区一键部署方案

社区文章中也出现了 1Panel 应用商店安装 DeepSeek Harness 的方案。

图 5：1Panel 中的 DeepSeek Harness 应用安装示例。
图片来源：https://openclaw.club/archives/deepseek-harness-official-release

这种方式适合服务器用户，但它不是 DeepSeek 官方最基础的安装路径。希望理解 Harness 本身时，仍建议先学会官方 npx / npm / 源码三种方式。

10. 第一次启动后的 Web UI

启动：

npx @deepseek-ai/dsh web

打开：

http://127.0.0.1:3080

可以看到 Harness 主界面。

图 6：DeepSeek Harness Web UI 实际界面示例。
图片来源：https://openclaw.club/archives/deepseek-harness-official-release

一般第一步是：

Settings
   ↓
Models
   ↓
配置 Provider / API Key

然后选择 Workspace，再开始 Session。

11. 模型 Provider 配置

DeepSeek Harness 的模型并不完全写死在一个 Provider 上。

11.1 配置 DeepSeek

进入：

Settings → Models

填写 API Key。

图 7：官方文档中的 Models 配置页。
图片来源：https://deepseek-harness.github.io/deepseek-harness/en/guide/providers

官方 Provider 文档说明：保存后的 Key 对页面是 write-only 的，credential 默认存放在 DSH Home 中，例如：

$DSH_HOME/.credentials.yaml

DSH Home 默认通常在用户目录下的 .dsh。

11.2 自定义 Provider

如果使用：

企业内部模型网关；
自部署 OpenAI-compatible Endpoint；
其他兼容 API；

可以添加 Custom Provider。

图 8：官方 Custom Provider 配置页。
图片来源：https://deepseek-harness.github.io/deepseek-harness/en/guide/providers

通常需要填写：

Provider ID
Display Name
Base URL
API Protocol
Credential
Model

官方文档：

https://deepseek-harness.github.io/deepseek-harness/en/guide/providers

12. Settings 中还能配置什么？

除了 Models，Web UI 还可以看到：

通用设置；
插件；
Agent 预设；
权限；
外观等。

图 9：DeepSeek Harness Settings 示例界面。
图片来源：https://openclaw.club/archives/deepseek-harness-official-release

其中权限和 Workspace 配置尤其重要，因为 Agent 不是普通聊天机器人，它可能真正执行命令和修改文件。

13. Workspace 与权限

建议每一个 Session 明确选择项目 Workspace。

Windows：

D:\Projects\my_project

Linux：

/home/user/projects/my_project

不要为了省事直接把：

C:\

或：

作为高权限工作区。

Agent 能执行 Shell、写文件、调用工具，所以 Workspace 权限边界就是重要的安全边界。

14. Sandbox：为什么很重要？

Coding Agent 可能执行：

rm
npm install
git reset
curl
python
bash
pwsh

因此 Sandbox 不是附属功能，而是核心能力。

官方 Process Sandbox 当前包含不同平台实现：

Linux: bwrap / Landlock
macOS: Seatbelt
Windows: ACL restricted-token backend

官方参考：

https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/sandbox

不要轻易把完全访问权限交给：

来源未知的代码仓库；
未审计的插件；
来路不明的自动化任务。

15. DeepSeek Harness 插件体系

Harness 的插件不是简单的 Prompt 文件。

一个插件可能提供：

Tool
Service
Event Handler
Provider
Storage
UI
Skill
Sandbox capability

甚至一个插件 Bundle 可以改变整个 Profile 的组合方式。

这就是为什么 DSH Plugin 更像“运行时模块”，而不是普通浏览器扩展。

16. Bundle 与 Profile

官方文档中有两个重要概念。

Bundle

Bundle 是作者发布的可安装包，它声明自己往 Runtime 中贡献哪些配置和插件。

Profile

Profile 是某一个可运行组合，位于类似：

$DSH_HOME/profiles/<profile-name>

可以把 Profile 理解成一份 Agent Runtime 配方：

Profile: web
   │
   ├── Base Runtime
   ├── Web UI
   ├── Model Provider
   ├── File Tools
   ├── Shell
   ├── Session
   └── Community Plugins

官方插件打包与安装教程：

https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/publish

17. 官方插件安装命令

最重要的命令是：

dsh plugin --profile <profile-name> add <package-or-git-spec>

例如给 web Profile 安装 npm 插件：

dsh plugin --profile web add dsh-web-shell

GitHub 插件：

dsh plugin --profile web add github:owner/repository

本地插件：

dsh plugin --profile web add ./my-plugin

检查最终 Profile 配置可以使用：

dsh --profile web --dump-config

18. 插件安装安全问题：一定要看

DeepSeek Harness 插件可以拥有很强的宿主能力，因此安装插件之前至少检查：

GitHub 仓库；
README；
License；
package.json；
cordis.patch.yml；
是否带 prepare / postinstall；
最近更新情况；
Issues / Discussions；
是否要求 allowBuilds；
是否真的属于 DSH Plugin。

尤其是当安装器要求类似：

allowBuilds:
  some-plugin: true

这并不是普通权限确认，而可能意味着允许安装阶段的代码在宿主机执行。

官方插件发布文档建议对不熟悉的 Git 源尽量固定到 commit SHA：

dsh plugin --profile web add github:owner/repo#COMMIT_SHA

这样可以降低仓库后续变化带来的供应链风险。

19. 去哪里找插件？

19.1 官方 GitHub Topic

最重要入口：

https://github.com/topics/dsh-plugin

DeepSeek 官方 README 明确建议插件仓库加入 dsh-plugin Topic 方便发现。

但是：

GitHub Topic 只代表“被打上标签”，不代表官方审核。

因此仍要自行检查代码。

19.2 GitHub Discussions

https://github.com/deepseek-ai/deepseek-harness/discussions

其中 “Show Your Plugins!” 分类更新非常快，是寻找新插件的重要入口。

19.3 Awesome 列表

例如：

https://github.com/0xsline/awesome-deepseek-harness

以及社区维护的其他 Awesome DSH 列表。

19.4 第三方插件目录

当前社区还出现了多种插件目录，例如：

https://dshmarket.com/browse/
https://dshdocs.com/plugins/
https://dshplugin.store/

这些目录适合发现插件，但安装前仍应回到原始 GitHub 仓库验证。

20. 推荐插件一：dsh-web-shell

GitHub：

https://github.com/JesmonX/dsh-web-shell

作用：给 DSH Web UI 增加右侧 Dock Terminal。

当前仓库 README 给出的 npm 安装方式：

dsh plugin --profile web add dsh-web-shell

GitHub 安装：

dsh plugin --profile web add github:JesmonX/dsh-web-shell

然后：

dsh web

特点：

xterm.js；
右侧停靠；
bash / zsh；
可调宽度；
折叠与关闭分离；
Profile 级布局记忆。

21. 推荐插件二：dsh-goodmemory

GitHub：

https://github.com/hjqcan/dsh-goodmemory

用途：给 Harness 增加跨 Session 的持久记忆。

官方 Harness Discussions 中已有作者介绍：

https://github.com/deepseek-ai/deepseek-harness/discussions/2033

安装可使用 npm Package：

dsh plugin --profile web add dsh-goodmemory

它解决的问题可以概括为：

Session A
   │
   └── 重要长期信息

Session B
   │
   └── 自动召回相关长期信息

需要注意：这是社区插件，不是 DeepSeek 官方内置 Memory 服务。

22. 推荐插件三：dsh-browser

GitHub：

https://github.com/Lum1104/dsh-browser

它把 DeepSeek Harness 接到用户正在使用的 Chrome Tab。

项目介绍中说明模型可以：

读取页面内容；
点击控件；
填写表单；
滚动；
页面导航；
保留当前 Chrome 的登录态、Session 和 Cookie。

整体结构类似：

DeepSeek Harness
       │
       ▼
Browser Bridge Plugin
       │
       ▼
Chrome MV3 Extension
       │
       ▼
Current Browser Tab

该项目同时包含 DSH Bridge 和 Chrome Extension，因此建议严格按照仓库最新版 README 安装，而不要只复制一个过时的一行命令。

23. 推荐插件四：dsh-im-gateway

GitHub：

https://github.com/zhuiyueya/dsh-im-gateway

项目定位：把 DSH Agent 接入多种 IM 平台，例如：

WeChat
Feishu
Telegram
Discord
QQ
...

社区插件目录给出的典型安装形式：

dsh plugin --profile web add github:zhuiyueya/dsh-im-gateway

它非常适合希望从聊天软件远程调度 Agent 的用户。

需要注意 IM Token、Bot Credential、Webhook 等敏感配置的存放方式。

24. 推荐插件五：dsh-web-ui

GitHub：

https://github.com/zhu1090093659/dsh-web-ui

它不是单一小工具，而是一个 Web GUI 插件与皮肤集合，当前介绍包括：

Task Board；
Git Graph；
Right Panel；
Mobile Remote；
SSH Ops；
Image Understanding；
Token Statistics；
Pet / Skin Center 等。

该仓库是多模块集合，安装哪个 Bundle、哪些子插件应以当前 README 为准，不建议简单把根仓库当作单一 npm Package 处理。

25. 推荐插件六：dsh-vision-sidecar

社区项目介绍位于官方 Harness Discussions：

https://github.com/deepseek-ai/deepseek-harness/discussions/395

示例安装：

dsh plugin --profile web add github:121103qwq/dsh-vision-sidecar#v0.1.3

这个例子也说明为什么推荐 pin tag / commit：

插件版本
    +
DSH 版本
    +
Node 版本

三者兼容关系在 Developer Preview 阶段非常重要。

26. 推荐插件七：Windows Desktop Shell

社区 Windows 桌面壳项目：

https://github.com/RAFOLIE/dsh-desktop-windowos

官方 Harness Discussions 中作者给出的安装方式：

dsh plugin --profile web add dsh-desktop-plugin

提供的方向包括：

Windows Tray；
原生 Web Chat Shell；
任务完成通知；
桌面入口。

这是社区项目，Windows SmartScreen、未签名二进制等问题需要用户自行评估。

27. 一个很有代表性的 UI 插件例子：@file

社区已经出现类似 Codex 的 @file 引用插件：用户在输入框中输入 @，搜索 Workspace 中的文件或目录，并将所选内容作为上下文传给模型。

图 10：社区 dsh-at-file 插件相关截图，展示在 Web Composer 中搜索文件并引用。
图片来源：https://linux.do/t/topic/2750934?page=2
所示仓库：https://github.com/FSMargoo/dsh-at-file

这个例子很好地说明了 DSH 插件可以直接扩展 Web Composer，而不是只能增加后端 Tool。

28. 插件推荐表

插件 / 项目	主要功能	典型安装/入口	地址
dsh-web-shell	Web UI 右侧 Terminal	`dsh plugin --profile web add dsh-web-shell`	https://github.com/JesmonX/dsh-web-shell
dsh-goodmemory	跨 Session 长期记忆	`dsh plugin --profile web add dsh-goodmemory`	https://github.com/hjqcan/dsh-goodmemory
dsh-browser	Chrome 页面控制	按仓库 README 安装 Bridge + Extension	https://github.com/Lum1104/dsh-browser
dsh-im-gateway	微信/飞书/Telegram/Discord/QQ 等 IM 网关	`dsh plugin --profile web add github:zhuiyueya/dsh-im-gateway`	https://github.com/zhuiyueya/dsh-im-gateway
dsh-web-ui	Web UI 插件与皮肤集合	按仓库具体 Bundle README	https://github.com/zhu1090093659/dsh-web-ui
dsh-vision-sidecar	外接视觉模型能力	`dsh plugin --profile web add github:121103qwq/dsh-vision-sidecar#v0.1.3`	https://github.com/deepseek-ai/deepseek-harness/discussions/395
dsh-desktop-plugin	Windows 桌面壳/通知	`dsh plugin --profile web add dsh-desktop-plugin`	https://github.com/RAFOLIE/dsh-desktop-windowos
dsh-at-file	Composer 中 `@file` 引用	以仓库 README 为准	https://github.com/FSMargoo/dsh-at-file
Awesome DSH	插件/Skill/工具索引	浏览列表	https://github.com/0xsline/awesome-deepseek-harness
dsh-plugin Topic	官方推荐的插件发现入口	浏览 GitHub Topic	https://github.com/topics/dsh-plugin

29. 推荐的实际安装顺序

不要第一次启动就装几十个插件。

30. Windows 推荐组合

普通 Windows 用户：

Windows 11
Node.js 24
Git
PowerShell 7
DeepSeek Harness npm/npx Release

启动：

npx @deepseek-ai/dsh web

浏览器：

http://127.0.0.1:3080

如果主要开发 ROS / Linux C++ / CUDA 项目，则优先考虑 WSL2。

31. Linux 推荐组合

Ubuntu 用户：

Ubuntu 22.04 / 24.04
Node.js 24
Git
python3 + make + g++（遇到 native build 时）

启动：

npx @deepseek-ai/dsh web

32. 常见坑

32.1 端口不是 3018

当前官方 README：

http://127.0.0.1:3080

32.2 不要安装错同名 Python 包

本文讨论的是 DeepSeek AI 官方的：

@deepseek-ai/dsh

主 Quick Start：

npx @deepseek-ai/dsh web

看到网络文章让你执行：

pip install deepseek-harness

一定先检查它是不是同一个项目。

32.3 Node 版本太低

官方当前 Engine：

^22.19.0 || >=24.0.0

直接用 Node 24 最省心。

32.4 `pnpm` 找不到

源码开发执行：

corepack enable
pnpm --version

官方仓库固定：

pnpm@11.7.0

32.5 Linux 报 `pty.node`

准备：

sudo apt install -y python3 make g++

并确认 Node 版本。

32.6 Windows 找不到 `pwsh`

安装 PowerShell 7。

微软官方：

https://learn.microsoft.com/powershell/scripting/install/install-powershell-on-windows

32.7 插件一装就坏

Developer Preview 阶段常见原因：

DSH Core version
        ×
Plugin version
        ×
Node version

不兼容。

优先查看插件 README 中的最低 DSH 版本，例如一些插件会明确要求 rc.5、rc.6 或更高版本。

33. 为什么不要把 Web UI 直接暴露到公网？

Harness Web UI 后面连接的是可以：

执行 Shell；
读取文件；
修改项目；
调用 Agent；
使用 Credential；

的控制面。

因此远程服务器上不要简单粗暴把 DSH 直接裸露到 0.0.0.0 公网。

社区与官方 Discussions 中更常见、更安全的方式是保留：

127.0.0.1:3080

然后通过 SSH Local Forward：

ssh -L 3080:127.0.0.1:3080 user@server

本机再打开：

http://127.0.0.1:3080

这样控制面仍主要绑定回环地址。

34. DeepSeek Harness 和 Claude Code / Codex 类工具怎么看？

最简单的区别不是“谁写代码更强”，而是产品层级不同。

可以粗略理解成：

成熟 Coding Agent 产品
      │
      └── 已经组合好的 Harness + Model + UX

DeepSeek Harness
      │
      └── 更强调 Harness Runtime 本身也能被重新组合

它当然可以被组合成 Coding Agent，但理论上也可以进一步构建：

Coding Agent
Research Agent
Browser Agent
RAG Agent
DevOps Agent
Robot Development Agent
Multi-Agent Runtime

因此 DeepSeek Harness 最值得研究的是 Agent 基础设施的开放方式。

35. 一个适合机器人 / ROS 开发者的组合思路

对于 ROS、机器人控制、强化学习用户，可以构建类似：

DeepSeek Harness
       │
       ├── File Tools
       ├── Bash / Terminal
       ├── Git
       ├── Web Search
       ├── Browser
       ├── Project Memory
       ├── ROS Skill
       ├── Build/Test Tool
       └── Sub-Agent
              │
              ├── 代码分析 Agent
              ├── ROS 日志 Agent
              └── 文献检索 Agent

这也是 Harness 架构比单纯聊天界面更有价值的地方：可以围绕具体工程流程重新组合 Agent 的能力边界。

36. 总结

DeepSeek Harness 最核心的三句话可以概括为：

Agent = Model + Harness

Everything is a Plugin

Every Run is Traceable

它尝试把过去经常被固定写在 Agent 产品内部的：

Model
Tool
Skill
Session
Memory
Sandbox
Storage
Agent Loop
Scheduling
Sub-Agent
UI

统一放到一个可组合的运行时中。

对于普通用户，目前最推荐的路线仍然是：

Node.js 24
   ↓
npx @deepseek-ai/dsh web
   ↓
127.0.0.1:3080
   ↓
配置 Provider
   ↓
选择 Workspace
   ↓
先验证官方能力
   ↓
再逐个增加社区插件

DeepSeek Harness 当前仍是 Developer Preview，所以现在更适合：

学习 Agent Harness 架构；
研究插件化 Runtime；
开发社区插件；
搭建个人 Agent 工作台；
做模型 Agent 能力实验。

如果准备直接承载关键生产任务，则应该特别注意：版本锁定、插件审计、Sandbox、Credential、安全暴露面以及升级后的兼容性测试。

37. 相关地址汇总

DeepSeek 官方

Harness 官网：https://deepseek.com/harness/en/
GitHub：https://github.com/deepseek-ai/deepseek-harness
Developer Docs：https://deepseek-harness.github.io/deepseek-harness/
Provider Docs：https://deepseek-harness.github.io/deepseek-harness/en/guide/providers
Plugin Publish：https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/publish
Sandbox Reference：https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/sandbox
Cordis Primer：https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-primer
GitHub Discussions：https://github.com/deepseek-ai/deepseek-harness/discussions
dsh-plugin Topic：https://github.com/topics/dsh-plugin