DSH Toolbox

DeepSeek Harness 安装

在 Node.js 24.9.0 或更高版本上执行 npm install -g @deepseek-ai/dsh，然后 dsh web 打开浏览器界面。

一个 npm 包，一条全局命令。剩下要注意的只有 Node 版本，和首次运行时自己填好的 profile 目录。

这个包要求 Node.js 24.9.0 或更高。装之前先 node --version；版本低了会在安装时给出 EBADENGINE 警告，启动时通常直接报语法错误。

Windows

装 Node.js 24.9.0 或更高版本，然后在 PowerShell 里执行 npm install -g @deepseek-ai/dsh。

npm 会把 dsh.cmd 和 dsh.ps1 写到全局前缀目录（和 node.exe 同级）。装完提示找不到 dsh，通常就是这个目录没在 PATH 里——用 npm prefix -g 看它在哪。

先用 dsh web 起界面。不想自动弹浏览器就加 --no-open，要固定端口加 --port 8080。

node --version
npm install -g @deepseek-ai/dsh
dsh --version
dsh web --port 8080

macOS

同一个包。如果 npm 的全局前缀属于 root，会报 EACCES；改前缀归属，或者用版本管理工具装 Node，让全局前缀属于你自己。

装好后 dsh web 启动 web profile 并打开浏览器；dsh web --no-open 只打印地址。

node --version
npm install -g @deepseek-ai/dsh
dsh --version
dsh web

Linux

从发行版仓库或 nodejs.org 装 Node.js 24.9.0 以上，然后全局安装这个包。

服务器上没有显示器时用 dsh web --host 127.0.0.1 --port 8080 --no-open，再通过隧道或反向代理访问。--host 只接受一个具体的本机地址，通配地址会被拒绝。

node --version
npm install -g @deepseek-ai/dsh
dsh --version
dsh web --host 127.0.0.1 --port 8080 --no-open

首次启动报插件不兼容怎么办

插件会声明自己兼容的 dsh 版本区间。装着的 dsh 不在区间内时，命令行会跳过这个插件并打印要求，类似 Plugin dsh-client-ui-aqua@1.3.1 is incompatible with dsh 0.2.1-rc.2。

两种处理：换成匹配当前 dsh 的插件版本，或者用 dsh plugin allow-version 给这一对版本开一个精确版本豁免——等于明确接受风险。

常见问题

dsh 需要哪个 Node 版本？

Node.js 24.9.0 或更高。这是发布包在 engines.node 里声明的要求。

还要装别的东西吗？

不用。npm 包装好命令行，profile 首次使用时会从随包模板自动初始化。

数据放在哪？

在 $DSH_HOME 下，各平台默认都是 ~/.dsh：profiles/、sessions/、storages/、logs/。

没有管理员权限能装吗？

能，只要 npm 全局前缀目录你有写权限。用 npm config set prefix 换一个目录，再加进 PATH。

怎么确认装好了？

dsh --version 打印版本；dsh --help 打印启动器语法，包括 dsh web 和 dsh headless。

相关