ARTICLE · 1158605
DeepSeek Harness 插件生态与免费上手指南
如果你觉得 Claude Code 太贵、Cursor 太封闭,那 DeepSeek 8 月开源的 DeepSeek Harness(DSH)值得一试。它的口号很激进——一切皆插件:模型、工具、存储、上下文、循环,全部可替换。上线不到三个月,插件注册表已收录 3000+ 插件、GitHub 星标 53 万+。
关键是本体完全免费开源,一行命令就能跑起来。这篇把是什么、怎么装、插件怎么挑、费用怎么算一次讲透。
⏱️ 30 秒速览
npx @deepseek-ai/dsh web | |
① DSH 是什么:Agent = 模型 + 外壳
DeepSeek Harness(DSH)是 DeepSeek 今年 8 月 13 日发布的开源 Agent 运行时,v0.1 开发者预览版,MIT 协议,代码全开。Harness 原义"马具",在 Agent 语境里指模型之外的那一整套工程外壳——让模型能读文件、调工具、管上下文、失败重试、连续干活。
DeepSeek 官方把它概括成一个公式:Agent = Model + Harness。模型负责判断力,外壳负责给判断力提供一切可作用的东西:看什么、调什么工具、会话写到哪、循环何时停。DSH 做的事,就是把"第二半"变成可编辑的。
底层是 Cordis 内核——服务注册、依赖注入、可逆副作用,外壳上每一层(上下文、工具、会话、沙箱、循环)都是一个插件,可以单独替换而不影响上下层。这正是"一切皆插件"的技术底气。
📌 划重点:Claude Code 商业跑通后,Harness 这一层成了所有模型公司的必争之地。DeepSeek 挖来前 Jane Street 工程师组建团队,交出的答卷不是"自己的 Claude Code",而是一个把外壳本身开放出来的运行时。36 氪的评价是:它在用《我的世界》的方式干掉 Claude Code。
② 四种模式与 Trajectory 黑匣子
同一个内核,按需要的外壳面积启动成四种形态:
🟦 标准模式:全套编程 Agent——文件编辑、Shell、文件/网页搜索、技能、规划、目标管理、子 Agent、工作流。日常主力。🟧 PTC 模式(Code as Tool Calls):工具通过 Code Mode SDK 暴露,模型直接写一段 TypeScript 程序,把本来要一来一回调十次的工具操作合并成一次执行。省 token、省时间。⬜ 极简模式:只留一个持久 Bash 和一个文件编辑器,官方定位是给模型做基准测试——拆掉外壳花活,看裸实力。🟪 创造模式:用来造新模式,运行时服务逐个可见,边跑边调。
另一个被低估的设计是 Trajectory(轨迹):模型看到的一切——系统提示词、推理过程、工具调用和结果、子 Agent 调度、每次上下文注入——全部记录在一份只增不改的会话日志里。恢复、分叉、搜索、回放都在同一条事件流上操作。相当于每次运行自带黑匣子,出了问题可以完整复盘它看到了什么、为什么这么做。
📌 划重点:PTC 模式是 DSH 最差异化的能力——别的 Agent 是"一次选一个工具",它是"一个回合写一段程序"。多步操作合并执行,token 消耗和延迟都大幅下降。复杂工作流场景建议优先切 PTC。
③ 免费上手:三条命令跑起来
安装门槛极低,Node 18+ 是唯一前置条件:
# 1. 启动 Web UI(本地 127.0.0.1:3080) npx @deepseek-ai/dsh web # 2. 添加插件(插件即 npm 包) npx @deepseek-ai/dsh plugin add <package-name> # 3. 查看已装插件 npx @deepseek-ai/dsh plugin list
不想碰终端的话,装 dsh-desktop(星标 3 万+),双击即用的桌面客户端。写代码的话,VS Code / JetBrains 都有社区集成插件(dsh-vsc-integration / dsh-intellij-integration):原生 diff 审阅、工具审批卡、持久会话恢复、Token 用量面板一应俱全。
🔑 配模型:启动后在设置里填 DeepSeek API Key 即可;也可以接任何 OpenAI 兼容的模型服务——这是"模型可替换"的直接好处,硅基流动等平台上的免费模型都能接进来。
📌 划重点:DSH 本体完全免费,真正花钱的只有模型调用。DeepSeek API 本身就是业内低价档;再把免费模型接进来当主力,整套方案可以做到接近零成本。
④ 插件怎么挑:从官方到社区五件套
插件生态入口是 GitHub 的 dsh-plugin 话题,注册表已索引 2981 个插件。热门插件一览:
社区还有一套实用的五件套(useful-dsh-plugins):语音输入(本机 SenseVoiceSmall 离线识别)、上传按钮(文件附件)、图像读取(视觉模型桥接)、文档伴侣(PDF/DOCX 边读边问)、插件管理器。一条命令整套安装:
npx --yes useful-dsh-plugins@0.5.1 setup
📌 划重点:挑插件先看三样——Star 数、是否通过 L5 运行测试、维护是否活跃。目录站(dsh.so)对每个插件做了安全扫描和沙箱安装验证,装机前先查一眼,别随手 npm 包就往里塞。
⑤ 费用账本:哪些免费、哪些花钱
把账拆开算:
🆓 免费部分:DSH 本体(MIT 开源)、全部社区插件、Web UI / 桌面版 / IDE 集成、Trajectory 会话存储(本地)。💰 花钱部分:模型 API 调用费。DeepSeek API 按量计费,本来就是业内低价档;日常轻度使用一个月也就几块到几十块。🎯 零成本方案:把 OpenAI 兼容的免费模型(如硅基流动平台免费档、阶跃 Step 5 免费周模型)接进 DSH 当主力,DeepSeek 只在需要强推理时顶上——这是"模型可替换"架构的最大红利。
对比参考:Claude Code 需要付费订阅或 API 计费,模型锁定 Anthropic;DSH 本体零门槛,模型随你换。省的不只是订阅费,更是"不被单一供应商锁定"的自由。
📌 划重点:DSH 仍是开发者预览版,破坏性变更频繁,插件 API 是重灾区——升级本体后记得核对插件兼容性(社区 awesome-dsh-plugins 仓库有每日兼容性追踪)。生产环境谨慎,折腾和学习环境随便玩。
⑥ 选型意义与上手建议
🏁 谁能用:有 Node 环境的开发者;想要本地化、可追溯 Agent 的团队;被订阅费劝退的个人;想研究 Agent 架构的学习者(Trajectory 黑匣子本身就是绝佳教材)。
⚖️ 怎么选:要开箱即用、生态成熟 → Claude Code / Cursor;要免费、开放、可魔改、能换模型 → DSH。两者不冲突——很多开发者的做法是 DSH 当实验田和备用生产力,付费工具当主力。
📖 上手路径建议:第一天 npx 启动 Web UI + 标准模式跑通一个真实小任务 → 第二天装五件套 + 试 PTC 模式跑多步工作流 → 第三天挑 2-3 个热门插件(记忆/视觉/多 Agent)组合出自己的工作台。
📌 划重点:判断一个 Agent 工具的长期价值,看三点——外壳是否开放、模型是否可换、数据是否可控。DSH 三项全占,这就是它发布不到三个月能长出 3000 插件生态的根本原因。
第一句:DeepSeek Harness(DSH)是 DeepSeek 开源的 Agent 运行时,MIT 协议,"一切皆插件"——模型、工具、存储、上下文、循环全部可替换,Agent = Model + Harness。
第二句:一行命令上手:npx @deepseek-ai/dsh web(Node 18+,无需账号);四种模式(标准/PTC/极简/创造)+ Trajectory 黑匣子;插件注册表已有 3000+ 插件,open-design、dsh-memory-plugin、dsh-agent-teams 等热门插件星标数万。
第三句:本体和插件全免费,模型费自付——接 DeepSeek API 是低价档,接免费模型可近乎零成本;注意仍是开发者预览版,升级后要核对插件兼容性,生产环境谨慎、学习环境放开玩。
本文信息来源(手机电脑均可打开):
· DSH 官网:dshai.org(快速开始/插件目录/架构说明)· GitHub:github.com/deepseek-ai/deepseek-harness(MIT 源码)· 插件注册表:dsh.so(安全扫描与兼容性验证数据)· 36氪《玩了一夜 DeepSeek Harness》2026.08 报道· VS Code Marketplace:dsh-vsc-integration 页面
📋 版权声明:本文为 AI 技术学习笔记,信息整理自 DeepSeek 官方文档、插件注册表及公开报道,版权归原作者及原发布平台所有。DSH 处于快速迭代阶段,功能与数据以官方最新文档为准,本文仅作技术交流用途。