如果不是我踩了太多坑一开始直奔CMD命令行安装可能十分钟就好因为不相信Workbuddy走不通导致我安装好几回滞留了很多安装进程增加来回折腾的难度和时间。这篇文章是写给完全没接触过编程的朋友看的。你不需要懂代码只需要会复制粘贴、会按回车。文里每一个「听不懂的词」我都会用大白话生活类比解释一遍。零、先搞清楚我们到底在折腾个啥一句话我们要把一个叫DeepSeek Harness小名 dsh的软件装到你自己的 Windows 电脑上然后打开浏览器就能用它。但你可能会问「DeepSeek 是啥WorkBuddy 又是啥为啥我让 WorkBuddy 帮我装它装不了最后却要在我自己电脑上装」别急下面把这三个「主角」一个个讲明白。一、三个主角都是谁看不懂先读这节 主角 1DeepSeek —— 一个会聊天的 AI你可以把 DeepSeek 理解成一个特别聪明的聊天机器人和 ChatGPT 类似但这是中国公司做的而且很便宜。它能写代码、回答问题、帮你干活。 主角 2DeepSeek Harnessdsh—— 一个「会自己干活的机器人管家」DeepSeek 本身只是个聊天框。Harness英文意思是「 harness 马具/驾驭」是 DeepSeek 官方出的一个更高级的工具你可以把它想象成雇了一个住在你电脑里的机器人管家。你在网页上对它说「帮我把这个文件夹里的图片都重命名」「帮我把这段 Python 代码跑一下」它就真的去动你电脑里的文件、运行程序。它启动后在你自己的浏览器里开一个操作页面网址是http://127.0.0.1:3080后面会讲这是啥。你要在那个页面里填上 DeepSeek 的「钥匙」API Key管家才能上岗。 主角 3WorkBuddy —— 你现在用的这个 AI 助手软件WorkBuddy 是你正在对话的这个软件。它本身很厉害但它不是你的整个电脑它有个「自己单独的小房间」。 配角Node.js、npm、pnpm —— 「快递打包站」dsh 不是一块铁它是一大堆小零件拼起来的官方说有 500 多个小零件。装它本质是把这 500 多个零件下载下来、拼好、再让其中几个零件现场加工一下。负责「下单→收货→拼装」的工具叫包管理器。常见的有两个名字大白话类比Node.js让 dsh 能跑起来的「运行环境」就像「电」——管家要干活得先通电npm一个快递站老牌、用的人最多就像邮局你下单它寄零件来pnpm另一个快递站 newer、更快就像顺丰也是寄零件但走不同的路有时更稳名词解释 · 包package程序员把一小段功能打成一个「包裹」别人想用直接下载这个包就行不用自己重写。dsh 就是由 500 多个这样的包裹拼成的。下载包裹的这个动作行话叫「安装依赖」。名词解释 · 命令行 / CMD / 终端就是那个黑底或白底的、要你打字输入指令的窗口。Windows 里按Win R输入cmd回车弹出来的就是它。后面所有操作都在这里敲字。二、为什么 WorkBuddy 里装不了很多人第一关就卡这你一开始让我WorkBuddy直接帮你装结果折腾半天没成。这不是你操作的问题是环境本身的限制。用大白话讲三个原因原因 1WorkBuddy 有个「玻璃房」删东西走特殊通道一碰中文名就乱码WorkBuddy 为了安全在自己内部弄了一个隔离的小房间技术叫「沙箱」。这个房间有个特殊设定任何文件要删除都得先扔进「回收站」而不是真删。名词解释 · 沙箱sandbox就像小孩玩的沙盘在里面怎么折腾都不会弄脏真实的地板。软件世界里沙箱是一个和外界隔离的临时空间在里面跑程序不会影响你真正的电脑。问题出在这个「先扔回收站」的补丁遇到中文用户名的文件夹路径比如你的用户名是「XXX」时会把路径名字编码搞乱成乱码导致零件解压解压 把下载的压缩包打开铺平这一步直接崩溃。原因 2玻璃房是临时的不是你真正的桌面即便勉强装进去那个房间是 WorkBuddy 临时借给你的关掉、重启、或者它自己清理时里面的东西就没了。你真正想用的是装在你自己电脑D:盘上、关机也在的东西。原因 3就算换到你本机npm 这个快递站也会「堵车假死」这一点和 WorkBuddy 无关是 npm 自己的老毛病详见第四节坑 1。dsh 零件太多500npm 处理这种超大包裹时会卡死不动。✅ 结论记住这句就行别在 WorkBuddy 里装 dsh。装在你自己真实的 Windows 电脑上用官方 Node放到一个纯英文名字的文件夹里。这才是正道。三、动手前准备两样东西5 分钟第 1 样装官方原版 Node.js给管家「通电」打开浏览器搜「Node.js 官网」或直接访问https://nodejs.org/zh-cn下载LTS 版本长期支持版最稳dsh要求版本在:22.19.0 || 24.0.0之间双击安装一路「下一步」即可装到哪个盘都行建议装到C:\Program Files\nodejs或D:\Program Files\nodejs纯英文路径很重要 验证装好没打开 CMD按WinR→ 输入cmd→ 回车输入node -v回车如果蹦出一串版本号比如v24.19.0就说明通电成功了。第 2 样建一个「纯英文名字」的文件夹在D:盘根目录新建一个文件夹名字里不要有中文、不要有空格。✅ 推荐D:\DeepseekHarness注意我去掉了空格❌ 别用D:\Deepseek Harness有空格命令行要加引号很麻烦❌ 更别用C:\Users\XXX\...中文用户名会触发上面说的乱码 bug名词解释 · 路径path就是文件在电脑里的「家庭住址」。比如D:\DeepseekHarness\package.json意思是「D盘 → DeepseekHarness 文件夹 → 里面的 package.json 文件」。中文路径 住址里带中文有些老软件读不懂就崩。补充CMD 新手专属 —— 你一定会懵的 6 件事必看这节专讲「用命令行时新手最容易慌、最容易以为自己搞砸的地方」。这些不是软件 bug是操作习惯问题提前知道就不慌。我当初装的时候这 6 件事件件都懵过。① 怎么打开 CMD要管理员吗按Win R→ 输入cmd→ 回车。弹出来的黑窗口就是。不需要管理员权限也别去搜什么「以管理员身份运行」。我们全程装在自己建的D:\DeepseekHarness文件夹里是普通用户就能干的事没碰系统核心多此一举反而容易出权限乱子。② 窗口开头那串C:\Users\XXX是啥那串字叫「命令提示符前缀」意思是「你现在站在电脑的C:\Users\XXX这个位置」。它只是个路标不用管它长啥样。你只要在它后面敲命令、按回车电脑就照做。很多新手包括我一开始以为「得先把这串字改对才能动」其实完全不用——它显示啥都不影响你输入命令。名词解释 · 当前目录 / 工作目录命令行有个「你现在站在哪」的概念。前缀里写的路径就是你的站位。用D:和cd命令能换站位见下条。③ CMD 只能装到 C 盘吗不是。CMD 一打开默认站在 C 盘但你可以用两句话「走」到 D 盘D:cdD:\DeepseekHarness第一行D: 「切换到 D 盘」注意只写盘符加冒号别漏冒号。第二行cd D:\DeepseekHarness 「进到这个文件夹」。之后所有安装动作都发生在 D 盘那个文件夹里跟 C 盘无关。④ 文件夹是空的 / 半天没新行是不是没在装很可能是正常的别慌。两个原因pnpm 下载是后台跑的开头几秒可能一行新字都没有像卡住其实在干活零件是「先攒齐、再一次性写进文件夹」的所以你盯着D:\DeepseekHarness看中途它经常是空的——要等下载解压完才突然冒出一堆文件。判断真假的窍门看 CMD 窗口里有没有在刷进度比如resolved 190, downloaded 175这种数字在涨。数字在涨 活着要是十几分钟一个数字都不动、也没报错那才是真卡了按坑 1 换 pnpm。⑤ 满屏红字 warning吓死是失败了吗红字 ≠ 失败。命令行里红色常常只是「提醒」不是「完蛋」。真正致命的错误通常带error字样并且会停下不动。拿不准就记住这条ERR_PNPM_IGNORED_BUILDS红字→ 只是「我拦了编译等你批准」跑approve-builds就好见坑 4EBADDEVENGINES、ERR_MODULE_NOT_FOUND红字→ 这才是真错按坑 3、坑 2 处理其他刷屏的warning/gyp/cmake白字 → 基本都是编译过程中的正常噪音别理。⑥ approve-builds 出来列表按啥关掉窗口白装了吗列表出来后按a全选、回车再按y确认然后等它编译完刷一堆白字是正常的1–3 分钟。关掉窗口不会白装你装好的几百个文件都老老实实躺在D:\DeepseekHarness里关窗只是把「当前这个对话框」关了文件一个不少。下次想用重新开 CMD →D:→cd D:\DeepseekHarness→ 再敲npx deepseek-ai/dsh web启动就行不用重装。所以当初看到「好像失败了」别急着放弃文件可能早就在了。✅ 这 6 件事记牢你就能把「命令行焦虑症」彻底扔掉开普通 CMD、别管前缀、用D:cd换盘、空文件夹别慌、红字先分清、关窗不白装。四、安装会踩的 5 个坑每个都大白话下面是我真机安装时按顺序踩的 5 个坑。你照着第五节的正确命令走就能一口气避开它们。但先看懂「坑长啥样」以后出问题你才不慌。 坑 1npm 卡住不动快递站堵车假死现象你下了npm install deepseek-ai/dsh这个单等了十几分钟啥动静没有也不报错就是「活着但不干活」。为什么npm 这个老快递站遇到 500 多个零件一起下单的大单子在「核对包裹清单」那一步有个已知的老 bug会直接卡死。我试过换缓存、换 Node 版本全都没用。怎么办别死磕 npm换 pnpm 这个快递站。它走完全不同的路能绕过这个堵车。名词解释 · 假死程序没崩溃、也没报错但就是停在那不往前走。看起来像死机其实进程还活着只是在发呆。 坑 2pnpm 下完却「少零件」peer 依赖丢了现象换成 pnpm 下完了 502 个包结果一点「启动」报错说找不到deepseek-ai/dsh-client-ui-goal这个包。为什么dsh 是个「大作坊」技术叫 monorepo下面解释里面有 50 多个互相依赖的小作坊。有些零件是「搭子零件」技术叫peer 依赖平时不单独下单得靠主零件带着走。pnpm 默认不帮你把搭子零件接上于是启动时缺料崩了。怎么办用pnpm add正式安装会接好搭子代替pnpm dlx临时试用不接搭子并加两个参数把零件全摊平摆好见第五节。名词解释 · monorepo单体仓库字面意思是「一个仓库里装了一堆项目」。就像一栋大楼里住了 50 家公司互相借东西用。dsh 就是这种结构所以零件关系特别复杂。名词解释 · 依赖dependencyA 零件要干活得靠 B 零件提供的能力就叫「A 依赖 B」。peer 依赖 平级搭档依赖两个零件级别一样、得互相配合但谁也不包含谁得你手动把它们摆在一起。 坑 3工程文件里写了「必须用 pnpm」但我们用 npm 去叫它它拒绝现象跑安装时报EBADDEVENGINES ... pnpm does not match npm。为什么pnpm init会自动在一个叫package.json的小本本工程说明书里写一行「本工程指定用 pnpm 11 版本」。但我们是用npxnpm 家的命令去调 pnpm 的npm 一检查「咦你命令是我 npm 派的本子却写要用 pnpm不对劲拒了。」怎么办手动打开D:\DeepseekHarness\package.json把那行「devEngines」整段删掉只留名字、版本、类型、依赖清单就行。名词解释 · package.json每个 Node 项目的「身份证说明书」文件记着项目叫啥、用哪些零件、有什么规矩。名词解释 · devEngines / packageManager说明书里规定「该用哪个版本的打包工具」的一项规矩。对我们这种手动装的用户它纯属添乱删掉就好。 坑 4pnpm 默认「不现场加工零件」原生模块没编译现象443 个包装好了启动却说找不到 binding零件接不上。为什么dsh 里有 5 个特殊零件是「半成品」需要你电脑现场用 C 编译器加工一下才能用比如node-pty、koffi。pnpm 10 版本后加了道「安全门」默认不许跑这种加工脚本怕脚本乱改你电脑于是这 5 个零件一直停在半成品状态。怎么办跑一条pnpm approve-builds命令出来 5 个零件的清单按a全选、回车再按y确认等 1–3 分钟编译完屏幕上刷一堆cmake/gyp/cl白字是正常的别怕。名词解释 · 原生模块native module用 C/C 写的、需要当场编译成你电脑能懂的机器码的零件。不像普通 JS 零件下载就能用它得「现场加工」。名词解释 · 编译build / compile把人写的高级语言翻成电脑 CPU 能直接执行的机器语言的过程。类比把中文菜谱翻译成你妈能直接下厨的操作步骤。名词解释 · build script构建脚本自动执行「编译」这段操作的指令文件。pnpm 的安全门就是拦这个。 坑 5CMD 里敲dsh说「不是内部或外部命令」现象零件都齐了你敲dsh web回车它回你一句「‘dsh’ 不是内部或外部命令也不是可运行的程序」。为什么pnpm 把启动器放在node_modules\.bin\dsh.cmd这个角落但 Windows 的 CMD 默认不去那个角落找人。怎么办唯一正确启动法用npx帮你在角落里把人揪出来D:\Program Files\nodejs\npx.cmddeepseek-ai/dsh web注意必须写全名deepseek-ai/dsh不能只写dsh前面npx.cmd是帮你定位启动器的「向导」。名词解释 · npxnpm 自带的一个「临时跑一下某个包」的小工具。它会在项目的零件角落里找对应的启动器所以用它来启动 dsh 最稳。名词解释 · 端口port你电脑上不同程序对外沟通的「门牌号」。dsh 默认走3080号门。127.0.0.1是「本机」的意思自己电脑的专属地址外人进不来。如果 3080 被占了它会自动顺延到 3081、3082以窗口里实际显示的为准。五、正确命令复制粘贴版 · 照抄就行心路历程Workbuddy一句话安装这个路走不通一开始HY3模型来操刀安装失败换成更聪明的Deepseek V4 pro一样失败我只能选择走CMD命令行。先安装最新的Node.jsdsh安装包下载成功又弹出别的问题一直是截图给Workbuddy解释并走下去发现WB不行换问Deepseek网页版结果还是创始人行。来回花了半小时走通了作为小白失败几遍超越自己认知硬着头皮走下坚持就是胜利。但是Dsh实在太毛坯了我居然要问他112多少来判断究竟是模型问题还是框架问题因为个人觉得很简单的问题居然花了5分钟都没答案中途被我强制关闭。唯独优点是内存占用好像不高不像WB分分钟就2G。希望下次入住的是精装修能自定义专属的Agent不浪费我充值了10块Deepseek的API还剩9.96元呢。打开 CMDWin R→ 输cmd→ 回车一行一行复制下面内容每行粘完按回车D:cdD:\DeepseekHarnessD:\Program Files\nodejs\npx.cmd--yespnpminitD:\Program Files\nodejs\npx.cmd--yespnpmadddeepseek-ai/dsh --shamefully-hoist --config.dedupe-peer-dependentsfalse名词解释 · --shamefully-hoistpnpm 的一个「摆摊参数」。意思是「把所有零件不管层级全平铺到最上层架子上」模拟 npm 的摆法。monorepo 这种复杂作坊不摊平就会丢搭子零件见坑 2。名字虽然羞耻但真有用。名词解释 · --config.dedupe-peer-dependentsfalse关掉「peer 依赖去重」。去重虽好但有时会为了精简把关键链接吞掉关掉它更稳。跑到上面最后一行如果它问Do you approve? (y/N)按y回车。然后继续复制D:\Program Files\nodejs\npx.cmd--yespnpmapprove-builds清单出来后按a回车全选 5 个包原生零件再按y回车确认等它编译完1–3 分钟刷白字正常。最后启动D:\Program Files\nodejs\npx.cmddeepseek-ai/dsh web看到窗口里输出http://127.0.0.1:3080这行复制这个网址到浏览器打开就是 dsh 的界面了⚠️红字 ≠ 失败pnpm 的ERR_PNPM_IGNORED_BUILDS只是「我拦了编译等你批准」的提示跑 approve-builds 就好而EBADDEVENGINES、ERR_MODULE_NOT_FOUND才是真错误要按上面坑 3、坑 2 处理。六、启动后接哪种「钥匙」免费第三方 APIagnes-ai怎么接第一次打开 dsh 网页接电源插入模型钥匙API密钥「怎么接模型选钥匙」。官方的当然好只不过一个简单打招呼花了我3分钱。我选择用的是一个免费的第三方 API叫 agnes-ai——注册就送额度、还直接兼容 OpenAI 协议最省事。下面一步步讲怎么接。来源自https://blog.csdn.net/m0_64708871/article/details/163826829第 1 步去 agnes-ai 注册拿到「钥匙」打开浏览器访问https://platform.agnes-ai.com注册一个账号登录后在平台里找到「API 密钥 / API Key」页面复制那串sk-开头的钥匙这串钥匙就是 agnes-ai 发给你的「门禁卡」等下填回 dsh 用名词解释 · API Key密钥/钥匙一串密码相当于「门禁卡」。你把它给 dshdsh 才能代表你去呼叫 agnes-ai 的服务。这串钥匙别随便发到网上别人捡到就能用你的额度。第 2 步在 dsh 里「添加自定义提供方」回到 dsh 的网页界面进设置 → 模型Settings → Models点「添加自定义提供方」Add custom provider在弹出的表单里按下面这张表一项项填字段建议值说明Provider IDagnes小写字母用于请求路由与内部标识显示名称可留空或填与 Provider ID 一致在模型选择器中显示的名称API 地址https://apihub.agnes-ai.com/v1/chat/completions兼容 OpenAI Chat Completions 的 endpointAPI 协议openai-completions选择 OpenAI 兼容协议API 密钥上一步复制的密钥用于鉴权填完点击获取可用模型保存dsh 就接上了 agnes-ai。之后在模型选择器里就能看到它选中就能聊天、让它读你指定文件夹的文件、跑任务。小提醒agnes-ai 是兼容 OpenAI 协议的所以「API 协议」那栏选openai-completions就对了很多第三方免费 API 都是这个套路。Provider ID 用纯小写agnes最稳别用中文或大写免得路由认不出、内部标识乱掉。七、名词小词典一口气复习词大白话DeepSeek一个便宜好用的中国 AI 聊天机器人DeepSeek Harness (dsh)一个住在你电脑里、能用网页指挥它干活的「机器人管家」WorkBuddy你正在用的 AI 助手软件有个临时的「玻璃房」沙箱Node.js让 dsh 能跑起来的「运行环境」相当于给管家通电npm / pnpm两个「快递站」负责把 dsh 的 500 多个零件下载拼好包 (package)一小段打包好的功能下载它叫「安装依赖」沙箱 (sandbox)和真实电脑隔离的临时小房间里面折腾不影响外面路径 (path)文件在电脑里的住址中文路径有些软件读不懂会崩monorepo一栋楼里住 50 家公司50 互相依赖的子项目依赖 / peer 依赖A 干活要靠 B 的能力peer 平级搭档得手动摆一起原生模块用 C 写的、需现场「编译」加工的零件编译 (build)把人写的代码翻成电脑 CPU 能直接跑的机器码npxnpm 带的「临时跑一下某个包」工具能帮你找启动器端口 (port)程序对外沟通的门牌号dsh 默认 3080127.0.0.1「本机」专属地址只有你自己的电脑能进API Key一串密码门禁卡让 dsh 能代表你呼叫 DeepSeek快捷方式 (shortcut)桌面小图标是「指向程序的书签」双击就替你执行某条命令服务 / 服务器在后台持续运行、随时响应请求的程序dsh 的服务跑在 CMD 窗口里关窗即熄火八、踩坑速查表出事了对号入座你看到的现象大白话原因一句话解法npm 卡十几分钟不动快递站堵车假死换 pnpm启动报找不到某包搭子零件没接上用pnpm add --shamefully-hoist报 EBADDEVENGINES工程本子指定用 pnpmnpm 不爽删 package.json 里的 devEngines装完启动缺 binding原生零件没编译pnpm approve-builds按 a 回车、y 回车敲dsh说找不到命令CMD 不去角落找人用npx deepseek-ai/dsh webTip如何dsh做成桌面快捷方式 —— 以后双击就开不用再敲命令装好一次之后每次想用 dsh 都要开 CMD、敲那一串命令太麻烦。可以做一个桌面图标以后双击就自动启动彻底告别手敲。温馨提醒第二天重新开电脑要先开CMD切换到你的项目目录输入cd /d D:\Deepseek Harness回车再输入以下命令启动npx deepseek-ai/dsh web这是双击才能自动再启动。⚠️ 铁律那个黑色 CMD 窗口绝对不能关 / 不能删这一点必须先刻进脑子dsh 的服务发动机是跑在那个黑色 CMD 窗口里的。你在浏览器里看到的网页是靠这个窗口在背后持续供着电。关掉、或删掉这个 CMD 窗口 直接把发动机熄火 浏览器页面立刻断连、白屏崩溃。所以窗口开着、你在网页里用得好好的别手贱去点窗口右上角的 ✕。想停用时要么直接关窗口服务随之停止要么在窗口里按Ctrl C温柔停下。 类比这个 CMD 窗口就像汽车的发动机舱。车在跑网页在用你不能把引擎盖掀了把发动机抱走——抱走车就瘫了。之前有人以为「窗口是多余的弹窗」顺手关了结果网页瞬间崩就是这个原因。做法3 步建桌面快捷方式在电脑桌面空白处点右键→ 选「新建」→「快捷方式」。在「请键入对象的位置」这一栏完整复制粘贴下面这行注意只粘这一行别把开头的cmd单独粘进去否则会出错C:\Windows\System32\cmd.exe /k D: cd D:\Deepseek Harness .\node_modules\.bin\dsh web这行长命令的意思是先打开命令行cmd.exe然后依次做三件事——切到 D 盘D:、进到你的项目文件夹cd、最后启动服务dsh web。⚠️路径对不上要改上面写的是D:\Deepseek Harness带空格是当时实际安装的文件夹。如果你是按本文第三节起的无空格纯英文名D:\DeepseekHarness就把命令里的cd D:\Deepseek Harness改成cd D:\DeepseekHarness去掉空格连引号都可省。名词解释 · 快捷方式shortcut桌面那个小图标不是程序本身而是「指向程序的书签」。双击它 自动替你执行后面那行命令。点「下一步」给快捷方式起个名字比如DeepSeek Harness点「完成」。之后双击桌面这个图标就会自动弹出命令行并启动服务。等窗口里出现http://127.0.0.1:3080那行浏览器打开就能用了——再也不用手动敲命令也别忘了「发动机窗口别关」。九、最后一句大实话这类「零件巨多的大作坊monorepo」在 Windows 上安装npm 大概率会教你做人。别信官方那句「一行命令搞定」直接上pnpm shamefully-hoist十分钟能装完。至于为什么一开始让WorkBuddy装没成——那是它自带的「玻璃房」有中文路径乱码的坑加上沙箱是临时的不是你真电脑。正解永远是在你自己电脑上、纯英文路径、用官方 Node 装。希望这篇帮你省下那三个小时的抓狂。装好了去 agnes-ai 领个免费额度接上挺香的。