
你好,我是国光。
这篇文章将从头看到尾带你体验不用敲一条命令,使用workBuddy快速安装 DeepSeek Harness。
8 月 13 号,DeepSeek 开源了一个叫 DeepSeek Harness的新东西,简称:DSH。官方地址:https://www.deepseek.com/harness/
很多人想尝鲜,结果卡在了安装上。官方还没出一键安装包,得从源码编译,装之前要核对 Node 版本、pnpm 版本,装的时候还可能踩符号链接、删除钩子各种坑。
用 WorkBuddy 的话,这些全都不用管。
你只要说一句:「帮我装 DeepSeek Harness,地址:https://github.com/deepseek-ai/deepseek-harness」
剩下的事它自动干完:检查环境、下载源码、装依赖、处理各种坑、构建、配好命令、跑通验证。版本对不对、环境合不合适,都是它自己查、自己确认,你从头到尾不用核对任何东西。
下面我带你看一遍整个过程,顺便告诉你,WorkBuddy 在背后都自动帮你确认了哪些。
装之前,先认识一下它
花半分钟搞清楚 DeepSeek Harness 是啥,不然装完也不知道手里多了个什么。
你可以把它理解成套在 AI 模型外面的一层壳。模型负责算,壳负责管:怎么调模型、怎么组织上下文、怎么调工具。我们日常用的 Claude Code、Codex,背后都有这么一套壳。
市面上这些壳,底层核心都是封装的,不更新版本就动不了,想加功能只能往外层套插件。
DeepSeek 这回把 Session、System Prompt、工具、agent 循环这些核心,全拆成了插件。项目首页就一句话:Everything is a Plugin,一切皆插件。
拆完之后,最底下只剩一个叫 Cordis 的小内核,只干几件最基础的事。剩下的交给运行时自动管:哪个插件缺依赖就先不启动,依赖齐了再加载;哪个组件被换掉,依赖它的自动重载。
你不用深究这些。只要记住一点:这东西刚出来,还在很早期,没有一键安装包。
所以普通人想装,最省事的路子就是交给 WorkBuddy。
第一步:环境检查,WorkBuddy 自动确认
手动装过的人都懂,第一步不是下载,是核对环境。
要自己敲 node --version,看 Node 够不够 22.19+;再敲 pnpm --version,确认是不是 11.7.0;还要看 git 装没装、GitHub 连不连得上、磁盘有没有 1 GB。
版本不对就装到一半报错,报错信息对小白来说跟天书一样。
这些确认,WorkBuddy 全自动帮你做了。它会自己检测机器上的 Node、pnpm、git 版本,版本不对自动提醒、甚至帮你处理,磁盘不够会提前告诉你。你从头到尾不用核对一个版本号。
第二步:下载源码,WorkBuddy 自动选路
环境没问题,下一步是把源码拉到本地。
手动装的话,这一步也要挑。先试 git clone,如果 GitHub 主站连不上、超时,就换 codeload 的归档下载,还得自己判断走哪条。
WorkBuddy 会自动试、自动判断当前网络走哪条最稳。你不用知道 git clone 和 codeload 有什么区别。
第三步:装依赖,坑最多的一步,也是它最省心的一步
源码下来后,要装 900 多个依赖包。手动装的话,这一步是重灾区,尤其 Windows 沙箱环境,有四个坑。
坑一,装到一半报删除失败。因为受限环境会把删除操作路由到一个不存在的回收站,导致 pnpm 中途退出。手动装要自己清空 NODE_OPTIONS 变量。
坑二,卡在 linking 阶段几十分钟不动。因为 pnpm 默认给 900 多个包建符号链接,Windows 沙箱建符号链接特别慢。手动装要自己建一个 .npmrc 文件,写 node-linker=hoisted。
坑三,卡在 postinstall 没动静。因为有两个包的构建脚本要去 GitHub 下载二进制,主站不通就无限挂起。手动装要自己改 pnpm-workspace.yaml,把 lefthook 和 node-pty 设成 false。
坑四,重跑报错。因为上次中断的安装留了残留,手动装要自己清理 node_modules 和 pnpm store。
这四个坑,每一个都能卡你半小时。而 WorkBuddy 会自己判断该不该清空 NODE_OPTIONS、自己写 .npmrc、自己改 allowBuilds、自己清理残留。符号链接、钩子这些词,你一个都不用懂,它全在后台给你排好了。
第四步:构建,配好命令,WorkBuddy 自动完成
依赖装完,要把源码编译成能跑的程序,再让 dsh 命令在你电脑任何地方都能敲。
手动装的话,要先跑 pnpm run build:lib,再手动写启动脚本,还要自己把目录加进 PATH。Windows 上尤其烦,PATH 没配对就报「不是内部或外部命令」。
WorkBuddy 会自动跑构建,自动生成启动器,自动配好 PATH。装完你直接就能敲 dsh,不用管什么环境变量、启动脚本。
第五步:跑通验证,WorkBuddy 自动确认装好了
最后一步,确认整个安装真的成功。
手动装要自己敲 dsh -V 看版本号、dsh --help 看帮助、dsh web 起服务,一条条核对输出对不对。
WorkBuddy 会自动跑这些验证,自动确认返回结果正常。装好之后,它直接告诉你「可以用了」,本地访问地址一并给你。访问地址:http://127.0.0.1:3080/
UI界面如下,非常简洁:


夜雨聆风