您的位置首页 >人工智能 >

DeepSeek Harness(DSH)新手保姆教程,2026 实测下载安装配置与完整使用指南

DeepSeek Harness 简称 DSH,是 DeepSeek 推出的 MIT 协议开源 Agent 运行框架,主打一切皆插件的 Cordis 架构,新手可以用它快速搭建能调用文件、脚本、搜索、代码工具的 AI 智能体,不用复杂开发,本文 2026 实测整理了从前置环境准备、三种下载安装方式、API 密钥配置、WebUI 基础操作、插件管理、常见排错的完整流程,新手优先推荐 npx 一键启动的方式,门槛最低,适合先体验功能,熟悉之后再切换全局安装或者源码编译部署。DSH 和普通对话模型不一样,它负责给大模型提供运行环境、工具调用权限、会话轨迹记录、沙箱隔离,支持对接 DeepSeek 系列模型,也兼容其他支持 OpenAI 格式接口的模型。

三种安装方式对比

安装方式适合人群优点缺点
npx 临时启动新手初次体验一行命令,不用本地安装,用完即走关闭终端服务就停止,不适合长期后台跑任务
npm 全局安装经常使用、日常开发任意目录调用 dsh 命令,常驻使用需要 Node 环境,占用本地包空间
源码编译安装二次开发、自定义内核插件可修改源码,深度定制能力步骤多,需要 pnpm,调试成本高

分步操作流程

  1. 前置环境准备:先安装 Node.js 18 及以上版本,安装完成打开终端输入node -v、npm -v,输出版本号代表环境正常,没有 Node 会直接启动失败。
  2. 下载安装:
  • 快速体验(推荐新手):终端输入npx @deepseek-ai/dsh web,等待依赖拉取,完成后访问 http://127.0.0.1:3080
  • 全局长期安装:npm install -g @deepseek-ai/dsh,安装后校验dsh --version,启动命令同样dsh web
  • 源码部署:git 拉取仓库,pnpm 安装依赖、build 编译后启动,适合开发者
  1. 模型配置:打开 WebUI 设置页,填入 DeepSeek API Key,选择模型,也可以切换其他兼容接口;设置工作目录,DSH 会在这个文件夹读取、修改文件,注意不要选系统敏感目录。
  2. 插件启用与使用:进入插件面板,按需开启 Shell、文件读写、网页搜索、代码执行插件,新手建议默认沙箱开启,降低误操作风险;支持 Creator 创造模式,直接对话生成自定义插件。
  3. 基础使用:新建会话,输入任务指令,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% 规避风险,所有操作建议在测试环境验证,内容不构成开发部署或者付费充值建议。