DeepSeek Harness安装与实战教程:从零上手AI智能体

DeepSeek Harness 客户端基于 Codex 架构,扩展本地 AI 能力,教程详解安装与插件配置。
本文介绍了 DeepSeek Harness 客户端的安装与上手方法。该客户端基于 Codex 架构,支持读写本地文件夹,并通过插件机制大幅扩展能力,如让 AI 阅读 B 站内容、生成视频、接入聊天软件等。安装分为两步:首先安装 Node.js 环境,建议版本 22 以上并安装到 D 盘,装完后用 node -v 验证;其次安装 Harness 客户端,选择对应系统版本,安装位置同样建议 D 盘。插件安装有三种方式:聊天让 AI 自动安装(消耗积分)、通过插件市场安装(不消耗积分)、命令行安装(适合进阶用户)。文章还提醒了常见坑,如 Node.js 版本过低或装到 C 盘,并建议优先从市场安装插件以节省积分。
DeepSeek Harness 客户端推出后,把 DeepSeek 模型的性价比优势延伸到了本地桌面:它基于 Codex 架构,能读写本地文件夹、集成海量插件,把聊天窗口变成一个可执行自动化任务、多智能体协作的工作台。本文根据 B 站教程整理,从环境安装到插件配置,讲清从零上手的关键步骤。
为什么值得装 DeepSeek Harness
网页版 DeepSeek广告 只能对话,而 Harness 客户端补上了本地能力。据 B 站 UP 主在教程中的演示,它与网页端界面相似,但可以添加本地文件夹,直接读取、修改、保存文件——这是线上版本做不到的。模型选择也集中在客户端内,DeepSeek 几款模型都能看到。

真正拉开差距的是插件机制。Harness 沿用 Codex 的插件架构,装上优秀插件后能力边界大幅扩展:让 AI 去 B 站阅读内容、把内容读出来交给知识库管理、生成视频、整理知识目录,甚至接入聊天软件与他人对话。这些场景在教程中被逐一列举,说明客户端定位不是“另一个聊天框”,而是可组装的 AI 助手底座。
第一步:装好 Node.js 环境
安装分两大步,第一步是装 Node.js。很多 AI 工具(包括 Codex 一类工具)都基于 Node.js 环境,所以要先把它准备好。
教程给出的两个注意点很具体:版本最好选 22 以上,不要选 22 以下的版本;安装路径改到 D 盘,避免占用 C 盘空间、产生大量缓存文件把系统盘占满。下载时可选 ZIP 或 MSI,MSI 可直接点击安装,ZIP 需要解压。

装完后必须验证。打开命令行(找不到就输入 CMD),输入 node -v(node 与 -v 之间有空格),如果出现版本号且大约等于 20,说明环境已就绪。这一步别跳过,否则后面装客户端容易出问题。
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境,它让 JavaScript 可以脱离浏览器在本地计算机上运行。许多现代 AI 工具和命令行应用都依赖 Node.js 作为运行基础,因为其包管理器 npm 拥有全球最大的开源库生态,开发者可以快速集成各种功能模块。对于普通用户而言,安装 Node.js 相当于为后续软件准备好“运行环境”,没有它,基于 Node.js 开发的客户端就无法启动。教程中强调版本需在 22 以上,是因为新版本通常包含性能优化、安全补丁和对新特性的支持,而旧版本可能导致兼容性问题。安装路径改到 D 盘则是为了避免系统盘(通常是 C 盘)空间被缓存和依赖包占满,影响系统运行速度。
第二步:安装 Harness 客户端
环境就绪后,点击教程提供的链接进入下载页,页面会按系统给出对应文件。Windows 用户选 Windows 版本下载,右键打开安装包,安装位置同样建议放 D 盘,点“立即安装”,完成后界面自动打开。

装好后先熟悉两个区域:一是本地文件夹的添加入口,添加后 AI 就能读写该目录;二是模型选择区。其余功能可边用边学,重点先放在插件上,因为插件的丰富程度直接决定 Harness 能做什么。
三种插件安装方式,按需选择
教程把插件安装归纳为三条路径,各有适用场景。
方式一:让 AI 自己装。 知道插件名称和 GitHub 链接时,直接在聊天窗口把链接发给它,让它自己安装。这种方式最省事,但会消耗 Token 和积分。
方式二:通过插件市场安装。 在“添加插件”处输入市场名称(教程以 Markit 市场为例),点击安装,检测到后点“立即启动”,即可进入市场浏览。在“更多—设置”里能找到已装的市场,里面插件数量庞大,支持搜索和筛选,也有推荐位,点一下就能装上,不消耗积分。
方式三:命令行安装。 以教程中提到的“外挂视觉插件”为例,原生 DeepSeek 无法读取本地图片,装上该插件后就能识别图片中的人物、穿着等信息。安装方法是在插件页面找到 install 命令,复制后在命令行执行。这种方式对新手略显抽象,更推荐前两种。

如果不知道有哪些插件可用,可以直接问 DeepSeek,让它给出热门且实用的插件列表,再从中挑选。
插件市场(Plugin Marketplace)是一个集中展示、搜索和安装插件的平台,类似于手机上的应用商店。在 Harness 中,市场由第三方或官方维护,用户可以通过输入市场名称来添加,之后便能浏览其中收录的大量插件。市场通常提供分类、搜索、筛选和推荐位等功能,帮助用户快速找到所需插件。与让 AI 自动安装相比,从市场安装通常不消耗 Token 或积分,因为插件包直接由市场分发,无需模型生成安装指令。市场机制的存在降低了插件发现和安装的门槛,使得非技术用户也能轻松扩展客户端能力。教程中以 Markit 市场为例,说明添加市场后即可一键安装插件,这是最经济高效的方式。
命令行(Command Line)是一种通过输入文本指令来操作计算机的界面,常见于 Windows 的 CMD 或 PowerShell、macOS 的终端等。在插件安装场景中,命令行方式通常要求用户复制插件页面提供的 install 命令,粘贴到命令行中执行。这种方式之所以对新手抽象,是因为它涉及路径、权限、环境变量等概念,且执行后可能没有图形化反馈,需要用户自行判断是否成功。然而,命令行安装往往能实现更精细的控制,例如指定安装目录、选择版本或安装开发版插件。对于进阶用户,命令行也是排查安装问题的有效手段。教程建议新手优先使用前两种方式,待熟悉后再尝试命令行,以降低学习曲线。
常见坑与建议
- Node.js 版本低于 22、装到 C 盘,是最容易踩的两个坑,教程明确提醒避开。
- 装完 Node.js 务必用
node -v验证,版本号达标再继续。 - 插件优先从市场装,省积分;聊天安装适合已知 GitHub 链接的特定插件;命令行方式留给进阶用户。
教程作者表示,下节课将详解最常用插件的安装方法与业务价值。对想搭建个人 AI 工作流的读者,先把环境和客户端装稳,再逐步扩展插件,是更稳妥的路径。
相关推荐

OpenAI 11月30日关停Agent Builder等三项服务,开发者需紧急迁移
OpenAI 将于 11 月 30 日关停 Agent Builder、evals 仪表盘和可复用提示三项开发者功能,evals 已转为只读。本文梳理受影响范围、OpenAI 官方给出的迁移路径(Agent SDK、PromptFu、自有代码)以及开发者本周应完成的导出与重建动作。

RankSpot:按次付费的SEO与AI搜索执行层,让Agent替你写文、发布、换外链
RankSpot 是面向 AI Agent 的 SEO 与 AI 搜索执行层,通过 MCP 接入 Claude 或 ChatGPT,让 Agent 完成写文、发布和外链获取。按次付费,每篇文章 3 美元,读数据免费,支持 100 多种语言。

Appxiom:给AI编程助手装上生产环境上下文
Appxiom为AI编程Agent提供生产环境上下文,覆盖崩溃、卡顿、内存泄漏与失败的网络调用,支持Android、iOS、Flutter、KMP和Web,并通过Goal Friction Impact按业务目标排序Bug。