DeepSeek Harness保姆级教程：从安装到自动化插件

为什么需要 DeepSeek Harness 客户端

长期以来，DeepSeek^广告 的模型以高性价比著称，但官方一直停留在网页端聊天窗口的形态。DeepSeek Harness 客户端的推出改变了这一点：它不再是单纯的对话工具，而是把本地文件读写、插件集成、任务自动化串联起来的智能体运行环境。据 B 站 UP 主在教程中演示，装上 Harness 之后，AI 可以直接读取本地文件夹内容、修改文件或把生成的文件保存到指定目录——这些操作在网页端是做不到的。

这也是本教程试图解决的问题：对没有技术基础的新手来说，如何绕过复杂的配置，先把环境跑起来，再逐步理解智能体的工作方式。整套课程从安装配置讲到工作模式、权限设置、补计划操作和命令行操作，最后用一个动手制作小游戏的案例串起完整流程。

第一步：安装 Node.js 环境

Harness 客户端本身安装很简单，真正的前置条件是 Node.js。教程作者指出，很多 AI 工具（包括 Claude、Codex 等）都依赖 Node.js 环境，所以这一步无法跳过。

有两个细节需要注意。其一是版本：建议选择 20 以上的版本，不要低于这个门槛。其二是安装路径：不要把 Node.js 装到 C 盘，一是安装本身占空间，二是它会产生大量缓存文件，容易把系统盘吃满，建议改到 D 盘。下载方式上，UP 主选择 MSI 安装包，因为可以直接点击安装，而 ZIP 包还需要额外解压。

安装完成后需要验证。打开命令行（找不到入口就输入 CMD），输入 node -v，如果返回的版本号大约等于 22，说明环境已经就绪。

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它让 JavaScript 可以脱离浏览器直接在操作系统上运行。大量现代 AI 开发工具、命令行程序和插件生态都以 Node.js 作为底层运行环境，因为其包管理器 npm 能快速分发和更新依赖。文章中提到的 node -v 是 Node.js 自带的版本查询命令，返回的版本号格式为主版本.次版本.修订号，主版本达到 20 以上即可满足多数新工具的要求。此外，Node.js 在运行过程中会在用户目录下生成 npm 缓存和模块依赖文件，单个项目的依赖体积可能达到数百 MB，这也是建议避免安装在系统盘的实际原因。

第二步：安装 Harness 客户端

访问 Harness 的下载页面，选择对应系统的安装文件，同样建议装到 D 盘。安装完成后打开界面，整体布局和网页端聊天窗口接近，但多出了一个关键能力：添加本地文件夹。选定文件夹后，AI 就能读取、修改其中的内容，或把文件保存进去。界面上还可以直接切换 DeepSeek 的几款模型。

插件的三种安装方式

Harness 基于 Codex 的插件架构，真正的能力边界扩展来自插件集成。教程给出了三条路径，各有取舍。

方式一：让 AI 自己装

如果已经知道插件名称，可以直接在聊天窗口里把 GitHub 链接发给它，让它自行安装。这种办法最省事，但会消耗 Token 和积分。

方式二：通过插件市场安装

不想花积分的用户，可以在插件市场里手动安装。操作路径是点击添加插件，输入插件名称（例如 DSH Market），装好后点击立即启动，再进入设置页面就能看到市场入口。市场里汇集了大量插件，支持搜索和筛选，也有推荐位，挂件、桌面宠物之类的插件点一下就能装上。

方式三：命令行安装

第三种方式相对抽象一些，适合有一定基础的读者。在插件主页下方通常有 "Install with" 一类的选项，复制那段代码，粘贴到命令行里执行即可。UP 主以一款视觉插件为例演示了完整过程：原生 DeepSeek 无法识别本地图片，装上该插件后，它就能判断图片里的人物数量、穿着特征等信息。

如果不知道有哪些插件值得装，可以直接问 DeepSeek，让它推荐一份热门且实用的插件清单，再按需挑选。

Codex 在这里指的是一套面向 AI 智能体的插件与工具集成架构，它定义了插件如何声明自身能力、如何被主程序加载以及如何与模型交互。与传统软件插件不同，Codex 架构下的插件往往直接向模型暴露可调用的函数或工具接口，使模型能够主动请求执行某个操作，而不是被动等待用户点击菜单。这种设计让 Harness 能在不修改核心程序的前提下扩展出识图、抓取网页、操作知识库等能力。理解了这一点，就能明白为什么文章反复强调「插件才是 Harness 的核心价值」——客户端本身只是运行时外壳，真正的能力边界由所安装的插件集合决定。

命令行（Windows 下即 CMD 或 PowerShell）是通过输入文本指令来操作计算机的界面，与图形界面的点击操作相对应。文章中提到「复制 Install with 后面的代码粘贴到命令行执行」，这类命令通常是 npm install 或类似的包管理指令，执行后会自动从远程仓库下载插件文件并注册到主程序。使用命令行安装的好处是速度快、不消耗模型的 Token，缺点是需要确认当前目录正确、命令拼写无误，否则会出现找不到包或权限不足的报错。对新手而言，可以先从插件市场入手，等熟悉了插件名称和安装位置后再尝试命令行方式。

插件能把 Harness 带到多远

教程中列举的场景跨度很大：去 B 站阅读内容并把内容转成文字、进入知识库做管理、生成视频、整理知识目录、搭建 QQ 机器人，甚至接入聊天软件与他人对话。这些场景的共同逻辑是，把模型能力嵌入到具体的工作流和工具链里，而不是停留在问答层面。

对新手来说，这套课程的编排思路值得参考：先建立基础认知，再完成环境与客户端的准备，然后理解工作模式和权限这类控制层概念，最后用实际案例巩固。作者也明确，本节只讲安装与插件入口，后续课程才会逐一拆解常用插件的安装方法和业务用途。

几个容易踩的坑

• 版本低于要求：Node.js 必须选 20 以上版本，否则后续工具可能无法运行。
• 默认装在 C 盘：空间占用和缓存堆积会拖慢系统，安装时手动改路径。
• 装完不验证：务必用 node -v 确认版本号，避免后续报错时无从排查。
• 忽略插件入口：Harness 的核心价值在插件，只把它当聊天窗口用就浪费了这套架构。