DeepSeek Harness从入门到实战：安装与插件全解析

DeepSeek Harness 是一个 AI 智能体运行平台，让 AI 从聊天走向执行：写代码、处理文件、调用工具、搭建 Agent 工作流。本文基于 B 站教程视频，从安装到插件生态，梳理一条可落地的上手路径。

为什么值得关注 DeepSeek Harness

据 B 站 UP 主在教程中的观察，DeepSeek^广告 模型本身性价比高，但此前缺少桌面客户端。Harness 客户端推出后，配合插件可显著扩展能力边界。它的核心差异点在于：不是只让 AI 陪你聊天，而是让 AI 真正拥有执行任务的能力——写代码、处理文件、调用工具、自动化办公，甚至搭建属于自己的 AI Agent 工作流。

更关键的是插件化架构。这意味着扩展性和可定制性很强，你可以按自己的需求打造一个真正属于自己的 AI 助手。

第一步：安装 NodeJS 环境

安装分两步：先装 NodeJS 环境，再装 Harness 客户端。很多 AI 工具都基于 NodeJS，包括装 CloudCodex 这类工具也需要先有 NodeJS。

操作要点：去 NodeJS 官网下载，网站会根据系统自动适配。版本上，UP 主建议选择 22 以上的版本，不要选 22 以下。下载可选 ZIP 或 MSI，MSI 可直接点击安装，ZIP 需要解压。安装时把路径改到 D 盘，避免占用 C 盘空间，也防止缓存文件把 C 盘占满。

装完后要验证：打开命令行（找不到就输入 CMD），输入 node -v（注意 node 与 -v 之间有空格），出现版本号且版本不低于要求，就说明环境装好了。

NodeJS 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它让 JavaScript 能够脱离浏览器在操作系统上直接运行。许多现代 AI 工具、CLI 客户端以及插件系统都依赖 NodeJS 作为底层运行环境，因此它常被当作安装这类工具的前置条件。文中提到的 CloudCodex 等工具同样需要先配置 NodeJS。版本号方面，偶数版本（如 22）属于长期支持版（LTS），稳定性更好，奇数版本则更适合尝鲜。安装时选择 MSI 可自动完成环境变量配置，ZIP 包则需要手动设置，对新手而言 MSI 更省事。

第二步：安装 Harness 客户端

点击链接进入下载页，选择对应系统的客户端文件。UP 主以 Windows 为例下载安装包，右键打开，安装位置同样建议放到 D 盘，点击立即安装，完成后点击完成，就能打开 DeepSeek Harness 界面。

界面和网页端聊天窗口相似，但有一个关键不同：可以添加本地文件夹。添加后，它能读取、修改、保存该文件夹的内容——这是线上网页端做不到的。界面里还能选择 DeepSeek 的几款模型。

文中提到的“添加本地文件夹”能力，背后是客户端被授予了本地文件系统的读写权限。网页端聊天窗口运行在浏览器的沙箱环境中，出于安全限制无法直接访问用户磁盘上的文件；而桌面客户端作为原生应用，可以在用户授权后读取、修改并保存指定文件夹内的内容。使用时应只添加确实需要 AI 操作的项目文件夹，避免把包含敏感信息的目录整体暴露给模型，同时在 AI 修改文件后留意变更记录，必要时借助版本控制工具回滚。

插件才是能力放大器

Harness 基于 Codex 的插件架构，真正强大的地方在于插件集成。UP 主在教程中列出三种安装方式：

方式一：让 AI 自己装

知道插件名称后，直接在聊天窗口把 GitHub 链接发给它，让它自己安装。这种方式会消耗 Token 和积分。

Token 是大型语言模型处理文本的基本计量单位，模型按输入和输出的 Token 数量计费，因此“让 AI 自己装插件”这种方式会消耗较多 Token 和积分——AI 需要读取插件仓库说明、理解安装步骤并执行命令，整个过程产生的上下文都可能计入消耗。相比之下，插件市场安装只是下载并启用已打包好的插件，不经过模型推理，所以免积分。理解这一区别有助于根据插件复杂度选择更经济的安装方式。

方式二：插件市场安装（免积分）

在插件页点击添加插件，输入插件名称（例如 DSH Market），点击安装，检测到后点击立即启动，就能逛插件市场。市场入口在“更多”下的“设置”里，可以搜索、筛选，里面可能有成千上万个插件，还有推荐和介绍，比如小金鱼挂件、桌面宠物，点一下就能装上。

方式三：命令行安装

适合有一定基础的用户。以“全网最强的 DeepSeek Harness 外挂视觉插件”为例：原生 DeepSeek 无法读取本地图片、不能识别图片内容，装上该插件后就能识别图片里的人物、穿着等信息。安装方法是在插件 GitHub 页面找到 option one installation 段落，复制代码到命令行执行，等待安装完成。UP 主也提到，这种方式对部分同学来说比较抽象，不如前两种方便。

命令行安装通常指在终端中执行插件仓库提供的安装脚本或包管理命令。原文提到的“option one installation”段落，一般位于 GitHub 项目 README 的安装说明中，作者会按推荐顺序列出多种安装方式。执行这类命令前应确认代码来源可信，避免运行来源不明的脚本；复制命令时注意不要遗漏参数或换行。安装完成后通常需要重启客户端或在插件页确认插件已加载，部分插件还要求额外配置 API Key 或模型权限才能生效。

教程中提到的应用想象空间

UP 主列举了几个演示方向：让 Harness 去 B 站阅读内容，把内容读出后接入知识库做知识库管理；生成视频；做知识目录整理；“养鱼”；甚至接到聊天软件里跟别人对话。这些场景说明，插件组合后能力边界会大幅扩展。

上手建议

如果你只想认真学一个 AI Agent 工具，Harness 值得列入清单。路径很清晰：先装 NodeJS（22 以上、装 D 盘、用 node -v 验证），再装 Harness 客户端（选对系统、装 D 盘），然后从插件市场挑插件，遇到不会的就把 GitHub 链接丢给 AI 让它装。后续 UP 主还计划讲解常用插件的安装方法与业务用途。

本文内容整理自 B 站教程视频，具体下载链接、界面与插件名称请以官方最新信息为准。