安装
dsh 安装教程:从命令到第一个插件
dsh 安装教程:先装 Node.js,用 npx @deepseek-ai/dsh web 启动 Web UI(默认 127.0.0.1:3080),或从源码用 pnpm 构建;附模型配置、工作区选择和 dsh plugin --profile web add 安装第一个插件的步骤。
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。
跑起来之后先看三件事
- 界面能不能打开。 打不开先看 3080 端口是不是被别的程序占了;换端口用
--port。 - 能不能发一条消息拿到回应。 这一步不通,先查模型配置,别去怪插件。
- 配置和 profile 在哪。 后面装插件会改 profile 目录,先知道位置、先备份。
装插件常见的三个坑
- 装完没重启。 插件改了 profile 或界面,通常要重启宿主才生效。
- profile 装错。 桌面端用自己的 profile,CLI 装进
web不一定出现在桌面端;按插件 README 的说明选入口。 - 把插件问题当成 dsh 问题。 出问题先卸掉最近装的插件,看能不能恢复;能恢复就是插件的事。
官方 README、CLI 帮助和仓库里的 docs 是最准的来源。插件界面和命令行为会随版本变化,装之前先看仓库最后更新时间。
安装之后接着读
- dsh 是什么:和 Claude Code 这类工具的区别 官方定位、一切皆插件、开发者预览,以及它和普通对话工具的根本区别。
- dsh 安装与第一次启动 从 Node.js、npx 启动、端口到模型配置和工作区,一条条照做。
- 插件是怎么被发现的:dsh.bundle 与 dsh plugin add 一个包凭什么算插件、别人怎么找到它、命令行怎么装。
- 怎么判断一个 dsh 插件值不值得装 最后提交、依赖、权限、issue 响应、能不能卸干净,五条按顺序过。
- dsh 命令找不到怎么办 command not found 的两种来源:安装方式与 PATH,别混着排错。
- 插件装坏了怎么卸载、怎么回滚 remove、rescue、还原备份和检查残留,按顺序把宿主救回来。
常见问题
必须装 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 详情页。