npx @deepseek-ai/dsh web 启动后怎么装第一个插件:搜索、确认、重启与验证生效

安装与快速上手发布于 2026-10-31作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH pluginnpx @deepseek-ai/dsh webdsh plugin market第一个插件
npx @deepseek-ai/dsh web 启动后,页面开了但不知道下一步做什么。这篇按五分钟路线走:从设置找到 DSH Plugin Hub、搜到第一个插件、读安装确认、重启并验证三个生效信号,最后给出装错后的回退路径。

「npx 跑起来了,页面也开了,然后呢?」 这是用 npx @deepseek-ai/dsh web 启动 DeepSeek Harness 后最常见的一句停顿。命令只负责把 Web UI 跑起来,第一个插件还得你自己走一遍:找入口、搜插件、确认安装、重启、验证(源码仓库)。这篇按五分钟路线走完,入口在 DSH Plugin Hub 的设置页。

从 npx @deepseek-ai/dsh web 到设置:DSH Plugin Hub 的入口

npx 启动的是 web profile,插件市场入口在「设置 → 插件市场」;先确认 Hub 装在这个 profile 里,再谈装插件。 入口找不到,通常是 Hub 没装或没生效,而不是浏览器问题。

bash
# 启动 Web UI:首次会从 npm 拉取并缓存
npx @deepseek-ai/dsh web
# 终端会打印访问地址,用浏览器打开它
# 需要确认 web profile 里装了什么时,另开一个终端
npx @deepseek-ai/dsh plugin --profile web list
# 已全局安装 dsh 的话,也可以直接 dsh plugin --profile web list
  1. 在终端运行 npx @deepseek-ai/dsh web,等它打印访问地址。
  2. 用浏览器打开该地址,进入页面左侧或顶部的「设置」。
  3. 找到「插件市场」并点开;看不到这一项时,先确认 Hub 是否装在 web profile。
  4. 进市场后认一下顶部四个页签:插件市场、已安装、自定义安装、设置。

这一步只做「找到入口」,不安装任何东西。入口找不到时,先查 Hub 是否已装,不要急着清浏览器缓存。

搜第一个插件:dsh plugin market 的三步筛选

第一个插件不要逛,直接搜:一个功能词、一次未安装筛选、一次排序,三步压到十个以内。 目标是尽快走完一次完整安装,而不是做最优选型。

  1. 想一个你每天都会用到的功能,把它压成一个英文词,比如 memory、search、theme。
  2. 在搜索框输入这个词,看结果条数;太多就再加一个场景词。
  3. 把分类切到「未安装」,排除已经装过的条目。
  4. 排序切到「最近」倒序,扫前五个,挑一个版本和更新时间都能接受的。
  5. 点「打开详情」,确认功能与你的需求一致,再回卡片准备安装。

第一个插件的选择标准是「低风险、好验证」,不是「功能最强」。入口类、主题类通常比涉及文件权限的插件更容易验证,适合作为第一次。

搜不到时的两步

  1. 先清空关键词,把分类切回「全部」,排除「已安装」筛选造成的 0 结果。
  2. 再换一种写法:英文名不行就换包名,包名不行就换 topic。

两步都试过还是没有,再去 GitHub 确认插件是否发布,别在市场里反复换近义词。

安装确认与重启:DeepSeek Harness 的加载时机

点安装只完成「写入」,重启才完成「挂载」;确认弹窗里的三项要逐项对上。 这一步是整个流程里最容易跳过、也最容易出问题的地方。

DSH Plugin Hub 确认安装
  1. 在目标卡片上点「安装」,等确认弹窗出现。
  2. 核对插件名、来源仓库与将要执行的安装命令,三项都对上再确认。
  3. 确认后等进度走完,留意通知中心有没有「待重启」提醒。
  4. 回到终端,停止当前 npx 进程并重新运行 npx @deepseek-ai/dsh web。
  5. 刷新页面,确认市场卡片状态从「安装」变成「已安装」。

「待重启」不是失败,而是加载时机没到。看到它就去重启,不要重复点安装;重复安装只会覆盖同一个版本,不会让入口提前出现。

验证生效的三个信号:DSH plugin 真的在跑吗

生效要看三个信号:入口出现、调用正常、日志无错误;三个都过,才算第一个插件装成功。 只看到「已安装」不够。

  1. 入口信号:重启后,插件提供的菜单、面板或命令真的出现在界面上。
  2. 调用信号:实际用一次它的能力,比如生成一次主题、执行一次搜索,确认有结果。
  3. 日志信号:进「设置 → 插件市场 → 系统日志」,确认没有同一插件的激活错误。
  4. 三个信号都通过,回已安装列表记下版本与来源。
  5. 任何一个不通过,先按 安装失败怎么看通知 排查,不要直接卸载重装。

验证时一次只动一个变量:先重启、再看入口、最后看日志。三个信号里,调用信号最有说服力——界面可能是缓存,实际调用骗不了人。

信号具体表现不通过时先查什么
入口菜单、面板或命令出现profile 是否装对、是否重启
调用执行一次能力有结果权限与依赖是否满足
日志没有同一插件的激活错误按下载、解包、依赖、加载定位

装错了怎么退:dsh plugin market 的卸载与回滚

装错就卸载,不要手删目录;卸载后重启确认入口消失,再决定要不要换一个。 第一个插件装错很正常,退出路径清楚比一次装对更重要。

  1. 进「已安装」,找到目标插件,点行尾的「卸载」。
  2. 读卸载确认弹窗,确认插件名与来源后移除。
  3. 重启 npx 进程,刷新页面,确认入口消失。
  4. 如果入口还在,先查是不是装在了另一个 profile,再按残留顺序核对。
  5. 想换一个插件时,回市场重新搜,不要在同一张卡片上反复装卸。

卸载是生命周期的一部分,不需要为「装错」感到挫败。第一周把安装、验证、卸载各走一遍,后面遇到插件冲突时就有现成的路径。想继续看更新流程,可以读 可更新徽标一直亮;想系统了解 npx 这条命令,见 npx 启动 Web UI 做了什么。

常见问题

npx @deepseek-ai/dsh web 启动后,插件市场入口到底在哪?

DeepSeek Harness 启动 Web UI 后,插件市场入口在页面的「设置 → 插件市场」;如果设置里没有这一项,说明 DSH Plugin Hub 还没装或没生效。先用 CLI 确认 Hub 已装,再重启 Web UI 并刷新页面,入口出现后再进市场。

dsh web 启动后,第一个插件到底应该怎么搜才不会挑花眼?

DeepSeek Harness 里第一个插件按「功能词 + 未安装筛选」两步搜:先用一个具体功能词,比如 memory 或 search,再把分类切到未安装。结果压到十个以内,就按版本与更新时间挑一个,不要在第一个插件上做复杂选型。

在 dsh web 里点安装后,为什么必须重启 npx 启动的进程?

DeepSeek Harness 的 Web UI 是 npx 启动的宿主进程提供的,插件在宿主启动时按 profile 清单加载。安装只把包写进 profile,运行中的进程不会自动换模块;重启 npx 进程或按提示重新加载,插件才会挂载。

怎么确认第一个 DSH plugin 真的生效,而不是只在列表里显示已安装?

DeepSeek Harness 里看三个信号:插件入口或命令在重启后出现、实际调用一次能力正常、系统日志没有激活错误。列表里的「已安装」只证明写入完成;三个信号都对上,才说明这个插件在跑。

第一个插件装错了,在 dsh web 的 npx 环境里怎么退回去?

DeepSeek Harness 里退回去走已安装列表的卸载按钮,读卸载确认弹窗后移除,再重启 Web UI 确认入口消失。不要手删 profile 目录;如果卸载后还有残留,再按清单、缓存、配置的顺序核对,而不是重装整个环境。

相关术语

npx @deepseek-ai/dsh web
npx @deepseek-ai/dsh web 是启动 DeepSeek Harness Web UI 的官方命令,npx 从 npm 拉取并执行 @deepseek-ai/dsh,web 是 --profile web 的别名。它不需要全局安装,首次运行会把包缓存到 npm 目录。— https://github.com/deepseek-ai/deepseek-harness
web profile
web profile 是 DeepSeek Harness 里由 dsh web 启动的配置栈,位于 $DSH_HOME/profiles/web。它决定 Web UI 加载哪些插件与补丁,插件必须装进这个 profile 才会在 Web 端出现。— https://github.com/deepseek-ai/deepseek-harness
安装确认弹窗
安装确认弹窗是 DSH Plugin Hub 在安装前显示的安全关卡,列出插件名、来源仓库与将要执行的安装命令。用户确认后才开始下载与写入 profile。— https://api.dsh-plugin.org/images/releases/2-2-5/index.json
验证生效
验证生效是安装后确认插件真正可用的过程,包括重启后入口出现、实际调用成功与日志无激活错误。它与「显示已安装」不是同一件事。— https://github.com/deepseek-ai/deepseek-harness

来源