DeepSeek Harness 新手完整上手指南：安装、模式与插件推荐
- 免费干货
- 15热度
- 0评论
DeepSeek Harness 是什么？一句话：Agent 的插件化骨架
DeepSeek V4 正式版发布后不久，DeepSeek 推出了自家首个开源 Agent 框架，名字叫 DeepSeek Harness。截至 2026 年 10 月，它仍处于开发者预览阶段。
官网给了一个很关键的公式：Agent = Model + Harness。
说人话，大模型是脑子，负责思考和输出；Harness 是骨架和手脚，负责让模型在真实环境里把事办成。
先别搞混：Claude Code、Codex 不是 Harness
很多人以为 Claude Code、Codex 本质就是 Harness。这不对。
它们都是完整的成品 Agent，是面向用户的专属模型、自研执行框架、全链路产品化封装的完整体，开箱即用。
Harness 是一套能插件化运行的基础设施。像豆包、千问等产品，能力通常已经被平台封装好，用户直接就能用。但想针对某些内容加特定功能，就不行了。
DeepSeek Harness 走的是插件化路线。模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力，由多个可以安装、卸载和替换的插件组成。
你可以根据具体任务场景，自由选择、组装、替换组件，构建专属智能体。自由度完全交给用户。
三种安装方式，按难度从低到高
官网在这里：https://www.deepseek.com/harness/
方式一：客户端 DSH Desktop（我最推荐）
这是基于 DeepSeek Harness 构建的 Windows 和 macOS 开源桌面客户端，由第三方社区大神根据开源代码维护。
进入 DSH Desktop 网站，有两个下载按钮：“下载 Mac 版”和“下载 Windows 版”。按自己的电脑系统下载。
下载完成后安装，步骤按自己的选择来。安装完不用配置运行环境，这点很省心。
方式二：让其他 Agent 产品帮你安装
用豆包、千问等具备本地电脑执行能力的 AI 电脑端工具，把下面代码发给 AI，让它帮你安装并启动。
进度完成后会得到访问地址及状态，把地址复制到浏览器打开就行。
npx @deepseek-ai/dsh web
方式三：命令行安装（适合有基础的人）
- 先安装 Node.js 环境。官网下载安装包，选择适合自己电脑的版本，Mac 或 Windows，建议选 Node.js 22 及以上最新版，下一步安装即可。
- 打开命令行工具：Mac 按住 Command+空格，输入“终端”；Windows 按 Win+R，输入 cmd。
- 输入官方启动命令，运行后会得到访问地址，复制到浏览器打开。
npx @deepseek-ai/dsh webAPI Key 必须配，不配用不了模型
获取 API Key 的方法：
- 进入 DeepSeek 开放平台官网：https://platform.deepseek.com/；
- 注册账号后，在“API Keys”页面点击“创建 API Key”，复制生成的密钥；
- 回到 DSH，在设置、模型、设置提供方中，选择 DeepSeek，粘贴密钥保存。
注意：API Key 只会在创建时显示一次，记得保存。忘了或没保存，只能删除重建。
API 按模型档位+峰谷时段计费，输入输出分别计价，空闲时段价格约为高峰一半。
推理等级越高，效果越好，成本也越高。复杂多轮任务的消耗会明显高于普通对话。建议先小额充值试用，最好设个预算上限。
模型等级可以自由选。推理等级越高，回答质量越好，但速度会降，费用更高。新手前期用最低的练练手，熟练后再按需求调整。
四大运行模式：标准、PTC、极简、创造
第一次用的话，相信我，无脑选标准模式。
标准模式拥有完整的 Agent 能力，包括文件读取与编辑、Shell、文件搜索、网页搜索、Skills、计划、目标、后台任务、子 Agent 和工作流等。
PTC 可以理解为程序化工具调用。通过 TypeScript 程序组合多个工具调用，把多个操作放进一次执行流程里。
通俗说，Agent 要把 100 个文件里的旧接口名批量替换成新接口名，不用一步步反复对话，写一段脚本直接跑完全程。
PTC 对模型的规划和编程能力要求更高，也增加了调试难度。新用户建议先从标准模式开始。
极简模式只保留少量核心工具，例如持久终端和文件编辑器。它适合测试模型在最小工具环境中的编码能力，也可以用于模型对比和基准测试。但缺少搜索、计划和 Skills 等能力，不适合日常开发。
创造模式是 Harness 最具特色的功能之一。通过 Agent 检查当前运行环境并辅助创建插件，把新获取的能力加入工作流程。
比如可以创建：只允许读取代码的 Agent、接入企业内部知识库的 Agent、自动生成测试用例的 Agent、对接内部系统的 Agent。这意味着 Harness 给了用户极大的权力，让你搭建属于自己的 Agent。
| 运行模式 | 核心特性 | 适用场景 |
|---|---|---|
| 标准模式 | 集成文件编辑、Shell、网页搜索、Skills、任务调度等完整能力 | 日常开发与通用任务，绝大多数用户首选 |
| PTC 模式 | 通过 TypeScript 程序化编排工具调用，合并多步操作，减少模型往返 | 批量文件处理、结构化数据整理、多步骤自动化任务 |
| 极简模式 | 仅保留基础终端与文件编辑工具，裁剪所有辅助能力 | 模型能力基准测试、纯编码场景横向对比 |
| 创造模式 | 支持 Agent 自主创建与集成插件，动态扩展自身能力 | 自定义 Agent 定制、插件开发与实验场景 |
插件推荐：装上这三个，体验直接上一个档
Harness 有插件社区，很多开发者在做三方插件。我挑了几个，推荐大家装上。
1. dsh genui
地址：https://github.com/omdsh-dev/dsh-genui
这个插件可以让模型在回复里直接生成图表、表单、Diff、Mermaid、交互面板之类的，办公很好用。
2. dsh automation
地址：https://github.com/titanwings/dsh-automation
这是给 DSH 加上自动化能力，适合重复性任务。
3. DSH better sidebar
地址：https://github.com/omdsh-dev/DSH-better-sidebar
给 DSH 做了个类似 Code 的工作台，侧边栏中文件管理、代码编辑、真实终端、Git、Diff、内嵌浏览器、后台任务和子代理状态都能看见。
另外再推荐两个插件网站，里面的插件很全。装不熟悉的插件前，最好先去 GitHub 仓库看源码，或者看看评论，看有没有危害的东西。
https://deepseek1024.com/
https://dshfind.com/zh
常见问题 FAQ
Q：API Key 收费吗？贵不贵？
A：Key 免费创建，费用产生于模型调用，输入和输出分别计价，现在按 Token 阶梯定价。建议先试用，根据模型结果再决定。API Key 不要复制进任何第三方插件或不明网站。
Q：怎么自己做插件？
A：可以根据官方插件开发指南自动生成适配插件。想要完整开发出自己的插件，就需要学习代码，然后编译插件。
Q：三个版本有什么区别？
A：本质上没区别。桌面版只是多了一层图形界面，界面好看、使用方便。命令行版走轻盈路线，适合熟悉终端的开发者。
到底改变了什么？
很多人说，这不就是又一个编码助手吗？我反而觉得，它真正改的是 Agent 的形态。
以前的 Agent，是功能固定的产品。平台做成什么样，你就怎么用。
现在的 Harness，是可以自由组合的运行基础设施。需要什么能力，就往上装什么插件。
它不只是增加了一个编码工具，更是探索出 Agent 产品的另一种形态：从固定功能的软件工具，走向可自定义、可扩展的运行平台。
不过话说回来，这项目还是开发版本，距离正式版有点远，上手门槛不低，第一次打开很容易看懵。
社区插件质量参差不齐。通常能力越强的插件，要的权限越高，潜在风险也越大。复杂多轮任务的 Token 消耗也不小，用之前最好设个预算上限。
纯新手其实可以再等等，等官方正式版出来再上车也不迟。
未来的 Agent，不该是一个个功能固定的聊天框，而是一套能融入工作流、能被自定义、能自己生长的智能运行时。从“别人给你什么你用什么”，到“你需要什么就拼什么”，这可能才是 Agent 真正该有的样子。
参考资料
- DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- DeepSeek Harness 官网：https://deepseek.com/harness
- DeepSeek API 模型与价格：https://api-docs.deepseek.com/zh-cn/quick_start/pricing
- DSH Desktop 社区客户端：https://www.dshdesktop.cn/
说明：软件版本、插件功能、API 策略均会随迭代更新，实际使用请以官方最新文档为准。安装第三方插件前，请务必核查代码来源与权限范围。
EdgeOne
ESA