[控场AI]
科技前沿· 8 分钟阅读· 4,361 字

DeepSeek Harness从零安装到插件精通指南

DeepSeek Harness从零安装到插件精通指南

从Node.js环境到插件选型,讲清DSH装好并用起来的最短路径。

文章基于B站UP主景行的实操教程,梳理DeepSeek Harness(DSH)从零到可用的完整路径。开篇纠正“先找安装包”的常见误区,指出DSH是JS/TS写的桌面工具,必须先装Node.js 22以上版本作为运行前提,并建议避开系统盘、演示了验证版本与手动配置环境变量的方法。随后介绍Git(拉取插件仓库)、NPM(本地编译)与FFmpeg(视频类插件)三个配套工具,再进入DSH本体安装、登录与四种工作模式的说明:标准全能、PTC批量、极简排障、创造模式管插件。插件部分给出市场、GitHub命令行、本地文件夹三种安装路径及npx替换技巧,并按必装、省Token、干活娱乐三类逐一介绍用途,最后提醒长期记忆与“鱼的记忆”插件冲突需二选一,版本不兼容时回退插件版本即可。

DeepSeek Harness(简称DSH)是一个能让AI帮你读文件、写代码、做PPT甚至养桌面宠物的桌面工具。但很多人第一反应是找安装包,装完却发现跑不起来——问题往往出在环境配置上。这篇内容基于B站UP主景行的实操教程,把从环境准备到插件选型的完整路径梳理清楚。

查看安装版本

先装发动机:Node.js是DSH的运行前提

DSH本身是用JavaScript和TypeScript写的。浏览器只能跑网页里的JS,而Node.js让JS能在你电脑上独立运行。UP主用一个比喻:DSH是车,Node.js是发动机,没有发动机车再好也跑不动。后续所有启动命令、插件下载和编译,都依赖它。

安装有两个硬性要求。版本必须选22以上,教程中演示的是24版本,版本太老DSH不认。安装路径不要放在系统盘(C盘),因为本体加上NPM缓存、插件缓存体积会持续膨胀,装C盘用不了多久就会把盘塞满,建议改到D盘等其他位置。

装完后按Win+R输入CMD打开终端,执行 node -v,能看到版本号就说明成功。如果看不到,需要手动配置环境变量:右键此电脑→属性→高级系统设置→环境变量,在Path变量中把Node.js的安装路径写进去,确定后重新验证即可。

环境变量与PATH

环境变量是操作系统用来向程序传递配置信息的键值对,其中 Path 是最常用的一个。当你在终端输入 node 或 git 这样的命令时,系统会按 Path 中列出的目录顺序逐个查找对应的可执行文件;如果安装程序没有把 Node.js 的安装目录写入 Path,终端就找不到 node.exe,于是报“不是内部或外部命令”。手动配置时要填的是包含 node.exe 的那一层目录(形如 D:\nodejs),而不是其上级或子目录。修改完成后必须关闭并重新打开终端,因为已打开的终端只在启动时读取一次环境变量。node -v 能正常输出版本号,才说明路径配置真正生效。

三个配套工具:Git、NPM与FFmpeg

Git是插件源码的搬运工。GitHub上的插件不是压缩包,而是一整个代码仓库,Git负责把仓库完整拉到本地。装插件、更新插件、甚至自己魔改插件都靠它。官网下载Windows 64位版本,安装时同样避开系统盘。装完在终端执行 git --version 验证。

NPM是Node.js自带的包管理工具,专门干编译活。很多插件拿到源码后不能直接用,需要先在本地打包一遍,这个活就是NPM干的。在终端执行安装命令即可,首次安装可能需要稍等。用 npm -v 验证版本号。

FFmpeg与视频剪辑、自动生成视频类插件相关。如果只做办公用途,这一步可以直接跳过。

包管理与本地编译

NPM 是随 Node.js 一起发布的包管理器,它维护一个全球公开的软件仓库(registry),里面存放着数百万个可复用的 JS 包。执行安装命令时,NPM 会先解析依赖树,再把源码下载到本地的 node_modules 目录,必要时运行包内声明的构建脚本完成编译。这正是“插件拿到源码后不能直接用、需要先在本地打包”的原因:TypeScript 需要转译成 JS,部分原生模块还需要调用编译器生成二进制文件。NPM 的缓存默认位于用户目录下,这也是安装路径不宜放在系统盘的原因之一。国内网络访问官方源较慢时,通常会把 registry 换成镜像源来提速。

安装DSH本体并完成初始配置

到官网下载桌面端,选择Windows版本。安装时把路径改到D盘,目录层级不要过深,点击立即安装后等待完成,启动即可。

首次打开需要登录,用微信号或手机号均可,登录后进入引导页面。引导中会让你选择使用场景——办公或代码开发,按需选择即可,也可以跳过。进入主界面后,点击头像→设置,能看到内置插件区域提供的4种工作模式。

设置界面

标准模式是全能选手,文件编辑、终端使用、搜索基本全开,覆盖绝大多数日常项目。代码模式(PTC模式)让AI自己写脚本批量完成操作,批量改文件或整理数据时更快也更省token,但方向一旦错了,翻车的是一整片而非单点,新手建议先用标准模式。极简模式只保留终端和文件编辑器,环境干净,适合排查插件冲突或测试bug。创造模式相当于管理员权限,可以动态写插件、测插件,是插件玩家和养宠玩家的必选项。

插件安装的三种路径

最省心的是插件市场。在插件页添加DSH插件市场,安装完成后点击立即启用,设置里就会出现插件市场入口,想用哪个点安装即可。如果入口没出现,重启或刷新一下。

第二种是用GitHub命令行安装。很多小众插件(比如养鱼插件)在市场里搜不到,需要复制它的安装命令粘贴到终端执行。这里有个万能补丁:如果提示找不到DSH命令,把命令开头的 dsh 换成 npx 开头,基本能解决问题。

终端执行安装

第三种是本地文件夹安装,需要把源码下载解压到本地,改完再装,流程最麻烦。

npx 的作用

npx 是随 NPM 一起提供的命令执行工具,它会先在本地项目的 node_modules/.bin 中查找目标命令,找不到再去临时下载并执行。把命令开头的 dsh 换成 npx 之所以能解决“找不到 DSH 命令”,是因为 dsh 直接调用要求该可执行文件已在 Path 中注册,而 npx 绕过了这一要求,由 NPM 自己去定位或临时拉取对应的包。代价是首次执行可能需要额外下载、耗时略长,且版本以包管理器解析到的为准。

必装类插件:补齐DSH的能力短板

DSH裸装之后其实是个空壳,真正的本事全靠插件堆出来。装插件之前先明确自己的需求,不必全装。

识图插件解决的是原生硬伤——DSH看不了图片,扔张截图或报错界面给它,它跟瞎子一样。装上之后相当于给它一双眼睛,图片上的文字也能识别。前端改页面、产品看设计稿,直接贴报错图甩给它就行。安装时注意把命令末尾的分号去掉,后面跟的是版本号。

构图插件一句话生成架构图、流程图、时序图,可直接导出图片或网页。写技术文档、跟团队对方案时,不用再打开画图工具手动画框。

长期记忆插件让DSH跨对话记事。默认情况下它只有金鱼记忆,关掉再打开就不知道你是谁、项目在哪、喜欢什么写法,每次都要重新交代。这个插件能保存你的编码习惯、项目结构和工作偏好,用得越久越顺手,写代码做项目强烈建议装。

时效性插件强行让模型只搜索最近一个月的新内容,避免照着过时方法踩坑。它是技能包,不在DSH界面里用,需要到终端执行对应命令加载。

Obsidian笔记适配插件专为Obsidian用户准备。AI写笔记时常出现链接指错、白板排版乱掉的问题,这个插件能让链接不跳错、白板不崩。

UI设计技能包来自前Vercel工程师整理的一套设计技能,包含16个小技能,覆盖动效做法、苹果设计风格、Swift开发选UI库等原型设计场景。装完后让AI做网页加动画或调移动端布局,它会自动调用对应技能,产出更专业。安装时选全局、选符号链接,一路默认回车即可。

这里要提醒一个冲突:长期记忆插件和后面养鱼专区的“鱼的记忆”插件同时装会打架。写代码做项目选记忆插件,养鱼玩人设选鱼的记忆,不要贪多。

省Token类插件:把钱花在刀刃上

DSH要烧token也就是烧钱,这一组插件帮你控制成本。

计费面板在侧边栏实时显示本次对话花了多少、余额还剩多少、花在哪里,解决“钱稀里糊涂就没了”的焦虑。上下文看板把上下文占用可视化——多少内容是占位置不干活的、缓存命中了多少,一眼看清瓶颈才能对症优化。上下文医生像体检医生一样自动扫一遍,清理冗余和冲突的插件指令,环境清醒了跑起来才快。智能压缩插件在返回内容时压缩一遍,回答质量不降,token消耗下降。思维固化插件把你的工作习惯、思考逻辑、输出格式要求固化下来,下次直接调用,不用重复交代。深度精简插件在把长对话喂给模型前先压缩,首次跑会消耗一点token,长期使用节省显著。

这六个插件按需挑选,不必全装。

Token 与上下文窗口

Token 是大模型处理文本的基本计量单位,一段文字会被切分成若干 token 计费,中文大致一字到两字对应一个 token,英文则按词片段切分。上下文窗口是模型单次能“看见”的 token 总量上限,系统提示、插件指令、历史对话、文件内容和模型输出都要挤在这一个窗口里。窗口被占满后,早期内容会被截断或丢弃,模型就开始“忘事”;而每轮对话都会把窗口内的内容重新计入费用,所以越长越贵。这就是上下文看板要可视化占用、智能压缩与深度精简要在送入模型前做压缩的根本原因——减少的是计费 token,保住的是有效信息。

干活类与娱乐类插件

一键PPT插件给一个主题就能生成带模板风格的PPT文件,模板选择相当丰富。安装方式特殊:不在DSH里装,要先装好Git和Python,再到系统终端或PowerShell(不是DSH内置终端)执行命令,跑完重启DSH。它从GitHub拉源码,国内网络可能需要代理。

自动视频插件覆盖写脚本、打分镜、压字幕、配音全流程,给一个主题就能出一条带讲解的完整视频,做教程、做产品介绍这类以前折腾一天的活,现在丢给它就行。

娱乐方向,开机动画插件让启动时有一段专属动画,比干巴巴的白屏多点仪式感。壁纸引擎联动可以把Wallpaper Engine里的动态壁纸接进来。侧边栏增强能加上Git面板、文件预览、项目结构树,找东西看项目更顺手。朗读桥让AI用真人语音朗读、聊天自动出声,做教程听长文本时很方便。桌面宠物插件在桌面上放悬浮小宠物,大小、动画、位置都能自己调。鱼的记忆插件是养鱼党的灵魂,能把AI的人设、性格、对话永久保存,关掉重开它还记得自己是谁。

插件配置效果

报版本不兼容怎么办

装插件时如果报版本不兼容,不用慌,大概率是插件太新、当前DSH版本跟不上。把插件版本往后回退一步即可解决。

整套流程走下来,先环境后本体再插件,顺序不能乱。插件选型按需求挑,记住记忆类插件二选一的冲突点,基本就能把DSH用起来了。

#DeepSeek Harness#DSH安装教程#DSH插件#Node.js环境配置#AI桌面助手#省Token插件#AI插件市场
分享:

相关推荐