DeepSeek Harness 保姆级教程 · 笔记

AI AGENT 入门 · 保姆级

DeepSeek Harness
保姆级教程

先搞懂 Harness 是什么，再手把手安装、玩转四大模式，最后进阶到最有意思的插件玩法。没有编程基础，也能定制一个专属于自己的 Agent。

三种安装方式四大模式插件 DIY 实战案例

先搞懂：Harness 到底是什么

AI Agent = 大模型 + Harness

大模型负责思考和生成结果，相当于一匹跑得很快的野马，但有时候很容易放飞自我。

这时候就需要装上 Harness——包括工具、Skill、操作权限、记忆系统等等，相当于缰绳和马鞭这一整套驾驭工具，把野马驯服成在真实任务中不会跑偏的 AI Agent。

简单来说，Harness 就是帮你驾驭大模型的一整套系统。

为什么 Harness 会火

因为大家发现：同样的大模型，装上不同的 Harness，干活的能力差距非常大。

第 30 名

优化前的编码能力排名

→

第 5 名

优化 Harness 之后

有团队做过实验：同一个大模型，优化 Harness 之后，Agent 的编码能力从第 30 名提升到了第 5 名。

它和其他 Agent 产品有什么不一样

其他 Agent 产品

相当于骑一匹平台帮你训练好的马：怎么跑、怎么停，基本都帮你设定好了，下一条命令就能按设计好的路线自动跑完任务。

DeepSeek Harness

不仅给你一匹训练好的马，还把「跑马场」也开放给你了。你可以训练自己的马，也就是定制属于自己的 AI Agent。

三种安装方式

命令行工具安装

先装一个环境 Node.js，选择自己电脑的版本（mac 或 Windows），一路下一步安装即可。然后打开命令行：mac 按 Command + 空格输入「终端」；Windows 按 Win + R 输入 cmd。小白别担心，就是这个黑色的界面，输入命令后会得到一个地址，复制到浏览器打开就行。
让已有的 Agent 帮你装

只要电脑上有任意 Agent 工具（Codex、Claude Code、WorkBuddy 等）都行。在对话框里把仓库地址发给 AI，让它帮我们安装并启动，同样会拿到一个地址，在浏览器打开即可。
下载桌面客户端

装好之后开箱即用，什么环境配置都不用管。

不管用哪种方法，安装进来之后都会有一个弹窗让你填 API Key：只需要在开放平台创建一个，再填回去就完成了，很简单的。

进入界面，先做四件事

选文件夹：先选择一个本地文件夹，后续操作都在这个文件夹里面。
设权限：共有三种等级——只允许读取、可修改写入、完全访问，一般选择「可修改写入」就好。
切模型：在这里可以切换模型，以及推理等级的高低。
选模式：最后在这里切换模式，目前开放了四种。

四大模式怎么选

标准模式

一般日常工作就可以用这个模式，跟其他 Agent 产品差不多。

批量模式

标准模式的增强版，适合批量的、多步骤的标准化任务，例如批量分析文件数据。

极速模式

马甲最轻，接近裸跑模型，适合开发者测试模型能力，普通用户一般用不上。

创造模式

最特别的一种。可以 DIY 自己的 Agent，像搭积木一样自由拼接不同的插件能力。

核心设计：一切皆插件

官方把它的插件化架构建成了一句话：Everything is a plugin——一切皆插件。模型、工具、绘画记录，甚至 Agent Group，都被放进同一套插件体系。

一个内核

让插件装得上、卸得下，还能互相配合地运行。

两种组合能力

时间可撤销性，加上空间可组合性。

案例：让小票自动记账

需求：给它一张小票的照片，它要能看懂里面的金额、时间和商家，最后帮我记到总账本里。

先找现成能力

这个功能要用到视觉识别能力，但 DeepSeek base pro 是纯文本模型，于是它去 GitHub 上的社区插件里找有没有现成的。
比较后择优安装

在插件社区里找到了四个现成的视觉识别插件，比较各自的优劣势后，推荐安装 vision Router 插件。
没有的就自己写

记账功能没有现成的，Agent 就给自己写了一套记账插件，规定金额、时间、商家和分类应该怎样提取和保存。
实测跑通

上传两张截图，很快就识别出来了。这些插件能一块块接进同一个 Agent，靠的就是 Harness 对整套插件系统的管理。

缺看图能力，就接一个视觉插件；缺记账能力，就补一个记账插件。

两种可组合性，一次讲清

时间可撤销性

我想在记账本上再加一个「每月预算提醒」，每次记完账顺便看看这个月花了多少，快用完时提醒我，比如把每月餐饮预算设为 300 元。哪天不需要这个提醒了，就把预算插件卸载——预算提醒没了，原来的记账功能和账本数据都还在。

一个插件卸载之后，它之前产生的影响能否被撤销，让项目恢复到加载前的状态，这就是时间可撤销性。

空间可组合性

哪天我又想把预算提醒变成一个可以随时开关的附加功能：需要就挂上，不需要就关闭，其他功能照常工作。但预算插件要正常工作，还得依赖记账插件提供的「月度支出统计」。

如果记账插件正在升级、这个统计能力暂时消失，Harness 就会先暂停预算插件；等它重新出现之后，再让预算插件恢复工作。当一个插件依赖的能力发生变化，系统会自动重新处理它们之间的依赖关系，这就是空间可组合性。

顺带一提：过程可回看

绘画记录就像一份实践日志：用户发了什么、模型返回了什么、工具调用和执行结果全都能看得见。对开发者来说很有用，出 bug 时沿着轨迹往回翻，很快就能找到是哪一步出了问题。

实战一：用别人的插件换肤

开源 Agent 产品最大的优势，就是有丰富的开源插件。比如 dream skin 换肤插件，让人很心动：把项目直接发给 AI，说「帮我安装好」就行。

装好之后在设置里就能看到预设的皮肤界面，可以切换主题、预览效果，还支持上传图片作为背景。如果没有喜欢的皮肤，还可以让 AI 基于这个插件自己做一套新的，比如做一套海贼王主题的皮肤。

这就是用好别人现成插件的完整流程。

实战二：一键生成课程工作台

插件从哪找？推荐去专门的插件仓库，里面收集了很多开发者做的插件，比如统计账户余额的、帮忙润色提示词的。

像「一键生成课程工作台」插件，安装好之后只要说一句「帮我做一节关于光的折射的物理课」，它就会生成一个带 PPT 课件、课程旁白、交互设计（拖动滑块可以非常直观地看到效果）以及随堂测验和 AI 解析的页面。

基本上大部分需求，都能在开源社群里找到对应的插件。

实战三：手搓第一个插件

如果开源社群里没有自己想要的插件也没关系，自己做一个就行，不懂代码的小白也很容易上手——官方开源了一整套插件开发指南，只要说清楚需求，Harness 就会照着开发指南帮你做出来。

明确需求

比如我有生图的需求，但 DeepSeek 是文本模型，没办法生图，这时可以通过接入 API 的形式，把其他有生图能力的模型接进来。
让 AI 手搓插件

社区里没找到现成方案，就让它做一个可以调用 Image 2 和 Nano Banana 的插件。
填 Key 做测试

插件里的服务商可以切换成谷歌或 OpenAI，去官网申请一个 API Key 填进来，点击测试链接，没问题就能生图了。
实际验证

新建一个绘画窗口，让它生成一张 16:9 的中国新城图片，出来的效果确实厉害。这个生图插件也可以直接拿来就用，下载后发给 AI 让它自己安装即可。

写在最后

Harness 的实际哲学，决定了它不会像其他 Agent 产品那样开箱即用。但只要你掌握了两个能力——怎么装别人的插件、怎么自己做插件——它的上限就会很高。

测评下来的使用体验，跟成熟的 Agent 产品还有差距。但它最有价值的地方，并不是开源了一个现成的 Agent 产品，而是创造了一个让所有用户都能低门槛开发 Agent 的平台。

如果未来社区能长出大量好用的插件和工作流，那 Agent 的上限就不再完全依赖少数公司的能力，而是取决于整个开源社区的创造力。

行动建议

先装 Node.js 走命令行，或直接下载桌面客户端，把 Harness 跑起来。
在开放平台创建 API Key，填进安装后的弹窗；选定一个本地文件夹，权限用「可修改写入」。
日常任务用标准模式，批量多步骤任务切批量模式，想玩定制就进创造模式。
先去社区插件仓库找现成的，找不到再照着开发指南自己做一个。