为什么突然聊它
2026 年初,DeepSeek 官方开源了一个名为 DeepSeek Harness(简称 DSH)的 AI Agent 运行时,口号是 "Everything is a Plugin"(万物皆插件)。发布当天社区就炸了——GitHub 仓库上线数小时就收获了数万 Star,各种插件、教程、评测文章像雨后春笋一样冒出来。
作为一个天天跟 AI 工具打交道的开发者,我第一时间就装来体验,断断续续用了几个月。这篇文章不打算堆参数,而是从一个真实用户的角度聊聊:它到底是什么、怎么装、用起来什么感觉、适合谁来用。
什么是 DeepSeek Harness
一句话概括:它是让大模型真正"干活"的外壳(运行时),而不是模型本身。
大模型本身只会"说话"——你问它问题,它给你答案。但一个合格的 AI Agent 需要读文件、写代码、执行命令、搜索网页、调用各种工具,并且要能在一连串任务里自己决定下一步做什么。这些能力需要一个框架来编排,DeepSeek Harness 干的就是这件事:把模型、工具、技能、权限管理、任务调度整合成一个开箱即用的运行时,并配了一个 Web 图形界面。
打个比方:模型是大脑,Harness 是手、脚和工具箱。大脑负责想,Harness 负责把想法变成现实。
它和普通聊天机器人最大的区别在于:你可以让它在真实环境里操作——比如"帮我重构这个项目的登录模块"、"把这份 CSV 转成 JSON 并按日期分组",它会真的去读你的文件、改你的代码、跑测试给你看。
它和 Claude Code、Cursor 有什么区别
很多人第一次听说 DSH,会拿它和已经很流行的 Claude Code、Cursor 比。其实它们的定位并不完全一样:
| 维度 | DeepSeek Harness | Claude Code | Cursor |
|---|---|---|---|
| 定位 | 通用 Agent 运行时 | 终端 AI 编程助手 | AI 集成编辑器 |
| 界面 | 本地 Web GUI | 命令行 | IDE 界面 |
| 扩展方式 | 插件(工具/技能/MCP) | MCP 为主 | 插件市场 / 规则 |
| 是否开源 | 开源 | 闭源 | 闭源 |
简单说:Claude Code 和 Cursor 更聚焦"帮你写代码",而 DSH 更像一个能让你自己搭 Agent 流水线的开放平台——写代码只是它的众多用法之一。如果你要的是一个开箱即用的编程助手,前两者都行;如果你想掌控底层、按自己的需求拼装能力,DSH 的价值就出来了。
万物皆插件:核心设计
DSH 最有辨识度的设计就是插件化架构。官方把 Agent 所需的能力全部抽象成可插拔的组件,核心概念大致分四类:
| 类型 | 作用 | 典型例子 |
|---|---|---|
| 工具(Tools) | 让 Agent 获得具体执行能力 | 文件读写、代码搜索、网页搜索、命令执行 |
| 技能(Skills) | 把常用流程固化成可复用能力 | 代码审查、文档生成、发布检查 |
| MCP 服务器 | 接入外部系统与数据源 | 数据库、飞书、浏览器控制 |
| 配置层 | 定制运行时行为 | 模型参数、权限策略、补丁(Profile) |
这套设计的好处很直接:需要什么就装什么,不用的东西不加载,运行时保持轻量;同时任何人都可以按官方规范写自己的插件,社区生态因此长得飞快。现在网上已经有不少 awesome-deepseek-harness 之类的汇总仓库,插件、技能、MCP 服务器一应俱全。
快速开始
安装非常简单,npm 全局装一下就行(具体以官方文档为准):
# 全局安装
npm install -g @deepseek-ai/dsh
# 或者不想全局装,直接用 npx 也行
npx @deepseek-ai/dsh
启动之后,浏览器打开本地 Web 界面(我这边默认是 http://127.0.0.1:3080),配置好模型就能开始用了。模型来源很灵活:
- DeepSeek 官方 API:开箱即用,配置 API Key 即可;
- 兼容 OpenAI 接口的服务:很多第三方模型服务都能直接接上;
- 本地模型:想完全离线的话,也可以接本地部署的模型(对机器要求高一些)。
整个过程大概五分钟,不需要写代码,也不需要理解内部实现——这也是它和那些"给开发者用的 SDK"最大的不同:普通用户装上就能用,开发者还能继续往深处折腾。
第一手使用体验
下面这些是我几个月用下来印象最深的点,按"惊喜程度"排序。
1. 看得见的工具调用
Agent 的每一步动作都是透明的:调用了哪个工具、传了什么参数、拿到了什么结果,界面上清清楚楚。以前用别的工具,AI 改坏了代码你都不知道它改了什么;在 DSH 里,每处改动都有迹可循,出问题能立刻定位。这种"可审计"的感觉对开发者来说太重要了。
2. 沙箱与权限审批
文件操作默认运行在沙箱里,权限分了好几个层级(只读、工作区写入、完全访问)。涉及写文件、执行敏感操作时会弹出审批请求,你点了同意它才动手。我在本地项目里试过让它直接改代码,每一步都先问过我。安全感拉满的同时也意味着:你要理解自己开的权限意味着什么(后面注意事项里细说)。
3. Plan 模式:先计划,后动手
遇到重构、迁移这类大改动,可以先让 Agent 进入 Plan 模式,它会输出一份完整的执行计划,你确认没问题再让它动手。这比我用过的很多 AI 工具"上来就改"的粗暴风格靠谱得多,尤其适合代码库比较大的时候。
4. Goal 机制:长任务的"自动驾驶"
这是我最喜欢的功能之一。你可以给它一个长期目标(比如"调研三款竞品的定价策略并输出对比报告"),它会拆成多轮任务自动推进,每轮自己决定下一步干什么,直到完成或遇到真正的阻塞。对,它甚至会自己判断"这个信息查不到,换个思路"。虽然偶尔也会跑偏,但大方向基本靠谱。
5. 子代理:并行分工
一个主任务可以派生出多个子代理并行工作,各自独立研究一块,最后汇总到主任务里。我现在写技术调研类文章经常这么干:三个子代理分别查资料、整理对比、列提纲,我再统一整合。效率至少翻一倍。
6. 工作流(Workflow):批量编排
如果说子代理是"小分队",工作流就是"工业化流水线":用一段脚本描述任务,框架会自动把工作扇出给大量 Agent 并行执行,再收集结果。适合审计、迁移、批量改写这类"量大且相互独立"的活。这功能目前对新手门槛略高,但会了之后是真香。
7. 后台任务
耗时的任务可以挂到后台跑,期间你该干嘛干嘛,完成后再回来收结果。不用一直盯着进度条,体验很舒服。
8. 技能(Skill):把经验固化成能力
你常用的操作流程可以固化成"技能",下次一句话就能触发。比如我把"代码提交前检查"(跑 lint、检查敏感信息、生成提交信息)做成一个技能,现在每次提交都让它过一遍,省心很多。
真实案例:这篇文章是怎么写出来的
说个有点"套娃"的事:这篇文章本身就有 DSH 的参与。我的流程大致是:
- 让一个子代理去搜集 DeepSeek Harness 的官方资料和社区评测,整理成事实清单;
- 我基于清单搭好文章骨架,明确"哪些必须准确、哪些是个人感受";
- 让另一个子代理按骨架生成初稿,把含糊的地方标出来;
- 我自己逐段审校,核实事实、润色语气——最终定稿还是我自己来。
心得:AI 负责"广"(快速搜集、生成初稿),人负责"准"(判断、取舍、最终把关)。工具是杠杆,方向感还是自己的。
生态与社区
作为一个刚发布几个月的项目,DSH 的社区生态已经相当热闹:
- 官方仓库 deepseek-ai/DeepSeek-Harness:源码、文档、插件开发规范都在这里;
- 官方产品页:对"开发者预览版"定位和功能做了完整介绍;
- awesome-deepseek-harness:社区维护的资源汇总,插件、技能、MCP、教程都有;
- 第三方生态:桌面客户端、PPT 生成、飞书接入、可视化插件等,很多已经能直接装来用。
中文资料尤其丰富,上手遇到问题基本都能搜到答案。
想自己写插件?给个入门思路
插件化是 DSH 的灵魂,自己动手扩展其实没有想象中难。入门可以分三步走:
- 先会用别人的:从 awesome 列表里挑一两个感兴趣的插件装上,观察它怎么接入、提供了什么能力;
- 读官方插件规范:官方仓库里有说明和最小示例,跟着抄一遍就能跑通一个最简插件;
- 从"抄 + 改"开始:把一个社区插件 fork 下来,改成自己需要的功能,比从零写快得多。
大体上,插件分为几类:给 Agent 增加执行能力的工具插件、把常用流程固化的技能插件、以及接入外部系统的MCP 服务器。你缺什么能力,就补什么插件——这正是"万物皆插件"最迷人的地方。
一些注意事项
夸了这么多,也得说点实话。几个使用中需要注意的点:
- 还是开发者预览版。当前处于 0.1.0-rc 阶段,API 和界面都可能变动,别把它当生产环境的稳定依赖。
- 成本要自己算。接云端 API 的话,长任务消耗的 token 不少,跑之前先估一下量级;用本地模型则要一台还不错的机器。
- 权限别乱开。沙箱权限分级的初衷是保护你,但对重要文件开"完全访问"之前,想清楚后果。我一般只在临时目录或测试项目里放权。
- 长任务要盯。Goal 机制虽然能自动驾驶,但 Agent 也会跑偏、也会在错误方向上花很久。隔一段时间看一眼进度,是长期使用者的基本素养。
- 敏感数据要小心。接云端模型时,上下文会发送给模型服务商,别把密钥、生产库数据直接丢进去。
常见问题
问:DSH 和 DeepSeek 的模型是一回事吗?
不是。DSH 是"运行时",模型是"大脑",两者解耦。你可以在 DSH 里接 DeepSeek 官方模型,也可以接其它兼容 OpenAI 接口的服务或本地模型。
问:不会编程能用吗?
基础使用不需要会编程,装上、配好模型、用自然语言下指令就行。只有想自己写插件、做深度编排时,才需要一定的开发能力。
问:免费吗?
DSH 本身开源免费;但调用云端模型要按 token 计费,用本地模型则主要吃自己机器的算力。
问:适合新手吗?
上手门槛不高,但用好需要理解"权限""编排""子代理"这几个概念。建议先从单个工具、简单任务开始,再逐步尝试 Goal 和工作流。
总结
DeepSeek Harness 把"模型 + 工具 + 权限 + 编排"揉成了一个开箱即用的 Agent 运行时,插件化设计给了它很强的扩展性,Web 界面又拉低了上手门槛。它既适合想用 AI 干活的普通用户,也适合想自己搭 Agent 流水线的开发者。
如果你已经在用 Claude Code、Cursor 这类 AI 编程工具,或者一直想试试"让 AI 真的动手干活"是什么感觉,DSH 值得花一个下午折腾一下。毕竟——万物皆插件的思路,让每个开发者都能长出自己想要的那双手。
最后:这篇文章提到的功能细节均来自我个人的使用体验,具体以官方文档为准。如果文中有什么不对的地方,欢迎来信指正:contact@727306.xyz。