DeepSeek Harness 简称 DSH,是 DeepSeek 推出的 MIT 协议开源 Agent 运行框架,主打一切皆插件的 Cordis 架构,新手可以用它快速搭建能调用文件、脚本、搜索、代码工具的 AI 智能体,不用复杂开发,本文 2026 实测整理了从前置环境准备、三种下载安装方式、API 密钥配置、WebUI 基础操作、插件管理、常见排错的完整流程,新手优先推荐 npx 一键启动的方式,门槛最低,适合先体验功能,熟悉之后再切换全局安装或者源码编译部署。DSH 和普通对话模型不一样,它负责给大模型提供运行环境、工具调用权限、会话轨迹记录、沙箱隔离,支持对接 DeepSeek 系列模型,也兼容其他支持 OpenAI 格式接口的模型。
三种安装方式对比
| 安装方式 | 适合人群 | 优点 | 缺点 |
|---|---|---|---|
| npx 临时启动 | 新手初次体验 | 一行命令,不用本地安装,用完即走 | 关闭终端服务就停止,不适合长期后台跑任务 |
| npm 全局安装 | 经常使用、日常开发 | 任意目录调用 dsh 命令,常驻使用 | 需要 Node 环境,占用本地包空间 |
| 源码编译安装 | 二次开发、自定义内核插件 | 可修改源码,深度定制能力 | 步骤多,需要 pnpm,调试成本高 |
分步操作流程
- 前置环境准备:先安装 Node.js 18 及以上版本,安装完成打开终端输入node -v、npm -v,输出版本号代表环境正常,没有 Node 会直接启动失败。
- 下载安装:
- 快速体验(推荐新手):终端输入npx @deepseek-ai/dsh web,等待依赖拉取,完成后访问 http://127.0.0.1:3080
- 全局长期安装:npm install -g @deepseek-ai/dsh,安装后校验dsh --version,启动命令同样dsh web
- 源码部署:git 拉取仓库,pnpm 安装依赖、build 编译后启动,适合开发者
- 模型配置:打开 WebUI 设置页,填入 DeepSeek API Key,选择模型,也可以切换其他兼容接口;设置工作目录,DSH 会在这个文件夹读取、修改文件,注意不要选系统敏感目录。
- 插件启用与使用:进入插件面板,按需开启 Shell、文件读写、网页搜索、代码执行插件,新手建议默认沙箱开启,降低误操作风险;支持 Creator 创造模式,直接对话生成自定义插件。
- 基础使用:新建会话,输入任务指令,DSH 会自动规划步骤、调用工具,Trajectory 面板可以查看完整思考轨迹、工具调用记录,任务支持暂停、继续、分叉会话。
新手必看注意清单
- 沙箱模式默认开启,防止 AI 随意执行高危命令、删除文件;
- API 密钥不要分享,密钥泄露会造成额度被盗刷;
- 预览版还在快速迭代,部分插件不稳定,遇到报错优先升级版本;
- 工作目录尽量单独新建空文件夹,避免 AI 改动你重要文档。
【相关 FAQ】
问题 1:DeepSeek Harness 也就是 DSH 是什么,新手适合上手吗?
回答 1:DeepSeek Harness(DSH)是 DeepSeek 开源的 Agent 智能体运行框架,基于插件架构,新手可以通过 WebUI 直接使用,不用写大量代码,很适合入门体验工具型 AI 智能体。
问题 2:新手装 DeepSeek Harness,优先选哪种下载安装方式?
回答 2:新手体验 DeepSeek Harness 优先 npx 一键启动,不用安装到本地,一行命令拉起 WebUI,适合先测试功能,确认需要长期使用再换成 npm 全局安装。
问题 3:配置 DeepSeek Harness 的时候,必须要有 DeepSeek API Key 吗?
回答 3:是的,DeepSeek Harness 默认需要填入 DeepSeek API Key 对接模型;同时它也支持配置其他兼容 OpenAI 协议的模型接口。
问题 4:DeepSeek Harness 里的 Trajectory 面板有什么用?
回答 4:DeepSeek Harness 的 Trajectory 面板会完整记录每一轮会话的思考过程、工具调用、返回结果,方便新手排查任务失败原因,回溯智能体执行链路。
【参考资料】
[2026-11-19](
【DSH】DeepSeek Harness 新手保姆教程(下载 + 安装 + 配置 + 使用,2026 最新实测))掘金
[2026-11-16](DeepSeek Harness 插件生态上新,v0.1.2rc 版本更新日志)DeepSeek 官方博客
[2026-11-09](DeepSeek Harness 下载、安装、配置一篇搞定 (2026 整理,送常用插件))阿里云开发者社区
[2026-10-15](DeepSeek Harness 保姆级落地教程:微内核 Agent 框架安装、模型对接、故障处理实操指南)阿里云开发者社区
【免责声明】
本文仅为 DeepSeek Harness(DSH)新手教程资讯整理,该项目属于开发者预览版本,版本、命令、插件功能持续迭代;API 调用会产生计费,沙箱不能 100% 规避风险,所有操作建议在测试环境验证,内容不构成开发部署或者付费充值建议。
