乐于分享
好东西不私藏

保姆级:DeepSeekHarness安装和使用教程!

保姆级:DeepSeekHarness安装和使用教程!

GPT/Claude充值:pay.ldxp.cn/shop/stone

DeepSeek Harness 的缩写是 dsh,定位是开源智能体框架(类似于 Codex 和 WorkBuddy 等)。

Harness=马具/驾驭

如果把 AI 比作是马的话,Hermes 就是给这匹马配置的一套马具。有了这套马具之后,我们才能更好地去驾驭这匹马。

通俗来讲,Hermes 是一个架构,它让你能够把原来的 AI 大模型从“陪你聊天”,变成真正可以帮你落地做一些事情,比如:

  1. 回复邮件

  2. 办公自动化

  3. 帮你写文档

  4. 帮你剪视频或生视频

  5. 帮你写代码到本地

  6. ...

开源地址:https://github.com/deepseek-ai/deepseek-harness

官网:https://www.deepseek.com/harness/

1.安装

安装前准备工作

无论以下任何安装方法,需要先在当前电脑安装 Node.js 环境才行,验证当前电脑有没有安装 NodeJS,输入以下命令:

  1. 如果能显示版本号,说明已经安装成功,可以跳过这一步进行下一步安装 DSH。

  2. 否则,需要先去 NodeJS 官网下载安装包,傻瓜式一路双击“下一步”安装完成之后,再执行下一步(安装 DSH)操作。

NodeJS 安装包下载:https://nodejs.org/zh-cn/download

1.1 npx 简易安装(不推荐,非完整版)

这种方式适合临时体验,打开终端执行:

npx @deepseek-ai/dsh web

第一次运行会自动下载依赖,等待时间可能稍长。终端出现启动成功的提示后,就可以继续操作。

出现这个提示,说明服务已经启动。

在浏览器打开:

http://127.0.0.1:3080

浏览器就是操作界面,不需要额外安装桌面客户端。

1.2 源码安装(不推荐,适合专业技术人员)

源码安装步骤较多,后续更新和维护也更麻烦。它更适合需要查看源码、二次开发或调试插件的专业技术人员。

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

普通用户没必要折腾这套流程,直接使用下面的 npm 满血版即可。

1.3 npm 满血版安装(推荐,适合普通用户)

这是普通用户最推荐的安装方式。它会把完整版永久安装到电脑上,以后启动更方便。

npm install -g @deepseek-ai/dsh

安装完成后,执行下面的命令启动:

dsh web

终端提示启动成功后,在浏览器打开:

http://127.0.0.1:3080

2.配置

DeepSeek Harness 安装完成之后,首先要配置大模型的 API key 才能使用,它的操作分为以下两步:

  1. 申请APIKey(注册并登录账号):https://platform.deepseek.com/
  1. 设置APIKey
输入上一步获取的 API 密钥。

PS:配置完成之后,必须要选择一个文件夹工作区域才能正常使用。

配置更多模型:https://deepseek-harness.github.io/deepseek-harness/guide/providers

3.四种模式

关于PTC模式

PTC 在 DSH 这里指的是 Programmatic Tool Calling,程序化工具调用

不过你不用太纠结英文,记住它的核心就行:

让 AI 不再一个工具、一个工具地慢慢调用,而是先写一段 TypeScript 小程序,把很多步骤一次性串起来执行。

比如标准模式可能是:

读文件 → 调工具 → 看结果 → 再调工具 → 修改 → 再测试

PTC 更像:

先想好整个流程 → 写一段程序 → 一次执行很多步骤

所以你可以把 PTC 简单记成:

“让 AI 用程序控制一整套操作的模式”

DSH 的资料也把它称作 Code 模式,底层通过 Code Mode SDK 工作。

顺便说一句,PTC 最大优势通常不是“更聪明”,而是复杂任务里调用工具更高效、往返次数更少

例如,你让 AI 助理帮你去采购食材:

第一次买土豆。

第二次买酱油。

第三次买盐。

第四次买醋。

...

  • 如果你使用的是标准模式,它会第一次买完给你交付结果,然后再执行第二次、第三次、第四次...;

  • 如果你使用的是 PTC 模式,它会先写好一张购物清单,写好之后再拿着这个清单一次性把所有食材买出来,然后再告诉你结果。

4.优缺点分析

优点

  1. 开源、高度可定制。适合用户/企业自定义和 DIY 自己的 AI 产品。
  1. 使用自家的DeepSeek模型缓存命中率很高,会节省使用成本和提升执行速度。

缺点

  1. 新发布的软件问题比较多,功能比较少。

  2. 目前官方不支持视觉模型、手机电脑互联等功能、官方也没有提供自己的客户端(只有网页端)。

5.热门插件安装

热门插件项目:https://github.com/awesome-dsh-plugin/awesome-dsh-plugin

插件官网:https://awesome-dsh-plugin.com/zh/?cat=ui

GPT 充值

我的新业务 GPT/ Claude /Gemini 充值:https://pay.ldxp.cn/shop/stone

正规渠道充值 | 全程质保 | 7*24 小时自助下单充值

GPT/Claude/Gemini在线充值(全程质保):https://pay.ldxp.cn/shop/stone