dsh插件市场

安装

dsh 安装教程:从命令到第一个插件

dsh 安装教程:先装 Node.js,用 npx @deepseek-ai/dsh web 启动 Web UI(默认 127.0.0.1:3080),或从源码用 pnpm 构建;附模型配置、工作区选择和 dsh plugin --profile web add 安装第一个插件的步骤。

上次核对:2026-11-20

npx @deepseek-ai/dsh web

先装 Node.js

dsh 通过 npm 发布,用 npx 运行之前,机器上必须先有 Node.js。官方 README 只写「Install Node.js」,没有指定最低版本;以你安装的 dsh 包在 npm 上声明的 engines 为准。装好后在终端执行 node -v,能输出版本号就说明环境好了。

用 npx 启动 Web UI

在终端运行:

npx @deepseek-ai/dsh web

官方 README 写明:这条命令默认在 http://127.0.0.1:3080 启动 Web UI,并在本地启动时自动打开浏览器;SSH 启动只打印地址,因为转发地址由 SSH 客户端或编辑器管理。不想自动打开浏览器就加 --no-open:

npx @deepseek-ai/dsh web --no-open

第一次启动后,按官方 Web UI 指南先在 Settings → Models 填 DeepSeek API Key,再选择一个工作区。没有工作区时,会话输入框不可用。

从源码运行

想跟开发分支或改源码,按官方 README 的步骤:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 准备构建产物,pnpm dsh web 直接使用这些产物,不再重新构建。源码方式需要 pnpm;版本变化时以官方 README 为准。

装第一个插件

dsh 的插件管理走 profile。官方 CLI 帮助里写明的用法是:

dsh plugin --profile <name> add <package>

Web UI 用 web profile,所以最常见的命令是:

dsh plugin --profile web add <包名>

这条命令会把参数转给该 profile 目录里的 pnpm,add、remove、why 都能用。包名可以是 npm 包,也可以是 Git 仓库或 release tarball 地址。装完通常要重启 dsh 或刷新页面;具体看插件 README。

跑起来之后先看三件事

  1. 界面能不能打开。 打不开先看 3080 端口是不是被别的程序占了;换端口用 --port。
  2. 能不能发一条消息拿到回应。 这一步不通,先查模型配置,别去怪插件。
  3. 配置和 profile 在哪。 后面装插件会改 profile 目录,先知道位置、先备份。

装插件常见的三个坑

  • 装完没重启。 插件改了 profile 或界面,通常要重启宿主才生效。
  • profile 装错。 桌面端用自己的 profile,CLI 装进 web 不一定出现在桌面端;按插件 README 的说明选入口。
  • 把插件问题当成 dsh 问题。 出问题先卸掉最近装的插件,看能不能恢复;能恢复就是插件的事。

官方 README、CLI 帮助和仓库里的 docs 是最准的来源。插件界面和命令行为会随版本变化,装之前先看仓库最后更新时间。

安装之后接着读

常见问题

必须装 Node.js 吗?

官方 README 的 npx 和源码两种方式都需要 Node.js;源码方式还需要 pnpm。

3080 端口能改吗?

能。官方 CLI 帮助里有 --port <port>,例如 dsh web --port 8080。

怎么装第一个插件?

基础会话跑通后,用 dsh plugin --profile web add <包名>;装完重启或刷新。包名从插件页复制,不要凭记忆写。

dsh插件市场安装怎么操作?

先按上面的步骤把 dsh 跑起来,再用 dsh plugin --profile web add <包名> 装插件。想用图形界面,可以装 dsh-market,在插件页里浏览、搜索和安装;具体步骤见 dsh-market 详情页。