系列文章目录

nodejs参考博客

参考博客

---

---

前言

DeepSeek Harness 官网
DeepSeek Harness GitHub官网
DeepSeek Harness 开发者文档
DeepSeek Harness 社区插件

一切皆插件
DeepSeek Harness 基于 Cordis 插件系统构建。模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件提供，并通过 Cordis 服务与事件彼此协作。开发者无需改动 DeepSeek Harness 源码，即可在配置层选择、替换或扩展任一能力。

每一次运行都有迹可循
模型看到的一切都会写入仅追加设计的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度，以及每一次上下文注入。在 Trajectory 视图中，你可以按来源查看这些信息。恢复、分叉、检索与回放也共享同一份事件流。

多种运行模式
标准模式提供完整的工具组合；PTC 模式通过模型生成的一段代码组合多轮工具调用；极简模式仅保留一个 shell 工具与一个文件编辑工具，用于最小化环境下的模型基准测试；创造模式可以检查当前运行时、在内存中试验 Cordis 插件，并据此组合和创作新的模式。

---

一、Node.js安装使用

1、安装

Node.js官网

选择长期维护版下的windows/mac/linux系统对应的安装包进行下载，比如msi/pkg/x64等，这里以windows的node-v24.18.0-x64.msi安装包为例。

下载到指定位置后，点击进入安装步骤，其中：
勾选I accept the terms in the License Agreement选项。
对于安装路径可修改到指定路径也可以使用默认路径。
不勾选Automatically install the necessary tools选项。
其他的基本都是直接点击Next即可。
最后点击点击Install按钮和Finish按钮。

如果是ubuntu系统，那么下载的是一个压缩包，例如node-v24.18.0-linux-x64.tar.xz。把压缩包放在指定路径下，然后解压再执行一下步骤：

sudo gedit ~/.bashrc

# 在~/.bashrc文件最后面添加
export PATH=/home/xxx/node-v24.18.0-linux-x64/bin:$PATH

source ~/.bashrc

2、测试

按下 win + r 键，打开cmd窗口。

输入以下命令进行测试：

# 查看Node版本
node -v    

# 查看npm版本
npm -v  

不建议使用powershell命令行测试，有些命令运行不了，具体步骤也可以参考这篇nodejs安装博客。

---

二、DeepSeek Harness web安装使用

1、全局安装

运行以下命令会进行全局安装。

npm install -g @deepseek-ai/dsh

运行以下命令可以查看是否安装成功和安装版本。

dsh --version

运行以下命令会启动 Web UI

dsh web

启动后在浏览器上输入http://127.0.0.1:3080即可打开web端。

进入web端后，会有一个内测声明和API key提示。
内测声明确认跳过即可。

API key提示输入deepseek的api key密钥。

需要到deepseek的API平台里进行注册->充值->创建对应的API key等步骤。

完成后就可以进入web端进行使用了。

如果想退出就在对应终端下点击快捷键ctrl+c即可退出。

2、临时执行

运行以下命令后会临时安装并启动 Web UI。

npx @deepseek-ai/dsh web

启动后在浏览器上输入http://127.0.0.1:3080即可打开web端。

进入web端后，会有一个内测声明和API key提示。
内测声明确认跳过即可。

API key提示输入deepseek的api key密钥。

需要到deepseek的API平台里进行注册->充值->创建对应的API key等步骤。

完成后就可以进入web端进行使用了。

如果想退出就在对应终端下点击快捷键ctrl+c，输入“y”即可退出。

3、区别

npm install -g @deepseek-ai/dsh 是全局安装，把包装到本机全局 node_modules 并链接 dsh 命令到 PATH，装完之后 dsh 在任何目录下都可长期使用 。
npx @deepseek-ai/dsh web 是临时执行，npx 会先检查本地/缓存里有没有这个包，没有就去 npm registry 临时下载到缓存目录，运行完不往全局 PATH 里写永久命令 。

两者启动 web 模式的效果完全等价，可以根据需求选择安装方式：
如果只是想快速试一下​ DeepSeek Harness 的 Web UI → 直接用 npx @deepseek-ai/dsh web，一条命令搞定，不污染全局环境 。
如果打算经常用（比如日常拿它跑 Agent 任务）→ 先 npm install -g @deepseek-ai/dsh，之后敲 dsh web 更顺手，版本也可控 。

问题

在ubuntu22中，使用npm install -g @deepseek-ai/dsh安装DeepSeek Harness，然后运行dsh --version输出0.1.1-rc.2，运行dsh web命令，打开http://127.0.0.1:3080点击选择工作区按键没有反应，改用http://localhost:3080网址点击选择工作区按键也没有反应。
强制 DSH 使用页面内的目录浏览器，编辑 ~/.dsh/profiles/web/cordis.patch.yml，备份或注释原来的内容，然后修改：

# 关闭 auto 猜测，强制使用页面内 browse 选择器
- id: directory-picker
  disabled: true
- insert:
  - id: directory-picker-browse
    name: '@deepseek-ai/dsh-host-directory-picker-browse'
  - id: directory-picker-browse-surface
    name: '@deepseek-ai/dsh-client-ui-directory-picker-browse'

---

总结

感觉dsh比Pi更开放。