deepseek harness插件是深度求索 2026 年 8 月开源的智能体框架 DeepSeek Harness(命令行名 dsh)的插件体系,MIT 协议、TypeScript 编写,主打一切皆插件:模型、工具、技能、会话、存储全都是可插拔的部件。它不是聊天网站,而是跑在你自己电脑上的框架,装好后浏览器里用。下面把它是什么、怎么装、模型怎么接、插件怎么管一次讲清。 deepseek harness插件是什么
先把名字拆开。DeepSeek Harness 是深度求索在 GitHub 上开源的一个智能体框架,仓库挂在官方组织名下,2026 年 8 月 13 日创建,MIT 协议,代码以 TypeScript 写成,主仓库星标已超二十三万。官方仓库首页给自己的介绍只有一句话:DeepSeek Harness,Everything is a Plugin,也就是一切皆插件。
它和你在手机上聊天的 DeepSeek 网页版不是一回事。网页版是现成的产品,打开就能用;Harness 是一个框架,装在你本地,连上模型密钥后,智能体能读你电脑上的文件、跑命令、改代码、委派任务。社区和媒体介绍里流传一个公式:Agent 等于 Model 加 Harness,模型是大脑,Harness 是手脚,光有模型只能问答,加上这层框架才能动手干活。插件,就是给这双手加新手指的方式。
内核叫 Cordis,官方文档说所有主要部件都以插件形式挂在它上面。你不用关心内核细节,只要知道结果:框架里几乎每层能力都能单独替换、开关,这就是插件体系存在的意义。
一切皆插件怎么理解
按官方架构文档与仓库介绍,框架里的主要部件分成七类,每一类都是一个插件位:
| | |
|---|
| 把 DeepSeek 或别家模型接进来,决定智能体用哪个大脑 | |
| 文件读写、命令执行、搜索、MCP 工具这些可调用的动作 | |
| | |
| | |
| | |
| | |
| | |
换个读法也行:前两行决定能不能干活,中间几行决定好不好用,最后一行决定顺不顺手。所谓一切皆插件,就是这七个位置全都能换、能加、能关,而不是只有工具能扩展。
怎么安装,一条命令的事
安装分三步。第一步装 Node.js,这里是网上教程的重灾区:不少文章写要 Node 18 以上,那是旧口径。按官方仓库配置文件里的写明要求,版本必须是 22.19 以上,或者 24 以上,低了起不来。装完在终端输入版本查询命令,看到 22 或 24 开头就对了。
第二步在终端里跑一条命令:npx @deepseek-ai/dsh web。第一次运行会拉一堆依赖,屏幕刷得飞快是正常的,等它停下来。本地启动时它会自动打开默认浏览器,界面地址默认是本机的 3080 端口;不想自动开浏览器就在命令后面加一个参数 --no-open,地址会照常打印出来。
第三步记住一条铁律:那个终端窗口就是框架的本体,最小化可以,关了界面立刻打不开。想从源码跑也行,官方给的是克隆仓库、装依赖、构建、启动四步,用 pnpm 完成,适合想看代码或参与贡献的人。
模型怎么接,能不能用别家
框架本身不带模型,要自己在设置页里配。打开设置里的模型页,DeepSeek 卡片有一个密钥输入框,填入在开放平台申请的 API 密钥保存即可,模型路由立刻可用,不需要重启。密钥是只写的:保存后页面只见脱敏引用,明文存本机凭据文件,不进浏览器。
| | |
|---|
| | |
| | |
| | 提供方 ID 一旦建好永久不能改,想改名只能新建再删旧的 |
| | 只是便利手段,端点不配合就手动填模型 ID,效果一样 |
| | DeepSeek 官方路由自带四档;走网关的模型要手动声明 |
自定义提供方是接别家模型的正路。填小写的 ID、接口地址和协议就行,协议三选一:OpenAI 的对话接口、OpenAI 的响应式接口、或者 Anthropic 的消息接口,一个提供方只认一种协议,网关同时给两种就建两个。图片能力也是在这里配,官方适配器里默认支持图片输入的条目是 deepseek-flash,手动加的模型默认只有文本,要在模型选项里手动勾上图片。
插件从哪装,在哪管理
官方插件的获取方式写得很朴素:给你的插件仓库打上官方定的 dsh-plugin 话题标签,别人就能搜到。社区插件目前集中在几个方向:记忆、终端、可视化工具、搜索、浏览器控制和智能体扩展。装插件不需要去外面下文件,近期的版本已经把插件安装和管理搬进了 Web 界面,侧边栏里有插件管理入口,插件页里能直接配置已装插件,引导式安装一路点下去就行。
想接第三方记忆系统这类 MCP 服务,官方文档给了现成参考配置,用启动命令加一个补丁参数指定配置文件就能启用。文档里写明了边界:框架只负责拉起子进程、发现工具、把工具以特定前缀暴露给模型,下载服务、建库、管账号这些上游的事都归你自己。还有个安全细节:启动子进程前,框架会主动移除环境里名字像凭据的变量,避免密钥被连带传出去。
装好之后常见问题怎么排
官方文档的排错节列得很全,汇总成一张表:
| | |
|---|
| | |
| | |
| | |
| | |
| | 在配置里关掉开发者角色字段,输出上限字段改成旧写法 |
| | |
| | 在模型配置里把思考格式设成 DeepSeek 专用写法 |
| | |
分界线看出在哪一侧:模型侧的错几乎都能在设置页解决,网关侧的错要改配置文件里的兼容开关,本地启动侧的错十有八九是终端被关了。官方还说明,兼容开关写的是对端点的断言不是检查,设错不会拦你,只是请求发出去被对端拒绝。
先把丑话说完:官方在仓库首页用大写字母警告,这是开发者预览版,会有破坏性变更。npm 上的最新版是 0.1.5 的候选版本,2026 年 9 月 10 日发布,官方明确说它没经过安全审计、不建议当生产工具。版本迭代还带来一个实际影响:会话日志升到第三版格式后,旧版本框架读不了新格式的记录,降级前要想想会话还要不要。
和 Claude Code 的比较,媒体的定位是开源路线的对照面:那是一个闭源、以终端为主的成熟产品,按订阅或 API 计费;这个框架开源免费、自带 Web 界面、模型随便换,代价是成熟度和生态还早。和 OpenAI 的 Codex 比也是类似的格局。要今天就能稳定交付的编码助手,现成产品更稳;想吃透智能体框架的结构、或想自己写插件攒一套专属工作流,这个框架现在是最好的现场教材之一。 使用前的注意事项
- 未经安全审计:官方安全须知原文写明这是实验性软件,不要当成安全或可用于生产的工具。
- 它真的会动你的电脑:框架会执行模型生成的代码和命令,能访问网络、进程、凭据和文件,模型输出出错、配置失误都可能改坏或删掉文件。
- 第三方插件是双刃剑:装任何社区插件前先审一遍它做什么,恶意插件和错误配置的危害官方写得很直白。
- 沙箱不是保险箱:官方原话是沙箱和审批能降低风险但不保证隔离,别把它当成不可信任务的唯一防线。
- 最小权限跑:官方建议用最少必要的权限运行,最好放在一次性的虚拟机、容器或专用环境里,并给它能碰到的文件做好备份。
- 密钥留在本机:密钥只写设计意味着界面拿不到明文,但也意味着谁拿到你本机凭据文件谁就能用你的额度,机器别乱借。
- 别把会话当永久资产:预览期格式会变,重要产出及时导出,别指望历史会话永远能打开。
- 终端窗口别关:最高频的事故没有之一,界面打不开先回去看终端。
- 额度是另一笔账:框架免费不等于使用免费,模型调用照常按开放平台的 API 计费,跑批量任务前先算消耗。
Q:deepseek harness插件要花钱吗?
A:框架本身 MIT 协议完全免费,装和跑都不花钱;调用模型时按 DeepSeek 开放平台的 API 价格正常计费。
Q:它和 DeepSeek 网页版是什么关系?
A:两回事。网页版是现成聊天产品,这个是跑在本地的智能体框架;网页版 9 月把几个模式合并成智能模式,和这个框架互不影响。
Q:只能配 DeepSeek 的模型吗?
A:不是。模型本身也是插件,内置几家常见厂商的接入,也能加自定义端点接公司网关或自建服务;用第三方账号登录的那类暂时接不了。
Q:Node.js 版本到底要多少?
A:官方配置文件写的是 22.19 以上或 24 以上,网上教程里写 18 的都是过时说法,版本低了启动会失败。
Q:第一次跑完界面打不开怎么办?
A:九成是终端窗口被关了,那个窗口就是服务本体;重开终端重新跑一遍启动命令,等它打印出地址再开浏览器。
Q:装插件有风险吗?
A:有。官方安全须知把第三方插件和模型输出并列为风险源,装前审代码、给最小权限、重要文件先备份。
Q:会话记录存在哪,能不能接着上次的聊?
A:每次运行都会记一份只增不改的会话日志,系统提示、工具调用、结果全在里面,可以恢复、分叉和回放。
Q:和 Claude Code 比该选哪个?
A:要今天就能稳定干活,闭源的成熟产品更省心;想开源、想自己写插件、想随便换模型,这个框架值得装来玩。
Q:手机上能用吗?
A:它跑在电脑上,手机不是设计目标;官方倒是支持在远程连接的场景下打印出主机地址,配合转发工具在别处打开界面。
回到最初的问题,deepseek harness插件不是某个单一功能的开关,而是一整套让智能体框架可以自由拼装的设计:模型、工具、技能、会话、界面全是插件位,装什么、怎么配、用谁家的模型都由你定。它还在快速迭代的预览期,装之前按安全须知做好隔离和备份,想跟进它的插件生态和版本变化,可以关注本站的 AI 工具栏目,有新进展我们会同步。