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

DeepSeek Harness 保姆级教程 下载安装配置一站式落地，附赠常用插件包

发布时间: 2026-11-10 19:29:17 作者:云智宅志

这套 DeepSeek Harness 保姆级教程把下载、安装、基础配置、插件安装全部打通，新手跟着操作就能一站式跑通本地 Agent 运行环境，DeepSeek Harness 简称 DSH，是 DeepSeek 推出的开源 Agent 框架，核心特点是一切皆插件，很多新手第一次上手容易卡在 Node 环境缺失、命令执行失败、API Key 配置错误，还有不知道该装哪些实用插件。它支持三种部署方式，npx 快速体验、npm 全局安装、源码编译，也有 Windows 和 Mac 桌面客户端，不用敲命令；装好之后，先配置模型接入密钥，再导入附赠的常用插件包，就能解锁代码沙盒、联网搜索、上下文管理、文件处理等能力，配置完成打开 WebUI，在浏览器访问本地地址，就可以直接使用可自由组合的智能体能力，后续还能自己新增、开发自定义插件扩展功能。

前置依赖检查清单

  • Node.js 版本：要求 Node.js 20 及以上版本，推荐 22 稳定版
  • 系统支持：Windows、macOS、Linux 全平台兼容，Mac 区分 Intel 和 Apple Silicon
  • 网络：需要访问 npm 包仓库，国内建议配置 npm 镜像提升下载速度
  • 权限：Windows 开启终端管理员权限，Mac/Linux 准备好 sudo 权限
  • 可选：Git，源码部署时用来拉取仓库代码

三种安装方式对比表

安装方式适合人群优点缺点
npx 临时启动初次体验、快速试玩不用安装，一条命令启动，无残留每次启动都要重新拉取依赖
npm 全局安装日常高频使用任意终端直接调用 dsh 命令，启动快需要全局权限
源码编译安装二次开发、自定义修改可修改源码、自主打包步骤多，需要懂基础前端构建

分步安装操作

方式 1：npx 快速体验（新手首选）

  1. 装好 Node.js，打开终端
  2. 执行命令：npx @deepseek-ai/dsh web
  3. 等待依赖下载，启动成功后访问：http://127.0.0.1:3080
  4. 关闭终端，服务就停止，不会留在系统里

方式 2：npm 全局安装（长期使用推荐）

  1. 终端执行：npm install -g @deepseek-ai/dsh
  2. 校验安装成功：dsh --version，输出版本号即成功
  3. 启动 WebUI：dsh web

方式 3：源码安装（开发者）

  1. 拉取代码：git clone https://github.com/deepseek-ai/deepseek-harness
  2. 进入目录：cd deepseek-harness
  3. 安装依赖：npm install
  4. 启动服务：npm run dev

桌面客户端安装

  1. 前往 DeepSeek 官网下载对应系统安装包
  2. Windows 双击 exe、Mac 打开 dmg 拖入应用程序
  3. 打开客户端，自动拉起本地 Web 服务，无需手动敲命令

基础配置步骤

  1. 打开 WebUI，进入设置页面，找到模型配置
  2. 填入 DeepSeek API Key，也可以配置其他兼容 OpenAI 协议的模型
  3. 调整沙箱权限、文件读写权限，按需开启联网能力
  4. 保存配置，重启 DSH 服务生效

附赠常用插件包清单

  • 联网搜索插件：网页检索，给 Agent 提供实时信息
  • 代码沙盒插件：运行 Python、JS 代码，自动执行脚本
  • 上下文管理插件：上下文统计、压缩、会话透视
  • 文件处理插件：读取本地文档、表格、批量解析文件
  • 模型切换插件：一键切换多个模型，支持多模型对比
  • 任务编排插件：长任务断点续跑、多步骤 Agent 任务

插件导入 & 安装方法

  1. 进入 DSH 左侧
  2. 两种方式：输入插件包名在线安装、导入本地插件包
  3. 安装完成后，在插件列表开启启用开关
  4. 部分插件需要单独填写密钥、权限参数，填写后保存
  5. 插件支持热加载，大部分不用重启 DSH

【插件】面板，点击添加插件

新手高频踩坑汇总

  1. Node 版本过低：提示语法报错，升级 Node 到 20 + 版本
  2. npm 下载超时：切换淘宝 npm 镜像
  3. API Key 填错：模型调用失败，返回鉴权报错
  4. 端口 3080 被占用：启动命令修改端口 dsh web --port 3081
  5. 插件安装后不生效：检查插件版本，部分插件不匹配 DSH 预览版
  6. 沙箱无法运行：系统安全策略拦截，按需放行

【相关 FAQ】

问题 1：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，附赠的常用插件包怎么导入？

回答 1：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，附赠的常用插件包可以在 WebUI 插件面板选择本地导入，也可以直接输入插件包名在线安装，开启开关后即可使用。

问题 2：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，DeepSeek Harness 的 npx 启动方式和 npm 全局安装有什么区别？

回答 2：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，npx 启动适合临时体验，不会在系统留存文件；npm 全局安装会常驻系统，后续直接用 dsh 命令启动，适合长期使用。

问题 3：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，DeepSeek Harness 必须使用 DeepSeek 的 API Key 吗？

回答 3：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，不是必须，DeepSeek Harness 兼容 OpenAI 协议，你也可以填入其他兼容接口的模型密钥。

问题 4：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，DeepSeek Harness 附赠的插件包里面的代码沙盒插件有什么作用？

回答 4：这套 DeepSeek Harness 保姆级教程支持下载安装配置一站式落地，附赠插件包里的代码沙盒插件可以让 Agent 直接运行 Python、JS 代码，自动执行计算、脚本任务，不用手动复制代码到本地运行。

【参考资料】

[2026-11-10]（DSH 插件市场，DeepSeek Harness 社区插件汇总）DSH 插件市场

[2026-11-07]（DeepSeek Harness 开发者预览版介绍，一切皆插件）36 氪

[2026-11-04]（DeepSeek Harness 官方文档，快速启动与插件说明）DeepSeek 官网

[2026-09-01]（DeepSeek Harness 保姆级安装与实操完整教程）阿里云开发者社区

【免责声明】

本 DeepSeek Harness 保姆级教程仅为学习资讯整理，DeepSeek Harness 属于开发者预览版，版本迭代快，插件、命令、配置页面会持续变动；第三方社区插件稳定性、安全性没有官方保障，导入插件前请自行甄别风险；API 调用会产生模型费用，费用由对应模型服务商收取；本文不构成生产环境部署方案，正式使用请以 DeepSeek 官方仓库文档为准。

相关文章

标签： DeepSeek Harness 保姆级教程，下载安装配置一站式落地，附赠常用插件包