DeepSeek Harness 第一次怎么安装？装前检查 Node.js、npx 一行启动、装后验证与安装插件

安装与快速上手发布于 2026-09-02作者: DeepSeek Plugin 插件市场
DeepSeek Harnessdsh安装npx安装教程DSH Plugin Hub
第一次装 DeepSeek Harness 怎么装？装前检查 Node.js（node -v 有输出），运行 npx @deepseek-ai/dsh web 启动 Web UI，浏览器打开 http://127.0.0.1:3080 即装好；再到 DSH Plugin Hub 装第一个插件就能开始用。

第一次装 DeepSeek Harness，按「装前检查 Node.js → npx 一行启动 → 装后验证 → 装第一个插件」四步走就能跑通。

概览

DeepSeek Harness（命令行工具 dsh）是 DeepSeek AI 开源的智能体框架，官方主推一条命令启动：npx @deepseek-ai/dsh web。 它会自动下载并启动，默认在 http://127.0.0.1:3080 起 Web UI，本机启动时还会自动用浏览器打开页面（来源）。这篇教程按新手视角把每一步拆开讲，照着做就能完成第一次安装。

安装 DeepSeek Harness 前：先确认 Node.js 环境可用

DeepSeek Harness 的 npx 启动方式只依赖一个前提：本机装好 Node.js。 装前先花一分钟做检查，能省掉后面大半报错。

  1. 打开终端，执行 node -v，应输出版本号（如 v20.11.0）；
  2. 再执行 npm -v，应输出 npm 版本号——npm 随 Node.js 一起安装，不用单独装；
  3. 若提示 node: command not found：去 Node.js 官网下载 LTS 安装包装好，装完重开终端，再执行一次第 1 步；
  4. （国内网络建议）确认能访问 npm registry：可先执行 npm config set registry https://registry.npmmirror.com 切到镜像，避免首次下载卡住。

检查都通过后，就可以开始安装 DeepSeek Harness 本体了。

安装并启动 DeepSeek Harness：用 npx 一行命令跑起 Web UI

官方推荐的第一种启动方式是免安装式的 npx 运行：不写任何全局文件，一条命令就完成下载、初始化和启动。 对应命令与完整说明见官方 README 的运行章节。

  1. 在终端执行启动命令：
bash
npx @deepseek-ai/dsh web
  1. 首次运行会自动下载 @deepseek-ai/dsh 包并初始化默认的 web profile，等待终端出现服务已启动的提示（下载视网络情况可能需要几十秒到几分钟）；
  2. 本机启动时浏览器会自动打开 http://127.0.0.1:3080；没有自动打开就手动输入该地址；
  3. 看到 DeepSeek Harness Web UI 页面即启动成功——保持这个终端窗口开着，关掉终端服务就停了；
  4. 若只想起服务、不想开浏览器，启动命令加 --no-open：npx @deepseek-ai/dsh web --no-open。

想长期固定使用或追最新开发版，可选 npm 全局安装（装完直接敲 dsh web）或源码构建，两种方式的完整对比与命令见《DeepSeek Harness 三种安装方式全对比》。切换方式不会丢数据——配置与会话都在默认 ~/.dsh 目录，与安装方式无关。

验证 DeepSeek Harness 装好没：浏览器能打开 3080 页面即成功

装完怎么算成功？以「服务能起、页面能开」为准。 按下面顺序验证，出现预期结果就说明第一次安装完成了。

  1. 看启动它的终端窗口：应显示服务已在 http://127.0.0.1:3080 监听，且没有报错退出；
  2. 打开浏览器访问 http://127.0.0.1:3080，应能看到 DeepSeek Harness Web UI 首页（若使用 npx 方式，验证入口就是这条，它不产生全局 dsh 命令）；
  3. 若你改用 npm 全局安装方式，额外执行 dsh --version，应输出版本号；
  4. 按页面提示完成首次基础设置，例如配置模型提供方（DeepSeek API Key 或本地模型均可），完成后发一条消息测试能正常对话。

到这里 DeepSeek Harness 本体已经装好并跑通。

装好 DeepSeek Harness 后下一步：进 DSH Plugin Hub 装第一个插件

跑通本体之后，扩展能力靠装插件——可视化市场比手敲命令更省心。 想一站式浏览、安装、卸载、更新插件，可以装社区官方的 DSH Plugin Hub 插件市场：

  1. 在 Web UI 里把 DSH Plugin Hub 插件装进当前环境，重启后从设置 → 插件市场打开；
  2. 在「插件市场」页搜索或按分类找插件，插件卡片会展示名称、版本、已验证徽章与描述；
  3. 点「安装」会先弹出确认窗口，展示插件名称、来源仓库与将要执行的安装命令——确认后才开始安装，这是安装前的一道安全关卡；
  4. 安装完成进「已安装」列表查看，后续更新、卸载都在这里一键完成。
确认安装

与其在命令行里背 dsh plugin 的参数，不如直接用 DSH Plugin Hub 的可视化界面管理插件——搜索、安装、更新、卸载都带确认与进度提示，官方收录的插件还会标记已验证状态。访问 https://dsh-plugin.org/zh/ 即可了解详情。

来源：deepseek-ai/deepseek-harness、DeepSeek Harness 官方文档 - Quickstart、dshplugin/dsh-plugin-hub

常见问题

装 DeepSeek Harness 前要先检查什么？node -v 没反应怎么办？

装前先确认 Node.js：终端执行 node -v，能输出版本号即可继续。没反应说明 Node.js 未安装或 PATH 未配置，去 Node.js 官网装 LTS 安装包，装完重开终端再执行 node -v，直到能输出版本号。

npx @deepseek-ai/dsh web 提示 command not found 或下载很慢怎么办？

提示 npx: command not found 说明 Node.js 没装好或 PATH 没配好；下载很慢通常是网络问题，可先执行 npm config set registry https://registry.npmmirror.com 切到国内镜像再重跑。首次运行要下载整个包，等待几十秒到几分钟都是正常的。

npx @deepseek-ai/dsh web 启动后，怎么确认 DeepSeek Harness 装好且能用？

分两层验证：浏览器能打开 http://127.0.0.1:3080 并显示 DeepSeek Harness Web UI 即启动成功；若做了 npm 全局安装，终端执行 dsh --version 应输出版本号。npx 方式没有自动打开浏览器时，手动输入该地址即可。

第一次启动 DeepSeek Harness 后要先做什么？

先按页面提示完成基础设置，例如配置模型提供方，之后才能开始对话。想用可视化市场管理插件，可以接着安装 DSH Plugin Hub 插件市场，在里面按分类搜索插件一键安装。

相关术语

DeepSeek Harness
DeepSeek Harness（DSH）是 DeepSeek AI 开发的开源 agent harness（智能体框架），构建在「一切皆插件」架构之上、由 Cordis 驱动，命令行工具是 dsh。— DeepSeek Harness 官方文档
npx
npx 是 npm 自带的命令运行器，能在不全局安装的情况下临时下载并执行 npm 包里的可执行命令，DeepSeek Harness 官方就用它做一键启动。— npm 官方文档
dsh web
dsh web 是 DeepSeek Harness 的启动命令，默认在 http://127.0.0.1:3080 启动 Web UI，本机启动时会自动打开浏览器，加 --no-open 可只起服务不开浏览器。— DeepSeek Harness 官方 README
DSH Plugin Hub
DSH Plugin Hub 是社区官方的 DSH 插件市场，提供插件可视化浏览与一键安装、卸载、更新，装插件前会弹确认展示来源与命令，属于管理插件的一站式界面。— dshplugin/dsh-plugin-hub GitHub 仓库

来源